@pulumi/cloudamqp 3.26.1 → 3.27.0-alpha.1770934853

package/upgradeRabbitmq.d.ts

@@ -1,5 +1,157 @@
 import * as pulumi from "@pulumi/pulumi";
 /**
+ * This resource allows you to upgrade RabbitMQ version. Depending on initial versions of RabbitMQ and
+ * Erlang of the CloudAMQP instance, multiple runs may be needed to get to the latest or wanted version.
+ * Reason for this is certain supported RabbitMQ version will also automatically upgrade Erlang version.
+ *
+ * There is three different ways to trigger the version upgrade
+ *
+ * > * Specify RabbitMQ version to upgrade to
+ * > * Upgrade to latest RabbitMQ version
+ * > * Old behaviour to upgrade to latest RabbitMQ version
+ *
+ * See example below for usage.
+ *
+ * Only available for dedicated subscription plans running ***RabbitMQ***.
+ *
+ * ## Example Usage
+ *
+ * <details>
+ *   <summary>
+ *     <b>
+ *       <i>Specify version upgrade, from [v1.31.0]</i>
+ *     </b>
+ *   </summary>
+ *
+ * Specify the version to upgrade to. List available upgradable versions, use
+ * [CloudAMQP API available versions].
+ *
+ * After the upgrade finished, there can still be newer versions available.
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as cloudamqp from "@pulumi/cloudamqp";
+ *
+ * const instance = new cloudamqp.Instance("instance", {
+ *     name: "rabbitmq-version-upgrade-test",
+ *     plan: "bunny-1",
+ *     region: "amazon-web-services::us-west-1",
+ * });
+ * const upgrade = new cloudamqp.UpgradeRabbitmq("upgrade", {
+ *     instanceId: instance.id,
+ *     newVersion: "3.13.2",
+ * });
+ * ```
+ *
+ * </details>
+ *
+ * <details>
+ *   <summary>
+ *     <b>
+ *       <i>Upgrade to latest possible version, from [v1.31.0]</i>
+ *     </b>
+ *   </summary>
+ *
+ * This will upgrade RabbitMQ to the latest possible version detected by the data source
+ * `cloudamqp.getUpgradableVersions`. Multiple runs can be needed to upgrade the version even further.
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as cloudamqp from "@pulumi/cloudamqp";
+ *
+ * const instance = new cloudamqp.Instance("instance", {
+ *     name: "rabbitmq-version-upgrade-test",
+ *     plan: "bunny-1",
+ *     region: "amazon-web-services::us-west-1",
+ * });
+ * const upgradableVersions = instance.id.apply(id => cloudamqp.getUpgradableVersionsOutput({
+ *     instanceId: id,
+ * }));
+ * const upgrade = new cloudamqp.UpgradeRabbitmq("upgrade", {
+ *     instanceId: instance.id,
+ *     currentVersion: instance.rmqVersion,
+ *     newVersion: upgradableVersions.apply(upgradableVersions => upgradableVersions.newRabbitmqVersion),
+ * });
+ * ```
+ *
+ * </details>
+ *
+ * <details>
+ *   <summary>
+ *     <b>
+ *       <i>Upgrade to latest possible version, before v1.31.0</i>
+ *     </b>
+ *   </summary>
+ *
+ * Old behaviour of the upgrading the RabbitMQ version. No longer recommended.
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as cloudamqp from "@pulumi/cloudamqp";
+ *
+ * // Retrieve latest possible upgradable versions for RabbitMQ and Erlang
+ * const versions = cloudamqp.getUpgradableVersions({
+ *     instanceId: instance.id,
+ * });
+ * // Invoke automatically upgrade to latest possible upgradable versions for RabbitMQ and Erlang
+ * const upgrade = new cloudamqp.UpgradeRabbitmq("upgrade", {instanceId: instance.id});
+ * ```
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as cloudamqp from "@pulumi/cloudamqp";
+ *
+ * // Retrieve latest possible upgradable versions for RabbitMQ and Erlang
+ * const versions = cloudamqp.getUpgradableVersions({
+ *     instanceId: instance.id,
+ * });
+ * ```
+ *
+ * If newer version is still available to be upgradable in the data source, re-run again.
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as cloudamqp from "@pulumi/cloudamqp";
+ *
+ * // Retrieve latest possible upgradable versions for RabbitMQ and Erlang
+ * const versions = cloudamqp.getUpgradableVersions({
+ *     instanceId: instance.id,
+ * });
+ * // Invoke automatically upgrade to latest possible upgradable versions for RabbitMQ and Erlang
+ * const upgrade = new cloudamqp.UpgradeRabbitmq("upgrade", {instanceId: instance.id});
+ * ```
+ *
+ * </details>
+ *
+ * ## Important upgrade information
+ *
+ * > * All single node upgrades will require some downtime since RabbitMQ needs a restart.
+ * > * From RabbitMQ version 3.9, rolling upgrades between minor versions (e.g. 3.9 to 3.10), in a
+ * >       multi-node cluster are possible without downtime. This means that one node is upgraded at a time
+ * >       while the other nodes are still running. For versions older than 3.9, patch version upgrades
+ * >       (e.g. 3.8.x to 3.8.y) are possible without downtime in a multi-node cluster, but minor version
+ * >       upgrades will require downtime.
+ * > * Auto delete queues (queues that are marked AD) will be deleted during the update.
+ * > * Any custom plugins support has installed on your behalf will be disabled and you need to contact
+ * >       support@cloudamqp.com and ask to have them re-installed.
+ * > * TLS 1.0 and 1.1 will not be supported after the update.
+ *
+ * ## Multiple runs
+ *
+ * Depending on initial versions of RabbitMQ and Erlang of the CloudAMQP instance, multiple runs may be
+ * needed to get to the latest or wanted version.
+ *
+ * Example steps needed when starting at RabbitMQ version 3.12.2
+ *
+ * |  Version         | Supported upgrading versions              | Min version to upgrade Erlang |
+ * |------------------|-------------------------------------------|-------------------------------|
+ * | 3.12.2           | 3.12.4, 3.12.6, 3.12.10, 3.12.12, 3.12.13 | 3.12.13                       |
+ * | 3.12.13          | 3.13.2                                    | 3.13.2                        |
+ * | 3.13.2           | -                                         | -                             |
+ *
+ * [CloudAMQP API available versions]: https://docs.cloudamqp.com/instance-api.html#tag/nodes/get/nodes/available-versions
+ * [v1.31.0]: https://github.com/cloudamqp/terraform-provider-cloudamqp/releases/tag/v1.31.0
+ *
  * ## Import
  *
  * Not possible to import this resource.

package/upgradeRabbitmq.js

@@ -6,6 +6,158 @@ exports.UpgradeRabbitmq = void 0;
 const pulumi = require("@pulumi/pulumi");
 const utilities = require("./utilities");
 /**
+ * This resource allows you to upgrade RabbitMQ version. Depending on initial versions of RabbitMQ and
+ * Erlang of the CloudAMQP instance, multiple runs may be needed to get to the latest or wanted version.
+ * Reason for this is certain supported RabbitMQ version will also automatically upgrade Erlang version.
+ *
+ * There is three different ways to trigger the version upgrade
+ *
+ * > * Specify RabbitMQ version to upgrade to
+ * > * Upgrade to latest RabbitMQ version
+ * > * Old behaviour to upgrade to latest RabbitMQ version
+ *
+ * See example below for usage.
+ *
+ * Only available for dedicated subscription plans running ***RabbitMQ***.
+ *
+ * ## Example Usage
+ *
+ * <details>
+ *   <summary>
+ *     <b>
+ *       <i>Specify version upgrade, from [v1.31.0]</i>
+ *     </b>
+ *   </summary>
+ *
+ * Specify the version to upgrade to. List available upgradable versions, use
+ * [CloudAMQP API available versions].
+ *
+ * After the upgrade finished, there can still be newer versions available.
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as cloudamqp from "@pulumi/cloudamqp";
+ *
+ * const instance = new cloudamqp.Instance("instance", {
+ *     name: "rabbitmq-version-upgrade-test",
+ *     plan: "bunny-1",
+ *     region: "amazon-web-services::us-west-1",
+ * });
+ * const upgrade = new cloudamqp.UpgradeRabbitmq("upgrade", {
+ *     instanceId: instance.id,
+ *     newVersion: "3.13.2",
+ * });
+ * ```
+ *
+ * </details>
+ *
+ * <details>
+ *   <summary>
+ *     <b>
+ *       <i>Upgrade to latest possible version, from [v1.31.0]</i>
+ *     </b>
+ *   </summary>
+ *
+ * This will upgrade RabbitMQ to the latest possible version detected by the data source
+ * `cloudamqp.getUpgradableVersions`. Multiple runs can be needed to upgrade the version even further.
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as cloudamqp from "@pulumi/cloudamqp";
+ *
+ * const instance = new cloudamqp.Instance("instance", {
+ *     name: "rabbitmq-version-upgrade-test",
+ *     plan: "bunny-1",
+ *     region: "amazon-web-services::us-west-1",
+ * });
+ * const upgradableVersions = instance.id.apply(id => cloudamqp.getUpgradableVersionsOutput({
+ *     instanceId: id,
+ * }));
+ * const upgrade = new cloudamqp.UpgradeRabbitmq("upgrade", {
+ *     instanceId: instance.id,
+ *     currentVersion: instance.rmqVersion,
+ *     newVersion: upgradableVersions.apply(upgradableVersions => upgradableVersions.newRabbitmqVersion),
+ * });
+ * ```
+ *
+ * </details>
+ *
+ * <details>
+ *   <summary>
+ *     <b>
+ *       <i>Upgrade to latest possible version, before v1.31.0</i>
+ *     </b>
+ *   </summary>
+ *
+ * Old behaviour of the upgrading the RabbitMQ version. No longer recommended.
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as cloudamqp from "@pulumi/cloudamqp";
+ *
+ * // Retrieve latest possible upgradable versions for RabbitMQ and Erlang
+ * const versions = cloudamqp.getUpgradableVersions({
+ *     instanceId: instance.id,
+ * });
+ * // Invoke automatically upgrade to latest possible upgradable versions for RabbitMQ and Erlang
+ * const upgrade = new cloudamqp.UpgradeRabbitmq("upgrade", {instanceId: instance.id});
+ * ```
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as cloudamqp from "@pulumi/cloudamqp";
+ *
+ * // Retrieve latest possible upgradable versions for RabbitMQ and Erlang
+ * const versions = cloudamqp.getUpgradableVersions({
+ *     instanceId: instance.id,
+ * });
+ * ```
+ *
+ * If newer version is still available to be upgradable in the data source, re-run again.
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as cloudamqp from "@pulumi/cloudamqp";
+ *
+ * // Retrieve latest possible upgradable versions for RabbitMQ and Erlang
+ * const versions = cloudamqp.getUpgradableVersions({
+ *     instanceId: instance.id,
+ * });
+ * // Invoke automatically upgrade to latest possible upgradable versions for RabbitMQ and Erlang
+ * const upgrade = new cloudamqp.UpgradeRabbitmq("upgrade", {instanceId: instance.id});
+ * ```
+ *
+ * </details>
+ *
+ * ## Important upgrade information
+ *
+ * > * All single node upgrades will require some downtime since RabbitMQ needs a restart.
+ * > * From RabbitMQ version 3.9, rolling upgrades between minor versions (e.g. 3.9 to 3.10), in a
+ * >       multi-node cluster are possible without downtime. This means that one node is upgraded at a time
+ * >       while the other nodes are still running. For versions older than 3.9, patch version upgrades
+ * >       (e.g. 3.8.x to 3.8.y) are possible without downtime in a multi-node cluster, but minor version
+ * >       upgrades will require downtime.
+ * > * Auto delete queues (queues that are marked AD) will be deleted during the update.
+ * > * Any custom plugins support has installed on your behalf will be disabled and you need to contact
+ * >       support@cloudamqp.com and ask to have them re-installed.
+ * > * TLS 1.0 and 1.1 will not be supported after the update.
+ *
+ * ## Multiple runs
+ *
+ * Depending on initial versions of RabbitMQ and Erlang of the CloudAMQP instance, multiple runs may be
+ * needed to get to the latest or wanted version.
+ *
+ * Example steps needed when starting at RabbitMQ version 3.12.2
+ *
+ * |  Version         | Supported upgrading versions              | Min version to upgrade Erlang |
+ * |------------------|-------------------------------------------|-------------------------------|
+ * | 3.12.2           | 3.12.4, 3.12.6, 3.12.10, 3.12.12, 3.12.13 | 3.12.13                       |
+ * | 3.12.13          | 3.13.2                                    | 3.13.2                        |
+ * | 3.13.2           | -                                         | -                             |
+ *
+ * [CloudAMQP API available versions]: https://docs.cloudamqp.com/instance-api.html#tag/nodes/get/nodes/available-versions
+ * [v1.31.0]: https://github.com/cloudamqp/terraform-provider-cloudamqp/releases/tag/v1.31.0
+ *
  * ## Import
  *
  * Not possible to import this resource.

package/upgradeRabbitmq.js.map

@@ -1 +1 @@
-{"version":3,"file":"upgradeRabbitmq.js","sourceRoot":"","sources":["../upgradeRabbitmq.ts"],"names":[],"mappings":";AAAA,sEAAsE;AACtE,iFAAiF;;;AAEjF,yCAAyC;AACzC,yCAAyC;AAEzC;;;;GAIG;AACH,MAAa,eAAgB,SAAQ,MAAM,CAAC,cAAc;IACtD;;;;;;;;OAQG;IACI,MAAM,CAAC,GAAG,CAAC,IAAY,EAAE,EAA2B,EAAE,KAA4B,EAAE,IAAmC;QAC1H,OAAO,IAAI,eAAe,CAAC,IAAI,EAAO,KAAK,EAAE,EAAE,GAAG,IAAI,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IACtE,CAAC;IAKD;;;OAGG;IACI,MAAM,CAAC,UAAU,CAAC,GAAQ;QAC7B,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,IAAI,EAAE;YACnC,OAAO,KAAK,CAAC;SAChB;QACD,OAAO,GAAG,CAAC,cAAc,CAAC,KAAK,eAAe,CAAC,YAAY,CAAC;IAChE,CAAC;IAwBD,YAAY,IAAY,EAAE,WAAwD,EAAE,IAAmC;QACnH,IAAI,cAAc,GAAkB,EAAE,CAAC;QACvC,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;QAClB,IAAI,IAAI,CAAC,EAAE,EAAE;YACT,MAAM,KAAK,GAAG,WAA+C,CAAC;YAC9D,cAAc,CAAC,gBAAgB,CAAC,GAAG,KAAK,EAAE,cAAc,CAAC;YACzD,cAAc,CAAC,YAAY,CAAC,GAAG,KAAK,EAAE,UAAU,CAAC;YACjD,cAAc,CAAC,YAAY,CAAC,GAAG,KAAK,EAAE,UAAU,CAAC;SACpD;aAAM;YACH,MAAM,IAAI,GAAG,WAA8C,CAAC;YAC5D,IAAI,IAAI,EAAE,UAAU,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE;gBAC7C,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;aAC7D;YACD,cAAc,CAAC,gBAAgB,CAAC,GAAG,IAAI,EAAE,cAAc,CAAC;YACxD,cAAc,CAAC,YAAY,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC;YAChD,cAAc,CAAC,YAAY,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC;SACnD;QACD,IAAI,GAAG,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,oBAAoB,EAAE,EAAE,IAAI,CAAC,CAAC;QACnE,KAAK,CAAC,eAAe,CAAC,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,CAAC,CAAC;IACpE,CAAC;;AArEL,0CAsEC;AAxDG,gBAAgB;AACO,4BAAY,GAAG,iDAAiD,CAAC"}
+{"version":3,"file":"upgradeRabbitmq.js","sourceRoot":"","sources":["../upgradeRabbitmq.ts"],"names":[],"mappings":";AAAA,sEAAsE;AACtE,iFAAiF;;;AAEjF,yCAAyC;AACzC,yCAAyC;AAEzC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4JG;AACH,MAAa,eAAgB,SAAQ,MAAM,CAAC,cAAc;IACtD;;;;;;;;OAQG;IACI,MAAM,CAAC,GAAG,CAAC,IAAY,EAAE,EAA2B,EAAE,KAA4B,EAAE,IAAmC;QAC1H,OAAO,IAAI,eAAe,CAAC,IAAI,EAAO,KAAK,EAAE,EAAE,GAAG,IAAI,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IACtE,CAAC;IAKD;;;OAGG;IACI,MAAM,CAAC,UAAU,CAAC,GAAQ;QAC7B,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,IAAI,EAAE;YACnC,OAAO,KAAK,CAAC;SAChB;QACD,OAAO,GAAG,CAAC,cAAc,CAAC,KAAK,eAAe,CAAC,YAAY,CAAC;IAChE,CAAC;IAwBD,YAAY,IAAY,EAAE,WAAwD,EAAE,IAAmC;QACnH,IAAI,cAAc,GAAkB,EAAE,CAAC;QACvC,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;QAClB,IAAI,IAAI,CAAC,EAAE,EAAE;YACT,MAAM,KAAK,GAAG,WAA+C,CAAC;YAC9D,cAAc,CAAC,gBAAgB,CAAC,GAAG,KAAK,EAAE,cAAc,CAAC;YACzD,cAAc,CAAC,YAAY,CAAC,GAAG,KAAK,EAAE,UAAU,CAAC;YACjD,cAAc,CAAC,YAAY,CAAC,GAAG,KAAK,EAAE,UAAU,CAAC;SACpD;aAAM;YACH,MAAM,IAAI,GAAG,WAA8C,CAAC;YAC5D,IAAI,IAAI,EAAE,UAAU,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE;gBAC7C,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;aAC7D;YACD,cAAc,CAAC,gBAAgB,CAAC,GAAG,IAAI,EAAE,cAAc,CAAC;YACxD,cAAc,CAAC,YAAY,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC;YAChD,cAAc,CAAC,YAAY,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC;SACnD;QACD,IAAI,GAAG,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,oBAAoB,EAAE,EAAE,IAAI,CAAC,CAAC;QACnE,KAAK,CAAC,eAAe,CAAC,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,CAAC,CAAC;IACpE,CAAC;;AArEL,0CAsEC;AAxDG,gBAAgB;AACO,4BAAY,GAAG,iDAAiD,CAAC"}

package/vpc.d.ts

@@ -37,34 +37,6 @@ import * as pulumi from "@pulumi/pulumi";
  *     vpcId: vpc.id,
  * });
  * ```
- *
- * ## Import
- *
- * `cloudamqp_vpc` can be imported using the CloudAMQP VPC identifier. To retrieve the identifier of an
- *
- * instance, use [CloudAMQP API list vpcs].
- *
- * From Terraform v1.5.0, the `import` block can be used to import this resource:
- *
- * hcl
- *
- * import {
- *
- *   to = cloudamqp_vpc.vpc
- *
- *   id = <vpc_id>
- *
- * }
- *
- * Or with Terraform CLI:
- *
- * ```sh
- * $ pulumi import cloudamqp:index/vpc:Vpc vpc <vpc_id>`
- * ```
- *
- * [CloudAMQP API list vpcs]: https://docs.cloudamqp.com/index.html#tag/vpcs/get/vpcs
- *
- * [CloudAMQP plans]: https://docs.cloudamqp.com/index.html#tag/plans/get/plans
  */
 export declare class Vpc extends pulumi.CustomResource {
     /**

package/vpc.js

@@ -43,34 +43,6 @@ const utilities = require("./utilities");
  *     vpcId: vpc.id,
  * });
  * ```
- *
- * ## Import
- *
- * `cloudamqp_vpc` can be imported using the CloudAMQP VPC identifier. To retrieve the identifier of an
- *
- * instance, use [CloudAMQP API list vpcs].
- *
- * From Terraform v1.5.0, the `import` block can be used to import this resource:
- *
- * hcl
- *
- * import {
- *
- *   to = cloudamqp_vpc.vpc
- *
- *   id = <vpc_id>
- *
- * }
- *
- * Or with Terraform CLI:
- *
- * ```sh
- * $ pulumi import cloudamqp:index/vpc:Vpc vpc <vpc_id>`
- * ```
- *
- * [CloudAMQP API list vpcs]: https://docs.cloudamqp.com/index.html#tag/vpcs/get/vpcs
- *
- * [CloudAMQP plans]: https://docs.cloudamqp.com/index.html#tag/plans/get/plans
  */
 class Vpc extends pulumi.CustomResource {
     /**

package/vpc.js.map

@@ -1 +1 @@
-{"version":3,"file":"vpc.js","sourceRoot":"","sources":["../vpc.ts"],"names":[],"mappings":";AAAA,sEAAsE;AACtE,iFAAiF;;;AAEjF,yCAAyC;AACzC,yCAAyC;AAEzC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkEG;AACH,MAAa,GAAI,SAAQ,MAAM,CAAC,cAAc;IAC1C;;;;;;;;OAQG;IACI,MAAM,CAAC,GAAG,CAAC,IAAY,EAAE,EAA2B,EAAE,KAAgB,EAAE,IAAmC;QAC9G,OAAO,IAAI,GAAG,CAAC,IAAI,EAAO,KAAK,EAAE,EAAE,GAAG,IAAI,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IAC1D,CAAC;IAKD;;;OAGG;IACI,MAAM,CAAC,UAAU,CAAC,GAAQ;QAC7B,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,IAAI,EAAE;YACnC,OAAO,KAAK,CAAC;SAChB;QACD,OAAO,GAAG,CAAC,cAAc,CAAC,KAAK,GAAG,CAAC,YAAY,CAAC;IACpD,CAAC;IA+BD,YAAY,IAAY,EAAE,WAAgC,EAAE,IAAmC;QAC3F,IAAI,cAAc,GAAkB,EAAE,CAAC;QACvC,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;QAClB,IAAI,IAAI,CAAC,EAAE,EAAE;YACT,MAAM,KAAK,GAAG,WAAmC,CAAC;YAClD,cAAc,CAAC,MAAM,CAAC,GAAG,KAAK,EAAE,IAAI,CAAC;YACrC,cAAc,CAAC,QAAQ,CAAC,GAAG,KAAK,EAAE,MAAM,CAAC;YACzC,cAAc,CAAC,QAAQ,CAAC,GAAG,KAAK,EAAE,MAAM,CAAC;YACzC,cAAc,CAAC,MAAM,CAAC,GAAG,KAAK,EAAE,IAAI,CAAC;YACrC,cAAc,CAAC,SAAS,CAAC,GAAG,KAAK,EAAE,OAAO,CAAC;SAC9C;aAAM;YACH,MAAM,IAAI,GAAG,WAAkC,CAAC;YAChD,IAAI,IAAI,EAAE,MAAM,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE;gBACzC,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;aACzD;YACD,IAAI,IAAI,EAAE,MAAM,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE;gBACzC,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;aACzD;YACD,cAAc,CAAC,MAAM,CAAC,GAAG,IAAI,EAAE,IAAI,CAAC;YACpC,cAAc,CAAC,QAAQ,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC;YACxC,cAAc,CAAC,QAAQ,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC;YACxC,cAAc,CAAC,MAAM,CAAC,GAAG,IAAI,EAAE,IAAI,CAAC;YACpC,cAAc,CAAC,SAAS,CAAC,GAAG,SAAS,CAAC,OAAO,CAAC;SACjD;QACD,IAAI,GAAG,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,oBAAoB,EAAE,EAAE,IAAI,CAAC,CAAC;QACnE,KAAK,CAAC,GAAG,CAAC,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,CAAC,CAAC;IACxD,CAAC;;AAnFL,kBAoFC;AAtEG,gBAAgB;AACO,gBAAY,GAAG,yBAAyB,CAAC"}
+{"version":3,"file":"vpc.js","sourceRoot":"","sources":["../vpc.ts"],"names":[],"mappings":";AAAA,sEAAsE;AACtE,iFAAiF;;;AAEjF,yCAAyC;AACzC,yCAAyC;AAEzC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,MAAa,GAAI,SAAQ,MAAM,CAAC,cAAc;IAC1C;;;;;;;;OAQG;IACI,MAAM,CAAC,GAAG,CAAC,IAAY,EAAE,EAA2B,EAAE,KAAgB,EAAE,IAAmC;QAC9G,OAAO,IAAI,GAAG,CAAC,IAAI,EAAO,KAAK,EAAE,EAAE,GAAG,IAAI,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IAC1D,CAAC;IAKD;;;OAGG;IACI,MAAM,CAAC,UAAU,CAAC,GAAQ;QAC7B,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,IAAI,EAAE;YACnC,OAAO,KAAK,CAAC;SAChB;QACD,OAAO,GAAG,CAAC,cAAc,CAAC,KAAK,GAAG,CAAC,YAAY,CAAC;IACpD,CAAC;IA+BD,YAAY,IAAY,EAAE,WAAgC,EAAE,IAAmC;QAC3F,IAAI,cAAc,GAAkB,EAAE,CAAC;QACvC,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;QAClB,IAAI,IAAI,CAAC,EAAE,EAAE;YACT,MAAM,KAAK,GAAG,WAAmC,CAAC;YAClD,cAAc,CAAC,MAAM,CAAC,GAAG,KAAK,EAAE,IAAI,CAAC;YACrC,cAAc,CAAC,QAAQ,CAAC,GAAG,KAAK,EAAE,MAAM,CAAC;YACzC,cAAc,CAAC,QAAQ,CAAC,GAAG,KAAK,EAAE,MAAM,CAAC;YACzC,cAAc,CAAC,MAAM,CAAC,GAAG,KAAK,EAAE,IAAI,CAAC;YACrC,cAAc,CAAC,SAAS,CAAC,GAAG,KAAK,EAAE,OAAO,CAAC;SAC9C;aAAM;YACH,MAAM,IAAI,GAAG,WAAkC,CAAC;YAChD,IAAI,IAAI,EAAE,MAAM,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE;gBACzC,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;aACzD;YACD,IAAI,IAAI,EAAE,MAAM,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE;gBACzC,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;aACzD;YACD,cAAc,CAAC,MAAM,CAAC,GAAG,IAAI,EAAE,IAAI,CAAC;YACpC,cAAc,CAAC,QAAQ,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC;YACxC,cAAc,CAAC,QAAQ,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC;YACxC,cAAc,CAAC,MAAM,CAAC,GAAG,IAAI,EAAE,IAAI,CAAC;YACpC,cAAc,CAAC,SAAS,CAAC,GAAG,SAAS,CAAC,OAAO,CAAC;SACjD;QACD,IAAI,GAAG,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,oBAAoB,EAAE,EAAE,IAAI,CAAC,CAAC;QACnE,KAAK,CAAC,GAAG,CAAC,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,CAAC,CAAC;IACxD,CAAC;;AAnFL,kBAoFC;AAtEG,gBAAgB;AACO,gBAAY,GAAG,yBAAyB,CAAC"}

package/vpcConnect.d.ts

@@ -1,28 +1,236 @@
 import * as pulumi from "@pulumi/pulumi";
 /**
- * ## Import
+ * This resource is a generic way to handle PrivateLink (AWS and Azure) and Private Service Connect
+ * (GCP). Communication between resources can be done just as they were living inside a VPC. CloudAMQP
+ * creates an Endpoint Service to connect the VPC and creating a new network interface to handle the
+ * communicate.
  *
- * `cloudamqp_vpc_connect` can be imported using CloudAMQP instance identifier. To
+ * If no existing VPC available when enable VPC connect, a new VPC will be created with subnet
+ * `10.52.72.0/24`.
  *
- * retrieve the identifier, use [CloudAMQP API list intances].
+ * More information can be found at: [CloudAMQP VPC Connect]
  *
- * From Terraform v1.5.0, the `import` block can be used to import this resource:
+ * > **Note:** Enabling VPC Connect will automatically add a firewall rule.
  *
- * hcl
+ * <details>
+ *  <summary>
+ *     <b>
+ *       <i>Default PrivateLink firewall rule [AWS, Azure]</i>
+ *     </b>
+ *   </summary>
  *
- * import {
+ * For LavinMQ:
  *
- *   to = cloudamqp_vpc_connect.this
+ * ## Example Usage
  *
- *   id = cloudamqp_instance.instance.id
+ * <details>
+ *   <summary>
+ *     <b>
+ *       <i>Enable VPC Connect (PrivateLink) in AWS</i>
+ *     </b>
+ *   </summary>
  *
- * }
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as cloudamqp from "@pulumi/cloudamqp";
  *
- * Or use Terraform CLI:
+ * const vpc = new cloudamqp.Vpc("vpc", {
+ *     name: "Standalone VPC",
+ *     region: "amazon-web-services::us-west-1",
+ *     subnet: "10.56.72.0/24",
+ *     tags: [],
+ * });
+ * const instance = new cloudamqp.Instance("instance", {
+ *     name: "Instance 01",
+ *     plan: "penguin-1",
+ *     region: "amazon-web-services::us-west-1",
+ *     tags: [],
+ *     vpcId: vpc.id,
+ *     keepAssociatedVpc: true,
+ * });
+ * const vpcConnect = new cloudamqp.VpcConnect("vpc_connect", {
+ *     instanceId: instance.id,
+ *     region: instance.region,
+ *     allowedPrincipals: ["arn:aws:iam::aws-account-id:user/user-name"],
+ * });
+ * ```
+ *
+ * </details>
+ *
+ * <details>
+ *   <summary>
+ *     <b>
+ *       <i>Enable VPC Connect (PrivateLink) in Azure</i>
+ *     </b>
+ *   </summary>
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as cloudamqp from "@pulumi/cloudamqp";
+ *
+ * const vpc = new cloudamqp.Vpc("vpc", {
+ *     name: "Standalone VPC",
+ *     region: "azure-arm::westus",
+ *     subnet: "10.56.72.0/24",
+ *     tags: [],
+ * });
+ * const instance = new cloudamqp.Instance("instance", {
+ *     name: "Instance 01",
+ *     plan: "penguin-1",
+ *     region: "azure-arm::westus",
+ *     tags: [],
+ *     vpcId: vpc.id,
+ *     keepAssociatedVpc: true,
+ * });
+ * const vpcConnect = new cloudamqp.VpcConnect("vpc_connect", {
+ *     instanceId: instance.id,
+ *     region: instance.region,
+ *     approvedSubscriptions: ["XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"],
+ * });
+ * ```
+ *
+ * The attribute `serviceName` found in resource `cloudamqp.VpcConnect` corresponds to the alias in
+ * the resource `azurermPrivateEndpoint` of the Azure provider. This can be used when creating the
+ * private endpoint.
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as azurerm from "@pulumi/azurerm";
+ *
+ * const example = new azurerm.index.PrivateEndpoint("example", {
+ *     name: "example-endpoint",
+ *     location: exampleAzurermResourceGroup.location,
+ *     resourceGroupName: exampleAzurermResourceGroup.name,
+ *     subnetId: subnet.id,
+ *     privateServiceConnection: [{
+ *         name: "example-privateserviceconnection",
+ *         privateConnectionResourceAlias: vpcConnect.serviceName,
+ *         isManualConnection: true,
+ *         requestMessage: "PL",
+ *     }],
+ * });
+ * ```
+ *
+ * More information about the resource and argument can be found here:
+ * [privateConnectionResourceAlias]. Or check their example "Using a Private Link Service Alias with
+ * existing resources".
+ *
+ * </details>
+ *
+ * <details>
+ *   <summary>
+ *     <b>
+ *       <i>Enable VPC Connect (Private Service Connect) in GCP</i>
+ *     </b>
+ *   </summary>
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as cloudamqp from "@pulumi/cloudamqp";
  *
- * ```sh
- * $ pulumi import cloudamqp:index/vpcConnect:VpcConnect vpc_connect <id>`
+ * const vpc = new cloudamqp.Vpc("vpc", {
+ *     name: "Standalone VPC",
+ *     region: "google-compute-engine::us-west1",
+ *     subnet: "10.56.72.0/24",
+ *     tags: [],
+ * });
+ * const instance = new cloudamqp.Instance("instance", {
+ *     name: "Instance 01",
+ *     plan: "penguin-1",
+ *     region: "google-compute-engine::us-west1",
+ *     tags: [],
+ *     vpcId: vpc.id,
+ *     keepAssociatedVpc: true,
+ * });
+ * const vpcConnect = new cloudamqp.VpcConnect("vpc_connect", {
+ *     instanceId: instance.id,
+ *     region: instance.region,
+ *     allowedProjects: ["some-project-123456"],
+ * });
  * ```
+ *
+ * </details>
+ *
+ * ### With Additional Firewall Rules
+ *
+ * <details>
+ *   <summary>
+ *     <b>
+ *       <i>CloudAMQP instance in an existing VPC with managed firewall rules</i>
+ *     </b>
+ *   </summary>
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as cloudamqp from "@pulumi/cloudamqp";
+ *
+ * const vpc = new cloudamqp.Vpc("vpc", {
+ *     name: "Standalone VPC",
+ *     region: "amazon-web-services::us-west-1",
+ *     subnet: "10.56.72.0/24",
+ *     tags: [],
+ * });
+ * const instance = new cloudamqp.Instance("instance", {
+ *     name: "Instance 01",
+ *     plan: "penguin-1",
+ *     region: "amazon-web-services::us-west-1",
+ *     tags: [],
+ *     vpcId: vpc.id,
+ *     keepAssociatedVpc: true,
+ * });
+ * const vpcConnect = new cloudamqp.VpcConnect("vpc_connect", {
+ *     instanceId: instance.id,
+ *     allowedPrincipals: ["arn:aws:iam::aws-account-id:user/user-name"],
+ * });
+ * const firewallSettings = new cloudamqp.SecurityFirewall("firewall_settings", {
+ *     instanceId: instance.id,
+ *     rules: [
+ *         {
+ *             description: "Custom PrivateLink setup",
+ *             ip: vpc.subnet,
+ *             ports: [],
+ *             services: [
+ *                 "AMQP",
+ *                 "AMQPS",
+ *                 "HTTPS",
+ *             ],
+ *         },
+ *         {
+ *             description: "MGMT interface",
+ *             ip: "0.0.0.0/0",
+ *             ports: [],
+ *             services: ["HTTPS"],
+ *         },
+ *     ],
+ * }, {
+ *     dependsOn: [vpcConnect],
+ * });
+ * ```
+ *
+ * </details>
+ *
+ * [CloudAMQP API list intances]: https://docs.cloudamqp.com/index.html#tag/instances/get/instances
+ * [CloudAMQP VPC Connect]: https://www.cloudamqp.com/docs/cloudamqp-vpc-connect.html
+ * [cloudamqp.SecurityFirewall]: https://registry.terraform.io/providers/cloudamqp/cloudamqp/latest/docs/resources/security_firewall
+ * [Google docs]: https://cloud.google.com/resource-manager/reference/rest/v1/projects
+ * [privateConnectionResourceAlias]: ./private_endpoint#private_connection_resource_alias-1
+ *
+ * ## Dependency
+ *
+ * This resource depends on CloudAMQP instance identifier, `cloudamqp_instance.instance.id`.
+ *
+ * Since `region` also is required, suggest to reuse the argument from CloudAMQP instance,
+ * `cloudamqp_instance.instance.region`.
+ *
+ * ## Create VPC Connect with additional firewall rules
+ *
+ * To create a PrivateLink/Private Service Connect configuration with additional firewall rules, it's
+ * required to chain the [cloudamqp.SecurityFirewall] resource to avoid parallel conflicting resource
+ * calls. You can do this by making the firewall resource depend on the VPC Connect resource
+ * `cloudamqp_vpc_connect.vpc_connect`.
+ *
+ * Furthermore, since all firewall rules are overwritten, the otherwise automatically added rules for
+ * the VPC Connect also needs to be added.
  */
 export declare class VpcConnect extends pulumi.CustomResource {
     /**