pulumi-cloudamqp 3.21.0a1743571485__py3-none-any.whl → 3.21.0a1744082841__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-cloudamqp might be problematic. Click here for more details.

Files changed (45) hide show
  1. pulumi_cloudamqp/__init__.py +9 -0
  2. pulumi_cloudamqp/_inputs.py +28 -9
  3. pulumi_cloudamqp/account_action.py +14 -7
  4. pulumi_cloudamqp/alarm.py +90 -30
  5. pulumi_cloudamqp/custom_domain.py +52 -10
  6. pulumi_cloudamqp/extra_disk_size.py +117 -101
  7. pulumi_cloudamqp/get_account.py +8 -2
  8. pulumi_cloudamqp/get_account_vpcs.py +13 -40
  9. pulumi_cloudamqp/get_alarm.py +50 -44
  10. pulumi_cloudamqp/get_credentials.py +10 -18
  11. pulumi_cloudamqp/get_instance.py +51 -2
  12. pulumi_cloudamqp/get_nodes.py +3 -50
  13. pulumi_cloudamqp/get_notification.py +17 -20
  14. pulumi_cloudamqp/get_plugins.py +15 -42
  15. pulumi_cloudamqp/get_plugins_community.py +16 -40
  16. pulumi_cloudamqp/get_upgradable_versions.py +10 -16
  17. pulumi_cloudamqp/get_vpc_gcp_info.py +23 -118
  18. pulumi_cloudamqp/get_vpc_info.py +18 -112
  19. pulumi_cloudamqp/instance.py +400 -177
  20. pulumi_cloudamqp/integration_aws_eventbridge.py +90 -26
  21. pulumi_cloudamqp/integration_log.py +135 -50
  22. pulumi_cloudamqp/integration_metric.py +50 -2
  23. pulumi_cloudamqp/maintenance_window.py +515 -0
  24. pulumi_cloudamqp/node_actions.py +32 -10
  25. pulumi_cloudamqp/notification.py +103 -22
  26. pulumi_cloudamqp/outputs.py +118 -28
  27. pulumi_cloudamqp/plugin.py +89 -25
  28. pulumi_cloudamqp/plugin_community.py +87 -27
  29. pulumi_cloudamqp/privatelink_aws.py +62 -270
  30. pulumi_cloudamqp/privatelink_azure.py +64 -268
  31. pulumi_cloudamqp/pulumi-plugin.json +1 -1
  32. pulumi_cloudamqp/rabbit_configuration.py +209 -86
  33. pulumi_cloudamqp/security_firewall.py +76 -23
  34. pulumi_cloudamqp/upgrade_lavinmq.py +0 -74
  35. pulumi_cloudamqp/upgrade_rabbitmq.py +14 -261
  36. pulumi_cloudamqp/vpc.py +48 -16
  37. pulumi_cloudamqp/vpc_connect.py +111 -499
  38. pulumi_cloudamqp/vpc_gcp_peering.py +141 -506
  39. pulumi_cloudamqp/vpc_peering.py +50 -36
  40. pulumi_cloudamqp/webhook.py +48 -9
  41. {pulumi_cloudamqp-3.21.0a1743571485.dist-info → pulumi_cloudamqp-3.21.0a1744082841.dist-info}/METADATA +1 -1
  42. pulumi_cloudamqp-3.21.0a1744082841.dist-info/RECORD +50 -0
  43. pulumi_cloudamqp-3.21.0a1743571485.dist-info/RECORD +0 -49
  44. {pulumi_cloudamqp-3.21.0a1743571485.dist-info → pulumi_cloudamqp-3.21.0a1744082841.dist-info}/WHEEL +0 -0
  45. {pulumi_cloudamqp-3.21.0a1743571485.dist-info → pulumi_cloudamqp-3.21.0a1744082841.dist-info}/top_level.txt +0 -0
@@ -28,9 +28,12 @@ class SecurityFirewallArgs:
28
28
  """
29
29
  The set of arguments for constructing a SecurityFirewall resource.
30
30
  :param pulumi.Input[int] instance_id: The CloudAMQP instance ID.
31
- :param pulumi.Input[Sequence[pulumi.Input['SecurityFirewallRuleArgs']]] rules: An array of rules, minimum of 1 needs to be configured. Each `rules` block consists of the field documented below.
32
- :param pulumi.Input[int] sleep: Configurable sleep time in seconds between retries for firewall configuration. Default set to 30 seconds.
33
- :param pulumi.Input[int] timeout: Configurable timeout time in seconds for firewall configuration. Default set to 1800 seconds.
31
+ :param pulumi.Input[Sequence[pulumi.Input['SecurityFirewallRuleArgs']]] rules: An array of rules, minimum of 1 needs to be configured. Each `rules`
32
+ block consists of the field documented below.
33
+ :param pulumi.Input[int] sleep: Configurable sleep time in seconds between retries for firewall
34
+ configuration. Default set to 30 seconds.
35
+ :param pulumi.Input[int] timeout: Configurable timeout time in seconds for firewall configuration.
36
+ Default set to 1800 seconds.
34
37
 
35
38
  ___
36
39
 
@@ -59,7 +62,8 @@ class SecurityFirewallArgs:
59
62
  @pulumi.getter
60
63
  def rules(self) -> pulumi.Input[Sequence[pulumi.Input['SecurityFirewallRuleArgs']]]:
61
64
  """
62
- An array of rules, minimum of 1 needs to be configured. Each `rules` block consists of the field documented below.
65
+ An array of rules, minimum of 1 needs to be configured. Each `rules`
66
+ block consists of the field documented below.
63
67
  """
64
68
  return pulumi.get(self, "rules")
65
69
 
@@ -71,7 +75,8 @@ class SecurityFirewallArgs:
71
75
  @pulumi.getter
72
76
  def sleep(self) -> Optional[pulumi.Input[int]]:
73
77
  """
74
- Configurable sleep time in seconds between retries for firewall configuration. Default set to 30 seconds.
78
+ Configurable sleep time in seconds between retries for firewall
79
+ configuration. Default set to 30 seconds.
75
80
  """
76
81
  return pulumi.get(self, "sleep")
77
82
 
@@ -83,7 +88,8 @@ class SecurityFirewallArgs:
83
88
  @pulumi.getter
84
89
  def timeout(self) -> Optional[pulumi.Input[int]]:
85
90
  """
86
- Configurable timeout time in seconds for firewall configuration. Default set to 1800 seconds.
91
+ Configurable timeout time in seconds for firewall configuration.
92
+ Default set to 1800 seconds.
87
93
 
88
94
  ___
89
95
 
@@ -106,9 +112,12 @@ class _SecurityFirewallState:
106
112
  """
107
113
  Input properties used for looking up and filtering SecurityFirewall resources.
108
114
  :param pulumi.Input[int] instance_id: The CloudAMQP instance ID.
109
- :param pulumi.Input[Sequence[pulumi.Input['SecurityFirewallRuleArgs']]] rules: An array of rules, minimum of 1 needs to be configured. Each `rules` block consists of the field documented below.
110
- :param pulumi.Input[int] sleep: Configurable sleep time in seconds between retries for firewall configuration. Default set to 30 seconds.
111
- :param pulumi.Input[int] timeout: Configurable timeout time in seconds for firewall configuration. Default set to 1800 seconds.
115
+ :param pulumi.Input[Sequence[pulumi.Input['SecurityFirewallRuleArgs']]] rules: An array of rules, minimum of 1 needs to be configured. Each `rules`
116
+ block consists of the field documented below.
117
+ :param pulumi.Input[int] sleep: Configurable sleep time in seconds between retries for firewall
118
+ configuration. Default set to 30 seconds.
119
+ :param pulumi.Input[int] timeout: Configurable timeout time in seconds for firewall configuration.
120
+ Default set to 1800 seconds.
112
121
 
113
122
  ___
114
123
 
@@ -139,7 +148,8 @@ class _SecurityFirewallState:
139
148
  @pulumi.getter
140
149
  def rules(self) -> Optional[pulumi.Input[Sequence[pulumi.Input['SecurityFirewallRuleArgs']]]]:
141
150
  """
142
- An array of rules, minimum of 1 needs to be configured. Each `rules` block consists of the field documented below.
151
+ An array of rules, minimum of 1 needs to be configured. Each `rules`
152
+ block consists of the field documented below.
143
153
  """
144
154
  return pulumi.get(self, "rules")
145
155
 
@@ -151,7 +161,8 @@ class _SecurityFirewallState:
151
161
  @pulumi.getter
152
162
  def sleep(self) -> Optional[pulumi.Input[int]]:
153
163
  """
154
- Configurable sleep time in seconds between retries for firewall configuration. Default set to 30 seconds.
164
+ Configurable sleep time in seconds between retries for firewall
165
+ configuration. Default set to 30 seconds.
155
166
  """
156
167
  return pulumi.get(self, "sleep")
157
168
 
@@ -163,7 +174,8 @@ class _SecurityFirewallState:
163
174
  @pulumi.getter
164
175
  def timeout(self) -> Optional[pulumi.Input[int]]:
165
176
  """
166
- Configurable timeout time in seconds for firewall configuration. Default set to 1800 seconds.
177
+ Configurable timeout time in seconds for firewall configuration.
178
+ Default set to 1800 seconds.
167
179
 
168
180
  ___
169
181
 
@@ -189,7 +201,23 @@ class SecurityFirewall(pulumi.CustomResource):
189
201
  """
190
202
  ## Import
191
203
 
192
- `cloudamqp_security_firewall` can be imported using CloudAMQP instance identifier.
204
+ `cloudamqp_security_firewall` can be imported using CloudAMQP instance identifier. To
205
+
206
+ retrieve the identifier, use [CloudAMQP API list intances].
207
+
208
+ From Terraform v1.5.0, the `import` block can be used to import this resource:
209
+
210
+ hcl
211
+
212
+ import {
213
+
214
+ to = cloudamqp_security_firewall.firewall
215
+
216
+ id = cloudamqp_instance.instance.id
217
+
218
+ }
219
+
220
+ Or use Terraform CLI:
193
221
 
194
222
  ```sh
195
223
  $ pulumi import cloudamqp:index/securityFirewall:SecurityFirewall firewall <instance_id>`
@@ -198,9 +226,12 @@ class SecurityFirewall(pulumi.CustomResource):
198
226
  :param str resource_name: The name of the resource.
199
227
  :param pulumi.ResourceOptions opts: Options for the resource.
200
228
  :param pulumi.Input[int] instance_id: The CloudAMQP instance ID.
201
- :param pulumi.Input[Sequence[pulumi.Input[Union['SecurityFirewallRuleArgs', 'SecurityFirewallRuleArgsDict']]]] rules: An array of rules, minimum of 1 needs to be configured. Each `rules` block consists of the field documented below.
202
- :param pulumi.Input[int] sleep: Configurable sleep time in seconds between retries for firewall configuration. Default set to 30 seconds.
203
- :param pulumi.Input[int] timeout: Configurable timeout time in seconds for firewall configuration. Default set to 1800 seconds.
229
+ :param pulumi.Input[Sequence[pulumi.Input[Union['SecurityFirewallRuleArgs', 'SecurityFirewallRuleArgsDict']]]] rules: An array of rules, minimum of 1 needs to be configured. Each `rules`
230
+ block consists of the field documented below.
231
+ :param pulumi.Input[int] sleep: Configurable sleep time in seconds between retries for firewall
232
+ configuration. Default set to 30 seconds.
233
+ :param pulumi.Input[int] timeout: Configurable timeout time in seconds for firewall configuration.
234
+ Default set to 1800 seconds.
204
235
 
205
236
  ___
206
237
 
@@ -215,7 +246,23 @@ class SecurityFirewall(pulumi.CustomResource):
215
246
  """
216
247
  ## Import
217
248
 
218
- `cloudamqp_security_firewall` can be imported using CloudAMQP instance identifier.
249
+ `cloudamqp_security_firewall` can be imported using CloudAMQP instance identifier. To
250
+
251
+ retrieve the identifier, use [CloudAMQP API list intances].
252
+
253
+ From Terraform v1.5.0, the `import` block can be used to import this resource:
254
+
255
+ hcl
256
+
257
+ import {
258
+
259
+ to = cloudamqp_security_firewall.firewall
260
+
261
+ id = cloudamqp_instance.instance.id
262
+
263
+ }
264
+
265
+ Or use Terraform CLI:
219
266
 
220
267
  ```sh
221
268
  $ pulumi import cloudamqp:index/securityFirewall:SecurityFirewall firewall <instance_id>`
@@ -279,9 +326,12 @@ class SecurityFirewall(pulumi.CustomResource):
279
326
  :param pulumi.Input[str] id: The unique provider ID of the resource to lookup.
280
327
  :param pulumi.ResourceOptions opts: Options for the resource.
281
328
  :param pulumi.Input[int] instance_id: The CloudAMQP instance ID.
282
- :param pulumi.Input[Sequence[pulumi.Input[Union['SecurityFirewallRuleArgs', 'SecurityFirewallRuleArgsDict']]]] rules: An array of rules, minimum of 1 needs to be configured. Each `rules` block consists of the field documented below.
283
- :param pulumi.Input[int] sleep: Configurable sleep time in seconds between retries for firewall configuration. Default set to 30 seconds.
284
- :param pulumi.Input[int] timeout: Configurable timeout time in seconds for firewall configuration. Default set to 1800 seconds.
329
+ :param pulumi.Input[Sequence[pulumi.Input[Union['SecurityFirewallRuleArgs', 'SecurityFirewallRuleArgsDict']]]] rules: An array of rules, minimum of 1 needs to be configured. Each `rules`
330
+ block consists of the field documented below.
331
+ :param pulumi.Input[int] sleep: Configurable sleep time in seconds between retries for firewall
332
+ configuration. Default set to 30 seconds.
333
+ :param pulumi.Input[int] timeout: Configurable timeout time in seconds for firewall configuration.
334
+ Default set to 1800 seconds.
285
335
 
286
336
  ___
287
337
 
@@ -309,7 +359,8 @@ class SecurityFirewall(pulumi.CustomResource):
309
359
  @pulumi.getter
310
360
  def rules(self) -> pulumi.Output[Sequence['outputs.SecurityFirewallRule']]:
311
361
  """
312
- An array of rules, minimum of 1 needs to be configured. Each `rules` block consists of the field documented below.
362
+ An array of rules, minimum of 1 needs to be configured. Each `rules`
363
+ block consists of the field documented below.
313
364
  """
314
365
  return pulumi.get(self, "rules")
315
366
 
@@ -317,7 +368,8 @@ class SecurityFirewall(pulumi.CustomResource):
317
368
  @pulumi.getter
318
369
  def sleep(self) -> pulumi.Output[Optional[int]]:
319
370
  """
320
- Configurable sleep time in seconds between retries for firewall configuration. Default set to 30 seconds.
371
+ Configurable sleep time in seconds between retries for firewall
372
+ configuration. Default set to 30 seconds.
321
373
  """
322
374
  return pulumi.get(self, "sleep")
323
375
 
@@ -325,7 +377,8 @@ class SecurityFirewall(pulumi.CustomResource):
325
377
  @pulumi.getter
326
378
  def timeout(self) -> pulumi.Output[Optional[int]]:
327
379
  """
328
- Configurable timeout time in seconds for firewall configuration. Default set to 1800 seconds.
380
+ Configurable timeout time in seconds for firewall configuration.
381
+ Default set to 1800 seconds.
329
382
 
330
383
  ___
331
384
 
@@ -104,43 +104,6 @@ class UpgradeLavinmq(pulumi.CustomResource):
104
104
  new_version: Optional[pulumi.Input[str]] = None,
105
105
  __props__=None):
106
106
  """
107
- This resource allows you to upgrade LavinMQ version.
108
-
109
- See below example usage.
110
-
111
- Only available for dedicated subscription plans running ***LavinMQ***.
112
-
113
- ## Example Usage
114
-
115
- <details>
116
- <summary>
117
- <b>
118
- <i>Upgrade LavinMQ, specify which version to upgrade to, from v1.32.0</i>
119
- </b>
120
- </summary>
121
-
122
- Specify the version to upgrade to. List available upgradable versions, use [CloudAMQP API](https://docs.cloudamqp.com/cloudamqp_api.html#get-available-versions).
123
-
124
- ```python
125
- import pulumi
126
- import pulumi_cloudamqp as cloudamqp
127
-
128
- instance = cloudamqp.Instance("instance",
129
- name="lavinmq-version-upgrade-test",
130
- plan="lynx-1",
131
- region="amazon-web-services::us-west-1")
132
- upgrade = cloudamqp.UpgradeLavinmq("upgrade",
133
- instance_id=instance.id,
134
- new_version="1.3.1")
135
- ```
136
-
137
- </details>
138
-
139
- ## Important Upgrade Information
140
-
141
- > - All single node upgrades will require some downtime since LavinMQ needs a restart.
142
- > - Auto delete queues (queues that are marked AD) will be deleted during the update.
143
-
144
107
  ## Import
145
108
 
146
109
  Not possible to import this resource.
@@ -157,43 +120,6 @@ class UpgradeLavinmq(pulumi.CustomResource):
157
120
  args: UpgradeLavinmqArgs,
158
121
  opts: Optional[pulumi.ResourceOptions] = None):
159
122
  """
160
- This resource allows you to upgrade LavinMQ version.
161
-
162
- See below example usage.
163
-
164
- Only available for dedicated subscription plans running ***LavinMQ***.
165
-
166
- ## Example Usage
167
-
168
- <details>
169
- <summary>
170
- <b>
171
- <i>Upgrade LavinMQ, specify which version to upgrade to, from v1.32.0</i>
172
- </b>
173
- </summary>
174
-
175
- Specify the version to upgrade to. List available upgradable versions, use [CloudAMQP API](https://docs.cloudamqp.com/cloudamqp_api.html#get-available-versions).
176
-
177
- ```python
178
- import pulumi
179
- import pulumi_cloudamqp as cloudamqp
180
-
181
- instance = cloudamqp.Instance("instance",
182
- name="lavinmq-version-upgrade-test",
183
- plan="lynx-1",
184
- region="amazon-web-services::us-west-1")
185
- upgrade = cloudamqp.UpgradeLavinmq("upgrade",
186
- instance_id=instance.id,
187
- new_version="1.3.1")
188
- ```
189
-
190
- </details>
191
-
192
- ## Important Upgrade Information
193
-
194
- > - All single node upgrades will require some downtime since LavinMQ needs a restart.
195
- > - Auto delete queues (queues that are marked AD) will be deleted during the update.
196
-
197
123
  ## Import
198
124
 
199
125
  Not possible to import this resource.
@@ -25,7 +25,8 @@ class UpgradeRabbitmqArgs:
25
25
  """
26
26
  The set of arguments for constructing a UpgradeRabbitmq resource.
27
27
  :param pulumi.Input[int] instance_id: The CloudAMQP instance identifier
28
- :param pulumi.Input[str] current_version: Helper argument to change upgrade behaviour to latest possible version
28
+ :param pulumi.Input[str] current_version: Helper argument to change upgrade behaviour to latest possible
29
+ version
29
30
  :param pulumi.Input[str] new_version: The new version to upgrade to
30
31
  """
31
32
  pulumi.set(__self__, "instance_id", instance_id)
@@ -50,7 +51,8 @@ class UpgradeRabbitmqArgs:
50
51
  @pulumi.getter(name="currentVersion")
51
52
  def current_version(self) -> Optional[pulumi.Input[str]]:
52
53
  """
53
- Helper argument to change upgrade behaviour to latest possible version
54
+ Helper argument to change upgrade behaviour to latest possible
55
+ version
54
56
  """
55
57
  return pulumi.get(self, "current_version")
56
58
 
@@ -79,7 +81,8 @@ class _UpgradeRabbitmqState:
79
81
  new_version: Optional[pulumi.Input[str]] = None):
80
82
  """
81
83
  Input properties used for looking up and filtering UpgradeRabbitmq resources.
82
- :param pulumi.Input[str] current_version: Helper argument to change upgrade behaviour to latest possible version
84
+ :param pulumi.Input[str] current_version: Helper argument to change upgrade behaviour to latest possible
85
+ version
83
86
  :param pulumi.Input[int] instance_id: The CloudAMQP instance identifier
84
87
  :param pulumi.Input[str] new_version: The new version to upgrade to
85
88
  """
@@ -94,7 +97,8 @@ class _UpgradeRabbitmqState:
94
97
  @pulumi.getter(name="currentVersion")
95
98
  def current_version(self) -> Optional[pulumi.Input[str]]:
96
99
  """
97
- Helper argument to change upgrade behaviour to latest possible version
100
+ Helper argument to change upgrade behaviour to latest possible
101
+ version
98
102
  """
99
103
  return pulumi.get(self, "current_version")
100
104
 
@@ -137,140 +141,14 @@ class UpgradeRabbitmq(pulumi.CustomResource):
137
141
  new_version: Optional[pulumi.Input[str]] = None,
138
142
  __props__=None):
139
143
  """
140
- This resource allows you to upgrade RabbitMQ version. Depending on initial versions of RabbitMQ and Erlang of the CloudAMQP instance, multiple runs may be needed to get to the latest or wanted version. Reason for this is certain supported RabbitMQ version will also automatically upgrade Erlang version.
141
-
142
- There is three different ways to trigger the version upgrade
143
-
144
- > - Specify RabbitMQ version to upgrade to
145
- > - Upgrade to latest RabbitMQ version
146
- > - Old behaviour to upgrade to latest RabbitMQ version
147
-
148
- See, below example usage for the difference.
149
-
150
- Only available for dedicated subscription plans running ***RabbitMQ***.
151
-
152
- ## Example Usage
153
-
154
- <details>
155
- <summary>
156
- <b>
157
- <i>Specify version upgrade, from v1.31.0</i>
158
- </b>
159
- </summary>
160
-
161
- Specify the version to upgrade to. List available upgradable versions, use [CloudAMQP API](https://docs.cloudamqp.com/cloudamqp_api.html#get-available-versions).
162
- After the upgrade finished, there can still be newer versions available.
163
-
164
- ```python
165
- import pulumi
166
- import pulumi_cloudamqp as cloudamqp
167
-
168
- instance = cloudamqp.Instance("instance",
169
- name="rabbitmq-version-upgrade-test",
170
- plan="bunny-1",
171
- region="amazon-web-services::us-west-1")
172
- upgrade = cloudamqp.UpgradeRabbitmq("upgrade",
173
- instance_id=instance.id,
174
- new_version="3.13.2")
175
- ```
176
-
177
- </details>
178
-
179
- <details>
180
- <summary>
181
- <b>
182
- <i>Upgrade to latest possible version, from v1.31.0</i>
183
- </b>
184
- </summary>
185
-
186
- This will upgrade RabbitMQ to the latest possible version detected by the data source `get_upgradable_versions`.
187
- Multiple runs can be needed to upgrade the version even further.
188
-
189
- ```python
190
- import pulumi
191
- import pulumi_cloudamqp as cloudamqp
192
-
193
- instance = cloudamqp.Instance("instance",
194
- name="rabbitmq-version-upgrade-test",
195
- plan="bunny-1",
196
- region="amazon-web-services::us-west-1")
197
- upgradable_versions = instance.id.apply(lambda id: cloudamqp.get_upgradable_versions_output(instance_id=id))
198
- upgrade = cloudamqp.UpgradeRabbitmq("upgrade",
199
- instance_id=instance.id,
200
- current_version=instance.rmq_version,
201
- new_version=upgradable_versions.new_rabbitmq_version)
202
- ```
203
-
204
- </details>
205
-
206
- <details>
207
- <summary>
208
- <b>
209
- <i>Upgrade to latest possible version, before v1.31.0</i>
210
- </b>
211
- </summary>
212
-
213
- Old behaviour of the upgrading the RabbitMQ version. No longer recommended.
214
-
215
- ```python
216
- import pulumi
217
- import pulumi_cloudamqp as cloudamqp
218
-
219
- # Retrieve latest possible upgradable versions for RabbitMQ and Erlang
220
- versions = cloudamqp.get_upgradable_versions(instance_id=instance["id"])
221
- # Invoke automatically upgrade to latest possible upgradable versions for RabbitMQ and Erlang
222
- upgrade = cloudamqp.UpgradeRabbitmq("upgrade", instance_id=instance["id"])
223
- ```
224
-
225
- ```python
226
- import pulumi
227
- import pulumi_cloudamqp as cloudamqp
228
-
229
- # Retrieve latest possible upgradable versions for RabbitMQ and Erlang
230
- versions = cloudamqp.get_upgradable_versions(instance_id=instance["id"])
231
- ```
232
-
233
- If newer version is still available to be upgradable in the data source, re-run again.
234
-
235
- ```python
236
- import pulumi
237
- import pulumi_cloudamqp as cloudamqp
238
-
239
- # Retrieve latest possible upgradable versions for RabbitMQ and Erlang
240
- versions = cloudamqp.get_upgradable_versions(instance_id=instance["id"])
241
- # Invoke automatically upgrade to latest possible upgradable versions for RabbitMQ and Erlang
242
- upgrade = cloudamqp.UpgradeRabbitmq("upgrade", instance_id=instance["id"])
243
- ```
244
-
245
- </details>
246
-
247
- ## Important Upgrade Information
248
-
249
- > - All single node upgrades will require some downtime since RabbitMQ needs a restart.
250
- > - From RabbitMQ version 3.9, rolling upgrades between minor versions (e.g. 3.9 to 3.10), in a multi-node cluster are possible without downtime. This means that one node is upgraded at a time while the other nodes are still running. For versions older than 3.9, patch version upgrades (e.g. 3.8.x to 3.8.y) are possible without downtime in a multi-node cluster, but minor version upgrades will require downtime.
251
- > - Auto delete queues (queues that are marked AD) will be deleted during the update.
252
- > - Any custom plugins support has installed on your behalf will be disabled and you need to contact support@cloudamqp.com and ask to have them re-installed.
253
- > - TLS 1.0 and 1.1 will not be supported after the update.
254
-
255
- ## Multiple runs
256
-
257
- Depending on initial versions of RabbitMQ and Erlang of the CloudAMQP instance, multiple runs may be needed to get to the latest or wanted version.
258
-
259
- Example steps needed when starting at RabbitMQ version 3.12.2
260
-
261
- | Version | Supported upgrading versions | Min version to upgrade Erlang |
262
- |------------------|-------------------------------------------|-------------------------------|
263
- | 3.12.2 | 3.12.4, 3.12.6, 3.12.10, 3.12.12, 3.12.13 | 3.12.13 |
264
- | 3.12.13 | 3.13.2 | 3.13.2 |
265
- | 3.13.2 | - | - |
266
-
267
144
  ## Import
268
145
 
269
146
  Not possible to import this resource.
270
147
 
271
148
  :param str resource_name: The name of the resource.
272
149
  :param pulumi.ResourceOptions opts: Options for the resource.
273
- :param pulumi.Input[str] current_version: Helper argument to change upgrade behaviour to latest possible version
150
+ :param pulumi.Input[str] current_version: Helper argument to change upgrade behaviour to latest possible
151
+ version
274
152
  :param pulumi.Input[int] instance_id: The CloudAMQP instance identifier
275
153
  :param pulumi.Input[str] new_version: The new version to upgrade to
276
154
  """
@@ -281,133 +159,6 @@ class UpgradeRabbitmq(pulumi.CustomResource):
281
159
  args: UpgradeRabbitmqArgs,
282
160
  opts: Optional[pulumi.ResourceOptions] = None):
283
161
  """
284
- This resource allows you to upgrade RabbitMQ version. Depending on initial versions of RabbitMQ and Erlang of the CloudAMQP instance, multiple runs may be needed to get to the latest or wanted version. Reason for this is certain supported RabbitMQ version will also automatically upgrade Erlang version.
285
-
286
- There is three different ways to trigger the version upgrade
287
-
288
- > - Specify RabbitMQ version to upgrade to
289
- > - Upgrade to latest RabbitMQ version
290
- > - Old behaviour to upgrade to latest RabbitMQ version
291
-
292
- See, below example usage for the difference.
293
-
294
- Only available for dedicated subscription plans running ***RabbitMQ***.
295
-
296
- ## Example Usage
297
-
298
- <details>
299
- <summary>
300
- <b>
301
- <i>Specify version upgrade, from v1.31.0</i>
302
- </b>
303
- </summary>
304
-
305
- Specify the version to upgrade to. List available upgradable versions, use [CloudAMQP API](https://docs.cloudamqp.com/cloudamqp_api.html#get-available-versions).
306
- After the upgrade finished, there can still be newer versions available.
307
-
308
- ```python
309
- import pulumi
310
- import pulumi_cloudamqp as cloudamqp
311
-
312
- instance = cloudamqp.Instance("instance",
313
- name="rabbitmq-version-upgrade-test",
314
- plan="bunny-1",
315
- region="amazon-web-services::us-west-1")
316
- upgrade = cloudamqp.UpgradeRabbitmq("upgrade",
317
- instance_id=instance.id,
318
- new_version="3.13.2")
319
- ```
320
-
321
- </details>
322
-
323
- <details>
324
- <summary>
325
- <b>
326
- <i>Upgrade to latest possible version, from v1.31.0</i>
327
- </b>
328
- </summary>
329
-
330
- This will upgrade RabbitMQ to the latest possible version detected by the data source `get_upgradable_versions`.
331
- Multiple runs can be needed to upgrade the version even further.
332
-
333
- ```python
334
- import pulumi
335
- import pulumi_cloudamqp as cloudamqp
336
-
337
- instance = cloudamqp.Instance("instance",
338
- name="rabbitmq-version-upgrade-test",
339
- plan="bunny-1",
340
- region="amazon-web-services::us-west-1")
341
- upgradable_versions = instance.id.apply(lambda id: cloudamqp.get_upgradable_versions_output(instance_id=id))
342
- upgrade = cloudamqp.UpgradeRabbitmq("upgrade",
343
- instance_id=instance.id,
344
- current_version=instance.rmq_version,
345
- new_version=upgradable_versions.new_rabbitmq_version)
346
- ```
347
-
348
- </details>
349
-
350
- <details>
351
- <summary>
352
- <b>
353
- <i>Upgrade to latest possible version, before v1.31.0</i>
354
- </b>
355
- </summary>
356
-
357
- Old behaviour of the upgrading the RabbitMQ version. No longer recommended.
358
-
359
- ```python
360
- import pulumi
361
- import pulumi_cloudamqp as cloudamqp
362
-
363
- # Retrieve latest possible upgradable versions for RabbitMQ and Erlang
364
- versions = cloudamqp.get_upgradable_versions(instance_id=instance["id"])
365
- # Invoke automatically upgrade to latest possible upgradable versions for RabbitMQ and Erlang
366
- upgrade = cloudamqp.UpgradeRabbitmq("upgrade", instance_id=instance["id"])
367
- ```
368
-
369
- ```python
370
- import pulumi
371
- import pulumi_cloudamqp as cloudamqp
372
-
373
- # Retrieve latest possible upgradable versions for RabbitMQ and Erlang
374
- versions = cloudamqp.get_upgradable_versions(instance_id=instance["id"])
375
- ```
376
-
377
- If newer version is still available to be upgradable in the data source, re-run again.
378
-
379
- ```python
380
- import pulumi
381
- import pulumi_cloudamqp as cloudamqp
382
-
383
- # Retrieve latest possible upgradable versions for RabbitMQ and Erlang
384
- versions = cloudamqp.get_upgradable_versions(instance_id=instance["id"])
385
- # Invoke automatically upgrade to latest possible upgradable versions for RabbitMQ and Erlang
386
- upgrade = cloudamqp.UpgradeRabbitmq("upgrade", instance_id=instance["id"])
387
- ```
388
-
389
- </details>
390
-
391
- ## Important Upgrade Information
392
-
393
- > - All single node upgrades will require some downtime since RabbitMQ needs a restart.
394
- > - From RabbitMQ version 3.9, rolling upgrades between minor versions (e.g. 3.9 to 3.10), in a multi-node cluster are possible without downtime. This means that one node is upgraded at a time while the other nodes are still running. For versions older than 3.9, patch version upgrades (e.g. 3.8.x to 3.8.y) are possible without downtime in a multi-node cluster, but minor version upgrades will require downtime.
395
- > - Auto delete queues (queues that are marked AD) will be deleted during the update.
396
- > - Any custom plugins support has installed on your behalf will be disabled and you need to contact support@cloudamqp.com and ask to have them re-installed.
397
- > - TLS 1.0 and 1.1 will not be supported after the update.
398
-
399
- ## Multiple runs
400
-
401
- Depending on initial versions of RabbitMQ and Erlang of the CloudAMQP instance, multiple runs may be needed to get to the latest or wanted version.
402
-
403
- Example steps needed when starting at RabbitMQ version 3.12.2
404
-
405
- | Version | Supported upgrading versions | Min version to upgrade Erlang |
406
- |------------------|-------------------------------------------|-------------------------------|
407
- | 3.12.2 | 3.12.4, 3.12.6, 3.12.10, 3.12.12, 3.12.13 | 3.12.13 |
408
- | 3.12.13 | 3.13.2 | 3.13.2 |
409
- | 3.13.2 | - | - |
410
-
411
162
  ## Import
412
163
 
413
164
  Not possible to import this resource.
@@ -464,7 +215,8 @@ class UpgradeRabbitmq(pulumi.CustomResource):
464
215
  :param str resource_name: The unique name of the resulting resource.
465
216
  :param pulumi.Input[str] id: The unique provider ID of the resource to lookup.
466
217
  :param pulumi.ResourceOptions opts: Options for the resource.
467
- :param pulumi.Input[str] current_version: Helper argument to change upgrade behaviour to latest possible version
218
+ :param pulumi.Input[str] current_version: Helper argument to change upgrade behaviour to latest possible
219
+ version
468
220
  :param pulumi.Input[int] instance_id: The CloudAMQP instance identifier
469
221
  :param pulumi.Input[str] new_version: The new version to upgrade to
470
222
  """
@@ -481,7 +233,8 @@ class UpgradeRabbitmq(pulumi.CustomResource):
481
233
  @pulumi.getter(name="currentVersion")
482
234
  def current_version(self) -> pulumi.Output[Optional[str]]:
483
235
  """
484
- Helper argument to change upgrade behaviour to latest possible version
236
+ Helper argument to change upgrade behaviour to latest possible
237
+ version
485
238
  """
486
239
  return pulumi.get(self, "current_version")
487
240