[APIE-798] CMK API v2 attribute deprecation - TF

docs/data-sources/confluent_kafka_cluster.md

@@ -94,8 +94,8 @@ In addition to the preceding arguments, the following attributes are exported:
     - `id` - (Required String) The ID of the Network that the Kafka cluster belongs to, for example, `n-abc123`.
 - `byok_key` (Optional Configuration Block) supports the following:
     - `id` - (Required String) The ID of the Confluent key that is used to encrypt the data in the Kafka cluster, for example, `cck-lye5m`.
-- `bootstrap_endpoint` - (Required String) The bootstrap endpoint used by Kafka clients to connect to the Kafka cluster. (e.g., `pkc-00000.us-central1.gcp.confluent.cloud:9092`).
-- `rest_endpoint` - (Required String) The REST endpoint of the Kafka cluster (e.g., `https://pkc-00000.us-central1.gcp.confluent.cloud:443`).
+- `bootstrap_endpoint` - (Required String, **Deprecated**) The bootstrap endpoint used by Kafka clients to connect to the Kafka cluster. (e.g., `pkc-00000.us-central1.gcp.confluent.cloud:9092`). Please use the `endpoints` attribute instead.
+- `rest_endpoint` - (Required String, **Deprecated**) The REST endpoint of the Kafka cluster (e.g., `https://pkc-00000.us-central1.gcp.confluent.cloud:443`). Please use the `endpoints` attribute instead.
 - `rbac_crn` - (Required String) The Confluent Resource Name of the Kafka cluster, for example, `crn://confluent.cloud/organization=1111aaaa-11aa-11aa-11aa-111111aaaaaa/environment=env-abc123/cloud-cluster=lkc-abc123`.
 - `endpoints` - (Optional List) The list of endpoints for connecting to the Kafka cluster. These endpoints provide different network access methods or regions for connecting to the cluster:
     - `access_point_id` - (Required String) The ID of the Access Point that the endpoint corresponds to. Access Point IDs `PUBLIC` and `PRIVATE_LINK` are reserved.

docs/data-sources/confluent_kafka_clusters.md

@@ -62,8 +62,8 @@ In addition to the preceding arguments, the following attributes are exported:
       - `id` - (Required String) The ID of the Network that the Kafka cluster belongs to, for example, `n-abc123`.
   - `byok_key` (Optional Configuration Block) supports the following:
       - `id` - (Required String) The ID of the Confluent key that is used to encrypt the data in the Kafka cluster, for example, `cck-lye5m`.
-  - `bootstrap_endpoint` - (Required String) The bootstrap endpoint used by Kafka clients to connect to the Kafka cluster. (e.g., `pkc-00000.us-central1.gcp.confluent.cloud:9092`).
-  - `rest_endpoint` - (Required String) The REST endpoint of the Kafka cluster (e.g., `https://pkc-00000.us-central1.gcp.confluent.cloud:443`).
+  - `bootstrap_endpoint` - (Required String, **Deprecated**) The bootstrap endpoint used by Kafka clients to connect to the Kafka cluster. (e.g., `pkc-00000.us-central1.gcp.confluent.cloud:9092`). Please use the `endpoints` attribute instead.
+  - `rest_endpoint` - (Required String, **Deprecated**) The REST endpoint of the Kafka cluster (e.g., `https://pkc-00000.us-central1.gcp.confluent.cloud:443`). Please use the `endpoints` attribute instead.
   - `rbac_crn` - (Required String) The Confluent Resource Name of the Kafka cluster, for example, `crn://confluent.cloud/organization=1111aaaa-11aa-11aa-11aa-111111aaaaaa/environment=env-abc123/cloud-cluster=lkc-abc123`.
   - `endpoints` - (Optional List) The list of endpoints for connecting to the Kafka cluster. These endpoints provide different network access methods or regions for connecting to the cluster:
       - `access_point_id` - (Required String) The ID of the Access Point that the endpoint corresponds to. Access Point IDs `PUBLIC` and `PRIVATE_LINK` are reserved.

docs/data-sources/confluent_kafka_topic.md

@@ -68,7 +68,7 @@ The following arguments are supported:
 - `kafka_cluster` - (Optional Configuration Block) supports the following:
   - `id` - (Required String) The ID of the Kafka cluster, for example, `lkc-abc123`.
 - `topic_name` - (Required String) The name of the topic, for example, `orders-1`. The topic name can be up to 255 characters in length and can contain only alphanumeric characters, hyphens, and underscores.
-- `rest_endpoint` - (Optional String) The REST endpoint of the Kafka cluster, for example, `https://pkc-00000.us-central1.gcp.confluent.cloud:443`).
+- `rest_endpoint` - (Optional String, **Deprecated**) The REST endpoint of the Kafka cluster, for example, `https://pkc-00000.us-central1.gcp.confluent.cloud:443`. Please use the `endpoints` attribute instead.
 - `credentials` (Optional Configuration Block) supports the following:
     - `key` - (Required String) The Kafka API Key.
     - `secret` - (Required String) The Kafka API Secret.

docs/resources/confluent_cluster_link.md

@@ -79,29 +79,29 @@ The following arguments are supported:
 - `link_name` - (Required String) The name of the cluster link, for example, `my-cluster-link`.
 - `source_kafka_cluster` - (Optional Configuration Block) supports the following:
   - `id` - (Required String) The ID of the source Kafka cluster, for example, `lkc-abc123`.
-  - `rest_endpoint` - (Optional String) The REST endpoint of the source Kafka cluster, for example, `https://pkc-00000.us-central1.gcp.confluent.cloud:443`).
-  - `bootstrap_endpoint` - (Optional String) The bootstrap endpoint of the source Kafka cluster, for example, `SASL_SSL://pkc-00000.us-central1.gcp.confluent.cloud:9092` or `pkc-00000.us-central1.gcp.confluent.cloud:9092`).
+  - `rest_endpoint` - (Optional String, **Deprecated**) The REST endpoint of the source Kafka cluster, for example, `https://pkc-00000.us-central1.gcp.confluent.cloud:443`. Please use the `endpoints` attribute instead.
+  - `bootstrap_endpoint` - (Optional String, **Deprecated**) The bootstrap endpoint of the source Kafka cluster, for example, `SASL_SSL://pkc-00000.us-central1.gcp.confluent.cloud:9092` or `pkc-00000.us-central1.gcp.confluent.cloud:9092`. Please use the `endpoints` attribute instead.
   - `credentials` (Optional Configuration Block) supports the following:
     - `key` - (Required String) The Kafka API Key.
     - `secret` - (Required String, Sensitive) The Kafka API Secret.
 - `destination_kafka_cluster` - (Optional Configuration Block) supports the following:
   - `id` - (Required String) The ID of the destination Kafka cluster, for example, `lkc-abc123`.
-  - `rest_endpoint` - (Optional String) The REST endpoint of the destination Kafka cluster, for example, `https://pkc-00000.us-central1.gcp.confluent.cloud:443`).
-  - `bootstrap_endpoint` - (Optional String) The bootstrap endpoint of the destination Kafka cluster, for example, `SASL_SSL://pkc-00000.us-central1.gcp.confluent.cloud:9092` or `pkc-00000.us-central1.gcp.confluent.cloud:9092`).
+  - `rest_endpoint` - (Optional String, **Deprecated**) The REST endpoint of the destination Kafka cluster, for example, `https://pkc-00000.us-central1.gcp.confluent.cloud:443`. Please use the `endpoints` attribute instead.
+  - `bootstrap_endpoint` - (Optional String, **Deprecated**) The bootstrap endpoint of the destination Kafka cluster, for example, `SASL_SSL://pkc-00000.us-central1.gcp.confluent.cloud:9092` or `pkc-00000.us-central1.gcp.confluent.cloud:9092`. Please use the `endpoints` attribute instead.
   - `credentials` (Optional Configuration Block) supports the following:
     - `key` - (Required String) The Kafka API Key.
     - `secret` - (Required String, Sensitive) The Kafka API Secret.
 - `local_kafka_cluster` - (Optional Configuration Block) supports the following:
   - `id` - (Required String) The ID of the local Kafka cluster, for example, `lkc-abc123`.
-  - `rest_endpoint` - (Optional String) The REST endpoint of the local Kafka cluster, for example, `https://pkc-00000.us-central1.gcp.confluent.cloud:443`).
-  - `bootstrap_endpoint` - (Optional String) The bootstrap endpoint of the local Kafka cluster, for example, `SASL_SSL://pkc-00000.us-central1.gcp.confluent.cloud:9092` or `pkc-00000.us-central1.gcp.confluent.cloud:9092`).
+  - `rest_endpoint` - (Optional String, **Deprecated**) The REST endpoint of the local Kafka cluster, for example, `https://pkc-00000.us-central1.gcp.confluent.cloud:443`. Please use the `endpoints` attribute instead.
+  - `bootstrap_endpoint` - (Optional String, **Deprecated**) The bootstrap endpoint of the local Kafka cluster, for example, `SASL_SSL://pkc-00000.us-central1.gcp.confluent.cloud:9092` or `pkc-00000.us-central1.gcp.confluent.cloud:9092`. Please use the `endpoints` attribute instead.
   - `credentials` (Optional Configuration Block) supports the following:
     - `key` - (Required String) The Kafka API Key.
     - `secret` - (Required String, Sensitive) The Kafka API Secret.
 - `remote_kafka_cluster` - (Optional Configuration Block) supports the following:
   - `id` - (Required String) The ID of the remote Kafka cluster, for example, `lkc-abc123`.
-  - `rest_endpoint` - (Optional String) The REST endpoint of the remote Kafka cluster, for example, `https://pkc-00000.us-central1.gcp.confluent.cloud:443`).
-  - `bootstrap_endpoint` - (Optional String) The bootstrap endpoint of the remote Kafka cluster, for example, `SASL_SSL://pkc-00000.us-central1.gcp.confluent.cloud:9092` or `pkc-00000.us-central1.gcp.confluent.cloud:9092`).
+  - `rest_endpoint` - (Optional String, **Deprecated**) The REST endpoint of the remote Kafka cluster, for example, `https://pkc-00000.us-central1.gcp.confluent.cloud:443`. Please use the `endpoints` attribute instead.
+  - `bootstrap_endpoint` - (Optional String, **Deprecated**) The bootstrap endpoint of the remote Kafka cluster, for example, `SASL_SSL://pkc-00000.us-central1.gcp.confluent.cloud:9092` or `pkc-00000.us-central1.gcp.confluent.cloud:9092`. Please use the `endpoints` attribute instead.
   - `credentials` (Optional Configuration Block) supports the following:
     - `key` - (Required String) The Kafka API Key.
     - `secret` - (Required String, Sensitive) The Kafka API Secret.

docs/resources/confluent_kafka_cluster.md

@@ -290,8 +290,8 @@ In addition to the preceding arguments, the following attributes are exported:
 - `id` - (Required String) The ID of the Kafka cluster (e.g., `lkc-abc123`).
 - `api_version` - (Required String) An API Version of the schema version of the Kafka cluster, for example, `cmk/v2`.
 - `kind` - (Required String) A kind of the Kafka cluster, for example, `Cluster`.
-- `bootstrap_endpoint` - (Required String) The bootstrap endpoint used by Kafka clients to connect to the Kafka cluster. (e.g., `SASL_SSL://pkc-00000.us-central1.gcp.confluent.cloud:9092`).
-- `rest_endpoint` - (Required String) The REST endpoint of the Kafka cluster (e.g., `https://pkc-00000.us-central1.gcp.confluent.cloud:443`).
+- `bootstrap_endpoint` - (Required String, **Deprecated**) The bootstrap endpoint used by Kafka clients to connect to the Kafka cluster. (e.g., `SASL_SSL://pkc-00000.us-central1.gcp.confluent.cloud:9092`). Please use the `endpoints` attribute instead.
+- `rest_endpoint` - (Required String, **Deprecated**) The REST endpoint of the Kafka cluster (e.g., `https://pkc-00000.us-central1.gcp.confluent.cloud:443`). Please use the `endpoints` attribute instead.
 - `rbac_crn` - (Required String) The Confluent Resource Name (CRN) of the Kafka cluster, for example, `crn://confluent.cloud/organization=1111aaaa-11aa-11aa-11aa-111111aaaaaa/environment=env-abc123/cloud-cluster=lkc-abc123`. Some resources, like topics, require appending the Kafka cluster ID for creating role bindings, for example, `/kafka=lkc-123abc`. For more information, see [confluent_role_binding Resource](https://registry.terraform.io/providers/confluentinc/confluent/latest/docs/resources/confluent_role_binding).
 - `dedicated` - (Optional Configuration Block) The configuration of the Dedicated Kafka cluster. It supports the following:
   - `zones` - (Required List of String) The list of zones the cluster is in.

docs/resources/confluent_kafka_cluster_config.md

@@ -63,7 +63,7 @@ The following arguments are supported:
 
 - `kafka_cluster` - (Optional Configuration Block) supports the following:
     - `id` - (Required String) The ID of the Dedicated Kafka cluster, for example, `lkc-abc123`.
-- `rest_endpoint` - (Optional String) The REST endpoint of the Dedicated Kafka cluster, for example, `https://pkc-00000.us-central1.gcp.confluent.cloud:443`).
+- `rest_endpoint` - (Optional String, **Deprecated**) The REST endpoint of the Dedicated Kafka cluster, for example, `https://pkc-00000.us-central1.gcp.confluent.cloud:443`. Please use the `endpoints` attribute instead.
 - `credentials` (Optional Configuration Block) supports the following:
     - `key` - (Required String) The Kafka API Key.
     - `secret` - (Required String, Sensitive) The Kafka API Secret.

docs/resources/confluent_kafka_mirror_topic.md

@@ -46,7 +46,7 @@ The following arguments are supported:
 
 - `kafka_cluster` - (Required Configuration Block) supports the following:
     - `id` - (Required String) The ID of the destination Kafka cluster, for example, `lkc-abc123`.
-    - `rest_endpoint` - (Required String) The REST endpoint of the destination Kafka cluster, for example, `https://pkc-00000.us-central1.gcp.confluent.cloud:443`).
+    - `rest_endpoint` - (Required String, **Deprecated**) The REST endpoint of the destination Kafka cluster, for example, `https://pkc-00000.us-central1.gcp.confluent.cloud:443`. Please use the `endpoints` attribute instead.
     - `credentials` (Required Configuration Block) supports the following:
         - `key` - (Required String) The Kafka API Key.
         - `secret` - (Required String, Sensitive) The Kafka API Secret.

docs/resources/confluent_kafka_topic.md

@@ -68,7 +68,7 @@ The following arguments are supported:
 - `kafka_cluster` - (Optional Configuration Block) supports the following:
     - `id` - (Required String) The ID of the Kafka cluster, for example, `lkc-abc123`.
 - `topic_name` - (Required String) The name of the topic, for example, `orders-1`. The topic name can be up to 249 characters in length, and can include the following characters: a-z, A-Z, 0-9, . (dot), _ (underscore), and - (dash). As a best practice, we recommend against using any personally identifiable information (PII) when naming your topic.
-- `rest_endpoint` - (Optional String) The REST endpoint of the Kafka cluster, for example, `https://pkc-00000.us-central1.gcp.confluent.cloud:443`).
+- `rest_endpoint` - (Optional String, **Deprecated**) The REST endpoint of the Kafka cluster, for example, `https://pkc-00000.us-central1.gcp.confluent.cloud:443`. Please use the `endpoints` attribute instead.
 - `credentials` (Optional Configuration Block) supports the following:
     - `key` - (Required String) The Kafka API Key.
     - `secret` - (Required String, Sensitive) The Kafka API Secret.

internal/provider/data_source_kafka_cluster.go

@@ -80,12 +80,14 @@ func kafkaDataSource() *schema.Resource {
 			paramEnterpriseCluster: enterpriseClusterDataSourceSchema(),
 			paramFreightCluster:    freightClusterDataSourceSchema(),
 			paramBootStrapEndpoint: {
-				Type:     schema.TypeString,
-				Computed: true,
+				Type:       schema.TypeString,
+				Computed:   true,
+				Deprecated: "Please use the endpoints attribute instead.",
 			},
 			paramRestEndpoint: {
-				Type:     schema.TypeString,
-				Computed: true,
+				Type:       schema.TypeString,
+				Computed:   true,
+				Deprecated: "Please use the endpoints attribute instead.",
 			},
 			paramRbacCrn: {
 				Type:     schema.TypeString,

internal/provider/data_source_kafka_clusters.go

@@ -78,12 +78,14 @@ func kafkaClustersSchema() *schema.Schema {
 				paramEnterpriseCluster: enterpriseClusterDataSourceSchema(),
 				paramFreightCluster:    freightClusterDataSourceSchema(),
 				paramBootStrapEndpoint: {
-					Type:     schema.TypeString,
-					Computed: true,
+					Type:       schema.TypeString,
+					Computed:   true,
+					Deprecated: "Please use the endpoints attribute instead.",
 				},
 				paramRestEndpoint: {
-					Type:     schema.TypeString,
-					Computed: true,
+					Type:       schema.TypeString,
+					Computed:   true,
+					Deprecated: "Please use the endpoints attribute instead.",
 				},
 				paramRbacCrn: {
 					Type:     schema.TypeString,

internal/provider/data_source_kafka_topic.go

@@ -32,8 +32,9 @@ func kafkaTopicDataSource() *schema.Resource {
 				Required: true,
 			},
 			paramRestEndpoint: {
-				Type:     schema.TypeString,
-				Required: true,
+				Type:       schema.TypeString,
+				Required:   true,
+				Deprecated: "Please use the endpoints attribute instead.",
 			},
 			paramCredentials: credentialsSchema(),
 			paramPartitionsCount: {

internal/provider/resource_cluster_link.go

@@ -886,6 +886,7 @@ func clusterLinkKafkaClusterBlockSchema(blockName string) *schema.Schema {
 					ValidateFunc: validation.StringMatch(regexp.MustCompile("^http"), "the REST endpoint must start with 'https://'"),
 					// A user should provide a value for either "paramRestEndpoint" or "paramBootStrapEndpoint" attribute
 					ExactlyOneOf: oneOfEndpointsKeys,
+					Deprecated:   "Please use the endpoints attribute instead.",
 				},
 				paramBootStrapEndpoint: {
 					Type:        schema.TypeString,
@@ -894,6 +895,7 @@ func clusterLinkKafkaClusterBlockSchema(blockName string) *schema.Schema {
 					Description: "The bootstrap endpoint used by Kafka clients to connect to the Kafka cluster. (e.g., `SASL_SSL://pkc-00000.us-central1.gcp.confluent.cloud:9092` or `pkc-00000.us-central1.gcp.confluent.cloud:9092`).",
 					// A user should provide a value for either "paramRestEndpoint" or "paramBootStrapEndpoint" attribute
 					ExactlyOneOf: oneOfEndpointsKeys,
+					Deprecated:   "Please use the endpoints attribute instead.",
 				},
 				paramCredentials: {
 					Type:        schema.TypeList,

internal/provider/resource_kafka_cluster.go

@@ -151,11 +151,13 @@ func kafkaResource() *schema.Resource {
 				Type:        schema.TypeString,
 				Computed:    true,
 				Description: "The bootstrap endpoint used by Kafka clients to connect to the Kafka cluster.",
+				Deprecated:  "Please use the endpoints attribute instead.",
 			},
 			paramRestEndpoint: {
 				Type:        schema.TypeString,
 				Computed:    true,
 				Description: "The REST endpoint of the Kafka cluster.",
+				Deprecated:  "Please use the endpoints attribute instead.",
 			},
 			paramRbacCrn: {
 				Type:     schema.TypeString,

internal/provider/resource_kafka_cluster_config.go

@@ -66,6 +66,7 @@ func kafkaConfigResource() *schema.Resource {
 				ForceNew:     true,
 				Description:  "The REST endpoint of the Kafka cluster (e.g., `https://pkc-00000.us-central1.gcp.confluent.cloud:443`).",
 				ValidateFunc: validation.StringMatch(regexp.MustCompile("^http"), "the REST endpoint must start with 'https://'"),
+				Deprecated:   "Please use the endpoint attribute instead.",
 			},
 			paramCredentials: credentialsSchema(),
 		},

internal/provider/resource_kafka_mirror_topic.go

@@ -455,6 +455,7 @@ func mirrorTopicKafkaClusterBlockSchema() *schema.Schema {
 					ForceNew:     true,
 					Description:  "The REST endpoint of the Kafka cluster (e.g., `https://pkc-00000.us-central1.gcp.confluent.cloud:443`).",
 					ValidateFunc: validation.StringMatch(regexp.MustCompile("^http"), "the REST endpoint must start with 'https://'"),
+					Deprecated:   "Please use the endpoints attribute instead.",
 				},
 				paramCredentials: {
 					Type:        schema.TypeList,

internal/provider/resource_kafka_topic.go

@@ -108,6 +108,7 @@ func kafkaTopicResource() *schema.Resource {
 				Optional:     true,
 				Description:  "The REST endpoint of the Kafka cluster (e.g., `https://pkc-00000.us-central1.gcp.confluent.cloud:443`).",
 				ValidateFunc: validation.StringMatch(regexp.MustCompile("^http"), "the REST endpoint must start with 'https://'"),
+				Deprecated:   "Please use the endpoints attribute instead.",
 			},
 			paramConfigs: {
 				Type: schema.TypeMap,