@pulumi/confluentcloud 2.84.0-alpha.1790573792 → 2.84.0

package/switchoverEndpoint.js

@@ -0,0 +1,144 @@
+"use strict";
+// *** WARNING: this file was generated by pulumi-language-nodejs. ***
+// *** Do not edit by hand unless you're certain you know what you are doing! ***
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SwitchoverEndpoint = void 0;
+const pulumi = __importStar(require("@pulumi/pulumi"));
+const utilities = __importStar(require("./utilities"));
+/**
+ * [![Preview](https://img.shields.io/badge/Lifecycle%20Stage-Preview-%2300afba)](https://docs.confluent.io/cloud/current/api.html#section/Versioning/API-Lifecycle-Policy)
+ *
+ * > **Warning:** Switchover is a preview feature. Preview features are introduced to gather customer feedback and may change based on that feedback. They are intended for evaluation and non-production use only, and are not covered by Confluent SLAs. Preview features may be discontinued at any time.
+ *
+ * `confluentcloud.SwitchoverEndpoint` provides a switchover endpoint resource that models a sticky disaster recovery (DR) endpoint bound to a `confluentcloud.SwitchoverPair`. The endpoint follows the pair's active member so that clients keep a stable connection target across a failover.
+ *
+ * Deleting an endpoint is asynchronous on the API side; the resource waits until the endpoint is gone before completing, so a `terraform destroy` that removes the endpoint and its pair together succeeds in one run (the pair cannot be deleted while an endpoint still exists).
+ *
+ * The side the endpoint points at is owned by the Switchover service and reported in the computed `target` attribute: it starts on the side matching the pair's active member, and a failover moves it without showing drift or forcing a replacement (which would hand clients a new hostname). Keep the endpoint in the same Terraform configuration as its pair. See the complete example.
+ *
+ * > **Note:** For PrivateLink Attachment (Enterprise) clusters, use `accessPointCrn` in the form `crn://confluent.cloud/organization=<org>/environment=<env>/gateway=<platt-id>/access-point=<plattc-id>`. For Dedicated clusters on a Confluent-managed network, use `networkCrn`.
+ *
+ * ## Example Usage
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as confluentcloud from "@pulumi/confluentcloud";
+ *
+ * const example = new confluentcloud.SwitchoverEndpoint("example", {
+ *     displayName: "prod-kafka-dr-endpoint",
+ *     parentResourceCrn: "crn://confluent.cloud/organization=org-abc/environment=env-abc123/switchover-pair=sw-abc123",
+ *     endpoints: [
+ *         {
+ *             name: "west-platt",
+ *             endpointFilter: {
+ *                 type: "private",
+ *                 networkCrn: "crn://confluent.cloud/organization=org-abc/environment=env-abc123/network=n-west01",
+ *             },
+ *         },
+ *         {
+ *             name: "east-platt",
+ *             endpointFilter: {
+ *                 type: "private",
+ *                 networkCrn: "crn://confluent.cloud/organization=org-abc/environment=env-def456/network=n-east01",
+ *             },
+ *         },
+ *     ],
+ * });
+ * ```
+ *
+ * ## Import
+ *
+ * > **Note:** `CONFLUENT_CLOUD_API_KEY` and `CONFLUENT_CLOUD_API_SECRET` environment variables must be set before importing a switchover endpoint.
+ *
+ * You can import a switchover endpoint by using the parent resource CRN and switchover endpoint ID, in the format `<Parent Resource CRN>/<Switchover Endpoint ID>`. The following example shows how to import a switchover endpoint:
+ *
+ * ```sh
+ * $ export CONFLUENT_CLOUD_API_KEY="<cloud_api_key>"
+ * $ export CONFLUENT_CLOUD_API_SECRET="<cloud_api_secret>"
+ * $ pulumi import confluentcloud:index/switchoverEndpoint:SwitchoverEndpoint example crn://confluent.cloud/organization=org-abc/environment=env-abc123/switchover-pair=sw-abc123/se-abc123
+ * ```
+ *
+ * > **Warning:** Do not forget to delete terminal command history afterwards for security purposes.
+ */
+class SwitchoverEndpoint extends pulumi.CustomResource {
+    /**
+     * Get an existing SwitchoverEndpoint resource's state with the given name, ID, and optional extra
+     * properties used to qualify the lookup.
+     *
+     * @param name The _unique_ name of the resulting resource.
+     * @param id The _unique_ provider ID of the resource to lookup.
+     * @param state Any extra arguments used during the lookup.
+     * @param opts Optional settings to control the behavior of the CustomResource.
+     */
+    static get(name, id, state, opts) {
+        return new SwitchoverEndpoint(name, state, { ...opts, id: id });
+    }
+    /** @internal */
+    static __pulumiType = 'confluentcloud:index/switchoverEndpoint:SwitchoverEndpoint';
+    /**
+     * Returns true if the given object is an instance of SwitchoverEndpoint.  This is designed to work even
+     * when multiple copies of the Pulumi SDK have been loaded into the same process.
+     */
+    static isInstance(obj) {
+        if (obj === undefined || obj === null) {
+            return false;
+        }
+        return obj['__pulumiType'] === SwitchoverEndpoint.__pulumiType;
+    }
+    constructor(name, argsOrState, opts) {
+        let resourceInputs = {};
+        opts = opts || {};
+        if (opts.id) {
+            const state = argsOrState;
+            resourceInputs["displayName"] = state?.displayName;
+            resourceInputs["endpoints"] = state?.endpoints;
+            resourceInputs["parentResourceCrn"] = state?.parentResourceCrn;
+            resourceInputs["phase"] = state?.phase;
+            resourceInputs["target"] = state?.target;
+        }
+        else {
+            const args = argsOrState;
+            if (args?.displayName === undefined && !opts.urn) {
+                throw new Error("Missing required property 'displayName'");
+            }
+            if (args?.endpoints === undefined && !opts.urn) {
+                throw new Error("Missing required property 'endpoints'");
+            }
+            if (args?.parentResourceCrn === undefined && !opts.urn) {
+                throw new Error("Missing required property 'parentResourceCrn'");
+            }
+            resourceInputs["displayName"] = args?.displayName;
+            resourceInputs["endpoints"] = args?.endpoints;
+            resourceInputs["parentResourceCrn"] = args?.parentResourceCrn;
+            resourceInputs["phase"] = undefined /*out*/;
+            resourceInputs["target"] = undefined /*out*/;
+        }
+        opts = pulumi.mergeOptions(utilities.resourceOptsDefaults(), opts);
+        super(SwitchoverEndpoint.__pulumiType, name, resourceInputs, opts);
+    }
+}
+exports.SwitchoverEndpoint = SwitchoverEndpoint;
+//# sourceMappingURL=switchoverEndpoint.js.map

package/switchoverEndpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"switchoverEndpoint.js","sourceRoot":"","sources":["../switchoverEndpoint.ts"],"names":[],"mappings":";AAAA,sEAAsE;AACtE,iFAAiF;;;;;;;;;;;;;;;;;;;;;;;;;;AAEjF,uDAAyC;AAGzC,uDAAyC;AAEzC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AACH,MAAa,kBAAmB,SAAQ,MAAM,CAAC,cAAc;IACzD;;;;;;;;OAQG;IACI,MAAM,CAAC,GAAG,CAAC,IAAY,EAAE,EAA2B,EAAE,KAA+B,EAAE,IAAmC;QAC7H,OAAO,IAAI,kBAAkB,CAAC,IAAI,EAAO,KAAK,EAAE,EAAE,GAAG,IAAI,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IACzE,CAAC;IAED,gBAAgB;IACT,MAAM,CAAU,YAAY,GAAG,4DAA4D,CAAC;IAEnG;;;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,kBAAkB,CAAC,YAAY,CAAC;IACnE,CAAC;IA+BD,YAAY,IAAY,EAAE,WAA8D,EAAE,IAAmC;QACzH,IAAI,cAAc,GAAkB,EAAE,CAAC;QACvC,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;QAClB,IAAI,IAAI,CAAC,EAAE,EAAE;YACT,MAAM,KAAK,GAAG,WAAkD,CAAC;YACjE,cAAc,CAAC,aAAa,CAAC,GAAG,KAAK,EAAE,WAAW,CAAC;YACnD,cAAc,CAAC,WAAW,CAAC,GAAG,KAAK,EAAE,SAAS,CAAC;YAC/C,cAAc,CAAC,mBAAmB,CAAC,GAAG,KAAK,EAAE,iBAAiB,CAAC;YAC/D,cAAc,CAAC,OAAO,CAAC,GAAG,KAAK,EAAE,KAAK,CAAC;YACvC,cAAc,CAAC,QAAQ,CAAC,GAAG,KAAK,EAAE,MAAM,CAAC;SAC5C;aAAM;YACH,MAAM,IAAI,GAAG,WAAiD,CAAC;YAC/D,IAAI,IAAI,EAAE,WAAW,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE;gBAC9C,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;aAC9D;YACD,IAAI,IAAI,EAAE,SAAS,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE;gBAC5C,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;aAC5D;YACD,IAAI,IAAI,EAAE,iBAAiB,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE;gBACpD,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;aACpE;YACD,cAAc,CAAC,aAAa,CAAC,GAAG,IAAI,EAAE,WAAW,CAAC;YAClD,cAAc,CAAC,WAAW,CAAC,GAAG,IAAI,EAAE,SAAS,CAAC;YAC9C,cAAc,CAAC,mBAAmB,CAAC,GAAG,IAAI,EAAE,iBAAiB,CAAC;YAC9D,cAAc,CAAC,OAAO,CAAC,GAAG,SAAS,CAAC,OAAO,CAAC;YAC5C,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,kBAAkB,CAAC,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,CAAC,CAAC;IACvE,CAAC;;AAtFL,gDAuFC"}

package/switchoverPair.d.ts

@@ -0,0 +1,161 @@
+import * as pulumi from "@pulumi/pulumi";
+import * as inputs from "./types/input";
+import * as outputs from "./types/output";
+/**
+ * [![Preview](https://img.shields.io/badge/Lifecycle%20Stage-Preview-%2300afba)](https://docs.confluent.io/cloud/current/api.html#section/Versioning/API-Lifecycle-Policy)
+ *
+ * > **Warning:** Switchover is a preview feature. Preview features are introduced to gather customer feedback and may change based on that feedback. They are intended for evaluation and non-production use only, and are not covered by Confluent SLAs. Preview features may be discontinued at any time.
+ *
+ * `confluentcloud.SwitchoverPair` provides a switchover pair resource that models a cluster-level disaster recovery (DR) pairing between two Kafka clusters (an active member and a passive member) on Confluent Cloud.
+ *
+ * Creating a pair is asynchronous on the API side; the resource waits until the pair reaches `READY_TO_FAILOVER` (up to 30 minutes) before completing, so a `confluentcloud.SwitchoverEndpoint` created in the same apply is not rejected while the pair is still `PROVISIONING`.
+ *
+ * `activeMember` chooses which member is active when the pair is created. After that the Switchover service owns it: a failover (the Switchover API's `:failover` operation, for example `confluent switchover pair failover <id> --active-member <name>`) changes the active member on the server, and the resource reads the current value back without showing drift or forcing a replacement. Editing `activeMember` in the configuration of an existing pair has no effect — the difference is suppressed, and no plan is produced. See the complete example.
+ *
+ * ## Example Usage
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as confluentcloud from "@pulumi/confluentcloud";
+ *
+ * const example = new confluentcloud.SwitchoverPair("example", {
+ *     displayName: "prod-kafka-dr",
+ *     activeMember: "west",
+ *     members: [
+ *         {
+ *             name: "west",
+ *             memberCrn: "crn://confluent.cloud/organization=org-abc/environment=env-abc123/cloud-cluster=lkc-west01",
+ *         },
+ *         {
+ *             name: "east",
+ *             memberCrn: "crn://confluent.cloud/organization=org-abc/environment=env-def456/cloud-cluster=lkc-east01",
+ *         },
+ *     ],
+ *     environmentCrn: "crn://confluent.cloud/organization=org-abc/environment=env-abc123",
+ * });
+ * ```
+ *
+ * ## Import
+ *
+ * > **Note:** `CONFLUENT_CLOUD_API_KEY` and `CONFLUENT_CLOUD_API_SECRET` environment variables must be set before importing a switchover pair.
+ *
+ * You can import a switchover pair by using the environment CRN and switchover pair ID, in the format `<Environment CRN>/<Switchover Pair ID>`. The following example shows how to import a switchover pair:
+ *
+ * ```sh
+ * $ export CONFLUENT_CLOUD_API_KEY="<cloud_api_key>"
+ * $ export CONFLUENT_CLOUD_API_SECRET="<cloud_api_secret>"
+ * $ pulumi import confluentcloud:index/switchoverPair:SwitchoverPair example crn://confluent.cloud/organization=org-abc/environment=env-abc123/sw-abc123
+ * ```
+ *
+ * On import, `activeMember` is read from the API and any value in your configuration is accepted without a planned replacement; use the currently active member (or `firstActive`) for clarity.
+ *
+ * > **Warning:** Do not forget to delete terminal command history afterwards for security purposes.
+ */
+export declare class SwitchoverPair extends pulumi.CustomResource {
+    /**
+     * Get an existing SwitchoverPair resource's state with the given name, ID, and optional extra
+     * properties used to qualify the lookup.
+     *
+     * @param name The _unique_ name of the resulting resource.
+     * @param id The _unique_ provider ID of the resource to lookup.
+     * @param state Any extra arguments used during the lookup.
+     * @param opts Optional settings to control the behavior of the CustomResource.
+     */
+    static get(name: string, id: pulumi.Input<pulumi.ID>, state?: SwitchoverPairState, opts?: pulumi.CustomResourceOptions): SwitchoverPair;
+    /**
+     * Returns true if the given object is an instance of SwitchoverPair.  This is designed to work even
+     * when multiple copies of the Pulumi SDK have been loaded into the same process.
+     */
+    static isInstance(obj: any): obj is SwitchoverPair;
+    /**
+     * The name of the member that is active when the pair is created; must match one of the `members[].name` values. After creation the Switchover service owns this value: it is read back from the API and always reflects the currently active member, and changing it in the configuration has no effect (no plan is produced). To change which member is active, trigger a failover through the Switchover API's `:failover` operation (for example with the Confluent CLI).
+     */
+    readonly activeMember: pulumi.Output<string>;
+    /**
+     * A human-readable name for the switchover pair.
+     */
+    readonly displayName: pulumi.Output<string>;
+    /**
+     * The CRN of the environment that owns this switchover pair, for example, `crn://confluent.cloud/organization=org-abc/environment=env-abc123`.
+     */
+    readonly environmentCrn: pulumi.Output<string>;
+    /**
+     * (Required String) The failover semantics most recently applied to this pair (`PLANNED`, `UNPLANNED`, or `RESTORE`). Empty until a failover has been triggered.
+     */
+    readonly failoverType: pulumi.Output<string>;
+    /**
+     * (Required String) The name of the member that was active when the pair was first created. Compare with `activeMember` to tell whether the pair is currently failed over.
+     */
+    readonly firstActive: pulumi.Output<string>;
+    /**
+     * (Required Configuration Block) In addition to the arguments above, each member exports the following:
+     */
+    readonly members: pulumi.Output<outputs.SwitchoverPairMember[]>;
+    /**
+     * (Required String) The lifecycle phase of the switchover pair, for example, `PROVISIONING`, `READY_TO_FAILOVER`, `UPDATING`, `READY_TO_RESTORE`, `FAILED`, or `DEPROVISIONING`.
+     */
+    readonly phase: pulumi.Output<string>;
+    /**
+     * Create a SwitchoverPair resource with the given unique name, arguments, and options.
+     *
+     * @param name The _unique_ name of the resource.
+     * @param args The arguments to use to populate this resource's properties.
+     * @param opts A bag of options that control this resource's behavior.
+     */
+    constructor(name: string, args: SwitchoverPairArgs, opts?: pulumi.CustomResourceOptions);
+}
+/**
+ * Input properties used for looking up and filtering SwitchoverPair resources.
+ */
+export interface SwitchoverPairState {
+    /**
+     * The name of the member that is active when the pair is created; must match one of the `members[].name` values. After creation the Switchover service owns this value: it is read back from the API and always reflects the currently active member, and changing it in the configuration has no effect (no plan is produced). To change which member is active, trigger a failover through the Switchover API's `:failover` operation (for example with the Confluent CLI).
+     */
+    activeMember?: pulumi.Input<string | undefined>;
+    /**
+     * A human-readable name for the switchover pair.
+     */
+    displayName?: pulumi.Input<string | undefined>;
+    /**
+     * The CRN of the environment that owns this switchover pair, for example, `crn://confluent.cloud/organization=org-abc/environment=env-abc123`.
+     */
+    environmentCrn?: pulumi.Input<string | undefined>;
+    /**
+     * (Required String) The failover semantics most recently applied to this pair (`PLANNED`, `UNPLANNED`, or `RESTORE`). Empty until a failover has been triggered.
+     */
+    failoverType?: pulumi.Input<string | undefined>;
+    /**
+     * (Required String) The name of the member that was active when the pair was first created. Compare with `activeMember` to tell whether the pair is currently failed over.
+     */
+    firstActive?: pulumi.Input<string | undefined>;
+    /**
+     * (Required Configuration Block) In addition to the arguments above, each member exports the following:
+     */
+    members?: pulumi.Input<pulumi.Input<inputs.SwitchoverPairMember>[] | undefined>;
+    /**
+     * (Required String) The lifecycle phase of the switchover pair, for example, `PROVISIONING`, `READY_TO_FAILOVER`, `UPDATING`, `READY_TO_RESTORE`, `FAILED`, or `DEPROVISIONING`.
+     */
+    phase?: pulumi.Input<string | undefined>;
+}
+/**
+ * The set of arguments for constructing a SwitchoverPair resource.
+ */
+export interface SwitchoverPairArgs {
+    /**
+     * The name of the member that is active when the pair is created; must match one of the `members[].name` values. After creation the Switchover service owns this value: it is read back from the API and always reflects the currently active member, and changing it in the configuration has no effect (no plan is produced). To change which member is active, trigger a failover through the Switchover API's `:failover` operation (for example with the Confluent CLI).
+     */
+    activeMember: pulumi.Input<string>;
+    /**
+     * A human-readable name for the switchover pair.
+     */
+    displayName: pulumi.Input<string>;
+    /**
+     * The CRN of the environment that owns this switchover pair, for example, `crn://confluent.cloud/organization=org-abc/environment=env-abc123`.
+     */
+    environmentCrn: pulumi.Input<string>;
+    /**
+     * (Required Configuration Block) In addition to the arguments above, each member exports the following:
+     */
+    members: pulumi.Input<pulumi.Input<inputs.SwitchoverPairMember>[]>;
+}
+//# sourceMappingURL=switchoverPair.d.ts.map

package/switchoverPair.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"switchoverPair.d.ts","sourceRoot":"","sources":["../switchoverPair.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,MAAM,MAAM,gBAAgB,CAAC;AACzC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAG1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,qBAAa,cAAe,SAAQ,MAAM,CAAC,cAAc;IACrD;;;;;;;;OAQG;WACW,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,mBAAmB,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,qBAAqB,GAAG,cAAc;IAO9I;;;OAGG;WACW,UAAU,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,IAAI,cAAc;IAOzD;;OAEG;IACH,SAAwB,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC5D;;OAEG;IACH,SAAwB,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC3D;;OAEG;IACH,SAAwB,cAAc,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC9D;;OAEG;IACH,SAAgC,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACpE;;OAEG;IACH,SAAgC,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACnE;;OAEG;IACH,SAAwB,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAAC;IAC/E;;OAEG;IACH,SAAgC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAE7D;;;;;;OAMG;gBACS,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,qBAAqB;CAsC1F;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAChD;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAC/C;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAClD;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAChD;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAC/C;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,oBAAoB,CAAC,EAAE,GAAG,SAAS,CAAC,CAAC;IAChF;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;CAC5C;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACnC;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAClC;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACrC;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,oBAAoB,CAAC,EAAE,CAAC,CAAC;CACtE"}

package/switchoverPair.js

@@ -0,0 +1,146 @@
+"use strict";
+// *** WARNING: this file was generated by pulumi-language-nodejs. ***
+// *** Do not edit by hand unless you're certain you know what you are doing! ***
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SwitchoverPair = void 0;
+const pulumi = __importStar(require("@pulumi/pulumi"));
+const utilities = __importStar(require("./utilities"));
+/**
+ * [![Preview](https://img.shields.io/badge/Lifecycle%20Stage-Preview-%2300afba)](https://docs.confluent.io/cloud/current/api.html#section/Versioning/API-Lifecycle-Policy)
+ *
+ * > **Warning:** Switchover is a preview feature. Preview features are introduced to gather customer feedback and may change based on that feedback. They are intended for evaluation and non-production use only, and are not covered by Confluent SLAs. Preview features may be discontinued at any time.
+ *
+ * `confluentcloud.SwitchoverPair` provides a switchover pair resource that models a cluster-level disaster recovery (DR) pairing between two Kafka clusters (an active member and a passive member) on Confluent Cloud.
+ *
+ * Creating a pair is asynchronous on the API side; the resource waits until the pair reaches `READY_TO_FAILOVER` (up to 30 minutes) before completing, so a `confluentcloud.SwitchoverEndpoint` created in the same apply is not rejected while the pair is still `PROVISIONING`.
+ *
+ * `activeMember` chooses which member is active when the pair is created. After that the Switchover service owns it: a failover (the Switchover API's `:failover` operation, for example `confluent switchover pair failover <id> --active-member <name>`) changes the active member on the server, and the resource reads the current value back without showing drift or forcing a replacement. Editing `activeMember` in the configuration of an existing pair has no effect — the difference is suppressed, and no plan is produced. See the complete example.
+ *
+ * ## Example Usage
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as confluentcloud from "@pulumi/confluentcloud";
+ *
+ * const example = new confluentcloud.SwitchoverPair("example", {
+ *     displayName: "prod-kafka-dr",
+ *     activeMember: "west",
+ *     members: [
+ *         {
+ *             name: "west",
+ *             memberCrn: "crn://confluent.cloud/organization=org-abc/environment=env-abc123/cloud-cluster=lkc-west01",
+ *         },
+ *         {
+ *             name: "east",
+ *             memberCrn: "crn://confluent.cloud/organization=org-abc/environment=env-def456/cloud-cluster=lkc-east01",
+ *         },
+ *     ],
+ *     environmentCrn: "crn://confluent.cloud/organization=org-abc/environment=env-abc123",
+ * });
+ * ```
+ *
+ * ## Import
+ *
+ * > **Note:** `CONFLUENT_CLOUD_API_KEY` and `CONFLUENT_CLOUD_API_SECRET` environment variables must be set before importing a switchover pair.
+ *
+ * You can import a switchover pair by using the environment CRN and switchover pair ID, in the format `<Environment CRN>/<Switchover Pair ID>`. The following example shows how to import a switchover pair:
+ *
+ * ```sh
+ * $ export CONFLUENT_CLOUD_API_KEY="<cloud_api_key>"
+ * $ export CONFLUENT_CLOUD_API_SECRET="<cloud_api_secret>"
+ * $ pulumi import confluentcloud:index/switchoverPair:SwitchoverPair example crn://confluent.cloud/organization=org-abc/environment=env-abc123/sw-abc123
+ * ```
+ *
+ * On import, `activeMember` is read from the API and any value in your configuration is accepted without a planned replacement; use the currently active member (or `firstActive`) for clarity.
+ *
+ * > **Warning:** Do not forget to delete terminal command history afterwards for security purposes.
+ */
+class SwitchoverPair extends pulumi.CustomResource {
+    /**
+     * Get an existing SwitchoverPair resource's state with the given name, ID, and optional extra
+     * properties used to qualify the lookup.
+     *
+     * @param name The _unique_ name of the resulting resource.
+     * @param id The _unique_ provider ID of the resource to lookup.
+     * @param state Any extra arguments used during the lookup.
+     * @param opts Optional settings to control the behavior of the CustomResource.
+     */
+    static get(name, id, state, opts) {
+        return new SwitchoverPair(name, state, { ...opts, id: id });
+    }
+    /** @internal */
+    static __pulumiType = 'confluentcloud:index/switchoverPair:SwitchoverPair';
+    /**
+     * Returns true if the given object is an instance of SwitchoverPair.  This is designed to work even
+     * when multiple copies of the Pulumi SDK have been loaded into the same process.
+     */
+    static isInstance(obj) {
+        if (obj === undefined || obj === null) {
+            return false;
+        }
+        return obj['__pulumiType'] === SwitchoverPair.__pulumiType;
+    }
+    constructor(name, argsOrState, opts) {
+        let resourceInputs = {};
+        opts = opts || {};
+        if (opts.id) {
+            const state = argsOrState;
+            resourceInputs["activeMember"] = state?.activeMember;
+            resourceInputs["displayName"] = state?.displayName;
+            resourceInputs["environmentCrn"] = state?.environmentCrn;
+            resourceInputs["failoverType"] = state?.failoverType;
+            resourceInputs["firstActive"] = state?.firstActive;
+            resourceInputs["members"] = state?.members;
+            resourceInputs["phase"] = state?.phase;
+        }
+        else {
+            const args = argsOrState;
+            if (args?.activeMember === undefined && !opts.urn) {
+                throw new Error("Missing required property 'activeMember'");
+            }
+            if (args?.displayName === undefined && !opts.urn) {
+                throw new Error("Missing required property 'displayName'");
+            }
+            if (args?.environmentCrn === undefined && !opts.urn) {
+                throw new Error("Missing required property 'environmentCrn'");
+            }
+            if (args?.members === undefined && !opts.urn) {
+                throw new Error("Missing required property 'members'");
+            }
+            resourceInputs["activeMember"] = args?.activeMember;
+            resourceInputs["displayName"] = args?.displayName;
+            resourceInputs["environmentCrn"] = args?.environmentCrn;
+            resourceInputs["members"] = args?.members;
+            resourceInputs["failoverType"] = undefined /*out*/;
+            resourceInputs["firstActive"] = undefined /*out*/;
+            resourceInputs["phase"] = undefined /*out*/;
+        }
+        opts = pulumi.mergeOptions(utilities.resourceOptsDefaults(), opts);
+        super(SwitchoverPair.__pulumiType, name, resourceInputs, opts);
+    }
+}
+exports.SwitchoverPair = SwitchoverPair;
+//# sourceMappingURL=switchoverPair.js.map

package/switchoverPair.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"switchoverPair.js","sourceRoot":"","sources":["../switchoverPair.ts"],"names":[],"mappings":"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"}

package/types/input.d.ts

@@ -3734,6 +3734,64 @@ export interface SubjectModeSchemaRegistryCluster {
      */
     id: pulumi.Input<string>;
 }
+export interface SwitchoverEndpointEndpoint {
+    /**
+     * (Required String) The cloud provider this endpoint resolves to.
+     */
+    cloud?: pulumi.Input<string | undefined>;
+    /**
+     * (Required String) The connection type this endpoint resolves to.
+     */
+    connectionType?: pulumi.Input<string | undefined>;
+    /**
+     * Filter criteria that identify a network endpoint for this side of the pair. Supports the following:
+     */
+    endpointFilter: pulumi.Input<inputs.SwitchoverEndpointEndpointEndpointFilter>;
+    /**
+     * (Required String) The resolved hostname for this endpoint.
+     */
+    hostname?: pulumi.Input<string | undefined>;
+    /**
+     * A logical name for this endpoint side (for example, `west-platt`), unique within the resource.
+     */
+    name: pulumi.Input<string>;
+    /**
+     * (Required String) The cloud region this endpoint resolves to.
+     */
+    region?: pulumi.Input<string | undefined>;
+}
+export interface SwitchoverEndpointEndpointEndpointFilter {
+    /**
+     * The CRN of the network access point, for access-point (PNI) endpoints.
+     */
+    accessPointCrn?: pulumi.Input<string | undefined>;
+    /**
+     * The CRN of the network, for network-based private endpoints.
+     */
+    networkCrn?: pulumi.Input<string | undefined>;
+    /**
+     * Whether the endpoint is `private` or `public`.
+     */
+    type: pulumi.Input<string>;
+}
+export interface SwitchoverPairMember {
+    /**
+     * (Required String) The cloud provider of the member's cluster.
+     */
+    cloud?: pulumi.Input<string | undefined>;
+    /**
+     * The CRN of the cluster this member represents, for example, `crn://confluent.cloud/organization=org-abc/environment=env-abc123/cloud-cluster=lkc-west01`. The CRN carries the member's own environment, so the two members may live in different environments.
+     */
+    memberCrn: pulumi.Input<string>;
+    /**
+     * A logical name for this member (for example, `west` or `east`), unique within the pair.
+     */
+    name: pulumi.Input<string>;
+    /**
+     * (Required String) The cloud region of the member's cluster.
+     */
+    region?: pulumi.Input<string | undefined>;
+}
 export interface TableflowTopicAzureDataLakeStorageGen2 {
     /**
      * The container name.