update

Author: parthban-db

.codegen/_openapi_sha

@@ -1 +1 @@
-3da28310c39d8ab0067e1c5fecd0707add475a86
+5a1f970dc9331ab41755d374a90b811365927b42

NEXT_CHANGELOG.md

@@ -32,85 +32,6 @@
 * Added `internal_catalog_path_overlap_exception` and `internal_catalog_missing_uc_path_exception` enum values for `databricks.sdk.service.dashboards.MessageErrorType`.
 * Added `foreign_catalog` enum value for `databricks.sdk.service.pipelines.IngestionSourceType`.
 * Added `foreign_iceberg_table` enum value for `databricks.sdk.service.sharing.TableInternalAttributesSharedTableType`.
-* [Breaking] Changed `creation_time` field for `databricks.sdk.service.agentbricks.CustomLlm` to type `str` dataclass.
-* [Breaking] Changed `update_mask` field for `databricks.sdk.service.agentbricks.UpdateCustomLlmRequest` to type `str` dataclass.
-* [Breaking] Changed `create_time` and `update_time` fields for `databricks.sdk.service.apps.App` to type `str` dataclass.
-* [Breaking] Changed `create_time` and `update_time` fields for `databricks.sdk.service.apps.AppDeployment` to type `str` dataclass.
-* [Breaking] Changed `timestamp` field for `databricks.sdk.service.catalog.ContinuousUpdateStatus` to type `str` dataclass.
-* [Breaking] Changed `event_time` field for `databricks.sdk.service.catalog.ExternalLineageExternalMetadataInfo` to type `str` dataclass.
-* [Breaking] Changed `event_time` field for `databricks.sdk.service.catalog.ExternalLineageFileInfo` to type `str` dataclass.
-* [Breaking] Changed `event_time` field for `databricks.sdk.service.catalog.ExternalLineageModelVersionInfo` to type `str` dataclass.
-* [Breaking] Changed `event_time` field for `databricks.sdk.service.catalog.ExternalLineageTableInfo` to type `str` dataclass.
-* [Breaking] Changed `create_time` and `update_time` fields for `databricks.sdk.service.catalog.ExternalMetadata` to type `str` dataclass.
-* [Breaking] Changed `timestamp` field for `databricks.sdk.service.catalog.FailedStatus` to type `str` dataclass.
-* [Breaking] Changed `timestamp` field for `databricks.sdk.service.catalog.TriggeredUpdateStatus` to type `str` dataclass.
-* [Breaking] Changed `update_mask` field for `databricks.sdk.service.catalog.UpdateAccessRequestDestinationsRequest` to type `str` dataclass.
-* [Breaking] Changed `update_mask` field for `databricks.sdk.service.catalog.UpdateEntityTagAssignmentRequest` to type `str` dataclass.
-* [Breaking] Changed `update_mask` field for `databricks.sdk.service.catalog.UpdateExternalLineageRelationshipRequest` to type `str` dataclass.
-* [Breaking] Changed `update_mask` field for `databricks.sdk.service.catalog.UpdateExternalMetadataRequest` to type `str` dataclass.
-* [Breaking] Changed `update_mask` field for `databricks.sdk.service.catalog.UpdatePolicyRequest` to type `str` dataclass.
-* [Breaking] Changed `update_mask` field for `databricks.sdk.service.compute.UpdateCluster` to type `str` dataclass.
-* [Breaking] Changed `create_time` and `update_time` fields for `databricks.sdk.service.dashboards.Dashboard` to type `str` dataclass.
-* [Breaking] Changed `revision_create_time` field for `databricks.sdk.service.dashboards.PublishedDashboard` to type `str` dataclass.
-* [Breaking] Changed `create_time` and `update_time` fields for `databricks.sdk.service.dashboards.Schedule` to type `str` dataclass.
-* [Breaking] Changed `create_time` and `update_time` fields for `databricks.sdk.service.dashboards.Subscription` to type `str` dataclass.
-* [Breaking] Changed `expiration_time` field for `databricks.sdk.service.database.DatabaseCredential` to type `str` dataclass.
-* [Breaking] Changed `creation_time` field for `databricks.sdk.service.database.DatabaseInstance` to type `str` dataclass.
-* [Breaking] Changed `branch_time` field for `databricks.sdk.service.database.DatabaseInstanceRef` to type `str` dataclass.
-* [Breaking] Changed `delta_commit_timestamp` field for `databricks.sdk.service.database.DeltaTableSyncInfo` to type `str` dataclass.
-* [Breaking] Changed `timestamp` field for `databricks.sdk.service.database.SyncedTableContinuousUpdateStatus` to type `str` dataclass.
-* [Breaking] Changed `timestamp` field for `databricks.sdk.service.database.SyncedTableFailedStatus` to type `str` dataclass.
-* [Breaking] Changed `sync_end_timestamp` and `sync_start_timestamp` fields for `databricks.sdk.service.database.SyncedTablePosition` to type `str` dataclass.
-* [Breaking] Changed `timestamp` field for `databricks.sdk.service.database.SyncedTableTriggeredUpdateStatus` to type `str` dataclass.
-* [Breaking] Changed `update_mask` field for `databricks.sdk.service.database.UpdateDatabaseCatalogRequest` to type `str` dataclass.
-* [Breaking] Changed `update_mask` field for `databricks.sdk.service.database.UpdateDatabaseInstanceRequest` to type `str` dataclass.
-* [Breaking] Changed `update_mask` field for `databricks.sdk.service.database.UpdateSyncedDatabaseTableRequest` to type `str` dataclass.
-* [Breaking] Changed `creation_time` field for `databricks.sdk.service.ml.OnlineStore` to type `str` dataclass.
-* [Breaking] Changed `update_mask` field for `databricks.sdk.service.ml.UpdateFeatureTagRequest` to type `str` dataclass.
-* [Breaking] Changed `update_mask` field for `databricks.sdk.service.ml.UpdateOnlineStoreRequest` to type `str` dataclass.
-* [Breaking] Changed `lifetime` field for `databricks.sdk.service.oauth2.CreateServicePrincipalSecretRequest` to type `str` dataclass.
-* [Breaking] Changed `expire_time` field for `databricks.sdk.service.oauth2.CreateServicePrincipalSecretResponse` to type `str` dataclass.
-* [Breaking] Changed `create_time` and `update_time` fields for `databricks.sdk.service.oauth2.FederationPolicy` to type `str` dataclass.
-* [Breaking] Changed `expire_time` field for `databricks.sdk.service.oauth2.SecretInfo` to type `str` dataclass.
-* [Breaking] Changed `update_mask` field for `databricks.sdk.service.oauth2.UpdateAccountFederationPolicyRequest` to type `str` dataclass.
-* [Breaking] Changed `update_mask` field for `databricks.sdk.service.oauth2.UpdateServicePrincipalFederationPolicyRequest` to type `str` dataclass.
-* [Breaking] Changed `field_mask` field for `databricks.sdk.service.settings.UpdateAccountIpAccessEnableRequest` to type `str` dataclass.
-* [Breaking] Changed `field_mask` field for `databricks.sdk.service.settings.UpdateAibiDashboardEmbeddingAccessPolicySettingRequest` to type `str` dataclass.
-* [Breaking] Changed `field_mask` field for `databricks.sdk.service.settings.UpdateAibiDashboardEmbeddingApprovedDomainsSettingRequest` to type `str` dataclass.
-* [Breaking] Changed `field_mask` field for `databricks.sdk.service.settings.UpdateAutomaticClusterUpdateSettingRequest` to type `str` dataclass.
-* [Breaking] Changed `field_mask` field for `databricks.sdk.service.settings.UpdateComplianceSecurityProfileSettingRequest` to type `str` dataclass.
-* [Breaking] Changed `field_mask` field for `databricks.sdk.service.settings.UpdateCspEnablementAccountSettingRequest` to type `str` dataclass.
-* [Breaking] Changed `field_mask` field for `databricks.sdk.service.settings.UpdateDashboardEmailSubscriptionsRequest` to type `str` dataclass.
-* [Breaking] Changed `field_mask` field for `databricks.sdk.service.settings.UpdateDefaultNamespaceSettingRequest` to type `str` dataclass.
-* [Breaking] Changed `field_mask` field for `databricks.sdk.service.settings.UpdateDefaultWarehouseIdRequest` to type `str` dataclass.
-* [Breaking] Changed `field_mask` field for `databricks.sdk.service.settings.UpdateDisableLegacyAccessRequest` to type `str` dataclass.
-* [Breaking] Changed `field_mask` field for `databricks.sdk.service.settings.UpdateDisableLegacyDbfsRequest` to type `str` dataclass.
-* [Breaking] Changed `field_mask` field for `databricks.sdk.service.settings.UpdateDisableLegacyFeaturesRequest` to type `str` dataclass.
-* [Breaking] Changed `field_mask` field for `databricks.sdk.service.settings.UpdateEnableExportNotebookRequest` to type `str` dataclass.
-* [Breaking] Changed `field_mask` field for `databricks.sdk.service.settings.UpdateEnableNotebookTableClipboardRequest` to type `str` dataclass.
-* [Breaking] Changed `field_mask` field for `databricks.sdk.service.settings.UpdateEnableResultsDownloadingRequest` to type `str` dataclass.
-* [Breaking] Changed `field_mask` field for `databricks.sdk.service.settings.UpdateEnhancedSecurityMonitoringSettingRequest` to type `str` dataclass.
-* [Breaking] Changed `field_mask` field for `databricks.sdk.service.settings.UpdateEsmEnablementAccountSettingRequest` to type `str` dataclass.
-* [Breaking] Changed `field_mask` field for `databricks.sdk.service.settings.UpdateLlmProxyPartnerPoweredAccountRequest` to type `str` dataclass.
-* [Breaking] Changed `field_mask` field for `databricks.sdk.service.settings.UpdateLlmProxyPartnerPoweredEnforceRequest` to type `str` dataclass.
-* [Breaking] Changed `field_mask` field for `databricks.sdk.service.settings.UpdateLlmProxyPartnerPoweredWorkspaceRequest` to type `str` dataclass.
-* [Breaking] Changed `update_mask` field for `databricks.sdk.service.settings.UpdateNccPrivateEndpointRuleRequest` to type `str` dataclass.
-* [Breaking] Changed `field_mask` field for `databricks.sdk.service.settings.UpdatePersonalComputeSettingRequest` to type `str` dataclass.
-* [Breaking] Changed `field_mask` field for `databricks.sdk.service.settings.UpdateRestrictWorkspaceAdminsSettingRequest` to type `str` dataclass.
-* [Breaking] Changed `field_mask` field for `databricks.sdk.service.settings.UpdateSqlResultsDownloadRequest` to type `str` dataclass.
-* [Breaking] Changed `create_time` and `update_time` fields for `databricks.sdk.service.sharing.FederationPolicy` to type `str` dataclass.
-* [Breaking] Changed `update_mask` field for `databricks.sdk.service.sharing.UpdateFederationPolicyRequest` to type `str` dataclass.
-* [Breaking] Changed `create_time`, `trigger_time` and `update_time` fields for `databricks.sdk.service.sql.Alert` to type `str` dataclass.
-* [Breaking] Changed `create_time` and `update_time` fields for `databricks.sdk.service.sql.AlertV2` to type `str` dataclass.
-* [Breaking] Changed `last_evaluated_at` field for `databricks.sdk.service.sql.AlertV2Evaluation` to type `str` dataclass.
-* [Breaking] Changed `create_time`, `trigger_time` and `update_time` fields for `databricks.sdk.service.sql.ListAlertsResponseAlert` to type `str` dataclass.
-* [Breaking] Changed `create_time` and `update_time` fields for `databricks.sdk.service.sql.ListQueryObjectsResponseQuery` to type `str` dataclass.
-* [Breaking] Changed `create_time` and `update_time` fields for `databricks.sdk.service.sql.Query` to type `str` dataclass.
-* [Breaking] Changed `update_mask` field for `databricks.sdk.service.sql.UpdateAlertRequest` to type `str` dataclass.
-* [Breaking] Changed `update_mask` field for `databricks.sdk.service.sql.UpdateAlertV2Request` to type `str` dataclass.
-* [Breaking] Changed `update_mask` field for `databricks.sdk.service.sql.UpdateQueryRequest` to type `str` dataclass.
-* [Breaking] Changed `update_mask` field for `databricks.sdk.service.sql.UpdateVisualizationRequest` to type `str` dataclass.
-* [Breaking] Changed `create_time` and `update_time` fields for `databricks.sdk.service.sql.Visualization` to type `str` dataclass.
-* [Breaking] Changed `update_mask` field for `databricks.sdk.service.tags.UpdateTagPolicyRequest` to type `str` dataclass.
 * [Breaking] Removed `disabled` field for `databricks.sdk.service.jobs.RunTask`.
 * [Breaking] Removed `default_data_security_mode` and `effective_default_data_security_mode` fields for `databricks.sdk.service.settingsv2.Setting`.
+* Added `list_shares()` method for [w.shares](https://databricks-sdk-py.readthedocs.io/en/latest/workspace/sharing/shares.html) workspace-level service.

databricks/sdk/__init__.py

@@ -0,0 +1,44 @@
+from typing import Iterator, Optional
+
+from databricks.sdk.service import sharing
+from databricks.sdk.service.sharing import ShareInfo
+
+
+class SharesExt(sharing.SharesAPI):
+    def list(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.
+
+        :param max_results: int (optional)
+          Maximum number of shares to return. - when set to 0, the page length is set to a server configured
+          value (recommended); - when set to a value greater than 0, the page length is the minimum of this
+          value and a server configured value; - when set to a value less than 0, an invalid parameter error
+          is returned; - If not set, all valid shares are returned (not recommended). - Note: The number of
+          returned shares might be less than the specified max_results size, even zero. The only definitive
+          indication that no further shares can be fetched is when the next_page_token is unset from the
+          response.
+        :param page_token: str (optional)
+          Opaque pagination token to go to next page based on previous query.
+
+        :returns: Iterator over :class:`ShareInfo`
+        """
+
+        query = {}
+        if max_results is not None:
+            query["max_results"] = max_results
+        if page_token is not None:
+            query["page_token"] = page_token
+        headers = {
+            "Accept": "application/json",
+        }
+
+        if "max_results" not in query:
+            query["max_results"] = 0
+        while True:
+            json = self._api.do("GET", "/api/2.1/unity-catalog/shares", query=query, headers=headers)
+            if "shares" in json:
+                for v in json["shares"]:
+                    yield ShareInfo.from_dict(v)
+            if "next_page_token" not in json or not json["next_page_token"]:
+                return
+            query["page_token"] = json["next_page_token"]