pulumi-confluentcloud 2.10.0a1731389320__py3-none-any.whl → 2.54.0a1766503424__py3-none-any.whl

pulumi_confluentcloud/get_certificate_authority.py

@@ -1,8 +1,8 @@
 # coding=utf-8
-# *** WARNING: this file was generated by the Pulumi Terraform Bridge (tfgen) Tool. ***
+# *** WARNING: this file was generated by pulumi-language-python. ***
 # *** Do not edit by hand unless you're certain you know what you are doing! ***
 
-import copy
+import builtins as _builtins
 import warnings
 import sys
 import pulumi
@@ -58,78 +58,78 @@ class GetCertificateAuthorityResult:
             raise TypeError("Expected argument 'serial_numbers' to be a list")
         pulumi.set(__self__, "serial_numbers", serial_numbers)
 
-    @property
+    @_builtins.property
     @pulumi.getter(name="certificateChainFilename")
-    def certificate_chain_filename(self) -> str:
+    def certificate_chain_filename(self) -> _builtins.str:
         """
         (Required String) The name of the certificate file, for example, `certificate.pem`.
         """
         return pulumi.get(self, "certificate_chain_filename")
 
-    @property
+    @_builtins.property
     @pulumi.getter(name="crlSource")
-    def crl_source(self) -> str:
+    def crl_source(self) -> _builtins.str:
         """
         (Optional String) The source specifies whether the Certificate Revocation List (CRL) is updated from either local file uploaded (LOCAL) or from url of CRL (URL). Accepted values are `LOCAL` and `URL`.
         """
         return pulumi.get(self, "crl_source")
 
-    @property
+    @_builtins.property
     @pulumi.getter(name="crlUpdatedAt")
-    def crl_updated_at(self) -> str:
+    def crl_updated_at(self) -> _builtins.str:
         """
         (Optional String) The timestamp for when CRL was last updated, for example, `2017-07-21T17:32:28Z`.
         """
         return pulumi.get(self, "crl_updated_at")
 
-    @property
+    @_builtins.property
     @pulumi.getter(name="crlUrl")
-    def crl_url(self) -> str:
+    def crl_url(self) -> _builtins.str:
         """
         (Optional String) The url from which to fetch the CRL for the certificate authority if crl_source is URL.
         """
         return pulumi.get(self, "crl_url")
 
-    @property
+    @_builtins.property
     @pulumi.getter
-    def description(self) -> str:
+    def description(self) -> _builtins.str:
         """
         (Required String) A description for the Certificate Authority.
         """
         return pulumi.get(self, "description")
 
-    @property
+    @_builtins.property
     @pulumi.getter(name="displayName")
-    def display_name(self) -> str:
+    def display_name(self) -> _builtins.str:
         """
         (Required String) A human-readable name for the Certificate Authority.
         """
         return pulumi.get(self, "display_name")
 
-    @property
+    @_builtins.property
     @pulumi.getter(name="expirationDates")
-    def expiration_dates(self) -> Sequence[str]:
+    def expiration_dates(self) -> Sequence[_builtins.str]:
         """
         (Required List of Strings) The expiration dates of certificates in the chain, for example, `["2017-07-21T17:32:28Z"]`.
         """
         return pulumi.get(self, "expiration_dates")
 
-    @property
+    @_builtins.property
     @pulumi.getter
-    def fingerprints(self) -> Sequence[str]:
+    def fingerprints(self) -> Sequence[_builtins.str]:
         """
         (Required List of Strings) The fingerprints for each certificate in the certificate chain, for example, `["B1BC968BD4f49D622AA89A81F2150152A41D829C"]`.
         """
         return pulumi.get(self, "fingerprints")
 
-    @property
+    @_builtins.property
     @pulumi.getter
-    def id(self) -> str:
+    def id(self) -> _builtins.str:
         return pulumi.get(self, "id")
 
-    @property
+    @_builtins.property
     @pulumi.getter(name="serialNumbers")
-    def serial_numbers(self) -> Sequence[str]:
+    def serial_numbers(self) -> Sequence[_builtins.str]:
         """
         (Required List of Strings) The serial numbers for each certificate in the certificate chain.
         """
@@ -154,13 +154,13 @@ class AwaitableGetCertificateAuthorityResult(GetCertificateAuthorityResult):
             serial_numbers=self.serial_numbers)
 
 
-def get_certificate_authority(crl_source: Optional[str] = None,
-                              crl_updated_at: Optional[str] = None,
-                              crl_url: Optional[str] = None,
-                              id: Optional[str] = None,
+def get_certificate_authority(crl_source: Optional[_builtins.str] = None,
+                              crl_updated_at: Optional[_builtins.str] = None,
+                              crl_url: Optional[_builtins.str] = None,
+                              id: Optional[_builtins.str] = None,
                               opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableGetCertificateAuthorityResult:
     """
-    [![Limited Availability](https://img.shields.io/badge/Lifecycle%20Stage-Limited%20Availability-%2345c6e8)](https://docs.confluent.io/cloud/current/api.html#section/Versioning/API-Lifecycle-Policy)
+    [![General Availability](https://img.shields.io/badge/Lifecycle%20Stage-General%20Availability-%2345c6e8)](https://docs.confluent.io/cloud/current/api.html#section/Versioning/API-Lifecycle-Policy)
 
     `CertificateAuthority` describes a Certificate Authority data source.
 
@@ -175,10 +175,10 @@ def get_certificate_authority(crl_source: Optional[str] = None,
     ```
 
 
-    :param str crl_source: (Optional String) The source specifies whether the Certificate Revocation List (CRL) is updated from either local file uploaded (LOCAL) or from url of CRL (URL). Accepted values are `LOCAL` and `URL`.
-    :param str crl_updated_at: (Optional String) The timestamp for when CRL was last updated, for example, `2017-07-21T17:32:28Z`.
-    :param str crl_url: (Optional String) The url from which to fetch the CRL for the certificate authority if crl_source is URL.
-    :param str id: The ID of the Certificate Authority, for example, `op-abc123`.
+    :param _builtins.str crl_source: (Optional String) The source specifies whether the Certificate Revocation List (CRL) is updated from either local file uploaded (LOCAL) or from url of CRL (URL). Accepted values are `LOCAL` and `URL`.
+    :param _builtins.str crl_updated_at: (Optional String) The timestamp for when CRL was last updated, for example, `2017-07-21T17:32:28Z`.
+    :param _builtins.str crl_url: (Optional String) The url from which to fetch the CRL for the certificate authority if crl_source is URL.
+    :param _builtins.str id: The ID of the Certificate Authority, for example, `op-abc123`.
     """
     __args__ = dict()
     __args__['crlSource'] = crl_source
@@ -199,13 +199,13 @@ def get_certificate_authority(crl_source: Optional[str] = None,
         fingerprints=pulumi.get(__ret__, 'fingerprints'),
         id=pulumi.get(__ret__, 'id'),
         serial_numbers=pulumi.get(__ret__, 'serial_numbers'))
-def get_certificate_authority_output(crl_source: Optional[pulumi.Input[Optional[str]]] = None,
-                                     crl_updated_at: Optional[pulumi.Input[Optional[str]]] = None,
-                                     crl_url: Optional[pulumi.Input[Optional[str]]] = None,
-                                     id: Optional[pulumi.Input[str]] = None,
-                                     opts: Optional[pulumi.InvokeOptions] = None) -> pulumi.Output[GetCertificateAuthorityResult]:
+def get_certificate_authority_output(crl_source: Optional[pulumi.Input[Optional[_builtins.str]]] = None,
+                                     crl_updated_at: Optional[pulumi.Input[Optional[_builtins.str]]] = None,
+                                     crl_url: Optional[pulumi.Input[Optional[_builtins.str]]] = None,
+                                     id: Optional[pulumi.Input[_builtins.str]] = None,
+                                     opts: Optional[Union[pulumi.InvokeOptions, pulumi.InvokeOutputOptions]] = None) -> pulumi.Output[GetCertificateAuthorityResult]:
     """
-    [![Limited Availability](https://img.shields.io/badge/Lifecycle%20Stage-Limited%20Availability-%2345c6e8)](https://docs.confluent.io/cloud/current/api.html#section/Versioning/API-Lifecycle-Policy)
+    [![General Availability](https://img.shields.io/badge/Lifecycle%20Stage-General%20Availability-%2345c6e8)](https://docs.confluent.io/cloud/current/api.html#section/Versioning/API-Lifecycle-Policy)
 
     `CertificateAuthority` describes a Certificate Authority data source.
 
@@ -220,17 +220,17 @@ def get_certificate_authority_output(crl_source: Optional[pulumi.Input[Optional[
     ```
 
 
-    :param str crl_source: (Optional String) The source specifies whether the Certificate Revocation List (CRL) is updated from either local file uploaded (LOCAL) or from url of CRL (URL). Accepted values are `LOCAL` and `URL`.
-    :param str crl_updated_at: (Optional String) The timestamp for when CRL was last updated, for example, `2017-07-21T17:32:28Z`.
-    :param str crl_url: (Optional String) The url from which to fetch the CRL for the certificate authority if crl_source is URL.
-    :param str id: The ID of the Certificate Authority, for example, `op-abc123`.
+    :param _builtins.str crl_source: (Optional String) The source specifies whether the Certificate Revocation List (CRL) is updated from either local file uploaded (LOCAL) or from url of CRL (URL). Accepted values are `LOCAL` and `URL`.
+    :param _builtins.str crl_updated_at: (Optional String) The timestamp for when CRL was last updated, for example, `2017-07-21T17:32:28Z`.
+    :param _builtins.str crl_url: (Optional String) The url from which to fetch the CRL for the certificate authority if crl_source is URL.
+    :param _builtins.str id: The ID of the Certificate Authority, for example, `op-abc123`.
     """
     __args__ = dict()
     __args__['crlSource'] = crl_source
     __args__['crlUpdatedAt'] = crl_updated_at
     __args__['crlUrl'] = crl_url
     __args__['id'] = id
-    opts = pulumi.InvokeOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
+    opts = pulumi.InvokeOutputOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
     __ret__ = pulumi.runtime.invoke_output('confluentcloud:index/getCertificateAuthority:getCertificateAuthority', __args__, opts=opts, typ=GetCertificateAuthorityResult)
     return __ret__.apply(lambda __response__: GetCertificateAuthorityResult(
         certificate_chain_filename=pulumi.get(__response__, 'certificate_chain_filename'),

pulumi_confluentcloud/get_certificate_pool.py

@@ -1,8 +1,8 @@
 # coding=utf-8
-# *** WARNING: this file was generated by the Pulumi Terraform Bridge (tfgen) Tool. ***
+# *** WARNING: this file was generated by pulumi-language-python. ***
 # *** Do not edit by hand unless you're certain you know what you are doing! ***
 
-import copy
+import builtins as _builtins
 import warnings
 import sys
 import pulumi
@@ -48,46 +48,46 @@ class GetCertificatePoolResult:
             raise TypeError("Expected argument 'id' to be a str")
         pulumi.set(__self__, "id", id)
 
-    @property
+    @_builtins.property
     @pulumi.getter(name="certificateAuthority")
     def certificate_authority(self) -> 'outputs.GetCertificatePoolCertificateAuthorityResult':
         return pulumi.get(self, "certificate_authority")
 
-    @property
+    @_builtins.property
     @pulumi.getter
-    def description(self) -> str:
+    def description(self) -> _builtins.str:
         """
         (Required String) A description of the Certificate Pool.
         """
         return pulumi.get(self, "description")
 
-    @property
+    @_builtins.property
     @pulumi.getter(name="displayName")
-    def display_name(self) -> str:
+    def display_name(self) -> _builtins.str:
         """
         (Required String) A human-readable name for the Certificate Pool.
         """
         return pulumi.get(self, "display_name")
 
-    @property
+    @_builtins.property
     @pulumi.getter(name="externalIdentifier")
-    def external_identifier(self) -> str:
+    def external_identifier(self) -> _builtins.str:
         """
         (Required String) The certificate field that will be used to represent the pool's external identity for audit logging, for example, `UID`.
         """
         return pulumi.get(self, "external_identifier")
 
-    @property
+    @_builtins.property
     @pulumi.getter
-    def filter(self) -> str:
+    def filter(self) -> _builtins.str:
         """
         (Required String) A filter expression in [Supported Common Expression Language (CEL)](https://docs.confluent.io/cloud/current/access-management/authenticate/mtls/cel-filters.html) that specifies which identities can authenticate using your certificate pool.
         """
         return pulumi.get(self, "filter")
 
-    @property
+    @_builtins.property
     @pulumi.getter
-    def id(self) -> str:
+    def id(self) -> _builtins.str:
         return pulumi.get(self, "id")
 
 
@@ -106,10 +106,10 @@ class AwaitableGetCertificatePoolResult(GetCertificatePoolResult):
 
 
 def get_certificate_pool(certificate_authority: Optional[Union['GetCertificatePoolCertificateAuthorityArgs', 'GetCertificatePoolCertificateAuthorityArgsDict']] = None,
-                         id: Optional[str] = None,
+                         id: Optional[_builtins.str] = None,
                          opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableGetCertificatePoolResult:
     """
-    [![Limited Availability](https://img.shields.io/badge/Lifecycle%20Stage-Limited%20Availability-%2345c6e8)](https://docs.confluent.io/cloud/current/api.html#section/Versioning/API-Lifecycle-Policy)
+    [![General Availability](https://img.shields.io/badge/Lifecycle%20Stage-General%20Availability-%2345c6e8)](https://docs.confluent.io/cloud/current/api.html#section/Versioning/API-Lifecycle-Policy)
 
     `CertificatePool` describes a Certificate Pool data source.
 
@@ -127,7 +127,7 @@ def get_certificate_pool(certificate_authority: Optional[Union['GetCertificatePo
     ```
 
 
-    :param str id: The ID of the Certificate Pool, for example, `pool-abc123`.
+    :param _builtins.str id: The ID of the Certificate Pool, for example, `pool-abc123`.
     """
     __args__ = dict()
     __args__['certificateAuthority'] = certificate_authority
@@ -143,10 +143,10 @@ def get_certificate_pool(certificate_authority: Optional[Union['GetCertificatePo
         filter=pulumi.get(__ret__, 'filter'),
         id=pulumi.get(__ret__, 'id'))
 def get_certificate_pool_output(certificate_authority: Optional[pulumi.Input[Union['GetCertificatePoolCertificateAuthorityArgs', 'GetCertificatePoolCertificateAuthorityArgsDict']]] = None,
-                                id: Optional[pulumi.Input[str]] = None,
-                                opts: Optional[pulumi.InvokeOptions] = None) -> pulumi.Output[GetCertificatePoolResult]:
+                                id: Optional[pulumi.Input[_builtins.str]] = None,
+                                opts: Optional[Union[pulumi.InvokeOptions, pulumi.InvokeOutputOptions]] = None) -> pulumi.Output[GetCertificatePoolResult]:
     """
-    [![Limited Availability](https://img.shields.io/badge/Lifecycle%20Stage-Limited%20Availability-%2345c6e8)](https://docs.confluent.io/cloud/current/api.html#section/Versioning/API-Lifecycle-Policy)
+    [![General Availability](https://img.shields.io/badge/Lifecycle%20Stage-General%20Availability-%2345c6e8)](https://docs.confluent.io/cloud/current/api.html#section/Versioning/API-Lifecycle-Policy)
 
     `CertificatePool` describes a Certificate Pool data source.
 
@@ -164,12 +164,12 @@ def get_certificate_pool_output(certificate_authority: Optional[pulumi.Input[Uni
     ```
 
 
-    :param str id: The ID of the Certificate Pool, for example, `pool-abc123`.
+    :param _builtins.str id: The ID of the Certificate Pool, for example, `pool-abc123`.
     """
     __args__ = dict()
     __args__['certificateAuthority'] = certificate_authority
     __args__['id'] = id
-    opts = pulumi.InvokeOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
+    opts = pulumi.InvokeOutputOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
     __ret__ = pulumi.runtime.invoke_output('confluentcloud:index/getCertificatePool:getCertificatePool', __args__, opts=opts, typ=GetCertificatePoolResult)
     return __ret__.apply(lambda __response__: GetCertificatePoolResult(
         certificate_authority=pulumi.get(__response__, 'certificate_authority'),

pulumi_confluentcloud/get_cluster_link.py

@@ -0,0 +1,274 @@
+# coding=utf-8
+# *** WARNING: this file was generated by pulumi-language-python. ***
+# *** Do not edit by hand unless you're certain you know what you are doing! ***
+
+import builtins as _builtins
+import warnings
+import sys
+import pulumi
+import pulumi.runtime
+from typing import Any, Mapping, Optional, Sequence, Union, overload
+if sys.version_info >= (3, 11):
+    from typing import NotRequired, TypedDict, TypeAlias
+else:
+    from typing_extensions import NotRequired, TypedDict, TypeAlias
+from . import _utilities
+from . import outputs
+from ._inputs import *
+
+__all__ = [
+    'GetClusterLinkResult',
+    'AwaitableGetClusterLinkResult',
+    'get_cluster_link',
+    'get_cluster_link_output',
+]
+
+@pulumi.output_type
+class GetClusterLinkResult:
+    """
+    A collection of values returned by getClusterLink.
+    """
+    def __init__(__self__, cluster_link_id=None, config=None, credentials=None, id=None, kafka_cluster=None, link_name=None, link_state=None, rest_endpoint=None):
+        if cluster_link_id and not isinstance(cluster_link_id, str):
+            raise TypeError("Expected argument 'cluster_link_id' to be a str")
+        pulumi.set(__self__, "cluster_link_id", cluster_link_id)
+        if config and not isinstance(config, dict):
+            raise TypeError("Expected argument 'config' to be a dict")
+        pulumi.set(__self__, "config", config)
+        if credentials and not isinstance(credentials, dict):
+            raise TypeError("Expected argument 'credentials' to be a dict")
+        pulumi.set(__self__, "credentials", credentials)
+        if id and not isinstance(id, str):
+            raise TypeError("Expected argument 'id' to be a str")
+        pulumi.set(__self__, "id", id)
+        if kafka_cluster and not isinstance(kafka_cluster, dict):
+            raise TypeError("Expected argument 'kafka_cluster' to be a dict")
+        pulumi.set(__self__, "kafka_cluster", kafka_cluster)
+        if link_name and not isinstance(link_name, str):
+            raise TypeError("Expected argument 'link_name' to be a str")
+        pulumi.set(__self__, "link_name", link_name)
+        if link_state and not isinstance(link_state, str):
+            raise TypeError("Expected argument 'link_state' to be a str")
+        pulumi.set(__self__, "link_state", link_state)
+        if rest_endpoint and not isinstance(rest_endpoint, str):
+            raise TypeError("Expected argument 'rest_endpoint' to be a str")
+        pulumi.set(__self__, "rest_endpoint", rest_endpoint)
+
+    @_builtins.property
+    @pulumi.getter(name="clusterLinkId")
+    def cluster_link_id(self) -> _builtins.str:
+        """
+        (Required String) The actual Cluster Link ID assigned from Confluent Cloud that uniquely represents a link between two Kafka clusters, for example, `qz0HDEV-Qz2B5aPFpcWQJQ`.
+        """
+        return pulumi.get(self, "cluster_link_id")
+
+    @_builtins.property
+    @pulumi.getter
+    def config(self) -> Mapping[str, _builtins.str]:
+        """
+        (Optional Map) The custom cluster link settings retrieved:
+        """
+        return pulumi.get(self, "config")
+
+    @_builtins.property
+    @pulumi.getter
+    def credentials(self) -> Optional['outputs.GetClusterLinkCredentialsResult']:
+        return pulumi.get(self, "credentials")
+
+    @_builtins.property
+    @pulumi.getter
+    def id(self) -> _builtins.str:
+        """
+        (Required String) The composite ID of the Cluster Link data-source, in the format `<Kafka cluster ID>/<Cluster link name>`, for example, `lkc-abc123/my-cluster-link`.
+        """
+        return pulumi.get(self, "id")
+
+    @_builtins.property
+    @pulumi.getter(name="kafkaCluster")
+    def kafka_cluster(self) -> Optional['outputs.GetClusterLinkKafkaClusterResult']:
+        return pulumi.get(self, "kafka_cluster")
+
+    @_builtins.property
+    @pulumi.getter(name="linkName")
+    def link_name(self) -> _builtins.str:
+        return pulumi.get(self, "link_name")
+
+    @_builtins.property
+    @pulumi.getter(name="linkState")
+    def link_state(self) -> _builtins.str:
+        """
+        (Required String) The current state of the Cluster Link.
+        """
+        return pulumi.get(self, "link_state")
+
+    @_builtins.property
+    @pulumi.getter(name="restEndpoint")
+    def rest_endpoint(self) -> Optional[_builtins.str]:
+        return pulumi.get(self, "rest_endpoint")
+
+
+class AwaitableGetClusterLinkResult(GetClusterLinkResult):
+    # pylint: disable=using-constant-test
+    def __await__(self):
+        if False:
+            yield self
+        return GetClusterLinkResult(
+            cluster_link_id=self.cluster_link_id,
+            config=self.config,
+            credentials=self.credentials,
+            id=self.id,
+            kafka_cluster=self.kafka_cluster,
+            link_name=self.link_name,
+            link_state=self.link_state,
+            rest_endpoint=self.rest_endpoint)
+
+
+def get_cluster_link(credentials: Optional[Union['GetClusterLinkCredentialsArgs', 'GetClusterLinkCredentialsArgsDict']] = None,
+                     kafka_cluster: Optional[Union['GetClusterLinkKafkaClusterArgs', 'GetClusterLinkKafkaClusterArgsDict']] = None,
+                     link_name: Optional[_builtins.str] = None,
+                     rest_endpoint: Optional[_builtins.str] = None,
+                     opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableGetClusterLinkResult:
+    """
+    [![General Availability](https://img.shields.io/badge/Lifecycle%20Stage-General%20Availability-%2345c6e8)](https://docs.confluent.io/cloud/current/api.html#section/Versioning/API-Lifecycle-Policy)
+
+    `ClusterLink` describes a Cluster Link data source.
+
+    ## Example Usage
+
+    ### Option #1: Manage multiple Kafka clusters in the same Pulumi Stack
+
+    ```python
+    import pulumi
+    import pulumi_confluentcloud as confluentcloud
+
+    main = confluentcloud.get_cluster_link(link_name="main-link",
+        rest_endpoint=west["restEndpoint"],
+        kafka_cluster={
+            "id": west["id"],
+        },
+        credentials={
+            "key": app_manager_west_cluster_api_key["id"],
+            "secret": app_manager_west_cluster_api_key["secret"],
+        })
+    pulumi.export("kafkaClusterLinkId", main.cluster_link_id)
+    ```
+
+    ### Option #2: Manage a single Kafka cluster in the same Pulumi Stack
+
+    ```python
+    import pulumi
+    import pulumi_confluentcloud as confluentcloud
+
+    main = confluentcloud.get_cluster_link(link_name="main-link")
+    pulumi.export("kafkaClusterLinkId", main.cluster_link_id)
+    ```
+
+    ### Option #3: Manage Kafka cluster(s) in the same Pulumi Stack using OAuth authentication
+
+    ```python
+    import pulumi
+    import pulumi_confluentcloud as confluentcloud
+
+    main = confluentcloud.get_cluster_link(link_name="main-link",
+        rest_endpoint=west["restEndpoint"],
+        kafka_cluster={
+            "id": west["id"],
+        })
+    pulumi.export("kafkaClusterLinkId", main.cluster_link_id)
+    ```
+
+
+    :param _builtins.str link_name: The name of the cluster link, for example, `my-cluster-link`.
+    :param _builtins.str rest_endpoint: The REST endpoint of the Kafka cluster, for example, `https://pkc-00000.us-central1.gcp.confluent.cloud:443`).
+    """
+    __args__ = dict()
+    __args__['credentials'] = credentials
+    __args__['kafkaCluster'] = kafka_cluster
+    __args__['linkName'] = link_name
+    __args__['restEndpoint'] = rest_endpoint
+    opts = pulumi.InvokeOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
+    __ret__ = pulumi.runtime.invoke('confluentcloud:index/getClusterLink:getClusterLink', __args__, opts=opts, typ=GetClusterLinkResult).value
+
+    return AwaitableGetClusterLinkResult(
+        cluster_link_id=pulumi.get(__ret__, 'cluster_link_id'),
+        config=pulumi.get(__ret__, 'config'),
+        credentials=pulumi.get(__ret__, 'credentials'),
+        id=pulumi.get(__ret__, 'id'),
+        kafka_cluster=pulumi.get(__ret__, 'kafka_cluster'),
+        link_name=pulumi.get(__ret__, 'link_name'),
+        link_state=pulumi.get(__ret__, 'link_state'),
+        rest_endpoint=pulumi.get(__ret__, 'rest_endpoint'))
+def get_cluster_link_output(credentials: Optional[pulumi.Input[Optional[Union['GetClusterLinkCredentialsArgs', 'GetClusterLinkCredentialsArgsDict']]]] = None,
+                            kafka_cluster: Optional[pulumi.Input[Optional[Union['GetClusterLinkKafkaClusterArgs', 'GetClusterLinkKafkaClusterArgsDict']]]] = None,
+                            link_name: Optional[pulumi.Input[_builtins.str]] = None,
+                            rest_endpoint: Optional[pulumi.Input[Optional[_builtins.str]]] = None,
+                            opts: Optional[Union[pulumi.InvokeOptions, pulumi.InvokeOutputOptions]] = None) -> pulumi.Output[GetClusterLinkResult]:
+    """
+    [![General Availability](https://img.shields.io/badge/Lifecycle%20Stage-General%20Availability-%2345c6e8)](https://docs.confluent.io/cloud/current/api.html#section/Versioning/API-Lifecycle-Policy)
+
+    `ClusterLink` describes a Cluster Link data source.
+
+    ## Example Usage
+
+    ### Option #1: Manage multiple Kafka clusters in the same Pulumi Stack
+
+    ```python
+    import pulumi
+    import pulumi_confluentcloud as confluentcloud
+
+    main = confluentcloud.get_cluster_link(link_name="main-link",
+        rest_endpoint=west["restEndpoint"],
+        kafka_cluster={
+            "id": west["id"],
+        },
+        credentials={
+            "key": app_manager_west_cluster_api_key["id"],
+            "secret": app_manager_west_cluster_api_key["secret"],
+        })
+    pulumi.export("kafkaClusterLinkId", main.cluster_link_id)
+    ```
+
+    ### Option #2: Manage a single Kafka cluster in the same Pulumi Stack
+
+    ```python
+    import pulumi
+    import pulumi_confluentcloud as confluentcloud
+
+    main = confluentcloud.get_cluster_link(link_name="main-link")
+    pulumi.export("kafkaClusterLinkId", main.cluster_link_id)
+    ```
+
+    ### Option #3: Manage Kafka cluster(s) in the same Pulumi Stack using OAuth authentication
+
+    ```python
+    import pulumi
+    import pulumi_confluentcloud as confluentcloud
+
+    main = confluentcloud.get_cluster_link(link_name="main-link",
+        rest_endpoint=west["restEndpoint"],
+        kafka_cluster={
+            "id": west["id"],
+        })
+    pulumi.export("kafkaClusterLinkId", main.cluster_link_id)
+    ```
+
+
+    :param _builtins.str link_name: The name of the cluster link, for example, `my-cluster-link`.
+    :param _builtins.str rest_endpoint: The REST endpoint of the Kafka cluster, for example, `https://pkc-00000.us-central1.gcp.confluent.cloud:443`).
+    """
+    __args__ = dict()
+    __args__['credentials'] = credentials
+    __args__['kafkaCluster'] = kafka_cluster
+    __args__['linkName'] = link_name
+    __args__['restEndpoint'] = rest_endpoint
+    opts = pulumi.InvokeOutputOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
+    __ret__ = pulumi.runtime.invoke_output('confluentcloud:index/getClusterLink:getClusterLink', __args__, opts=opts, typ=GetClusterLinkResult)
+    return __ret__.apply(lambda __response__: GetClusterLinkResult(
+        cluster_link_id=pulumi.get(__response__, 'cluster_link_id'),
+        config=pulumi.get(__response__, 'config'),
+        credentials=pulumi.get(__response__, 'credentials'),
+        id=pulumi.get(__response__, 'id'),
+        kafka_cluster=pulumi.get(__response__, 'kafka_cluster'),
+        link_name=pulumi.get(__response__, 'link_name'),
+        link_state=pulumi.get(__response__, 'link_state'),
+        rest_endpoint=pulumi.get(__response__, 'rest_endpoint')))