@pulumi/confluentcloud 1.32.0 → 1.33.0-alpha.1706307303

package/connector.d.ts

@@ -2,6 +2,176 @@ import * as pulumi from "@pulumi/pulumi";
 import * as inputs from "./types/input";
 import * as outputs from "./types/output";
 /**
+ * ## Example Usage
+ * ### Example Managed [Datagen Source Connector](https://docs.confluent.io/cloud/current/connectors/cc-datagen-source.html) that uses a service account to communicate with your Kafka cluster
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as confluentcloud from "@pulumi/confluentcloud";
+ *
+ * const source = new confluentcloud.Connector("source", {
+ *     environment: {
+ *         id: confluent_environment.staging.id,
+ *     },
+ *     kafkaCluster: {
+ *         id: confluent_kafka_cluster.basic.id,
+ *     },
+ *     configSensitive: {},
+ *     configNonsensitive: {
+ *         "connector.class": "DatagenSource",
+ *         name: "DatagenSourceConnector_0",
+ *         "kafka.auth.mode": "SERVICE_ACCOUNT",
+ *         "kafka.service.account.id": confluent_service_account["app-connector"].id,
+ *         "kafka.topic": confluent_kafka_topic.orders.topic_name,
+ *         "output.data.format": "JSON",
+ *         quickstart: "ORDERS",
+ *         "tasks.max": "1",
+ *     },
+ * }, {
+ *     dependsOn: [
+ *         confluent_kafka_acl["app-connector-describe-on-cluster"],
+ *         confluent_kafka_acl["app-connector-write-on-target-topic"],
+ *         confluent_kafka_acl["app-connector-create-on-data-preview-topics"],
+ *         confluent_kafka_acl["app-connector-write-on-data-preview-topics"],
+ *     ],
+ * });
+ * ```
+ * ### Example Managed [Amazon S3 Sink Connector](https://docs.confluent.io/cloud/current/connectors/cc-s3-sink.html) that uses a service account to communicate with your Kafka cluster
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as confluentcloud from "@pulumi/confluentcloud";
+ *
+ * const sink = new confluentcloud.Connector("sink", {
+ *     environment: {
+ *         id: confluent_environment.staging.id,
+ *     },
+ *     kafkaCluster: {
+ *         id: confluent_kafka_cluster.basic.id,
+ *     },
+ *     configSensitive: {
+ *         "aws.access.key.id": "***REDACTED***",
+ *         "aws.secret.access.key": "***REDACTED***",
+ *     },
+ *     configNonsensitive: {
+ *         topics: confluent_kafka_topic.orders.topic_name,
+ *         "input.data.format": "JSON",
+ *         "connector.class": "S3_SINK",
+ *         name: "S3_SINKConnector_0",
+ *         "kafka.auth.mode": "SERVICE_ACCOUNT",
+ *         "kafka.service.account.id": confluent_service_account["app-connector"].id,
+ *         "s3.bucket.name": "<s3-bucket-name>",
+ *         "output.data.format": "JSON",
+ *         "time.interval": "DAILY",
+ *         "flush.size": "1000",
+ *         "tasks.max": "1",
+ *     },
+ * }, {
+ *     dependsOn: [
+ *         confluent_kafka_acl["app-connector-describe-on-cluster"],
+ *         confluent_kafka_acl["app-connector-read-on-target-topic"],
+ *         confluent_kafka_acl["app-connector-create-on-dlq-lcc-topics"],
+ *         confluent_kafka_acl["app-connector-write-on-dlq-lcc-topics"],
+ *         confluent_kafka_acl["app-connector-create-on-success-lcc-topics"],
+ *         confluent_kafka_acl["app-connector-write-on-success-lcc-topics"],
+ *         confluent_kafka_acl["app-connector-create-on-error-lcc-topics"],
+ *         confluent_kafka_acl["app-connector-write-on-error-lcc-topics"],
+ *         confluent_kafka_acl["app-connector-read-on-connect-lcc-group"],
+ *     ],
+ * });
+ * ```
+ * ### Example Managed [Amazon DynamoDB Connector](https://docs.confluent.io/cloud/current/connectors/cc-amazon-dynamo-db-sink.html) that uses a service account to communicate with your Kafka cluster
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as confluentcloud from "@pulumi/confluentcloud";
+ *
+ * const sink = new confluentcloud.Connector("sink", {
+ *     environment: {
+ *         id: confluent_environment.staging.id,
+ *     },
+ *     kafkaCluster: {
+ *         id: confluent_kafka_cluster.basic.id,
+ *     },
+ *     configSensitive: {
+ *         "aws.access.key.id": "***REDACTED***",
+ *         "aws.secret.access.key": "***REDACTED***",
+ *     },
+ *     configNonsensitive: {
+ *         topics: confluent_kafka_topic.orders.topic_name,
+ *         "input.data.format": "JSON",
+ *         "connector.class": "DynamoDbSink",
+ *         name: "DynamoDbSinkConnector_0",
+ *         "kafka.auth.mode": "SERVICE_ACCOUNT",
+ *         "kafka.service.account.id": confluent_service_account["app-connector"].id,
+ *         "aws.dynamodb.pk.hash": "value.userid",
+ *         "aws.dynamodb.pk.sort": "value.pageid",
+ *         "tasks.max": "1",
+ *     },
+ * }, {
+ *     dependsOn: [
+ *         confluent_kafka_acl["app-connector-describe-on-cluster"],
+ *         confluent_kafka_acl["app-connector-read-on-target-topic"],
+ *         confluent_kafka_acl["app-connector-create-on-dlq-lcc-topics"],
+ *         confluent_kafka_acl["app-connector-write-on-dlq-lcc-topics"],
+ *         confluent_kafka_acl["app-connector-create-on-success-lcc-topics"],
+ *         confluent_kafka_acl["app-connector-write-on-success-lcc-topics"],
+ *         confluent_kafka_acl["app-connector-create-on-error-lcc-topics"],
+ *         confluent_kafka_acl["app-connector-write-on-error-lcc-topics"],
+ *         confluent_kafka_acl["app-connector-read-on-connect-lcc-group"],
+ *     ],
+ * });
+ * ```
+ * ### Example Custom [Datagen Source Connector](https://www.confluent.io/hub/confluentinc/kafka-connect-datagen) that uses a Kafka API Key to communicate with your Kafka cluster
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as confluentcloud from "@pulumi/confluentcloud";
+ *
+ * const source = new confluentcloud.Connector("source", {
+ *     environment: {
+ *         id: confluent_environment.staging.id,
+ *     },
+ *     kafkaCluster: {
+ *         id: confluent_kafka_cluster.basic.id,
+ *     },
+ *     configSensitive: {
+ *         "kafka.api.key": "***REDACTED***",
+ *         "kafka.api.secret": "***REDACTED***",
+ *     },
+ *     configNonsensitive: {
+ *         "confluent.connector.type": "CUSTOM",
+ *         "connector.class": confluent_custom_connector_plugin.source.connector_class,
+ *         name: "DatagenConnectorExampleName",
+ *         "kafka.auth.mode": "KAFKA_API_KEY",
+ *         "kafka.topic": confluent_kafka_topic.orders.topic_name,
+ *         "output.data.format": "JSON",
+ *         quickstart: "ORDERS",
+ *         "confluent.custom.plugin.id": confluent_custom_connector_plugin.source.id,
+ *         "min.interval": "1000",
+ *         "max.interval": "2000",
+ *         "tasks.max": "1",
+ *     },
+ * }, {
+ *     dependsOn: [confluent_role_binding["app-manager-kafka-cluster-admin"]],
+ * });
+ * ```
+ *
+ * > **Note:** Custom connectors are available in **Preview** for early adopters. Preview features are introduced to gather customer feedback. This feature should be used only for evaluation and non-production testing purposes or to provide feedback to Confluent, particularly as it becomes more widely available in follow-on editions.\
+ * **Preview** features are intended for evaluation use in development and testing environments only, and not for production use. The warranty, SLA, and Support Services provisions of your agreement with Confluent do not apply to Preview features. Preview features are considered to be a Proof of Concept as defined in the Confluent Cloud Terms of Service. Confluent may discontinue providing preview releases of the Preview features at any time in Confluent’s sole discretion.
+ * ## Getting Started
+ *
+ * The following end-to-end examples might help to get started with `confluentcloud.Connector` resource:
+ * * `s3-sink-connector`
+ * * `snowflake-sink-connector`
+ * * `managed-datagen-source-connector`
+ * * `elasticsearch-sink-connector`
+ * * `dynamo-db-sink-connector`
+ * * `mongo-db-source-connector`
+ * * `mongo-db-sink-connector`
+ * * `sql-server-cdc-debezium-source-connector`
+ * * `postgre-sql-cdc-debezium-source-connector`
+ * * `custom-datagen-source-connector`
+ *
+ * > **Note:** Certain connectors require additional ACL entries. See [Additional ACL entries](https://docs.confluent.io/cloud/current/connectors/service-account.html#additional-acl-entries) for more details.
+ *
  * ## Import
  *
  * You can import a connector by using Environment ID, Kafka cluster ID, and connector's name, in the format `<Environment ID>/<Kafka cluster ID>/<Connector name>`, for example$ export CONFLUENT_CLOUD_API_KEY="<cloud_api_key>" $ export CONFLUENT_CLOUD_API_SECRET="<cloud_api_secret>"
@@ -43,6 +213,13 @@ export declare class Connector extends pulumi.CustomResource {
      */
     readonly environment: pulumi.Output<outputs.ConnectorEnvironment>;
     readonly kafkaCluster: pulumi.Output<outputs.ConnectorKafkaCluster>;
+    /**
+     * The status of the connector (one of `"NONE"`, `"PROVISIONING"`, `"RUNNING"`, `"DEGRADED"`, `"FAILED"`, `"PAUSED"`, `"DELETED"`). Pausing (`"RUNNING" > "PAUSED"`) and resuming (`"PAUSED" > "RUNNING"`) a connector is supported via an update operation.
+     *
+     * > **Note:** If there are no _sensitive_ configuration settings for your connector, set `configSensitive = {}` explicitly.
+     *
+     * > **Note:** You may declare sensitive variables for secrets `configSensitive` block and set them using environment variables (for example, `export TF_VAR_aws_access_key_id="foo"`).
+     */
     readonly status: pulumi.Output<string>;
     /**
      * Create a Connector resource with the given unique name, arguments, and options.
@@ -74,6 +251,13 @@ export interface ConnectorState {
      */
     environment?: pulumi.Input<inputs.ConnectorEnvironment>;
     kafkaCluster?: pulumi.Input<inputs.ConnectorKafkaCluster>;
+    /**
+     * The status of the connector (one of `"NONE"`, `"PROVISIONING"`, `"RUNNING"`, `"DEGRADED"`, `"FAILED"`, `"PAUSED"`, `"DELETED"`). Pausing (`"RUNNING" > "PAUSED"`) and resuming (`"PAUSED" > "RUNNING"`) a connector is supported via an update operation.
+     *
+     * > **Note:** If there are no _sensitive_ configuration settings for your connector, set `configSensitive = {}` explicitly.
+     *
+     * > **Note:** You may declare sensitive variables for secrets `configSensitive` block and set them using environment variables (for example, `export TF_VAR_aws_access_key_id="foo"`).
+     */
     status?: pulumi.Input<string>;
 }
 /**
@@ -97,5 +281,12 @@ export interface ConnectorArgs {
      */
     environment: pulumi.Input<inputs.ConnectorEnvironment>;
     kafkaCluster: pulumi.Input<inputs.ConnectorKafkaCluster>;
+    /**
+     * The status of the connector (one of `"NONE"`, `"PROVISIONING"`, `"RUNNING"`, `"DEGRADED"`, `"FAILED"`, `"PAUSED"`, `"DELETED"`). Pausing (`"RUNNING" > "PAUSED"`) and resuming (`"PAUSED" > "RUNNING"`) a connector is supported via an update operation.
+     *
+     * > **Note:** If there are no _sensitive_ configuration settings for your connector, set `configSensitive = {}` explicitly.
+     *
+     * > **Note:** You may declare sensitive variables for secrets `configSensitive` block and set them using environment variables (for example, `export TF_VAR_aws_access_key_id="foo"`).
+     */
     status?: pulumi.Input<string>;
 }

package/connector.js

@@ -6,6 +6,176 @@ exports.Connector = void 0;
 const pulumi = require("@pulumi/pulumi");
 const utilities = require("./utilities");
 /**
+ * ## Example Usage
+ * ### Example Managed [Datagen Source Connector](https://docs.confluent.io/cloud/current/connectors/cc-datagen-source.html) that uses a service account to communicate with your Kafka cluster
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as confluentcloud from "@pulumi/confluentcloud";
+ *
+ * const source = new confluentcloud.Connector("source", {
+ *     environment: {
+ *         id: confluent_environment.staging.id,
+ *     },
+ *     kafkaCluster: {
+ *         id: confluent_kafka_cluster.basic.id,
+ *     },
+ *     configSensitive: {},
+ *     configNonsensitive: {
+ *         "connector.class": "DatagenSource",
+ *         name: "DatagenSourceConnector_0",
+ *         "kafka.auth.mode": "SERVICE_ACCOUNT",
+ *         "kafka.service.account.id": confluent_service_account["app-connector"].id,
+ *         "kafka.topic": confluent_kafka_topic.orders.topic_name,
+ *         "output.data.format": "JSON",
+ *         quickstart: "ORDERS",
+ *         "tasks.max": "1",
+ *     },
+ * }, {
+ *     dependsOn: [
+ *         confluent_kafka_acl["app-connector-describe-on-cluster"],
+ *         confluent_kafka_acl["app-connector-write-on-target-topic"],
+ *         confluent_kafka_acl["app-connector-create-on-data-preview-topics"],
+ *         confluent_kafka_acl["app-connector-write-on-data-preview-topics"],
+ *     ],
+ * });
+ * ```
+ * ### Example Managed [Amazon S3 Sink Connector](https://docs.confluent.io/cloud/current/connectors/cc-s3-sink.html) that uses a service account to communicate with your Kafka cluster
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as confluentcloud from "@pulumi/confluentcloud";
+ *
+ * const sink = new confluentcloud.Connector("sink", {
+ *     environment: {
+ *         id: confluent_environment.staging.id,
+ *     },
+ *     kafkaCluster: {
+ *         id: confluent_kafka_cluster.basic.id,
+ *     },
+ *     configSensitive: {
+ *         "aws.access.key.id": "***REDACTED***",
+ *         "aws.secret.access.key": "***REDACTED***",
+ *     },
+ *     configNonsensitive: {
+ *         topics: confluent_kafka_topic.orders.topic_name,
+ *         "input.data.format": "JSON",
+ *         "connector.class": "S3_SINK",
+ *         name: "S3_SINKConnector_0",
+ *         "kafka.auth.mode": "SERVICE_ACCOUNT",
+ *         "kafka.service.account.id": confluent_service_account["app-connector"].id,
+ *         "s3.bucket.name": "<s3-bucket-name>",
+ *         "output.data.format": "JSON",
+ *         "time.interval": "DAILY",
+ *         "flush.size": "1000",
+ *         "tasks.max": "1",
+ *     },
+ * }, {
+ *     dependsOn: [
+ *         confluent_kafka_acl["app-connector-describe-on-cluster"],
+ *         confluent_kafka_acl["app-connector-read-on-target-topic"],
+ *         confluent_kafka_acl["app-connector-create-on-dlq-lcc-topics"],
+ *         confluent_kafka_acl["app-connector-write-on-dlq-lcc-topics"],
+ *         confluent_kafka_acl["app-connector-create-on-success-lcc-topics"],
+ *         confluent_kafka_acl["app-connector-write-on-success-lcc-topics"],
+ *         confluent_kafka_acl["app-connector-create-on-error-lcc-topics"],
+ *         confluent_kafka_acl["app-connector-write-on-error-lcc-topics"],
+ *         confluent_kafka_acl["app-connector-read-on-connect-lcc-group"],
+ *     ],
+ * });
+ * ```
+ * ### Example Managed [Amazon DynamoDB Connector](https://docs.confluent.io/cloud/current/connectors/cc-amazon-dynamo-db-sink.html) that uses a service account to communicate with your Kafka cluster
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as confluentcloud from "@pulumi/confluentcloud";
+ *
+ * const sink = new confluentcloud.Connector("sink", {
+ *     environment: {
+ *         id: confluent_environment.staging.id,
+ *     },
+ *     kafkaCluster: {
+ *         id: confluent_kafka_cluster.basic.id,
+ *     },
+ *     configSensitive: {
+ *         "aws.access.key.id": "***REDACTED***",
+ *         "aws.secret.access.key": "***REDACTED***",
+ *     },
+ *     configNonsensitive: {
+ *         topics: confluent_kafka_topic.orders.topic_name,
+ *         "input.data.format": "JSON",
+ *         "connector.class": "DynamoDbSink",
+ *         name: "DynamoDbSinkConnector_0",
+ *         "kafka.auth.mode": "SERVICE_ACCOUNT",
+ *         "kafka.service.account.id": confluent_service_account["app-connector"].id,
+ *         "aws.dynamodb.pk.hash": "value.userid",
+ *         "aws.dynamodb.pk.sort": "value.pageid",
+ *         "tasks.max": "1",
+ *     },
+ * }, {
+ *     dependsOn: [
+ *         confluent_kafka_acl["app-connector-describe-on-cluster"],
+ *         confluent_kafka_acl["app-connector-read-on-target-topic"],
+ *         confluent_kafka_acl["app-connector-create-on-dlq-lcc-topics"],
+ *         confluent_kafka_acl["app-connector-write-on-dlq-lcc-topics"],
+ *         confluent_kafka_acl["app-connector-create-on-success-lcc-topics"],
+ *         confluent_kafka_acl["app-connector-write-on-success-lcc-topics"],
+ *         confluent_kafka_acl["app-connector-create-on-error-lcc-topics"],
+ *         confluent_kafka_acl["app-connector-write-on-error-lcc-topics"],
+ *         confluent_kafka_acl["app-connector-read-on-connect-lcc-group"],
+ *     ],
+ * });
+ * ```
+ * ### Example Custom [Datagen Source Connector](https://www.confluent.io/hub/confluentinc/kafka-connect-datagen) that uses a Kafka API Key to communicate with your Kafka cluster
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as confluentcloud from "@pulumi/confluentcloud";
+ *
+ * const source = new confluentcloud.Connector("source", {
+ *     environment: {
+ *         id: confluent_environment.staging.id,
+ *     },
+ *     kafkaCluster: {
+ *         id: confluent_kafka_cluster.basic.id,
+ *     },
+ *     configSensitive: {
+ *         "kafka.api.key": "***REDACTED***",
+ *         "kafka.api.secret": "***REDACTED***",
+ *     },
+ *     configNonsensitive: {
+ *         "confluent.connector.type": "CUSTOM",
+ *         "connector.class": confluent_custom_connector_plugin.source.connector_class,
+ *         name: "DatagenConnectorExampleName",
+ *         "kafka.auth.mode": "KAFKA_API_KEY",
+ *         "kafka.topic": confluent_kafka_topic.orders.topic_name,
+ *         "output.data.format": "JSON",
+ *         quickstart: "ORDERS",
+ *         "confluent.custom.plugin.id": confluent_custom_connector_plugin.source.id,
+ *         "min.interval": "1000",
+ *         "max.interval": "2000",
+ *         "tasks.max": "1",
+ *     },
+ * }, {
+ *     dependsOn: [confluent_role_binding["app-manager-kafka-cluster-admin"]],
+ * });
+ * ```
+ *
+ * > **Note:** Custom connectors are available in **Preview** for early adopters. Preview features are introduced to gather customer feedback. This feature should be used only for evaluation and non-production testing purposes or to provide feedback to Confluent, particularly as it becomes more widely available in follow-on editions.\
+ * **Preview** features are intended for evaluation use in development and testing environments only, and not for production use. The warranty, SLA, and Support Services provisions of your agreement with Confluent do not apply to Preview features. Preview features are considered to be a Proof of Concept as defined in the Confluent Cloud Terms of Service. Confluent may discontinue providing preview releases of the Preview features at any time in Confluent’s sole discretion.
+ * ## Getting Started
+ *
+ * The following end-to-end examples might help to get started with `confluentcloud.Connector` resource:
+ * * `s3-sink-connector`
+ * * `snowflake-sink-connector`
+ * * `managed-datagen-source-connector`
+ * * `elasticsearch-sink-connector`
+ * * `dynamo-db-sink-connector`
+ * * `mongo-db-source-connector`
+ * * `mongo-db-sink-connector`
+ * * `sql-server-cdc-debezium-source-connector`
+ * * `postgre-sql-cdc-debezium-source-connector`
+ * * `custom-datagen-source-connector`
+ *
+ * > **Note:** Certain connectors require additional ACL entries. See [Additional ACL entries](https://docs.confluent.io/cloud/current/connectors/service-account.html#additional-acl-entries) for more details.
+ *
  * ## Import
  *
  * You can import a connector by using Environment ID, Kafka cluster ID, and connector's name, in the format `<Environment ID>/<Kafka cluster ID>/<Connector name>`, for example$ export CONFLUENT_CLOUD_API_KEY="<cloud_api_key>" $ export CONFLUENT_CLOUD_API_SECRET="<cloud_api_secret>"

package/connector.js.map

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

package/environment.d.ts

@@ -1,5 +1,30 @@
 import * as pulumi from "@pulumi/pulumi";
 /**
+ * ## Getting Started
+ *
+ * The following end-to-end examples might help to get started with `confluentcloud.Environment` resource:
+ *   * `basic-kafka-acls`: _Basic_ Kafka cluster with authorization using ACLs
+ *   * `basic-kafka-acls-with-alias`: _Basic_ Kafka cluster with authorization using ACLs
+ *   * `standard-kafka-acls`: _Standard_ Kafka cluster with authorization using ACLs
+ *   * `standard-kafka-rbac`: _Standard_ Kafka cluster with authorization using RBAC
+ *   * `dedicated-public-kafka-acls`: _Dedicated_ Kafka cluster that is accessible over the public internet with authorization using ACLs
+ *   * `dedicated-public-kafka-rbac`: _Dedicated_ Kafka cluster that is accessible over the public internet with authorization using RBAC
+ *   * `dedicated-privatelink-aws-kafka-acls`: _Dedicated_ Kafka cluster on AWS that is accessible via PrivateLink connections with authorization using ACLs
+ *   * `dedicated-privatelink-aws-kafka-rbac`: _Dedicated_ Kafka cluster on AWS that is accessible via PrivateLink connections with authorization using RBAC
+ *   * `dedicated-privatelink-azure-kafka-rbac`: _Dedicated_ Kafka cluster on Azure that is accessible via PrivateLink connections with authorization using RBAC
+ *   * `dedicated-privatelink-azure-kafka-acls`: _Dedicated_ Kafka cluster on Azure that is accessible via PrivateLink connections with authorization using ACLs
+ *   * `dedicated-private-service-connect-gcp-kafka-acls`: _Dedicated_ Kafka cluster on GCP that is accessible via Private Service Connect connections with authorization using ACLs
+ *   * `dedicated-private-service-connect-gcp-kafka-rbac`: _Dedicated_ Kafka cluster on GCP that is accessible via Private Service Connect connections with authorization using RBAC
+ *   * `dedicated-vnet-peering-azure-kafka-acls`: _Dedicated_ Kafka cluster on Azure that is accessible via VPC Peering connections with authorization using ACLs
+ *   * `dedicated-vnet-peering-azure-kafka-rbac`: _Dedicated_ Kafka cluster on Azure that is accessible via VPC Peering connections with authorization using RBAC
+ *   * `dedicated-vpc-peering-aws-kafka-acls`: _Dedicated_ Kafka cluster on AWS that is accessible via VPC Peering connections with authorization using ACLs
+ *   * `dedicated-vpc-peering-aws-kafka-rbac`: _Dedicated_ Kafka cluster on AWS that is accessible via VPC Peering connections with authorization using RBAC
+ *   * `dedicated-vpc-peering-gcp-kafka-acls`: _Dedicated_ Kafka cluster on GCP that is accessible via VPC Peering connections with authorization using ACLs
+ *   * `dedicated-vpc-peering-gcp-kafka-rbac`: _Dedicated_ Kafka cluster on GCP that is accessible via VPC Peering connections with authorization using RBAC
+ *   * `dedicated-transit-gateway-attachment-aws-kafka-acls`: _Dedicated_ Kafka cluster on AWS that is accessible via Transit Gateway Endpoint with authorization using ACLs
+ *   * `dedicated-transit-gateway-attachment-aws-kafka-rbac`: _Dedicated_ Kafka cluster on AWS that is accessible via Transit Gateway Endpoint with authorization using RBAC
+ *   * `enterprise-privatelinkattachment-aws-kafka-acls`: _Enterprise_ Kafka cluster on AWS that is accessible via PrivateLink connections with authorization using ACLs
+ *
  * ## Import
  *
  * You can import an Environment by using Environment ID, for example$ export CONFLUENT_CLOUD_API_KEY="<cloud_api_key>" $ export CONFLUENT_CLOUD_API_SECRET="<cloud_api_secret>"

package/environment.js

@@ -6,6 +6,31 @@ exports.Environment = void 0;
 const pulumi = require("@pulumi/pulumi");
 const utilities = require("./utilities");
 /**
+ * ## Getting Started
+ *
+ * The following end-to-end examples might help to get started with `confluentcloud.Environment` resource:
+ *   * `basic-kafka-acls`: _Basic_ Kafka cluster with authorization using ACLs
+ *   * `basic-kafka-acls-with-alias`: _Basic_ Kafka cluster with authorization using ACLs
+ *   * `standard-kafka-acls`: _Standard_ Kafka cluster with authorization using ACLs
+ *   * `standard-kafka-rbac`: _Standard_ Kafka cluster with authorization using RBAC
+ *   * `dedicated-public-kafka-acls`: _Dedicated_ Kafka cluster that is accessible over the public internet with authorization using ACLs
+ *   * `dedicated-public-kafka-rbac`: _Dedicated_ Kafka cluster that is accessible over the public internet with authorization using RBAC
+ *   * `dedicated-privatelink-aws-kafka-acls`: _Dedicated_ Kafka cluster on AWS that is accessible via PrivateLink connections with authorization using ACLs
+ *   * `dedicated-privatelink-aws-kafka-rbac`: _Dedicated_ Kafka cluster on AWS that is accessible via PrivateLink connections with authorization using RBAC
+ *   * `dedicated-privatelink-azure-kafka-rbac`: _Dedicated_ Kafka cluster on Azure that is accessible via PrivateLink connections with authorization using RBAC
+ *   * `dedicated-privatelink-azure-kafka-acls`: _Dedicated_ Kafka cluster on Azure that is accessible via PrivateLink connections with authorization using ACLs
+ *   * `dedicated-private-service-connect-gcp-kafka-acls`: _Dedicated_ Kafka cluster on GCP that is accessible via Private Service Connect connections with authorization using ACLs
+ *   * `dedicated-private-service-connect-gcp-kafka-rbac`: _Dedicated_ Kafka cluster on GCP that is accessible via Private Service Connect connections with authorization using RBAC
+ *   * `dedicated-vnet-peering-azure-kafka-acls`: _Dedicated_ Kafka cluster on Azure that is accessible via VPC Peering connections with authorization using ACLs
+ *   * `dedicated-vnet-peering-azure-kafka-rbac`: _Dedicated_ Kafka cluster on Azure that is accessible via VPC Peering connections with authorization using RBAC
+ *   * `dedicated-vpc-peering-aws-kafka-acls`: _Dedicated_ Kafka cluster on AWS that is accessible via VPC Peering connections with authorization using ACLs
+ *   * `dedicated-vpc-peering-aws-kafka-rbac`: _Dedicated_ Kafka cluster on AWS that is accessible via VPC Peering connections with authorization using RBAC
+ *   * `dedicated-vpc-peering-gcp-kafka-acls`: _Dedicated_ Kafka cluster on GCP that is accessible via VPC Peering connections with authorization using ACLs
+ *   * `dedicated-vpc-peering-gcp-kafka-rbac`: _Dedicated_ Kafka cluster on GCP that is accessible via VPC Peering connections with authorization using RBAC
+ *   * `dedicated-transit-gateway-attachment-aws-kafka-acls`: _Dedicated_ Kafka cluster on AWS that is accessible via Transit Gateway Endpoint with authorization using ACLs
+ *   * `dedicated-transit-gateway-attachment-aws-kafka-rbac`: _Dedicated_ Kafka cluster on AWS that is accessible via Transit Gateway Endpoint with authorization using RBAC
+ *   * `enterprise-privatelinkattachment-aws-kafka-acls`: _Enterprise_ Kafka cluster on AWS that is accessible via PrivateLink connections with authorization using ACLs
+ *
  * ## Import
  *
  * You can import an Environment by using Environment ID, for example$ export CONFLUENT_CLOUD_API_KEY="<cloud_api_key>" $ export CONFLUENT_CLOUD_API_SECRET="<cloud_api_secret>"

package/environment.js.map

@@ -1 +1 @@
-{"version":3,"file":"environment.js","sourceRoot":"","sources":["../environment.ts"],"names":[],"mappings":";AAAA,wFAAwF;AACxF,iFAAiF;;;AAEjF,yCAAyC;AACzC,yCAAyC;AAEzC;;;;;;;;;;GAUG;AACH,MAAa,WAAY,SAAQ,MAAM,CAAC,cAAc;IAClD;;;;;;;;OAQG;IACI,MAAM,CAAC,GAAG,CAAC,IAAY,EAAE,EAA2B,EAAE,KAAwB,EAAE,IAAmC;QACtH,OAAO,IAAI,WAAW,CAAC,IAAI,EAAO,KAAK,kCAAO,IAAI,KAAE,EAAE,EAAE,EAAE,IAAG,CAAC;IAClE,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,WAAW,CAAC,YAAY,CAAC;IAC5D,CAAC;IAmBD,YAAY,IAAY,EAAE,WAAgD,EAAE,IAAmC;QAC3G,IAAI,cAAc,GAAkB,EAAE,CAAC;QACvC,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;QAClB,IAAI,IAAI,CAAC,EAAE,EAAE;YACT,MAAM,KAAK,GAAG,WAA2C,CAAC;YAC1D,cAAc,CAAC,aAAa,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;YACtE,cAAc,CAAC,cAAc,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC;SAC3E;aAAM;YACH,MAAM,IAAI,GAAG,WAA0C,CAAC;YACxD,cAAc,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;YACpE,cAAc,CAAC,cAAc,CAAC,GAAG,SAAS,CAAC,OAAO,CAAC;SACtD;QACD,IAAI,GAAG,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,oBAAoB,EAAE,EAAE,IAAI,CAAC,CAAC;QACnE,KAAK,CAAC,WAAW,CAAC,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,CAAC,CAAC;IAChE,CAAC;;AA3DL,kCA4DC;AA9CG,gBAAgB;AACO,wBAAY,GAAG,8CAA8C,CAAC"}
+{"version":3,"file":"environment.js","sourceRoot":"","sources":["../environment.ts"],"names":[],"mappings":";AAAA,wFAAwF;AACxF,iFAAiF;;;AAEjF,yCAAyC;AACzC,yCAAyC;AAEzC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,MAAa,WAAY,SAAQ,MAAM,CAAC,cAAc;IAClD;;;;;;;;OAQG;IACI,MAAM,CAAC,GAAG,CAAC,IAAY,EAAE,EAA2B,EAAE,KAAwB,EAAE,IAAmC;QACtH,OAAO,IAAI,WAAW,CAAC,IAAI,EAAO,KAAK,kCAAO,IAAI,KAAE,EAAE,EAAE,EAAE,IAAG,CAAC;IAClE,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,WAAW,CAAC,YAAY,CAAC;IAC5D,CAAC;IAmBD,YAAY,IAAY,EAAE,WAAgD,EAAE,IAAmC;QAC3G,IAAI,cAAc,GAAkB,EAAE,CAAC;QACvC,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;QAClB,IAAI,IAAI,CAAC,EAAE,EAAE;YACT,MAAM,KAAK,GAAG,WAA2C,CAAC;YAC1D,cAAc,CAAC,aAAa,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;YACtE,cAAc,CAAC,cAAc,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC;SAC3E;aAAM;YACH,MAAM,IAAI,GAAG,WAA0C,CAAC;YACxD,cAAc,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;YACpE,cAAc,CAAC,cAAc,CAAC,GAAG,SAAS,CAAC,OAAO,CAAC;SACtD;QACD,IAAI,GAAG,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,oBAAoB,EAAE,EAAE,IAAI,CAAC,CAAC;QACnE,KAAK,CAAC,WAAW,CAAC,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,CAAC,CAAC;IAChE,CAAC;;AA3DL,kCA4DC;AA9CG,gBAAgB;AACO,wBAAY,GAAG,8CAA8C,CAAC"}

package/kafkaCluster.d.ts

@@ -2,6 +2,143 @@ import * as pulumi from "@pulumi/pulumi";
 import * as inputs from "./types/input";
 import * as outputs from "./types/output";
 /**
+ * ## Example Usage
+ * ### Example Kafka clusters on AWS
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as confluentcloud from "@pulumi/confluentcloud";
+ *
+ * const development = new confluentcloud.Environment("development", {});
+ * const basic = new confluentcloud.KafkaCluster("basic", {
+ *     availability: "SINGLE_ZONE",
+ *     cloud: "AWS",
+ *     region: "us-east-2",
+ *     basic: {},
+ *     environment: {
+ *         id: development.id,
+ *     },
+ * });
+ * const standard = new confluentcloud.KafkaCluster("standard", {
+ *     availability: "SINGLE_ZONE",
+ *     cloud: "AWS",
+ *     region: "us-east-2",
+ *     standard: {},
+ *     environment: {
+ *         id: development.id,
+ *     },
+ * });
+ * const dedicated = new confluentcloud.KafkaCluster("dedicated", {
+ *     availability: "MULTI_ZONE",
+ *     cloud: "AWS",
+ *     region: "us-east-2",
+ *     dedicated: {
+ *         cku: 2,
+ *     },
+ *     environment: {
+ *         id: development.id,
+ *     },
+ * });
+ * ```
+ * ### Example Kafka clusters on Azure
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as confluentcloud from "@pulumi/confluentcloud";
+ *
+ * const development = new confluentcloud.Environment("development", {});
+ * const basic = new confluentcloud.KafkaCluster("basic", {
+ *     availability: "SINGLE_ZONE",
+ *     cloud: "AZURE",
+ *     region: "centralus",
+ *     basic: {},
+ *     environment: {
+ *         id: development.id,
+ *     },
+ * });
+ * const standard = new confluentcloud.KafkaCluster("standard", {
+ *     availability: "SINGLE_ZONE",
+ *     cloud: "AZURE",
+ *     region: "centralus",
+ *     standard: {},
+ *     environment: {
+ *         id: development.id,
+ *     },
+ * });
+ * const dedicated = new confluentcloud.KafkaCluster("dedicated", {
+ *     availability: "MULTI_ZONE",
+ *     cloud: "AZURE",
+ *     region: "centralus",
+ *     dedicated: {
+ *         cku: 2,
+ *     },
+ *     environment: {
+ *         id: development.id,
+ *     },
+ * });
+ * ```
+ * ### Example Kafka clusters on GCP
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as confluentcloud from "@pulumi/confluentcloud";
+ *
+ * const development = new confluentcloud.Environment("development", {});
+ * const basic = new confluentcloud.KafkaCluster("basic", {
+ *     availability: "SINGLE_ZONE",
+ *     cloud: "GCP",
+ *     region: "us-central1",
+ *     basic: {},
+ *     environment: {
+ *         id: development.id,
+ *     },
+ * });
+ * const standard = new confluentcloud.KafkaCluster("standard", {
+ *     availability: "SINGLE_ZONE",
+ *     cloud: "GCP",
+ *     region: "us-central1",
+ *     standard: {},
+ *     environment: {
+ *         id: development.id,
+ *     },
+ * });
+ * const dedicated = new confluentcloud.KafkaCluster("dedicated", {
+ *     availability: "MULTI_ZONE",
+ *     cloud: "GCP",
+ *     region: "us-central1",
+ *     dedicated: {
+ *         cku: 2,
+ *     },
+ *     environment: {
+ *         id: development.id,
+ *     },
+ * });
+ * ```
+ * ## Getting Started
+ *
+ * The following end-to-end examples might help to get started with `confluentcloud.KafkaCluster` resource:
+ *   * `basic-kafka-acls`: _Basic_ Kafka cluster with authorization using ACLs
+ *   * `basic-kafka-acls-with-alias`: _Basic_ Kafka cluster with authorization using ACLs
+ *   * `standard-kafka-acls`: _Standard_ Kafka cluster with authorization using ACLs
+ *   * `standard-kafka-rbac`: _Standard_ Kafka cluster with authorization using RBAC
+ *   * `dedicated-public-kafka-acls`: _Dedicated_ Kafka cluster that is accessible over the public internet with authorization using ACLs
+ *   * `dedicated-public-kafka-rbac`: _Dedicated_ Kafka cluster that is accessible over the public internet with authorization using RBAC
+ *   * `dedicated-privatelink-aws-kafka-acls`: _Dedicated_ Kafka cluster on AWS that is accessible via PrivateLink connections with authorization using ACLs
+ *   * `dedicated-privatelink-aws-kafka-rbac`: _Dedicated_ Kafka cluster on AWS that is accessible via PrivateLink connections with authorization using RBAC
+ *   * `dedicated-privatelink-azure-kafka-rbac`: _Dedicated_ Kafka cluster on Azure that is accessible via PrivateLink connections with authorization using RBAC
+ *   * `dedicated-privatelink-azure-kafka-acls`: _Dedicated_ Kafka cluster on Azure that is accessible via PrivateLink connections with authorization using ACLs
+ *   * `dedicated-private-service-connect-gcp-kafka-acls`: _Dedicated_ Kafka cluster on GCP that is accessible via Private Service Connect connections with authorization using ACLs
+ *   * `dedicated-private-service-connect-gcp-kafka-rbac`: _Dedicated_ Kafka cluster on GCP that is accessible via Private Service Connect connections with authorization using RBAC
+ *   * `dedicated-vnet-peering-azure-kafka-acls`: _Dedicated_ Kafka cluster on Azure that is accessible via VPC Peering connections with authorization using ACLs
+ *   * `dedicated-vnet-peering-azure-kafka-rbac`: _Dedicated_ Kafka cluster on Azure that is accessible via VPC Peering connections with authorization using RBAC
+ *   * `dedicated-vpc-peering-aws-kafka-acls`: _Dedicated_ Kafka cluster on AWS that is accessible via VPC Peering connections with authorization using ACLs
+ *   * `dedicated-vpc-peering-aws-kafka-rbac`: _Dedicated_ Kafka cluster on AWS that is accessible via VPC Peering connections with authorization using RBAC
+ *   * `dedicated-vpc-peering-gcp-kafka-acls`: _Dedicated_ Kafka cluster on GCP that is accessible via VPC Peering connections with authorization using ACLs
+ *   * `dedicated-vpc-peering-gcp-kafka-rbac`: _Dedicated_ Kafka cluster on GCP that is accessible via VPC Peering connections with authorization using RBAC
+ *   * `dedicated-transit-gateway-attachment-aws-kafka-acls`: _Dedicated_ Kafka cluster on AWS that is accessible via Transit Gateway Endpoint with authorization using ACLs
+ *   * `dedicated-transit-gateway-attachment-aws-kafka-rbac`: _Dedicated_ Kafka cluster on AWS that is accessible via Transit Gateway Endpoint with authorization using RBAC
+ *   * `enterprise-privatelinkattachment-aws-kafka-acls`: _Enterprise_ Kafka cluster on AWS that is accessible via PrivateLink connections with authorization using ACLs
+ *
  * ## Import
  *
  * You can import a Kafka cluster by using Environment ID and Kafka cluster ID, in the format `<Environment ID>/<Kafka cluster ID>`, e.g. $ export CONFLUENT_CLOUD_API_KEY="<cloud_api_key>" $ export CONFLUENT_CLOUD_API_SECRET="<cloud_api_secret>"