pulumiverse-scaleway 1.16.0a1730122985__py3-none-any.whl → 1.17.0a1730194779__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 pulumiverse-scaleway might be problematic. Click here for more details.

Files changed (34) hide show
  1. pulumiverse_scaleway/__init__.py +10 -0
  2. pulumiverse_scaleway/_inputs.py +165 -60
  3. pulumiverse_scaleway/block_snapshot.py +37 -27
  4. pulumiverse_scaleway/block_volume.py +49 -43
  5. pulumiverse_scaleway/cockpit.py +39 -24
  6. pulumiverse_scaleway/cockpit_alert_manager.py +42 -38
  7. pulumiverse_scaleway/cockpit_grafana_user.py +39 -31
  8. pulumiverse_scaleway/cockpit_source.py +86 -50
  9. pulumiverse_scaleway/cockpit_token.py +45 -27
  10. pulumiverse_scaleway/database_instance.py +13 -8
  11. pulumiverse_scaleway/domain_record.py +88 -46
  12. pulumiverse_scaleway/domain_zone.py +47 -75
  13. pulumiverse_scaleway/get_block_snapshot.py +16 -12
  14. pulumiverse_scaleway/get_block_volume.py +10 -8
  15. pulumiverse_scaleway/get_cockpit.py +44 -19
  16. pulumiverse_scaleway/get_cockpit_plan.py +18 -6
  17. pulumiverse_scaleway/get_domain_record.py +40 -34
  18. pulumiverse_scaleway/get_domain_zone.py +12 -36
  19. pulumiverse_scaleway/get_mnq_sns.py +150 -0
  20. pulumiverse_scaleway/get_secret.py +77 -29
  21. pulumiverse_scaleway/get_secret_version.py +75 -38
  22. pulumiverse_scaleway/iam_policy.py +46 -0
  23. pulumiverse_scaleway/instance_server.py +56 -4
  24. pulumiverse_scaleway/loadbalancer_frontend.py +4 -4
  25. pulumiverse_scaleway/outputs.py +169 -55
  26. pulumiverse_scaleway/pulumi-plugin.json +1 -1
  27. pulumiverse_scaleway/secret.py +162 -59
  28. pulumiverse_scaleway/secret_version.py +59 -54
  29. pulumiverse_scaleway/tem_domain.py +9 -4
  30. pulumiverse_scaleway/tem_webhook.py +640 -0
  31. {pulumiverse_scaleway-1.16.0a1730122985.dist-info → pulumiverse_scaleway-1.17.0a1730194779.dist-info}/METADATA +1 -1
  32. {pulumiverse_scaleway-1.16.0a1730122985.dist-info → pulumiverse_scaleway-1.17.0a1730194779.dist-info}/RECORD +34 -32
  33. {pulumiverse_scaleway-1.16.0a1730122985.dist-info → pulumiverse_scaleway-1.17.0a1730194779.dist-info}/WHEEL +0 -0
  34. {pulumiverse_scaleway-1.16.0a1730122985.dist-info → pulumiverse_scaleway-1.17.0a1730194779.dist-info}/top_level.txt +0 -0
@@ -27,10 +27,10 @@ class BlockSnapshotArgs:
27
27
  """
28
28
  The set of arguments for constructing a BlockSnapshot resource.
29
29
  :param pulumi.Input[str] volume_id: The ID of the volume to take a snapshot from.
30
- :param pulumi.Input[str] name: The name of the snapshot. If not provided it will be randomly generated.
31
- :param pulumi.Input[str] project_id: `project_id`) The ID of the project the snapshot is associated with.
30
+ :param pulumi.Input[str] name: The name of the snapshot. If not provided, a name will be randomly generated.
31
+ :param pulumi.Input[str] project_id: ). The ID of the Scaleway Project the snapshot is associated with.
32
32
  :param pulumi.Input[Sequence[pulumi.Input[str]]] tags: A list of tags to apply to the snapshot.
33
- :param pulumi.Input[str] zone: `zone`) The zone in which the snapshot should be created.
33
+ :param pulumi.Input[str] zone: ). The zone in which the snapshot should be created.
34
34
  """
35
35
  pulumi.set(__self__, "volume_id", volume_id)
36
36
  if name is not None:
@@ -58,7 +58,7 @@ class BlockSnapshotArgs:
58
58
  @pulumi.getter
59
59
  def name(self) -> Optional[pulumi.Input[str]]:
60
60
  """
61
- The name of the snapshot. If not provided it will be randomly generated.
61
+ The name of the snapshot. If not provided, a name will be randomly generated.
62
62
  """
63
63
  return pulumi.get(self, "name")
64
64
 
@@ -70,7 +70,7 @@ class BlockSnapshotArgs:
70
70
  @pulumi.getter(name="projectId")
71
71
  def project_id(self) -> Optional[pulumi.Input[str]]:
72
72
  """
73
- `project_id`) The ID of the project the snapshot is associated with.
73
+ ). The ID of the Scaleway Project the snapshot is associated with.
74
74
  """
75
75
  return pulumi.get(self, "project_id")
76
76
 
@@ -94,7 +94,7 @@ class BlockSnapshotArgs:
94
94
  @pulumi.getter
95
95
  def zone(self) -> Optional[pulumi.Input[str]]:
96
96
  """
97
- `zone`) The zone in which the snapshot should be created.
97
+ ). The zone in which the snapshot should be created.
98
98
  """
99
99
  return pulumi.get(self, "zone")
100
100
 
@@ -113,11 +113,11 @@ class _BlockSnapshotState:
113
113
  zone: Optional[pulumi.Input[str]] = None):
114
114
  """
115
115
  Input properties used for looking up and filtering BlockSnapshot resources.
116
- :param pulumi.Input[str] name: The name of the snapshot. If not provided it will be randomly generated.
117
- :param pulumi.Input[str] project_id: `project_id`) The ID of the project the snapshot is associated with.
116
+ :param pulumi.Input[str] name: The name of the snapshot. If not provided, a name will be randomly generated.
117
+ :param pulumi.Input[str] project_id: ). The ID of the Scaleway Project the snapshot is associated with.
118
118
  :param pulumi.Input[Sequence[pulumi.Input[str]]] tags: A list of tags to apply to the snapshot.
119
119
  :param pulumi.Input[str] volume_id: The ID of the volume to take a snapshot from.
120
- :param pulumi.Input[str] zone: `zone`) The zone in which the snapshot should be created.
120
+ :param pulumi.Input[str] zone: ). The zone in which the snapshot should be created.
121
121
  """
122
122
  if name is not None:
123
123
  pulumi.set(__self__, "name", name)
@@ -134,7 +134,7 @@ class _BlockSnapshotState:
134
134
  @pulumi.getter
135
135
  def name(self) -> Optional[pulumi.Input[str]]:
136
136
  """
137
- The name of the snapshot. If not provided it will be randomly generated.
137
+ The name of the snapshot. If not provided, a name will be randomly generated.
138
138
  """
139
139
  return pulumi.get(self, "name")
140
140
 
@@ -146,7 +146,7 @@ class _BlockSnapshotState:
146
146
  @pulumi.getter(name="projectId")
147
147
  def project_id(self) -> Optional[pulumi.Input[str]]:
148
148
  """
149
- `project_id`) The ID of the project the snapshot is associated with.
149
+ ). The ID of the Scaleway Project the snapshot is associated with.
150
150
  """
151
151
  return pulumi.get(self, "project_id")
152
152
 
@@ -182,7 +182,7 @@ class _BlockSnapshotState:
182
182
  @pulumi.getter
183
183
  def zone(self) -> Optional[pulumi.Input[str]]:
184
184
  """
185
- `zone`) The zone in which the snapshot should be created.
185
+ ). The zone in which the snapshot should be created.
186
186
  """
187
187
  return pulumi.get(self, "zone")
188
188
 
@@ -203,11 +203,16 @@ class BlockSnapshot(pulumi.CustomResource):
203
203
  zone: Optional[pulumi.Input[str]] = None,
204
204
  __props__=None):
205
205
  """
206
- Creates and manages Scaleway Block Snapshots.
207
- For more information, see [the documentation](https://www.scaleway.com/en/developers/api/block/).
206
+ The `BlockSnapshot` resource is used to create and manage snapshots of Block Storage volumes.
207
+
208
+ Refer to the Block Storage [product documentation](https://www.scaleway.com/en/docs/storage/block/) and [API documentation](https://www.scaleway.com/en/developers/api/block/) for more information.
208
209
 
209
210
  ## Example Usage
210
211
 
212
+ ### Create a snapshot of a Block Storage volume
213
+
214
+ The following command allows you to create a snapshot (`some-snapshot-name`) from a Block Storage volume specified by its ID.
215
+
211
216
  ```python
212
217
  import pulumi
213
218
  import pulumiverse_scaleway as scaleway
@@ -223,7 +228,7 @@ class BlockSnapshot(pulumi.CustomResource):
223
228
 
224
229
  ## Import
225
230
 
226
- Block Snapshots can be imported using the `{zone}/{id}`, e.g.
231
+ This section explains how to import the snapshot of a Block Storage volume using the zoned ID format (`{zone}/{id}`).
227
232
 
228
233
  bash
229
234
 
@@ -233,11 +238,11 @@ class BlockSnapshot(pulumi.CustomResource):
233
238
 
234
239
  :param str resource_name: The name of the resource.
235
240
  :param pulumi.ResourceOptions opts: Options for the resource.
236
- :param pulumi.Input[str] name: The name of the snapshot. If not provided it will be randomly generated.
237
- :param pulumi.Input[str] project_id: `project_id`) The ID of the project the snapshot is associated with.
241
+ :param pulumi.Input[str] name: The name of the snapshot. If not provided, a name will be randomly generated.
242
+ :param pulumi.Input[str] project_id: ). The ID of the Scaleway Project the snapshot is associated with.
238
243
  :param pulumi.Input[Sequence[pulumi.Input[str]]] tags: A list of tags to apply to the snapshot.
239
244
  :param pulumi.Input[str] volume_id: The ID of the volume to take a snapshot from.
240
- :param pulumi.Input[str] zone: `zone`) The zone in which the snapshot should be created.
245
+ :param pulumi.Input[str] zone: ). The zone in which the snapshot should be created.
241
246
  """
242
247
  ...
243
248
  @overload
@@ -246,11 +251,16 @@ class BlockSnapshot(pulumi.CustomResource):
246
251
  args: BlockSnapshotArgs,
247
252
  opts: Optional[pulumi.ResourceOptions] = None):
248
253
  """
249
- Creates and manages Scaleway Block Snapshots.
250
- For more information, see [the documentation](https://www.scaleway.com/en/developers/api/block/).
254
+ The `BlockSnapshot` resource is used to create and manage snapshots of Block Storage volumes.
255
+
256
+ Refer to the Block Storage [product documentation](https://www.scaleway.com/en/docs/storage/block/) and [API documentation](https://www.scaleway.com/en/developers/api/block/) for more information.
251
257
 
252
258
  ## Example Usage
253
259
 
260
+ ### Create a snapshot of a Block Storage volume
261
+
262
+ The following command allows you to create a snapshot (`some-snapshot-name`) from a Block Storage volume specified by its ID.
263
+
254
264
  ```python
255
265
  import pulumi
256
266
  import pulumiverse_scaleway as scaleway
@@ -266,7 +276,7 @@ class BlockSnapshot(pulumi.CustomResource):
266
276
 
267
277
  ## Import
268
278
 
269
- Block Snapshots can be imported using the `{zone}/{id}`, e.g.
279
+ This section explains how to import the snapshot of a Block Storage volume using the zoned ID format (`{zone}/{id}`).
270
280
 
271
281
  bash
272
282
 
@@ -332,11 +342,11 @@ class BlockSnapshot(pulumi.CustomResource):
332
342
  :param str resource_name: The unique name of the resulting resource.
333
343
  :param pulumi.Input[str] id: The unique provider ID of the resource to lookup.
334
344
  :param pulumi.ResourceOptions opts: Options for the resource.
335
- :param pulumi.Input[str] name: The name of the snapshot. If not provided it will be randomly generated.
336
- :param pulumi.Input[str] project_id: `project_id`) The ID of the project the snapshot is associated with.
345
+ :param pulumi.Input[str] name: The name of the snapshot. If not provided, a name will be randomly generated.
346
+ :param pulumi.Input[str] project_id: ). The ID of the Scaleway Project the snapshot is associated with.
337
347
  :param pulumi.Input[Sequence[pulumi.Input[str]]] tags: A list of tags to apply to the snapshot.
338
348
  :param pulumi.Input[str] volume_id: The ID of the volume to take a snapshot from.
339
- :param pulumi.Input[str] zone: `zone`) The zone in which the snapshot should be created.
349
+ :param pulumi.Input[str] zone: ). The zone in which the snapshot should be created.
340
350
  """
341
351
  opts = pulumi.ResourceOptions.merge(opts, pulumi.ResourceOptions(id=id))
342
352
 
@@ -353,7 +363,7 @@ class BlockSnapshot(pulumi.CustomResource):
353
363
  @pulumi.getter
354
364
  def name(self) -> pulumi.Output[str]:
355
365
  """
356
- The name of the snapshot. If not provided it will be randomly generated.
366
+ The name of the snapshot. If not provided, a name will be randomly generated.
357
367
  """
358
368
  return pulumi.get(self, "name")
359
369
 
@@ -361,7 +371,7 @@ class BlockSnapshot(pulumi.CustomResource):
361
371
  @pulumi.getter(name="projectId")
362
372
  def project_id(self) -> pulumi.Output[str]:
363
373
  """
364
- `project_id`) The ID of the project the snapshot is associated with.
374
+ ). The ID of the Scaleway Project the snapshot is associated with.
365
375
  """
366
376
  return pulumi.get(self, "project_id")
367
377
 
@@ -385,7 +395,7 @@ class BlockSnapshot(pulumi.CustomResource):
385
395
  @pulumi.getter
386
396
  def zone(self) -> pulumi.Output[str]:
387
397
  """
388
- `zone`) The zone in which the snapshot should be created.
398
+ ). The zone in which the snapshot should be created.
389
399
  """
390
400
  return pulumi.get(self, "zone")
391
401
 
@@ -28,13 +28,13 @@ class BlockVolumeArgs:
28
28
  zone: Optional[pulumi.Input[str]] = None):
29
29
  """
30
30
  The set of arguments for constructing a BlockVolume resource.
31
- :param pulumi.Input[int] iops: The maximum IO/s expected, must match available options.
32
- :param pulumi.Input[str] name: The name of the volume. If not provided it will be randomly generated.
33
- :param pulumi.Input[str] project_id: `project_id`) The ID of the project the volume is associated with.
34
- :param pulumi.Input[int] size_in_gb: The size of the volume. Only one of `size_in_gb`, and `snapshot_id` should be specified.
31
+ :param pulumi.Input[int] iops: The maximum [IOPs](https://www.scaleway.com/en/docs/storage/block/concepts/#iops) expected, must match available options.
32
+ :param pulumi.Input[str] name: The name of the volume. If not provided, a name will be randomly generated.
33
+ :param pulumi.Input[str] project_id: ). The ID of the Project the volume is associated with.
34
+ :param pulumi.Input[int] size_in_gb: The size of the volume in gigabytes. Only one of `size_in_gb`, and `snapshot_id` should be specified.
35
35
  :param pulumi.Input[str] snapshot_id: If set, the new volume will be created from this snapshot. Only one of `size_in_gb`, `snapshot_id` should be specified.
36
36
  :param pulumi.Input[Sequence[pulumi.Input[str]]] tags: A list of tags to apply to the volume.
37
- :param pulumi.Input[str] zone: `zone`) The zone in which the volume should be created.
37
+ :param pulumi.Input[str] zone: ). The zone in which the volume should be created.
38
38
  """
39
39
  pulumi.set(__self__, "iops", iops)
40
40
  if name is not None:
@@ -54,7 +54,7 @@ class BlockVolumeArgs:
54
54
  @pulumi.getter
55
55
  def iops(self) -> pulumi.Input[int]:
56
56
  """
57
- The maximum IO/s expected, must match available options.
57
+ The maximum [IOPs](https://www.scaleway.com/en/docs/storage/block/concepts/#iops) expected, must match available options.
58
58
  """
59
59
  return pulumi.get(self, "iops")
60
60
 
@@ -66,7 +66,7 @@ class BlockVolumeArgs:
66
66
  @pulumi.getter
67
67
  def name(self) -> Optional[pulumi.Input[str]]:
68
68
  """
69
- The name of the volume. If not provided it will be randomly generated.
69
+ The name of the volume. If not provided, a name will be randomly generated.
70
70
  """
71
71
  return pulumi.get(self, "name")
72
72
 
@@ -78,7 +78,7 @@ class BlockVolumeArgs:
78
78
  @pulumi.getter(name="projectId")
79
79
  def project_id(self) -> Optional[pulumi.Input[str]]:
80
80
  """
81
- `project_id`) The ID of the project the volume is associated with.
81
+ ). The ID of the Project the volume is associated with.
82
82
  """
83
83
  return pulumi.get(self, "project_id")
84
84
 
@@ -90,7 +90,7 @@ class BlockVolumeArgs:
90
90
  @pulumi.getter(name="sizeInGb")
91
91
  def size_in_gb(self) -> Optional[pulumi.Input[int]]:
92
92
  """
93
- The size of the volume. Only one of `size_in_gb`, and `snapshot_id` should be specified.
93
+ The size of the volume in gigabytes. Only one of `size_in_gb`, and `snapshot_id` should be specified.
94
94
  """
95
95
  return pulumi.get(self, "size_in_gb")
96
96
 
@@ -126,7 +126,7 @@ class BlockVolumeArgs:
126
126
  @pulumi.getter
127
127
  def zone(self) -> Optional[pulumi.Input[str]]:
128
128
  """
129
- `zone`) The zone in which the volume should be created.
129
+ ). The zone in which the volume should be created.
130
130
  """
131
131
  return pulumi.get(self, "zone")
132
132
 
@@ -147,13 +147,13 @@ class _BlockVolumeState:
147
147
  zone: Optional[pulumi.Input[str]] = None):
148
148
  """
149
149
  Input properties used for looking up and filtering BlockVolume resources.
150
- :param pulumi.Input[int] iops: The maximum IO/s expected, must match available options.
151
- :param pulumi.Input[str] name: The name of the volume. If not provided it will be randomly generated.
152
- :param pulumi.Input[str] project_id: `project_id`) The ID of the project the volume is associated with.
153
- :param pulumi.Input[int] size_in_gb: The size of the volume. Only one of `size_in_gb`, and `snapshot_id` should be specified.
150
+ :param pulumi.Input[int] iops: The maximum [IOPs](https://www.scaleway.com/en/docs/storage/block/concepts/#iops) expected, must match available options.
151
+ :param pulumi.Input[str] name: The name of the volume. If not provided, a name will be randomly generated.
152
+ :param pulumi.Input[str] project_id: ). The ID of the Project the volume is associated with.
153
+ :param pulumi.Input[int] size_in_gb: The size of the volume in gigabytes. Only one of `size_in_gb`, and `snapshot_id` should be specified.
154
154
  :param pulumi.Input[str] snapshot_id: If set, the new volume will be created from this snapshot. Only one of `size_in_gb`, `snapshot_id` should be specified.
155
155
  :param pulumi.Input[Sequence[pulumi.Input[str]]] tags: A list of tags to apply to the volume.
156
- :param pulumi.Input[str] zone: `zone`) The zone in which the volume should be created.
156
+ :param pulumi.Input[str] zone: ). The zone in which the volume should be created.
157
157
  """
158
158
  if iops is not None:
159
159
  pulumi.set(__self__, "iops", iops)
@@ -174,7 +174,7 @@ class _BlockVolumeState:
174
174
  @pulumi.getter
175
175
  def iops(self) -> Optional[pulumi.Input[int]]:
176
176
  """
177
- The maximum IO/s expected, must match available options.
177
+ The maximum [IOPs](https://www.scaleway.com/en/docs/storage/block/concepts/#iops) expected, must match available options.
178
178
  """
179
179
  return pulumi.get(self, "iops")
180
180
 
@@ -186,7 +186,7 @@ class _BlockVolumeState:
186
186
  @pulumi.getter
187
187
  def name(self) -> Optional[pulumi.Input[str]]:
188
188
  """
189
- The name of the volume. If not provided it will be randomly generated.
189
+ The name of the volume. If not provided, a name will be randomly generated.
190
190
  """
191
191
  return pulumi.get(self, "name")
192
192
 
@@ -198,7 +198,7 @@ class _BlockVolumeState:
198
198
  @pulumi.getter(name="projectId")
199
199
  def project_id(self) -> Optional[pulumi.Input[str]]:
200
200
  """
201
- `project_id`) The ID of the project the volume is associated with.
201
+ ). The ID of the Project the volume is associated with.
202
202
  """
203
203
  return pulumi.get(self, "project_id")
204
204
 
@@ -210,7 +210,7 @@ class _BlockVolumeState:
210
210
  @pulumi.getter(name="sizeInGb")
211
211
  def size_in_gb(self) -> Optional[pulumi.Input[int]]:
212
212
  """
213
- The size of the volume. Only one of `size_in_gb`, and `snapshot_id` should be specified.
213
+ The size of the volume in gigabytes. Only one of `size_in_gb`, and `snapshot_id` should be specified.
214
214
  """
215
215
  return pulumi.get(self, "size_in_gb")
216
216
 
@@ -246,7 +246,7 @@ class _BlockVolumeState:
246
246
  @pulumi.getter
247
247
  def zone(self) -> Optional[pulumi.Input[str]]:
248
248
  """
249
- `zone`) The zone in which the volume should be created.
249
+ ). The zone in which the volume should be created.
250
250
  """
251
251
  return pulumi.get(self, "zone")
252
252
 
@@ -269,12 +269,15 @@ class BlockVolume(pulumi.CustomResource):
269
269
  zone: Optional[pulumi.Input[str]] = None,
270
270
  __props__=None):
271
271
  """
272
- Creates and manages Scaleway Block Volumes.
273
- For more information, see [the documentation](https://www.scaleway.com/en/developers/api/block/).
272
+ The `BlockVolume` resource is used to create and manage Scaleway Block Storage volumes.
273
+
274
+ Refer to the Block Storage [product documentation](https://www.scaleway.com/en/docs/storage/block/) and [API documentation](https://www.scaleway.com/en/developers/api/block/) for more information.
274
275
 
275
276
  ## Example Usage
276
277
 
277
- ### Basic
278
+ ### Create a Block Storage volume
279
+
280
+ The following command allows you to create a Block Storage volume of 20 GB with a 5000 [IOPS](https://www.scaleway.com/en/docs/storage/block/concepts/#iops).
278
281
 
279
282
  ```python
280
283
  import pulumi
@@ -307,7 +310,7 @@ class BlockVolume(pulumi.CustomResource):
307
310
 
308
311
  ## Import
309
312
 
310
- Block Volumes can be imported using the `{zone}/{id}`, e.g.
313
+ This section explains how to import a Block Storage volume using the zoned ID (`{zone}/{id}`) format.
311
314
 
312
315
  bash
313
316
 
@@ -317,13 +320,13 @@ class BlockVolume(pulumi.CustomResource):
317
320
 
318
321
  :param str resource_name: The name of the resource.
319
322
  :param pulumi.ResourceOptions opts: Options for the resource.
320
- :param pulumi.Input[int] iops: The maximum IO/s expected, must match available options.
321
- :param pulumi.Input[str] name: The name of the volume. If not provided it will be randomly generated.
322
- :param pulumi.Input[str] project_id: `project_id`) The ID of the project the volume is associated with.
323
- :param pulumi.Input[int] size_in_gb: The size of the volume. Only one of `size_in_gb`, and `snapshot_id` should be specified.
323
+ :param pulumi.Input[int] iops: The maximum [IOPs](https://www.scaleway.com/en/docs/storage/block/concepts/#iops) expected, must match available options.
324
+ :param pulumi.Input[str] name: The name of the volume. If not provided, a name will be randomly generated.
325
+ :param pulumi.Input[str] project_id: ). The ID of the Project the volume is associated with.
326
+ :param pulumi.Input[int] size_in_gb: The size of the volume in gigabytes. Only one of `size_in_gb`, and `snapshot_id` should be specified.
324
327
  :param pulumi.Input[str] snapshot_id: If set, the new volume will be created from this snapshot. Only one of `size_in_gb`, `snapshot_id` should be specified.
325
328
  :param pulumi.Input[Sequence[pulumi.Input[str]]] tags: A list of tags to apply to the volume.
326
- :param pulumi.Input[str] zone: `zone`) The zone in which the volume should be created.
329
+ :param pulumi.Input[str] zone: ). The zone in which the volume should be created.
327
330
  """
328
331
  ...
329
332
  @overload
@@ -332,12 +335,15 @@ class BlockVolume(pulumi.CustomResource):
332
335
  args: BlockVolumeArgs,
333
336
  opts: Optional[pulumi.ResourceOptions] = None):
334
337
  """
335
- Creates and manages Scaleway Block Volumes.
336
- For more information, see [the documentation](https://www.scaleway.com/en/developers/api/block/).
338
+ The `BlockVolume` resource is used to create and manage Scaleway Block Storage volumes.
339
+
340
+ Refer to the Block Storage [product documentation](https://www.scaleway.com/en/docs/storage/block/) and [API documentation](https://www.scaleway.com/en/developers/api/block/) for more information.
337
341
 
338
342
  ## Example Usage
339
343
 
340
- ### Basic
344
+ ### Create a Block Storage volume
345
+
346
+ The following command allows you to create a Block Storage volume of 20 GB with a 5000 [IOPS](https://www.scaleway.com/en/docs/storage/block/concepts/#iops).
341
347
 
342
348
  ```python
343
349
  import pulumi
@@ -370,7 +376,7 @@ class BlockVolume(pulumi.CustomResource):
370
376
 
371
377
  ## Import
372
378
 
373
- Block Volumes can be imported using the `{zone}/{id}`, e.g.
379
+ This section explains how to import a Block Storage volume using the zoned ID (`{zone}/{id}`) format.
374
380
 
375
381
  bash
376
382
 
@@ -442,13 +448,13 @@ class BlockVolume(pulumi.CustomResource):
442
448
  :param str resource_name: The unique name of the resulting resource.
443
449
  :param pulumi.Input[str] id: The unique provider ID of the resource to lookup.
444
450
  :param pulumi.ResourceOptions opts: Options for the resource.
445
- :param pulumi.Input[int] iops: The maximum IO/s expected, must match available options.
446
- :param pulumi.Input[str] name: The name of the volume. If not provided it will be randomly generated.
447
- :param pulumi.Input[str] project_id: `project_id`) The ID of the project the volume is associated with.
448
- :param pulumi.Input[int] size_in_gb: The size of the volume. Only one of `size_in_gb`, and `snapshot_id` should be specified.
451
+ :param pulumi.Input[int] iops: The maximum [IOPs](https://www.scaleway.com/en/docs/storage/block/concepts/#iops) expected, must match available options.
452
+ :param pulumi.Input[str] name: The name of the volume. If not provided, a name will be randomly generated.
453
+ :param pulumi.Input[str] project_id: ). The ID of the Project the volume is associated with.
454
+ :param pulumi.Input[int] size_in_gb: The size of the volume in gigabytes. Only one of `size_in_gb`, and `snapshot_id` should be specified.
449
455
  :param pulumi.Input[str] snapshot_id: If set, the new volume will be created from this snapshot. Only one of `size_in_gb`, `snapshot_id` should be specified.
450
456
  :param pulumi.Input[Sequence[pulumi.Input[str]]] tags: A list of tags to apply to the volume.
451
- :param pulumi.Input[str] zone: `zone`) The zone in which the volume should be created.
457
+ :param pulumi.Input[str] zone: ). The zone in which the volume should be created.
452
458
  """
453
459
  opts = pulumi.ResourceOptions.merge(opts, pulumi.ResourceOptions(id=id))
454
460
 
@@ -467,7 +473,7 @@ class BlockVolume(pulumi.CustomResource):
467
473
  @pulumi.getter
468
474
  def iops(self) -> pulumi.Output[int]:
469
475
  """
470
- The maximum IO/s expected, must match available options.
476
+ The maximum [IOPs](https://www.scaleway.com/en/docs/storage/block/concepts/#iops) expected, must match available options.
471
477
  """
472
478
  return pulumi.get(self, "iops")
473
479
 
@@ -475,7 +481,7 @@ class BlockVolume(pulumi.CustomResource):
475
481
  @pulumi.getter
476
482
  def name(self) -> pulumi.Output[str]:
477
483
  """
478
- The name of the volume. If not provided it will be randomly generated.
484
+ The name of the volume. If not provided, a name will be randomly generated.
479
485
  """
480
486
  return pulumi.get(self, "name")
481
487
 
@@ -483,7 +489,7 @@ class BlockVolume(pulumi.CustomResource):
483
489
  @pulumi.getter(name="projectId")
484
490
  def project_id(self) -> pulumi.Output[str]:
485
491
  """
486
- `project_id`) The ID of the project the volume is associated with.
492
+ ). The ID of the Project the volume is associated with.
487
493
  """
488
494
  return pulumi.get(self, "project_id")
489
495
 
@@ -491,7 +497,7 @@ class BlockVolume(pulumi.CustomResource):
491
497
  @pulumi.getter(name="sizeInGb")
492
498
  def size_in_gb(self) -> pulumi.Output[int]:
493
499
  """
494
- The size of the volume. Only one of `size_in_gb`, and `snapshot_id` should be specified.
500
+ The size of the volume in gigabytes. Only one of `size_in_gb`, and `snapshot_id` should be specified.
495
501
  """
496
502
  return pulumi.get(self, "size_in_gb")
497
503
 
@@ -515,7 +521,7 @@ class BlockVolume(pulumi.CustomResource):
515
521
  @pulumi.getter
516
522
  def zone(self) -> pulumi.Output[str]:
517
523
  """
518
- `zone`) The zone in which the volume should be created.
524
+ ). The zone in which the volume should be created.
519
525
  """
520
526
  return pulumi.get(self, "zone")
521
527
 
@@ -25,8 +25,8 @@ class CockpitArgs:
25
25
  project_id: Optional[pulumi.Input[str]] = None):
26
26
  """
27
27
  The set of arguments for constructing a Cockpit resource.
28
- :param pulumi.Input[str] plan: Name or ID of the plan to use.
29
- :param pulumi.Input[str] project_id: `project_id`) The ID of the project the cockpit is associated with.
28
+ :param pulumi.Input[str] plan: Name of the plan to use. Available plans are: free, premium, and custom.
29
+ :param pulumi.Input[str] project_id: ) The ID of the Project the Cockpit is associated with.
30
30
  """
31
31
  if plan is not None:
32
32
  pulumi.set(__self__, "plan", plan)
@@ -37,7 +37,7 @@ class CockpitArgs:
37
37
  @pulumi.getter
38
38
  def plan(self) -> Optional[pulumi.Input[str]]:
39
39
  """
40
- Name or ID of the plan to use.
40
+ Name of the plan to use. Available plans are: free, premium, and custom.
41
41
  """
42
42
  return pulumi.get(self, "plan")
43
43
 
@@ -49,7 +49,7 @@ class CockpitArgs:
49
49
  @pulumi.getter(name="projectId")
50
50
  def project_id(self) -> Optional[pulumi.Input[str]]:
51
51
  """
52
- `project_id`) The ID of the project the cockpit is associated with.
52
+ ) The ID of the Project the Cockpit is associated with.
53
53
  """
54
54
  return pulumi.get(self, "project_id")
55
55
 
@@ -68,28 +68,38 @@ class _CockpitState:
68
68
  push_urls: Optional[pulumi.Input[Sequence[pulumi.Input['CockpitPushUrlArgs']]]] = None):
69
69
  """
70
70
  Input properties used for looking up and filtering Cockpit resources.
71
- :param pulumi.Input[Sequence[pulumi.Input['CockpitEndpointArgs']]] endpoints: Endpoints.
72
- :param pulumi.Input[str] plan: Name or ID of the plan to use.
73
- :param pulumi.Input[str] plan_id: The ID of the current plan.
74
- :param pulumi.Input[str] project_id: `project_id`) The ID of the project the cockpit is associated with.
71
+ :param pulumi.Input[Sequence[pulumi.Input['CockpitEndpointArgs']]] endpoints: (Deprecated) A list of [endpoints](https://www.scaleway.com/en/docs/observability/cockpit/concepts/#endpoints) related to Cockpit, each with specific URLs:
72
+ :param pulumi.Input[str] plan: Name of the plan to use. Available plans are: free, premium, and custom.
73
+ :param pulumi.Input[str] plan_id: (Deprecated) The ID of the current pricing plan.
74
+ :param pulumi.Input[str] project_id: ) The ID of the Project the Cockpit is associated with.
75
75
  :param pulumi.Input[Sequence[pulumi.Input['CockpitPushUrlArgs']]] push_urls: Push_url
76
76
  """
77
+ if endpoints is not None:
78
+ warnings.warn("""Please use `CockpitSource` instead""", DeprecationWarning)
79
+ pulumi.log.warn("""endpoints is deprecated: Please use `CockpitSource` instead""")
77
80
  if endpoints is not None:
78
81
  pulumi.set(__self__, "endpoints", endpoints)
79
82
  if plan is not None:
80
83
  pulumi.set(__self__, "plan", plan)
84
+ if plan_id is not None:
85
+ warnings.warn("""Please use Name only""", DeprecationWarning)
86
+ pulumi.log.warn("""plan_id is deprecated: Please use Name only""")
81
87
  if plan_id is not None:
82
88
  pulumi.set(__self__, "plan_id", plan_id)
83
89
  if project_id is not None:
84
90
  pulumi.set(__self__, "project_id", project_id)
91
+ if push_urls is not None:
92
+ warnings.warn("""Please use `CockpitSource` instead""", DeprecationWarning)
93
+ pulumi.log.warn("""push_urls is deprecated: Please use `CockpitSource` instead""")
85
94
  if push_urls is not None:
86
95
  pulumi.set(__self__, "push_urls", push_urls)
87
96
 
88
97
  @property
89
98
  @pulumi.getter
99
+ @_utilities.deprecated("""Please use `CockpitSource` instead""")
90
100
  def endpoints(self) -> Optional[pulumi.Input[Sequence[pulumi.Input['CockpitEndpointArgs']]]]:
91
101
  """
92
- Endpoints.
102
+ (Deprecated) A list of [endpoints](https://www.scaleway.com/en/docs/observability/cockpit/concepts/#endpoints) related to Cockpit, each with specific URLs:
93
103
  """
94
104
  return pulumi.get(self, "endpoints")
95
105
 
@@ -101,7 +111,7 @@ class _CockpitState:
101
111
  @pulumi.getter
102
112
  def plan(self) -> Optional[pulumi.Input[str]]:
103
113
  """
104
- Name or ID of the plan to use.
114
+ Name of the plan to use. Available plans are: free, premium, and custom.
105
115
  """
106
116
  return pulumi.get(self, "plan")
107
117
 
@@ -111,9 +121,10 @@ class _CockpitState:
111
121
 
112
122
  @property
113
123
  @pulumi.getter(name="planId")
124
+ @_utilities.deprecated("""Please use Name only""")
114
125
  def plan_id(self) -> Optional[pulumi.Input[str]]:
115
126
  """
116
- The ID of the current plan.
127
+ (Deprecated) The ID of the current pricing plan.
117
128
  """
118
129
  return pulumi.get(self, "plan_id")
119
130
 
@@ -125,7 +136,7 @@ class _CockpitState:
125
136
  @pulumi.getter(name="projectId")
126
137
  def project_id(self) -> Optional[pulumi.Input[str]]:
127
138
  """
128
- `project_id`) The ID of the project the cockpit is associated with.
139
+ ) The ID of the Project the Cockpit is associated with.
129
140
  """
130
141
  return pulumi.get(self, "project_id")
131
142
 
@@ -135,6 +146,7 @@ class _CockpitState:
135
146
 
136
147
  @property
137
148
  @pulumi.getter(name="pushUrls")
149
+ @_utilities.deprecated("""Please use `CockpitSource` instead""")
138
150
  def push_urls(self) -> Optional[pulumi.Input[Sequence[pulumi.Input['CockpitPushUrlArgs']]]]:
139
151
  """
140
152
  Push_url
@@ -157,7 +169,7 @@ class Cockpit(pulumi.CustomResource):
157
169
  """
158
170
  ## Import
159
171
 
160
- Cockpits can be imported using the `{project_id}`, e.g.
172
+ This section explains how to import a Cockpit using its `{project_id}`.
161
173
 
162
174
  bash
163
175
 
@@ -167,8 +179,8 @@ class Cockpit(pulumi.CustomResource):
167
179
 
168
180
  :param str resource_name: The name of the resource.
169
181
  :param pulumi.ResourceOptions opts: Options for the resource.
170
- :param pulumi.Input[str] plan: Name or ID of the plan to use.
171
- :param pulumi.Input[str] project_id: `project_id`) The ID of the project the cockpit is associated with.
182
+ :param pulumi.Input[str] plan: Name of the plan to use. Available plans are: free, premium, and custom.
183
+ :param pulumi.Input[str] project_id: ) The ID of the Project the Cockpit is associated with.
172
184
  """
173
185
  ...
174
186
  @overload
@@ -179,7 +191,7 @@ class Cockpit(pulumi.CustomResource):
179
191
  """
180
192
  ## Import
181
193
 
182
- Cockpits can be imported using the `{project_id}`, e.g.
194
+ This section explains how to import a Cockpit using its `{project_id}`.
183
195
 
184
196
  bash
185
197
 
@@ -240,10 +252,10 @@ class Cockpit(pulumi.CustomResource):
240
252
  :param str resource_name: The unique name of the resulting resource.
241
253
  :param pulumi.Input[str] id: The unique provider ID of the resource to lookup.
242
254
  :param pulumi.ResourceOptions opts: Options for the resource.
243
- :param pulumi.Input[Sequence[pulumi.Input[Union['CockpitEndpointArgs', 'CockpitEndpointArgsDict']]]] endpoints: Endpoints.
244
- :param pulumi.Input[str] plan: Name or ID of the plan to use.
245
- :param pulumi.Input[str] plan_id: The ID of the current plan.
246
- :param pulumi.Input[str] project_id: `project_id`) The ID of the project the cockpit is associated with.
255
+ :param pulumi.Input[Sequence[pulumi.Input[Union['CockpitEndpointArgs', 'CockpitEndpointArgsDict']]]] endpoints: (Deprecated) A list of [endpoints](https://www.scaleway.com/en/docs/observability/cockpit/concepts/#endpoints) related to Cockpit, each with specific URLs:
256
+ :param pulumi.Input[str] plan: Name of the plan to use. Available plans are: free, premium, and custom.
257
+ :param pulumi.Input[str] plan_id: (Deprecated) The ID of the current pricing plan.
258
+ :param pulumi.Input[str] project_id: ) The ID of the Project the Cockpit is associated with.
247
259
  :param pulumi.Input[Sequence[pulumi.Input[Union['CockpitPushUrlArgs', 'CockpitPushUrlArgsDict']]]] push_urls: Push_url
248
260
  """
249
261
  opts = pulumi.ResourceOptions.merge(opts, pulumi.ResourceOptions(id=id))
@@ -259,9 +271,10 @@ class Cockpit(pulumi.CustomResource):
259
271
 
260
272
  @property
261
273
  @pulumi.getter
274
+ @_utilities.deprecated("""Please use `CockpitSource` instead""")
262
275
  def endpoints(self) -> pulumi.Output[Sequence['outputs.CockpitEndpoint']]:
263
276
  """
264
- Endpoints.
277
+ (Deprecated) A list of [endpoints](https://www.scaleway.com/en/docs/observability/cockpit/concepts/#endpoints) related to Cockpit, each with specific URLs:
265
278
  """
266
279
  return pulumi.get(self, "endpoints")
267
280
 
@@ -269,15 +282,16 @@ class Cockpit(pulumi.CustomResource):
269
282
  @pulumi.getter
270
283
  def plan(self) -> pulumi.Output[Optional[str]]:
271
284
  """
272
- Name or ID of the plan to use.
285
+ Name of the plan to use. Available plans are: free, premium, and custom.
273
286
  """
274
287
  return pulumi.get(self, "plan")
275
288
 
276
289
  @property
277
290
  @pulumi.getter(name="planId")
291
+ @_utilities.deprecated("""Please use Name only""")
278
292
  def plan_id(self) -> pulumi.Output[str]:
279
293
  """
280
- The ID of the current plan.
294
+ (Deprecated) The ID of the current pricing plan.
281
295
  """
282
296
  return pulumi.get(self, "plan_id")
283
297
 
@@ -285,12 +299,13 @@ class Cockpit(pulumi.CustomResource):
285
299
  @pulumi.getter(name="projectId")
286
300
  def project_id(self) -> pulumi.Output[str]:
287
301
  """
288
- `project_id`) The ID of the project the cockpit is associated with.
302
+ ) The ID of the Project the Cockpit is associated with.
289
303
  """
290
304
  return pulumi.get(self, "project_id")
291
305
 
292
306
  @property
293
307
  @pulumi.getter(name="pushUrls")
308
+ @_utilities.deprecated("""Please use `CockpitSource` instead""")
294
309
  def push_urls(self) -> pulumi.Output[Sequence['outputs.CockpitPushUrl']]:
295
310
  """
296
311
  Push_url