databricks-sdk 0.65.0__py3-none-any.whl → 0.66.0__py3-none-any.whl

databricks/sdk/service/pipelines.py

@@ -610,6 +610,10 @@ class IngestionPipelineDefinition:
     """Immutable. Identifier for the gateway that is used by this ingestion pipeline to communicate
     with the source database. This is used with connectors to databases like SQL Server."""
 
+    netsuite_jar_path: Optional[str] = None
+    """Netsuite only configuration. When the field is set for a netsuite connector, the jar stored in
+    the field will be validated and added to the classpath of pipeline's cluster."""
+
     objects: Optional[List[IngestionConfig]] = None
     """Required. Settings specifying tables to replicate and the destination for the replicated tables."""
 
@@ -631,6 +635,8 @@ class IngestionPipelineDefinition:
             body["connection_name"] = self.connection_name
         if self.ingestion_gateway_id is not None:
             body["ingestion_gateway_id"] = self.ingestion_gateway_id
+        if self.netsuite_jar_path is not None:
+            body["netsuite_jar_path"] = self.netsuite_jar_path
         if self.objects:
             body["objects"] = [v.as_dict() for v in self.objects]
         if self.source_configurations:
@@ -648,6 +654,8 @@ class IngestionPipelineDefinition:
             body["connection_name"] = self.connection_name
         if self.ingestion_gateway_id is not None:
             body["ingestion_gateway_id"] = self.ingestion_gateway_id
+        if self.netsuite_jar_path is not None:
+            body["netsuite_jar_path"] = self.netsuite_jar_path
         if self.objects:
             body["objects"] = self.objects
         if self.source_configurations:
@@ -664,6 +672,7 @@ class IngestionPipelineDefinition:
         return cls(
             connection_name=d.get("connection_name", None),
             ingestion_gateway_id=d.get("ingestion_gateway_id", None),
+            netsuite_jar_path=d.get("netsuite_jar_path", None),
             objects=_repeated_dict(d, "objects", IngestionConfig),
             source_configurations=_repeated_dict(d, "source_configurations", SourceConfig),
             source_type=_enum(d, "source_type", IngestionSourceType),
@@ -730,11 +739,97 @@ class IngestionPipelineDefinitionTableSpecificConfigQueryBasedConnectorConfig:
         )
 
 
+@dataclass
+class IngestionPipelineDefinitionWorkdayReportParameters:
+    incremental: Optional[bool] = None
+    """(Optional) Marks the report as incremental. This field is deprecated and should not be used. Use
+    `parameters` instead. The incremental behavior is now controlled by the `parameters` field."""
+
+    parameters: Optional[Dict[str, str]] = None
+    """Parameters for the Workday report. Each key represents the parameter name (e.g., "start_date",
+    "end_date"), and the corresponding value is a SQL-like expression used to compute the parameter
+    value at runtime. Example: { "start_date": "{ coalesce(current_offset(), date(\"2025-02-01\"))
+    }", "end_date": "{ current_date() - INTERVAL 1 DAY }" }"""
+
+    report_parameters: Optional[List[IngestionPipelineDefinitionWorkdayReportParametersQueryKeyValue]] = None
+    """(Optional) Additional custom parameters for Workday Report This field is deprecated and should
+    not be used. Use `parameters` instead."""
+
+    def as_dict(self) -> dict:
+        """Serializes the IngestionPipelineDefinitionWorkdayReportParameters into a dictionary suitable for use as a JSON request body."""
+        body = {}
+        if self.incremental is not None:
+            body["incremental"] = self.incremental
+        if self.parameters:
+            body["parameters"] = self.parameters
+        if self.report_parameters:
+            body["report_parameters"] = [v.as_dict() for v in self.report_parameters]
+        return body
+
+    def as_shallow_dict(self) -> dict:
+        """Serializes the IngestionPipelineDefinitionWorkdayReportParameters into a shallow dictionary of its immediate attributes."""
+        body = {}
+        if self.incremental is not None:
+            body["incremental"] = self.incremental
+        if self.parameters:
+            body["parameters"] = self.parameters
+        if self.report_parameters:
+            body["report_parameters"] = self.report_parameters
+        return body
+
+    @classmethod
+    def from_dict(cls, d: Dict[str, Any]) -> IngestionPipelineDefinitionWorkdayReportParameters:
+        """Deserializes the IngestionPipelineDefinitionWorkdayReportParameters from a dictionary."""
+        return cls(
+            incremental=d.get("incremental", None),
+            parameters=d.get("parameters", None),
+            report_parameters=_repeated_dict(
+                d, "report_parameters", IngestionPipelineDefinitionWorkdayReportParametersQueryKeyValue
+            ),
+        )
+
+
+@dataclass
+class IngestionPipelineDefinitionWorkdayReportParametersQueryKeyValue:
+    key: Optional[str] = None
+    """Key for the report parameter, can be a column name or other metadata"""
+
+    value: Optional[str] = None
+    """Value for the report parameter. Possible values it can take are these sql functions: 1.
+    coalesce(current_offset(), date("YYYY-MM-DD")) -> if current_offset() is null, then the passed
+    date, else current_offset() 2. current_date() 3. date_sub(current_date(), x) -> subtract x (some
+    non-negative integer) days from current date"""
+
+    def as_dict(self) -> dict:
+        """Serializes the IngestionPipelineDefinitionWorkdayReportParametersQueryKeyValue into a dictionary suitable for use as a JSON request body."""
+        body = {}
+        if self.key is not None:
+            body["key"] = self.key
+        if self.value is not None:
+            body["value"] = self.value
+        return body
+
+    def as_shallow_dict(self) -> dict:
+        """Serializes the IngestionPipelineDefinitionWorkdayReportParametersQueryKeyValue into a shallow dictionary of its immediate attributes."""
+        body = {}
+        if self.key is not None:
+            body["key"] = self.key
+        if self.value is not None:
+            body["value"] = self.value
+        return body
+
+    @classmethod
+    def from_dict(cls, d: Dict[str, Any]) -> IngestionPipelineDefinitionWorkdayReportParametersQueryKeyValue:
+        """Deserializes the IngestionPipelineDefinitionWorkdayReportParametersQueryKeyValue from a dictionary."""
+        return cls(key=d.get("key", None), value=d.get("value", None))
+
+
 class IngestionSourceType(Enum):
 
     BIGQUERY = "BIGQUERY"
     CONFLUENCE = "CONFLUENCE"
     DYNAMICS365 = "DYNAMICS365"
+    FOREIGN_CATALOG = "FOREIGN_CATALOG"
     GA4_RAW_DATA = "GA4_RAW_DATA"
     MANAGED_POSTGRESQL = "MANAGED_POSTGRESQL"
     META_MARKETING = "META_MARKETING"
@@ -2871,6 +2966,9 @@ class TableSpecificConfig:
     """The column names specifying the logical order of events in the source data. Delta Live Tables
     uses this sequencing to handle change events that arrive out of order."""
 
+    workday_report_parameters: Optional[IngestionPipelineDefinitionWorkdayReportParameters] = None
+    """(Optional) Additional custom parameters for Workday Report"""
+
     def as_dict(self) -> dict:
         """Serializes the TableSpecificConfig into a dictionary suitable for use as a JSON request body."""
         body = {}
@@ -2888,6 +2986,8 @@ class TableSpecificConfig:
             body["scd_type"] = self.scd_type.value
         if self.sequence_by:
             body["sequence_by"] = [v for v in self.sequence_by]
+        if self.workday_report_parameters:
+            body["workday_report_parameters"] = self.workday_report_parameters.as_dict()
         return body
 
     def as_shallow_dict(self) -> dict:
@@ -2907,6 +3007,8 @@ class TableSpecificConfig:
             body["scd_type"] = self.scd_type
         if self.sequence_by:
             body["sequence_by"] = self.sequence_by
+        if self.workday_report_parameters:
+            body["workday_report_parameters"] = self.workday_report_parameters
         return body
 
     @classmethod
@@ -2924,6 +3026,9 @@ class TableSpecificConfig:
             salesforce_include_formula_fields=d.get("salesforce_include_formula_fields", None),
             scd_type=_enum(d, "scd_type", TableSpecificConfigScdType),
             sequence_by=d.get("sequence_by", None),
+            workday_report_parameters=_from_dict(
+                d, "workday_report_parameters", IngestionPipelineDefinitionWorkdayReportParameters
+            ),
         )
 
 

databricks/sdk/service/settingsv2.py

@@ -322,44 +322,6 @@ class ClusterAutoRestartMessageMaintenanceWindowWindowStartTime:
         return cls(hours=d.get("hours", None), minutes=d.get("minutes", None))
 
 
-@dataclass
-class DefaultDataSecurityModeMessage:
-    """Changes the behaviour of Jobs service when creating job clusters.
-
-    Before this setting is introduced, all workspaces with metastore attached had behaviour matching
-    SINGLE_USER setting.
-
-    See: - go/defaultdatasecuritymode - go/defaultdatasecuritymode/setting - go/datasecuritymode"""
-
-    status: DefaultDataSecurityModeMessageStatus
-
-    def as_dict(self) -> dict:
-        """Serializes the DefaultDataSecurityModeMessage into a dictionary suitable for use as a JSON request body."""
-        body = {}
-        if self.status is not None:
-            body["status"] = self.status.value
-        return body
-
-    def as_shallow_dict(self) -> dict:
-        """Serializes the DefaultDataSecurityModeMessage into a shallow dictionary of its immediate attributes."""
-        body = {}
-        if self.status is not None:
-            body["status"] = self.status
-        return body
-
-    @classmethod
-    def from_dict(cls, d: Dict[str, Any]) -> DefaultDataSecurityModeMessage:
-        """Deserializes the DefaultDataSecurityModeMessage from a dictionary."""
-        return cls(status=_enum(d, "status", DefaultDataSecurityModeMessageStatus))
-
-
-class DefaultDataSecurityModeMessageStatus(Enum):
-
-    NOT_SET = "NOT_SET"
-    SINGLE_USER = "SINGLE_USER"
-    USER_ISOLATION = "USER_ISOLATION"
-
-
 @dataclass
 class IntegerMessage:
     value: Optional[int] = None
@@ -528,12 +490,9 @@ class Setting:
     aibi_dashboard_embedding_approved_domains: Optional[AibiDashboardEmbeddingApprovedDomains] = None
 
     automatic_cluster_update_workspace: Optional[ClusterAutoRestartMessage] = None
-    """todo: Mark these Public after onboarded to DSL"""
 
     boolean_val: Optional[BooleanMessage] = None
 
-    default_data_security_mode: Optional[DefaultDataSecurityModeMessage] = None
-
     effective_aibi_dashboard_embedding_access_policy: Optional[AibiDashboardEmbeddingAccessPolicy] = None
 
     effective_aibi_dashboard_embedding_approved_domains: Optional[AibiDashboardEmbeddingApprovedDomains] = None
@@ -542,8 +501,6 @@ class Setting:
 
     effective_boolean_val: Optional[BooleanMessage] = None
 
-    effective_default_data_security_mode: Optional[DefaultDataSecurityModeMessage] = None
-
     effective_integer_val: Optional[IntegerMessage] = None
 
     effective_personal_compute: Optional[PersonalComputeMessage] = None
@@ -574,8 +531,6 @@ class Setting:
             body["automatic_cluster_update_workspace"] = self.automatic_cluster_update_workspace.as_dict()
         if self.boolean_val:
             body["boolean_val"] = self.boolean_val.as_dict()
-        if self.default_data_security_mode:
-            body["default_data_security_mode"] = self.default_data_security_mode.as_dict()
         if self.effective_aibi_dashboard_embedding_access_policy:
             body["effective_aibi_dashboard_embedding_access_policy"] = (
                 self.effective_aibi_dashboard_embedding_access_policy.as_dict()
@@ -590,8 +545,6 @@ class Setting:
             )
         if self.effective_boolean_val:
             body["effective_boolean_val"] = self.effective_boolean_val.as_dict()
-        if self.effective_default_data_security_mode:
-            body["effective_default_data_security_mode"] = self.effective_default_data_security_mode.as_dict()
         if self.effective_integer_val:
             body["effective_integer_val"] = self.effective_integer_val.as_dict()
         if self.effective_personal_compute:
@@ -623,8 +576,6 @@ class Setting:
             body["automatic_cluster_update_workspace"] = self.automatic_cluster_update_workspace
         if self.boolean_val:
             body["boolean_val"] = self.boolean_val
-        if self.default_data_security_mode:
-            body["default_data_security_mode"] = self.default_data_security_mode
         if self.effective_aibi_dashboard_embedding_access_policy:
             body["effective_aibi_dashboard_embedding_access_policy"] = (
                 self.effective_aibi_dashboard_embedding_access_policy
@@ -637,8 +588,6 @@ class Setting:
             body["effective_automatic_cluster_update_workspace"] = self.effective_automatic_cluster_update_workspace
         if self.effective_boolean_val:
             body["effective_boolean_val"] = self.effective_boolean_val
-        if self.effective_default_data_security_mode:
-            body["effective_default_data_security_mode"] = self.effective_default_data_security_mode
         if self.effective_integer_val:
             body["effective_integer_val"] = self.effective_integer_val
         if self.effective_personal_compute:
@@ -673,7 +622,6 @@ class Setting:
                 d, "automatic_cluster_update_workspace", ClusterAutoRestartMessage
             ),
             boolean_val=_from_dict(d, "boolean_val", BooleanMessage),
-            default_data_security_mode=_from_dict(d, "default_data_security_mode", DefaultDataSecurityModeMessage),
             effective_aibi_dashboard_embedding_access_policy=_from_dict(
                 d, "effective_aibi_dashboard_embedding_access_policy", AibiDashboardEmbeddingAccessPolicy
             ),
@@ -684,9 +632,6 @@ class Setting:
                 d, "effective_automatic_cluster_update_workspace", ClusterAutoRestartMessage
             ),
             effective_boolean_val=_from_dict(d, "effective_boolean_val", BooleanMessage),
-            effective_default_data_security_mode=_from_dict(
-                d, "effective_default_data_security_mode", DefaultDataSecurityModeMessage
-            ),
             effective_integer_val=_from_dict(d, "effective_integer_val", IntegerMessage),
             effective_personal_compute=_from_dict(d, "effective_personal_compute", PersonalComputeMessage),
             effective_restrict_workspace_admins=_from_dict(
@@ -784,7 +729,8 @@ class AccountSettingsV2API:
         self._api = api_client
 
     def get_public_account_setting(self, name: str) -> Setting:
-        """Get a setting value at account level
+        """Get a setting value at account level. See :method:settingsv2/listaccountsettingsmetadata for list of
+        setting available via public APIs at account level.
 
         :param name: str
 
@@ -801,9 +747,8 @@ class AccountSettingsV2API:
     def list_account_settings_metadata(
         self, *, page_size: Optional[int] = None, page_token: Optional[str] = None
     ) -> Iterator[SettingsMetadata]:
-        """List valid setting keys and metadata. These settings are available to referenced via [GET
-        /api/2.1/settings/{name}](#~1api~1account~1settingsv2~1getpublicaccountsetting) and [PATCH
-        /api/2.1/settings/{name}](#~1api~1account~1settingsv2~patchpublicaccountsetting) APIs
+        """List valid setting keys and metadata. These settings are available to be referenced via GET
+        :method:settingsv2/getpublicaccountsetting and PATCH :method:settingsv2/patchpublicaccountsetting APIs
 
         :param page_size: int (optional)
           The maximum number of settings to return. The service may return fewer than this value. If
@@ -840,7 +785,8 @@ class AccountSettingsV2API:
             query["page_token"] = json["next_page_token"]
 
     def patch_public_account_setting(self, name: str, setting: Setting) -> Setting:
-        """Patch a setting value at account level
+        """Patch a setting value at account level. See :method:settingsv2/listaccountsettingsmetadata for list of
+        setting available via public APIs at account level.
 
         :param name: str
         :param setting: :class:`Setting`
@@ -866,7 +812,8 @@ class WorkspaceSettingsV2API:
         self._api = api_client
 
     def get_public_workspace_setting(self, name: str) -> Setting:
-        """Get a setting value at workspace level
+        """Get a setting value at workspace level. See :method:settingsv2/listworkspacesettingsmetadata for list
+        of setting available via public APIs.
 
         :param name: str
 
@@ -883,9 +830,9 @@ class WorkspaceSettingsV2API:
     def list_workspace_settings_metadata(
         self, *, page_size: Optional[int] = None, page_token: Optional[str] = None
     ) -> Iterator[SettingsMetadata]:
-        """List valid setting keys and metadata. These settings are available to referenced via [GET
-        /api/2.1/settings/{name}](#~1api~1workspace~1settingsv2~1getpublicworkspacesetting) and [PATCH
-        /api/2.1/settings/{name}](#~1api~1workspace~1settingsv2~patchpublicworkspacesetting) APIs
+        """List valid setting keys and metadata. These settings are available to be referenced via GET
+        :method:settingsv2/getpublicworkspacesetting and PATCH :method:settingsv2/patchpublicworkspacesetting
+        APIs
 
         :param page_size: int (optional)
           The maximum number of settings to return. The service may return fewer than this value. If
@@ -920,7 +867,8 @@ class WorkspaceSettingsV2API:
             query["page_token"] = json["next_page_token"]
 
     def patch_public_workspace_setting(self, name: str, setting: Setting) -> Setting:
-        """Patch a setting value at workspace level
+        """Patch a setting value at workspace level. See :method:settingsv2/listworkspacesettingsmetadata for
+        list of setting available via public APIs at workspace level.
 
         :param name: str
         :param setting: :class:`Setting`

databricks/sdk/service/sharing.py

@@ -2307,6 +2307,9 @@ class Table:
 class TableInternalAttributes:
     """Internal information for D2D sharing that should not be disclosed to external users."""
 
+    auxiliary_managed_location: Optional[str] = None
+    """Managed Delta Metadata location for foreign iceberg tables."""
+
     parent_storage_location: Optional[str] = None
     """Will be populated in the reconciliation response for VIEW and FOREIGN_TABLE, with the value of
     the parent UC entity's storage_location, following the same logic as getManagedEntityPath in
@@ -2327,6 +2330,8 @@ class TableInternalAttributes:
     def as_dict(self) -> dict:
         """Serializes the TableInternalAttributes into a dictionary suitable for use as a JSON request body."""
         body = {}
+        if self.auxiliary_managed_location is not None:
+            body["auxiliary_managed_location"] = self.auxiliary_managed_location
         if self.parent_storage_location is not None:
             body["parent_storage_location"] = self.parent_storage_location
         if self.storage_location is not None:
@@ -2340,6 +2345,8 @@ class TableInternalAttributes:
     def as_shallow_dict(self) -> dict:
         """Serializes the TableInternalAttributes into a shallow dictionary of its immediate attributes."""
         body = {}
+        if self.auxiliary_managed_location is not None:
+            body["auxiliary_managed_location"] = self.auxiliary_managed_location
         if self.parent_storage_location is not None:
             body["parent_storage_location"] = self.parent_storage_location
         if self.storage_location is not None:
@@ -2354,6 +2361,7 @@ class TableInternalAttributes:
     def from_dict(cls, d: Dict[str, Any]) -> TableInternalAttributes:
         """Deserializes the TableInternalAttributes from a dictionary."""
         return cls(
+            auxiliary_managed_location=d.get("auxiliary_managed_location", None),
             parent_storage_location=d.get("parent_storage_location", None),
             storage_location=d.get("storage_location", None),
             type=_enum(d, "type", TableInternalAttributesSharedTableType),
@@ -2366,8 +2374,10 @@ class TableInternalAttributesSharedTableType(Enum):
     DELTA_ICEBERG_TABLE = "DELTA_ICEBERG_TABLE"
     DIRECTORY_BASED_TABLE = "DIRECTORY_BASED_TABLE"
     FILE_BASED_TABLE = "FILE_BASED_TABLE"
+    FOREIGN_ICEBERG_TABLE = "FOREIGN_ICEBERG_TABLE"
     FOREIGN_TABLE = "FOREIGN_TABLE"
     MATERIALIZED_VIEW = "MATERIALIZED_VIEW"
+    METRIC_VIEW = "METRIC_VIEW"
     STREAMING_TABLE = "STREAMING_TABLE"
     VIEW = "VIEW"
 
@@ -3363,7 +3373,9 @@ class SharesAPI:
         res = self._api.do("GET", f"/api/2.1/unity-catalog/shares/{name}", query=query, headers=headers)
         return ShareInfo.from_dict(res)
 
-    def list(self, *, max_results: Optional[int] = None, page_token: Optional[str] = None) -> Iterator[ShareInfo]:
+    def list_shares(
+        self, *, max_results: Optional[int] = None, page_token: Optional[str] = None
+    ) -> Iterator[ShareInfo]:
         """Gets an array of data object shares from the metastore. The caller must be a metastore admin or the
         owner of the share. There is no guarantee of a specific ordering of the elements in the array.
 

databricks/sdk/service/sql.py

@@ -792,7 +792,8 @@ class AlertV2Evaluation:
     """Operator used for comparison in alert evaluation."""
 
     empty_result_state: Optional[AlertEvaluationState] = None
-    """Alert state if result is empty."""
+    """Alert state if result is empty. Please avoid setting this field to be `UNKNOWN` because
+    `UNKNOWN` state is planned to be deprecated."""
 
     last_evaluated_at: Optional[str] = None
     """Timestamp of the last evaluation."""
@@ -3914,13 +3915,18 @@ class ListAlertsResponseAlert:
 
 @dataclass
 class ListAlertsV2Response:
+    alerts: Optional[List[AlertV2]] = None
+
     next_page_token: Optional[str] = None
 
     results: Optional[List[AlertV2]] = None
+    """Deprecated. Use `alerts` instead."""
 
     def as_dict(self) -> dict:
         """Serializes the ListAlertsV2Response into a dictionary suitable for use as a JSON request body."""
         body = {}
+        if self.alerts:
+            body["alerts"] = [v.as_dict() for v in self.alerts]
         if self.next_page_token is not None:
             body["next_page_token"] = self.next_page_token
         if self.results:
@@ -3930,6 +3936,8 @@ class ListAlertsV2Response:
     def as_shallow_dict(self) -> dict:
         """Serializes the ListAlertsV2Response into a shallow dictionary of its immediate attributes."""
         body = {}
+        if self.alerts:
+            body["alerts"] = self.alerts
         if self.next_page_token is not None:
             body["next_page_token"] = self.next_page_token
         if self.results:
@@ -3939,7 +3947,11 @@ class ListAlertsV2Response:
     @classmethod
     def from_dict(cls, d: Dict[str, Any]) -> ListAlertsV2Response:
         """Deserializes the ListAlertsV2Response from a dictionary."""
-        return cls(next_page_token=d.get("next_page_token", None), results=_repeated_dict(d, "results", AlertV2))
+        return cls(
+            alerts=_repeated_dict(d, "alerts", AlertV2),
+            next_page_token=d.get("next_page_token", None),
+            results=_repeated_dict(d, "results", AlertV2),
+        )
 
 
 class ListOrder(Enum):
@@ -9534,7 +9546,7 @@ class WarehousesAPI:
         return GetWorkspaceWarehouseConfigResponse.from_dict(res)
 
     def list(self, *, run_as_user_id: Optional[int] = None) -> Iterator[EndpointInfo]:
-        """Lists all SQL warehouses that a user has manager permissions on.
+        """Lists all SQL warehouses that a user has access to.
 
         :param run_as_user_id: int (optional)
           Service Principal which will be used to fetch the list of warehouses. If not specified, the user

databricks/sdk/service/tags.py

@@ -50,21 +50,31 @@ class ListTagPoliciesResponse:
 class TagPolicy:
     tag_key: str
 
+    create_time: Optional[str] = None
+    """Timestamp when the tag policy was created"""
+
     description: Optional[str] = None
 
     id: Optional[str] = None
 
+    update_time: Optional[str] = None
+    """Timestamp when the tag policy was last updated"""
+
     values: Optional[List[Value]] = None
 
     def as_dict(self) -> dict:
         """Serializes the TagPolicy into a dictionary suitable for use as a JSON request body."""
         body = {}
+        if self.create_time is not None:
+            body["create_time"] = self.create_time
         if self.description is not None:
             body["description"] = self.description
         if self.id is not None:
             body["id"] = self.id
         if self.tag_key is not None:
             body["tag_key"] = self.tag_key
+        if self.update_time is not None:
+            body["update_time"] = self.update_time
         if self.values:
             body["values"] = [v.as_dict() for v in self.values]
         return body
@@ -72,12 +82,16 @@ class TagPolicy:
     def as_shallow_dict(self) -> dict:
         """Serializes the TagPolicy into a shallow dictionary of its immediate attributes."""
         body = {}
+        if self.create_time is not None:
+            body["create_time"] = self.create_time
         if self.description is not None:
             body["description"] = self.description
         if self.id is not None:
             body["id"] = self.id
         if self.tag_key is not None:
             body["tag_key"] = self.tag_key
+        if self.update_time is not None:
+            body["update_time"] = self.update_time
         if self.values:
             body["values"] = self.values
         return body
@@ -86,9 +100,11 @@ class TagPolicy:
     def from_dict(cls, d: Dict[str, Any]) -> TagPolicy:
         """Deserializes the TagPolicy from a dictionary."""
         return cls(
+            create_time=d.get("create_time", None),
             description=d.get("description", None),
             id=d.get("id", None),
             tag_key=d.get("tag_key", None),
+            update_time=d.get("update_time", None),
             values=_repeated_dict(d, "values", Value),
         )
 
@@ -118,13 +134,16 @@ class Value:
 
 
 class TagPoliciesAPI:
-    """The Tag Policy API allows you to manage tag policies in Databricks."""
+    """The Tag Policy API allows you to manage policies for governed tags in Databricks. Permissions for tag
+    policies can be managed using the [Account Access Control Proxy API].
+
+    [Account Access Control Proxy API]: https://docs.databricks.com/api/workspace/accountaccesscontrolproxy"""
 
     def __init__(self, api_client):
         self._api = api_client
 
     def create_tag_policy(self, tag_policy: TagPolicy) -> TagPolicy:
-        """Creates a new tag policy.
+        """Creates a new tag policy, making the associated tag key governed.
 
         :param tag_policy: :class:`TagPolicy`
 
@@ -140,7 +159,7 @@ class TagPoliciesAPI:
         return TagPolicy.from_dict(res)
 
     def delete_tag_policy(self, tag_key: str):
-        """Deletes a tag policy by its key.
+        """Deletes a tag policy by its associated governed tag's key, leaving that tag key ungoverned.
 
         :param tag_key: str
 
@@ -154,7 +173,7 @@ class TagPoliciesAPI:
         self._api.do("DELETE", f"/api/2.1/tag-policies/{tag_key}", headers=headers)
 
     def get_tag_policy(self, tag_key: str) -> TagPolicy:
-        """Gets a single tag policy by its key.
+        """Gets a single tag policy by its associated governed tag's key.
 
         :param tag_key: str
 
@@ -171,7 +190,7 @@ class TagPoliciesAPI:
     def list_tag_policies(
         self, *, page_size: Optional[int] = None, page_token: Optional[str] = None
     ) -> Iterator[TagPolicy]:
-        """Lists all tag policies in the account.
+        """Lists the tag policies for all governed tags in the account.
 
         :param page_size: int (optional)
           The maximum number of results to return in this request. Fewer results may be returned than
@@ -202,7 +221,7 @@ class TagPoliciesAPI:
             query["page_token"] = json["next_page_token"]
 
     def update_tag_policy(self, tag_key: str, tag_policy: TagPolicy, update_mask: str) -> TagPolicy:
-        """Updates an existing tag policy.
+        """Updates an existing tag policy for a single governed tag.
 
         :param tag_key: str
         :param tag_policy: :class:`TagPolicy`

databricks/sdk/version.py

@@ -1 +1 @@
-__version__ = "0.65.0"
+__version__ = "0.66.0"

{databricks_sdk-0.65.0.dist-info → databricks_sdk-0.66.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: databricks-sdk
-Version: 0.65.0
+Version: 0.66.0
 Summary: Databricks SDK for Python (Beta)
 Project-URL: Documentation, https://databricks-sdk-py.readthedocs.io
 Keywords: databricks,sdk