pulumi-alicloud 3.63.0a1727371922__py3-none-any.whl → 3.63.0a1727705137__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.

This version of pulumi-alicloud might be problematic. Click here for more details.

Files changed (41) hide show
  1. pulumi_alicloud/__init__.py +24 -0
  2. pulumi_alicloud/alb/acl.py +18 -19
  3. pulumi_alicloud/alb/health_check_template.py +96 -88
  4. pulumi_alicloud/cms/_inputs.py +6 -6
  5. pulumi_alicloud/cms/outputs.py +6 -6
  6. pulumi_alicloud/ddos/_inputs.py +8 -9
  7. pulumi_alicloud/ddos/domain_resource.py +446 -90
  8. pulumi_alicloud/ddos/outputs.py +7 -8
  9. pulumi_alicloud/eci/container_group.py +47 -0
  10. pulumi_alicloud/ecs/ecs_snapshot.py +199 -77
  11. pulumi_alicloud/ecs/snapshot.py +26 -8
  12. pulumi_alicloud/ess/__init__.py +1 -0
  13. pulumi_alicloud/ess/alarm.py +47 -0
  14. pulumi_alicloud/ess/server_group_attachment.py +552 -0
  15. pulumi_alicloud/ga/_inputs.py +23 -5
  16. pulumi_alicloud/ga/outputs.py +21 -5
  17. pulumi_alicloud/governance/account.py +61 -0
  18. pulumi_alicloud/gpdb/__init__.py +4 -0
  19. pulumi_alicloud/gpdb/_inputs.py +361 -3
  20. pulumi_alicloud/gpdb/db_instance_ip_array.py +533 -0
  21. pulumi_alicloud/gpdb/get_data_backups.py +288 -0
  22. pulumi_alicloud/gpdb/get_log_backups.py +225 -0
  23. pulumi_alicloud/gpdb/instance.py +47 -0
  24. pulumi_alicloud/gpdb/outputs.py +597 -4
  25. pulumi_alicloud/gpdb/streaming_job.py +1568 -0
  26. pulumi_alicloud/nlb/load_balancer.py +116 -0
  27. pulumi_alicloud/oos/get_secret_parameters.py +111 -9
  28. pulumi_alicloud/oos/outputs.py +22 -11
  29. pulumi_alicloud/pulumi-plugin.json +1 -1
  30. pulumi_alicloud/ram/get_account_alias.py +35 -2
  31. pulumi_alicloud/rds/instance.py +21 -21
  32. pulumi_alicloud/rocketmq/_inputs.py +79 -22
  33. pulumi_alicloud/rocketmq/outputs.py +85 -21
  34. pulumi_alicloud/rocketmq/rocket_mq_instance.py +307 -113
  35. pulumi_alicloud/vpc/peer_connection.py +127 -59
  36. pulumi_alicloud/vpc/peer_connection_accepter.py +263 -42
  37. pulumi_alicloud/vpc/route_entry.py +232 -210
  38. {pulumi_alicloud-3.63.0a1727371922.dist-info → pulumi_alicloud-3.63.0a1727705137.dist-info}/METADATA +1 -1
  39. {pulumi_alicloud-3.63.0a1727371922.dist-info → pulumi_alicloud-3.63.0a1727705137.dist-info}/RECORD +41 -36
  40. {pulumi_alicloud-3.63.0a1727371922.dist-info → pulumi_alicloud-3.63.0a1727705137.dist-info}/WHEEL +0 -0
  41. {pulumi_alicloud-3.63.0a1727371922.dist-info → pulumi_alicloud-3.63.0a1727705137.dist-info}/top_level.txt +0 -0
pulumi_alicloud/ecs/ecs_snapshot.py CHANGED
@@ -28,18 +28,16 @@ class EcsSnapshotArgs:
28
28
  """
29
29
  The set of arguments for constructing a EcsSnapshot resource.
30
30
  :param pulumi.Input[str] disk_id: The ID of the disk.
31
- :param pulumi.Input[str] category: The category of the snapshot. Valid Values: `standard` and `flash`.
31
+ :param pulumi.Input[str] category: The category of the snapshot. Valid values:
32
32
  :param pulumi.Input[str] description: The description of the snapshot.
33
- :param pulumi.Input[bool] force: Specifies whether to forcibly delete the snapshot that has been used to create disks.
34
- :param pulumi.Input[bool] instant_access: Specifies whether to enable the instant access feature.
35
- :param pulumi.Input[int] instant_access_retention_days: Specifies the retention period of the instant access feature. After the retention period ends, the snapshot is automatically released.
33
+ :param pulumi.Input[bool] force: Specifies whether to force delete the snapshot that has been used to create disks. Valid values:
34
+ :param pulumi.Input[bool] instant_access: Field `instant_access` has been deprecated from provider version 1.231.0.
35
+ :param pulumi.Input[int] instant_access_retention_days: Field `instant_access_retention_days` has been deprecated from provider version 1.231.0.
36
36
  :param pulumi.Input[str] name: Field `name` has been deprecated from provider version 1.120.0. New field `snapshot_name` instead.
37
- :param pulumi.Input[str] resource_group_id: The resource group id.
38
- :param pulumi.Input[int] retention_days: The retention period of the snapshot.
37
+ :param pulumi.Input[str] resource_group_id: The ID of the resource group.
38
+ :param pulumi.Input[int] retention_days: The retention period of the snapshot. Valid values: `1` to `65536`. **NOTE:** From version 1.231.0, `retention_days` can be modified.
39
39
  :param pulumi.Input[str] snapshot_name: The name of the snapshot.
40
- :param pulumi.Input[Mapping[str, pulumi.Input[str]]] tags: A mapping of tags to assign to the snapshot.
41
-
42
- > **NOTE:** If `force` is true, After an snapshot is deleted, the disks created from this snapshot cannot be re-initialized.
40
+ :param pulumi.Input[Mapping[str, pulumi.Input[str]]] tags: A mapping of tags to assign to the resource.
43
41
  """
44
42
  pulumi.set(__self__, "disk_id", disk_id)
45
43
  if category is not None:
@@ -48,13 +46,19 @@ class EcsSnapshotArgs:
48
46
  pulumi.set(__self__, "description", description)
49
47
  if force is not None:
50
48
  pulumi.set(__self__, "force", force)
49
+ if instant_access is not None:
50
+ warnings.warn("""Field `instant_access` has been deprecated from provider version 1.231.0.""", DeprecationWarning)
51
+ pulumi.log.warn("""instant_access is deprecated: Field `instant_access` has been deprecated from provider version 1.231.0.""")
51
52
  if instant_access is not None:
52
53
  pulumi.set(__self__, "instant_access", instant_access)
54
+ if instant_access_retention_days is not None:
55
+ warnings.warn("""Field `instant_access_retention_days` has been deprecated from provider version 1.231.0.""", DeprecationWarning)
56
+ pulumi.log.warn("""instant_access_retention_days is deprecated: Field `instant_access_retention_days` has been deprecated from provider version 1.231.0.""")
53
57
  if instant_access_retention_days is not None:
54
58
  pulumi.set(__self__, "instant_access_retention_days", instant_access_retention_days)
55
59
  if name is not None:
56
- warnings.warn("""Field 'name' has been deprecated from provider version 1.120.0. New field 'snapshot_name' instead.""", DeprecationWarning)
57
- pulumi.log.warn("""name is deprecated: Field 'name' has been deprecated from provider version 1.120.0. New field 'snapshot_name' instead.""")
60
+ warnings.warn("""Field `name` has been deprecated from provider version 1.120.0. New field `snapshot_name` instead.""", DeprecationWarning)
61
+ pulumi.log.warn("""name is deprecated: Field `name` has been deprecated from provider version 1.120.0. New field `snapshot_name` instead.""")
58
62
  if name is not None:
59
63
  pulumi.set(__self__, "name", name)
60
64
  if resource_group_id is not None:
@@ -82,7 +86,7 @@ class EcsSnapshotArgs:
82
86
  @pulumi.getter
83
87
  def category(self) -> Optional[pulumi.Input[str]]:
84
88
  """
85
- The category of the snapshot. Valid Values: `standard` and `flash`.
89
+ The category of the snapshot. Valid values:
86
90
  """
87
91
  return pulumi.get(self, "category")
88
92
 
@@ -106,7 +110,7 @@ class EcsSnapshotArgs:
106
110
  @pulumi.getter
107
111
  def force(self) -> Optional[pulumi.Input[bool]]:
108
112
  """
109
- Specifies whether to forcibly delete the snapshot that has been used to create disks.
113
+ Specifies whether to force delete the snapshot that has been used to create disks. Valid values:
110
114
  """
111
115
  return pulumi.get(self, "force")
112
116
 
@@ -116,9 +120,10 @@ class EcsSnapshotArgs:
116
120
 
117
121
  @property
118
122
  @pulumi.getter(name="instantAccess")
123
+ @_utilities.deprecated("""Field `instant_access` has been deprecated from provider version 1.231.0.""")
119
124
  def instant_access(self) -> Optional[pulumi.Input[bool]]:
120
125
  """
121
- Specifies whether to enable the instant access feature.
126
+ Field `instant_access` has been deprecated from provider version 1.231.0.
122
127
  """
123
128
  return pulumi.get(self, "instant_access")
124
129
 
@@ -128,9 +133,10 @@ class EcsSnapshotArgs:
128
133
 
129
134
  @property
130
135
  @pulumi.getter(name="instantAccessRetentionDays")
136
+ @_utilities.deprecated("""Field `instant_access_retention_days` has been deprecated from provider version 1.231.0.""")
131
137
  def instant_access_retention_days(self) -> Optional[pulumi.Input[int]]:
132
138
  """
133
- Specifies the retention period of the instant access feature. After the retention period ends, the snapshot is automatically released.
139
+ Field `instant_access_retention_days` has been deprecated from provider version 1.231.0.
134
140
  """
135
141
  return pulumi.get(self, "instant_access_retention_days")
136
142
 
@@ -140,7 +146,7 @@ class EcsSnapshotArgs:
140
146
 
141
147
  @property
142
148
  @pulumi.getter
143
- @_utilities.deprecated("""Field 'name' has been deprecated from provider version 1.120.0. New field 'snapshot_name' instead.""")
149
+ @_utilities.deprecated("""Field `name` has been deprecated from provider version 1.120.0. New field `snapshot_name` instead.""")
144
150
  def name(self) -> Optional[pulumi.Input[str]]:
145
151
  """
146
152
  Field `name` has been deprecated from provider version 1.120.0. New field `snapshot_name` instead.
@@ -155,7 +161,7 @@ class EcsSnapshotArgs:
155
161
  @pulumi.getter(name="resourceGroupId")
156
162
  def resource_group_id(self) -> Optional[pulumi.Input[str]]:
157
163
  """
158
- The resource group id.
164
+ The ID of the resource group.
159
165
  """
160
166
  return pulumi.get(self, "resource_group_id")
161
167
 
@@ -167,7 +173,7 @@ class EcsSnapshotArgs:
167
173
  @pulumi.getter(name="retentionDays")
168
174
  def retention_days(self) -> Optional[pulumi.Input[int]]:
169
175
  """
170
- The retention period of the snapshot.
176
+ The retention period of the snapshot. Valid values: `1` to `65536`. **NOTE:** From version 1.231.0, `retention_days` can be modified.
171
177
  """
172
178
  return pulumi.get(self, "retention_days")
173
179
 
@@ -191,9 +197,7 @@ class EcsSnapshotArgs:
191
197
  @pulumi.getter
192
198
  def tags(self) -> Optional[pulumi.Input[Mapping[str, pulumi.Input[str]]]]:
193
199
  """
194
- A mapping of tags to assign to the snapshot.
195
-
196
- > **NOTE:** If `force` is true, After an snapshot is deleted, the disks created from this snapshot cannot be re-initialized.
200
+ A mapping of tags to assign to the resource.
197
201
  """
198
202
  return pulumi.get(self, "tags")
199
203
 
@@ -219,20 +223,18 @@ class _EcsSnapshotState:
219
223
  tags: Optional[pulumi.Input[Mapping[str, pulumi.Input[str]]]] = None):
220
224
  """
221
225
  Input properties used for looking up and filtering EcsSnapshot resources.
222
- :param pulumi.Input[str] category: The category of the snapshot. Valid Values: `standard` and `flash`.
226
+ :param pulumi.Input[str] category: The category of the snapshot. Valid values:
223
227
  :param pulumi.Input[str] description: The description of the snapshot.
224
228
  :param pulumi.Input[str] disk_id: The ID of the disk.
225
- :param pulumi.Input[bool] force: Specifies whether to forcibly delete the snapshot that has been used to create disks.
226
- :param pulumi.Input[bool] instant_access: Specifies whether to enable the instant access feature.
227
- :param pulumi.Input[int] instant_access_retention_days: Specifies the retention period of the instant access feature. After the retention period ends, the snapshot is automatically released.
229
+ :param pulumi.Input[bool] force: Specifies whether to force delete the snapshot that has been used to create disks. Valid values:
230
+ :param pulumi.Input[bool] instant_access: Field `instant_access` has been deprecated from provider version 1.231.0.
231
+ :param pulumi.Input[int] instant_access_retention_days: Field `instant_access_retention_days` has been deprecated from provider version 1.231.0.
228
232
  :param pulumi.Input[str] name: Field `name` has been deprecated from provider version 1.120.0. New field `snapshot_name` instead.
229
- :param pulumi.Input[str] resource_group_id: The resource group id.
230
- :param pulumi.Input[int] retention_days: The retention period of the snapshot.
233
+ :param pulumi.Input[str] resource_group_id: The ID of the resource group.
234
+ :param pulumi.Input[int] retention_days: The retention period of the snapshot. Valid values: `1` to `65536`. **NOTE:** From version 1.231.0, `retention_days` can be modified.
231
235
  :param pulumi.Input[str] snapshot_name: The name of the snapshot.
232
- :param pulumi.Input[str] status: The status of snapshot.
233
- :param pulumi.Input[Mapping[str, pulumi.Input[str]]] tags: A mapping of tags to assign to the snapshot.
234
-
235
- > **NOTE:** If `force` is true, After an snapshot is deleted, the disks created from this snapshot cannot be re-initialized.
236
+ :param pulumi.Input[str] status: The status of the Snapshot.
237
+ :param pulumi.Input[Mapping[str, pulumi.Input[str]]] tags: A mapping of tags to assign to the resource.
236
238
  """
237
239
  if category is not None:
238
240
  pulumi.set(__self__, "category", category)
@@ -242,13 +244,19 @@ class _EcsSnapshotState:
242
244
  pulumi.set(__self__, "disk_id", disk_id)
243
245
  if force is not None:
244
246
  pulumi.set(__self__, "force", force)
247
+ if instant_access is not None:
248
+ warnings.warn("""Field `instant_access` has been deprecated from provider version 1.231.0.""", DeprecationWarning)
249
+ pulumi.log.warn("""instant_access is deprecated: Field `instant_access` has been deprecated from provider version 1.231.0.""")
245
250
  if instant_access is not None:
246
251
  pulumi.set(__self__, "instant_access", instant_access)
252
+ if instant_access_retention_days is not None:
253
+ warnings.warn("""Field `instant_access_retention_days` has been deprecated from provider version 1.231.0.""", DeprecationWarning)
254
+ pulumi.log.warn("""instant_access_retention_days is deprecated: Field `instant_access_retention_days` has been deprecated from provider version 1.231.0.""")
247
255
  if instant_access_retention_days is not None:
248
256
  pulumi.set(__self__, "instant_access_retention_days", instant_access_retention_days)
249
257
  if name is not None:
250
- warnings.warn("""Field 'name' has been deprecated from provider version 1.120.0. New field 'snapshot_name' instead.""", DeprecationWarning)
251
- pulumi.log.warn("""name is deprecated: Field 'name' has been deprecated from provider version 1.120.0. New field 'snapshot_name' instead.""")
258
+ warnings.warn("""Field `name` has been deprecated from provider version 1.120.0. New field `snapshot_name` instead.""", DeprecationWarning)
259
+ pulumi.log.warn("""name is deprecated: Field `name` has been deprecated from provider version 1.120.0. New field `snapshot_name` instead.""")
252
260
  if name is not None:
253
261
  pulumi.set(__self__, "name", name)
254
262
  if resource_group_id is not None:
@@ -266,7 +274,7 @@ class _EcsSnapshotState:
266
274
  @pulumi.getter
267
275
  def category(self) -> Optional[pulumi.Input[str]]:
268
276
  """
269
- The category of the snapshot. Valid Values: `standard` and `flash`.
277
+ The category of the snapshot. Valid values:
270
278
  """
271
279
  return pulumi.get(self, "category")
272
280
 
@@ -302,7 +310,7 @@ class _EcsSnapshotState:
302
310
  @pulumi.getter
303
311
  def force(self) -> Optional[pulumi.Input[bool]]:
304
312
  """
305
- Specifies whether to forcibly delete the snapshot that has been used to create disks.
313
+ Specifies whether to force delete the snapshot that has been used to create disks. Valid values:
306
314
  """
307
315
  return pulumi.get(self, "force")
308
316
 
@@ -312,9 +320,10 @@ class _EcsSnapshotState:
312
320
 
313
321
  @property
314
322
  @pulumi.getter(name="instantAccess")
323
+ @_utilities.deprecated("""Field `instant_access` has been deprecated from provider version 1.231.0.""")
315
324
  def instant_access(self) -> Optional[pulumi.Input[bool]]:
316
325
  """
317
- Specifies whether to enable the instant access feature.
326
+ Field `instant_access` has been deprecated from provider version 1.231.0.
318
327
  """
319
328
  return pulumi.get(self, "instant_access")
320
329
 
@@ -324,9 +333,10 @@ class _EcsSnapshotState:
324
333
 
325
334
  @property
326
335
  @pulumi.getter(name="instantAccessRetentionDays")
336
+ @_utilities.deprecated("""Field `instant_access_retention_days` has been deprecated from provider version 1.231.0.""")
327
337
  def instant_access_retention_days(self) -> Optional[pulumi.Input[int]]:
328
338
  """
329
- Specifies the retention period of the instant access feature. After the retention period ends, the snapshot is automatically released.
339
+ Field `instant_access_retention_days` has been deprecated from provider version 1.231.0.
330
340
  """
331
341
  return pulumi.get(self, "instant_access_retention_days")
332
342
 
@@ -336,7 +346,7 @@ class _EcsSnapshotState:
336
346
 
337
347
  @property
338
348
  @pulumi.getter
339
- @_utilities.deprecated("""Field 'name' has been deprecated from provider version 1.120.0. New field 'snapshot_name' instead.""")
349
+ @_utilities.deprecated("""Field `name` has been deprecated from provider version 1.120.0. New field `snapshot_name` instead.""")
340
350
  def name(self) -> Optional[pulumi.Input[str]]:
341
351
  """
342
352
  Field `name` has been deprecated from provider version 1.120.0. New field `snapshot_name` instead.
@@ -351,7 +361,7 @@ class _EcsSnapshotState:
351
361
  @pulumi.getter(name="resourceGroupId")
352
362
  def resource_group_id(self) -> Optional[pulumi.Input[str]]:
353
363
  """
354
- The resource group id.
364
+ The ID of the resource group.
355
365
  """
356
366
  return pulumi.get(self, "resource_group_id")
357
367
 
@@ -363,7 +373,7 @@ class _EcsSnapshotState:
363
373
  @pulumi.getter(name="retentionDays")
364
374
  def retention_days(self) -> Optional[pulumi.Input[int]]:
365
375
  """
366
- The retention period of the snapshot.
376
+ The retention period of the snapshot. Valid values: `1` to `65536`. **NOTE:** From version 1.231.0, `retention_days` can be modified.
367
377
  """
368
378
  return pulumi.get(self, "retention_days")
369
379
 
@@ -387,7 +397,7 @@ class _EcsSnapshotState:
387
397
  @pulumi.getter
388
398
  def status(self) -> Optional[pulumi.Input[str]]:
389
399
  """
390
- The status of snapshot.
400
+ The status of the Snapshot.
391
401
  """
392
402
  return pulumi.get(self, "status")
393
403
 
@@ -399,9 +409,7 @@ class _EcsSnapshotState:
399
409
  @pulumi.getter
400
410
  def tags(self) -> Optional[pulumi.Input[Mapping[str, pulumi.Input[str]]]]:
401
411
  """
402
- A mapping of tags to assign to the snapshot.
403
-
404
- > **NOTE:** If `force` is true, After an snapshot is deleted, the disks created from this snapshot cannot be re-initialized.
412
+ A mapping of tags to assign to the resource.
405
413
  """
406
414
  return pulumi.get(self, "tags")
407
415
 
@@ -432,7 +440,66 @@ class EcsSnapshot(pulumi.CustomResource):
432
440
 
433
441
  For information about ECS Snapshot and how to use it, see [What is Snapshot](https://www.alibabacloud.com/help/en/doc-detail/25524.htm).
434
442
 
435
- > **NOTE:** Available in v1.120.0+.
443
+ > **NOTE:** Available since v1.120.0.
444
+
445
+ ## Example Usage
446
+
447
+ Basic Usage
448
+
449
+ ```python
450
+ import pulumi
451
+ import pulumi_alicloud as alicloud
452
+
453
+ config = pulumi.Config()
454
+ name = config.get("name")
455
+ if name is None:
456
+ name = "terraform-example"
457
+ default = alicloud.get_zones(available_disk_category="cloud_essd",
458
+ available_resource_creation="VSwitch")
459
+ default_get_images = alicloud.ecs.get_images(most_recent=True,
460
+ owners="system")
461
+ default_get_instance_types = alicloud.ecs.get_instance_types(availability_zone=default.zones[0].id,
462
+ image_id=default_get_images.images[0].id,
463
+ system_disk_category="cloud_essd")
464
+ default_network = alicloud.vpc.Network("default",
465
+ vpc_name=name,
466
+ cidr_block="192.168.0.0/16")
467
+ default_switch = alicloud.vpc.Switch("default",
468
+ vswitch_name=name,
469
+ vpc_id=default_network.id,
470
+ cidr_block="192.168.192.0/24",
471
+ zone_id=default.zones[0].id)
472
+ default_security_group = alicloud.ecs.SecurityGroup("default",
473
+ name=name,
474
+ vpc_id=default_network.id)
475
+ default_instance = alicloud.ecs.Instance("default",
476
+ image_id=default_get_images.images[0].id,
477
+ instance_type=default_get_instance_types.instance_types[0].id,
478
+ security_groups=[__item.id for __item in [default_security_group]],
479
+ internet_charge_type="PayByTraffic",
480
+ internet_max_bandwidth_out=10,
481
+ availability_zone=default_get_instance_types.instance_types[0].availability_zones[0],
482
+ instance_charge_type="PostPaid",
483
+ system_disk_category="cloud_essd",
484
+ vswitch_id=default_switch.id,
485
+ instance_name=name,
486
+ data_disks=[{
487
+ "category": "cloud_essd",
488
+ "size": 20,
489
+ }])
490
+ default_ecs_disk = alicloud.ecs.EcsDisk("default",
491
+ disk_name=name,
492
+ zone_id=default_get_instance_types.instance_types[0].availability_zones[0],
493
+ category="cloud_essd",
494
+ size=500)
495
+ default_ecs_disk_attachment = alicloud.ecs.EcsDiskAttachment("default",
496
+ disk_id=default_ecs_disk.id,
497
+ instance_id=default_instance.id)
498
+ default_ecs_snapshot = alicloud.ecs.EcsSnapshot("default",
499
+ disk_id=default_ecs_disk_attachment.disk_id,
500
+ category="standard",
501
+ retention_days=20)
502
+ ```
436
503
 
437
504
  ## Import
438
505
 
@@ -444,19 +511,17 @@ class EcsSnapshot(pulumi.CustomResource):
444
511
 
445
512
  :param str resource_name: The name of the resource.
446
513
  :param pulumi.ResourceOptions opts: Options for the resource.
447
- :param pulumi.Input[str] category: The category of the snapshot. Valid Values: `standard` and `flash`.
514
+ :param pulumi.Input[str] category: The category of the snapshot. Valid values:
448
515
  :param pulumi.Input[str] description: The description of the snapshot.
449
516
  :param pulumi.Input[str] disk_id: The ID of the disk.
450
- :param pulumi.Input[bool] force: Specifies whether to forcibly delete the snapshot that has been used to create disks.
451
- :param pulumi.Input[bool] instant_access: Specifies whether to enable the instant access feature.
452
- :param pulumi.Input[int] instant_access_retention_days: Specifies the retention period of the instant access feature. After the retention period ends, the snapshot is automatically released.
517
+ :param pulumi.Input[bool] force: Specifies whether to force delete the snapshot that has been used to create disks. Valid values:
518
+ :param pulumi.Input[bool] instant_access: Field `instant_access` has been deprecated from provider version 1.231.0.
519
+ :param pulumi.Input[int] instant_access_retention_days: Field `instant_access_retention_days` has been deprecated from provider version 1.231.0.
453
520
  :param pulumi.Input[str] name: Field `name` has been deprecated from provider version 1.120.0. New field `snapshot_name` instead.
454
- :param pulumi.Input[str] resource_group_id: The resource group id.
455
- :param pulumi.Input[int] retention_days: The retention period of the snapshot.
521
+ :param pulumi.Input[str] resource_group_id: The ID of the resource group.
522
+ :param pulumi.Input[int] retention_days: The retention period of the snapshot. Valid values: `1` to `65536`. **NOTE:** From version 1.231.0, `retention_days` can be modified.
456
523
  :param pulumi.Input[str] snapshot_name: The name of the snapshot.
457
- :param pulumi.Input[Mapping[str, pulumi.Input[str]]] tags: A mapping of tags to assign to the snapshot.
458
-
459
- > **NOTE:** If `force` is true, After an snapshot is deleted, the disks created from this snapshot cannot be re-initialized.
524
+ :param pulumi.Input[Mapping[str, pulumi.Input[str]]] tags: A mapping of tags to assign to the resource.
460
525
  """
461
526
  ...
462
527
  @overload
@@ -469,7 +534,66 @@ class EcsSnapshot(pulumi.CustomResource):
469
534
 
470
535
  For information about ECS Snapshot and how to use it, see [What is Snapshot](https://www.alibabacloud.com/help/en/doc-detail/25524.htm).
471
536
 
472
- > **NOTE:** Available in v1.120.0+.
537
+ > **NOTE:** Available since v1.120.0.
538
+
539
+ ## Example Usage
540
+
541
+ Basic Usage
542
+
543
+ ```python
544
+ import pulumi
545
+ import pulumi_alicloud as alicloud
546
+
547
+ config = pulumi.Config()
548
+ name = config.get("name")
549
+ if name is None:
550
+ name = "terraform-example"
551
+ default = alicloud.get_zones(available_disk_category="cloud_essd",
552
+ available_resource_creation="VSwitch")
553
+ default_get_images = alicloud.ecs.get_images(most_recent=True,
554
+ owners="system")
555
+ default_get_instance_types = alicloud.ecs.get_instance_types(availability_zone=default.zones[0].id,
556
+ image_id=default_get_images.images[0].id,
557
+ system_disk_category="cloud_essd")
558
+ default_network = alicloud.vpc.Network("default",
559
+ vpc_name=name,
560
+ cidr_block="192.168.0.0/16")
561
+ default_switch = alicloud.vpc.Switch("default",
562
+ vswitch_name=name,
563
+ vpc_id=default_network.id,
564
+ cidr_block="192.168.192.0/24",
565
+ zone_id=default.zones[0].id)
566
+ default_security_group = alicloud.ecs.SecurityGroup("default",
567
+ name=name,
568
+ vpc_id=default_network.id)
569
+ default_instance = alicloud.ecs.Instance("default",
570
+ image_id=default_get_images.images[0].id,
571
+ instance_type=default_get_instance_types.instance_types[0].id,
572
+ security_groups=[__item.id for __item in [default_security_group]],
573
+ internet_charge_type="PayByTraffic",
574
+ internet_max_bandwidth_out=10,
575
+ availability_zone=default_get_instance_types.instance_types[0].availability_zones[0],
576
+ instance_charge_type="PostPaid",
577
+ system_disk_category="cloud_essd",
578
+ vswitch_id=default_switch.id,
579
+ instance_name=name,
580
+ data_disks=[{
581
+ "category": "cloud_essd",
582
+ "size": 20,
583
+ }])
584
+ default_ecs_disk = alicloud.ecs.EcsDisk("default",
585
+ disk_name=name,
586
+ zone_id=default_get_instance_types.instance_types[0].availability_zones[0],
587
+ category="cloud_essd",
588
+ size=500)
589
+ default_ecs_disk_attachment = alicloud.ecs.EcsDiskAttachment("default",
590
+ disk_id=default_ecs_disk.id,
591
+ instance_id=default_instance.id)
592
+ default_ecs_snapshot = alicloud.ecs.EcsSnapshot("default",
593
+ disk_id=default_ecs_disk_attachment.disk_id,
594
+ category="standard",
595
+ retention_days=20)
596
+ ```
473
597
 
474
598
  ## Import
475
599
 
@@ -557,20 +681,18 @@ class EcsSnapshot(pulumi.CustomResource):
557
681
  :param str resource_name: The unique name of the resulting resource.
558
682
  :param pulumi.Input[str] id: The unique provider ID of the resource to lookup.
559
683
  :param pulumi.ResourceOptions opts: Options for the resource.
560
- :param pulumi.Input[str] category: The category of the snapshot. Valid Values: `standard` and `flash`.
684
+ :param pulumi.Input[str] category: The category of the snapshot. Valid values:
561
685
  :param pulumi.Input[str] description: The description of the snapshot.
562
686
  :param pulumi.Input[str] disk_id: The ID of the disk.
563
- :param pulumi.Input[bool] force: Specifies whether to forcibly delete the snapshot that has been used to create disks.
564
- :param pulumi.Input[bool] instant_access: Specifies whether to enable the instant access feature.
565
- :param pulumi.Input[int] instant_access_retention_days: Specifies the retention period of the instant access feature. After the retention period ends, the snapshot is automatically released.
687
+ :param pulumi.Input[bool] force: Specifies whether to force delete the snapshot that has been used to create disks. Valid values:
688
+ :param pulumi.Input[bool] instant_access: Field `instant_access` has been deprecated from provider version 1.231.0.
689
+ :param pulumi.Input[int] instant_access_retention_days: Field `instant_access_retention_days` has been deprecated from provider version 1.231.0.
566
690
  :param pulumi.Input[str] name: Field `name` has been deprecated from provider version 1.120.0. New field `snapshot_name` instead.
567
- :param pulumi.Input[str] resource_group_id: The resource group id.
568
- :param pulumi.Input[int] retention_days: The retention period of the snapshot.
691
+ :param pulumi.Input[str] resource_group_id: The ID of the resource group.
692
+ :param pulumi.Input[int] retention_days: The retention period of the snapshot. Valid values: `1` to `65536`. **NOTE:** From version 1.231.0, `retention_days` can be modified.
569
693
  :param pulumi.Input[str] snapshot_name: The name of the snapshot.
570
- :param pulumi.Input[str] status: The status of snapshot.
571
- :param pulumi.Input[Mapping[str, pulumi.Input[str]]] tags: A mapping of tags to assign to the snapshot.
572
-
573
- > **NOTE:** If `force` is true, After an snapshot is deleted, the disks created from this snapshot cannot be re-initialized.
694
+ :param pulumi.Input[str] status: The status of the Snapshot.
695
+ :param pulumi.Input[Mapping[str, pulumi.Input[str]]] tags: A mapping of tags to assign to the resource.
574
696
  """
575
697
  opts = pulumi.ResourceOptions.merge(opts, pulumi.ResourceOptions(id=id))
576
698
 
@@ -592,9 +714,9 @@ class EcsSnapshot(pulumi.CustomResource):
592
714
 
593
715
  @property
594
716
  @pulumi.getter
595
- def category(self) -> pulumi.Output[Optional[str]]:
717
+ def category(self) -> pulumi.Output[str]:
596
718
  """
597
- The category of the snapshot. Valid Values: `standard` and `flash`.
719
+ The category of the snapshot. Valid values:
598
720
  """
599
721
  return pulumi.get(self, "category")
600
722
 
@@ -618,29 +740,31 @@ class EcsSnapshot(pulumi.CustomResource):
618
740
  @pulumi.getter
619
741
  def force(self) -> pulumi.Output[Optional[bool]]:
620
742
  """
621
- Specifies whether to forcibly delete the snapshot that has been used to create disks.
743
+ Specifies whether to force delete the snapshot that has been used to create disks. Valid values:
622
744
  """
623
745
  return pulumi.get(self, "force")
624
746
 
625
747
  @property
626
748
  @pulumi.getter(name="instantAccess")
749
+ @_utilities.deprecated("""Field `instant_access` has been deprecated from provider version 1.231.0.""")
627
750
  def instant_access(self) -> pulumi.Output[Optional[bool]]:
628
751
  """
629
- Specifies whether to enable the instant access feature.
752
+ Field `instant_access` has been deprecated from provider version 1.231.0.
630
753
  """
631
754
  return pulumi.get(self, "instant_access")
632
755
 
633
756
  @property
634
757
  @pulumi.getter(name="instantAccessRetentionDays")
758
+ @_utilities.deprecated("""Field `instant_access_retention_days` has been deprecated from provider version 1.231.0.""")
635
759
  def instant_access_retention_days(self) -> pulumi.Output[Optional[int]]:
636
760
  """
637
- Specifies the retention period of the instant access feature. After the retention period ends, the snapshot is automatically released.
761
+ Field `instant_access_retention_days` has been deprecated from provider version 1.231.0.
638
762
  """
639
763
  return pulumi.get(self, "instant_access_retention_days")
640
764
 
641
765
  @property
642
766
  @pulumi.getter
643
- @_utilities.deprecated("""Field 'name' has been deprecated from provider version 1.120.0. New field 'snapshot_name' instead.""")
767
+ @_utilities.deprecated("""Field `name` has been deprecated from provider version 1.120.0. New field `snapshot_name` instead.""")
644
768
  def name(self) -> pulumi.Output[str]:
645
769
  """
646
770
  Field `name` has been deprecated from provider version 1.120.0. New field `snapshot_name` instead.
@@ -651,7 +775,7 @@ class EcsSnapshot(pulumi.CustomResource):
651
775
  @pulumi.getter(name="resourceGroupId")
652
776
  def resource_group_id(self) -> pulumi.Output[Optional[str]]:
653
777
  """
654
- The resource group id.
778
+ The ID of the resource group.
655
779
  """
656
780
  return pulumi.get(self, "resource_group_id")
657
781
 
@@ -659,7 +783,7 @@ class EcsSnapshot(pulumi.CustomResource):
659
783
  @pulumi.getter(name="retentionDays")
660
784
  def retention_days(self) -> pulumi.Output[Optional[int]]:
661
785
  """
662
- The retention period of the snapshot.
786
+ The retention period of the snapshot. Valid values: `1` to `65536`. **NOTE:** From version 1.231.0, `retention_days` can be modified.
663
787
  """
664
788
  return pulumi.get(self, "retention_days")
665
789
 
@@ -675,7 +799,7 @@ class EcsSnapshot(pulumi.CustomResource):
675
799
  @pulumi.getter
676
800
  def status(self) -> pulumi.Output[str]:
677
801
  """
678
- The status of snapshot.
802
+ The status of the Snapshot.
679
803
  """
680
804
  return pulumi.get(self, "status")
681
805
 
@@ -683,9 +807,7 @@ class EcsSnapshot(pulumi.CustomResource):
683
807
  @pulumi.getter
684
808
  def tags(self) -> pulumi.Output[Optional[Mapping[str, str]]]:
685
809
  """
686
- A mapping of tags to assign to the snapshot.
687
-
688
- > **NOTE:** If `force` is true, After an snapshot is deleted, the disks created from this snapshot cannot be re-initialized.
810
+ A mapping of tags to assign to the resource.
689
811
  """
690
812
  return pulumi.get(self, "tags")
691
813