pulumi-databricks 1.77.0a1761975834__py3-none-any.whl → 1.79.0a1762839813__py3-none-any.whl

pulumi_databricks/get_budget_policy.py

@@ -14,7 +14,6 @@ else:
     from typing_extensions import NotRequired, TypedDict, TypeAlias
 from . import _utilities
 from . import outputs
-from ._inputs import *
 
 __all__ = [
     'GetBudgetPolicyResult',
@@ -47,7 +46,7 @@ class GetBudgetPolicyResult:
 
     @_builtins.property
     @pulumi.getter(name="bindingWorkspaceIds")
-    def binding_workspace_ids(self) -> Optional[Sequence[_builtins.int]]:
+    def binding_workspace_ids(self) -> Sequence[_builtins.int]:
         """
         (list of integer) - List of workspaces that this budget policy will be exclusively bound to.
         An empty binding implies that this budget policy is open to any workspace in the account
@@ -56,7 +55,7 @@ class GetBudgetPolicyResult:
 
     @_builtins.property
     @pulumi.getter(name="customTags")
-    def custom_tags(self) -> Optional[Sequence['outputs.GetBudgetPolicyCustomTagResult']]:
+    def custom_tags(self) -> Sequence['outputs.GetBudgetPolicyCustomTagResult']:
         """
         (list of CustomPolicyTag) - A list of tags defined by the customer. At most 20 entries are allowed per policy
         """
@@ -80,7 +79,7 @@ class GetBudgetPolicyResult:
 
     @_builtins.property
     @pulumi.getter(name="policyName")
-    def policy_name(self) -> Optional[_builtins.str]:
+    def policy_name(self) -> _builtins.str:
         """
         (string) - The name of the policy.
         - Must be unique among active policies.
@@ -103,12 +102,11 @@ class AwaitableGetBudgetPolicyResult(GetBudgetPolicyResult):
             policy_name=self.policy_name)
 
 
-def get_budget_policy(binding_workspace_ids: Optional[Sequence[_builtins.int]] = None,
-                      custom_tags: Optional[Sequence[Union['GetBudgetPolicyCustomTagArgs', 'GetBudgetPolicyCustomTagArgsDict']]] = None,
-                      policy_id: Optional[_builtins.str] = None,
-                      policy_name: Optional[_builtins.str] = None,
+def get_budget_policy(policy_id: Optional[_builtins.str] = None,
                       opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableGetBudgetPolicyResult:
     """
+    [![Public Preview](https://img.shields.io/badge/Release_Stage-Public_Preview-yellowgreen)](https://docs.databricks.com/aws/en/release-notes/release-types)
+
     This data source can be used to get a single budget policy.
 
     > **Note** This data source can only be used with an account-level provider!
@@ -125,20 +123,10 @@ def get_budget_policy(binding_workspace_ids: Optional[Sequence[_builtins.int]] =
     ```
 
 
-    :param Sequence[_builtins.int] binding_workspace_ids: (list of integer) - List of workspaces that this budget policy will be exclusively bound to.
-           An empty binding implies that this budget policy is open to any workspace in the account
-    :param Sequence[Union['GetBudgetPolicyCustomTagArgs', 'GetBudgetPolicyCustomTagArgsDict']] custom_tags: (list of CustomPolicyTag) - A list of tags defined by the customer. At most 20 entries are allowed per policy
     :param _builtins.str policy_id: The Id of the policy. This field is generated by Databricks and globally unique
-    :param _builtins.str policy_name: (string) - The name of the policy.
-           - Must be unique among active policies.
-           - Can contain only characters from the ISO 8859-1 (latin1) set.
-           - Can't start with reserved keywords such as `databricks:default-policy`
     """
     __args__ = dict()
-    __args__['bindingWorkspaceIds'] = binding_workspace_ids
-    __args__['customTags'] = custom_tags
     __args__['policyId'] = policy_id
-    __args__['policyName'] = policy_name
     opts = pulumi.InvokeOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
     __ret__ = pulumi.runtime.invoke('databricks:index/getBudgetPolicy:getBudgetPolicy', __args__, opts=opts, typ=GetBudgetPolicyResult).value
 
@@ -148,12 +136,11 @@ def get_budget_policy(binding_workspace_ids: Optional[Sequence[_builtins.int]] =
         id=pulumi.get(__ret__, 'id'),
         policy_id=pulumi.get(__ret__, 'policy_id'),
         policy_name=pulumi.get(__ret__, 'policy_name'))
-def get_budget_policy_output(binding_workspace_ids: Optional[pulumi.Input[Optional[Sequence[_builtins.int]]]] = None,
-                             custom_tags: Optional[pulumi.Input[Optional[Sequence[Union['GetBudgetPolicyCustomTagArgs', 'GetBudgetPolicyCustomTagArgsDict']]]]] = None,
-                             policy_id: Optional[pulumi.Input[Optional[_builtins.str]]] = None,
-                             policy_name: Optional[pulumi.Input[Optional[_builtins.str]]] = None,
+def get_budget_policy_output(policy_id: Optional[pulumi.Input[_builtins.str]] = None,
                              opts: Optional[Union[pulumi.InvokeOptions, pulumi.InvokeOutputOptions]] = None) -> pulumi.Output[GetBudgetPolicyResult]:
     """
+    [![Public Preview](https://img.shields.io/badge/Release_Stage-Public_Preview-yellowgreen)](https://docs.databricks.com/aws/en/release-notes/release-types)
+
     This data source can be used to get a single budget policy.
 
     > **Note** This data source can only be used with an account-level provider!
@@ -170,20 +157,10 @@ def get_budget_policy_output(binding_workspace_ids: Optional[pulumi.Input[Option
     ```
 
 
-    :param Sequence[_builtins.int] binding_workspace_ids: (list of integer) - List of workspaces that this budget policy will be exclusively bound to.
-           An empty binding implies that this budget policy is open to any workspace in the account
-    :param Sequence[Union['GetBudgetPolicyCustomTagArgs', 'GetBudgetPolicyCustomTagArgsDict']] custom_tags: (list of CustomPolicyTag) - A list of tags defined by the customer. At most 20 entries are allowed per policy
     :param _builtins.str policy_id: The Id of the policy. This field is generated by Databricks and globally unique
-    :param _builtins.str policy_name: (string) - The name of the policy.
-           - Must be unique among active policies.
-           - Can contain only characters from the ISO 8859-1 (latin1) set.
-           - Can't start with reserved keywords such as `databricks:default-policy`
     """
     __args__ = dict()
-    __args__['bindingWorkspaceIds'] = binding_workspace_ids
-    __args__['customTags'] = custom_tags
     __args__['policyId'] = policy_id
-    __args__['policyName'] = policy_name
     opts = pulumi.InvokeOutputOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
     __ret__ = pulumi.runtime.invoke_output('databricks:index/getBudgetPolicy:getBudgetPolicy', __args__, opts=opts, typ=GetBudgetPolicyResult)
     return __ret__.apply(lambda __response__: GetBudgetPolicyResult(

pulumi_databricks/get_catalog.py

@@ -28,7 +28,7 @@ class GetCatalogResult:
     """
     A collection of values returned by getCatalog.
     """
-    def __init__(__self__, catalog_info=None, id=None, name=None):
+    def __init__(__self__, catalog_info=None, id=None, name=None, provider_config=None):
         if catalog_info and not isinstance(catalog_info, dict):
             raise TypeError("Expected argument 'catalog_info' to be a dict")
         pulumi.set(__self__, "catalog_info", catalog_info)
@@ -38,6 +38,9 @@ class GetCatalogResult:
         if name and not isinstance(name, str):
             raise TypeError("Expected argument 'name' to be a str")
         pulumi.set(__self__, "name", name)
+        if provider_config and not isinstance(provider_config, dict):
+            raise TypeError("Expected argument 'provider_config' to be a dict")
+        pulumi.set(__self__, "provider_config", provider_config)
 
     @_builtins.property
     @pulumi.getter(name="catalogInfo")
@@ -63,6 +66,11 @@ class GetCatalogResult:
         """
         return pulumi.get(self, "name")
 
+    @_builtins.property
+    @pulumi.getter(name="providerConfig")
+    def provider_config(self) -> Optional['outputs.GetCatalogProviderConfigResult']:
+        return pulumi.get(self, "provider_config")
+
 
 class AwaitableGetCatalogResult(GetCatalogResult):
     # pylint: disable=using-constant-test
@@ -72,12 +80,14 @@ class AwaitableGetCatalogResult(GetCatalogResult):
         return GetCatalogResult(
             catalog_info=self.catalog_info,
             id=self.id,
-            name=self.name)
+            name=self.name,
+            provider_config=self.provider_config)
 
 
 def get_catalog(catalog_info: Optional[Union['GetCatalogCatalogInfoArgs', 'GetCatalogCatalogInfoArgsDict']] = None,
                 id: Optional[_builtins.str] = None,
                 name: Optional[_builtins.str] = None,
+                provider_config: Optional[Union['GetCatalogProviderConfigArgs', 'GetCatalogProviderConfigArgsDict']] = None,
                 opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableGetCatalogResult:
     """
     Retrieves details of a specific catalog in Unity Catalog, that were created by Pulumi or manually. Use get_catalogs to retrieve IDs of multiple catalogs from Unity Catalog
@@ -112,21 +122,25 @@ def get_catalog(catalog_info: Optional[Union['GetCatalogCatalogInfoArgs', 'GetCa
     :param Union['GetCatalogCatalogInfoArgs', 'GetCatalogCatalogInfoArgsDict'] catalog_info: the [CatalogInfo](https://pkg.go.dev/github.com/databricks/databricks-sdk-go/service/catalog#CatalogInfo) object for a Unity Catalog catalog. This contains the following attributes (see ):
     :param _builtins.str id: same as the `name`
     :param _builtins.str name: name of the catalog
+    :param Union['GetCatalogProviderConfigArgs', 'GetCatalogProviderConfigArgsDict'] provider_config: Configure the provider for management through account provider. This block consists of the following fields:
     """
     __args__ = dict()
     __args__['catalogInfo'] = catalog_info
     __args__['id'] = id
     __args__['name'] = name
+    __args__['providerConfig'] = provider_config
     opts = pulumi.InvokeOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
     __ret__ = pulumi.runtime.invoke('databricks:index/getCatalog:getCatalog', __args__, opts=opts, typ=GetCatalogResult).value
 
     return AwaitableGetCatalogResult(
         catalog_info=pulumi.get(__ret__, 'catalog_info'),
         id=pulumi.get(__ret__, 'id'),
-        name=pulumi.get(__ret__, 'name'))
+        name=pulumi.get(__ret__, 'name'),
+        provider_config=pulumi.get(__ret__, 'provider_config'))
 def get_catalog_output(catalog_info: Optional[pulumi.Input[Optional[Union['GetCatalogCatalogInfoArgs', 'GetCatalogCatalogInfoArgsDict']]]] = None,
                        id: Optional[pulumi.Input[Optional[_builtins.str]]] = None,
                        name: Optional[pulumi.Input[_builtins.str]] = None,
+                       provider_config: Optional[pulumi.Input[Optional[Union['GetCatalogProviderConfigArgs', 'GetCatalogProviderConfigArgsDict']]]] = None,
                        opts: Optional[Union[pulumi.InvokeOptions, pulumi.InvokeOutputOptions]] = None) -> pulumi.Output[GetCatalogResult]:
     """
     Retrieves details of a specific catalog in Unity Catalog, that were created by Pulumi or manually. Use get_catalogs to retrieve IDs of multiple catalogs from Unity Catalog
@@ -161,14 +175,17 @@ def get_catalog_output(catalog_info: Optional[pulumi.Input[Optional[Union['GetCa
     :param Union['GetCatalogCatalogInfoArgs', 'GetCatalogCatalogInfoArgsDict'] catalog_info: the [CatalogInfo](https://pkg.go.dev/github.com/databricks/databricks-sdk-go/service/catalog#CatalogInfo) object for a Unity Catalog catalog. This contains the following attributes (see ):
     :param _builtins.str id: same as the `name`
     :param _builtins.str name: name of the catalog
+    :param Union['GetCatalogProviderConfigArgs', 'GetCatalogProviderConfigArgsDict'] provider_config: Configure the provider for management through account provider. This block consists of the following fields:
     """
     __args__ = dict()
     __args__['catalogInfo'] = catalog_info
     __args__['id'] = id
     __args__['name'] = name
+    __args__['providerConfig'] = provider_config
     opts = pulumi.InvokeOutputOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
     __ret__ = pulumi.runtime.invoke_output('databricks:index/getCatalog:getCatalog', __args__, opts=opts, typ=GetCatalogResult)
     return __ret__.apply(lambda __response__: GetCatalogResult(
         catalog_info=pulumi.get(__response__, 'catalog_info'),
         id=pulumi.get(__response__, 'id'),
-        name=pulumi.get(__response__, 'name')))
+        name=pulumi.get(__response__, 'name'),
+        provider_config=pulumi.get(__response__, 'provider_config')))

pulumi_databricks/get_catalogs.py

@@ -13,6 +13,8 @@ if sys.version_info >= (3, 11):
 else:
     from typing_extensions import NotRequired, TypedDict, TypeAlias
 from . import _utilities
+from . import outputs
+from ._inputs import *
 
 __all__ = [
     'GetCatalogsResult',
@@ -26,13 +28,16 @@ class GetCatalogsResult:
     """
     A collection of values returned by getCatalogs.
     """
-    def __init__(__self__, id=None, ids=None):
+    def __init__(__self__, id=None, ids=None, provider_config=None):
         if id and not isinstance(id, str):
             raise TypeError("Expected argument 'id' to be a str")
         pulumi.set(__self__, "id", id)
         if ids and not isinstance(ids, list):
             raise TypeError("Expected argument 'ids' to be a list")
         pulumi.set(__self__, "ids", ids)
+        if provider_config and not isinstance(provider_config, dict):
+            raise TypeError("Expected argument 'provider_config' to be a dict")
+        pulumi.set(__self__, "provider_config", provider_config)
 
     @_builtins.property
     @pulumi.getter
@@ -50,6 +55,11 @@ class GetCatalogsResult:
         """
         return pulumi.get(self, "ids")
 
+    @_builtins.property
+    @pulumi.getter(name="providerConfig")
+    def provider_config(self) -> Optional['outputs.GetCatalogsProviderConfigResult']:
+        return pulumi.get(self, "provider_config")
+
 
 class AwaitableGetCatalogsResult(GetCatalogsResult):
     # pylint: disable=using-constant-test
@@ -58,10 +68,12 @@ class AwaitableGetCatalogsResult(GetCatalogsResult):
             yield self
         return GetCatalogsResult(
             id=self.id,
-            ids=self.ids)
+            ids=self.ids,
+            provider_config=self.provider_config)
 
 
 def get_catalogs(ids: Optional[Sequence[_builtins.str]] = None,
+                 provider_config: Optional[Union['GetCatalogsProviderConfigArgs', 'GetCatalogsProviderConfigArgsDict']] = None,
                  opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableGetCatalogsResult:
     """
     Retrieves a list of Catalog ids, that were created by Pulumi or manually, so that special handling could be applied.
@@ -89,16 +101,20 @@ def get_catalogs(ids: Optional[Sequence[_builtins.str]] = None,
 
 
     :param Sequence[_builtins.str] ids: set of Catalog names
+    :param Union['GetCatalogsProviderConfigArgs', 'GetCatalogsProviderConfigArgsDict'] provider_config: Configure the provider for management through account provider. This block consists of the following fields:
     """
     __args__ = dict()
     __args__['ids'] = ids
+    __args__['providerConfig'] = provider_config
     opts = pulumi.InvokeOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
     __ret__ = pulumi.runtime.invoke('databricks:index/getCatalogs:getCatalogs', __args__, opts=opts, typ=GetCatalogsResult).value
 
     return AwaitableGetCatalogsResult(
         id=pulumi.get(__ret__, 'id'),
-        ids=pulumi.get(__ret__, 'ids'))
+        ids=pulumi.get(__ret__, 'ids'),
+        provider_config=pulumi.get(__ret__, 'provider_config'))
 def get_catalogs_output(ids: Optional[pulumi.Input[Optional[Sequence[_builtins.str]]]] = None,
+                        provider_config: Optional[pulumi.Input[Optional[Union['GetCatalogsProviderConfigArgs', 'GetCatalogsProviderConfigArgsDict']]]] = None,
                         opts: Optional[Union[pulumi.InvokeOptions, pulumi.InvokeOutputOptions]] = None) -> pulumi.Output[GetCatalogsResult]:
     """
     Retrieves a list of Catalog ids, that were created by Pulumi or manually, so that special handling could be applied.
@@ -126,11 +142,14 @@ def get_catalogs_output(ids: Optional[pulumi.Input[Optional[Sequence[_builtins.s
 
 
     :param Sequence[_builtins.str] ids: set of Catalog names
+    :param Union['GetCatalogsProviderConfigArgs', 'GetCatalogsProviderConfigArgsDict'] provider_config: Configure the provider for management through account provider. This block consists of the following fields:
     """
     __args__ = dict()
     __args__['ids'] = ids
+    __args__['providerConfig'] = provider_config
     opts = pulumi.InvokeOutputOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
     __ret__ = pulumi.runtime.invoke_output('databricks:index/getCatalogs:getCatalogs', __args__, opts=opts, typ=GetCatalogsResult)
     return __ret__.apply(lambda __response__: GetCatalogsResult(
         id=pulumi.get(__response__, 'id'),
-        ids=pulumi.get(__response__, 'ids')))
+        ids=pulumi.get(__response__, 'ids'),
+        provider_config=pulumi.get(__response__, 'provider_config')))

pulumi_databricks/get_cluster.py

@@ -28,7 +28,7 @@ class GetClusterResult:
     """
     A collection of values returned by getCluster.
     """
-    def __init__(__self__, cluster_id=None, cluster_info=None, cluster_name=None, id=None):
+    def __init__(__self__, cluster_id=None, cluster_info=None, cluster_name=None, id=None, provider_config=None):
         if cluster_id and not isinstance(cluster_id, str):
             raise TypeError("Expected argument 'cluster_id' to be a str")
         pulumi.set(__self__, "cluster_id", cluster_id)
@@ -41,6 +41,9 @@ class GetClusterResult:
         if id and not isinstance(id, str):
             raise TypeError("Expected argument 'id' to be a str")
         pulumi.set(__self__, "id", id)
+        if provider_config and not isinstance(provider_config, dict):
+            raise TypeError("Expected argument 'provider_config' to be a dict")
+        pulumi.set(__self__, "provider_config", provider_config)
 
     @_builtins.property
     @pulumi.getter(name="clusterId")
@@ -71,6 +74,11 @@ class GetClusterResult:
         """
         return pulumi.get(self, "id")
 
+    @_builtins.property
+    @pulumi.getter(name="providerConfig")
+    def provider_config(self) -> Optional['outputs.GetClusterProviderConfigResult']:
+        return pulumi.get(self, "provider_config")
+
 
 class AwaitableGetClusterResult(GetClusterResult):
     # pylint: disable=using-constant-test
@@ -81,13 +89,15 @@ class AwaitableGetClusterResult(GetClusterResult):
             cluster_id=self.cluster_id,
             cluster_info=self.cluster_info,
             cluster_name=self.cluster_name,
-            id=self.id)
+            id=self.id,
+            provider_config=self.provider_config)
 
 
 def get_cluster(cluster_id: Optional[_builtins.str] = None,
                 cluster_info: Optional[Union['GetClusterClusterInfoArgs', 'GetClusterClusterInfoArgsDict']] = None,
                 cluster_name: Optional[_builtins.str] = None,
                 id: Optional[_builtins.str] = None,
+                provider_config: Optional[Union['GetClusterProviderConfigArgs', 'GetClusterProviderConfigArgsDict']] = None,
                 opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableGetClusterResult:
     """
     Retrieves information about a Cluster using its id. This could be retrieved programmatically using get_clusters data source.
@@ -106,17 +116,46 @@ def get_cluster(cluster_id: Optional[_builtins.str] = None,
     all_get_cluster = {__key: databricks.get_cluster(cluster_id=__value) for __key, __value in all.ids}
     ```
 
+    ### Multiple clusters with the same name
+
+    When fetching a cluster whose name is not unique (including terminated but not permanently deleted clusters), you must use the `cluster_id` argument to uniquely identify the cluster. Combine this data source with `get_clusters` to get the `cluster_id` of the cluster you want to fetch.
+
+    ```python
+    import pulumi
+    import pulumi_databricks as databricks
+
+    my_cluster = databricks.get_clusters(cluster_name_contains="my-cluster",
+        filter_by={
+            "cluster_states": ["RUNNING"],
+        })
+    my_cluster_get_cluster = databricks.get_cluster(cluster_id=my_cluster.ids[0])
+    ```
+
+    ## Related Resources
+
+    The following resources are often used in the same context:
+
+    * End to end workspace management guide.
+    * Cluster to create [Databricks Clusters](https://docs.databricks.com/clusters/index.html).
+    * ClusterPolicy to create a Cluster policy, which limits the ability to create clusters based on a set of rules.
+    * InstancePool to manage [instance pools](https://docs.databricks.com/clusters/instance-pools/index.html) to reduce cluster start and auto-scaling times by maintaining a set of idle, ready-to-use instances.
+    * Job to manage [Databricks Jobs](https://docs.databricks.com/jobs.html) to run non-interactive code in a databricks_cluster.
+    * Library to install a [library](https://docs.databricks.com/libraries/index.html) on databricks_cluster.
+    * Pipeline to deploy [Lakeflow Declarative Pipelines](https://docs.databricks.com/aws/en/dlt).
+
 
     :param _builtins.str cluster_id: The id of the cluster.
     :param Union['GetClusterClusterInfoArgs', 'GetClusterClusterInfoArgsDict'] cluster_info: block, consisting of following fields:
     :param _builtins.str cluster_name: The exact name of the cluster to search. Can only be specified if there is exactly one cluster with the provided name.
     :param _builtins.str id: cluster ID
+    :param Union['GetClusterProviderConfigArgs', 'GetClusterProviderConfigArgsDict'] provider_config: Configure the provider for management through account provider. This block consists of the following fields:
     """
     __args__ = dict()
     __args__['clusterId'] = cluster_id
     __args__['clusterInfo'] = cluster_info
     __args__['clusterName'] = cluster_name
     __args__['id'] = id
+    __args__['providerConfig'] = provider_config
     opts = pulumi.InvokeOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
     __ret__ = pulumi.runtime.invoke('databricks:index/getCluster:getCluster', __args__, opts=opts, typ=GetClusterResult).value
 
@@ -124,11 +163,13 @@ def get_cluster(cluster_id: Optional[_builtins.str] = None,
         cluster_id=pulumi.get(__ret__, 'cluster_id'),
         cluster_info=pulumi.get(__ret__, 'cluster_info'),
         cluster_name=pulumi.get(__ret__, 'cluster_name'),
-        id=pulumi.get(__ret__, 'id'))
+        id=pulumi.get(__ret__, 'id'),
+        provider_config=pulumi.get(__ret__, 'provider_config'))
 def get_cluster_output(cluster_id: Optional[pulumi.Input[Optional[_builtins.str]]] = None,
                        cluster_info: Optional[pulumi.Input[Optional[Union['GetClusterClusterInfoArgs', 'GetClusterClusterInfoArgsDict']]]] = None,
                        cluster_name: Optional[pulumi.Input[Optional[_builtins.str]]] = None,
                        id: Optional[pulumi.Input[Optional[_builtins.str]]] = None,
+                       provider_config: Optional[pulumi.Input[Optional[Union['GetClusterProviderConfigArgs', 'GetClusterProviderConfigArgsDict']]]] = None,
                        opts: Optional[Union[pulumi.InvokeOptions, pulumi.InvokeOutputOptions]] = None) -> pulumi.Output[GetClusterResult]:
     """
     Retrieves information about a Cluster using its id. This could be retrieved programmatically using get_clusters data source.
@@ -147,21 +188,51 @@ def get_cluster_output(cluster_id: Optional[pulumi.Input[Optional[_builtins.str]
     all_get_cluster = {__key: databricks.get_cluster(cluster_id=__value) for __key, __value in all.ids}
     ```
 
+    ### Multiple clusters with the same name
+
+    When fetching a cluster whose name is not unique (including terminated but not permanently deleted clusters), you must use the `cluster_id` argument to uniquely identify the cluster. Combine this data source with `get_clusters` to get the `cluster_id` of the cluster you want to fetch.
+
+    ```python
+    import pulumi
+    import pulumi_databricks as databricks
+
+    my_cluster = databricks.get_clusters(cluster_name_contains="my-cluster",
+        filter_by={
+            "cluster_states": ["RUNNING"],
+        })
+    my_cluster_get_cluster = databricks.get_cluster(cluster_id=my_cluster.ids[0])
+    ```
+
+    ## Related Resources
+
+    The following resources are often used in the same context:
+
+    * End to end workspace management guide.
+    * Cluster to create [Databricks Clusters](https://docs.databricks.com/clusters/index.html).
+    * ClusterPolicy to create a Cluster policy, which limits the ability to create clusters based on a set of rules.
+    * InstancePool to manage [instance pools](https://docs.databricks.com/clusters/instance-pools/index.html) to reduce cluster start and auto-scaling times by maintaining a set of idle, ready-to-use instances.
+    * Job to manage [Databricks Jobs](https://docs.databricks.com/jobs.html) to run non-interactive code in a databricks_cluster.
+    * Library to install a [library](https://docs.databricks.com/libraries/index.html) on databricks_cluster.
+    * Pipeline to deploy [Lakeflow Declarative Pipelines](https://docs.databricks.com/aws/en/dlt).
+
 
     :param _builtins.str cluster_id: The id of the cluster.
     :param Union['GetClusterClusterInfoArgs', 'GetClusterClusterInfoArgsDict'] cluster_info: block, consisting of following fields:
     :param _builtins.str cluster_name: The exact name of the cluster to search. Can only be specified if there is exactly one cluster with the provided name.
     :param _builtins.str id: cluster ID
+    :param Union['GetClusterProviderConfigArgs', 'GetClusterProviderConfigArgsDict'] provider_config: Configure the provider for management through account provider. This block consists of the following fields:
     """
     __args__ = dict()
     __args__['clusterId'] = cluster_id
     __args__['clusterInfo'] = cluster_info
     __args__['clusterName'] = cluster_name
     __args__['id'] = id
+    __args__['providerConfig'] = provider_config
     opts = pulumi.InvokeOutputOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
     __ret__ = pulumi.runtime.invoke_output('databricks:index/getCluster:getCluster', __args__, opts=opts, typ=GetClusterResult)
     return __ret__.apply(lambda __response__: GetClusterResult(
         cluster_id=pulumi.get(__response__, 'cluster_id'),
         cluster_info=pulumi.get(__response__, 'cluster_info'),
         cluster_name=pulumi.get(__response__, 'cluster_name'),
-        id=pulumi.get(__response__, 'id')))
+        id=pulumi.get(__response__, 'id'),
+        provider_config=pulumi.get(__response__, 'provider_config')))

pulumi_databricks/get_cluster_policy.py

@@ -13,6 +13,8 @@ if sys.version_info >= (3, 11):
 else:
     from typing_extensions import NotRequired, TypedDict, TypeAlias
 from . import _utilities
+from . import outputs
+from ._inputs import *
 
 __all__ = [
     'GetClusterPolicyResult',
@@ -26,7 +28,7 @@ class GetClusterPolicyResult:
     """
     A collection of values returned by getClusterPolicy.
     """
-    def __init__(__self__, definition=None, description=None, id=None, is_default=None, max_clusters_per_user=None, name=None, policy_family_definition_overrides=None, policy_family_id=None):
+    def __init__(__self__, definition=None, description=None, id=None, is_default=None, max_clusters_per_user=None, name=None, policy_family_definition_overrides=None, policy_family_id=None, provider_config=None):
         if definition and not isinstance(definition, str):
             raise TypeError("Expected argument 'definition' to be a str")
         pulumi.set(__self__, "definition", definition)
@@ -51,6 +53,9 @@ class GetClusterPolicyResult:
         if policy_family_id and not isinstance(policy_family_id, str):
             raise TypeError("Expected argument 'policy_family_id' to be a str")
         pulumi.set(__self__, "policy_family_id", policy_family_id)
+        if provider_config and not isinstance(provider_config, dict):
+            raise TypeError("Expected argument 'provider_config' to be a dict")
+        pulumi.set(__self__, "provider_config", provider_config)
 
     @_builtins.property
     @pulumi.getter
@@ -113,6 +118,11 @@ class GetClusterPolicyResult:
         """
         return pulumi.get(self, "policy_family_id")
 
+    @_builtins.property
+    @pulumi.getter(name="providerConfig")
+    def provider_config(self) -> Optional['outputs.GetClusterPolicyProviderConfigResult']:
+        return pulumi.get(self, "provider_config")
+
 
 class AwaitableGetClusterPolicyResult(GetClusterPolicyResult):
     # pylint: disable=using-constant-test
@@ -127,7 +137,8 @@ class AwaitableGetClusterPolicyResult(GetClusterPolicyResult):
             max_clusters_per_user=self.max_clusters_per_user,
             name=self.name,
             policy_family_definition_overrides=self.policy_family_definition_overrides,
-            policy_family_id=self.policy_family_id)
+            policy_family_id=self.policy_family_id,
+            provider_config=self.provider_config)
 
 
 def get_cluster_policy(definition: Optional[_builtins.str] = None,
@@ -138,6 +149,7 @@ def get_cluster_policy(definition: Optional[_builtins.str] = None,
                        name: Optional[_builtins.str] = None,
                        policy_family_definition_overrides: Optional[_builtins.str] = None,
                        policy_family_id: Optional[_builtins.str] = None,
+                       provider_config: Optional[Union['GetClusterPolicyProviderConfigArgs', 'GetClusterPolicyProviderConfigArgsDict']] = None,
                        opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableGetClusterPolicyResult:
     """
     Retrieves information about databricks_cluster_policy.
@@ -165,6 +177,7 @@ def get_cluster_policy(definition: Optional[_builtins.str] = None,
     :param _builtins.str name: Name of the cluster policy. The cluster policy must exist before this resource can be planned.
     :param _builtins.str policy_family_definition_overrides: Policy definition JSON document expressed in Databricks [Policy Definition Language](https://docs.databricks.com/administration-guide/clusters/policies.html#cluster-policy-definitions).
     :param _builtins.str policy_family_id: ID of the policy family.
+    :param Union['GetClusterPolicyProviderConfigArgs', 'GetClusterPolicyProviderConfigArgsDict'] provider_config: Configure the provider for management through account provider. This block consists of the following fields:
     """
     __args__ = dict()
     __args__['definition'] = definition
@@ -175,6 +188,7 @@ def get_cluster_policy(definition: Optional[_builtins.str] = None,
     __args__['name'] = name
     __args__['policyFamilyDefinitionOverrides'] = policy_family_definition_overrides
     __args__['policyFamilyId'] = policy_family_id
+    __args__['providerConfig'] = provider_config
     opts = pulumi.InvokeOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
     __ret__ = pulumi.runtime.invoke('databricks:index/getClusterPolicy:getClusterPolicy', __args__, opts=opts, typ=GetClusterPolicyResult).value
 
@@ -186,7 +200,8 @@ def get_cluster_policy(definition: Optional[_builtins.str] = None,
         max_clusters_per_user=pulumi.get(__ret__, 'max_clusters_per_user'),
         name=pulumi.get(__ret__, 'name'),
         policy_family_definition_overrides=pulumi.get(__ret__, 'policy_family_definition_overrides'),
-        policy_family_id=pulumi.get(__ret__, 'policy_family_id'))
+        policy_family_id=pulumi.get(__ret__, 'policy_family_id'),
+        provider_config=pulumi.get(__ret__, 'provider_config'))
 def get_cluster_policy_output(definition: Optional[pulumi.Input[Optional[_builtins.str]]] = None,
                               description: Optional[pulumi.Input[Optional[_builtins.str]]] = None,
                               id: Optional[pulumi.Input[Optional[_builtins.str]]] = None,
@@ -195,6 +210,7 @@ def get_cluster_policy_output(definition: Optional[pulumi.Input[Optional[_builti
                               name: Optional[pulumi.Input[Optional[_builtins.str]]] = None,
                               policy_family_definition_overrides: Optional[pulumi.Input[Optional[_builtins.str]]] = None,
                               policy_family_id: Optional[pulumi.Input[Optional[_builtins.str]]] = None,
+                              provider_config: Optional[pulumi.Input[Optional[Union['GetClusterPolicyProviderConfigArgs', 'GetClusterPolicyProviderConfigArgsDict']]]] = None,
                               opts: Optional[Union[pulumi.InvokeOptions, pulumi.InvokeOutputOptions]] = None) -> pulumi.Output[GetClusterPolicyResult]:
     """
     Retrieves information about databricks_cluster_policy.
@@ -222,6 +238,7 @@ def get_cluster_policy_output(definition: Optional[pulumi.Input[Optional[_builti
     :param _builtins.str name: Name of the cluster policy. The cluster policy must exist before this resource can be planned.
     :param _builtins.str policy_family_definition_overrides: Policy definition JSON document expressed in Databricks [Policy Definition Language](https://docs.databricks.com/administration-guide/clusters/policies.html#cluster-policy-definitions).
     :param _builtins.str policy_family_id: ID of the policy family.
+    :param Union['GetClusterPolicyProviderConfigArgs', 'GetClusterPolicyProviderConfigArgsDict'] provider_config: Configure the provider for management through account provider. This block consists of the following fields:
     """
     __args__ = dict()
     __args__['definition'] = definition
@@ -232,6 +249,7 @@ def get_cluster_policy_output(definition: Optional[pulumi.Input[Optional[_builti
     __args__['name'] = name
     __args__['policyFamilyDefinitionOverrides'] = policy_family_definition_overrides
     __args__['policyFamilyId'] = policy_family_id
+    __args__['providerConfig'] = provider_config
     opts = pulumi.InvokeOutputOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
     __ret__ = pulumi.runtime.invoke_output('databricks:index/getClusterPolicy:getClusterPolicy', __args__, opts=opts, typ=GetClusterPolicyResult)
     return __ret__.apply(lambda __response__: GetClusterPolicyResult(
@@ -242,4 +260,5 @@ def get_cluster_policy_output(definition: Optional[pulumi.Input[Optional[_builti
         max_clusters_per_user=pulumi.get(__response__, 'max_clusters_per_user'),
         name=pulumi.get(__response__, 'name'),
         policy_family_definition_overrides=pulumi.get(__response__, 'policy_family_definition_overrides'),
-        policy_family_id=pulumi.get(__response__, 'policy_family_id')))
+        policy_family_id=pulumi.get(__response__, 'policy_family_id'),
+        provider_config=pulumi.get(__response__, 'provider_config')))