pulumi-cloudamqp 3.21.0a1743571485__py3-none-any.whl → 3.22.0a1744182778__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 (49) hide show
  1. pulumi_cloudamqp/__init__.py +10 -0
  2. pulumi_cloudamqp/_inputs.py +92 -72
  3. pulumi_cloudamqp/account_action.py +39 -31
  4. pulumi_cloudamqp/alarm.py +229 -168
  5. pulumi_cloudamqp/config/__init__.py +1 -0
  6. pulumi_cloudamqp/config/__init__.pyi +1 -0
  7. pulumi_cloudamqp/config/vars.py +1 -0
  8. pulumi_cloudamqp/custom_domain.py +81 -38
  9. pulumi_cloudamqp/extra_disk_size.py +172 -155
  10. pulumi_cloudamqp/get_account.py +10 -3
  11. pulumi_cloudamqp/get_account_vpcs.py +15 -41
  12. pulumi_cloudamqp/get_alarm.py +74 -67
  13. pulumi_cloudamqp/get_credentials.py +19 -26
  14. pulumi_cloudamqp/get_instance.py +75 -25
  15. pulumi_cloudamqp/get_nodes.py +10 -56
  16. pulumi_cloudamqp/get_notification.py +39 -41
  17. pulumi_cloudamqp/get_plugins.py +28 -54
  18. pulumi_cloudamqp/get_plugins_community.py +29 -52
  19. pulumi_cloudamqp/get_upgradable_versions.py +19 -24
  20. pulumi_cloudamqp/get_vpc_gcp_info.py +44 -138
  21. pulumi_cloudamqp/get_vpc_info.py +34 -127
  22. pulumi_cloudamqp/instance.py +557 -333
  23. pulumi_cloudamqp/integration_aws_eventbridge.py +182 -117
  24. pulumi_cloudamqp/integration_log.py +488 -402
  25. pulumi_cloudamqp/integration_metric.py +345 -296
  26. pulumi_cloudamqp/maintenance_window.py +516 -0
  27. pulumi_cloudamqp/node_actions.py +82 -59
  28. pulumi_cloudamqp/notification.py +174 -92
  29. pulumi_cloudamqp/outputs.py +216 -125
  30. pulumi_cloudamqp/plugin.py +170 -105
  31. pulumi_cloudamqp/plugin_community.py +168 -107
  32. pulumi_cloudamqp/privatelink_aws.py +140 -347
  33. pulumi_cloudamqp/privatelink_azure.py +142 -345
  34. pulumi_cloudamqp/provider.py +22 -21
  35. pulumi_cloudamqp/pulumi-plugin.json +1 -1
  36. pulumi_cloudamqp/rabbit_configuration.py +334 -210
  37. pulumi_cloudamqp/security_firewall.py +111 -57
  38. pulumi_cloudamqp/upgrade_lavinmq.py +29 -102
  39. pulumi_cloudamqp/upgrade_rabbitmq.py +53 -299
  40. pulumi_cloudamqp/vpc.py +112 -79
  41. pulumi_cloudamqp/vpc_connect.py +219 -606
  42. pulumi_cloudamqp/vpc_gcp_peering.py +227 -591
  43. pulumi_cloudamqp/vpc_peering.py +120 -105
  44. pulumi_cloudamqp/webhook.py +143 -103
  45. {pulumi_cloudamqp-3.21.0a1743571485.dist-info → pulumi_cloudamqp-3.22.0a1744182778.dist-info}/METADATA +1 -1
  46. pulumi_cloudamqp-3.22.0a1744182778.dist-info/RECORD +50 -0
  47. pulumi_cloudamqp-3.21.0a1743571485.dist-info/RECORD +0 -49
  48. {pulumi_cloudamqp-3.21.0a1743571485.dist-info → pulumi_cloudamqp-3.22.0a1744182778.dist-info}/WHEEL +0 -0
  49. {pulumi_cloudamqp-3.21.0a1743571485.dist-info → pulumi_cloudamqp-3.22.0a1744182778.dist-info}/top_level.txt +0 -0
@@ -2,6 +2,7 @@
2
2
  # *** WARNING: this file was generated by the Pulumi Terraform Bridge (tfgen) Tool. ***
3
3
  # *** Do not edit by hand unless you're certain you know what you are doing! ***
4
4
 
5
+ import builtins
5
6
  import copy
6
7
  import warnings
7
8
  import sys
@@ -21,44 +22,55 @@ __all__ = ['InstanceArgs', 'Instance']
21
22
  @pulumi.input_type
22
23
  class InstanceArgs:
23
24
  def __init__(__self__, *,
24
- plan: pulumi.Input[str],
25
- region: pulumi.Input[str],
25
+ plan: pulumi.Input[builtins.str],
26
+ region: pulumi.Input[builtins.str],
26
27
  copy_settings: Optional[pulumi.Input[Sequence[pulumi.Input['InstanceCopySettingArgs']]]] = None,
27
- keep_associated_vpc: Optional[pulumi.Input[bool]] = None,
28
- name: Optional[pulumi.Input[str]] = None,
29
- no_default_alarms: Optional[pulumi.Input[bool]] = None,
30
- nodes: Optional[pulumi.Input[int]] = None,
31
- rmq_version: Optional[pulumi.Input[str]] = None,
32
- tags: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
33
- vpc_id: Optional[pulumi.Input[int]] = None,
34
- vpc_subnet: Optional[pulumi.Input[str]] = None):
28
+ keep_associated_vpc: Optional[pulumi.Input[builtins.bool]] = None,
29
+ name: Optional[pulumi.Input[builtins.str]] = None,
30
+ no_default_alarms: Optional[pulumi.Input[builtins.bool]] = None,
31
+ nodes: Optional[pulumi.Input[builtins.int]] = None,
32
+ rmq_version: Optional[pulumi.Input[builtins.str]] = None,
33
+ tags: Optional[pulumi.Input[Sequence[pulumi.Input[builtins.str]]]] = None,
34
+ vpc_id: Optional[pulumi.Input[builtins.int]] = None,
35
+ vpc_subnet: Optional[pulumi.Input[builtins.str]] = None):
35
36
  """
36
37
  The set of arguments for constructing a Instance resource.
37
- :param pulumi.Input[str] plan: The subscription plan. See available plans
38
- :param pulumi.Input[str] region: The region to host the instance in. See instance regions
38
+ :param pulumi.Input[builtins.str] plan: The subscription plan. See available [plans].
39
+ :param pulumi.Input[builtins.str] region: The region to host the instance in. See available [regions].
39
40
 
40
- ***Note: Changing region will force the instance to be destroyed and a new created in the new region. All data will be lost and a new name assigned.***
41
- :param pulumi.Input[Sequence[pulumi.Input['InstanceCopySettingArgs']]] copy_settings: Copy settings from one CloudAMQP instance to a new. Consists of the block documented below.
41
+ ***Note:*** Changing region will force the instance to be destroyed and a new created in the new
42
+ region. All data will be lost and a new name assigned.
43
+ :param pulumi.Input[Sequence[pulumi.Input['InstanceCopySettingArgs']]] copy_settings: Copy settings from one CloudAMQP instance to a new. Consists of
44
+ the block documented below.
42
45
 
43
46
  ___
44
47
 
45
48
  The `copy_settings` block consists of:
46
- :param pulumi.Input[bool] keep_associated_vpc: Keep associated VPC when deleting instance, default set to false.
47
- :param pulumi.Input[str] name: Name of the CloudAMQP instance.
48
- :param pulumi.Input[bool] no_default_alarms: Set to true to discard creating default alarms when the instance is created. Can be left out, will then use default value = false.
49
- :param pulumi.Input[int] nodes: Number of nodes, 1, 3 or 5 depending on plan used. Only needed for legacy plans, will otherwise be computed.
49
+ :param pulumi.Input[builtins.bool] keep_associated_vpc: Keep associated VPC when deleting instance. Default set to
50
+ false.
51
+ :param pulumi.Input[builtins.str] name: Name of the CloudAMQP instance.
52
+ :param pulumi.Input[builtins.bool] no_default_alarms: Set to true to not create default alarms
53
+ :param pulumi.Input[builtins.int] nodes: Number of nodes, 1, 3 or 5 depending on plan used. Only needed for
54
+ legacy plans, will otherwise be computed.
50
55
 
51
- ***Deprecated: Legacy subscriptions plan can still change this to scale up or down the instance. New subscriptions plans use the plan to determine number of nodes. In order to change number of nodes the `plan` needs to be updated.***
52
- :param pulumi.Input[str] rmq_version: The Rabbit MQ version. Can be left out, will then be set to default value used by CloudAMQP API.
56
+ ***Deprecated:*** Legacy subscriptions plan can still change this to scale up or down the instance.
57
+ New subscriptions plans use the plan to determine number of nodes. In order to
58
+ change number of nodes the `plan` needs to be updated.
59
+ :param pulumi.Input[builtins.str] rmq_version: The Rabbit MQ version. Can be left out, will then be set to
60
+ default value used by CloudAMQP API.
53
61
 
54
- ***Note: There is not yet any support in the provider to change the RMQ version. Once it's set in the initial creation, it will remain.***
55
- :param pulumi.Input[Sequence[pulumi.Input[str]]] tags: One or more tags for the CloudAMQP instance, makes it possible to categories multiple instances in console view. Default there is no tags assigned.
56
- :param pulumi.Input[int] vpc_id: The VPC ID. Use this to create your instance in an existing VPC. See available example.
57
- :param pulumi.Input[str] vpc_subnet: Creates a dedicated VPC subnet, shouldn't overlap with other VPC subnet, default subnet used 10.56.72.0/24.
62
+ ***Note:*** There is not yet any support in the provider to change the RMQ version. Once it's set
63
+ in the initial creation, it will remain.
64
+ :param pulumi.Input[Sequence[pulumi.Input[builtins.str]]] tags: One or more tags for the CloudAMQP instance, makes it possible to
65
+ categories multiple instances in console view. Default there is no tags assigned.
66
+ :param pulumi.Input[builtins.int] vpc_id: The VPC ID. Use this to create your instance in an existing
67
+ VPC. See available [example].
68
+ :param pulumi.Input[builtins.str] vpc_subnet: Creates a dedicated VPC subnet, shouldn't overlap with other
69
+ VPC subnet, default subnet used 10.56.72.0/24.
58
70
 
59
- ***Deprecated: Will be removed in next major version (v2.0)***
71
+ ***Deprecated:*** Will be removed in next major version (v2.0)
60
72
 
61
- ***Note: extra fee will be charged when using VPC, see [CloudAMQP](https://cloudamqp.com) for more information.***
73
+ ***Note:*** Extra fee will be charged when using VPC, see [CloudAMQP] for more information.
62
74
  """
63
75
  pulumi.set(__self__, "plan", plan)
64
76
  pulumi.set(__self__, "region", region)
@@ -83,35 +95,37 @@ class InstanceArgs:
83
95
 
84
96
  @property
85
97
  @pulumi.getter
86
- def plan(self) -> pulumi.Input[str]:
98
+ def plan(self) -> pulumi.Input[builtins.str]:
87
99
  """
88
- The subscription plan. See available plans
100
+ The subscription plan. See available [plans].
89
101
  """
90
102
  return pulumi.get(self, "plan")
91
103
 
92
104
  @plan.setter
93
- def plan(self, value: pulumi.Input[str]):
105
+ def plan(self, value: pulumi.Input[builtins.str]):
94
106
  pulumi.set(self, "plan", value)
95
107
 
96
108
  @property
97
109
  @pulumi.getter
98
- def region(self) -> pulumi.Input[str]:
110
+ def region(self) -> pulumi.Input[builtins.str]:
99
111
  """
100
- The region to host the instance in. See instance regions
112
+ The region to host the instance in. See available [regions].
101
113
 
102
- ***Note: Changing region will force the instance to be destroyed and a new created in the new region. All data will be lost and a new name assigned.***
114
+ ***Note:*** Changing region will force the instance to be destroyed and a new created in the new
115
+ region. All data will be lost and a new name assigned.
103
116
  """
104
117
  return pulumi.get(self, "region")
105
118
 
106
119
  @region.setter
107
- def region(self, value: pulumi.Input[str]):
120
+ def region(self, value: pulumi.Input[builtins.str]):
108
121
  pulumi.set(self, "region", value)
109
122
 
110
123
  @property
111
124
  @pulumi.getter(name="copySettings")
112
125
  def copy_settings(self) -> Optional[pulumi.Input[Sequence[pulumi.Input['InstanceCopySettingArgs']]]]:
113
126
  """
114
- Copy settings from one CloudAMQP instance to a new. Consists of the block documented below.
127
+ Copy settings from one CloudAMQP instance to a new. Consists of
128
+ the block documented below.
115
129
 
116
130
  ___
117
131
 
@@ -125,166 +139,188 @@ class InstanceArgs:
125
139
 
126
140
  @property
127
141
  @pulumi.getter(name="keepAssociatedVpc")
128
- def keep_associated_vpc(self) -> Optional[pulumi.Input[bool]]:
142
+ def keep_associated_vpc(self) -> Optional[pulumi.Input[builtins.bool]]:
129
143
  """
130
- Keep associated VPC when deleting instance, default set to false.
144
+ Keep associated VPC when deleting instance. Default set to
145
+ false.
131
146
  """
132
147
  return pulumi.get(self, "keep_associated_vpc")
133
148
 
134
149
  @keep_associated_vpc.setter
135
- def keep_associated_vpc(self, value: Optional[pulumi.Input[bool]]):
150
+ def keep_associated_vpc(self, value: Optional[pulumi.Input[builtins.bool]]):
136
151
  pulumi.set(self, "keep_associated_vpc", value)
137
152
 
138
153
  @property
139
154
  @pulumi.getter
140
- def name(self) -> Optional[pulumi.Input[str]]:
155
+ def name(self) -> Optional[pulumi.Input[builtins.str]]:
141
156
  """
142
157
  Name of the CloudAMQP instance.
143
158
  """
144
159
  return pulumi.get(self, "name")
145
160
 
146
161
  @name.setter
147
- def name(self, value: Optional[pulumi.Input[str]]):
162
+ def name(self, value: Optional[pulumi.Input[builtins.str]]):
148
163
  pulumi.set(self, "name", value)
149
164
 
150
165
  @property
151
166
  @pulumi.getter(name="noDefaultAlarms")
152
- def no_default_alarms(self) -> Optional[pulumi.Input[bool]]:
167
+ def no_default_alarms(self) -> Optional[pulumi.Input[builtins.bool]]:
153
168
  """
154
- Set to true to discard creating default alarms when the instance is created. Can be left out, will then use default value = false.
169
+ Set to true to not create default alarms
155
170
  """
156
171
  return pulumi.get(self, "no_default_alarms")
157
172
 
158
173
  @no_default_alarms.setter
159
- def no_default_alarms(self, value: Optional[pulumi.Input[bool]]):
174
+ def no_default_alarms(self, value: Optional[pulumi.Input[builtins.bool]]):
160
175
  pulumi.set(self, "no_default_alarms", value)
161
176
 
162
177
  @property
163
178
  @pulumi.getter
164
- def nodes(self) -> Optional[pulumi.Input[int]]:
179
+ def nodes(self) -> Optional[pulumi.Input[builtins.int]]:
165
180
  """
166
- Number of nodes, 1, 3 or 5 depending on plan used. Only needed for legacy plans, will otherwise be computed.
181
+ Number of nodes, 1, 3 or 5 depending on plan used. Only needed for
182
+ legacy plans, will otherwise be computed.
167
183
 
168
- ***Deprecated: Legacy subscriptions plan can still change this to scale up or down the instance. New subscriptions plans use the plan to determine number of nodes. In order to change number of nodes the `plan` needs to be updated.***
184
+ ***Deprecated:*** Legacy subscriptions plan can still change this to scale up or down the instance.
185
+ New subscriptions plans use the plan to determine number of nodes. In order to
186
+ change number of nodes the `plan` needs to be updated.
169
187
  """
170
188
  return pulumi.get(self, "nodes")
171
189
 
172
190
  @nodes.setter
173
- def nodes(self, value: Optional[pulumi.Input[int]]):
191
+ def nodes(self, value: Optional[pulumi.Input[builtins.int]]):
174
192
  pulumi.set(self, "nodes", value)
175
193
 
176
194
  @property
177
195
  @pulumi.getter(name="rmqVersion")
178
- def rmq_version(self) -> Optional[pulumi.Input[str]]:
196
+ def rmq_version(self) -> Optional[pulumi.Input[builtins.str]]:
179
197
  """
180
- The Rabbit MQ version. Can be left out, will then be set to default value used by CloudAMQP API.
198
+ The Rabbit MQ version. Can be left out, will then be set to
199
+ default value used by CloudAMQP API.
181
200
 
182
- ***Note: There is not yet any support in the provider to change the RMQ version. Once it's set in the initial creation, it will remain.***
201
+ ***Note:*** There is not yet any support in the provider to change the RMQ version. Once it's set
202
+ in the initial creation, it will remain.
183
203
  """
184
204
  return pulumi.get(self, "rmq_version")
185
205
 
186
206
  @rmq_version.setter
187
- def rmq_version(self, value: Optional[pulumi.Input[str]]):
207
+ def rmq_version(self, value: Optional[pulumi.Input[builtins.str]]):
188
208
  pulumi.set(self, "rmq_version", value)
189
209
 
190
210
  @property
191
211
  @pulumi.getter
192
- def tags(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]:
212
+ def tags(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[builtins.str]]]]:
193
213
  """
194
- One or more tags for the CloudAMQP instance, makes it possible to categories multiple instances in console view. Default there is no tags assigned.
214
+ One or more tags for the CloudAMQP instance, makes it possible to
215
+ categories multiple instances in console view. Default there is no tags assigned.
195
216
  """
196
217
  return pulumi.get(self, "tags")
197
218
 
198
219
  @tags.setter
199
- def tags(self, value: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]):
220
+ def tags(self, value: Optional[pulumi.Input[Sequence[pulumi.Input[builtins.str]]]]):
200
221
  pulumi.set(self, "tags", value)
201
222
 
202
223
  @property
203
224
  @pulumi.getter(name="vpcId")
204
- def vpc_id(self) -> Optional[pulumi.Input[int]]:
225
+ def vpc_id(self) -> Optional[pulumi.Input[builtins.int]]:
205
226
  """
206
- The VPC ID. Use this to create your instance in an existing VPC. See available example.
227
+ The VPC ID. Use this to create your instance in an existing
228
+ VPC. See available [example].
207
229
  """
208
230
  return pulumi.get(self, "vpc_id")
209
231
 
210
232
  @vpc_id.setter
211
- def vpc_id(self, value: Optional[pulumi.Input[int]]):
233
+ def vpc_id(self, value: Optional[pulumi.Input[builtins.int]]):
212
234
  pulumi.set(self, "vpc_id", value)
213
235
 
214
236
  @property
215
237
  @pulumi.getter(name="vpcSubnet")
216
- def vpc_subnet(self) -> Optional[pulumi.Input[str]]:
238
+ def vpc_subnet(self) -> Optional[pulumi.Input[builtins.str]]:
217
239
  """
218
- Creates a dedicated VPC subnet, shouldn't overlap with other VPC subnet, default subnet used 10.56.72.0/24.
240
+ Creates a dedicated VPC subnet, shouldn't overlap with other
241
+ VPC subnet, default subnet used 10.56.72.0/24.
219
242
 
220
- ***Deprecated: Will be removed in next major version (v2.0)***
243
+ ***Deprecated:*** Will be removed in next major version (v2.0)
221
244
 
222
- ***Note: extra fee will be charged when using VPC, see [CloudAMQP](https://cloudamqp.com) for more information.***
245
+ ***Note:*** Extra fee will be charged when using VPC, see [CloudAMQP] for more information.
223
246
  """
224
247
  return pulumi.get(self, "vpc_subnet")
225
248
 
226
249
  @vpc_subnet.setter
227
- def vpc_subnet(self, value: Optional[pulumi.Input[str]]):
250
+ def vpc_subnet(self, value: Optional[pulumi.Input[builtins.str]]):
228
251
  pulumi.set(self, "vpc_subnet", value)
229
252
 
230
253
 
231
254
  @pulumi.input_type
232
255
  class _InstanceState:
233
256
  def __init__(__self__, *,
234
- apikey: Optional[pulumi.Input[str]] = None,
235
- backend: Optional[pulumi.Input[str]] = None,
257
+ apikey: Optional[pulumi.Input[builtins.str]] = None,
258
+ backend: Optional[pulumi.Input[builtins.str]] = None,
236
259
  copy_settings: Optional[pulumi.Input[Sequence[pulumi.Input['InstanceCopySettingArgs']]]] = None,
237
- dedicated: Optional[pulumi.Input[bool]] = None,
238
- host: Optional[pulumi.Input[str]] = None,
239
- host_internal: Optional[pulumi.Input[str]] = None,
240
- keep_associated_vpc: Optional[pulumi.Input[bool]] = None,
241
- name: Optional[pulumi.Input[str]] = None,
242
- no_default_alarms: Optional[pulumi.Input[bool]] = None,
243
- nodes: Optional[pulumi.Input[int]] = None,
244
- plan: Optional[pulumi.Input[str]] = None,
245
- ready: Optional[pulumi.Input[bool]] = None,
246
- region: Optional[pulumi.Input[str]] = None,
247
- rmq_version: Optional[pulumi.Input[str]] = None,
248
- tags: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
249
- url: Optional[pulumi.Input[str]] = None,
250
- vhost: Optional[pulumi.Input[str]] = None,
251
- vpc_id: Optional[pulumi.Input[int]] = None,
252
- vpc_subnet: Optional[pulumi.Input[str]] = None):
260
+ dedicated: Optional[pulumi.Input[builtins.bool]] = None,
261
+ host: Optional[pulumi.Input[builtins.str]] = None,
262
+ host_internal: Optional[pulumi.Input[builtins.str]] = None,
263
+ keep_associated_vpc: Optional[pulumi.Input[builtins.bool]] = None,
264
+ name: Optional[pulumi.Input[builtins.str]] = None,
265
+ no_default_alarms: Optional[pulumi.Input[builtins.bool]] = None,
266
+ nodes: Optional[pulumi.Input[builtins.int]] = None,
267
+ plan: Optional[pulumi.Input[builtins.str]] = None,
268
+ ready: Optional[pulumi.Input[builtins.bool]] = None,
269
+ region: Optional[pulumi.Input[builtins.str]] = None,
270
+ rmq_version: Optional[pulumi.Input[builtins.str]] = None,
271
+ tags: Optional[pulumi.Input[Sequence[pulumi.Input[builtins.str]]]] = None,
272
+ url: Optional[pulumi.Input[builtins.str]] = None,
273
+ vhost: Optional[pulumi.Input[builtins.str]] = None,
274
+ vpc_id: Optional[pulumi.Input[builtins.int]] = None,
275
+ vpc_subnet: Optional[pulumi.Input[builtins.str]] = None):
253
276
  """
254
277
  Input properties used for looking up and filtering Instance resources.
255
- :param pulumi.Input[str] apikey: API key needed to communicate to CloudAMQP's second API. The second API is used to manage alarms, integration and more, full description [CloudAMQP API](https://docs.cloudamqp.com/cloudamqp_api.html).
256
- :param pulumi.Input[str] backend: Information if the CloudAMQP instance runs either RabbitMQ or LavinMQ.
257
- :param pulumi.Input[Sequence[pulumi.Input['InstanceCopySettingArgs']]] copy_settings: Copy settings from one CloudAMQP instance to a new. Consists of the block documented below.
278
+ :param pulumi.Input[builtins.str] apikey: API key needed to communicate to CloudAMQP's second API. The second API is used
279
+ to manage alarms, integration and more, full description [CloudAMQP API].
280
+ :param pulumi.Input[builtins.str] backend: Information if the CloudAMQP instance runs either RabbitMQ or LavinMQ.
281
+ :param pulumi.Input[Sequence[pulumi.Input['InstanceCopySettingArgs']]] copy_settings: Copy settings from one CloudAMQP instance to a new. Consists of
282
+ the block documented below.
258
283
 
259
284
  ___
260
285
 
261
286
  The `copy_settings` block consists of:
262
- :param pulumi.Input[bool] dedicated: Information if the CloudAMQP instance is shared or dedicated.
263
- :param pulumi.Input[str] host: The external hostname for the CloudAMQP instance.
264
- :param pulumi.Input[str] host_internal: The internal hostname for the CloudAMQP instance.
265
- :param pulumi.Input[bool] keep_associated_vpc: Keep associated VPC when deleting instance, default set to false.
266
- :param pulumi.Input[str] name: Name of the CloudAMQP instance.
267
- :param pulumi.Input[bool] no_default_alarms: Set to true to discard creating default alarms when the instance is created. Can be left out, will then use default value = false.
268
- :param pulumi.Input[int] nodes: Number of nodes, 1, 3 or 5 depending on plan used. Only needed for legacy plans, will otherwise be computed.
287
+ :param pulumi.Input[builtins.bool] dedicated: Information if the CloudAMQP instance is shared or dedicated.
288
+ :param pulumi.Input[builtins.str] host: The external hostname for the CloudAMQP instance.
289
+ :param pulumi.Input[builtins.str] host_internal: The internal hostname for the CloudAMQP instance.
290
+ :param pulumi.Input[builtins.bool] keep_associated_vpc: Keep associated VPC when deleting instance. Default set to
291
+ false.
292
+ :param pulumi.Input[builtins.str] name: Name of the CloudAMQP instance.
293
+ :param pulumi.Input[builtins.bool] no_default_alarms: Set to true to not create default alarms
294
+ :param pulumi.Input[builtins.int] nodes: Number of nodes, 1, 3 or 5 depending on plan used. Only needed for
295
+ legacy plans, will otherwise be computed.
269
296
 
270
- ***Deprecated: Legacy subscriptions plan can still change this to scale up or down the instance. New subscriptions plans use the plan to determine number of nodes. In order to change number of nodes the `plan` needs to be updated.***
271
- :param pulumi.Input[str] plan: The subscription plan. See available plans
272
- :param pulumi.Input[bool] ready: Flag describing if the resource is ready
273
- :param pulumi.Input[str] region: The region to host the instance in. See instance regions
297
+ ***Deprecated:*** Legacy subscriptions plan can still change this to scale up or down the instance.
298
+ New subscriptions plans use the plan to determine number of nodes. In order to
299
+ change number of nodes the `plan` needs to be updated.
300
+ :param pulumi.Input[builtins.str] plan: The subscription plan. See available [plans].
301
+ :param pulumi.Input[builtins.bool] ready: Flag describing if the resource is ready
302
+ :param pulumi.Input[builtins.str] region: The region to host the instance in. See available [regions].
274
303
 
275
- ***Note: Changing region will force the instance to be destroyed and a new created in the new region. All data will be lost and a new name assigned.***
276
- :param pulumi.Input[str] rmq_version: The Rabbit MQ version. Can be left out, will then be set to default value used by CloudAMQP API.
304
+ ***Note:*** Changing region will force the instance to be destroyed and a new created in the new
305
+ region. All data will be lost and a new name assigned.
306
+ :param pulumi.Input[builtins.str] rmq_version: The Rabbit MQ version. Can be left out, will then be set to
307
+ default value used by CloudAMQP API.
277
308
 
278
- ***Note: There is not yet any support in the provider to change the RMQ version. Once it's set in the initial creation, it will remain.***
279
- :param pulumi.Input[Sequence[pulumi.Input[str]]] tags: One or more tags for the CloudAMQP instance, makes it possible to categories multiple instances in console view. Default there is no tags assigned.
280
- :param pulumi.Input[str] url: The AMQP URL (uses the internal hostname if the instance was created with VPC). Has the format: `amqps://{username}:{password}@{hostname}/{vhost}`
281
- :param pulumi.Input[str] vhost: The virtual host used by Rabbit MQ.
282
- :param pulumi.Input[int] vpc_id: The VPC ID. Use this to create your instance in an existing VPC. See available example.
283
- :param pulumi.Input[str] vpc_subnet: Creates a dedicated VPC subnet, shouldn't overlap with other VPC subnet, default subnet used 10.56.72.0/24.
309
+ ***Note:*** There is not yet any support in the provider to change the RMQ version. Once it's set
310
+ in the initial creation, it will remain.
311
+ :param pulumi.Input[Sequence[pulumi.Input[builtins.str]]] tags: One or more tags for the CloudAMQP instance, makes it possible to
312
+ categories multiple instances in console view. Default there is no tags assigned.
313
+ :param pulumi.Input[builtins.str] url: The AMQP URL (uses the internal hostname if the instance was created with VPC).
314
+ Has the format: `amqps://{username}:{password}@{hostname}/{vhost}`
315
+ :param pulumi.Input[builtins.str] vhost: The virtual host used by Rabbit MQ.
316
+ :param pulumi.Input[builtins.int] vpc_id: The VPC ID. Use this to create your instance in an existing
317
+ VPC. See available [example].
318
+ :param pulumi.Input[builtins.str] vpc_subnet: Creates a dedicated VPC subnet, shouldn't overlap with other
319
+ VPC subnet, default subnet used 10.56.72.0/24.
284
320
 
285
- ***Deprecated: Will be removed in next major version (v2.0)***
321
+ ***Deprecated:*** Will be removed in next major version (v2.0)
286
322
 
287
- ***Note: extra fee will be charged when using VPC, see [CloudAMQP](https://cloudamqp.com) for more information.***
323
+ ***Note:*** Extra fee will be charged when using VPC, see [CloudAMQP] for more information.
288
324
  """
289
325
  if apikey is not None:
290
326
  pulumi.set(__self__, "apikey", apikey)
@@ -327,33 +363,35 @@ class _InstanceState:
327
363
 
328
364
  @property
329
365
  @pulumi.getter
330
- def apikey(self) -> Optional[pulumi.Input[str]]:
366
+ def apikey(self) -> Optional[pulumi.Input[builtins.str]]:
331
367
  """
332
- API key needed to communicate to CloudAMQP's second API. The second API is used to manage alarms, integration and more, full description [CloudAMQP API](https://docs.cloudamqp.com/cloudamqp_api.html).
368
+ API key needed to communicate to CloudAMQP's second API. The second API is used
369
+ to manage alarms, integration and more, full description [CloudAMQP API].
333
370
  """
334
371
  return pulumi.get(self, "apikey")
335
372
 
336
373
  @apikey.setter
337
- def apikey(self, value: Optional[pulumi.Input[str]]):
374
+ def apikey(self, value: Optional[pulumi.Input[builtins.str]]):
338
375
  pulumi.set(self, "apikey", value)
339
376
 
340
377
  @property
341
378
  @pulumi.getter
342
- def backend(self) -> Optional[pulumi.Input[str]]:
379
+ def backend(self) -> Optional[pulumi.Input[builtins.str]]:
343
380
  """
344
381
  Information if the CloudAMQP instance runs either RabbitMQ or LavinMQ.
345
382
  """
346
383
  return pulumi.get(self, "backend")
347
384
 
348
385
  @backend.setter
349
- def backend(self, value: Optional[pulumi.Input[str]]):
386
+ def backend(self, value: Optional[pulumi.Input[builtins.str]]):
350
387
  pulumi.set(self, "backend", value)
351
388
 
352
389
  @property
353
390
  @pulumi.getter(name="copySettings")
354
391
  def copy_settings(self) -> Optional[pulumi.Input[Sequence[pulumi.Input['InstanceCopySettingArgs']]]]:
355
392
  """
356
- Copy settings from one CloudAMQP instance to a new. Consists of the block documented below.
393
+ Copy settings from one CloudAMQP instance to a new. Consists of
394
+ the block documented below.
357
395
 
358
396
  ___
359
397
 
@@ -367,204 +405,215 @@ class _InstanceState:
367
405
 
368
406
  @property
369
407
  @pulumi.getter
370
- def dedicated(self) -> Optional[pulumi.Input[bool]]:
408
+ def dedicated(self) -> Optional[pulumi.Input[builtins.bool]]:
371
409
  """
372
410
  Information if the CloudAMQP instance is shared or dedicated.
373
411
  """
374
412
  return pulumi.get(self, "dedicated")
375
413
 
376
414
  @dedicated.setter
377
- def dedicated(self, value: Optional[pulumi.Input[bool]]):
415
+ def dedicated(self, value: Optional[pulumi.Input[builtins.bool]]):
378
416
  pulumi.set(self, "dedicated", value)
379
417
 
380
418
  @property
381
419
  @pulumi.getter
382
- def host(self) -> Optional[pulumi.Input[str]]:
420
+ def host(self) -> Optional[pulumi.Input[builtins.str]]:
383
421
  """
384
422
  The external hostname for the CloudAMQP instance.
385
423
  """
386
424
  return pulumi.get(self, "host")
387
425
 
388
426
  @host.setter
389
- def host(self, value: Optional[pulumi.Input[str]]):
427
+ def host(self, value: Optional[pulumi.Input[builtins.str]]):
390
428
  pulumi.set(self, "host", value)
391
429
 
392
430
  @property
393
431
  @pulumi.getter(name="hostInternal")
394
- def host_internal(self) -> Optional[pulumi.Input[str]]:
432
+ def host_internal(self) -> Optional[pulumi.Input[builtins.str]]:
395
433
  """
396
434
  The internal hostname for the CloudAMQP instance.
397
435
  """
398
436
  return pulumi.get(self, "host_internal")
399
437
 
400
438
  @host_internal.setter
401
- def host_internal(self, value: Optional[pulumi.Input[str]]):
439
+ def host_internal(self, value: Optional[pulumi.Input[builtins.str]]):
402
440
  pulumi.set(self, "host_internal", value)
403
441
 
404
442
  @property
405
443
  @pulumi.getter(name="keepAssociatedVpc")
406
- def keep_associated_vpc(self) -> Optional[pulumi.Input[bool]]:
444
+ def keep_associated_vpc(self) -> Optional[pulumi.Input[builtins.bool]]:
407
445
  """
408
- Keep associated VPC when deleting instance, default set to false.
446
+ Keep associated VPC when deleting instance. Default set to
447
+ false.
409
448
  """
410
449
  return pulumi.get(self, "keep_associated_vpc")
411
450
 
412
451
  @keep_associated_vpc.setter
413
- def keep_associated_vpc(self, value: Optional[pulumi.Input[bool]]):
452
+ def keep_associated_vpc(self, value: Optional[pulumi.Input[builtins.bool]]):
414
453
  pulumi.set(self, "keep_associated_vpc", value)
415
454
 
416
455
  @property
417
456
  @pulumi.getter
418
- def name(self) -> Optional[pulumi.Input[str]]:
457
+ def name(self) -> Optional[pulumi.Input[builtins.str]]:
419
458
  """
420
459
  Name of the CloudAMQP instance.
421
460
  """
422
461
  return pulumi.get(self, "name")
423
462
 
424
463
  @name.setter
425
- def name(self, value: Optional[pulumi.Input[str]]):
464
+ def name(self, value: Optional[pulumi.Input[builtins.str]]):
426
465
  pulumi.set(self, "name", value)
427
466
 
428
467
  @property
429
468
  @pulumi.getter(name="noDefaultAlarms")
430
- def no_default_alarms(self) -> Optional[pulumi.Input[bool]]:
469
+ def no_default_alarms(self) -> Optional[pulumi.Input[builtins.bool]]:
431
470
  """
432
- Set to true to discard creating default alarms when the instance is created. Can be left out, will then use default value = false.
471
+ Set to true to not create default alarms
433
472
  """
434
473
  return pulumi.get(self, "no_default_alarms")
435
474
 
436
475
  @no_default_alarms.setter
437
- def no_default_alarms(self, value: Optional[pulumi.Input[bool]]):
476
+ def no_default_alarms(self, value: Optional[pulumi.Input[builtins.bool]]):
438
477
  pulumi.set(self, "no_default_alarms", value)
439
478
 
440
479
  @property
441
480
  @pulumi.getter
442
- def nodes(self) -> Optional[pulumi.Input[int]]:
481
+ def nodes(self) -> Optional[pulumi.Input[builtins.int]]:
443
482
  """
444
- Number of nodes, 1, 3 or 5 depending on plan used. Only needed for legacy plans, will otherwise be computed.
483
+ Number of nodes, 1, 3 or 5 depending on plan used. Only needed for
484
+ legacy plans, will otherwise be computed.
445
485
 
446
- ***Deprecated: Legacy subscriptions plan can still change this to scale up or down the instance. New subscriptions plans use the plan to determine number of nodes. In order to change number of nodes the `plan` needs to be updated.***
486
+ ***Deprecated:*** Legacy subscriptions plan can still change this to scale up or down the instance.
487
+ New subscriptions plans use the plan to determine number of nodes. In order to
488
+ change number of nodes the `plan` needs to be updated.
447
489
  """
448
490
  return pulumi.get(self, "nodes")
449
491
 
450
492
  @nodes.setter
451
- def nodes(self, value: Optional[pulumi.Input[int]]):
493
+ def nodes(self, value: Optional[pulumi.Input[builtins.int]]):
452
494
  pulumi.set(self, "nodes", value)
453
495
 
454
496
  @property
455
497
  @pulumi.getter
456
- def plan(self) -> Optional[pulumi.Input[str]]:
498
+ def plan(self) -> Optional[pulumi.Input[builtins.str]]:
457
499
  """
458
- The subscription plan. See available plans
500
+ The subscription plan. See available [plans].
459
501
  """
460
502
  return pulumi.get(self, "plan")
461
503
 
462
504
  @plan.setter
463
- def plan(self, value: Optional[pulumi.Input[str]]):
505
+ def plan(self, value: Optional[pulumi.Input[builtins.str]]):
464
506
  pulumi.set(self, "plan", value)
465
507
 
466
508
  @property
467
509
  @pulumi.getter
468
- def ready(self) -> Optional[pulumi.Input[bool]]:
510
+ def ready(self) -> Optional[pulumi.Input[builtins.bool]]:
469
511
  """
470
512
  Flag describing if the resource is ready
471
513
  """
472
514
  return pulumi.get(self, "ready")
473
515
 
474
516
  @ready.setter
475
- def ready(self, value: Optional[pulumi.Input[bool]]):
517
+ def ready(self, value: Optional[pulumi.Input[builtins.bool]]):
476
518
  pulumi.set(self, "ready", value)
477
519
 
478
520
  @property
479
521
  @pulumi.getter
480
- def region(self) -> Optional[pulumi.Input[str]]:
522
+ def region(self) -> Optional[pulumi.Input[builtins.str]]:
481
523
  """
482
- The region to host the instance in. See instance regions
524
+ The region to host the instance in. See available [regions].
483
525
 
484
- ***Note: Changing region will force the instance to be destroyed and a new created in the new region. All data will be lost and a new name assigned.***
526
+ ***Note:*** Changing region will force the instance to be destroyed and a new created in the new
527
+ region. All data will be lost and a new name assigned.
485
528
  """
486
529
  return pulumi.get(self, "region")
487
530
 
488
531
  @region.setter
489
- def region(self, value: Optional[pulumi.Input[str]]):
532
+ def region(self, value: Optional[pulumi.Input[builtins.str]]):
490
533
  pulumi.set(self, "region", value)
491
534
 
492
535
  @property
493
536
  @pulumi.getter(name="rmqVersion")
494
- def rmq_version(self) -> Optional[pulumi.Input[str]]:
537
+ def rmq_version(self) -> Optional[pulumi.Input[builtins.str]]:
495
538
  """
496
- The Rabbit MQ version. Can be left out, will then be set to default value used by CloudAMQP API.
539
+ The Rabbit MQ version. Can be left out, will then be set to
540
+ default value used by CloudAMQP API.
497
541
 
498
- ***Note: There is not yet any support in the provider to change the RMQ version. Once it's set in the initial creation, it will remain.***
542
+ ***Note:*** There is not yet any support in the provider to change the RMQ version. Once it's set
543
+ in the initial creation, it will remain.
499
544
  """
500
545
  return pulumi.get(self, "rmq_version")
501
546
 
502
547
  @rmq_version.setter
503
- def rmq_version(self, value: Optional[pulumi.Input[str]]):
548
+ def rmq_version(self, value: Optional[pulumi.Input[builtins.str]]):
504
549
  pulumi.set(self, "rmq_version", value)
505
550
 
506
551
  @property
507
552
  @pulumi.getter
508
- def tags(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]:
553
+ def tags(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[builtins.str]]]]:
509
554
  """
510
- One or more tags for the CloudAMQP instance, makes it possible to categories multiple instances in console view. Default there is no tags assigned.
555
+ One or more tags for the CloudAMQP instance, makes it possible to
556
+ categories multiple instances in console view. Default there is no tags assigned.
511
557
  """
512
558
  return pulumi.get(self, "tags")
513
559
 
514
560
  @tags.setter
515
- def tags(self, value: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]):
561
+ def tags(self, value: Optional[pulumi.Input[Sequence[pulumi.Input[builtins.str]]]]):
516
562
  pulumi.set(self, "tags", value)
517
563
 
518
564
  @property
519
565
  @pulumi.getter
520
- def url(self) -> Optional[pulumi.Input[str]]:
566
+ def url(self) -> Optional[pulumi.Input[builtins.str]]:
521
567
  """
522
- The AMQP URL (uses the internal hostname if the instance was created with VPC). Has the format: `amqps://{username}:{password}@{hostname}/{vhost}`
568
+ The AMQP URL (uses the internal hostname if the instance was created with VPC).
569
+ Has the format: `amqps://{username}:{password}@{hostname}/{vhost}`
523
570
  """
524
571
  return pulumi.get(self, "url")
525
572
 
526
573
  @url.setter
527
- def url(self, value: Optional[pulumi.Input[str]]):
574
+ def url(self, value: Optional[pulumi.Input[builtins.str]]):
528
575
  pulumi.set(self, "url", value)
529
576
 
530
577
  @property
531
578
  @pulumi.getter
532
- def vhost(self) -> Optional[pulumi.Input[str]]:
579
+ def vhost(self) -> Optional[pulumi.Input[builtins.str]]:
533
580
  """
534
581
  The virtual host used by Rabbit MQ.
535
582
  """
536
583
  return pulumi.get(self, "vhost")
537
584
 
538
585
  @vhost.setter
539
- def vhost(self, value: Optional[pulumi.Input[str]]):
586
+ def vhost(self, value: Optional[pulumi.Input[builtins.str]]):
540
587
  pulumi.set(self, "vhost", value)
541
588
 
542
589
  @property
543
590
  @pulumi.getter(name="vpcId")
544
- def vpc_id(self) -> Optional[pulumi.Input[int]]:
591
+ def vpc_id(self) -> Optional[pulumi.Input[builtins.int]]:
545
592
  """
546
- The VPC ID. Use this to create your instance in an existing VPC. See available example.
593
+ The VPC ID. Use this to create your instance in an existing
594
+ VPC. See available [example].
547
595
  """
548
596
  return pulumi.get(self, "vpc_id")
549
597
 
550
598
  @vpc_id.setter
551
- def vpc_id(self, value: Optional[pulumi.Input[int]]):
599
+ def vpc_id(self, value: Optional[pulumi.Input[builtins.int]]):
552
600
  pulumi.set(self, "vpc_id", value)
553
601
 
554
602
  @property
555
603
  @pulumi.getter(name="vpcSubnet")
556
- def vpc_subnet(self) -> Optional[pulumi.Input[str]]:
604
+ def vpc_subnet(self) -> Optional[pulumi.Input[builtins.str]]:
557
605
  """
558
- Creates a dedicated VPC subnet, shouldn't overlap with other VPC subnet, default subnet used 10.56.72.0/24.
606
+ Creates a dedicated VPC subnet, shouldn't overlap with other
607
+ VPC subnet, default subnet used 10.56.72.0/24.
559
608
 
560
- ***Deprecated: Will be removed in next major version (v2.0)***
609
+ ***Deprecated:*** Will be removed in next major version (v2.0)
561
610
 
562
- ***Note: extra fee will be charged when using VPC, see [CloudAMQP](https://cloudamqp.com) for more information.***
611
+ ***Note:*** Extra fee will be charged when using VPC, see [CloudAMQP] for more information.
563
612
  """
564
613
  return pulumi.get(self, "vpc_subnet")
565
614
 
566
615
  @vpc_subnet.setter
567
- def vpc_subnet(self, value: Optional[pulumi.Input[str]]):
616
+ def vpc_subnet(self, value: Optional[pulumi.Input[builtins.str]]):
568
617
  pulumi.set(self, "vpc_subnet", value)
569
618
 
570
619
 
@@ -574,30 +623,33 @@ class Instance(pulumi.CustomResource):
574
623
  resource_name: str,
575
624
  opts: Optional[pulumi.ResourceOptions] = None,
576
625
  copy_settings: Optional[pulumi.Input[Sequence[pulumi.Input[Union['InstanceCopySettingArgs', 'InstanceCopySettingArgsDict']]]]] = None,
577
- keep_associated_vpc: Optional[pulumi.Input[bool]] = None,
578
- name: Optional[pulumi.Input[str]] = None,
579
- no_default_alarms: Optional[pulumi.Input[bool]] = None,
580
- nodes: Optional[pulumi.Input[int]] = None,
581
- plan: Optional[pulumi.Input[str]] = None,
582
- region: Optional[pulumi.Input[str]] = None,
583
- rmq_version: Optional[pulumi.Input[str]] = None,
584
- tags: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
585
- vpc_id: Optional[pulumi.Input[int]] = None,
586
- vpc_subnet: Optional[pulumi.Input[str]] = None,
626
+ keep_associated_vpc: Optional[pulumi.Input[builtins.bool]] = None,
627
+ name: Optional[pulumi.Input[builtins.str]] = None,
628
+ no_default_alarms: Optional[pulumi.Input[builtins.bool]] = None,
629
+ nodes: Optional[pulumi.Input[builtins.int]] = None,
630
+ plan: Optional[pulumi.Input[builtins.str]] = None,
631
+ region: Optional[pulumi.Input[builtins.str]] = None,
632
+ rmq_version: Optional[pulumi.Input[builtins.str]] = None,
633
+ tags: Optional[pulumi.Input[Sequence[pulumi.Input[builtins.str]]]] = None,
634
+ vpc_id: Optional[pulumi.Input[builtins.int]] = None,
635
+ vpc_subnet: Optional[pulumi.Input[builtins.str]] = None,
587
636
  __props__=None):
588
637
  """
589
- This resource allows you to create and manage a CloudAMQP instance running either [**RabbitMQ**](https://www.rabbitmq.com/) or [**LavinMQ**](https://lavinmq.com/) and can be deployed to multiple cloud platforms provider and regions, see instance regions for more information.
638
+ This resource allows you to create and manage a CloudAMQP instance running either [**RabbitMQ**] or
639
+ [**LavinMQ**] and can be deployed to multiple cloud platforms provider and regions, see
640
+ [instance regions] for more information.
590
641
 
591
- Once the instance is created it will be assigned a unique identifier. All other resources and data sources created for this instance needs to reference this unique instance identifier.
642
+ Once the instance is created it will be assigned a unique identifier. All other resources and data
643
+ sources created for this instance needs to reference this unique instance identifier.
592
644
 
593
- Pricing is available at [cloudamqp.com](https://www.cloudamqp.com/plans.html).
645
+ Pricing is available at [CloudAMQP plans].
594
646
 
595
647
  ## Example Usage
596
648
 
597
649
  <details>
598
650
  <summary>
599
651
  <b>
600
- <i>Basic example of shared and dedicated instances</i>
652
+ <i>Shared and dedicated instances running LavinMQ</i>
601
653
  </b>
602
654
  </summary>
603
655
 
@@ -605,24 +657,30 @@ class Instance(pulumi.CustomResource):
605
657
  import pulumi
606
658
  import pulumi_cloudamqp as cloudamqp
607
659
 
608
- # Minimum free lemur instance running RabbitMQ
660
+ # Minimum free lemming instance running LavinMQ
609
661
  lemur_instance = cloudamqp.Instance("lemur_instance",
610
- name="cloudamqp-free-instance",
662
+ name="cloudamqp-free-instance-01",
663
+ plan="lemming",
664
+ region="amazon-web-services::us-west-1",
665
+ tags=["lavinmq"])
666
+ # Minimum free lemur instance running RabbitMQ
667
+ lemming_instance = cloudamqp.Instance("lemming_instance",
668
+ name="cloudamqp-free-instance-02",
611
669
  plan="lemur",
612
670
  region="amazon-web-services::us-west-1",
613
671
  tags=["rabbitmq"])
614
- # Minimum free lemming instance running LavinMQ
615
- lemming_instance = cloudamqp.Instance("lemming_instance",
616
- name="cloudamqp-free-instance",
617
- plan="lemming",
672
+ # Dedicated penguin instance running LavinMQ
673
+ penguin_instance = cloudamqp.Instance("penguin_instance",
674
+ name="terraform-cloudamqp-instance-01",
675
+ plan="penguin-1",
618
676
  region="amazon-web-services::us-west-1",
619
677
  tags=["lavinmq"])
620
- # New dedicated bunny instance running RabbitMQ
621
- instance = cloudamqp.Instance("instance",
622
- name="terraform-cloudamqp-instance",
678
+ # Dedicated bunny instance running RabbitMQ
679
+ bunny_instance = cloudamqp.Instance("bunny_instance",
680
+ name="terraform-cloudamqp-instance-02",
623
681
  plan="bunny-1",
624
682
  region="amazon-web-services::us-west-1",
625
- tags=["terraform"])
683
+ tags=["rabbitmq"])
626
684
  ```
627
685
 
628
686
  </details>
@@ -640,7 +698,7 @@ class Instance(pulumi.CustomResource):
640
698
 
641
699
  instance = cloudamqp.Instance("instance",
642
700
  name="terraform-cloudamqp-instance",
643
- plan="bunny-1",
701
+ plan="penguin-1",
644
702
  region="amazon-web-services::us-west-1",
645
703
  tags=["terraform"],
646
704
  vpc_subnet="10.56.72.0/24")
@@ -651,7 +709,10 @@ class Instance(pulumi.CustomResource):
651
709
  <details>
652
710
  <summary>
653
711
  <b>
654
- <i>Dedicated instance using attribute vpc_subnet to create VPC and then import managed VPC, from v1.16.0 (Managed VPC)</i>
712
+ <i>
713
+ Dedicated instance using attribute vpc_subnet to create VPC and then import managed VPC,
714
+ from v1.16.0 (Managed VPC)
715
+ </i>
655
716
  </b>
656
717
  </summary>
657
718
 
@@ -662,15 +723,16 @@ class Instance(pulumi.CustomResource):
662
723
  # Dedicated instance that also creates VPC
663
724
  instance01 = cloudamqp.Instance("instance_01",
664
725
  name="terraform-cloudamqp-instance-01",
665
- plan="bunny-1",
726
+ plan="penguin-1",
666
727
  region="amazon-web-services::us-west-1",
667
728
  tags=["terraform"],
668
729
  vpc_subnet="10.56.72.0/24")
669
730
  ```
670
731
 
671
- Once the instance and the VPC are created, the VPC can be imported as managed VPC and added to the configuration file.
672
- Set attribute `vpc_id` to the managed VPC identifier. To keep the managed VPC when deleting the instance, set attribute `keep_associated_vpc` to true.
673
- For more information see guide Managed VPC.
732
+ Once the instance and the VPC are created, the VPC can be imported as managed VPC and added to the
733
+ configuration file. Set attribute `vpc_id` to the managed VPC identifier. To keep the managed VPC
734
+ when deleting the instance, set attribute `keep_associated_vpc` to true. For more information see
735
+ guide [Managed VPC].
674
736
 
675
737
  ```python
676
738
  import pulumi
@@ -685,7 +747,7 @@ class Instance(pulumi.CustomResource):
685
747
  # Add vpc_id and keep_associated_vpc attributes
686
748
  instance01 = cloudamqp.Instance("instance_01",
687
749
  name="terraform-cloudamqp-instance-01",
688
- plan="bunny-1",
750
+ plan="penguin-1",
689
751
  region="amazon-web-services::us-west-1",
690
752
  tags=["terraform"],
691
753
  vpc_id=vpc.id,
@@ -714,7 +776,7 @@ class Instance(pulumi.CustomResource):
714
776
  # First instance added to managed VPC
715
777
  instance01 = cloudamqp.Instance("instance_01",
716
778
  name="terraform-cloudamqp-instance-01",
717
- plan="bunny-1",
779
+ plan="penguin-1",
718
780
  region="amazon-web-services::us-west-1",
719
781
  tags=["terraform"],
720
782
  vpc_id=vpc.id,
@@ -722,7 +784,7 @@ class Instance(pulumi.CustomResource):
722
784
  # Second instance added to managed VPC
723
785
  instance02 = cloudamqp.Instance("instance_02",
724
786
  name="terraform-cloudamqp-instance-02",
725
- plan="bunny-1",
787
+ plan="penguin-1",
726
788
  region="amazon-web-services::us-west-1",
727
789
  tags=["terraform"],
728
790
  vpc_id=vpc.id,
@@ -733,13 +795,43 @@ class Instance(pulumi.CustomResource):
733
795
 
734
796
  </details>
735
797
 
736
- ## Copy settings to a new dedicated instance
798
+ ### Settings supported by LavinMQ
737
799
 
738
- With copy settings it's possible to create a new dedicated instance with settings such as alarms, config, etc. from another dedicated instance. This can be done by adding the `copy_settings` block to this resource and populate `subscription_id` with a CloudAMQP instance identifier from another already existing instance.
800
+ ***Allowed values:*** alarms, definitions, firewall, metrics
739
801
 
740
- Then add the settings to be copied over to the new dedicated instance. Settings that can be copied [alarms, config, definitions, firewall, logs, metrics, plugins]
802
+ <details>
803
+ <summary>
804
+ <b>
805
+ <i>Copy settings from a dedicated instance to a new dedicated instance</i>
806
+ </b>
807
+ </summary>
741
808
 
742
- > `rmq_version` argument is required when doing this action. Must match the RabbitMQ version of the dedicated instance to be copied from.
809
+ ```python
810
+ import pulumi
811
+ import pulumi_cloudamqp as cloudamqp
812
+
813
+ penguin_instance = cloudamqp.Instance("penguin_instance",
814
+ name="terraform-cloudamqp-instance-01",
815
+ plan="penguin-1",
816
+ region="amazon-web-services::us-west-1",
817
+ rmq_version="2.2.0",
818
+ tags=["terraform"],
819
+ copy_settings=[{
820
+ "subscription_id": instance_id,
821
+ "settings": [
822
+ "alarms",
823
+ "definitions",
824
+ "firewall",
825
+ "metrics",
826
+ ],
827
+ }])
828
+ ```
829
+
830
+ </details>
831
+
832
+ ### Settings supported by RabbitMQ
833
+
834
+ ***Allowed values:*** alarms, config, definitions, firewall, logs, metrics, plugins
743
835
 
744
836
  <details>
745
837
  <summary>
@@ -752,9 +844,9 @@ class Instance(pulumi.CustomResource):
752
844
  import pulumi
753
845
  import pulumi_cloudamqp as cloudamqp
754
846
 
755
- instance02 = cloudamqp.Instance("instance_02",
847
+ bunny_instance = cloudamqp.Instance("bunny_instance",
756
848
  name="terraform-cloudamqp-instance-02",
757
- plan="squirrel-1",
849
+ plan="bunny-1",
758
850
  region="amazon-web-services::us-west-1",
759
851
  rmq_version="3.12.2",
760
852
  tags=["terraform"],
@@ -774,43 +866,80 @@ class Instance(pulumi.CustomResource):
774
866
 
775
867
  </details>
776
868
 
869
+ [CloudAMQP]: https://cloudamqp.com
870
+ [CloudAMQP API]: https://docs.cloudamqp.com/cloudamqp_api.html
871
+ [CloudAMQP API list instances]: https://docs.cloudamqp.com/#list-instances
872
+ [CloudAMQP plans]: https://www.cloudamqp.com/plans.html
873
+ [copy settings]: #copy-settings-to-a-new-dedicated-instance
874
+ [example]: ../guides/info_vpc_existing.md
875
+ [regions]: ../guides/info_region.md
876
+ [**LavinMQ**]: https://lavinmq.com
877
+ [Managed VPC]: ../guides/info_managed_vpc#dedicated-instance-and-vpc_subnet
878
+ [plans]: ../guides/info_plan.md
879
+ [**RabbitMQ**]: https://www.rabbitmq.com
880
+
777
881
  ## Import
778
882
 
779
- `cloudamqp_instance`can be imported using CloudAMQP internal identifier.
883
+ `cloudamqp_instance`can be imported using resource identifier. To retrieve the resource identifier,
884
+
885
+ use [CloudAMQP API list instances]
886
+
887
+ From Terraform v1.5.0, the `import` block can be used to import this resource:
888
+
889
+ hcl
890
+
891
+ import {
892
+
893
+ to = cloudamqp_instance.instance
894
+
895
+ id = <id>
896
+
897
+ }
898
+
899
+ Or use Terraform CLI:
780
900
 
781
901
  ```sh
782
902
  $ pulumi import cloudamqp:index/instance:Instance instance <id>`
783
903
  ```
784
904
 
785
- To retrieve the identifier for an instance, either use [CloudAMQP customer API](https://docs.cloudamqp.com/#list-instances) or use the data source [`cloudamqp_account`](./data-sources/account.md) to list all available instances for an account.
786
-
787
905
  :param str resource_name: The name of the resource.
788
906
  :param pulumi.ResourceOptions opts: Options for the resource.
789
- :param pulumi.Input[Sequence[pulumi.Input[Union['InstanceCopySettingArgs', 'InstanceCopySettingArgsDict']]]] copy_settings: Copy settings from one CloudAMQP instance to a new. Consists of the block documented below.
907
+ :param pulumi.Input[Sequence[pulumi.Input[Union['InstanceCopySettingArgs', 'InstanceCopySettingArgsDict']]]] copy_settings: Copy settings from one CloudAMQP instance to a new. Consists of
908
+ the block documented below.
790
909
 
791
910
  ___
792
911
 
793
912
  The `copy_settings` block consists of:
794
- :param pulumi.Input[bool] keep_associated_vpc: Keep associated VPC when deleting instance, default set to false.
795
- :param pulumi.Input[str] name: Name of the CloudAMQP instance.
796
- :param pulumi.Input[bool] no_default_alarms: Set to true to discard creating default alarms when the instance is created. Can be left out, will then use default value = false.
797
- :param pulumi.Input[int] nodes: Number of nodes, 1, 3 or 5 depending on plan used. Only needed for legacy plans, will otherwise be computed.
913
+ :param pulumi.Input[builtins.bool] keep_associated_vpc: Keep associated VPC when deleting instance. Default set to
914
+ false.
915
+ :param pulumi.Input[builtins.str] name: Name of the CloudAMQP instance.
916
+ :param pulumi.Input[builtins.bool] no_default_alarms: Set to true to not create default alarms
917
+ :param pulumi.Input[builtins.int] nodes: Number of nodes, 1, 3 or 5 depending on plan used. Only needed for
918
+ legacy plans, will otherwise be computed.
798
919
 
799
- ***Deprecated: Legacy subscriptions plan can still change this to scale up or down the instance. New subscriptions plans use the plan to determine number of nodes. In order to change number of nodes the `plan` needs to be updated.***
800
- :param pulumi.Input[str] plan: The subscription plan. See available plans
801
- :param pulumi.Input[str] region: The region to host the instance in. See instance regions
920
+ ***Deprecated:*** Legacy subscriptions plan can still change this to scale up or down the instance.
921
+ New subscriptions plans use the plan to determine number of nodes. In order to
922
+ change number of nodes the `plan` needs to be updated.
923
+ :param pulumi.Input[builtins.str] plan: The subscription plan. See available [plans].
924
+ :param pulumi.Input[builtins.str] region: The region to host the instance in. See available [regions].
802
925
 
803
- ***Note: Changing region will force the instance to be destroyed and a new created in the new region. All data will be lost and a new name assigned.***
804
- :param pulumi.Input[str] rmq_version: The Rabbit MQ version. Can be left out, will then be set to default value used by CloudAMQP API.
926
+ ***Note:*** Changing region will force the instance to be destroyed and a new created in the new
927
+ region. All data will be lost and a new name assigned.
928
+ :param pulumi.Input[builtins.str] rmq_version: The Rabbit MQ version. Can be left out, will then be set to
929
+ default value used by CloudAMQP API.
805
930
 
806
- ***Note: There is not yet any support in the provider to change the RMQ version. Once it's set in the initial creation, it will remain.***
807
- :param pulumi.Input[Sequence[pulumi.Input[str]]] tags: One or more tags for the CloudAMQP instance, makes it possible to categories multiple instances in console view. Default there is no tags assigned.
808
- :param pulumi.Input[int] vpc_id: The VPC ID. Use this to create your instance in an existing VPC. See available example.
809
- :param pulumi.Input[str] vpc_subnet: Creates a dedicated VPC subnet, shouldn't overlap with other VPC subnet, default subnet used 10.56.72.0/24.
931
+ ***Note:*** There is not yet any support in the provider to change the RMQ version. Once it's set
932
+ in the initial creation, it will remain.
933
+ :param pulumi.Input[Sequence[pulumi.Input[builtins.str]]] tags: One or more tags for the CloudAMQP instance, makes it possible to
934
+ categories multiple instances in console view. Default there is no tags assigned.
935
+ :param pulumi.Input[builtins.int] vpc_id: The VPC ID. Use this to create your instance in an existing
936
+ VPC. See available [example].
937
+ :param pulumi.Input[builtins.str] vpc_subnet: Creates a dedicated VPC subnet, shouldn't overlap with other
938
+ VPC subnet, default subnet used 10.56.72.0/24.
810
939
 
811
- ***Deprecated: Will be removed in next major version (v2.0)***
940
+ ***Deprecated:*** Will be removed in next major version (v2.0)
812
941
 
813
- ***Note: extra fee will be charged when using VPC, see [CloudAMQP](https://cloudamqp.com) for more information.***
942
+ ***Note:*** Extra fee will be charged when using VPC, see [CloudAMQP] for more information.
814
943
  """
815
944
  ...
816
945
  @overload
@@ -819,18 +948,21 @@ class Instance(pulumi.CustomResource):
819
948
  args: InstanceArgs,
820
949
  opts: Optional[pulumi.ResourceOptions] = None):
821
950
  """
822
- This resource allows you to create and manage a CloudAMQP instance running either [**RabbitMQ**](https://www.rabbitmq.com/) or [**LavinMQ**](https://lavinmq.com/) and can be deployed to multiple cloud platforms provider and regions, see instance regions for more information.
951
+ This resource allows you to create and manage a CloudAMQP instance running either [**RabbitMQ**] or
952
+ [**LavinMQ**] and can be deployed to multiple cloud platforms provider and regions, see
953
+ [instance regions] for more information.
823
954
 
824
- Once the instance is created it will be assigned a unique identifier. All other resources and data sources created for this instance needs to reference this unique instance identifier.
955
+ Once the instance is created it will be assigned a unique identifier. All other resources and data
956
+ sources created for this instance needs to reference this unique instance identifier.
825
957
 
826
- Pricing is available at [cloudamqp.com](https://www.cloudamqp.com/plans.html).
958
+ Pricing is available at [CloudAMQP plans].
827
959
 
828
960
  ## Example Usage
829
961
 
830
962
  <details>
831
963
  <summary>
832
964
  <b>
833
- <i>Basic example of shared and dedicated instances</i>
965
+ <i>Shared and dedicated instances running LavinMQ</i>
834
966
  </b>
835
967
  </summary>
836
968
 
@@ -838,24 +970,30 @@ class Instance(pulumi.CustomResource):
838
970
  import pulumi
839
971
  import pulumi_cloudamqp as cloudamqp
840
972
 
841
- # Minimum free lemur instance running RabbitMQ
973
+ # Minimum free lemming instance running LavinMQ
842
974
  lemur_instance = cloudamqp.Instance("lemur_instance",
843
- name="cloudamqp-free-instance",
975
+ name="cloudamqp-free-instance-01",
976
+ plan="lemming",
977
+ region="amazon-web-services::us-west-1",
978
+ tags=["lavinmq"])
979
+ # Minimum free lemur instance running RabbitMQ
980
+ lemming_instance = cloudamqp.Instance("lemming_instance",
981
+ name="cloudamqp-free-instance-02",
844
982
  plan="lemur",
845
983
  region="amazon-web-services::us-west-1",
846
984
  tags=["rabbitmq"])
847
- # Minimum free lemming instance running LavinMQ
848
- lemming_instance = cloudamqp.Instance("lemming_instance",
849
- name="cloudamqp-free-instance",
850
- plan="lemming",
985
+ # Dedicated penguin instance running LavinMQ
986
+ penguin_instance = cloudamqp.Instance("penguin_instance",
987
+ name="terraform-cloudamqp-instance-01",
988
+ plan="penguin-1",
851
989
  region="amazon-web-services::us-west-1",
852
990
  tags=["lavinmq"])
853
- # New dedicated bunny instance running RabbitMQ
854
- instance = cloudamqp.Instance("instance",
855
- name="terraform-cloudamqp-instance",
991
+ # Dedicated bunny instance running RabbitMQ
992
+ bunny_instance = cloudamqp.Instance("bunny_instance",
993
+ name="terraform-cloudamqp-instance-02",
856
994
  plan="bunny-1",
857
995
  region="amazon-web-services::us-west-1",
858
- tags=["terraform"])
996
+ tags=["rabbitmq"])
859
997
  ```
860
998
 
861
999
  </details>
@@ -873,7 +1011,7 @@ class Instance(pulumi.CustomResource):
873
1011
 
874
1012
  instance = cloudamqp.Instance("instance",
875
1013
  name="terraform-cloudamqp-instance",
876
- plan="bunny-1",
1014
+ plan="penguin-1",
877
1015
  region="amazon-web-services::us-west-1",
878
1016
  tags=["terraform"],
879
1017
  vpc_subnet="10.56.72.0/24")
@@ -884,7 +1022,10 @@ class Instance(pulumi.CustomResource):
884
1022
  <details>
885
1023
  <summary>
886
1024
  <b>
887
- <i>Dedicated instance using attribute vpc_subnet to create VPC and then import managed VPC, from v1.16.0 (Managed VPC)</i>
1025
+ <i>
1026
+ Dedicated instance using attribute vpc_subnet to create VPC and then import managed VPC,
1027
+ from v1.16.0 (Managed VPC)
1028
+ </i>
888
1029
  </b>
889
1030
  </summary>
890
1031
 
@@ -895,15 +1036,16 @@ class Instance(pulumi.CustomResource):
895
1036
  # Dedicated instance that also creates VPC
896
1037
  instance01 = cloudamqp.Instance("instance_01",
897
1038
  name="terraform-cloudamqp-instance-01",
898
- plan="bunny-1",
1039
+ plan="penguin-1",
899
1040
  region="amazon-web-services::us-west-1",
900
1041
  tags=["terraform"],
901
1042
  vpc_subnet="10.56.72.0/24")
902
1043
  ```
903
1044
 
904
- Once the instance and the VPC are created, the VPC can be imported as managed VPC and added to the configuration file.
905
- Set attribute `vpc_id` to the managed VPC identifier. To keep the managed VPC when deleting the instance, set attribute `keep_associated_vpc` to true.
906
- For more information see guide Managed VPC.
1045
+ Once the instance and the VPC are created, the VPC can be imported as managed VPC and added to the
1046
+ configuration file. Set attribute `vpc_id` to the managed VPC identifier. To keep the managed VPC
1047
+ when deleting the instance, set attribute `keep_associated_vpc` to true. For more information see
1048
+ guide [Managed VPC].
907
1049
 
908
1050
  ```python
909
1051
  import pulumi
@@ -918,7 +1060,7 @@ class Instance(pulumi.CustomResource):
918
1060
  # Add vpc_id and keep_associated_vpc attributes
919
1061
  instance01 = cloudamqp.Instance("instance_01",
920
1062
  name="terraform-cloudamqp-instance-01",
921
- plan="bunny-1",
1063
+ plan="penguin-1",
922
1064
  region="amazon-web-services::us-west-1",
923
1065
  tags=["terraform"],
924
1066
  vpc_id=vpc.id,
@@ -947,7 +1089,7 @@ class Instance(pulumi.CustomResource):
947
1089
  # First instance added to managed VPC
948
1090
  instance01 = cloudamqp.Instance("instance_01",
949
1091
  name="terraform-cloudamqp-instance-01",
950
- plan="bunny-1",
1092
+ plan="penguin-1",
951
1093
  region="amazon-web-services::us-west-1",
952
1094
  tags=["terraform"],
953
1095
  vpc_id=vpc.id,
@@ -955,7 +1097,7 @@ class Instance(pulumi.CustomResource):
955
1097
  # Second instance added to managed VPC
956
1098
  instance02 = cloudamqp.Instance("instance_02",
957
1099
  name="terraform-cloudamqp-instance-02",
958
- plan="bunny-1",
1100
+ plan="penguin-1",
959
1101
  region="amazon-web-services::us-west-1",
960
1102
  tags=["terraform"],
961
1103
  vpc_id=vpc.id,
@@ -966,13 +1108,43 @@ class Instance(pulumi.CustomResource):
966
1108
 
967
1109
  </details>
968
1110
 
969
- ## Copy settings to a new dedicated instance
1111
+ ### Settings supported by LavinMQ
970
1112
 
971
- With copy settings it's possible to create a new dedicated instance with settings such as alarms, config, etc. from another dedicated instance. This can be done by adding the `copy_settings` block to this resource and populate `subscription_id` with a CloudAMQP instance identifier from another already existing instance.
1113
+ ***Allowed values:*** alarms, definitions, firewall, metrics
972
1114
 
973
- Then add the settings to be copied over to the new dedicated instance. Settings that can be copied [alarms, config, definitions, firewall, logs, metrics, plugins]
1115
+ <details>
1116
+ <summary>
1117
+ <b>
1118
+ <i>Copy settings from a dedicated instance to a new dedicated instance</i>
1119
+ </b>
1120
+ </summary>
974
1121
 
975
- > `rmq_version` argument is required when doing this action. Must match the RabbitMQ version of the dedicated instance to be copied from.
1122
+ ```python
1123
+ import pulumi
1124
+ import pulumi_cloudamqp as cloudamqp
1125
+
1126
+ penguin_instance = cloudamqp.Instance("penguin_instance",
1127
+ name="terraform-cloudamqp-instance-01",
1128
+ plan="penguin-1",
1129
+ region="amazon-web-services::us-west-1",
1130
+ rmq_version="2.2.0",
1131
+ tags=["terraform"],
1132
+ copy_settings=[{
1133
+ "subscription_id": instance_id,
1134
+ "settings": [
1135
+ "alarms",
1136
+ "definitions",
1137
+ "firewall",
1138
+ "metrics",
1139
+ ],
1140
+ }])
1141
+ ```
1142
+
1143
+ </details>
1144
+
1145
+ ### Settings supported by RabbitMQ
1146
+
1147
+ ***Allowed values:*** alarms, config, definitions, firewall, logs, metrics, plugins
976
1148
 
977
1149
  <details>
978
1150
  <summary>
@@ -985,9 +1157,9 @@ class Instance(pulumi.CustomResource):
985
1157
  import pulumi
986
1158
  import pulumi_cloudamqp as cloudamqp
987
1159
 
988
- instance02 = cloudamqp.Instance("instance_02",
1160
+ bunny_instance = cloudamqp.Instance("bunny_instance",
989
1161
  name="terraform-cloudamqp-instance-02",
990
- plan="squirrel-1",
1162
+ plan="bunny-1",
991
1163
  region="amazon-web-services::us-west-1",
992
1164
  rmq_version="3.12.2",
993
1165
  tags=["terraform"],
@@ -1007,16 +1179,42 @@ class Instance(pulumi.CustomResource):
1007
1179
 
1008
1180
  </details>
1009
1181
 
1182
+ [CloudAMQP]: https://cloudamqp.com
1183
+ [CloudAMQP API]: https://docs.cloudamqp.com/cloudamqp_api.html
1184
+ [CloudAMQP API list instances]: https://docs.cloudamqp.com/#list-instances
1185
+ [CloudAMQP plans]: https://www.cloudamqp.com/plans.html
1186
+ [copy settings]: #copy-settings-to-a-new-dedicated-instance
1187
+ [example]: ../guides/info_vpc_existing.md
1188
+ [regions]: ../guides/info_region.md
1189
+ [**LavinMQ**]: https://lavinmq.com
1190
+ [Managed VPC]: ../guides/info_managed_vpc#dedicated-instance-and-vpc_subnet
1191
+ [plans]: ../guides/info_plan.md
1192
+ [**RabbitMQ**]: https://www.rabbitmq.com
1193
+
1010
1194
  ## Import
1011
1195
 
1012
- `cloudamqp_instance`can be imported using CloudAMQP internal identifier.
1196
+ `cloudamqp_instance`can be imported using resource identifier. To retrieve the resource identifier,
1197
+
1198
+ use [CloudAMQP API list instances]
1199
+
1200
+ From Terraform v1.5.0, the `import` block can be used to import this resource:
1201
+
1202
+ hcl
1203
+
1204
+ import {
1205
+
1206
+ to = cloudamqp_instance.instance
1207
+
1208
+ id = <id>
1209
+
1210
+ }
1211
+
1212
+ Or use Terraform CLI:
1013
1213
 
1014
1214
  ```sh
1015
1215
  $ pulumi import cloudamqp:index/instance:Instance instance <id>`
1016
1216
  ```
1017
1217
 
1018
- To retrieve the identifier for an instance, either use [CloudAMQP customer API](https://docs.cloudamqp.com/#list-instances) or use the data source [`cloudamqp_account`](./data-sources/account.md) to list all available instances for an account.
1019
-
1020
1218
  :param str resource_name: The name of the resource.
1021
1219
  :param InstanceArgs args: The arguments to use to populate this resource's properties.
1022
1220
  :param pulumi.ResourceOptions opts: Options for the resource.
@@ -1033,16 +1231,16 @@ class Instance(pulumi.CustomResource):
1033
1231
  resource_name: str,
1034
1232
  opts: Optional[pulumi.ResourceOptions] = None,
1035
1233
  copy_settings: Optional[pulumi.Input[Sequence[pulumi.Input[Union['InstanceCopySettingArgs', 'InstanceCopySettingArgsDict']]]]] = None,
1036
- keep_associated_vpc: Optional[pulumi.Input[bool]] = None,
1037
- name: Optional[pulumi.Input[str]] = None,
1038
- no_default_alarms: Optional[pulumi.Input[bool]] = None,
1039
- nodes: Optional[pulumi.Input[int]] = None,
1040
- plan: Optional[pulumi.Input[str]] = None,
1041
- region: Optional[pulumi.Input[str]] = None,
1042
- rmq_version: Optional[pulumi.Input[str]] = None,
1043
- tags: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
1044
- vpc_id: Optional[pulumi.Input[int]] = None,
1045
- vpc_subnet: Optional[pulumi.Input[str]] = None,
1234
+ keep_associated_vpc: Optional[pulumi.Input[builtins.bool]] = None,
1235
+ name: Optional[pulumi.Input[builtins.str]] = None,
1236
+ no_default_alarms: Optional[pulumi.Input[builtins.bool]] = None,
1237
+ nodes: Optional[pulumi.Input[builtins.int]] = None,
1238
+ plan: Optional[pulumi.Input[builtins.str]] = None,
1239
+ region: Optional[pulumi.Input[builtins.str]] = None,
1240
+ rmq_version: Optional[pulumi.Input[builtins.str]] = None,
1241
+ tags: Optional[pulumi.Input[Sequence[pulumi.Input[builtins.str]]]] = None,
1242
+ vpc_id: Optional[pulumi.Input[builtins.int]] = None,
1243
+ vpc_subnet: Optional[pulumi.Input[builtins.str]] = None,
1046
1244
  __props__=None):
1047
1245
  opts = pulumi.ResourceOptions.merge(_utilities.get_resource_opts_defaults(), opts)
1048
1246
  if not isinstance(opts, pulumi.ResourceOptions):
@@ -1087,25 +1285,25 @@ class Instance(pulumi.CustomResource):
1087
1285
  def get(resource_name: str,
1088
1286
  id: pulumi.Input[str],
1089
1287
  opts: Optional[pulumi.ResourceOptions] = None,
1090
- apikey: Optional[pulumi.Input[str]] = None,
1091
- backend: Optional[pulumi.Input[str]] = None,
1288
+ apikey: Optional[pulumi.Input[builtins.str]] = None,
1289
+ backend: Optional[pulumi.Input[builtins.str]] = None,
1092
1290
  copy_settings: Optional[pulumi.Input[Sequence[pulumi.Input[Union['InstanceCopySettingArgs', 'InstanceCopySettingArgsDict']]]]] = None,
1093
- dedicated: Optional[pulumi.Input[bool]] = None,
1094
- host: Optional[pulumi.Input[str]] = None,
1095
- host_internal: Optional[pulumi.Input[str]] = None,
1096
- keep_associated_vpc: Optional[pulumi.Input[bool]] = None,
1097
- name: Optional[pulumi.Input[str]] = None,
1098
- no_default_alarms: Optional[pulumi.Input[bool]] = None,
1099
- nodes: Optional[pulumi.Input[int]] = None,
1100
- plan: Optional[pulumi.Input[str]] = None,
1101
- ready: Optional[pulumi.Input[bool]] = None,
1102
- region: Optional[pulumi.Input[str]] = None,
1103
- rmq_version: Optional[pulumi.Input[str]] = None,
1104
- tags: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
1105
- url: Optional[pulumi.Input[str]] = None,
1106
- vhost: Optional[pulumi.Input[str]] = None,
1107
- vpc_id: Optional[pulumi.Input[int]] = None,
1108
- vpc_subnet: Optional[pulumi.Input[str]] = None) -> 'Instance':
1291
+ dedicated: Optional[pulumi.Input[builtins.bool]] = None,
1292
+ host: Optional[pulumi.Input[builtins.str]] = None,
1293
+ host_internal: Optional[pulumi.Input[builtins.str]] = None,
1294
+ keep_associated_vpc: Optional[pulumi.Input[builtins.bool]] = None,
1295
+ name: Optional[pulumi.Input[builtins.str]] = None,
1296
+ no_default_alarms: Optional[pulumi.Input[builtins.bool]] = None,
1297
+ nodes: Optional[pulumi.Input[builtins.int]] = None,
1298
+ plan: Optional[pulumi.Input[builtins.str]] = None,
1299
+ ready: Optional[pulumi.Input[builtins.bool]] = None,
1300
+ region: Optional[pulumi.Input[builtins.str]] = None,
1301
+ rmq_version: Optional[pulumi.Input[builtins.str]] = None,
1302
+ tags: Optional[pulumi.Input[Sequence[pulumi.Input[builtins.str]]]] = None,
1303
+ url: Optional[pulumi.Input[builtins.str]] = None,
1304
+ vhost: Optional[pulumi.Input[builtins.str]] = None,
1305
+ vpc_id: Optional[pulumi.Input[builtins.int]] = None,
1306
+ vpc_subnet: Optional[pulumi.Input[builtins.str]] = None) -> 'Instance':
1109
1307
  """
1110
1308
  Get an existing Instance resource's state with the given name, id, and optional extra
1111
1309
  properties used to qualify the lookup.
@@ -1113,39 +1311,52 @@ class Instance(pulumi.CustomResource):
1113
1311
  :param str resource_name: The unique name of the resulting resource.
1114
1312
  :param pulumi.Input[str] id: The unique provider ID of the resource to lookup.
1115
1313
  :param pulumi.ResourceOptions opts: Options for the resource.
1116
- :param pulumi.Input[str] apikey: API key needed to communicate to CloudAMQP's second API. The second API is used to manage alarms, integration and more, full description [CloudAMQP API](https://docs.cloudamqp.com/cloudamqp_api.html).
1117
- :param pulumi.Input[str] backend: Information if the CloudAMQP instance runs either RabbitMQ or LavinMQ.
1118
- :param pulumi.Input[Sequence[pulumi.Input[Union['InstanceCopySettingArgs', 'InstanceCopySettingArgsDict']]]] copy_settings: Copy settings from one CloudAMQP instance to a new. Consists of the block documented below.
1314
+ :param pulumi.Input[builtins.str] apikey: API key needed to communicate to CloudAMQP's second API. The second API is used
1315
+ to manage alarms, integration and more, full description [CloudAMQP API].
1316
+ :param pulumi.Input[builtins.str] backend: Information if the CloudAMQP instance runs either RabbitMQ or LavinMQ.
1317
+ :param pulumi.Input[Sequence[pulumi.Input[Union['InstanceCopySettingArgs', 'InstanceCopySettingArgsDict']]]] copy_settings: Copy settings from one CloudAMQP instance to a new. Consists of
1318
+ the block documented below.
1119
1319
 
1120
1320
  ___
1121
1321
 
1122
1322
  The `copy_settings` block consists of:
1123
- :param pulumi.Input[bool] dedicated: Information if the CloudAMQP instance is shared or dedicated.
1124
- :param pulumi.Input[str] host: The external hostname for the CloudAMQP instance.
1125
- :param pulumi.Input[str] host_internal: The internal hostname for the CloudAMQP instance.
1126
- :param pulumi.Input[bool] keep_associated_vpc: Keep associated VPC when deleting instance, default set to false.
1127
- :param pulumi.Input[str] name: Name of the CloudAMQP instance.
1128
- :param pulumi.Input[bool] no_default_alarms: Set to true to discard creating default alarms when the instance is created. Can be left out, will then use default value = false.
1129
- :param pulumi.Input[int] nodes: Number of nodes, 1, 3 or 5 depending on plan used. Only needed for legacy plans, will otherwise be computed.
1323
+ :param pulumi.Input[builtins.bool] dedicated: Information if the CloudAMQP instance is shared or dedicated.
1324
+ :param pulumi.Input[builtins.str] host: The external hostname for the CloudAMQP instance.
1325
+ :param pulumi.Input[builtins.str] host_internal: The internal hostname for the CloudAMQP instance.
1326
+ :param pulumi.Input[builtins.bool] keep_associated_vpc: Keep associated VPC when deleting instance. Default set to
1327
+ false.
1328
+ :param pulumi.Input[builtins.str] name: Name of the CloudAMQP instance.
1329
+ :param pulumi.Input[builtins.bool] no_default_alarms: Set to true to not create default alarms
1330
+ :param pulumi.Input[builtins.int] nodes: Number of nodes, 1, 3 or 5 depending on plan used. Only needed for
1331
+ legacy plans, will otherwise be computed.
1130
1332
 
1131
- ***Deprecated: Legacy subscriptions plan can still change this to scale up or down the instance. New subscriptions plans use the plan to determine number of nodes. In order to change number of nodes the `plan` needs to be updated.***
1132
- :param pulumi.Input[str] plan: The subscription plan. See available plans
1133
- :param pulumi.Input[bool] ready: Flag describing if the resource is ready
1134
- :param pulumi.Input[str] region: The region to host the instance in. See instance regions
1333
+ ***Deprecated:*** Legacy subscriptions plan can still change this to scale up or down the instance.
1334
+ New subscriptions plans use the plan to determine number of nodes. In order to
1335
+ change number of nodes the `plan` needs to be updated.
1336
+ :param pulumi.Input[builtins.str] plan: The subscription plan. See available [plans].
1337
+ :param pulumi.Input[builtins.bool] ready: Flag describing if the resource is ready
1338
+ :param pulumi.Input[builtins.str] region: The region to host the instance in. See available [regions].
1135
1339
 
1136
- ***Note: Changing region will force the instance to be destroyed and a new created in the new region. All data will be lost and a new name assigned.***
1137
- :param pulumi.Input[str] rmq_version: The Rabbit MQ version. Can be left out, will then be set to default value used by CloudAMQP API.
1340
+ ***Note:*** Changing region will force the instance to be destroyed and a new created in the new
1341
+ region. All data will be lost and a new name assigned.
1342
+ :param pulumi.Input[builtins.str] rmq_version: The Rabbit MQ version. Can be left out, will then be set to
1343
+ default value used by CloudAMQP API.
1138
1344
 
1139
- ***Note: There is not yet any support in the provider to change the RMQ version. Once it's set in the initial creation, it will remain.***
1140
- :param pulumi.Input[Sequence[pulumi.Input[str]]] tags: One or more tags for the CloudAMQP instance, makes it possible to categories multiple instances in console view. Default there is no tags assigned.
1141
- :param pulumi.Input[str] url: The AMQP URL (uses the internal hostname if the instance was created with VPC). Has the format: `amqps://{username}:{password}@{hostname}/{vhost}`
1142
- :param pulumi.Input[str] vhost: The virtual host used by Rabbit MQ.
1143
- :param pulumi.Input[int] vpc_id: The VPC ID. Use this to create your instance in an existing VPC. See available example.
1144
- :param pulumi.Input[str] vpc_subnet: Creates a dedicated VPC subnet, shouldn't overlap with other VPC subnet, default subnet used 10.56.72.0/24.
1345
+ ***Note:*** There is not yet any support in the provider to change the RMQ version. Once it's set
1346
+ in the initial creation, it will remain.
1347
+ :param pulumi.Input[Sequence[pulumi.Input[builtins.str]]] tags: One or more tags for the CloudAMQP instance, makes it possible to
1348
+ categories multiple instances in console view. Default there is no tags assigned.
1349
+ :param pulumi.Input[builtins.str] url: The AMQP URL (uses the internal hostname if the instance was created with VPC).
1350
+ Has the format: `amqps://{username}:{password}@{hostname}/{vhost}`
1351
+ :param pulumi.Input[builtins.str] vhost: The virtual host used by Rabbit MQ.
1352
+ :param pulumi.Input[builtins.int] vpc_id: The VPC ID. Use this to create your instance in an existing
1353
+ VPC. See available [example].
1354
+ :param pulumi.Input[builtins.str] vpc_subnet: Creates a dedicated VPC subnet, shouldn't overlap with other
1355
+ VPC subnet, default subnet used 10.56.72.0/24.
1145
1356
 
1146
- ***Deprecated: Will be removed in next major version (v2.0)***
1357
+ ***Deprecated:*** Will be removed in next major version (v2.0)
1147
1358
 
1148
- ***Note: extra fee will be charged when using VPC, see [CloudAMQP](https://cloudamqp.com) for more information.***
1359
+ ***Note:*** Extra fee will be charged when using VPC, see [CloudAMQP] for more information.
1149
1360
  """
1150
1361
  opts = pulumi.ResourceOptions.merge(opts, pulumi.ResourceOptions(id=id))
1151
1362
 
@@ -1174,15 +1385,16 @@ class Instance(pulumi.CustomResource):
1174
1385
 
1175
1386
  @property
1176
1387
  @pulumi.getter
1177
- def apikey(self) -> pulumi.Output[str]:
1388
+ def apikey(self) -> pulumi.Output[builtins.str]:
1178
1389
  """
1179
- API key needed to communicate to CloudAMQP's second API. The second API is used to manage alarms, integration and more, full description [CloudAMQP API](https://docs.cloudamqp.com/cloudamqp_api.html).
1390
+ API key needed to communicate to CloudAMQP's second API. The second API is used
1391
+ to manage alarms, integration and more, full description [CloudAMQP API].
1180
1392
  """
1181
1393
  return pulumi.get(self, "apikey")
1182
1394
 
1183
1395
  @property
1184
1396
  @pulumi.getter
1185
- def backend(self) -> pulumi.Output[str]:
1397
+ def backend(self) -> pulumi.Output[builtins.str]:
1186
1398
  """
1187
1399
  Information if the CloudAMQP instance runs either RabbitMQ or LavinMQ.
1188
1400
  """
@@ -1192,7 +1404,8 @@ class Instance(pulumi.CustomResource):
1192
1404
  @pulumi.getter(name="copySettings")
1193
1405
  def copy_settings(self) -> pulumi.Output[Optional[Sequence['outputs.InstanceCopySetting']]]:
1194
1406
  """
1195
- Copy settings from one CloudAMQP instance to a new. Consists of the block documented below.
1407
+ Copy settings from one CloudAMQP instance to a new. Consists of
1408
+ the block documented below.
1196
1409
 
1197
1410
  ___
1198
1411
 
@@ -1202,7 +1415,7 @@ class Instance(pulumi.CustomResource):
1202
1415
 
1203
1416
  @property
1204
1417
  @pulumi.getter
1205
- def dedicated(self) -> pulumi.Output[bool]:
1418
+ def dedicated(self) -> pulumi.Output[builtins.bool]:
1206
1419
  """
1207
1420
  Information if the CloudAMQP instance is shared or dedicated.
1208
1421
  """
@@ -1210,7 +1423,7 @@ class Instance(pulumi.CustomResource):
1210
1423
 
1211
1424
  @property
1212
1425
  @pulumi.getter
1213
- def host(self) -> pulumi.Output[str]:
1426
+ def host(self) -> pulumi.Output[builtins.str]:
1214
1427
  """
1215
1428
  The external hostname for the CloudAMQP instance.
1216
1429
  """
@@ -1218,7 +1431,7 @@ class Instance(pulumi.CustomResource):
1218
1431
 
1219
1432
  @property
1220
1433
  @pulumi.getter(name="hostInternal")
1221
- def host_internal(self) -> pulumi.Output[str]:
1434
+ def host_internal(self) -> pulumi.Output[builtins.str]:
1222
1435
  """
1223
1436
  The internal hostname for the CloudAMQP instance.
1224
1437
  """
@@ -1226,15 +1439,16 @@ class Instance(pulumi.CustomResource):
1226
1439
 
1227
1440
  @property
1228
1441
  @pulumi.getter(name="keepAssociatedVpc")
1229
- def keep_associated_vpc(self) -> pulumi.Output[Optional[bool]]:
1442
+ def keep_associated_vpc(self) -> pulumi.Output[Optional[builtins.bool]]:
1230
1443
  """
1231
- Keep associated VPC when deleting instance, default set to false.
1444
+ Keep associated VPC when deleting instance. Default set to
1445
+ false.
1232
1446
  """
1233
1447
  return pulumi.get(self, "keep_associated_vpc")
1234
1448
 
1235
1449
  @property
1236
1450
  @pulumi.getter
1237
- def name(self) -> pulumi.Output[str]:
1451
+ def name(self) -> pulumi.Output[builtins.str]:
1238
1452
  """
1239
1453
  Name of the CloudAMQP instance.
1240
1454
  """
@@ -1242,33 +1456,36 @@ class Instance(pulumi.CustomResource):
1242
1456
 
1243
1457
  @property
1244
1458
  @pulumi.getter(name="noDefaultAlarms")
1245
- def no_default_alarms(self) -> pulumi.Output[bool]:
1459
+ def no_default_alarms(self) -> pulumi.Output[builtins.bool]:
1246
1460
  """
1247
- Set to true to discard creating default alarms when the instance is created. Can be left out, will then use default value = false.
1461
+ Set to true to not create default alarms
1248
1462
  """
1249
1463
  return pulumi.get(self, "no_default_alarms")
1250
1464
 
1251
1465
  @property
1252
1466
  @pulumi.getter
1253
- def nodes(self) -> pulumi.Output[int]:
1467
+ def nodes(self) -> pulumi.Output[builtins.int]:
1254
1468
  """
1255
- Number of nodes, 1, 3 or 5 depending on plan used. Only needed for legacy plans, will otherwise be computed.
1469
+ Number of nodes, 1, 3 or 5 depending on plan used. Only needed for
1470
+ legacy plans, will otherwise be computed.
1256
1471
 
1257
- ***Deprecated: Legacy subscriptions plan can still change this to scale up or down the instance. New subscriptions plans use the plan to determine number of nodes. In order to change number of nodes the `plan` needs to be updated.***
1472
+ ***Deprecated:*** Legacy subscriptions plan can still change this to scale up or down the instance.
1473
+ New subscriptions plans use the plan to determine number of nodes. In order to
1474
+ change number of nodes the `plan` needs to be updated.
1258
1475
  """
1259
1476
  return pulumi.get(self, "nodes")
1260
1477
 
1261
1478
  @property
1262
1479
  @pulumi.getter
1263
- def plan(self) -> pulumi.Output[str]:
1480
+ def plan(self) -> pulumi.Output[builtins.str]:
1264
1481
  """
1265
- The subscription plan. See available plans
1482
+ The subscription plan. See available [plans].
1266
1483
  """
1267
1484
  return pulumi.get(self, "plan")
1268
1485
 
1269
1486
  @property
1270
1487
  @pulumi.getter
1271
- def ready(self) -> pulumi.Output[bool]:
1488
+ def ready(self) -> pulumi.Output[builtins.bool]:
1272
1489
  """
1273
1490
  Flag describing if the resource is ready
1274
1491
  """
@@ -1276,43 +1493,48 @@ class Instance(pulumi.CustomResource):
1276
1493
 
1277
1494
  @property
1278
1495
  @pulumi.getter
1279
- def region(self) -> pulumi.Output[str]:
1496
+ def region(self) -> pulumi.Output[builtins.str]:
1280
1497
  """
1281
- The region to host the instance in. See instance regions
1498
+ The region to host the instance in. See available [regions].
1282
1499
 
1283
- ***Note: Changing region will force the instance to be destroyed and a new created in the new region. All data will be lost and a new name assigned.***
1500
+ ***Note:*** Changing region will force the instance to be destroyed and a new created in the new
1501
+ region. All data will be lost and a new name assigned.
1284
1502
  """
1285
1503
  return pulumi.get(self, "region")
1286
1504
 
1287
1505
  @property
1288
1506
  @pulumi.getter(name="rmqVersion")
1289
- def rmq_version(self) -> pulumi.Output[str]:
1507
+ def rmq_version(self) -> pulumi.Output[builtins.str]:
1290
1508
  """
1291
- The Rabbit MQ version. Can be left out, will then be set to default value used by CloudAMQP API.
1509
+ The Rabbit MQ version. Can be left out, will then be set to
1510
+ default value used by CloudAMQP API.
1292
1511
 
1293
- ***Note: There is not yet any support in the provider to change the RMQ version. Once it's set in the initial creation, it will remain.***
1512
+ ***Note:*** There is not yet any support in the provider to change the RMQ version. Once it's set
1513
+ in the initial creation, it will remain.
1294
1514
  """
1295
1515
  return pulumi.get(self, "rmq_version")
1296
1516
 
1297
1517
  @property
1298
1518
  @pulumi.getter
1299
- def tags(self) -> pulumi.Output[Optional[Sequence[str]]]:
1519
+ def tags(self) -> pulumi.Output[Optional[Sequence[builtins.str]]]:
1300
1520
  """
1301
- One or more tags for the CloudAMQP instance, makes it possible to categories multiple instances in console view. Default there is no tags assigned.
1521
+ One or more tags for the CloudAMQP instance, makes it possible to
1522
+ categories multiple instances in console view. Default there is no tags assigned.
1302
1523
  """
1303
1524
  return pulumi.get(self, "tags")
1304
1525
 
1305
1526
  @property
1306
1527
  @pulumi.getter
1307
- def url(self) -> pulumi.Output[str]:
1528
+ def url(self) -> pulumi.Output[builtins.str]:
1308
1529
  """
1309
- The AMQP URL (uses the internal hostname if the instance was created with VPC). Has the format: `amqps://{username}:{password}@{hostname}/{vhost}`
1530
+ The AMQP URL (uses the internal hostname if the instance was created with VPC).
1531
+ Has the format: `amqps://{username}:{password}@{hostname}/{vhost}`
1310
1532
  """
1311
1533
  return pulumi.get(self, "url")
1312
1534
 
1313
1535
  @property
1314
1536
  @pulumi.getter
1315
- def vhost(self) -> pulumi.Output[str]:
1537
+ def vhost(self) -> pulumi.Output[builtins.str]:
1316
1538
  """
1317
1539
  The virtual host used by Rabbit MQ.
1318
1540
  """
@@ -1320,21 +1542,23 @@ class Instance(pulumi.CustomResource):
1320
1542
 
1321
1543
  @property
1322
1544
  @pulumi.getter(name="vpcId")
1323
- def vpc_id(self) -> pulumi.Output[int]:
1545
+ def vpc_id(self) -> pulumi.Output[builtins.int]:
1324
1546
  """
1325
- The VPC ID. Use this to create your instance in an existing VPC. See available example.
1547
+ The VPC ID. Use this to create your instance in an existing
1548
+ VPC. See available [example].
1326
1549
  """
1327
1550
  return pulumi.get(self, "vpc_id")
1328
1551
 
1329
1552
  @property
1330
1553
  @pulumi.getter(name="vpcSubnet")
1331
- def vpc_subnet(self) -> pulumi.Output[str]:
1554
+ def vpc_subnet(self) -> pulumi.Output[builtins.str]:
1332
1555
  """
1333
- Creates a dedicated VPC subnet, shouldn't overlap with other VPC subnet, default subnet used 10.56.72.0/24.
1556
+ Creates a dedicated VPC subnet, shouldn't overlap with other
1557
+ VPC subnet, default subnet used 10.56.72.0/24.
1334
1558
 
1335
- ***Deprecated: Will be removed in next major version (v2.0)***
1559
+ ***Deprecated:*** Will be removed in next major version (v2.0)
1336
1560
 
1337
- ***Note: extra fee will be charged when using VPC, see [CloudAMQP](https://cloudamqp.com) for more information.***
1561
+ ***Note:*** Extra fee will be charged when using VPC, see [CloudAMQP] for more information.
1338
1562
  """
1339
1563
  return pulumi.get(self, "vpc_subnet")
1340
1564