pulumi-databricks 1.76.0__py3-none-any.whl → 1.79.0a1764800092__py3-none-any.whl

pulumi_databricks/apps_settings_custom_template.py

@@ -26,8 +26,7 @@ class AppsSettingsCustomTemplateArgs:
                  manifest: pulumi.Input['AppsSettingsCustomTemplateManifestArgs'],
                  path: pulumi.Input[_builtins.str],
                  description: Optional[pulumi.Input[_builtins.str]] = None,
-                 name: Optional[pulumi.Input[_builtins.str]] = None,
-                 workspace_id: Optional[pulumi.Input[_builtins.str]] = None):
+                 name: Optional[pulumi.Input[_builtins.str]] = None):
         """
         The set of arguments for constructing a AppsSettingsCustomTemplate resource.
         :param pulumi.Input[_builtins.str] git_provider: The Git provider of the template
@@ -37,7 +36,6 @@ class AppsSettingsCustomTemplateArgs:
         :param pulumi.Input[_builtins.str] description: The description of the template
         :param pulumi.Input[_builtins.str] name: The name of the template. It must contain only alphanumeric characters, hyphens, underscores, and whitespaces.
                It must be unique within the workspace
-        :param pulumi.Input[_builtins.str] workspace_id: Workspace ID of the resource
         """
         pulumi.set(__self__, "git_provider", git_provider)
         pulumi.set(__self__, "git_repo", git_repo)
@@ -47,8 +45,6 @@ class AppsSettingsCustomTemplateArgs:
             pulumi.set(__self__, "description", description)
         if name is not None:
             pulumi.set(__self__, "name", name)
-        if workspace_id is not None:
-            pulumi.set(__self__, "workspace_id", workspace_id)
 
     @_builtins.property
     @pulumi.getter(name="gitProvider")
@@ -123,18 +119,6 @@ class AppsSettingsCustomTemplateArgs:
     def name(self, value: Optional[pulumi.Input[_builtins.str]]):
         pulumi.set(self, "name", value)
 
-    @_builtins.property
-    @pulumi.getter(name="workspaceId")
-    def workspace_id(self) -> Optional[pulumi.Input[_builtins.str]]:
-        """
-        Workspace ID of the resource
-        """
-        return pulumi.get(self, "workspace_id")
-
-    @workspace_id.setter
-    def workspace_id(self, value: Optional[pulumi.Input[_builtins.str]]):
-        pulumi.set(self, "workspace_id", value)
-
 
 @pulumi.input_type
 class _AppsSettingsCustomTemplateState:
@@ -145,8 +129,7 @@ class _AppsSettingsCustomTemplateState:
                  git_repo: Optional[pulumi.Input[_builtins.str]] = None,
                  manifest: Optional[pulumi.Input['AppsSettingsCustomTemplateManifestArgs']] = None,
                  name: Optional[pulumi.Input[_builtins.str]] = None,
-                 path: Optional[pulumi.Input[_builtins.str]] = None,
-                 workspace_id: Optional[pulumi.Input[_builtins.str]] = None):
+                 path: Optional[pulumi.Input[_builtins.str]] = None):
         """
         Input properties used for looking up and filtering AppsSettingsCustomTemplate resources.
         :param pulumi.Input[_builtins.str] creator: (string)
@@ -157,7 +140,6 @@ class _AppsSettingsCustomTemplateState:
         :param pulumi.Input[_builtins.str] name: The name of the template. It must contain only alphanumeric characters, hyphens, underscores, and whitespaces.
                It must be unique within the workspace
         :param pulumi.Input[_builtins.str] path: The path to the template within the Git repository
-        :param pulumi.Input[_builtins.str] workspace_id: Workspace ID of the resource
         """
         if creator is not None:
             pulumi.set(__self__, "creator", creator)
@@ -173,8 +155,6 @@ class _AppsSettingsCustomTemplateState:
             pulumi.set(__self__, "name", name)
         if path is not None:
             pulumi.set(__self__, "path", path)
-        if workspace_id is not None:
-            pulumi.set(__self__, "workspace_id", workspace_id)
 
     @_builtins.property
     @pulumi.getter
@@ -261,18 +241,6 @@ class _AppsSettingsCustomTemplateState:
     def path(self, value: Optional[pulumi.Input[_builtins.str]]):
         pulumi.set(self, "path", value)
 
-    @_builtins.property
-    @pulumi.getter(name="workspaceId")
-    def workspace_id(self) -> Optional[pulumi.Input[_builtins.str]]:
-        """
-        Workspace ID of the resource
-        """
-        return pulumi.get(self, "workspace_id")
-
-    @workspace_id.setter
-    def workspace_id(self, value: Optional[pulumi.Input[_builtins.str]]):
-        pulumi.set(self, "workspace_id", value)
-
 
 @pulumi.type_token("databricks:index/appsSettingsCustomTemplate:AppsSettingsCustomTemplate")
 class AppsSettingsCustomTemplate(pulumi.CustomResource):
@@ -286,9 +254,10 @@ class AppsSettingsCustomTemplate(pulumi.CustomResource):
                  manifest: Optional[pulumi.Input[Union['AppsSettingsCustomTemplateManifestArgs', 'AppsSettingsCustomTemplateManifestArgsDict']]] = None,
                  name: Optional[pulumi.Input[_builtins.str]] = None,
                  path: Optional[pulumi.Input[_builtins.str]] = None,
-                 workspace_id: Optional[pulumi.Input[_builtins.str]] = None,
                  __props__=None):
         """
+        [![Private Preview](https://img.shields.io/badge/Release_Stage-Private_Preview-blueviolet)](https://docs.databricks.com/aws/en/release-notes/release-types)
+
         Custom App Templates store the metadata of custom app code hosted in an external Git repository, enabling users to reuse boilerplate code when creating apps.
 
         ## Example Usage
@@ -313,6 +282,65 @@ class AppsSettingsCustomTemplate(pulumi.CustomResource):
             })
         ```
 
+        ### Example with API Scopes
+
+        This example creates a custom template that declares required user API scopes.
+
+        ```python
+        import pulumi
+        import pulumi_databricks as databricks
+
+        api_scopes_example = databricks.AppsSettingsCustomTemplate("api_scopes_example",
+            name="my-api-template",
+            description="A template that requests user API scopes",
+            git_repo="https://github.com/example/my-app.git",
+            path="templates/app",
+            git_provider="github",
+            manifest={
+                "version": 1,
+                "name": "my-databricks-app",
+                "description": "This app requires the SQL API scope.",
+                "user_api_scopes": ["sql"],
+            })
+        ```
+
+        ### Example with Resource Requirements
+
+        This example defines a template that requests specific workspace resources with permissions granted.
+
+        ```python
+        import pulumi
+        import pulumi_databricks as databricks
+
+        resources_example = databricks.AppsSettingsCustomTemplate("resources_example",
+            name="my-resource-template",
+            description="Template that requires secret and SQL warehouse access",
+            git_repo="https://github.com/example/resource-app.git",
+            path="resource-template",
+            git_provider="github",
+            manifest={
+                "version": 1,
+                "name": "resource-consuming-app",
+                "description": "This app requires access to a secret and SQL warehouse.",
+                "resource_specs": [
+                    {
+                        "name": "my-secret",
+                        "description": "A secret needed by the app",
+                        "secret_spec": {
+                            "permission": "READ",
+                        },
+                    },
+                    {
+                        "name": "warehouse",
+                        "description": "Warehouse access",
+                        "sql_warehouse_spec": {
+                            "permission": "CAN_USE",
+                        },
+                    },
+                ],
+            })
+        ```
+
         ## Import
 
         As of Pulumi v1.5, resources can be imported through configuration.
@@ -330,7 +358,7 @@ class AppsSettingsCustomTemplate(pulumi.CustomResource):
         If you are using an older version of Pulumi, import the resource using the `pulumi import` command as follows:
 
         ```sh
-        $ pulumi import databricks:index/appsSettingsCustomTemplate:AppsSettingsCustomTemplate databricks_apps_settings_custom_template "name"
+        $ pulumi import databricks:index/appsSettingsCustomTemplate:AppsSettingsCustomTemplate this "name"
         ```
 
         :param str resource_name: The name of the resource.
@@ -342,7 +370,6 @@ class AppsSettingsCustomTemplate(pulumi.CustomResource):
         :param pulumi.Input[_builtins.str] name: The name of the template. It must contain only alphanumeric characters, hyphens, underscores, and whitespaces.
                It must be unique within the workspace
         :param pulumi.Input[_builtins.str] path: The path to the template within the Git repository
-        :param pulumi.Input[_builtins.str] workspace_id: Workspace ID of the resource
         """
         ...
     @overload
@@ -351,6 +378,8 @@ class AppsSettingsCustomTemplate(pulumi.CustomResource):
                  args: AppsSettingsCustomTemplateArgs,
                  opts: Optional[pulumi.ResourceOptions] = None):
         """
+        [![Private Preview](https://img.shields.io/badge/Release_Stage-Private_Preview-blueviolet)](https://docs.databricks.com/aws/en/release-notes/release-types)
+
         Custom App Templates store the metadata of custom app code hosted in an external Git repository, enabling users to reuse boilerplate code when creating apps.
 
         ## Example Usage
@@ -375,6 +404,65 @@ class AppsSettingsCustomTemplate(pulumi.CustomResource):
             })
         ```
 
+        ### Example with API Scopes
+
+        This example creates a custom template that declares required user API scopes.
+
+        ```python
+        import pulumi
+        import pulumi_databricks as databricks
+
+        api_scopes_example = databricks.AppsSettingsCustomTemplate("api_scopes_example",
+            name="my-api-template",
+            description="A template that requests user API scopes",
+            git_repo="https://github.com/example/my-app.git",
+            path="templates/app",
+            git_provider="github",
+            manifest={
+                "version": 1,
+                "name": "my-databricks-app",
+                "description": "This app requires the SQL API scope.",
+                "user_api_scopes": ["sql"],
+            })
+        ```
+
+        ### Example with Resource Requirements
+
+        This example defines a template that requests specific workspace resources with permissions granted.
+
+        ```python
+        import pulumi
+        import pulumi_databricks as databricks
+
+        resources_example = databricks.AppsSettingsCustomTemplate("resources_example",
+            name="my-resource-template",
+            description="Template that requires secret and SQL warehouse access",
+            git_repo="https://github.com/example/resource-app.git",
+            path="resource-template",
+            git_provider="github",
+            manifest={
+                "version": 1,
+                "name": "resource-consuming-app",
+                "description": "This app requires access to a secret and SQL warehouse.",
+                "resource_specs": [
+                    {
+                        "name": "my-secret",
+                        "description": "A secret needed by the app",
+                        "secret_spec": {
+                            "permission": "READ",
+                        },
+                    },
+                    {
+                        "name": "warehouse",
+                        "description": "Warehouse access",
+                        "sql_warehouse_spec": {
+                            "permission": "CAN_USE",
+                        },
+                    },
+                ],
+            })
+        ```
+
         ## Import
 
         As of Pulumi v1.5, resources can be imported through configuration.
@@ -392,7 +480,7 @@ class AppsSettingsCustomTemplate(pulumi.CustomResource):
         If you are using an older version of Pulumi, import the resource using the `pulumi import` command as follows:
 
         ```sh
-        $ pulumi import databricks:index/appsSettingsCustomTemplate:AppsSettingsCustomTemplate databricks_apps_settings_custom_template "name"
+        $ pulumi import databricks:index/appsSettingsCustomTemplate:AppsSettingsCustomTemplate this "name"
         ```
 
         :param str resource_name: The name of the resource.
@@ -416,7 +504,6 @@ class AppsSettingsCustomTemplate(pulumi.CustomResource):
                  manifest: Optional[pulumi.Input[Union['AppsSettingsCustomTemplateManifestArgs', 'AppsSettingsCustomTemplateManifestArgsDict']]] = None,
                  name: Optional[pulumi.Input[_builtins.str]] = None,
                  path: Optional[pulumi.Input[_builtins.str]] = None,
-                 workspace_id: Optional[pulumi.Input[_builtins.str]] = None,
                  __props__=None):
         opts = pulumi.ResourceOptions.merge(_utilities.get_resource_opts_defaults(), opts)
         if not isinstance(opts, pulumi.ResourceOptions):
@@ -440,7 +527,6 @@ class AppsSettingsCustomTemplate(pulumi.CustomResource):
             if path is None and not opts.urn:
                 raise TypeError("Missing required property 'path'")
             __props__.__dict__["path"] = path
-            __props__.__dict__["workspace_id"] = workspace_id
             __props__.__dict__["creator"] = None
         super(AppsSettingsCustomTemplate, __self__).__init__(
             'databricks:index/appsSettingsCustomTemplate:AppsSettingsCustomTemplate',
@@ -458,8 +544,7 @@ class AppsSettingsCustomTemplate(pulumi.CustomResource):
             git_repo: Optional[pulumi.Input[_builtins.str]] = None,
             manifest: Optional[pulumi.Input[Union['AppsSettingsCustomTemplateManifestArgs', 'AppsSettingsCustomTemplateManifestArgsDict']]] = None,
             name: Optional[pulumi.Input[_builtins.str]] = None,
-            path: Optional[pulumi.Input[_builtins.str]] = None,
-            workspace_id: Optional[pulumi.Input[_builtins.str]] = None) -> 'AppsSettingsCustomTemplate':
+            path: Optional[pulumi.Input[_builtins.str]] = None) -> 'AppsSettingsCustomTemplate':
         """
         Get an existing AppsSettingsCustomTemplate resource's state with the given name, id, and optional extra
         properties used to qualify the lookup.
@@ -475,7 +560,6 @@ class AppsSettingsCustomTemplate(pulumi.CustomResource):
         :param pulumi.Input[_builtins.str] name: The name of the template. It must contain only alphanumeric characters, hyphens, underscores, and whitespaces.
                It must be unique within the workspace
         :param pulumi.Input[_builtins.str] path: The path to the template within the Git repository
-        :param pulumi.Input[_builtins.str] workspace_id: Workspace ID of the resource
         """
         opts = pulumi.ResourceOptions.merge(opts, pulumi.ResourceOptions(id=id))
 
@@ -488,7 +572,6 @@ class AppsSettingsCustomTemplate(pulumi.CustomResource):
         __props__.__dict__["manifest"] = manifest
         __props__.__dict__["name"] = name
         __props__.__dict__["path"] = path
-        __props__.__dict__["workspace_id"] = workspace_id
         return AppsSettingsCustomTemplate(resource_name, opts=opts, __props__=__props__)
 
     @_builtins.property
@@ -548,11 +631,3 @@ class AppsSettingsCustomTemplate(pulumi.CustomResource):
         """
         return pulumi.get(self, "path")
 
-    @_builtins.property
-    @pulumi.getter(name="workspaceId")
-    def workspace_id(self) -> pulumi.Output[Optional[_builtins.str]]:
-        """
-        Workspace ID of the resource
-        """
-        return pulumi.get(self, "workspace_id")
-

pulumi_databricks/budget_policy.py

@@ -190,6 +190,8 @@ class BudgetPolicy(pulumi.CustomResource):
                  policy_name: Optional[pulumi.Input[_builtins.str]] = None,
                  __props__=None):
         """
+        [![Public Preview](https://img.shields.io/badge/Release_Stage-Public_Preview-yellowgreen)](https://docs.databricks.com/aws/en/release-notes/release-types)
+
         Administrators can use budget policies to ensure that the correct tags appear automatically on serverless resources without depending on users to attach tags manually, allowing for customized cost reporting and chargebacks.
 
         Budget policies consist of tags that are applied to any serverless compute activity incurred by a user assigned to the policy.
@@ -229,7 +231,7 @@ class BudgetPolicy(pulumi.CustomResource):
         If you are using an older version of Pulumi, import the resource using the `pulumi import` command as follows:
 
         ```sh
-        $ pulumi import databricks:index/budgetPolicy:BudgetPolicy databricks_budget_policy "policy_id"
+        $ pulumi import databricks:index/budgetPolicy:BudgetPolicy this "policy_id"
         ```
 
         :param str resource_name: The name of the resource.
@@ -250,6 +252,8 @@ class BudgetPolicy(pulumi.CustomResource):
                  args: Optional[BudgetPolicyArgs] = None,
                  opts: Optional[pulumi.ResourceOptions] = None):
         """
+        [![Public Preview](https://img.shields.io/badge/Release_Stage-Public_Preview-yellowgreen)](https://docs.databricks.com/aws/en/release-notes/release-types)
+
         Administrators can use budget policies to ensure that the correct tags appear automatically on serverless resources without depending on users to attach tags manually, allowing for customized cost reporting and chargebacks.
 
         Budget policies consist of tags that are applied to any serverless compute activity incurred by a user assigned to the policy.
@@ -289,7 +293,7 @@ class BudgetPolicy(pulumi.CustomResource):
         If you are using an older version of Pulumi, import the resource using the `pulumi import` command as follows:
 
         ```sh
-        $ pulumi import databricks:index/budgetPolicy:BudgetPolicy databricks_budget_policy "policy_id"
+        $ pulumi import databricks:index/budgetPolicy:BudgetPolicy this "policy_id"
         ```
 
         :param str resource_name: The name of the resource.

pulumi_databricks/catalog.py

@@ -36,7 +36,6 @@ class CatalogArgs:
                  provider_name: Optional[pulumi.Input[_builtins.str]] = None,
                  provisioning_info: Optional[pulumi.Input['CatalogProvisioningInfoArgs']] = None,
                  share_name: Optional[pulumi.Input[_builtins.str]] = None,
-                 storage_location: Optional[pulumi.Input[_builtins.str]] = None,
                  storage_root: Optional[pulumi.Input[_builtins.str]] = None):
         """
         The set of arguments for constructing a Catalog resource.
@@ -52,7 +51,7 @@ class CatalogArgs:
         :param pulumi.Input[Mapping[str, pulumi.Input[_builtins.str]]] properties: Extensible Catalog properties.
         :param pulumi.Input[_builtins.str] provider_name: For Delta Sharing Catalogs: the name of the delta sharing provider. Change forces creation of a new resource.
         :param pulumi.Input[_builtins.str] share_name: For Delta Sharing Catalogs: the name of the share under the share provider. Change forces creation of a new resource.
-        :param pulumi.Input[_builtins.str] storage_root: Managed location of the catalog. Location in cloud storage where data for managed tables will be stored. If not specified, the location will default to the metastore root location. Change forces creation of a new resource.
+        :param pulumi.Input[_builtins.str] storage_root: Managed location of the catalog. Location in cloud storage where data for managed tables will be stored.  If the URL contains special characters, such as space, `&`, etc., they should be percent-encoded (space > `%20`, etc.). If not specified, the location will default to the metastore root location. Change forces creation of a new resource.
         """
         if browse_only is not None:
             pulumi.set(__self__, "browse_only", browse_only)
@@ -84,8 +83,6 @@ class CatalogArgs:
             pulumi.set(__self__, "provisioning_info", provisioning_info)
         if share_name is not None:
             pulumi.set(__self__, "share_name", share_name)
-        if storage_location is not None:
-            pulumi.set(__self__, "storage_location", storage_location)
         if storage_root is not None:
             pulumi.set(__self__, "storage_root", storage_root)
 
@@ -260,20 +257,11 @@ class CatalogArgs:
     def share_name(self, value: Optional[pulumi.Input[_builtins.str]]):
         pulumi.set(self, "share_name", value)
 
-    @_builtins.property
-    @pulumi.getter(name="storageLocation")
-    def storage_location(self) -> Optional[pulumi.Input[_builtins.str]]:
-        return pulumi.get(self, "storage_location")
-
-    @storage_location.setter
-    def storage_location(self, value: Optional[pulumi.Input[_builtins.str]]):
-        pulumi.set(self, "storage_location", value)
-
     @_builtins.property
     @pulumi.getter(name="storageRoot")
     def storage_root(self) -> Optional[pulumi.Input[_builtins.str]]:
         """
-        Managed location of the catalog. Location in cloud storage where data for managed tables will be stored. If not specified, the location will default to the metastore root location. Change forces creation of a new resource.
+        Managed location of the catalog. Location in cloud storage where data for managed tables will be stored.  If the URL contains special characters, such as space, `&`, etc., they should be percent-encoded (space > `%20`, etc.). If not specified, the location will default to the metastore root location. Change forces creation of a new resource.
         """
         return pulumi.get(self, "storage_root")
 
@@ -311,8 +299,11 @@ class _CatalogState:
                  updated_by: Optional[pulumi.Input[_builtins.str]] = None):
         """
         Input properties used for looking up and filtering Catalog resources.
+        :param pulumi.Input[_builtins.str] catalog_type: the type of the catalog.
         :param pulumi.Input[_builtins.str] comment: User-supplied free-form text.
         :param pulumi.Input[_builtins.str] connection_name: For Foreign Catalogs: the name of the connection to an external data source. Changes forces creation of a new resource.
+        :param pulumi.Input[_builtins.int] created_at: time at which this catalog was created, in epoch milliseconds.
+        :param pulumi.Input[_builtins.str] created_by: username of catalog creator.
         :param pulumi.Input[_builtins.str] enable_predictive_optimization: Whether predictive optimization should be enabled for this object and objects under it. Can be `ENABLE`, `DISABLE` or `INHERIT`
         :param pulumi.Input[_builtins.bool] force_destroy: Delete catalog regardless of its contents.
         :param pulumi.Input[_builtins.str] isolation_mode: Whether the catalog is accessible from all workspaces or a specific set of workspaces. Can be `ISOLATED` or `OPEN`. Setting the catalog to `ISOLATED` will automatically allow access from the current workspace.
@@ -322,8 +313,12 @@ class _CatalogState:
         :param pulumi.Input[_builtins.str] owner: Username/groupname/sp application_id of the catalog owner.
         :param pulumi.Input[Mapping[str, pulumi.Input[_builtins.str]]] properties: Extensible Catalog properties.
         :param pulumi.Input[_builtins.str] provider_name: For Delta Sharing Catalogs: the name of the delta sharing provider. Change forces creation of a new resource.
+        :param pulumi.Input[_builtins.str] securable_type: the type of Unity Catalog securable.
         :param pulumi.Input[_builtins.str] share_name: For Delta Sharing Catalogs: the name of the share under the share provider. Change forces creation of a new resource.
-        :param pulumi.Input[_builtins.str] storage_root: Managed location of the catalog. Location in cloud storage where data for managed tables will be stored. If not specified, the location will default to the metastore root location. Change forces creation of a new resource.
+        :param pulumi.Input[_builtins.str] storage_location: effective storage Location URL (full path) for managed tables within catalog.
+        :param pulumi.Input[_builtins.str] storage_root: Managed location of the catalog. Location in cloud storage where data for managed tables will be stored.  If the URL contains special characters, such as space, `&`, etc., they should be percent-encoded (space > `%20`, etc.). If not specified, the location will default to the metastore root location. Change forces creation of a new resource.
+        :param pulumi.Input[_builtins.int] updated_at: time at which this catalog was last modified, in epoch milliseconds..
+        :param pulumi.Input[_builtins.str] updated_by: username of user who last modified catalog.
         """
         if browse_only is not None:
             pulumi.set(__self__, "browse_only", browse_only)
@@ -386,6 +381,9 @@ class _CatalogState:
     @_builtins.property
     @pulumi.getter(name="catalogType")
     def catalog_type(self) -> Optional[pulumi.Input[_builtins.str]]:
+        """
+        the type of the catalog.
+        """
         return pulumi.get(self, "catalog_type")
 
     @catalog_type.setter
@@ -419,6 +417,9 @@ class _CatalogState:
     @_builtins.property
     @pulumi.getter(name="createdAt")
     def created_at(self) -> Optional[pulumi.Input[_builtins.int]]:
+        """
+        time at which this catalog was created, in epoch milliseconds.
+        """
         return pulumi.get(self, "created_at")
 
     @created_at.setter
@@ -428,6 +429,9 @@ class _CatalogState:
     @_builtins.property
     @pulumi.getter(name="createdBy")
     def created_by(self) -> Optional[pulumi.Input[_builtins.str]]:
+        """
+        username of catalog creator.
+        """
         return pulumi.get(self, "created_by")
 
     @created_by.setter
@@ -572,6 +576,9 @@ class _CatalogState:
     @_builtins.property
     @pulumi.getter(name="securableType")
     def securable_type(self) -> Optional[pulumi.Input[_builtins.str]]:
+        """
+        the type of Unity Catalog securable.
+        """
         return pulumi.get(self, "securable_type")
 
     @securable_type.setter
@@ -593,6 +600,9 @@ class _CatalogState:
     @_builtins.property
     @pulumi.getter(name="storageLocation")
     def storage_location(self) -> Optional[pulumi.Input[_builtins.str]]:
+        """
+        effective storage Location URL (full path) for managed tables within catalog.
+        """
         return pulumi.get(self, "storage_location")
 
     @storage_location.setter
@@ -603,7 +613,7 @@ class _CatalogState:
     @pulumi.getter(name="storageRoot")
     def storage_root(self) -> Optional[pulumi.Input[_builtins.str]]:
         """
-        Managed location of the catalog. Location in cloud storage where data for managed tables will be stored. If not specified, the location will default to the metastore root location. Change forces creation of a new resource.
+        Managed location of the catalog. Location in cloud storage where data for managed tables will be stored.  If the URL contains special characters, such as space, `&`, etc., they should be percent-encoded (space > `%20`, etc.). If not specified, the location will default to the metastore root location. Change forces creation of a new resource.
         """
         return pulumi.get(self, "storage_root")
 
@@ -614,6 +624,9 @@ class _CatalogState:
     @_builtins.property
     @pulumi.getter(name="updatedAt")
     def updated_at(self) -> Optional[pulumi.Input[_builtins.int]]:
+        """
+        time at which this catalog was last modified, in epoch milliseconds..
+        """
         return pulumi.get(self, "updated_at")
 
     @updated_at.setter
@@ -623,6 +636,9 @@ class _CatalogState:
     @_builtins.property
     @pulumi.getter(name="updatedBy")
     def updated_by(self) -> Optional[pulumi.Input[_builtins.str]]:
+        """
+        username of user who last modified catalog.
+        """
         return pulumi.get(self, "updated_by")
 
     @updated_by.setter
@@ -651,7 +667,6 @@ class Catalog(pulumi.CustomResource):
                  provider_name: Optional[pulumi.Input[_builtins.str]] = None,
                  provisioning_info: Optional[pulumi.Input[Union['CatalogProvisioningInfoArgs', 'CatalogProvisioningInfoArgsDict']]] = None,
                  share_name: Optional[pulumi.Input[_builtins.str]] = None,
-                 storage_location: Optional[pulumi.Input[_builtins.str]] = None,
                  storage_root: Optional[pulumi.Input[_builtins.str]] = None,
                  __props__=None):
         """
@@ -719,7 +734,7 @@ class Catalog(pulumi.CustomResource):
         :param pulumi.Input[Mapping[str, pulumi.Input[_builtins.str]]] properties: Extensible Catalog properties.
         :param pulumi.Input[_builtins.str] provider_name: For Delta Sharing Catalogs: the name of the delta sharing provider. Change forces creation of a new resource.
         :param pulumi.Input[_builtins.str] share_name: For Delta Sharing Catalogs: the name of the share under the share provider. Change forces creation of a new resource.
-        :param pulumi.Input[_builtins.str] storage_root: Managed location of the catalog. Location in cloud storage where data for managed tables will be stored. If not specified, the location will default to the metastore root location. Change forces creation of a new resource.
+        :param pulumi.Input[_builtins.str] storage_root: Managed location of the catalog. Location in cloud storage where data for managed tables will be stored.  If the URL contains special characters, such as space, `&`, etc., they should be percent-encoded (space > `%20`, etc.). If not specified, the location will default to the metastore root location. Change forces creation of a new resource.
         """
         ...
     @overload
@@ -808,7 +823,6 @@ class Catalog(pulumi.CustomResource):
                  provider_name: Optional[pulumi.Input[_builtins.str]] = None,
                  provisioning_info: Optional[pulumi.Input[Union['CatalogProvisioningInfoArgs', 'CatalogProvisioningInfoArgsDict']]] = None,
                  share_name: Optional[pulumi.Input[_builtins.str]] = None,
-                 storage_location: Optional[pulumi.Input[_builtins.str]] = None,
                  storage_root: Optional[pulumi.Input[_builtins.str]] = None,
                  __props__=None):
         opts = pulumi.ResourceOptions.merge(_utilities.get_resource_opts_defaults(), opts)
@@ -834,13 +848,13 @@ class Catalog(pulumi.CustomResource):
             __props__.__dict__["provider_name"] = provider_name
             __props__.__dict__["provisioning_info"] = provisioning_info
             __props__.__dict__["share_name"] = share_name
-            __props__.__dict__["storage_location"] = storage_location
             __props__.__dict__["storage_root"] = storage_root
             __props__.__dict__["catalog_type"] = None
             __props__.__dict__["created_at"] = None
             __props__.__dict__["created_by"] = None
             __props__.__dict__["full_name"] = None
             __props__.__dict__["securable_type"] = None
+            __props__.__dict__["storage_location"] = None
             __props__.__dict__["updated_at"] = None
             __props__.__dict__["updated_by"] = None
         super(Catalog, __self__).__init__(
@@ -884,8 +898,11 @@ class Catalog(pulumi.CustomResource):
         :param str resource_name: The unique name of the resulting resource.
         :param pulumi.Input[str] id: The unique provider ID of the resource to lookup.
         :param pulumi.ResourceOptions opts: Options for the resource.
+        :param pulumi.Input[_builtins.str] catalog_type: the type of the catalog.
         :param pulumi.Input[_builtins.str] comment: User-supplied free-form text.
         :param pulumi.Input[_builtins.str] connection_name: For Foreign Catalogs: the name of the connection to an external data source. Changes forces creation of a new resource.
+        :param pulumi.Input[_builtins.int] created_at: time at which this catalog was created, in epoch milliseconds.
+        :param pulumi.Input[_builtins.str] created_by: username of catalog creator.
         :param pulumi.Input[_builtins.str] enable_predictive_optimization: Whether predictive optimization should be enabled for this object and objects under it. Can be `ENABLE`, `DISABLE` or `INHERIT`
         :param pulumi.Input[_builtins.bool] force_destroy: Delete catalog regardless of its contents.
         :param pulumi.Input[_builtins.str] isolation_mode: Whether the catalog is accessible from all workspaces or a specific set of workspaces. Can be `ISOLATED` or `OPEN`. Setting the catalog to `ISOLATED` will automatically allow access from the current workspace.
@@ -895,8 +912,12 @@ class Catalog(pulumi.CustomResource):
         :param pulumi.Input[_builtins.str] owner: Username/groupname/sp application_id of the catalog owner.
         :param pulumi.Input[Mapping[str, pulumi.Input[_builtins.str]]] properties: Extensible Catalog properties.
         :param pulumi.Input[_builtins.str] provider_name: For Delta Sharing Catalogs: the name of the delta sharing provider. Change forces creation of a new resource.
+        :param pulumi.Input[_builtins.str] securable_type: the type of Unity Catalog securable.
         :param pulumi.Input[_builtins.str] share_name: For Delta Sharing Catalogs: the name of the share under the share provider. Change forces creation of a new resource.
-        :param pulumi.Input[_builtins.str] storage_root: Managed location of the catalog. Location in cloud storage where data for managed tables will be stored. If not specified, the location will default to the metastore root location. Change forces creation of a new resource.
+        :param pulumi.Input[_builtins.str] storage_location: effective storage Location URL (full path) for managed tables within catalog.
+        :param pulumi.Input[_builtins.str] storage_root: Managed location of the catalog. Location in cloud storage where data for managed tables will be stored.  If the URL contains special characters, such as space, `&`, etc., they should be percent-encoded (space > `%20`, etc.). If not specified, the location will default to the metastore root location. Change forces creation of a new resource.
+        :param pulumi.Input[_builtins.int] updated_at: time at which this catalog was last modified, in epoch milliseconds..
+        :param pulumi.Input[_builtins.str] updated_by: username of user who last modified catalog.
         """
         opts = pulumi.ResourceOptions.merge(opts, pulumi.ResourceOptions(id=id))
 
@@ -936,6 +957,9 @@ class Catalog(pulumi.CustomResource):
     @_builtins.property
     @pulumi.getter(name="catalogType")
     def catalog_type(self) -> pulumi.Output[_builtins.str]:
+        """
+        the type of the catalog.
+        """
         return pulumi.get(self, "catalog_type")
 
     @_builtins.property
@@ -957,11 +981,17 @@ class Catalog(pulumi.CustomResource):
     @_builtins.property
     @pulumi.getter(name="createdAt")
     def created_at(self) -> pulumi.Output[_builtins.int]:
+        """
+        time at which this catalog was created, in epoch milliseconds.
+        """
         return pulumi.get(self, "created_at")
 
     @_builtins.property
     @pulumi.getter(name="createdBy")
     def created_by(self) -> pulumi.Output[_builtins.str]:
+        """
+        username of catalog creator.
+        """
         return pulumi.get(self, "created_by")
 
     @_builtins.property
@@ -1054,6 +1084,9 @@ class Catalog(pulumi.CustomResource):
     @_builtins.property
     @pulumi.getter(name="securableType")
     def securable_type(self) -> pulumi.Output[_builtins.str]:
+        """
+        the type of Unity Catalog securable.
+        """
         return pulumi.get(self, "securable_type")
 
     @_builtins.property
@@ -1066,24 +1099,33 @@ class Catalog(pulumi.CustomResource):
 
     @_builtins.property
     @pulumi.getter(name="storageLocation")
-    def storage_location(self) -> pulumi.Output[Optional[_builtins.str]]:
+    def storage_location(self) -> pulumi.Output[_builtins.str]:
+        """
+        effective storage Location URL (full path) for managed tables within catalog.
+        """
         return pulumi.get(self, "storage_location")
 
     @_builtins.property
     @pulumi.getter(name="storageRoot")
     def storage_root(self) -> pulumi.Output[Optional[_builtins.str]]:
         """
-        Managed location of the catalog. Location in cloud storage where data for managed tables will be stored. If not specified, the location will default to the metastore root location. Change forces creation of a new resource.
+        Managed location of the catalog. Location in cloud storage where data for managed tables will be stored.  If the URL contains special characters, such as space, `&`, etc., they should be percent-encoded (space > `%20`, etc.). If not specified, the location will default to the metastore root location. Change forces creation of a new resource.
         """
         return pulumi.get(self, "storage_root")
 
     @_builtins.property
     @pulumi.getter(name="updatedAt")
     def updated_at(self) -> pulumi.Output[_builtins.int]:
+        """
+        time at which this catalog was last modified, in epoch milliseconds..
+        """
         return pulumi.get(self, "updated_at")
 
     @_builtins.property
     @pulumi.getter(name="updatedBy")
     def updated_by(self) -> pulumi.Output[_builtins.str]:
+        """
+        username of user who last modified catalog.
+        """
         return pulumi.get(self, "updated_by")