@pulumi/cloudamqp 3.26.1 → 3.27.0-alpha.1770934853

package/privatelinkAws.js

@@ -6,29 +6,156 @@ exports.PrivatelinkAws = void 0;
 const pulumi = require("@pulumi/pulumi");
 const utilities = require("./utilities");
 /**
- * ## Import
+ * Enable PrivateLink for a CloudAMQP instance hosted in AWS. If no existing VPC available when enable
+ * PrivateLink, a new VPC will be created with subnet `10.52.72.0/24`.
  *
- * `cloudamqp_privatelink_aws` can be imported using CloudAMQP instance identifier. To retrieve the
+ * > **Note:** Enabling PrivateLink will automatically add firewall rules for the peered subnet.
  *
- * identifier, use [CloudAMQP API list intances].
+ * <details>
+ *  <summary>
+ *     <i>Default PrivateLink firewall rule</i>
+ *   </summary>
  *
- * From Terraform v1.5.0, the `import` block can be used to import this resource:
+ * ## Example Usage
  *
- * hcl
+ * <details>
+ *   <summary>
+ *     <b>
+ *       <i>CloudAMQP instance without existing VPC</i>
+ *     </b>
+ *   </summary>
  *
- * import {
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as cloudamqp from "@pulumi/cloudamqp";
  *
- *   to = cloudamqp_privatelink_aws.privatelink
+ * const instance = new cloudamqp.Instance("instance", {
+ *     name: "Instance 01",
+ *     plan: "bunny-1",
+ *     region: "amazon-web-services::us-west-1",
+ *     tags: [],
+ * });
+ * const privatelink = new cloudamqp.PrivatelinkAws("privatelink", {
+ *     instanceId: instance.id,
+ *     allowedPrincipals: ["arn:aws:iam::aws-account-id:user/user-name"],
+ * });
+ * ```
+ *
+ * </details>
+ *
+ * <details>
+ *   <summary>
+ *     <b>
+ *       <i>CloudAMQP instance in an existing VPC</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: "bunny-1",
+ *     region: "amazon-web-services::us-west-1",
+ *     tags: [],
+ *     vpcId: vpc.id,
+ *     keepAssociatedVpc: true,
+ * });
+ * const privatelink = new cloudamqp.PrivatelinkAws("privatelink", {
+ *     instanceId: instance.id,
+ *     allowedPrincipals: ["arn:aws:iam::aws-account-id:user/user-name"],
+ * });
+ * ```
+ *
+ * </details>
  *
- *   id = cloudamqp_instance.instance.id
+ * ### With Additional Firewall Rules
  *
- * }
+ * <details>
+ *   <summary>
+ *     <b>
+ *       <i>CloudAMQP instance in an existing VPC with managed firewall rules</i>
+ *     </b>
+ *   </summary>
  *
- * Or use Terraform CLI:
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as cloudamqp from "@pulumi/cloudamqp";
  *
- * ```sh
- * $ pulumi import cloudamqp:index/privatelinkAws:PrivatelinkAws privatelink <id>`
+ * 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: "bunny-1",
+ *     region: "amazon-web-services::us-west-1",
+ *     tags: [],
+ *     vpcId: vpc.id,
+ *     keepAssociatedVpc: true,
+ * });
+ * const privatelink = new cloudamqp.PrivatelinkAws("privatelink", {
+ *     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",
+ *                 "STREAM",
+ *                 "STREAM_SSL",
+ *             ],
+ *         },
+ *         {
+ *             description: "MGMT interface",
+ *             ip: "0.0.0.0/0",
+ *             ports: [],
+ *             services: ["HTTPS"],
+ *         },
+ *     ],
+ * }, {
+ *     dependsOn: [privatelink],
+ * });
  * ```
+ *
+ * </details>
+ *
+ * [CloudAMQP API list intances]: https://docs.cloudamqp.com/index.html#tag/instances/get/instances
+ * [CloudAMQP plans]: https://www.cloudamqp.com/plans.html
+ * [CloudAMQP PrivateLink]: https://www.cloudamqp.com/docs/cloudamqp-privatelink.html#aws-privatelink
+ * [cloudamqp.SecurityFirewall]: ./security_firewall.md
+ * [cloudamqp.VpcConnect]: ./vpc_connect.md
+ * [v1.29.0]: https://github.com/cloudamqp/terraform-provider-cloudamqp/releases/tag/v1.29.0
+ *
+ * ## Dependency
+ *
+ * This resource depends on CloudAMQP instance identifier, `cloudamqp_instance.instance.id`.
+ *
+ * ## Create PrivateLink with additional firewall rules
+ *
+ * To create a PrivateLink 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 PrivateLink resource,
+ * `cloudamqp_privatelink_aws.privatelink`.
+ *
+ * Furthermore, since all firewall rules are overwritten, the otherwise automatically added rules for
+ * the PrivateLink also needs to be added.
  */
 class PrivatelinkAws extends pulumi.CustomResource {
     /**

package/privatelinkAws.js.map

@@ -1 +1 @@
-{"version":3,"file":"privatelinkAws.js","sourceRoot":"","sources":["../privatelinkAws.ts"],"names":[],"mappings":";AAAA,sEAAsE;AACtE,iFAAiF;;;AAEjF,yCAAyC;AACzC,yCAAyC;AAEzC;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAa,cAAe,SAAQ,MAAM,CAAC,cAAc;IACrD;;;;;;;;OAQG;IACI,MAAM,CAAC,GAAG,CAAC,IAAY,EAAE,EAA2B,EAAE,KAA2B,EAAE,IAAmC;QACzH,OAAO,IAAI,cAAc,CAAC,IAAI,EAAO,KAAK,EAAE,EAAE,GAAG,IAAI,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IACrE,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,cAAc,CAAC,YAAY,CAAC;IAC/D,CAAC;IAkDD,YAAY,IAAY,EAAE,WAAsD,EAAE,IAAmC;QACjH,IAAI,cAAc,GAAkB,EAAE,CAAC;QACvC,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;QAClB,IAAI,IAAI,CAAC,EAAE,EAAE;YACT,MAAM,KAAK,GAAG,WAA8C,CAAC;YAC7D,cAAc,CAAC,aAAa,CAAC,GAAG,KAAK,EAAE,WAAW,CAAC;YACnD,cAAc,CAAC,mBAAmB,CAAC,GAAG,KAAK,EAAE,iBAAiB,CAAC;YAC/D,cAAc,CAAC,YAAY,CAAC,GAAG,KAAK,EAAE,UAAU,CAAC;YACjD,cAAc,CAAC,aAAa,CAAC,GAAG,KAAK,EAAE,WAAW,CAAC;YACnD,cAAc,CAAC,OAAO,CAAC,GAAG,KAAK,EAAE,KAAK,CAAC;YACvC,cAAc,CAAC,QAAQ,CAAC,GAAG,KAAK,EAAE,MAAM,CAAC;YACzC,cAAc,CAAC,SAAS,CAAC,GAAG,KAAK,EAAE,OAAO,CAAC;SAC9C;aAAM;YACH,MAAM,IAAI,GAAG,WAA6C,CAAC;YAC3D,IAAI,IAAI,EAAE,iBAAiB,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE;gBACpD,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;aACpE;YACD,IAAI,IAAI,EAAE,UAAU,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE;gBAC7C,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;aAC7D;YACD,cAAc,CAAC,mBAAmB,CAAC,GAAG,IAAI,EAAE,iBAAiB,CAAC;YAC9D,cAAc,CAAC,YAAY,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC;YAChD,cAAc,CAAC,OAAO,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC;YACtC,cAAc,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC;YAC1C,cAAc,CAAC,aAAa,CAAC,GAAG,SAAS,CAAC,OAAO,CAAC;YAClD,cAAc,CAAC,aAAa,CAAC,GAAG,SAAS,CAAC,OAAO,CAAC;YAClD,cAAc,CAAC,QAAQ,CAAC,GAAG,SAAS,CAAC,OAAO,CAAC;SAChD;QACD,IAAI,GAAG,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,oBAAoB,EAAE,EAAE,IAAI,CAAC,CAAC;QACnE,KAAK,CAAC,cAAc,CAAC,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,CAAC,CAAC;IACnE,CAAC;;AA1GL,wCA2GC;AA7FG,gBAAgB;AACO,2BAAY,GAAG,+CAA+C,CAAC"}
+{"version":3,"file":"privatelinkAws.js","sourceRoot":"","sources":["../privatelinkAws.ts"],"names":[],"mappings":"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"}

package/privatelinkAzure.d.ts

@@ -1,30 +1,155 @@
 import * as pulumi from "@pulumi/pulumi";
 /**
- * ## Import
+ * Enable PrivateLink for a CloudAMQP instance hosted in Azure. If no existing VPC available when
+ * enable PrivateLink, a new VPC will be created with subnet `10.52.72.0/24`.
  *
- * `cloudamqp_privatelink_azure` can be imported using CloudAMQP instance identifier. To retrieve the
+ * > **Note:** Enabling PrivateLink will automatically add firewall rules for the peered subnet.
  *
- * identifier, use [CloudAMQP API list intances].
+ * <details>
+ *  <summary>
+ *     <i>Default PrivateLink firewall rule</i>
+ *   </summary>
  *
- * From Terraform v1.5.0, the `import` block can be used to import this resource:
+ * ## Example Usage
  *
- * hcl
+ * <details>
+ *   <summary>
+ *     <b>
+ *       <i>CloudAMQP instance without existing VPC</i>
+ *     </b>
+ *   </summary>
  *
- * import {
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as cloudamqp from "@pulumi/cloudamqp";
  *
- *   to = cloudamqp_privatelink_azure.privatelink
+ * const instance = new cloudamqp.Instance("instance", {
+ *     name: "Instance 01",
+ *     plan: "bunny-1",
+ *     region: "azure-arm::westus",
+ *     tags: [],
+ * });
+ * const privatelink = new cloudamqp.PrivatelinkAzure("privatelink", {
+ *     instanceId: instance.id,
+ *     approvedSubscriptions: ["XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"],
+ * });
+ * ```
+ *
+ * </details>
+ *
+ * <details>
+ *   <summary>
+ *     <b>
+ *       <i>CloudAMQP instance in an existing VPC</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: "bunny-1",
+ *     region: "azure-arm::westus",
+ *     tags: [],
+ *     vpcId: vpc.id,
+ *     keepAssociatedVpc: true,
+ * });
+ * const privatelink = new cloudamqp.PrivatelinkAzure("privatelink", {
+ *     instanceId: instance.id,
+ *     approvedSubscriptions: ["XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"],
+ * });
+ * ```
+ *
+ * </details>
  *
- *   id = cloudamqp_instance.instance.id
+ * ### With Additional Firewall Rules
  *
- * }
+ * <details>
+ *   <summary>
+ *     <b>
+ *       <i>CloudAMQP instance in an existing VPC with managed firewall rules</i>
+ *     </b>
+ *   </summary>
  *
- * Or use Terraform CLI:
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as cloudamqp from "@pulumi/cloudamqp";
  *
- * ```sh
- * $ pulumi import cloudamqp:index/privatelinkAzure:PrivatelinkAzure privatelink <id>`
+ * 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: "bunny-1",
+ *     region: "azure-arm::westus",
+ *     tags: [],
+ *     vpcId: vpc.id,
+ *     keepAssociatedVpc: true,
+ * });
+ * const privatelink = new cloudamqp.PrivatelinkAzure("privatelink", {
+ *     instanceId: instance.id,
+ *     approvedSubscriptions: ["XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"],
+ * });
+ * const firewallSettings = new cloudamqp.SecurityFirewall("firewall_settings", {
+ *     instanceId: instance.id,
+ *     rules: [
+ *         {
+ *             description: "Custom PrivateLink setup",
+ *             ip: vpc.subnet,
+ *             ports: [],
+ *             services: [
+ *                 "AMQP",
+ *                 "AMQPS",
+ *                 "HTTPS",
+ *                 "STREAM",
+ *                 "STREAM_SSL",
+ *             ],
+ *         },
+ *         {
+ *             description: "MGMT interface",
+ *             ip: "0.0.0.0/0",
+ *             ports: [],
+ *             services: ["HTTPS"],
+ *         },
+ *     ],
+ * }, {
+ *     dependsOn: [privatelink],
+ * });
  * ```
  *
- * `cloudamqp_privatelink_aws` can be imported using CloudAMQP instance identifier.
+ * </details>
+ *
+ * [CloudAMQP API list intances]: https://docs.cloudamqp.com/index.html#tag/instances/get/instances
+ * [CloudAMQP plans]: https://www.cloudamqp.com/plans.html
+ * [CloudAMQP PrivateLink]: https://www.cloudamqp.com/docs/cloudamqp-privatelink.html#azure-privatelink
+ * [cloudamqp.SecurityFirewall]: ./security_firewall.md
+ * [cloudamqp.VpcConnect]: ./vpc_connect.md
+ * [v1.29.0]: https://github.com/cloudamqp/terraform-provider-cloudamqp/releases/tag/v1.29.0
+ *
+ * ## Dependency
+ *
+ * This resource depends on CloudAMQP instance identifier, `cloudamqp_instance.instance.id`.
+ *
+ * ## Create PrivateLink with additional firewall rules
+ *
+ * To create a PrivateLink 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 PrivateLink resource
+ * `cloudamqp_privatelink_azure.privatelink`.
+ *
+ * Furthermore, since all firewall rules are overwritten, the otherwise automatically added rules for
+ * the PrivateLink also needs to be added.
  */
 export declare class PrivatelinkAzure extends pulumi.CustomResource {
     /**

package/privatelinkAzure.js

@@ -6,31 +6,156 @@ exports.PrivatelinkAzure = void 0;
 const pulumi = require("@pulumi/pulumi");
 const utilities = require("./utilities");
 /**
- * ## Import
+ * Enable PrivateLink for a CloudAMQP instance hosted in Azure. If no existing VPC available when
+ * enable PrivateLink, a new VPC will be created with subnet `10.52.72.0/24`.
  *
- * `cloudamqp_privatelink_azure` can be imported using CloudAMQP instance identifier. To retrieve the
+ * > **Note:** Enabling PrivateLink will automatically add firewall rules for the peered subnet.
  *
- * identifier, use [CloudAMQP API list intances].
+ * <details>
+ *  <summary>
+ *     <i>Default PrivateLink firewall rule</i>
+ *   </summary>
  *
- * From Terraform v1.5.0, the `import` block can be used to import this resource:
+ * ## Example Usage
  *
- * hcl
+ * <details>
+ *   <summary>
+ *     <b>
+ *       <i>CloudAMQP instance without existing VPC</i>
+ *     </b>
+ *   </summary>
  *
- * import {
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as cloudamqp from "@pulumi/cloudamqp";
  *
- *   to = cloudamqp_privatelink_azure.privatelink
+ * const instance = new cloudamqp.Instance("instance", {
+ *     name: "Instance 01",
+ *     plan: "bunny-1",
+ *     region: "azure-arm::westus",
+ *     tags: [],
+ * });
+ * const privatelink = new cloudamqp.PrivatelinkAzure("privatelink", {
+ *     instanceId: instance.id,
+ *     approvedSubscriptions: ["XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"],
+ * });
+ * ```
+ *
+ * </details>
+ *
+ * <details>
+ *   <summary>
+ *     <b>
+ *       <i>CloudAMQP instance in an existing VPC</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: "bunny-1",
+ *     region: "azure-arm::westus",
+ *     tags: [],
+ *     vpcId: vpc.id,
+ *     keepAssociatedVpc: true,
+ * });
+ * const privatelink = new cloudamqp.PrivatelinkAzure("privatelink", {
+ *     instanceId: instance.id,
+ *     approvedSubscriptions: ["XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"],
+ * });
+ * ```
+ *
+ * </details>
  *
- *   id = cloudamqp_instance.instance.id
+ * ### With Additional Firewall Rules
  *
- * }
+ * <details>
+ *   <summary>
+ *     <b>
+ *       <i>CloudAMQP instance in an existing VPC with managed firewall rules</i>
+ *     </b>
+ *   </summary>
  *
- * Or use Terraform CLI:
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as cloudamqp from "@pulumi/cloudamqp";
  *
- * ```sh
- * $ pulumi import cloudamqp:index/privatelinkAzure:PrivatelinkAzure privatelink <id>`
+ * 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: "bunny-1",
+ *     region: "azure-arm::westus",
+ *     tags: [],
+ *     vpcId: vpc.id,
+ *     keepAssociatedVpc: true,
+ * });
+ * const privatelink = new cloudamqp.PrivatelinkAzure("privatelink", {
+ *     instanceId: instance.id,
+ *     approvedSubscriptions: ["XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"],
+ * });
+ * const firewallSettings = new cloudamqp.SecurityFirewall("firewall_settings", {
+ *     instanceId: instance.id,
+ *     rules: [
+ *         {
+ *             description: "Custom PrivateLink setup",
+ *             ip: vpc.subnet,
+ *             ports: [],
+ *             services: [
+ *                 "AMQP",
+ *                 "AMQPS",
+ *                 "HTTPS",
+ *                 "STREAM",
+ *                 "STREAM_SSL",
+ *             ],
+ *         },
+ *         {
+ *             description: "MGMT interface",
+ *             ip: "0.0.0.0/0",
+ *             ports: [],
+ *             services: ["HTTPS"],
+ *         },
+ *     ],
+ * }, {
+ *     dependsOn: [privatelink],
+ * });
  * ```
  *
- * `cloudamqp_privatelink_aws` can be imported using CloudAMQP instance identifier.
+ * </details>
+ *
+ * [CloudAMQP API list intances]: https://docs.cloudamqp.com/index.html#tag/instances/get/instances
+ * [CloudAMQP plans]: https://www.cloudamqp.com/plans.html
+ * [CloudAMQP PrivateLink]: https://www.cloudamqp.com/docs/cloudamqp-privatelink.html#azure-privatelink
+ * [cloudamqp.SecurityFirewall]: ./security_firewall.md
+ * [cloudamqp.VpcConnect]: ./vpc_connect.md
+ * [v1.29.0]: https://github.com/cloudamqp/terraform-provider-cloudamqp/releases/tag/v1.29.0
+ *
+ * ## Dependency
+ *
+ * This resource depends on CloudAMQP instance identifier, `cloudamqp_instance.instance.id`.
+ *
+ * ## Create PrivateLink with additional firewall rules
+ *
+ * To create a PrivateLink 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 PrivateLink resource
+ * `cloudamqp_privatelink_azure.privatelink`.
+ *
+ * Furthermore, since all firewall rules are overwritten, the otherwise automatically added rules for
+ * the PrivateLink also needs to be added.
  */
 class PrivatelinkAzure extends pulumi.CustomResource {
     /**

package/privatelinkAzure.js.map

@@ -1 +1 @@
-{"version":3,"file":"privatelinkAzure.js","sourceRoot":"","sources":["../privatelinkAzure.ts"],"names":[],"mappings":";AAAA,sEAAsE;AACtE,iFAAiF;;;AAEjF,yCAAyC;AACzC,yCAAyC;AAEzC;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAa,gBAAiB,SAAQ,MAAM,CAAC,cAAc;IACvD;;;;;;;;OAQG;IACI,MAAM,CAAC,GAAG,CAAC,IAAY,EAAE,EAA2B,EAAE,KAA6B,EAAE,IAAmC;QAC3H,OAAO,IAAI,gBAAgB,CAAC,IAAI,EAAO,KAAK,EAAE,EAAE,GAAG,IAAI,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IACvE,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,gBAAgB,CAAC,YAAY,CAAC;IACjE,CAAC;IAiDD,YAAY,IAAY,EAAE,WAA0D,EAAE,IAAmC;QACrH,IAAI,cAAc,GAAkB,EAAE,CAAC;QACvC,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;QAClB,IAAI,IAAI,CAAC,EAAE,EAAE;YACT,MAAM,KAAK,GAAG,WAAgD,CAAC;YAC/D,cAAc,CAAC,uBAAuB,CAAC,GAAG,KAAK,EAAE,qBAAqB,CAAC;YACvE,cAAc,CAAC,YAAY,CAAC,GAAG,KAAK,EAAE,UAAU,CAAC;YACjD,cAAc,CAAC,YAAY,CAAC,GAAG,KAAK,EAAE,UAAU,CAAC;YACjD,cAAc,CAAC,aAAa,CAAC,GAAG,KAAK,EAAE,WAAW,CAAC;YACnD,cAAc,CAAC,OAAO,CAAC,GAAG,KAAK,EAAE,KAAK,CAAC;YACvC,cAAc,CAAC,QAAQ,CAAC,GAAG,KAAK,EAAE,MAAM,CAAC;YACzC,cAAc,CAAC,SAAS,CAAC,GAAG,KAAK,EAAE,OAAO,CAAC;SAC9C;aAAM;YACH,MAAM,IAAI,GAAG,WAA+C,CAAC;YAC7D,IAAI,IAAI,EAAE,qBAAqB,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE;gBACxD,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;aACxE;YACD,IAAI,IAAI,EAAE,UAAU,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE;gBAC7C,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;aAC7D;YACD,cAAc,CAAC,uBAAuB,CAAC,GAAG,IAAI,EAAE,qBAAqB,CAAC;YACtE,cAAc,CAAC,YAAY,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC;YAChD,cAAc,CAAC,OAAO,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC;YACtC,cAAc,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC;YAC1C,cAAc,CAAC,YAAY,CAAC,GAAG,SAAS,CAAC,OAAO,CAAC;YACjD,cAAc,CAAC,aAAa,CAAC,GAAG,SAAS,CAAC,OAAO,CAAC;YAClD,cAAc,CAAC,QAAQ,CAAC,GAAG,SAAS,CAAC,OAAO,CAAC;SAChD;QACD,IAAI,GAAG,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,oBAAoB,EAAE,EAAE,IAAI,CAAC,CAAC;QACnE,KAAK,CAAC,gBAAgB,CAAC,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,CAAC,CAAC;IACrE,CAAC;;AAzGL,4CA0GC;AA5FG,gBAAgB;AACO,6BAAY,GAAG,mDAAmD,CAAC"}
+{"version":3,"file":"privatelinkAzure.js","sourceRoot":"","sources":["../privatelinkAzure.ts"],"names":[],"mappings":"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"}

package/provider.d.ts

@@ -44,6 +44,9 @@ export interface ProviderArgs {
      * Base URL to CloudAMQP Customer website
      */
     baseurl?: pulumi.Input<string>;
+    /**
+     * Skips destroying backend resources on 'terraform destroy'
+     */
     enableFasterInstanceDestroy?: pulumi.Input<boolean>;
 }
 export declare namespace Provider {