pulumi-cloudamqp 3.21.0a1743571485__py3-none-any.whl → 3.22.0__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 (51) hide show
  1. pulumi_cloudamqp/__init__.py +12 -0
  2. pulumi_cloudamqp/_inputs.py +92 -72
  3. pulumi_cloudamqp/account_action.py +42 -31
  4. pulumi_cloudamqp/alarm.py +232 -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 +84 -38
  9. pulumi_cloudamqp/extra_disk_size.py +175 -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_alarms.py +165 -0
  14. pulumi_cloudamqp/get_credentials.py +19 -26
  15. pulumi_cloudamqp/get_instance.py +75 -25
  16. pulumi_cloudamqp/get_nodes.py +10 -56
  17. pulumi_cloudamqp/get_notification.py +39 -41
  18. pulumi_cloudamqp/get_notifications.py +135 -0
  19. pulumi_cloudamqp/get_plugins.py +28 -54
  20. pulumi_cloudamqp/get_plugins_community.py +29 -52
  21. pulumi_cloudamqp/get_upgradable_versions.py +19 -24
  22. pulumi_cloudamqp/get_vpc_gcp_info.py +44 -138
  23. pulumi_cloudamqp/get_vpc_info.py +34 -127
  24. pulumi_cloudamqp/instance.py +560 -333
  25. pulumi_cloudamqp/integration_aws_eventbridge.py +185 -117
  26. pulumi_cloudamqp/integration_log.py +491 -402
  27. pulumi_cloudamqp/integration_metric.py +348 -296
  28. pulumi_cloudamqp/maintenance_window.py +519 -0
  29. pulumi_cloudamqp/node_actions.py +85 -59
  30. pulumi_cloudamqp/notification.py +177 -92
  31. pulumi_cloudamqp/outputs.py +419 -125
  32. pulumi_cloudamqp/plugin.py +173 -105
  33. pulumi_cloudamqp/plugin_community.py +171 -107
  34. pulumi_cloudamqp/privatelink_aws.py +143 -347
  35. pulumi_cloudamqp/privatelink_azure.py +145 -345
  36. pulumi_cloudamqp/provider.py +25 -21
  37. pulumi_cloudamqp/pulumi-plugin.json +1 -1
  38. pulumi_cloudamqp/rabbit_configuration.py +337 -210
  39. pulumi_cloudamqp/security_firewall.py +114 -57
  40. pulumi_cloudamqp/upgrade_lavinmq.py +32 -102
  41. pulumi_cloudamqp/upgrade_rabbitmq.py +56 -299
  42. pulumi_cloudamqp/vpc.py +115 -79
  43. pulumi_cloudamqp/vpc_connect.py +222 -606
  44. pulumi_cloudamqp/vpc_gcp_peering.py +230 -591
  45. pulumi_cloudamqp/vpc_peering.py +123 -105
  46. pulumi_cloudamqp/webhook.py +146 -103
  47. {pulumi_cloudamqp-3.21.0a1743571485.dist-info → pulumi_cloudamqp-3.22.0.dist-info}/METADATA +1 -1
  48. pulumi_cloudamqp-3.22.0.dist-info/RECORD +52 -0
  49. {pulumi_cloudamqp-3.21.0a1743571485.dist-info → pulumi_cloudamqp-3.22.0.dist-info}/WHEEL +1 -1
  50. pulumi_cloudamqp-3.21.0a1743571485.dist-info/RECORD +0 -49
  51. {pulumi_cloudamqp-3.21.0a1743571485.dist-info → pulumi_cloudamqp-3.22.0.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,237 +405,254 @@ 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
 
571
620
  class Instance(pulumi.CustomResource):
621
+
622
+ pulumi_type = "cloudamqp:index/instance:Instance"
623
+
572
624
  @overload
573
625
  def __init__(__self__,
574
626
  resource_name: str,
575
627
  opts: Optional[pulumi.ResourceOptions] = None,
576
628
  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,
629
+ keep_associated_vpc: Optional[pulumi.Input[builtins.bool]] = None,
630
+ name: Optional[pulumi.Input[builtins.str]] = None,
631
+ no_default_alarms: Optional[pulumi.Input[builtins.bool]] = None,
632
+ nodes: Optional[pulumi.Input[builtins.int]] = None,
633
+ plan: Optional[pulumi.Input[builtins.str]] = None,
634
+ region: Optional[pulumi.Input[builtins.str]] = None,
635
+ rmq_version: Optional[pulumi.Input[builtins.str]] = None,
636
+ tags: Optional[pulumi.Input[Sequence[pulumi.Input[builtins.str]]]] = None,
637
+ vpc_id: Optional[pulumi.Input[builtins.int]] = None,
638
+ vpc_subnet: Optional[pulumi.Input[builtins.str]] = None,
587
639
  __props__=None):
588
640
  """
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.
641
+ This resource allows you to create and manage a CloudAMQP instance running either [**RabbitMQ**] or
642
+ [**LavinMQ**] and can be deployed to multiple cloud platforms provider and regions, see
643
+ [instance regions] for more information.
590
644
 
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.
645
+ Once the instance is created it will be assigned a unique identifier. All other resources and data
646
+ sources created for this instance needs to reference this unique instance identifier.
592
647
 
593
- Pricing is available at [cloudamqp.com](https://www.cloudamqp.com/plans.html).
648
+ Pricing is available at [CloudAMQP plans].
594
649
 
595
650
  ## Example Usage
596
651
 
597
652
  <details>
598
653
  <summary>
599
654
  <b>
600
- <i>Basic example of shared and dedicated instances</i>
655
+ <i>Shared and dedicated instances running LavinMQ</i>
601
656
  </b>
602
657
  </summary>
603
658
 
@@ -605,24 +660,30 @@ class Instance(pulumi.CustomResource):
605
660
  import pulumi
606
661
  import pulumi_cloudamqp as cloudamqp
607
662
 
608
- # Minimum free lemur instance running RabbitMQ
663
+ # Minimum free lemming instance running LavinMQ
609
664
  lemur_instance = cloudamqp.Instance("lemur_instance",
610
- name="cloudamqp-free-instance",
665
+ name="cloudamqp-free-instance-01",
666
+ plan="lemming",
667
+ region="amazon-web-services::us-west-1",
668
+ tags=["lavinmq"])
669
+ # Minimum free lemur instance running RabbitMQ
670
+ lemming_instance = cloudamqp.Instance("lemming_instance",
671
+ name="cloudamqp-free-instance-02",
611
672
  plan="lemur",
612
673
  region="amazon-web-services::us-west-1",
613
674
  tags=["rabbitmq"])
614
- # Minimum free lemming instance running LavinMQ
615
- lemming_instance = cloudamqp.Instance("lemming_instance",
616
- name="cloudamqp-free-instance",
617
- plan="lemming",
675
+ # Dedicated penguin instance running LavinMQ
676
+ penguin_instance = cloudamqp.Instance("penguin_instance",
677
+ name="terraform-cloudamqp-instance-01",
678
+ plan="penguin-1",
618
679
  region="amazon-web-services::us-west-1",
619
680
  tags=["lavinmq"])
620
- # New dedicated bunny instance running RabbitMQ
621
- instance = cloudamqp.Instance("instance",
622
- name="terraform-cloudamqp-instance",
681
+ # Dedicated bunny instance running RabbitMQ
682
+ bunny_instance = cloudamqp.Instance("bunny_instance",
683
+ name="terraform-cloudamqp-instance-02",
623
684
  plan="bunny-1",
624
685
  region="amazon-web-services::us-west-1",
625
- tags=["terraform"])
686
+ tags=["rabbitmq"])
626
687
  ```
627
688
 
628
689
  </details>
@@ -640,7 +701,7 @@ class Instance(pulumi.CustomResource):
640
701
 
641
702
  instance = cloudamqp.Instance("instance",
642
703
  name="terraform-cloudamqp-instance",
643
- plan="bunny-1",
704
+ plan="penguin-1",
644
705
  region="amazon-web-services::us-west-1",
645
706
  tags=["terraform"],
646
707
  vpc_subnet="10.56.72.0/24")
@@ -651,7 +712,10 @@ class Instance(pulumi.CustomResource):
651
712
  <details>
652
713
  <summary>
653
714
  <b>
654
- <i>Dedicated instance using attribute vpc_subnet to create VPC and then import managed VPC, from v1.16.0 (Managed VPC)</i>
715
+ <i>
716
+ Dedicated instance using attribute vpc_subnet to create VPC and then import managed VPC,
717
+ from v1.16.0 (Managed VPC)
718
+ </i>
655
719
  </b>
656
720
  </summary>
657
721
 
@@ -662,15 +726,16 @@ class Instance(pulumi.CustomResource):
662
726
  # Dedicated instance that also creates VPC
663
727
  instance01 = cloudamqp.Instance("instance_01",
664
728
  name="terraform-cloudamqp-instance-01",
665
- plan="bunny-1",
729
+ plan="penguin-1",
666
730
  region="amazon-web-services::us-west-1",
667
731
  tags=["terraform"],
668
732
  vpc_subnet="10.56.72.0/24")
669
733
  ```
670
734
 
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.
735
+ Once the instance and the VPC are created, the VPC can be imported as managed VPC and added to the
736
+ configuration file. Set attribute `vpc_id` to the managed VPC identifier. To keep the managed VPC
737
+ when deleting the instance, set attribute `keep_associated_vpc` to true. For more information see
738
+ guide [Managed VPC].
674
739
 
675
740
  ```python
676
741
  import pulumi
@@ -685,7 +750,7 @@ class Instance(pulumi.CustomResource):
685
750
  # Add vpc_id and keep_associated_vpc attributes
686
751
  instance01 = cloudamqp.Instance("instance_01",
687
752
  name="terraform-cloudamqp-instance-01",
688
- plan="bunny-1",
753
+ plan="penguin-1",
689
754
  region="amazon-web-services::us-west-1",
690
755
  tags=["terraform"],
691
756
  vpc_id=vpc.id,
@@ -714,7 +779,7 @@ class Instance(pulumi.CustomResource):
714
779
  # First instance added to managed VPC
715
780
  instance01 = cloudamqp.Instance("instance_01",
716
781
  name="terraform-cloudamqp-instance-01",
717
- plan="bunny-1",
782
+ plan="penguin-1",
718
783
  region="amazon-web-services::us-west-1",
719
784
  tags=["terraform"],
720
785
  vpc_id=vpc.id,
@@ -722,7 +787,7 @@ class Instance(pulumi.CustomResource):
722
787
  # Second instance added to managed VPC
723
788
  instance02 = cloudamqp.Instance("instance_02",
724
789
  name="terraform-cloudamqp-instance-02",
725
- plan="bunny-1",
790
+ plan="penguin-1",
726
791
  region="amazon-web-services::us-west-1",
727
792
  tags=["terraform"],
728
793
  vpc_id=vpc.id,
@@ -733,13 +798,43 @@ class Instance(pulumi.CustomResource):
733
798
 
734
799
  </details>
735
800
 
736
- ## Copy settings to a new dedicated instance
801
+ ### Settings supported by LavinMQ
802
+
803
+ ***Allowed values:*** alarms, definitions, firewall, metrics
804
+
805
+ <details>
806
+ <summary>
807
+ <b>
808
+ <i>Copy settings from a dedicated instance to a new dedicated instance</i>
809
+ </b>
810
+ </summary>
811
+
812
+ ```python
813
+ import pulumi
814
+ import pulumi_cloudamqp as cloudamqp
815
+
816
+ penguin_instance = cloudamqp.Instance("penguin_instance",
817
+ name="terraform-cloudamqp-instance-01",
818
+ plan="penguin-1",
819
+ region="amazon-web-services::us-west-1",
820
+ rmq_version="2.2.0",
821
+ tags=["terraform"],
822
+ copy_settings=[{
823
+ "subscription_id": instance_id,
824
+ "settings": [
825
+ "alarms",
826
+ "definitions",
827
+ "firewall",
828
+ "metrics",
829
+ ],
830
+ }])
831
+ ```
737
832
 
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.
833
+ </details>
739
834
 
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]
835
+ ### Settings supported by RabbitMQ
741
836
 
742
- > `rmq_version` argument is required when doing this action. Must match the RabbitMQ version of the dedicated instance to be copied from.
837
+ ***Allowed values:*** alarms, config, definitions, firewall, logs, metrics, plugins
743
838
 
744
839
  <details>
745
840
  <summary>
@@ -752,9 +847,9 @@ class Instance(pulumi.CustomResource):
752
847
  import pulumi
753
848
  import pulumi_cloudamqp as cloudamqp
754
849
 
755
- instance02 = cloudamqp.Instance("instance_02",
850
+ bunny_instance = cloudamqp.Instance("bunny_instance",
756
851
  name="terraform-cloudamqp-instance-02",
757
- plan="squirrel-1",
852
+ plan="bunny-1",
758
853
  region="amazon-web-services::us-west-1",
759
854
  rmq_version="3.12.2",
760
855
  tags=["terraform"],
@@ -774,43 +869,80 @@ class Instance(pulumi.CustomResource):
774
869
 
775
870
  </details>
776
871
 
872
+ [CloudAMQP]: https://cloudamqp.com
873
+ [CloudAMQP API]: https://docs.cloudamqp.com/cloudamqp_api.html
874
+ [CloudAMQP API list instances]: https://docs.cloudamqp.com/#list-instances
875
+ [CloudAMQP plans]: https://www.cloudamqp.com/plans.html
876
+ [copy settings]: #copy-settings-to-a-new-dedicated-instance
877
+ [example]: ../guides/info_vpc_existing.md
878
+ [regions]: ../guides/info_region.md
879
+ [**LavinMQ**]: https://lavinmq.com
880
+ [Managed VPC]: ../guides/info_managed_vpc#dedicated-instance-and-vpc_subnet
881
+ [plans]: ../guides/info_plan.md
882
+ [**RabbitMQ**]: https://www.rabbitmq.com
883
+
777
884
  ## Import
778
885
 
779
- `cloudamqp_instance`can be imported using CloudAMQP internal identifier.
886
+ `cloudamqp_instance`can be imported using resource identifier. To retrieve the resource identifier,
887
+
888
+ use [CloudAMQP API list instances]
889
+
890
+ From Terraform v1.5.0, the `import` block can be used to import this resource:
891
+
892
+ hcl
893
+
894
+ import {
895
+
896
+ to = cloudamqp_instance.instance
897
+
898
+ id = <id>
899
+
900
+ }
901
+
902
+ Or use Terraform CLI:
780
903
 
781
904
  ```sh
782
905
  $ pulumi import cloudamqp:index/instance:Instance instance <id>`
783
906
  ```
784
907
 
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
908
  :param str resource_name: The name of the resource.
788
909
  :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.
910
+ :param pulumi.Input[Sequence[pulumi.Input[Union['InstanceCopySettingArgs', 'InstanceCopySettingArgsDict']]]] copy_settings: Copy settings from one CloudAMQP instance to a new. Consists of
911
+ the block documented below.
790
912
 
791
913
  ___
792
914
 
793
915
  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.
916
+ :param pulumi.Input[builtins.bool] keep_associated_vpc: Keep associated VPC when deleting instance. Default set to
917
+ false.
918
+ :param pulumi.Input[builtins.str] name: Name of the CloudAMQP instance.
919
+ :param pulumi.Input[builtins.bool] no_default_alarms: Set to true to not create default alarms
920
+ :param pulumi.Input[builtins.int] nodes: Number of nodes, 1, 3 or 5 depending on plan used. Only needed for
921
+ legacy plans, will otherwise be computed.
798
922
 
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
923
+ ***Deprecated:*** Legacy subscriptions plan can still change this to scale up or down the instance.
924
+ New subscriptions plans use the plan to determine number of nodes. In order to
925
+ change number of nodes the `plan` needs to be updated.
926
+ :param pulumi.Input[builtins.str] plan: The subscription plan. See available [plans].
927
+ :param pulumi.Input[builtins.str] region: The region to host the instance in. See available [regions].
802
928
 
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.
929
+ ***Note:*** Changing region will force the instance to be destroyed and a new created in the new
930
+ region. All data will be lost and a new name assigned.
931
+ :param pulumi.Input[builtins.str] rmq_version: The Rabbit MQ version. Can be left out, will then be set to
932
+ default value used by CloudAMQP API.
805
933
 
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.
934
+ ***Note:*** There is not yet any support in the provider to change the RMQ version. Once it's set
935
+ in the initial creation, it will remain.
936
+ :param pulumi.Input[Sequence[pulumi.Input[builtins.str]]] tags: One or more tags for the CloudAMQP instance, makes it possible to
937
+ categories multiple instances in console view. Default there is no tags assigned.
938
+ :param pulumi.Input[builtins.int] vpc_id: The VPC ID. Use this to create your instance in an existing
939
+ VPC. See available [example].
940
+ :param pulumi.Input[builtins.str] vpc_subnet: Creates a dedicated VPC subnet, shouldn't overlap with other
941
+ VPC subnet, default subnet used 10.56.72.0/24.
810
942
 
811
- ***Deprecated: Will be removed in next major version (v2.0)***
943
+ ***Deprecated:*** Will be removed in next major version (v2.0)
812
944
 
813
- ***Note: extra fee will be charged when using VPC, see [CloudAMQP](https://cloudamqp.com) for more information.***
945
+ ***Note:*** Extra fee will be charged when using VPC, see [CloudAMQP] for more information.
814
946
  """
815
947
  ...
816
948
  @overload
@@ -819,18 +951,21 @@ class Instance(pulumi.CustomResource):
819
951
  args: InstanceArgs,
820
952
  opts: Optional[pulumi.ResourceOptions] = None):
821
953
  """
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.
954
+ This resource allows you to create and manage a CloudAMQP instance running either [**RabbitMQ**] or
955
+ [**LavinMQ**] and can be deployed to multiple cloud platforms provider and regions, see
956
+ [instance regions] for more information.
823
957
 
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.
958
+ Once the instance is created it will be assigned a unique identifier. All other resources and data
959
+ sources created for this instance needs to reference this unique instance identifier.
825
960
 
826
- Pricing is available at [cloudamqp.com](https://www.cloudamqp.com/plans.html).
961
+ Pricing is available at [CloudAMQP plans].
827
962
 
828
963
  ## Example Usage
829
964
 
830
965
  <details>
831
966
  <summary>
832
967
  <b>
833
- <i>Basic example of shared and dedicated instances</i>
968
+ <i>Shared and dedicated instances running LavinMQ</i>
834
969
  </b>
835
970
  </summary>
836
971
 
@@ -838,24 +973,30 @@ class Instance(pulumi.CustomResource):
838
973
  import pulumi
839
974
  import pulumi_cloudamqp as cloudamqp
840
975
 
841
- # Minimum free lemur instance running RabbitMQ
976
+ # Minimum free lemming instance running LavinMQ
842
977
  lemur_instance = cloudamqp.Instance("lemur_instance",
843
- name="cloudamqp-free-instance",
978
+ name="cloudamqp-free-instance-01",
979
+ plan="lemming",
980
+ region="amazon-web-services::us-west-1",
981
+ tags=["lavinmq"])
982
+ # Minimum free lemur instance running RabbitMQ
983
+ lemming_instance = cloudamqp.Instance("lemming_instance",
984
+ name="cloudamqp-free-instance-02",
844
985
  plan="lemur",
845
986
  region="amazon-web-services::us-west-1",
846
987
  tags=["rabbitmq"])
847
- # Minimum free lemming instance running LavinMQ
848
- lemming_instance = cloudamqp.Instance("lemming_instance",
849
- name="cloudamqp-free-instance",
850
- plan="lemming",
988
+ # Dedicated penguin instance running LavinMQ
989
+ penguin_instance = cloudamqp.Instance("penguin_instance",
990
+ name="terraform-cloudamqp-instance-01",
991
+ plan="penguin-1",
851
992
  region="amazon-web-services::us-west-1",
852
993
  tags=["lavinmq"])
853
- # New dedicated bunny instance running RabbitMQ
854
- instance = cloudamqp.Instance("instance",
855
- name="terraform-cloudamqp-instance",
994
+ # Dedicated bunny instance running RabbitMQ
995
+ bunny_instance = cloudamqp.Instance("bunny_instance",
996
+ name="terraform-cloudamqp-instance-02",
856
997
  plan="bunny-1",
857
998
  region="amazon-web-services::us-west-1",
858
- tags=["terraform"])
999
+ tags=["rabbitmq"])
859
1000
  ```
860
1001
 
861
1002
  </details>
@@ -873,7 +1014,7 @@ class Instance(pulumi.CustomResource):
873
1014
 
874
1015
  instance = cloudamqp.Instance("instance",
875
1016
  name="terraform-cloudamqp-instance",
876
- plan="bunny-1",
1017
+ plan="penguin-1",
877
1018
  region="amazon-web-services::us-west-1",
878
1019
  tags=["terraform"],
879
1020
  vpc_subnet="10.56.72.0/24")
@@ -884,7 +1025,10 @@ class Instance(pulumi.CustomResource):
884
1025
  <details>
885
1026
  <summary>
886
1027
  <b>
887
- <i>Dedicated instance using attribute vpc_subnet to create VPC and then import managed VPC, from v1.16.0 (Managed VPC)</i>
1028
+ <i>
1029
+ Dedicated instance using attribute vpc_subnet to create VPC and then import managed VPC,
1030
+ from v1.16.0 (Managed VPC)
1031
+ </i>
888
1032
  </b>
889
1033
  </summary>
890
1034
 
@@ -895,15 +1039,16 @@ class Instance(pulumi.CustomResource):
895
1039
  # Dedicated instance that also creates VPC
896
1040
  instance01 = cloudamqp.Instance("instance_01",
897
1041
  name="terraform-cloudamqp-instance-01",
898
- plan="bunny-1",
1042
+ plan="penguin-1",
899
1043
  region="amazon-web-services::us-west-1",
900
1044
  tags=["terraform"],
901
1045
  vpc_subnet="10.56.72.0/24")
902
1046
  ```
903
1047
 
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.
1048
+ Once the instance and the VPC are created, the VPC can be imported as managed VPC and added to the
1049
+ configuration file. Set attribute `vpc_id` to the managed VPC identifier. To keep the managed VPC
1050
+ when deleting the instance, set attribute `keep_associated_vpc` to true. For more information see
1051
+ guide [Managed VPC].
907
1052
 
908
1053
  ```python
909
1054
  import pulumi
@@ -918,7 +1063,7 @@ class Instance(pulumi.CustomResource):
918
1063
  # Add vpc_id and keep_associated_vpc attributes
919
1064
  instance01 = cloudamqp.Instance("instance_01",
920
1065
  name="terraform-cloudamqp-instance-01",
921
- plan="bunny-1",
1066
+ plan="penguin-1",
922
1067
  region="amazon-web-services::us-west-1",
923
1068
  tags=["terraform"],
924
1069
  vpc_id=vpc.id,
@@ -947,7 +1092,7 @@ class Instance(pulumi.CustomResource):
947
1092
  # First instance added to managed VPC
948
1093
  instance01 = cloudamqp.Instance("instance_01",
949
1094
  name="terraform-cloudamqp-instance-01",
950
- plan="bunny-1",
1095
+ plan="penguin-1",
951
1096
  region="amazon-web-services::us-west-1",
952
1097
  tags=["terraform"],
953
1098
  vpc_id=vpc.id,
@@ -955,7 +1100,7 @@ class Instance(pulumi.CustomResource):
955
1100
  # Second instance added to managed VPC
956
1101
  instance02 = cloudamqp.Instance("instance_02",
957
1102
  name="terraform-cloudamqp-instance-02",
958
- plan="bunny-1",
1103
+ plan="penguin-1",
959
1104
  region="amazon-web-services::us-west-1",
960
1105
  tags=["terraform"],
961
1106
  vpc_id=vpc.id,
@@ -966,13 +1111,43 @@ class Instance(pulumi.CustomResource):
966
1111
 
967
1112
  </details>
968
1113
 
969
- ## Copy settings to a new dedicated instance
1114
+ ### Settings supported by LavinMQ
1115
+
1116
+ ***Allowed values:*** alarms, definitions, firewall, metrics
1117
+
1118
+ <details>
1119
+ <summary>
1120
+ <b>
1121
+ <i>Copy settings from a dedicated instance to a new dedicated instance</i>
1122
+ </b>
1123
+ </summary>
1124
+
1125
+ ```python
1126
+ import pulumi
1127
+ import pulumi_cloudamqp as cloudamqp
1128
+
1129
+ penguin_instance = cloudamqp.Instance("penguin_instance",
1130
+ name="terraform-cloudamqp-instance-01",
1131
+ plan="penguin-1",
1132
+ region="amazon-web-services::us-west-1",
1133
+ rmq_version="2.2.0",
1134
+ tags=["terraform"],
1135
+ copy_settings=[{
1136
+ "subscription_id": instance_id,
1137
+ "settings": [
1138
+ "alarms",
1139
+ "definitions",
1140
+ "firewall",
1141
+ "metrics",
1142
+ ],
1143
+ }])
1144
+ ```
970
1145
 
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.
1146
+ </details>
972
1147
 
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]
1148
+ ### Settings supported by RabbitMQ
974
1149
 
975
- > `rmq_version` argument is required when doing this action. Must match the RabbitMQ version of the dedicated instance to be copied from.
1150
+ ***Allowed values:*** alarms, config, definitions, firewall, logs, metrics, plugins
976
1151
 
977
1152
  <details>
978
1153
  <summary>
@@ -985,9 +1160,9 @@ class Instance(pulumi.CustomResource):
985
1160
  import pulumi
986
1161
  import pulumi_cloudamqp as cloudamqp
987
1162
 
988
- instance02 = cloudamqp.Instance("instance_02",
1163
+ bunny_instance = cloudamqp.Instance("bunny_instance",
989
1164
  name="terraform-cloudamqp-instance-02",
990
- plan="squirrel-1",
1165
+ plan="bunny-1",
991
1166
  region="amazon-web-services::us-west-1",
992
1167
  rmq_version="3.12.2",
993
1168
  tags=["terraform"],
@@ -1007,16 +1182,42 @@ class Instance(pulumi.CustomResource):
1007
1182
 
1008
1183
  </details>
1009
1184
 
1185
+ [CloudAMQP]: https://cloudamqp.com
1186
+ [CloudAMQP API]: https://docs.cloudamqp.com/cloudamqp_api.html
1187
+ [CloudAMQP API list instances]: https://docs.cloudamqp.com/#list-instances
1188
+ [CloudAMQP plans]: https://www.cloudamqp.com/plans.html
1189
+ [copy settings]: #copy-settings-to-a-new-dedicated-instance
1190
+ [example]: ../guides/info_vpc_existing.md
1191
+ [regions]: ../guides/info_region.md
1192
+ [**LavinMQ**]: https://lavinmq.com
1193
+ [Managed VPC]: ../guides/info_managed_vpc#dedicated-instance-and-vpc_subnet
1194
+ [plans]: ../guides/info_plan.md
1195
+ [**RabbitMQ**]: https://www.rabbitmq.com
1196
+
1010
1197
  ## Import
1011
1198
 
1012
- `cloudamqp_instance`can be imported using CloudAMQP internal identifier.
1199
+ `cloudamqp_instance`can be imported using resource identifier. To retrieve the resource identifier,
1200
+
1201
+ use [CloudAMQP API list instances]
1202
+
1203
+ From Terraform v1.5.0, the `import` block can be used to import this resource:
1204
+
1205
+ hcl
1206
+
1207
+ import {
1208
+
1209
+ to = cloudamqp_instance.instance
1210
+
1211
+ id = <id>
1212
+
1213
+ }
1214
+
1215
+ Or use Terraform CLI:
1013
1216
 
1014
1217
  ```sh
1015
1218
  $ pulumi import cloudamqp:index/instance:Instance instance <id>`
1016
1219
  ```
1017
1220
 
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
1221
  :param str resource_name: The name of the resource.
1021
1222
  :param InstanceArgs args: The arguments to use to populate this resource's properties.
1022
1223
  :param pulumi.ResourceOptions opts: Options for the resource.
@@ -1033,16 +1234,16 @@ class Instance(pulumi.CustomResource):
1033
1234
  resource_name: str,
1034
1235
  opts: Optional[pulumi.ResourceOptions] = None,
1035
1236
  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,
1237
+ keep_associated_vpc: Optional[pulumi.Input[builtins.bool]] = None,
1238
+ name: Optional[pulumi.Input[builtins.str]] = None,
1239
+ no_default_alarms: Optional[pulumi.Input[builtins.bool]] = None,
1240
+ nodes: Optional[pulumi.Input[builtins.int]] = None,
1241
+ plan: Optional[pulumi.Input[builtins.str]] = None,
1242
+ region: Optional[pulumi.Input[builtins.str]] = None,
1243
+ rmq_version: Optional[pulumi.Input[builtins.str]] = None,
1244
+ tags: Optional[pulumi.Input[Sequence[pulumi.Input[builtins.str]]]] = None,
1245
+ vpc_id: Optional[pulumi.Input[builtins.int]] = None,
1246
+ vpc_subnet: Optional[pulumi.Input[builtins.str]] = None,
1046
1247
  __props__=None):
1047
1248
  opts = pulumi.ResourceOptions.merge(_utilities.get_resource_opts_defaults(), opts)
1048
1249
  if not isinstance(opts, pulumi.ResourceOptions):
@@ -1087,25 +1288,25 @@ class Instance(pulumi.CustomResource):
1087
1288
  def get(resource_name: str,
1088
1289
  id: pulumi.Input[str],
1089
1290
  opts: Optional[pulumi.ResourceOptions] = None,
1090
- apikey: Optional[pulumi.Input[str]] = None,
1091
- backend: Optional[pulumi.Input[str]] = None,
1291
+ apikey: Optional[pulumi.Input[builtins.str]] = None,
1292
+ backend: Optional[pulumi.Input[builtins.str]] = None,
1092
1293
  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':
1294
+ dedicated: Optional[pulumi.Input[builtins.bool]] = None,
1295
+ host: Optional[pulumi.Input[builtins.str]] = None,
1296
+ host_internal: Optional[pulumi.Input[builtins.str]] = None,
1297
+ keep_associated_vpc: Optional[pulumi.Input[builtins.bool]] = None,
1298
+ name: Optional[pulumi.Input[builtins.str]] = None,
1299
+ no_default_alarms: Optional[pulumi.Input[builtins.bool]] = None,
1300
+ nodes: Optional[pulumi.Input[builtins.int]] = None,
1301
+ plan: Optional[pulumi.Input[builtins.str]] = None,
1302
+ ready: Optional[pulumi.Input[builtins.bool]] = None,
1303
+ region: Optional[pulumi.Input[builtins.str]] = None,
1304
+ rmq_version: Optional[pulumi.Input[builtins.str]] = None,
1305
+ tags: Optional[pulumi.Input[Sequence[pulumi.Input[builtins.str]]]] = None,
1306
+ url: Optional[pulumi.Input[builtins.str]] = None,
1307
+ vhost: Optional[pulumi.Input[builtins.str]] = None,
1308
+ vpc_id: Optional[pulumi.Input[builtins.int]] = None,
1309
+ vpc_subnet: Optional[pulumi.Input[builtins.str]] = None) -> 'Instance':
1109
1310
  """
1110
1311
  Get an existing Instance resource's state with the given name, id, and optional extra
1111
1312
  properties used to qualify the lookup.
@@ -1113,39 +1314,52 @@ class Instance(pulumi.CustomResource):
1113
1314
  :param str resource_name: The unique name of the resulting resource.
1114
1315
  :param pulumi.Input[str] id: The unique provider ID of the resource to lookup.
1115
1316
  :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.
1317
+ :param pulumi.Input[builtins.str] apikey: API key needed to communicate to CloudAMQP's second API. The second API is used
1318
+ to manage alarms, integration and more, full description [CloudAMQP API].
1319
+ :param pulumi.Input[builtins.str] backend: Information if the CloudAMQP instance runs either RabbitMQ or LavinMQ.
1320
+ :param pulumi.Input[Sequence[pulumi.Input[Union['InstanceCopySettingArgs', 'InstanceCopySettingArgsDict']]]] copy_settings: Copy settings from one CloudAMQP instance to a new. Consists of
1321
+ the block documented below.
1119
1322
 
1120
1323
  ___
1121
1324
 
1122
1325
  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.
1326
+ :param pulumi.Input[builtins.bool] dedicated: Information if the CloudAMQP instance is shared or dedicated.
1327
+ :param pulumi.Input[builtins.str] host: The external hostname for the CloudAMQP instance.
1328
+ :param pulumi.Input[builtins.str] host_internal: The internal hostname for the CloudAMQP instance.
1329
+ :param pulumi.Input[builtins.bool] keep_associated_vpc: Keep associated VPC when deleting instance. Default set to
1330
+ false.
1331
+ :param pulumi.Input[builtins.str] name: Name of the CloudAMQP instance.
1332
+ :param pulumi.Input[builtins.bool] no_default_alarms: Set to true to not create default alarms
1333
+ :param pulumi.Input[builtins.int] nodes: Number of nodes, 1, 3 or 5 depending on plan used. Only needed for
1334
+ legacy plans, will otherwise be computed.
1130
1335
 
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
1336
+ ***Deprecated:*** Legacy subscriptions plan can still change this to scale up or down the instance.
1337
+ New subscriptions plans use the plan to determine number of nodes. In order to
1338
+ change number of nodes the `plan` needs to be updated.
1339
+ :param pulumi.Input[builtins.str] plan: The subscription plan. See available [plans].
1340
+ :param pulumi.Input[builtins.bool] ready: Flag describing if the resource is ready
1341
+ :param pulumi.Input[builtins.str] region: The region to host the instance in. See available [regions].
1135
1342
 
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.
1343
+ ***Note:*** Changing region will force the instance to be destroyed and a new created in the new
1344
+ region. All data will be lost and a new name assigned.
1345
+ :param pulumi.Input[builtins.str] rmq_version: The Rabbit MQ version. Can be left out, will then be set to
1346
+ default value used by CloudAMQP API.
1138
1347
 
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.
1348
+ ***Note:*** There is not yet any support in the provider to change the RMQ version. Once it's set
1349
+ in the initial creation, it will remain.
1350
+ :param pulumi.Input[Sequence[pulumi.Input[builtins.str]]] tags: One or more tags for the CloudAMQP instance, makes it possible to
1351
+ categories multiple instances in console view. Default there is no tags assigned.
1352
+ :param pulumi.Input[builtins.str] url: The AMQP URL (uses the internal hostname if the instance was created with VPC).
1353
+ Has the format: `amqps://{username}:{password}@{hostname}/{vhost}`
1354
+ :param pulumi.Input[builtins.str] vhost: The virtual host used by Rabbit MQ.
1355
+ :param pulumi.Input[builtins.int] vpc_id: The VPC ID. Use this to create your instance in an existing
1356
+ VPC. See available [example].
1357
+ :param pulumi.Input[builtins.str] vpc_subnet: Creates a dedicated VPC subnet, shouldn't overlap with other
1358
+ VPC subnet, default subnet used 10.56.72.0/24.
1145
1359
 
1146
- ***Deprecated: Will be removed in next major version (v2.0)***
1360
+ ***Deprecated:*** Will be removed in next major version (v2.0)
1147
1361
 
1148
- ***Note: extra fee will be charged when using VPC, see [CloudAMQP](https://cloudamqp.com) for more information.***
1362
+ ***Note:*** Extra fee will be charged when using VPC, see [CloudAMQP] for more information.
1149
1363
  """
1150
1364
  opts = pulumi.ResourceOptions.merge(opts, pulumi.ResourceOptions(id=id))
1151
1365
 
@@ -1174,15 +1388,16 @@ class Instance(pulumi.CustomResource):
1174
1388
 
1175
1389
  @property
1176
1390
  @pulumi.getter
1177
- def apikey(self) -> pulumi.Output[str]:
1391
+ def apikey(self) -> pulumi.Output[builtins.str]:
1178
1392
  """
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).
1393
+ API key needed to communicate to CloudAMQP's second API. The second API is used
1394
+ to manage alarms, integration and more, full description [CloudAMQP API].
1180
1395
  """
1181
1396
  return pulumi.get(self, "apikey")
1182
1397
 
1183
1398
  @property
1184
1399
  @pulumi.getter
1185
- def backend(self) -> pulumi.Output[str]:
1400
+ def backend(self) -> pulumi.Output[builtins.str]:
1186
1401
  """
1187
1402
  Information if the CloudAMQP instance runs either RabbitMQ or LavinMQ.
1188
1403
  """
@@ -1192,7 +1407,8 @@ class Instance(pulumi.CustomResource):
1192
1407
  @pulumi.getter(name="copySettings")
1193
1408
  def copy_settings(self) -> pulumi.Output[Optional[Sequence['outputs.InstanceCopySetting']]]:
1194
1409
  """
1195
- Copy settings from one CloudAMQP instance to a new. Consists of the block documented below.
1410
+ Copy settings from one CloudAMQP instance to a new. Consists of
1411
+ the block documented below.
1196
1412
 
1197
1413
  ___
1198
1414
 
@@ -1202,7 +1418,7 @@ class Instance(pulumi.CustomResource):
1202
1418
 
1203
1419
  @property
1204
1420
  @pulumi.getter
1205
- def dedicated(self) -> pulumi.Output[bool]:
1421
+ def dedicated(self) -> pulumi.Output[builtins.bool]:
1206
1422
  """
1207
1423
  Information if the CloudAMQP instance is shared or dedicated.
1208
1424
  """
@@ -1210,7 +1426,7 @@ class Instance(pulumi.CustomResource):
1210
1426
 
1211
1427
  @property
1212
1428
  @pulumi.getter
1213
- def host(self) -> pulumi.Output[str]:
1429
+ def host(self) -> pulumi.Output[builtins.str]:
1214
1430
  """
1215
1431
  The external hostname for the CloudAMQP instance.
1216
1432
  """
@@ -1218,7 +1434,7 @@ class Instance(pulumi.CustomResource):
1218
1434
 
1219
1435
  @property
1220
1436
  @pulumi.getter(name="hostInternal")
1221
- def host_internal(self) -> pulumi.Output[str]:
1437
+ def host_internal(self) -> pulumi.Output[builtins.str]:
1222
1438
  """
1223
1439
  The internal hostname for the CloudAMQP instance.
1224
1440
  """
@@ -1226,15 +1442,16 @@ class Instance(pulumi.CustomResource):
1226
1442
 
1227
1443
  @property
1228
1444
  @pulumi.getter(name="keepAssociatedVpc")
1229
- def keep_associated_vpc(self) -> pulumi.Output[Optional[bool]]:
1445
+ def keep_associated_vpc(self) -> pulumi.Output[Optional[builtins.bool]]:
1230
1446
  """
1231
- Keep associated VPC when deleting instance, default set to false.
1447
+ Keep associated VPC when deleting instance. Default set to
1448
+ false.
1232
1449
  """
1233
1450
  return pulumi.get(self, "keep_associated_vpc")
1234
1451
 
1235
1452
  @property
1236
1453
  @pulumi.getter
1237
- def name(self) -> pulumi.Output[str]:
1454
+ def name(self) -> pulumi.Output[builtins.str]:
1238
1455
  """
1239
1456
  Name of the CloudAMQP instance.
1240
1457
  """
@@ -1242,33 +1459,36 @@ class Instance(pulumi.CustomResource):
1242
1459
 
1243
1460
  @property
1244
1461
  @pulumi.getter(name="noDefaultAlarms")
1245
- def no_default_alarms(self) -> pulumi.Output[bool]:
1462
+ def no_default_alarms(self) -> pulumi.Output[builtins.bool]:
1246
1463
  """
1247
- Set to true to discard creating default alarms when the instance is created. Can be left out, will then use default value = false.
1464
+ Set to true to not create default alarms
1248
1465
  """
1249
1466
  return pulumi.get(self, "no_default_alarms")
1250
1467
 
1251
1468
  @property
1252
1469
  @pulumi.getter
1253
- def nodes(self) -> pulumi.Output[int]:
1470
+ def nodes(self) -> pulumi.Output[builtins.int]:
1254
1471
  """
1255
- Number of nodes, 1, 3 or 5 depending on plan used. Only needed for legacy plans, will otherwise be computed.
1472
+ Number of nodes, 1, 3 or 5 depending on plan used. Only needed for
1473
+ legacy plans, will otherwise be computed.
1256
1474
 
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.***
1475
+ ***Deprecated:*** Legacy subscriptions plan can still change this to scale up or down the instance.
1476
+ New subscriptions plans use the plan to determine number of nodes. In order to
1477
+ change number of nodes the `plan` needs to be updated.
1258
1478
  """
1259
1479
  return pulumi.get(self, "nodes")
1260
1480
 
1261
1481
  @property
1262
1482
  @pulumi.getter
1263
- def plan(self) -> pulumi.Output[str]:
1483
+ def plan(self) -> pulumi.Output[builtins.str]:
1264
1484
  """
1265
- The subscription plan. See available plans
1485
+ The subscription plan. See available [plans].
1266
1486
  """
1267
1487
  return pulumi.get(self, "plan")
1268
1488
 
1269
1489
  @property
1270
1490
  @pulumi.getter
1271
- def ready(self) -> pulumi.Output[bool]:
1491
+ def ready(self) -> pulumi.Output[builtins.bool]:
1272
1492
  """
1273
1493
  Flag describing if the resource is ready
1274
1494
  """
@@ -1276,43 +1496,48 @@ class Instance(pulumi.CustomResource):
1276
1496
 
1277
1497
  @property
1278
1498
  @pulumi.getter
1279
- def region(self) -> pulumi.Output[str]:
1499
+ def region(self) -> pulumi.Output[builtins.str]:
1280
1500
  """
1281
- The region to host the instance in. See instance regions
1501
+ The region to host the instance in. See available [regions].
1282
1502
 
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.***
1503
+ ***Note:*** Changing region will force the instance to be destroyed and a new created in the new
1504
+ region. All data will be lost and a new name assigned.
1284
1505
  """
1285
1506
  return pulumi.get(self, "region")
1286
1507
 
1287
1508
  @property
1288
1509
  @pulumi.getter(name="rmqVersion")
1289
- def rmq_version(self) -> pulumi.Output[str]:
1510
+ def rmq_version(self) -> pulumi.Output[builtins.str]:
1290
1511
  """
1291
- The Rabbit MQ version. Can be left out, will then be set to default value used by CloudAMQP API.
1512
+ The Rabbit MQ version. Can be left out, will then be set to
1513
+ default value used by CloudAMQP API.
1292
1514
 
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.***
1515
+ ***Note:*** There is not yet any support in the provider to change the RMQ version. Once it's set
1516
+ in the initial creation, it will remain.
1294
1517
  """
1295
1518
  return pulumi.get(self, "rmq_version")
1296
1519
 
1297
1520
  @property
1298
1521
  @pulumi.getter
1299
- def tags(self) -> pulumi.Output[Optional[Sequence[str]]]:
1522
+ def tags(self) -> pulumi.Output[Optional[Sequence[builtins.str]]]:
1300
1523
  """
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.
1524
+ One or more tags for the CloudAMQP instance, makes it possible to
1525
+ categories multiple instances in console view. Default there is no tags assigned.
1302
1526
  """
1303
1527
  return pulumi.get(self, "tags")
1304
1528
 
1305
1529
  @property
1306
1530
  @pulumi.getter
1307
- def url(self) -> pulumi.Output[str]:
1531
+ def url(self) -> pulumi.Output[builtins.str]:
1308
1532
  """
1309
- The AMQP URL (uses the internal hostname if the instance was created with VPC). Has the format: `amqps://{username}:{password}@{hostname}/{vhost}`
1533
+ The AMQP URL (uses the internal hostname if the instance was created with VPC).
1534
+ Has the format: `amqps://{username}:{password}@{hostname}/{vhost}`
1310
1535
  """
1311
1536
  return pulumi.get(self, "url")
1312
1537
 
1313
1538
  @property
1314
1539
  @pulumi.getter
1315
- def vhost(self) -> pulumi.Output[str]:
1540
+ def vhost(self) -> pulumi.Output[builtins.str]:
1316
1541
  """
1317
1542
  The virtual host used by Rabbit MQ.
1318
1543
  """
@@ -1320,21 +1545,23 @@ class Instance(pulumi.CustomResource):
1320
1545
 
1321
1546
  @property
1322
1547
  @pulumi.getter(name="vpcId")
1323
- def vpc_id(self) -> pulumi.Output[int]:
1548
+ def vpc_id(self) -> pulumi.Output[builtins.int]:
1324
1549
  """
1325
- The VPC ID. Use this to create your instance in an existing VPC. See available example.
1550
+ The VPC ID. Use this to create your instance in an existing
1551
+ VPC. See available [example].
1326
1552
  """
1327
1553
  return pulumi.get(self, "vpc_id")
1328
1554
 
1329
1555
  @property
1330
1556
  @pulumi.getter(name="vpcSubnet")
1331
- def vpc_subnet(self) -> pulumi.Output[str]:
1557
+ def vpc_subnet(self) -> pulumi.Output[builtins.str]:
1332
1558
  """
1333
- Creates a dedicated VPC subnet, shouldn't overlap with other VPC subnet, default subnet used 10.56.72.0/24.
1559
+ Creates a dedicated VPC subnet, shouldn't overlap with other
1560
+ VPC subnet, default subnet used 10.56.72.0/24.
1334
1561
 
1335
- ***Deprecated: Will be removed in next major version (v2.0)***
1562
+ ***Deprecated:*** Will be removed in next major version (v2.0)
1336
1563
 
1337
- ***Note: extra fee will be charged when using VPC, see [CloudAMQP](https://cloudamqp.com) for more information.***
1564
+ ***Note:*** Extra fee will be charged when using VPC, see [CloudAMQP] for more information.
1338
1565
  """
1339
1566
  return pulumi.get(self, "vpc_subnet")
1340
1567