databricks-sdk 0.55.0__py3-none-any.whl → 0.57.0__py3-none-any.whl

databricks/sdk/service/catalog.py

@@ -520,8 +520,10 @@ class AwsIamRole:
 
 @dataclass
 class AwsIamRoleRequest:
+    """The AWS IAM role configuration"""
+
     role_arn: str
-    """The Amazon Resource Name (ARN) of the AWS IAM role for S3 data access."""
+    """The Amazon Resource Name (ARN) of the AWS IAM role used to vend temporary credentials."""
 
     def as_dict(self) -> dict:
         """Serializes the AwsIamRoleRequest into a dictionary suitable for use as a JSON request body."""
@@ -545,11 +547,13 @@ class AwsIamRoleRequest:
 
 @dataclass
 class AwsIamRoleResponse:
+    """The AWS IAM role configuration"""
+
     role_arn: str
-    """The Amazon Resource Name (ARN) of the AWS IAM role for S3 data access."""
+    """The Amazon Resource Name (ARN) of the AWS IAM role used to vend temporary credentials."""
 
     external_id: Optional[str] = None
-    """The external ID used in role assumption to prevent confused deputy problem.."""
+    """The external ID used in role assumption to prevent the confused deputy problem."""
 
     unity_catalog_iam_arn: Optional[str] = None
     """The Amazon Resource Name (ARN) of the AWS IAM user managed by Databricks. This is the identity
@@ -659,9 +663,7 @@ class AzureManagedIdentity:
     `/subscriptions/{guid}/resourceGroups/{rg-name}/providers/Microsoft.Databricks/accessConnectors/{connector-name}`."""
 
     credential_id: Optional[str] = None
-    """The Databricks internal ID that represents this managed identity. This field is only used to
-    persist the credential_id once it is fetched from the credentials manager - as we only use the
-    protobuf serializer to store credentials, this ID gets persisted to the database. ."""
+    """The Databricks internal ID that represents this managed identity."""
 
     managed_identity_id: Optional[str] = None
     """The Azure resource ID of the managed identity. Use the format,
@@ -704,16 +706,18 @@ class AzureManagedIdentity:
 
 @dataclass
 class AzureManagedIdentityRequest:
+    """The Azure managed identity configuration."""
+
     access_connector_id: str
     """The Azure resource ID of the Azure Databricks Access Connector. Use the format
-    /subscriptions/{guid}/resourceGroups/{rg-name}/providers/Microsoft.Databricks/accessConnectors/{connector-name}."""
+    `/subscriptions/{guid}/resourceGroups/{rg-name}/providers/Microsoft.Databricks/accessConnectors/{connector-name}`."""
 
     managed_identity_id: Optional[str] = None
-    """The Azure resource ID of the managed identity. Use the format
-    /subscriptions/{guid}/resourceGroups/{rg-name}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identity-name}.
+    """The Azure resource ID of the managed identity. Use the format,
+    `/subscriptions/{guid}/resourceGroups/{rg-name}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identity-name}`
     This is only available for user-assgined identities. For system-assigned identities, the
     access_connector_id is used to identify the identity. If this field is not provided, then we
-    assume the AzureManagedIdentity is for a system-assigned identity."""
+    assume the AzureManagedIdentity is using the system-assigned identity."""
 
     def as_dict(self) -> dict:
         """Serializes the AzureManagedIdentityRequest into a dictionary suitable for use as a JSON request body."""
@@ -744,19 +748,21 @@ class AzureManagedIdentityRequest:
 
 @dataclass
 class AzureManagedIdentityResponse:
+    """The Azure managed identity configuration."""
+
     access_connector_id: str
     """The Azure resource ID of the Azure Databricks Access Connector. Use the format
-    /subscriptions/{guid}/resourceGroups/{rg-name}/providers/Microsoft.Databricks/accessConnectors/{connector-name}."""
+    `/subscriptions/{guid}/resourceGroups/{rg-name}/providers/Microsoft.Databricks/accessConnectors/{connector-name}`."""
 
     credential_id: Optional[str] = None
     """The Databricks internal ID that represents this managed identity."""
 
     managed_identity_id: Optional[str] = None
-    """The Azure resource ID of the managed identity. Use the format
-    /subscriptions/{guid}/resourceGroups/{rg-name}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identity-name}.
+    """The Azure resource ID of the managed identity. Use the format,
+    `/subscriptions/{guid}/resourceGroups/{rg-name}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identity-name}`
     This is only available for user-assgined identities. For system-assigned identities, the
     access_connector_id is used to identify the identity. If this field is not provided, then we
-    assume the AzureManagedIdentity is for a system-assigned identity."""
+    assume the AzureManagedIdentity is using the system-assigned identity."""
 
     def as_dict(self) -> dict:
         """Serializes the AzureManagedIdentityResponse into a dictionary suitable for use as a JSON request body."""
@@ -1162,14 +1168,17 @@ class CatalogType(Enum):
 
 @dataclass
 class CloudflareApiToken:
+    """The Cloudflare API token configuration. Read more at
+    https://developers.cloudflare.com/r2/api/s3/tokens/"""
+
     access_key_id: str
-    """The Cloudflare access key id of the token."""
+    """The access key ID associated with the API token."""
 
     secret_access_key: str
-    """The secret access token generated for the access key id"""
+    """The secret access token generated for the above access key ID."""
 
     account_id: str
-    """The account id associated with the API token."""
+    """The ID of the account associated with the API token."""
 
     def as_dict(self) -> dict:
         """Serializes the CloudflareApiToken into a dictionary suitable for use as a JSON request body."""
@@ -1414,7 +1423,7 @@ class ConnectionInfo:
     """Username of current owner of the connection."""
 
     properties: Optional[Dict[str, str]] = None
-    """An object containing map of key-value properties attached to the connection."""
+    """A map of key-value properties attached to the securable."""
 
     provisioning_info: Optional[ProvisioningInfo] = None
     """Status of an asynchronously provisioned resource."""
@@ -1422,7 +1431,8 @@ class ConnectionInfo:
     read_only: Optional[bool] = None
     """If the connection is read only."""
 
-    securable_type: Optional[str] = None
+    securable_type: Optional[SecurableType] = None
+    """The type of Unity Catalog securable."""
 
     updated_at: Optional[int] = None
     """Time at which this connection was updated, in epoch milliseconds."""
@@ -1465,7 +1475,7 @@ class ConnectionInfo:
         if self.read_only is not None:
             body["read_only"] = self.read_only
         if self.securable_type is not None:
-            body["securable_type"] = self.securable_type
+            body["securable_type"] = self.securable_type.value
         if self.updated_at is not None:
             body["updated_at"] = self.updated_at
         if self.updated_by is not None:
@@ -1533,7 +1543,7 @@ class ConnectionInfo:
             properties=d.get("properties", None),
             provisioning_info=_from_dict(d, "provisioning_info", ProvisioningInfo),
             read_only=d.get("read_only", None),
-            securable_type=d.get("securable_type", None),
+            securable_type=_enum(d, "securable_type", SecurableType),
             updated_at=d.get("updated_at", None),
             updated_by=d.get("updated_by", None),
             url=d.get("url", None),
@@ -1541,21 +1551,28 @@ class ConnectionInfo:
 
 
 class ConnectionType(Enum):
-    """The type of connection."""
+    """Next Id: 33"""
 
     BIGQUERY = "BIGQUERY"
     DATABRICKS = "DATABRICKS"
+    GA4_RAW_DATA = "GA4_RAW_DATA"
     GLUE = "GLUE"
     HIVE_METASTORE = "HIVE_METASTORE"
     HTTP = "HTTP"
     MYSQL = "MYSQL"
     ORACLE = "ORACLE"
     POSTGRESQL = "POSTGRESQL"
+    POWER_BI = "POWER_BI"
     REDSHIFT = "REDSHIFT"
+    SALESFORCE = "SALESFORCE"
+    SALESFORCE_DATA_CLOUD = "SALESFORCE_DATA_CLOUD"
+    SERVICENOW = "SERVICENOW"
     SNOWFLAKE = "SNOWFLAKE"
     SQLDW = "SQLDW"
     SQLSERVER = "SQLSERVER"
     TERADATA = "TERADATA"
+    UNKNOWN_CONNECTION_TYPE = "UNKNOWN_CONNECTION_TYPE"
+    WORKDAY_RAAS = "WORKDAY_RAAS"
 
 
 @dataclass
@@ -1706,7 +1723,7 @@ class CreateConnection:
     """User-provided free-form text description."""
 
     properties: Optional[Dict[str, str]] = None
-    """An object containing map of key-value properties attached to the connection."""
+    """A map of key-value properties attached to the securable."""
 
     read_only: Optional[bool] = None
     """If the connection is read only."""
@@ -1765,19 +1782,19 @@ class CreateCredentialRequest:
     metastore."""
 
     aws_iam_role: Optional[AwsIamRole] = None
-    """The AWS IAM role configuration"""
+    """The AWS IAM role configuration."""
 
     azure_managed_identity: Optional[AzureManagedIdentity] = None
     """The Azure managed identity configuration."""
 
     azure_service_principal: Optional[AzureServicePrincipal] = None
-    """The Azure service principal configuration. Only applicable when purpose is **STORAGE**."""
+    """The Azure service principal configuration."""
 
     comment: Optional[str] = None
     """Comment associated with the credential."""
 
     databricks_gcp_service_account: Optional[DatabricksGcpServiceAccount] = None
-    """GCP long-lived credential. Databricks-created Google Cloud Storage service account."""
+    """The Databricks managed GCP service account configuration."""
 
     purpose: Optional[CredentialPurpose] = None
     """Indicates the purpose of the credential."""
@@ -2202,9 +2219,7 @@ class CreateMetastore:
     """The user-specified name of the metastore."""
 
     region: Optional[str] = None
-    """Cloud region which the metastore serves (e.g., `us-west-2`, `westus`). The field can be omitted
-    in the __workspace-level__ __API__ but not in the __account-level__ __API__. If this field is
-    omitted, the region of the workspace receiving the request will be used."""
+    """Cloud region which the metastore serves (e.g., `us-west-2`, `westus`)."""
 
     storage_root: Optional[str] = None
     """The storage root URL for metastore"""
@@ -2243,7 +2258,7 @@ class CreateMetastoreAssignment:
     """The unique ID of the metastore."""
 
     default_catalog_name: str
-    """The name of the default catalog in the metastore. This field is depracted. Please use "Default
+    """The name of the default catalog in the metastore. This field is deprecated. Please use "Default
     Namespace API" to configure the default catalog for a Databricks workspace."""
 
     workspace_id: Optional[int] = None
@@ -2557,7 +2572,8 @@ class CreateSchema:
 @dataclass
 class CreateStorageCredential:
     name: str
-    """The credential name. The name must be unique within the metastore."""
+    """The credential name. The name must be unique among storage and service credentials within the
+    metastore."""
 
     aws_iam_role: Optional[AwsIamRoleRequest] = None
     """The AWS IAM role configuration."""
@@ -2578,7 +2594,8 @@ class CreateStorageCredential:
     """The Databricks managed GCP service account configuration."""
 
     read_only: Optional[bool] = None
-    """Whether the storage credential is only usable for read operations."""
+    """Whether the credential is usable only for read operations. Only applicable when purpose is
+    **STORAGE**."""
 
     skip_validation: Optional[bool] = None
     """Supplying true to this argument skips validation of the created credential."""
@@ -2754,13 +2771,13 @@ class CreateVolumeRequestContent:
 @dataclass
 class CredentialInfo:
     aws_iam_role: Optional[AwsIamRole] = None
-    """The AWS IAM role configuration"""
+    """The AWS IAM role configuration."""
 
     azure_managed_identity: Optional[AzureManagedIdentity] = None
     """The Azure managed identity configuration."""
 
     azure_service_principal: Optional[AzureServicePrincipal] = None
-    """The Azure service principal configuration. Only applicable when purpose is **STORAGE**."""
+    """The Azure service principal configuration."""
 
     comment: Optional[str] = None
     """Comment associated with the credential."""
@@ -2772,7 +2789,7 @@ class CredentialInfo:
     """Username of credential creator."""
 
     databricks_gcp_service_account: Optional[DatabricksGcpServiceAccount] = None
-    """GCP long-lived credential. Databricks-created Google Cloud Storage service account."""
+    """The Databricks managed GCP service account configuration."""
 
     full_name: Optional[str] = None
     """The full name of the credential."""
@@ -2924,9 +2941,19 @@ class CredentialPurpose(Enum):
 
 
 class CredentialType(Enum):
-    """The type of credential."""
+    """Next Id: 12"""
 
     BEARER_TOKEN = "BEARER_TOKEN"
+    OAUTH_ACCESS_TOKEN = "OAUTH_ACCESS_TOKEN"
+    OAUTH_M2M = "OAUTH_M2M"
+    OAUTH_REFRESH_TOKEN = "OAUTH_REFRESH_TOKEN"
+    OAUTH_RESOURCE_OWNER_PASSWORD = "OAUTH_RESOURCE_OWNER_PASSWORD"
+    OAUTH_U2M = "OAUTH_U2M"
+    OAUTH_U2M_MAPPING = "OAUTH_U2M_MAPPING"
+    OIDC_TOKEN = "OIDC_TOKEN"
+    PEM_PRIVATE_KEY = "PEM_PRIVATE_KEY"
+    SERVICE_CREDENTIAL = "SERVICE_CREDENTIAL"
+    UNKNOWN_CREDENTIAL_TYPE = "UNKNOWN_CREDENTIAL_TYPE"
     USERNAME_PASSWORD = "USERNAME_PASSWORD"
 
 
@@ -2990,191 +3017,12 @@ class DataSourceFormat(Enum):
     WORKDAY_RAAS_FORMAT = "WORKDAY_RAAS_FORMAT"
 
 
-@dataclass
-class DatabaseCatalog:
-    name: str
-    """The name of the catalog in UC."""
-
-    database_instance_name: str
-    """The name of the DatabaseInstance housing the database."""
-
-    database_name: str
-    """The name of the database (in a instance) associated with the catalog."""
-
-    create_database_if_not_exists: Optional[bool] = None
-
-    uid: Optional[str] = None
-
-    def as_dict(self) -> dict:
-        """Serializes the DatabaseCatalog into a dictionary suitable for use as a JSON request body."""
-        body = {}
-        if self.create_database_if_not_exists is not None:
-            body["create_database_if_not_exists"] = self.create_database_if_not_exists
-        if self.database_instance_name is not None:
-            body["database_instance_name"] = self.database_instance_name
-        if self.database_name is not None:
-            body["database_name"] = self.database_name
-        if self.name is not None:
-            body["name"] = self.name
-        if self.uid is not None:
-            body["uid"] = self.uid
-        return body
-
-    def as_shallow_dict(self) -> dict:
-        """Serializes the DatabaseCatalog into a shallow dictionary of its immediate attributes."""
-        body = {}
-        if self.create_database_if_not_exists is not None:
-            body["create_database_if_not_exists"] = self.create_database_if_not_exists
-        if self.database_instance_name is not None:
-            body["database_instance_name"] = self.database_instance_name
-        if self.database_name is not None:
-            body["database_name"] = self.database_name
-        if self.name is not None:
-            body["name"] = self.name
-        if self.uid is not None:
-            body["uid"] = self.uid
-        return body
-
-    @classmethod
-    def from_dict(cls, d: Dict[str, Any]) -> DatabaseCatalog:
-        """Deserializes the DatabaseCatalog from a dictionary."""
-        return cls(
-            create_database_if_not_exists=d.get("create_database_if_not_exists", None),
-            database_instance_name=d.get("database_instance_name", None),
-            database_name=d.get("database_name", None),
-            name=d.get("name", None),
-            uid=d.get("uid", None),
-        )
-
-
-@dataclass
-class DatabaseInstance:
-    """A DatabaseInstance represents a logical Postgres instance, comprised of both compute and
-    storage."""
-
-    name: str
-    """The name of the instance. This is the unique identifier for the instance."""
-
-    admin_password: Optional[str] = None
-    """Password for admin user to create. If not provided, no user will be created."""
-
-    admin_rolename: Optional[str] = None
-    """Name of the admin role for the instance. If not provided, defaults to 'databricks_admin'."""
-
-    capacity: Optional[str] = None
-    """The sku of the instance. Valid values are "CU_1", "CU_2", "CU_4"."""
-
-    creation_time: Optional[str] = None
-    """The timestamp when the instance was created."""
-
-    creator: Optional[str] = None
-    """The email of the creator of the instance."""
-
-    pg_version: Optional[str] = None
-    """The version of Postgres running on the instance."""
-
-    read_write_dns: Optional[str] = None
-    """The DNS endpoint to connect to the instance for read+write access."""
-
-    state: Optional[DatabaseInstanceState] = None
-    """The current state of the instance."""
-
-    stopped: Optional[bool] = None
-    """Whether the instance is stopped."""
-
-    uid: Optional[str] = None
-    """An immutable UUID identifier for the instance."""
-
-    def as_dict(self) -> dict:
-        """Serializes the DatabaseInstance into a dictionary suitable for use as a JSON request body."""
-        body = {}
-        if self.admin_password is not None:
-            body["admin_password"] = self.admin_password
-        if self.admin_rolename is not None:
-            body["admin_rolename"] = self.admin_rolename
-        if self.capacity is not None:
-            body["capacity"] = self.capacity
-        if self.creation_time is not None:
-            body["creation_time"] = self.creation_time
-        if self.creator is not None:
-            body["creator"] = self.creator
-        if self.name is not None:
-            body["name"] = self.name
-        if self.pg_version is not None:
-            body["pg_version"] = self.pg_version
-        if self.read_write_dns is not None:
-            body["read_write_dns"] = self.read_write_dns
-        if self.state is not None:
-            body["state"] = self.state.value
-        if self.stopped is not None:
-            body["stopped"] = self.stopped
-        if self.uid is not None:
-            body["uid"] = self.uid
-        return body
-
-    def as_shallow_dict(self) -> dict:
-        """Serializes the DatabaseInstance into a shallow dictionary of its immediate attributes."""
-        body = {}
-        if self.admin_password is not None:
-            body["admin_password"] = self.admin_password
-        if self.admin_rolename is not None:
-            body["admin_rolename"] = self.admin_rolename
-        if self.capacity is not None:
-            body["capacity"] = self.capacity
-        if self.creation_time is not None:
-            body["creation_time"] = self.creation_time
-        if self.creator is not None:
-            body["creator"] = self.creator
-        if self.name is not None:
-            body["name"] = self.name
-        if self.pg_version is not None:
-            body["pg_version"] = self.pg_version
-        if self.read_write_dns is not None:
-            body["read_write_dns"] = self.read_write_dns
-        if self.state is not None:
-            body["state"] = self.state
-        if self.stopped is not None:
-            body["stopped"] = self.stopped
-        if self.uid is not None:
-            body["uid"] = self.uid
-        return body
-
-    @classmethod
-    def from_dict(cls, d: Dict[str, Any]) -> DatabaseInstance:
-        """Deserializes the DatabaseInstance from a dictionary."""
-        return cls(
-            admin_password=d.get("admin_password", None),
-            admin_rolename=d.get("admin_rolename", None),
-            capacity=d.get("capacity", None),
-            creation_time=d.get("creation_time", None),
-            creator=d.get("creator", None),
-            name=d.get("name", None),
-            pg_version=d.get("pg_version", None),
-            read_write_dns=d.get("read_write_dns", None),
-            state=_enum(d, "state", DatabaseInstanceState),
-            stopped=d.get("stopped", None),
-            uid=d.get("uid", None),
-        )
-
-
-class DatabaseInstanceState(Enum):
-
-    AVAILABLE = "AVAILABLE"
-    DELETING = "DELETING"
-    FAILING_OVER = "FAILING_OVER"
-    STARTING = "STARTING"
-    STOPPED = "STOPPED"
-    UPDATING = "UPDATING"
-
-
 @dataclass
 class DatabricksGcpServiceAccount:
     """GCP long-lived credential. Databricks-created Google Cloud Storage service account."""
 
     credential_id: Optional[str] = None
-    """The Databricks internal ID that represents this managed identity. This field is only used to
-    persist the credential_id once it is fetched from the credentials manager - as we only use the
-    protobuf serializer to store credentials, this ID gets persisted to the database"""
+    """The Databricks internal ID that represents this managed identity."""
 
     email: Optional[str] = None
     """The email of the service account."""
@@ -3216,6 +3064,8 @@ class DatabricksGcpServiceAccount:
 
 @dataclass
 class DatabricksGcpServiceAccountRequest:
+    """GCP long-lived credential. Databricks-created Google Cloud Storage service account."""
+
     def as_dict(self) -> dict:
         """Serializes the DatabricksGcpServiceAccountRequest into a dictionary suitable for use as a JSON request body."""
         body = {}
@@ -3234,11 +3084,13 @@ class DatabricksGcpServiceAccountRequest:
 
 @dataclass
 class DatabricksGcpServiceAccountResponse:
+    """GCP long-lived credential. Databricks-created Google Cloud Storage service account."""
+
     credential_id: Optional[str] = None
-    """The Databricks internal ID that represents this service account. This is an output-only field."""
+    """The Databricks internal ID that represents this managed identity."""
 
     email: Optional[str] = None
-    """The email of the service account. This is an output-only field."""
+    """The email of the service account."""
 
     def as_dict(self) -> dict:
         """Serializes the DatabricksGcpServiceAccountResponse into a dictionary suitable for use as a JSON request body."""
@@ -3300,42 +3152,6 @@ class DeleteCredentialResponse:
         return cls()
 
 
-@dataclass
-class DeleteDatabaseCatalogResponse:
-    def as_dict(self) -> dict:
-        """Serializes the DeleteDatabaseCatalogResponse into a dictionary suitable for use as a JSON request body."""
-        body = {}
-        return body
-
-    def as_shallow_dict(self) -> dict:
-        """Serializes the DeleteDatabaseCatalogResponse into a shallow dictionary of its immediate attributes."""
-        body = {}
-        return body
-
-    @classmethod
-    def from_dict(cls, d: Dict[str, Any]) -> DeleteDatabaseCatalogResponse:
-        """Deserializes the DeleteDatabaseCatalogResponse from a dictionary."""
-        return cls()
-
-
-@dataclass
-class DeleteDatabaseInstanceResponse:
-    def as_dict(self) -> dict:
-        """Serializes the DeleteDatabaseInstanceResponse into a dictionary suitable for use as a JSON request body."""
-        body = {}
-        return body
-
-    def as_shallow_dict(self) -> dict:
-        """Serializes the DeleteDatabaseInstanceResponse into a shallow dictionary of its immediate attributes."""
-        body = {}
-        return body
-
-    @classmethod
-    def from_dict(cls, d: Dict[str, Any]) -> DeleteDatabaseInstanceResponse:
-        """Deserializes the DeleteDatabaseInstanceResponse from a dictionary."""
-        return cls()
-
-
 @dataclass
 class DeleteResponse:
     def as_dict(self) -> dict:
@@ -3354,24 +3170,6 @@ class DeleteResponse:
         return cls()
 
 
-@dataclass
-class DeleteSyncedDatabaseTableResponse:
-    def as_dict(self) -> dict:
-        """Serializes the DeleteSyncedDatabaseTableResponse into a dictionary suitable for use as a JSON request body."""
-        body = {}
-        return body
-
-    def as_shallow_dict(self) -> dict:
-        """Serializes the DeleteSyncedDatabaseTableResponse into a shallow dictionary of its immediate attributes."""
-        body = {}
-        return body
-
-    @classmethod
-    def from_dict(cls, d: Dict[str, Any]) -> DeleteSyncedDatabaseTableResponse:
-        """Deserializes the DeleteSyncedDatabaseTableResponse from a dictionary."""
-        return cls()
-
-
 @dataclass
 class DeltaRuntimePropertiesKvPairs:
     """Properties pertaining to the current state of the delta table as given by the commit server.
@@ -3400,6 +3198,12 @@ class DeltaRuntimePropertiesKvPairs:
         return cls(delta_runtime_properties=d.get("delta_runtime_properties", None))
 
 
+class DeltaSharingScopeEnum(Enum):
+
+    INTERNAL = "INTERNAL"
+    INTERNAL_AND_EXTERNAL = "INTERNAL_AND_EXTERNAL"
+
+
 @dataclass
 class Dependency:
     """A dependency of a SQL object. Either the __table__ field or the __function__ field must be
@@ -3484,12 +3288,18 @@ class DisableResponse:
 
 @dataclass
 class EffectivePermissionsList:
+    next_page_token: Optional[str] = None
+    """Opaque token to retrieve the next page of results. Absent if there are no more pages.
+    __page_token__ should be set to this value for the next request (for the next page of results)."""
+
     privilege_assignments: Optional[List[EffectivePrivilegeAssignment]] = None
     """The privileges conveyed to each principal (either directly or via inheritance)"""
 
     def as_dict(self) -> dict:
         """Serializes the EffectivePermissionsList into a dictionary suitable for use as a JSON request body."""
         body = {}
+        if self.next_page_token is not None:
+            body["next_page_token"] = self.next_page_token
         if self.privilege_assignments:
             body["privilege_assignments"] = [v.as_dict() for v in self.privilege_assignments]
         return body
@@ -3497,6 +3307,8 @@ class EffectivePermissionsList:
     def as_shallow_dict(self) -> dict:
         """Serializes the EffectivePermissionsList into a shallow dictionary of its immediate attributes."""
         body = {}
+        if self.next_page_token is not None:
+            body["next_page_token"] = self.next_page_token
         if self.privilege_assignments:
             body["privilege_assignments"] = self.privilege_assignments
         return body
@@ -3504,7 +3316,10 @@ class EffectivePermissionsList:
     @classmethod
     def from_dict(cls, d: Dict[str, Any]) -> EffectivePermissionsList:
         """Deserializes the EffectivePermissionsList from a dictionary."""
-        return cls(privilege_assignments=_repeated_dict(d, "privilege_assignments", EffectivePrivilegeAssignment))
+        return cls(
+            next_page_token=d.get("next_page_token", None),
+            privilege_assignments=_repeated_dict(d, "privilege_assignments", EffectivePrivilegeAssignment),
+        )
 
 
 @dataclass
@@ -4847,7 +4662,7 @@ class GetMetastoreSummaryResponse:
     delta_sharing_recipient_token_lifetime_in_seconds: Optional[int] = None
     """The lifetime of delta sharing recipient token in seconds."""
 
-    delta_sharing_scope: Optional[GetMetastoreSummaryResponseDeltaSharingScope] = None
+    delta_sharing_scope: Optional[DeltaSharingScopeEnum] = None
     """The scope of Delta Sharing enabled for the metastore."""
 
     external_access_enabled: Optional[bool] = None
@@ -4988,7 +4803,7 @@ class GetMetastoreSummaryResponse:
             delta_sharing_recipient_token_lifetime_in_seconds=d.get(
                 "delta_sharing_recipient_token_lifetime_in_seconds", None
             ),
-            delta_sharing_scope=_enum(d, "delta_sharing_scope", GetMetastoreSummaryResponseDeltaSharingScope),
+            delta_sharing_scope=_enum(d, "delta_sharing_scope", DeltaSharingScopeEnum),
             external_access_enabled=d.get("external_access_enabled", None),
             global_metastore_id=d.get("global_metastore_id", None),
             metastore_id=d.get("metastore_id", None),
@@ -5004,11 +4819,40 @@ class GetMetastoreSummaryResponse:
         )
 
 
-class GetMetastoreSummaryResponseDeltaSharingScope(Enum):
-    """The scope of Delta Sharing enabled for the metastore."""
+@dataclass
+class GetPermissionsResponse:
+    next_page_token: Optional[str] = None
+    """Opaque token to retrieve the next page of results. Absent if there are no more pages.
+    __page_token__ should be set to this value for the next request (for the next page of results)."""
 
-    INTERNAL = "INTERNAL"
-    INTERNAL_AND_EXTERNAL = "INTERNAL_AND_EXTERNAL"
+    privilege_assignments: Optional[List[PrivilegeAssignment]] = None
+    """The privileges assigned to each principal"""
+
+    def as_dict(self) -> dict:
+        """Serializes the GetPermissionsResponse into a dictionary suitable for use as a JSON request body."""
+        body = {}
+        if self.next_page_token is not None:
+            body["next_page_token"] = self.next_page_token
+        if self.privilege_assignments:
+            body["privilege_assignments"] = [v.as_dict() for v in self.privilege_assignments]
+        return body
+
+    def as_shallow_dict(self) -> dict:
+        """Serializes the GetPermissionsResponse into a shallow dictionary of its immediate attributes."""
+        body = {}
+        if self.next_page_token is not None:
+            body["next_page_token"] = self.next_page_token
+        if self.privilege_assignments:
+            body["privilege_assignments"] = self.privilege_assignments
+        return body
+
+    @classmethod
+    def from_dict(cls, d: Dict[str, Any]) -> GetPermissionsResponse:
+        """Deserializes the GetPermissionsResponse from a dictionary."""
+        return cls(
+            next_page_token=d.get("next_page_token", None),
+            privilege_assignments=_repeated_dict(d, "privilege_assignments", PrivilegeAssignment),
+        )
 
 
 @dataclass
@@ -5230,41 +5074,6 @@ class ListCredentialsResponse:
         )
 
 
-@dataclass
-class ListDatabaseInstancesResponse:
-    database_instances: Optional[List[DatabaseInstance]] = None
-    """List of instances."""
-
-    next_page_token: Optional[str] = None
-    """Pagination token to request the next page of instances."""
-
-    def as_dict(self) -> dict:
-        """Serializes the ListDatabaseInstancesResponse into a dictionary suitable for use as a JSON request body."""
-        body = {}
-        if self.database_instances:
-            body["database_instances"] = [v.as_dict() for v in self.database_instances]
-        if self.next_page_token is not None:
-            body["next_page_token"] = self.next_page_token
-        return body
-
-    def as_shallow_dict(self) -> dict:
-        """Serializes the ListDatabaseInstancesResponse into a shallow dictionary of its immediate attributes."""
-        body = {}
-        if self.database_instances:
-            body["database_instances"] = self.database_instances
-        if self.next_page_token is not None:
-            body["next_page_token"] = self.next_page_token
-        return body
-
-    @classmethod
-    def from_dict(cls, d: Dict[str, Any]) -> ListDatabaseInstancesResponse:
-        """Deserializes the ListDatabaseInstancesResponse from a dictionary."""
-        return cls(
-            database_instances=_repeated_dict(d, "database_instances", DatabaseInstance),
-            next_page_token=d.get("next_page_token", None),
-        )
-
-
 @dataclass
 class ListExternalLocationsResponse:
     external_locations: Optional[List[ExternalLocationInfo]] = None
@@ -5341,11 +5150,17 @@ class ListMetastoresResponse:
     metastores: Optional[List[MetastoreInfo]] = None
     """An array of metastore information objects."""
 
+    next_page_token: Optional[str] = None
+    """Opaque token to retrieve the next page of results. Absent if there are no more pages.
+    __page_token__ should be set to this value for the next request (for the next page of results)."""
+
     def as_dict(self) -> dict:
         """Serializes the ListMetastoresResponse into a dictionary suitable for use as a JSON request body."""
         body = {}
         if self.metastores:
             body["metastores"] = [v.as_dict() for v in self.metastores]
+        if self.next_page_token is not None:
+            body["next_page_token"] = self.next_page_token
         return body
 
     def as_shallow_dict(self) -> dict:
@@ -5353,12 +5168,16 @@ class ListMetastoresResponse:
         body = {}
         if self.metastores:
             body["metastores"] = self.metastores
+        if self.next_page_token is not None:
+            body["next_page_token"] = self.next_page_token
         return body
 
     @classmethod
     def from_dict(cls, d: Dict[str, Any]) -> ListMetastoresResponse:
         """Deserializes the ListMetastoresResponse from a dictionary."""
-        return cls(metastores=_repeated_dict(d, "metastores", MetastoreInfo))
+        return cls(
+            metastores=_repeated_dict(d, "metastores", MetastoreInfo), next_page_token=d.get("next_page_token", None)
+        )
 
 
 @dataclass
@@ -5674,12 +5493,12 @@ class MatchType(Enum):
 
 @dataclass
 class MetastoreAssignment:
-    metastore_id: str
-    """The unique ID of the metastore."""
-
     workspace_id: int
     """The unique ID of the Databricks workspace."""
 
+    metastore_id: str
+    """The unique ID of the metastore."""
+
     default_catalog_name: Optional[str] = None
     """The name of the default catalog in the metastore."""
 
@@ -5736,7 +5555,7 @@ class MetastoreInfo:
     delta_sharing_recipient_token_lifetime_in_seconds: Optional[int] = None
     """The lifetime of delta sharing recipient token in seconds."""
 
-    delta_sharing_scope: Optional[MetastoreInfoDeltaSharingScope] = None
+    delta_sharing_scope: Optional[DeltaSharingScopeEnum] = None
     """The scope of Delta Sharing enabled for the metastore."""
 
     external_access_enabled: Optional[bool] = None
@@ -5877,7 +5696,7 @@ class MetastoreInfo:
             delta_sharing_recipient_token_lifetime_in_seconds=d.get(
                 "delta_sharing_recipient_token_lifetime_in_seconds", None
             ),
-            delta_sharing_scope=_enum(d, "delta_sharing_scope", MetastoreInfoDeltaSharingScope),
+            delta_sharing_scope=_enum(d, "delta_sharing_scope", DeltaSharingScopeEnum),
             external_access_enabled=d.get("external_access_enabled", None),
             global_metastore_id=d.get("global_metastore_id", None),
             metastore_id=d.get("metastore_id", None),
@@ -5893,13 +5712,6 @@ class MetastoreInfo:
         )
 
 
-class MetastoreInfoDeltaSharingScope(Enum):
-    """The scope of Delta Sharing enabled for the metastore."""
-
-    INTERNAL = "INTERNAL"
-    INTERNAL_AND_EXTERNAL = "INTERNAL_AND_EXTERNAL"
-
-
 @dataclass
 class ModelVersionInfo:
     aliases: Optional[List[RegisteredModelAlias]] = None
@@ -6770,48 +6582,11 @@ class NamedTableConstraint:
 
 
 @dataclass
-class NewPipelineSpec:
-    """Custom fields that user can set for pipeline while creating SyncedDatabaseTable. Note that other
-    fields of pipeline are still inferred by table def internally"""
+class OnlineTable:
+    """Online Table information."""
 
-    storage_catalog: Optional[str] = None
-    """UC catalog for the pipeline to store intermediate files (checkpoints, event logs etc). This
-    needs to be a standard catalog where the user has permissions to create Delta tables."""
-
-    storage_schema: Optional[str] = None
-    """UC schema for the pipeline to store intermediate files (checkpoints, event logs etc). This needs
-    to be in the standard catalog where the user has permissions to create Delta tables."""
-
-    def as_dict(self) -> dict:
-        """Serializes the NewPipelineSpec into a dictionary suitable for use as a JSON request body."""
-        body = {}
-        if self.storage_catalog is not None:
-            body["storage_catalog"] = self.storage_catalog
-        if self.storage_schema is not None:
-            body["storage_schema"] = self.storage_schema
-        return body
-
-    def as_shallow_dict(self) -> dict:
-        """Serializes the NewPipelineSpec into a shallow dictionary of its immediate attributes."""
-        body = {}
-        if self.storage_catalog is not None:
-            body["storage_catalog"] = self.storage_catalog
-        if self.storage_schema is not None:
-            body["storage_schema"] = self.storage_schema
-        return body
-
-    @classmethod
-    def from_dict(cls, d: Dict[str, Any]) -> NewPipelineSpec:
-        """Deserializes the NewPipelineSpec from a dictionary."""
-        return cls(storage_catalog=d.get("storage_catalog", None), storage_schema=d.get("storage_schema", None))
-
-
-@dataclass
-class OnlineTable:
-    """Online Table information."""
-
-    name: Optional[str] = None
-    """Full three-part (catalog, schema, table) name of the table."""
+    name: Optional[str] = None
+    """Full three-part (catalog, schema, table) name of the table."""
 
     spec: Optional[OnlineTableSpec] = None
     """Specification of the online table."""
@@ -7120,31 +6895,6 @@ class PermissionsChange:
         )
 
 
-@dataclass
-class PermissionsList:
-    privilege_assignments: Optional[List[PrivilegeAssignment]] = None
-    """The privileges assigned to each principal"""
-
-    def as_dict(self) -> dict:
-        """Serializes the PermissionsList into a dictionary suitable for use as a JSON request body."""
-        body = {}
-        if self.privilege_assignments:
-            body["privilege_assignments"] = [v.as_dict() for v in self.privilege_assignments]
-        return body
-
-    def as_shallow_dict(self) -> dict:
-        """Serializes the PermissionsList into a shallow dictionary of its immediate attributes."""
-        body = {}
-        if self.privilege_assignments:
-            body["privilege_assignments"] = self.privilege_assignments
-        return body
-
-    @classmethod
-    def from_dict(cls, d: Dict[str, Any]) -> PermissionsList:
-        """Deserializes the PermissionsList from a dictionary."""
-        return cls(privilege_assignments=_repeated_dict(d, "privilege_assignments", PrivilegeAssignment))
-
-
 @dataclass
 class PipelineProgress:
     """Progress information of the Online Table data synchronization pipeline."""
@@ -7335,9 +7085,6 @@ class PrivilegeAssignment:
         return cls(principal=d.get("principal", None), privileges=_repeated_enum(d, "privileges", Privilege))
 
 
-PropertiesKvPairs = Dict[str, str]
-
-
 @dataclass
 class ProvisioningInfo:
     """Status of an asynchronously provisioned resource."""
@@ -7750,6 +7497,8 @@ class RegisteredModelInfo:
 
 @dataclass
 class SchemaInfo:
+    """Next ID: 40"""
+
     browse_only: Optional[bool] = None
     """Indicates whether the principal is limited to retrieving metadata for the associated object
     through the BROWSE privilege when include_browse is enabled in the request."""
@@ -7757,7 +7506,7 @@ class SchemaInfo:
     catalog_name: Optional[str] = None
     """Name of parent catalog."""
 
-    catalog_type: Optional[str] = None
+    catalog_type: Optional[CatalogType] = None
     """The type of the parent catalog."""
 
     comment: Optional[str] = None
@@ -7772,6 +7521,7 @@ class SchemaInfo:
     effective_predictive_optimization_flag: Optional[EffectivePredictiveOptimizationFlag] = None
 
     enable_predictive_optimization: Optional[EnablePredictiveOptimization] = None
+    """Whether predictive optimization should be enabled for this object and objects under it."""
 
     full_name: Optional[str] = None
     """Full name of schema, in form of __catalog_name__.__schema_name__."""
@@ -7811,7 +7561,7 @@ class SchemaInfo:
         if self.catalog_name is not None:
             body["catalog_name"] = self.catalog_name
         if self.catalog_type is not None:
-            body["catalog_type"] = self.catalog_type
+            body["catalog_type"] = self.catalog_type.value
         if self.comment is not None:
             body["comment"] = self.comment
         if self.created_at is not None:
@@ -7891,7 +7641,7 @@ class SchemaInfo:
         return cls(
             browse_only=d.get("browse_only", None),
             catalog_name=d.get("catalog_name", None),
-            catalog_type=d.get("catalog_type", None),
+            catalog_type=_enum(d, "catalog_type", CatalogType),
             comment=d.get("comment", None),
             created_at=d.get("created_at", None),
             created_by=d.get("created_by", None),
@@ -7912,12 +7662,6 @@ class SchemaInfo:
         )
 
 
-SecurableOptionsMap = Dict[str, str]
-
-
-SecurablePropertiesMap = Dict[str, str]
-
-
 class SecurableType(Enum):
     """The type of Unity Catalog securable."""
 
@@ -8103,7 +7847,7 @@ class StorageCredentialInfo:
     """Comment associated with the credential."""
 
     created_at: Optional[int] = None
-    """Time at which this Credential was created, in epoch milliseconds."""
+    """Time at which this credential was created, in epoch milliseconds."""
 
     created_by: Optional[str] = None
     """Username of credential creator."""
@@ -8118,18 +7862,21 @@ class StorageCredentialInfo:
     """The unique identifier of the credential."""
 
     isolation_mode: Optional[IsolationMode] = None
+    """Whether the current securable is accessible from all workspaces or a specific set of workspaces."""
 
     metastore_id: Optional[str] = None
-    """Unique identifier of parent metastore."""
+    """Unique identifier of the parent metastore."""
 
     name: Optional[str] = None
-    """The credential name. The name must be unique within the metastore."""
+    """The credential name. The name must be unique among storage and service credentials within the
+    metastore."""
 
     owner: Optional[str] = None
     """Username of current owner of credential."""
 
     read_only: Optional[bool] = None
-    """Whether the storage credential is only usable for read operations."""
+    """Whether the credential is usable only for read operations. Only applicable when purpose is
+    **STORAGE**."""
 
     updated_at: Optional[int] = None
     """Time at which this credential was last modified, in epoch milliseconds."""
@@ -8138,7 +7885,8 @@ class StorageCredentialInfo:
     """Username of user who last modified the credential."""
 
     used_for_managed_storage: Optional[bool] = None
-    """Whether this credential is the current metastore's root storage credential."""
+    """Whether this credential is the current metastore's root storage credential. Only applicable when
+    purpose is **STORAGE**."""
 
     def as_dict(self) -> dict:
         """Serializes the StorageCredentialInfo into a dictionary suitable for use as a JSON request body."""
@@ -8249,184 +7997,6 @@ class StorageCredentialInfo:
         )
 
 
-@dataclass
-class SyncedDatabaseTable:
-    """Next field marker: 10"""
-
-    name: str
-    """Full three-part (catalog, schema, table) name of the table."""
-
-    data_synchronization_status: Optional[OnlineTableStatus] = None
-    """Synced Table data synchronization status"""
-
-    database_instance_name: Optional[str] = None
-    """Name of the target database instance. This is required when creating synced database tables in
-    standard catalogs. This is optional when creating synced database tables in registered catalogs.
-    If this field is specified when creating synced database tables in registered catalogs, the
-    database instance name MUST match that of the registered catalog (or the request will be
-    rejected)."""
-
-    logical_database_name: Optional[str] = None
-    """Target Postgres database object (logical database) name for this table. This field is optional
-    in all scenarios.
-    
-    When creating a synced table in a registered Postgres catalog, the target Postgres database name
-    is inferred to be that of the registered catalog. If this field is specified in this scenario,
-    the Postgres database name MUST match that of the registered catalog (or the request will be
-    rejected).
-    
-    When creating a synced table in a standard catalog, the target database name is inferred to be
-    that of the standard catalog. In this scenario, specifying this field will allow targeting an
-    arbitrary postgres database."""
-
-    spec: Optional[SyncedTableSpec] = None
-    """Specification of a synced database table."""
-
-    table_serving_url: Optional[str] = None
-    """Data serving REST API URL for this table"""
-
-    unity_catalog_provisioning_state: Optional[ProvisioningInfoState] = None
-    """The provisioning state of the synced table entity in Unity Catalog. This is distinct from the
-    state of the data synchronization pipeline (i.e. the table may be in "ACTIVE" but the pipeline
-    may be in "PROVISIONING" as it runs asynchronously)."""
-
-    def as_dict(self) -> dict:
-        """Serializes the SyncedDatabaseTable into a dictionary suitable for use as a JSON request body."""
-        body = {}
-        if self.data_synchronization_status:
-            body["data_synchronization_status"] = self.data_synchronization_status.as_dict()
-        if self.database_instance_name is not None:
-            body["database_instance_name"] = self.database_instance_name
-        if self.logical_database_name is not None:
-            body["logical_database_name"] = self.logical_database_name
-        if self.name is not None:
-            body["name"] = self.name
-        if self.spec:
-            body["spec"] = self.spec.as_dict()
-        if self.table_serving_url is not None:
-            body["table_serving_url"] = self.table_serving_url
-        if self.unity_catalog_provisioning_state is not None:
-            body["unity_catalog_provisioning_state"] = self.unity_catalog_provisioning_state.value
-        return body
-
-    def as_shallow_dict(self) -> dict:
-        """Serializes the SyncedDatabaseTable into a shallow dictionary of its immediate attributes."""
-        body = {}
-        if self.data_synchronization_status:
-            body["data_synchronization_status"] = self.data_synchronization_status
-        if self.database_instance_name is not None:
-            body["database_instance_name"] = self.database_instance_name
-        if self.logical_database_name is not None:
-            body["logical_database_name"] = self.logical_database_name
-        if self.name is not None:
-            body["name"] = self.name
-        if self.spec:
-            body["spec"] = self.spec
-        if self.table_serving_url is not None:
-            body["table_serving_url"] = self.table_serving_url
-        if self.unity_catalog_provisioning_state is not None:
-            body["unity_catalog_provisioning_state"] = self.unity_catalog_provisioning_state
-        return body
-
-    @classmethod
-    def from_dict(cls, d: Dict[str, Any]) -> SyncedDatabaseTable:
-        """Deserializes the SyncedDatabaseTable from a dictionary."""
-        return cls(
-            data_synchronization_status=_from_dict(d, "data_synchronization_status", OnlineTableStatus),
-            database_instance_name=d.get("database_instance_name", None),
-            logical_database_name=d.get("logical_database_name", None),
-            name=d.get("name", None),
-            spec=_from_dict(d, "spec", SyncedTableSpec),
-            table_serving_url=d.get("table_serving_url", None),
-            unity_catalog_provisioning_state=_enum(d, "unity_catalog_provisioning_state", ProvisioningInfoState),
-        )
-
-
-class SyncedTableSchedulingPolicy(Enum):
-
-    CONTINUOUS = "CONTINUOUS"
-    SNAPSHOT = "SNAPSHOT"
-    TRIGGERED = "TRIGGERED"
-
-
-@dataclass
-class SyncedTableSpec:
-    """Specification of a synced database table."""
-
-    create_database_objects_if_missing: Optional[bool] = None
-    """If true, the synced table's logical database and schema resources in PG will be created if they
-    do not already exist."""
-
-    new_pipeline_spec: Optional[NewPipelineSpec] = None
-    """Spec of new pipeline. Should be empty if pipeline_id is set"""
-
-    pipeline_id: Optional[str] = None
-    """ID of the associated pipeline. Should be empty if new_pipeline_spec is set"""
-
-    primary_key_columns: Optional[List[str]] = None
-    """Primary Key columns to be used for data insert/update in the destination."""
-
-    scheduling_policy: Optional[SyncedTableSchedulingPolicy] = None
-    """Scheduling policy of the underlying pipeline."""
-
-    source_table_full_name: Optional[str] = None
-    """Three-part (catalog, schema, table) name of the source Delta table."""
-
-    timeseries_key: Optional[str] = None
-    """Time series key to deduplicate (tie-break) rows with the same primary key."""
-
-    def as_dict(self) -> dict:
-        """Serializes the SyncedTableSpec into a dictionary suitable for use as a JSON request body."""
-        body = {}
-        if self.create_database_objects_if_missing is not None:
-            body["create_database_objects_if_missing"] = self.create_database_objects_if_missing
-        if self.new_pipeline_spec:
-            body["new_pipeline_spec"] = self.new_pipeline_spec.as_dict()
-        if self.pipeline_id is not None:
-            body["pipeline_id"] = self.pipeline_id
-        if self.primary_key_columns:
-            body["primary_key_columns"] = [v for v in self.primary_key_columns]
-        if self.scheduling_policy is not None:
-            body["scheduling_policy"] = self.scheduling_policy.value
-        if self.source_table_full_name is not None:
-            body["source_table_full_name"] = self.source_table_full_name
-        if self.timeseries_key is not None:
-            body["timeseries_key"] = self.timeseries_key
-        return body
-
-    def as_shallow_dict(self) -> dict:
-        """Serializes the SyncedTableSpec into a shallow dictionary of its immediate attributes."""
-        body = {}
-        if self.create_database_objects_if_missing is not None:
-            body["create_database_objects_if_missing"] = self.create_database_objects_if_missing
-        if self.new_pipeline_spec:
-            body["new_pipeline_spec"] = self.new_pipeline_spec
-        if self.pipeline_id is not None:
-            body["pipeline_id"] = self.pipeline_id
-        if self.primary_key_columns:
-            body["primary_key_columns"] = self.primary_key_columns
-        if self.scheduling_policy is not None:
-            body["scheduling_policy"] = self.scheduling_policy
-        if self.source_table_full_name is not None:
-            body["source_table_full_name"] = self.source_table_full_name
-        if self.timeseries_key is not None:
-            body["timeseries_key"] = self.timeseries_key
-        return body
-
-    @classmethod
-    def from_dict(cls, d: Dict[str, Any]) -> SyncedTableSpec:
-        """Deserializes the SyncedTableSpec from a dictionary."""
-        return cls(
-            create_database_objects_if_missing=d.get("create_database_objects_if_missing", None),
-            new_pipeline_spec=_from_dict(d, "new_pipeline_spec", NewPipelineSpec),
-            pipeline_id=d.get("pipeline_id", None),
-            primary_key_columns=d.get("primary_key_columns", None),
-            scheduling_policy=_enum(d, "scheduling_policy", SyncedTableSchedulingPolicy),
-            source_table_full_name=d.get("source_table_full_name", None),
-            timeseries_key=d.get("timeseries_key", None),
-        )
-
-
 @dataclass
 class SystemSchemaInfo:
     schema: str
@@ -9255,19 +8825,19 @@ class UpdateConnection:
 @dataclass
 class UpdateCredentialRequest:
     aws_iam_role: Optional[AwsIamRole] = None
-    """The AWS IAM role configuration"""
+    """The AWS IAM role configuration."""
 
     azure_managed_identity: Optional[AzureManagedIdentity] = None
     """The Azure managed identity configuration."""
 
     azure_service_principal: Optional[AzureServicePrincipal] = None
-    """The Azure service principal configuration. Only applicable when purpose is **STORAGE**."""
+    """The Azure service principal configuration."""
 
     comment: Optional[str] = None
     """Comment associated with the credential."""
 
     databricks_gcp_service_account: Optional[DatabricksGcpServiceAccount] = None
-    """GCP long-lived credential. Databricks-created Google Cloud Storage service account."""
+    """The Databricks managed GCP service account configuration."""
 
     force: Optional[bool] = None
     """Force an update even if there are dependent services (when purpose is **SERVICE**) or dependent
@@ -9543,7 +9113,7 @@ class UpdateMetastore:
     delta_sharing_recipient_token_lifetime_in_seconds: Optional[int] = None
     """The lifetime of delta sharing recipient token in seconds."""
 
-    delta_sharing_scope: Optional[UpdateMetastoreDeltaSharingScope] = None
+    delta_sharing_scope: Optional[DeltaSharingScopeEnum] = None
     """The scope of Delta Sharing enabled for the metastore."""
 
     id: Optional[str] = None
@@ -9615,7 +9185,7 @@ class UpdateMetastore:
             delta_sharing_recipient_token_lifetime_in_seconds=d.get(
                 "delta_sharing_recipient_token_lifetime_in_seconds", None
             ),
-            delta_sharing_scope=_enum(d, "delta_sharing_scope", UpdateMetastoreDeltaSharingScope),
+            delta_sharing_scope=_enum(d, "delta_sharing_scope", DeltaSharingScopeEnum),
             id=d.get("id", None),
             new_name=d.get("new_name", None),
             owner=d.get("owner", None),
@@ -9627,7 +9197,7 @@ class UpdateMetastore:
 @dataclass
 class UpdateMetastoreAssignment:
     default_catalog_name: Optional[str] = None
-    """The name of the default catalog in the metastore. This field is depracted. Please use "Default
+    """The name of the default catalog in the metastore. This field is deprecated. Please use "Default
     Namespace API" to configure the default catalog for a Databricks workspace."""
 
     metastore_id: Optional[str] = None
@@ -9668,13 +9238,6 @@ class UpdateMetastoreAssignment:
         )
 
 
-class UpdateMetastoreDeltaSharingScope(Enum):
-    """The scope of Delta Sharing enabled for the metastore."""
-
-    INTERNAL = "INTERNAL"
-    INTERNAL_AND_EXTERNAL = "INTERNAL_AND_EXTERNAL"
-
-
 @dataclass
 class UpdateModelVersionRequest:
     comment: Optional[str] = None
@@ -9843,7 +9406,7 @@ class UpdatePermissions:
     full_name: Optional[str] = None
     """Full name of securable."""
 
-    securable_type: Optional[SecurableType] = None
+    securable_type: Optional[str] = None
     """Type of securable."""
 
     def as_dict(self) -> dict:
@@ -9854,7 +9417,7 @@ class UpdatePermissions:
         if self.full_name is not None:
             body["full_name"] = self.full_name
         if self.securable_type is not None:
-            body["securable_type"] = self.securable_type.value
+            body["securable_type"] = self.securable_type
         return body
 
     def as_shallow_dict(self) -> dict:
@@ -9874,10 +9437,35 @@ class UpdatePermissions:
         return cls(
             changes=_repeated_dict(d, "changes", PermissionsChange),
             full_name=d.get("full_name", None),
-            securable_type=_enum(d, "securable_type", SecurableType),
+            securable_type=d.get("securable_type", None),
         )
 
 
+@dataclass
+class UpdatePermissionsResponse:
+    privilege_assignments: Optional[List[PrivilegeAssignment]] = None
+    """The privileges assigned to each principal"""
+
+    def as_dict(self) -> dict:
+        """Serializes the UpdatePermissionsResponse into a dictionary suitable for use as a JSON request body."""
+        body = {}
+        if self.privilege_assignments:
+            body["privilege_assignments"] = [v.as_dict() for v in self.privilege_assignments]
+        return body
+
+    def as_shallow_dict(self) -> dict:
+        """Serializes the UpdatePermissionsResponse into a shallow dictionary of its immediate attributes."""
+        body = {}
+        if self.privilege_assignments:
+            body["privilege_assignments"] = self.privilege_assignments
+        return body
+
+    @classmethod
+    def from_dict(cls, d: Dict[str, Any]) -> UpdatePermissionsResponse:
+        """Deserializes the UpdatePermissionsResponse from a dictionary."""
+        return cls(privilege_assignments=_repeated_dict(d, "privilege_assignments", PrivilegeAssignment))
+
+
 @dataclass
 class UpdateRegisteredModelRequest:
     comment: Optional[str] = None
@@ -9953,6 +9541,7 @@ class UpdateSchema:
     """User-provided free-form text description."""
 
     enable_predictive_optimization: Optional[EnablePredictiveOptimization] = None
+    """Whether predictive optimization should be enabled for this object and objects under it."""
 
     full_name: Optional[str] = None
     """Full name of the schema."""
@@ -10037,6 +9626,7 @@ class UpdateStorageCredential:
     """Force update even if there are dependent external locations or external tables."""
 
     isolation_mode: Optional[IsolationMode] = None
+    """Whether the current securable is accessible from all workspaces or a specific set of workspaces."""
 
     name: Optional[str] = None
     """Name of the storage credential."""
@@ -10048,7 +9638,8 @@ class UpdateStorageCredential:
     """Username of current owner of credential."""
 
     read_only: Optional[bool] = None
-    """Whether the storage credential is only usable for read operations."""
+    """Whether the credential is usable only for read operations. Only applicable when purpose is
+    **STORAGE**."""
 
     skip_validation: Optional[bool] = None
     """Supplying true to this argument skips validation of the updated credential."""
@@ -10137,6 +9728,39 @@ class UpdateStorageCredential:
         )
 
 
+@dataclass
+class UpdateTableRequest:
+    """Update a table owner."""
+
+    full_name: Optional[str] = None
+    """Full name of the table."""
+
+    owner: Optional[str] = None
+
+    def as_dict(self) -> dict:
+        """Serializes the UpdateTableRequest into a dictionary suitable for use as a JSON request body."""
+        body = {}
+        if self.full_name is not None:
+            body["full_name"] = self.full_name
+        if self.owner is not None:
+            body["owner"] = self.owner
+        return body
+
+    def as_shallow_dict(self) -> dict:
+        """Serializes the UpdateTableRequest into a shallow dictionary of its immediate attributes."""
+        body = {}
+        if self.full_name is not None:
+            body["full_name"] = self.full_name
+        if self.owner is not None:
+            body["owner"] = self.owner
+        return body
+
+    @classmethod
+    def from_dict(cls, d: Dict[str, Any]) -> UpdateTableRequest:
+        """Deserializes the UpdateTableRequest from a dictionary."""
+        return cls(full_name=d.get("full_name", None), owner=d.get("owner", None))
+
+
 @dataclass
 class UpdateVolumeRequestContent:
     comment: Optional[str] = None
@@ -10462,7 +10086,7 @@ class ValidateStorageCredential:
     """Whether the storage credential is only usable for read operations."""
 
     storage_credential_name: Optional[str] = None
-    """The name of the storage credential to validate."""
+    """Required. The name of an existing credential or long-lived cloud credential to validate."""
 
     url: Optional[str] = None
     """The external location url to validate."""
@@ -10607,7 +10231,8 @@ class ValidationResult:
 
 
 class ValidationResultOperation(Enum):
-    """The operation tested."""
+    """A enum represents the file operation performed on the external location with the storage
+    credential"""
 
     DELETE = "DELETE"
     LIST = "LIST"
@@ -10617,7 +10242,7 @@ class ValidationResultOperation(Enum):
 
 
 class ValidationResultResult(Enum):
-    """The results of the tested operation."""
+    """A enum represents the result of the file operation"""
 
     FAIL = "FAIL"
     PASS = "PASS"
@@ -10844,9 +10469,7 @@ class AccountMetastoreAssignmentsAPI:
     def create(
         self, workspace_id: int, metastore_id: str, *, metastore_assignment: Optional[CreateMetastoreAssignment] = None
     ):
-        """Assigns a workspace to a metastore.
-
-        Creates an assignment to a metastore for a workspace
+        """Creates an assignment to a metastore for a workspace
 
         :param workspace_id: int
           Workspace ID.
@@ -10872,9 +10495,7 @@ class AccountMetastoreAssignmentsAPI:
         )
 
     def delete(self, workspace_id: int, metastore_id: str):
-        """Delete a metastore assignment.
-
-        Deletes a metastore assignment to a workspace, leaving the workspace with no metastore.
+        """Deletes a metastore assignment to a workspace, leaving the workspace with no metastore.
 
         :param workspace_id: int
           Workspace ID.
@@ -10895,9 +10516,7 @@ class AccountMetastoreAssignmentsAPI:
         )
 
     def get(self, workspace_id: int) -> AccountsMetastoreAssignment:
-        """Gets the metastore assignment for a workspace.
-
-        Gets the metastore assignment, if any, for the workspace specified by ID. If the workspace is assigned
+        """Gets the metastore assignment, if any, for the workspace specified by ID. If the workspace is assigned
         a metastore, the mappig will be returned. If no metastore is assigned to the workspace, the assignment
         will not be found and a 404 returned.
 
@@ -10917,9 +10536,7 @@ class AccountMetastoreAssignmentsAPI:
         return AccountsMetastoreAssignment.from_dict(res)
 
     def list(self, metastore_id: str) -> Iterator[int]:
-        """Get all workspaces assigned to a metastore.
-
-        Gets a list of all Databricks workspace IDs that have been assigned to given metastore.
+        """Gets a list of all Databricks workspace IDs that have been assigned to given metastore.
 
         :param metastore_id: str
           Unity Catalog metastore ID
@@ -10940,9 +10557,7 @@ class AccountMetastoreAssignmentsAPI:
     def update(
         self, workspace_id: int, metastore_id: str, *, metastore_assignment: Optional[UpdateMetastoreAssignment] = None
     ):
-        """Updates a metastore assignment to a workspaces.
-
-        Updates an assignment to a metastore for a workspace. Currently, only the default catalog may be
+        """Updates an assignment to a metastore for a workspace. Currently, only the default catalog may be
         updated.
 
         :param workspace_id: int
@@ -10977,9 +10592,7 @@ class AccountMetastoresAPI:
         self._api = api_client
 
     def create(self, *, metastore_info: Optional[CreateMetastore] = None) -> AccountsMetastoreInfo:
-        """Create metastore.
-
-        Creates a Unity Catalog metastore.
+        """Creates a Unity Catalog metastore.
 
         :param metastore_info: :class:`CreateMetastore` (optional)
 
@@ -10997,9 +10610,7 @@ class AccountMetastoresAPI:
         return AccountsMetastoreInfo.from_dict(res)
 
     def delete(self, metastore_id: str, *, force: Optional[bool] = None):
-        """Delete a metastore.
-
-        Deletes a Unity Catalog metastore for an account, both specified by ID.
+        """Deletes a Unity Catalog metastore for an account, both specified by ID.
 
         :param metastore_id: str
           Unity Catalog metastore ID
@@ -11024,9 +10635,7 @@ class AccountMetastoresAPI:
         )
 
     def get(self, metastore_id: str) -> AccountsMetastoreInfo:
-        """Get a metastore.
-
-        Gets a Unity Catalog metastore from an account, both specified by ID.
+        """Gets a Unity Catalog metastore from an account, both specified by ID.
 
         :param metastore_id: str
           Unity Catalog metastore ID
@@ -11044,9 +10653,7 @@ class AccountMetastoresAPI:
         return AccountsMetastoreInfo.from_dict(res)
 
     def list(self) -> Iterator[MetastoreInfo]:
-        """Get all metastores associated with an account.
-
-        Gets all Unity Catalog metastores associated with an account specified by ID.
+        """Gets all Unity Catalog metastores associated with an account specified by ID.
 
         :returns: Iterator over :class:`MetastoreInfo`
         """
@@ -11060,9 +10667,7 @@ class AccountMetastoresAPI:
         return parsed if parsed is not None else []
 
     def update(self, metastore_id: str, *, metastore_info: Optional[UpdateMetastore] = None) -> AccountsMetastoreInfo:
-        """Update a metastore.
-
-        Updates an existing Unity Catalog metastore.
+        """Updates an existing Unity Catalog metastore.
 
         :param metastore_id: str
           Unity Catalog metastore ID
@@ -11093,9 +10698,7 @@ class AccountStorageCredentialsAPI:
     def create(
         self, metastore_id: str, *, credential_info: Optional[CreateStorageCredential] = None
     ) -> AccountsStorageCredentialInfo:
-        """Create a storage credential.
-
-        Creates a new storage credential. The request object is specific to the cloud:
+        """Creates a new storage credential. The request object is specific to the cloud:
 
         * **AwsIamRole** for AWS credentials * **AzureServicePrincipal** for Azure credentials *
         **GcpServiceAcountKey** for GCP credentials.
@@ -11126,9 +10729,7 @@ class AccountStorageCredentialsAPI:
         return AccountsStorageCredentialInfo.from_dict(res)
 
     def delete(self, metastore_id: str, storage_credential_name: str, *, force: Optional[bool] = None):
-        """Delete a storage credential.
-
-        Deletes a storage credential from the metastore. The caller must be an owner of the storage
+        """Deletes a storage credential from the metastore. The caller must be an owner of the storage
         credential.
 
         :param metastore_id: str
@@ -11156,9 +10757,7 @@ class AccountStorageCredentialsAPI:
         )
 
     def get(self, metastore_id: str, storage_credential_name: str) -> AccountsStorageCredentialInfo:
-        """Gets the named storage credential.
-
-        Gets a storage credential from the metastore. The caller must be a metastore admin, the owner of the
+        """Gets a storage credential from the metastore. The caller must be a metastore admin, the owner of the
         storage credential, or have a level of privilege on the storage credential.
 
         :param metastore_id: str
@@ -11181,9 +10780,7 @@ class AccountStorageCredentialsAPI:
         return AccountsStorageCredentialInfo.from_dict(res)
 
     def list(self, metastore_id: str) -> Iterator[StorageCredentialInfo]:
-        """Get all storage credentials assigned to a metastore.
-
-        Gets a list of all storage credentials that have been assigned to given metastore.
+        """Gets a list of all storage credentials that have been assigned to given metastore.
 
         :param metastore_id: str
           Unity Catalog metastore ID
@@ -11210,9 +10807,7 @@ class AccountStorageCredentialsAPI:
         *,
         credential_info: Optional[UpdateStorageCredential] = None,
     ) -> AccountsStorageCredentialInfo:
-        """Updates a storage credential.
-
-        Updates a storage credential on the metastore. The caller must be the owner of the storage credential.
+        """Updates a storage credential on the metastore. The caller must be the owner of the storage credential.
         If the caller is a metastore admin, only the __owner__ credential can be changed.
 
         :param metastore_id: str
@@ -11248,9 +10843,7 @@ class ArtifactAllowlistsAPI:
         self._api = api_client
 
     def get(self, artifact_type: ArtifactType) -> ArtifactAllowlistInfo:
-        """Get an artifact allowlist.
-
-        Get the artifact allowlist of a certain artifact type. The caller must be a metastore admin or have
+        """Get the artifact allowlist of a certain artifact type. The caller must be a metastore admin or have
         the **MANAGE ALLOWLIST** privilege on the metastore.
 
         :param artifact_type: :class:`ArtifactType`
@@ -11275,9 +10868,7 @@ class ArtifactAllowlistsAPI:
         created_by: Optional[str] = None,
         metastore_id: Optional[str] = None,
     ) -> ArtifactAllowlistInfo:
-        """Set an artifact allowlist.
-
-        Set the artifact allowlist of a certain artifact type. The whole artifact allowlist is replaced with
+        """Set the artifact allowlist of a certain artifact type. The whole artifact allowlist is replaced with
         the new allowlist. The caller must be a metastore admin or have the **MANAGE ALLOWLIST** privilege on
         the metastore.
 
@@ -11337,9 +10928,7 @@ class CatalogsAPI:
         share_name: Optional[str] = None,
         storage_root: Optional[str] = None,
     ) -> CatalogInfo:
-        """Create a catalog.
-
-        Creates a new catalog instance in the parent metastore if the caller is a metastore admin or has the
+        """Creates a new catalog instance in the parent metastore if the caller is a metastore admin or has the
         **CREATE_CATALOG** privilege.
 
         :param name: str
@@ -11389,9 +10978,7 @@ class CatalogsAPI:
         return CatalogInfo.from_dict(res)
 
     def delete(self, name: str, *, force: Optional[bool] = None):
-        """Delete a catalog.
-
-        Deletes the catalog that matches the supplied name. The caller must be a metastore admin or the owner
+        """Deletes the catalog that matches the supplied name. The caller must be a metastore admin or the owner
         of the catalog.
 
         :param name: str
@@ -11412,9 +10999,7 @@ class CatalogsAPI:
         self._api.do("DELETE", f"/api/2.1/unity-catalog/catalogs/{name}", query=query, headers=headers)
 
     def get(self, name: str, *, include_browse: Optional[bool] = None) -> CatalogInfo:
-        """Get a catalog.
-
-        Gets the specified catalog in a metastore. The caller must be a metastore admin, the owner of the
+        """Gets the specified catalog in a metastore. The caller must be a metastore admin, the owner of the
         catalog, or a user that has the **USE_CATALOG** privilege set for their account.
 
         :param name: str
@@ -11443,9 +11028,7 @@ class CatalogsAPI:
         max_results: Optional[int] = None,
         page_token: Optional[str] = None,
     ) -> Iterator[CatalogInfo]:
-        """List catalogs.
-
-        Gets an array of catalogs in the metastore. If the caller is the metastore admin, all catalogs will be
+        """Gets an array of catalogs in the metastore. If the caller is the metastore admin, all catalogs will be
         retrieved. Otherwise, only catalogs owned by the caller (or for which the caller has the
         **USE_CATALOG** privilege) will be retrieved. There is no guarantee of a specific ordering of the
         elements in the array.
@@ -11499,9 +11082,7 @@ class CatalogsAPI:
         owner: Optional[str] = None,
         properties: Optional[Dict[str, str]] = None,
     ) -> CatalogInfo:
-        """Update a catalog.
-
-        Updates the catalog that matches the supplied name. The caller must be either the owner of the
+        """Updates the catalog that matches the supplied name. The caller must be either the owner of the
         catalog, or a metastore admin (when changing the owner field of the catalog).
 
         :param name: str
@@ -11570,9 +11151,7 @@ class ConnectionsAPI:
         properties: Optional[Dict[str, str]] = None,
         read_only: Optional[bool] = None,
     ) -> ConnectionInfo:
-        """Create a connection.
-
-        Creates a new connection
+        """Creates a new connection
 
         Creates a new connection to an external data source. It allows users to specify connection details and
         configurations for interaction with the external server.
@@ -11586,7 +11165,7 @@ class ConnectionsAPI:
         :param comment: str (optional)
           User-provided free-form text description.
         :param properties: Dict[str,str] (optional)
-          An object containing map of key-value properties attached to the connection.
+          A map of key-value properties attached to the securable.
         :param read_only: bool (optional)
           If the connection is read only.
 
@@ -11614,9 +11193,7 @@ class ConnectionsAPI:
         return ConnectionInfo.from_dict(res)
 
     def delete(self, name: str):
-        """Delete a connection.
-
-        Deletes the connection that matches the supplied name.
+        """Deletes the connection that matches the supplied name.
 
         :param name: str
           The name of the connection to be deleted.
@@ -11631,9 +11208,7 @@ class ConnectionsAPI:
         self._api.do("DELETE", f"/api/2.1/unity-catalog/connections/{name}", headers=headers)
 
     def get(self, name: str) -> ConnectionInfo:
-        """Get a connection.
-
-        Gets a connection from it's name.
+        """Gets a connection from it's name.
 
         :param name: str
           Name of the connection.
@@ -11649,9 +11224,7 @@ class ConnectionsAPI:
         return ConnectionInfo.from_dict(res)
 
     def list(self, *, max_results: Optional[int] = None, page_token: Optional[str] = None) -> Iterator[ConnectionInfo]:
-        """List connections.
-
-        List all connections.
+        """List all connections.
 
         :param max_results: int (optional)
           Maximum number of connections to return. - If not set, all connections are returned (not
@@ -11673,8 +11246,6 @@ class ConnectionsAPI:
             "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/connections", query=query, headers=headers)
             if "connections" in json:
@@ -11687,9 +11258,7 @@ class ConnectionsAPI:
     def update(
         self, name: str, options: Dict[str, str], *, new_name: Optional[str] = None, owner: Optional[str] = None
     ) -> ConnectionInfo:
-        """Update a connection.
-
-        Updates the connection that matches the supplied name.
+        """Updates the connection that matches the supplied name.
 
         :param name: str
           Name of the connection.
@@ -11743,9 +11312,7 @@ class CredentialsAPI:
         read_only: Optional[bool] = None,
         skip_validation: Optional[bool] = None,
     ) -> CredentialInfo:
-        """Create a credential.
-
-        Creates a new credential. The type of credential to be created is determined by the **purpose** field,
+        """Creates a new credential. The type of credential to be created is determined by the **purpose** field,
         which should be either **SERVICE** or **STORAGE**.
 
         The caller must be a metastore admin or have the metastore privilege **CREATE_STORAGE_CREDENTIAL** for
@@ -11755,15 +11322,15 @@ class CredentialsAPI:
           The credential name. The name must be unique among storage and service credentials within the
           metastore.
         :param aws_iam_role: :class:`AwsIamRole` (optional)
-          The AWS IAM role configuration
+          The AWS IAM role configuration.
         :param azure_managed_identity: :class:`AzureManagedIdentity` (optional)
           The Azure managed identity configuration.
         :param azure_service_principal: :class:`AzureServicePrincipal` (optional)
-          The Azure service principal configuration. Only applicable when purpose is **STORAGE**.
+          The Azure service principal configuration.
         :param comment: str (optional)
           Comment associated with the credential.
         :param databricks_gcp_service_account: :class:`DatabricksGcpServiceAccount` (optional)
-          GCP long-lived credential. Databricks-created Google Cloud Storage service account.
+          The Databricks managed GCP service account configuration.
         :param purpose: :class:`CredentialPurpose` (optional)
           Indicates the purpose of the credential.
         :param read_only: bool (optional)
@@ -11802,9 +11369,7 @@ class CredentialsAPI:
         return CredentialInfo.from_dict(res)
 
     def delete_credential(self, name_arg: str, *, force: Optional[bool] = None):
-        """Delete a credential.
-
-        Deletes a service or storage credential from the metastore. The caller must be an owner of the
+        """Deletes a service or storage credential from the metastore. The caller must be an owner of the
         credential.
 
         :param name_arg: str
@@ -11832,9 +11397,7 @@ class CredentialsAPI:
         azure_options: Optional[GenerateTemporaryServiceCredentialAzureOptions] = None,
         gcp_options: Optional[GenerateTemporaryServiceCredentialGcpOptions] = None,
     ) -> TemporaryCredentials:
-        """Generate a temporary service credential.
-
-        Returns a set of temporary credentials generated using the specified service credential. The caller
+        """Returns a set of temporary credentials generated using the specified service credential. The caller
         must be a metastore admin or have the metastore privilege **ACCESS** on the service credential.
 
         :param credential_name: str
@@ -11862,9 +11425,7 @@ class CredentialsAPI:
         return TemporaryCredentials.from_dict(res)
 
     def get_credential(self, name_arg: str) -> CredentialInfo:
-        """Get a credential.
-
-        Gets a service or storage credential from the metastore. The caller must be a metastore admin, the
+        """Gets a service or storage credential from the metastore. The caller must be a metastore admin, the
         owner of the credential, or have any permission on the credential.
 
         :param name_arg: str
@@ -11887,9 +11448,7 @@ class CredentialsAPI:
         page_token: Optional[str] = None,
         purpose: Optional[CredentialPurpose] = None,
     ) -> Iterator[CredentialInfo]:
-        """List credentials.
-
-        Gets an array of credentials (as __CredentialInfo__ objects).
+        """Gets an array of credentials (as __CredentialInfo__ objects).
 
         The array is limited to only the credentials that the caller has permission to access. If the caller
         is a metastore admin, retrieval of credentials is unrestricted. There is no guarantee of a specific
@@ -11944,9 +11503,7 @@ class CredentialsAPI:
         read_only: Optional[bool] = None,
         skip_validation: Optional[bool] = None,
     ) -> CredentialInfo:
-        """Update a credential.
-
-        Updates a service or storage credential on the metastore.
+        """Updates a service or storage credential on the metastore.
 
         The caller must be the owner of the credential or a metastore admin or have the `MANAGE` permission.
         If the caller is a metastore admin, only the __owner__ field can be changed.
@@ -11954,15 +11511,15 @@ class CredentialsAPI:
         :param name_arg: str
           Name of the credential.
         :param aws_iam_role: :class:`AwsIamRole` (optional)
-          The AWS IAM role configuration
+          The AWS IAM role configuration.
         :param azure_managed_identity: :class:`AzureManagedIdentity` (optional)
           The Azure managed identity configuration.
         :param azure_service_principal: :class:`AzureServicePrincipal` (optional)
-          The Azure service principal configuration. Only applicable when purpose is **STORAGE**.
+          The Azure service principal configuration.
         :param comment: str (optional)
           Comment associated with the credential.
         :param databricks_gcp_service_account: :class:`DatabricksGcpServiceAccount` (optional)
-          GCP long-lived credential. Databricks-created Google Cloud Storage service account.
+          The Databricks managed GCP service account configuration.
         :param force: bool (optional)
           Force an update even if there are dependent services (when purpose is **SERVICE**) or dependent
           external locations and external tables (when purpose is **STORAGE**).
@@ -12023,9 +11580,7 @@ class CredentialsAPI:
         read_only: Optional[bool] = None,
         url: Optional[str] = None,
     ) -> ValidateCredentialResponse:
-        """Validate a credential.
-
-        Validates a credential.
+        """Validates a credential.
 
         For service credentials (purpose is **SERVICE**), either the __credential_name__ or the cloud-specific
         credential must be provided.
@@ -12086,241 +11641,6 @@ class CredentialsAPI:
         return ValidateCredentialResponse.from_dict(res)
 
 
-class DatabaseInstancesAPI:
-    """Database Instances provide access to a database via REST API or direct SQL."""
-
-    def __init__(self, api_client):
-        self._api = api_client
-
-    def create_database_catalog(self, catalog: DatabaseCatalog) -> DatabaseCatalog:
-        """Create a Database Catalog.
-
-        :param catalog: :class:`DatabaseCatalog`
-
-        :returns: :class:`DatabaseCatalog`
-        """
-        body = catalog.as_dict()
-        headers = {
-            "Accept": "application/json",
-            "Content-Type": "application/json",
-        }
-
-        res = self._api.do("POST", "/api/2.0/database/catalogs", body=body, headers=headers)
-        return DatabaseCatalog.from_dict(res)
-
-    def create_database_instance(self, database_instance: DatabaseInstance) -> DatabaseInstance:
-        """Create a Database Instance.
-
-        :param database_instance: :class:`DatabaseInstance`
-          A DatabaseInstance represents a logical Postgres instance, comprised of both compute and storage.
-
-        :returns: :class:`DatabaseInstance`
-        """
-        body = database_instance.as_dict()
-        headers = {
-            "Accept": "application/json",
-            "Content-Type": "application/json",
-        }
-
-        res = self._api.do("POST", "/api/2.0/database/instances", body=body, headers=headers)
-        return DatabaseInstance.from_dict(res)
-
-    def create_synced_database_table(self, synced_table: SyncedDatabaseTable) -> SyncedDatabaseTable:
-        """Create a Synced Database Table.
-
-        :param synced_table: :class:`SyncedDatabaseTable`
-          Next field marker: 10
-
-        :returns: :class:`SyncedDatabaseTable`
-        """
-        body = synced_table.as_dict()
-        headers = {
-            "Accept": "application/json",
-            "Content-Type": "application/json",
-        }
-
-        res = self._api.do("POST", "/api/2.0/database/synced_tables", body=body, headers=headers)
-        return SyncedDatabaseTable.from_dict(res)
-
-    def delete_database_catalog(self, name: str):
-        """Delete a Database Catalog.
-
-        :param name: str
-
-
-        """
-
-        headers = {
-            "Accept": "application/json",
-        }
-
-        self._api.do("DELETE", f"/api/2.0/database/catalogs/{name}", headers=headers)
-
-    def delete_database_instance(self, name: str, *, force: Optional[bool] = None, purge: Optional[bool] = None):
-        """Delete a Database Instance.
-
-        :param name: str
-          Name of the instance to delete.
-        :param force: bool (optional)
-          By default, a instance cannot be deleted if it has descendant instances created via PITR. If this
-          flag is specified as true, all descendent instances will be deleted as well.
-        :param purge: bool (optional)
-          If false, the database instance is soft deleted. Soft deleted instances behave as if they are
-          deleted, and cannot be used for CRUD operations nor connected to. However they can be undeleted by
-          calling the undelete API for a limited time. If true, the database instance is hard deleted and
-          cannot be undeleted.
-
-
-        """
-
-        query = {}
-        if force is not None:
-            query["force"] = force
-        if purge is not None:
-            query["purge"] = purge
-        headers = {
-            "Accept": "application/json",
-        }
-
-        self._api.do("DELETE", f"/api/2.0/database/instances/{name}", query=query, headers=headers)
-
-    def delete_synced_database_table(self, name: str):
-        """Delete a Synced Database Table.
-
-        :param name: str
-
-
-        """
-
-        headers = {
-            "Accept": "application/json",
-        }
-
-        self._api.do("DELETE", f"/api/2.0/database/synced_tables/{name}", headers=headers)
-
-    def find_database_instance_by_uid(self, *, uid: Optional[str] = None) -> DatabaseInstance:
-        """Find a Database Instance by uid.
-
-        :param uid: str (optional)
-          UID of the cluster to get.
-
-        :returns: :class:`DatabaseInstance`
-        """
-
-        query = {}
-        if uid is not None:
-            query["uid"] = uid
-        headers = {
-            "Accept": "application/json",
-        }
-
-        res = self._api.do("GET", "/api/2.0/database/instances:findByUid", query=query, headers=headers)
-        return DatabaseInstance.from_dict(res)
-
-    def get_database_catalog(self, name: str) -> DatabaseCatalog:
-        """Get a Database Catalog.
-
-        :param name: str
-
-        :returns: :class:`DatabaseCatalog`
-        """
-
-        headers = {
-            "Accept": "application/json",
-        }
-
-        res = self._api.do("GET", f"/api/2.0/database/catalogs/{name}", headers=headers)
-        return DatabaseCatalog.from_dict(res)
-
-    def get_database_instance(self, name: str) -> DatabaseInstance:
-        """Get a Database Instance.
-
-        :param name: str
-          Name of the cluster to get.
-
-        :returns: :class:`DatabaseInstance`
-        """
-
-        headers = {
-            "Accept": "application/json",
-        }
-
-        res = self._api.do("GET", f"/api/2.0/database/instances/{name}", headers=headers)
-        return DatabaseInstance.from_dict(res)
-
-    def get_synced_database_table(self, name: str) -> SyncedDatabaseTable:
-        """Get a Synced Database Table.
-
-        :param name: str
-
-        :returns: :class:`SyncedDatabaseTable`
-        """
-
-        headers = {
-            "Accept": "application/json",
-        }
-
-        res = self._api.do("GET", f"/api/2.0/database/synced_tables/{name}", headers=headers)
-        return SyncedDatabaseTable.from_dict(res)
-
-    def list_database_instances(
-        self, *, page_size: Optional[int] = None, page_token: Optional[str] = None
-    ) -> Iterator[DatabaseInstance]:
-        """List Database Instances.
-
-        :param page_size: int (optional)
-          Upper bound for items returned.
-        :param page_token: str (optional)
-          Pagination token to go to the next page of Database Instances. Requests first page if absent.
-
-        :returns: Iterator over :class:`DatabaseInstance`
-        """
-
-        query = {}
-        if page_size is not None:
-            query["page_size"] = page_size
-        if page_token is not None:
-            query["page_token"] = page_token
-        headers = {
-            "Accept": "application/json",
-        }
-
-        while True:
-            json = self._api.do("GET", "/api/2.0/database/instances", query=query, headers=headers)
-            if "database_instances" in json:
-                for v in json["database_instances"]:
-                    yield DatabaseInstance.from_dict(v)
-            if "next_page_token" not in json or not json["next_page_token"]:
-                return
-            query["page_token"] = json["next_page_token"]
-
-    def update_database_instance(
-        self, name: str, database_instance: DatabaseInstance, update_mask: str
-    ) -> DatabaseInstance:
-        """Update a Database Instance.
-
-        :param name: str
-          The name of the instance. This is the unique identifier for the instance.
-        :param database_instance: :class:`DatabaseInstance`
-          A DatabaseInstance represents a logical Postgres instance, comprised of both compute and storage.
-        :param update_mask: str
-          The list of fields to update.
-
-        :returns: :class:`DatabaseInstance`
-        """
-        body = database_instance.as_dict()
-        query = {}
-        if update_mask is not None:
-            query["update_mask"] = update_mask
-        headers = {
-            "Accept": "application/json",
-            "Content-Type": "application/json",
-        }
-
-        res = self._api.do("PATCH", f"/api/2.0/database/instances/{name}", query=query, body=body, headers=headers)
-        return DatabaseInstance.from_dict(res)
-
-
 class ExternalLocationsAPI:
     """An external location is an object that combines a cloud storage path with a storage credential that
     authorizes access to the cloud storage path. Each external location is subject to Unity Catalog
@@ -12350,9 +11670,7 @@ class ExternalLocationsAPI:
         read_only: Optional[bool] = None,
         skip_validation: Optional[bool] = None,
     ) -> ExternalLocationInfo:
-        """Create an external location.
-
-        Creates a new external location entry in the metastore. The caller must be a metastore admin or have
+        """Creates a new external location entry in the metastore. The caller must be a metastore admin or have
         the **CREATE_EXTERNAL_LOCATION** privilege on both the metastore and the associated storage
         credential.
 
@@ -12411,9 +11729,7 @@ class ExternalLocationsAPI:
         return ExternalLocationInfo.from_dict(res)
 
     def delete(self, name: str, *, force: Optional[bool] = None):
-        """Delete an external location.
-
-        Deletes the specified external location from the metastore. The caller must be the owner of the
+        """Deletes the specified external location from the metastore. The caller must be the owner of the
         external location.
 
         :param name: str
@@ -12434,9 +11750,7 @@ class ExternalLocationsAPI:
         self._api.do("DELETE", f"/api/2.1/unity-catalog/external-locations/{name}", query=query, headers=headers)
 
     def get(self, name: str, *, include_browse: Optional[bool] = None) -> ExternalLocationInfo:
-        """Get an external location.
-
-        Gets an external location from the metastore. The caller must be either a metastore admin, the owner
+        """Gets an external location from the metastore. The caller must be either a metastore admin, the owner
         of the external location, or a user that has some privilege on the external location.
 
         :param name: str
@@ -12465,9 +11779,7 @@ class ExternalLocationsAPI:
         max_results: Optional[int] = None,
         page_token: Optional[str] = None,
     ) -> Iterator[ExternalLocationInfo]:
-        """List external locations.
-
-        Gets an array of external locations (__ExternalLocationInfo__ objects) from the metastore. The caller
+        """Gets an array of external locations (__ExternalLocationInfo__ objects) from the metastore. The caller
         must be a metastore admin, the owner of the external location, or a user that has some privilege on
         the external location. There is no guarantee of a specific ordering of the elements in the array.
 
@@ -12523,9 +11835,7 @@ class ExternalLocationsAPI:
         skip_validation: Optional[bool] = None,
         url: Optional[str] = None,
     ) -> ExternalLocationInfo:
-        """Update an external location.
-
-        Updates an external location in the metastore. The caller must be the owner of the external location,
+        """Updates an external location in the metastore. The caller must be the owner of the external location,
         or be a metastore admin. In the second case, the admin can only update the name of the external
         location.
 
@@ -12608,9 +11918,7 @@ class FunctionsAPI:
         self._api = api_client
 
     def create(self, function_info: CreateFunction) -> FunctionInfo:
-        """Create a function.
-
-        **WARNING: This API is experimental and will change in future versions**
+        """**WARNING: This API is experimental and will change in future versions**
 
         Creates a new function
 
@@ -12635,9 +11943,7 @@ class FunctionsAPI:
         return FunctionInfo.from_dict(res)
 
     def delete(self, name: str, *, force: Optional[bool] = None):
-        """Delete a function.
-
-        Deletes the function that matches the supplied name. For the deletion to succeed, the user must
+        """Deletes the function that matches the supplied name. For the deletion to succeed, the user must
         satisfy one of the following conditions: - Is the owner of the function's parent catalog - Is the
         owner of the function's parent schema and have the **USE_CATALOG** privilege on its parent catalog -
         Is the owner of the function itself and have both the **USE_CATALOG** privilege on its parent catalog
@@ -12662,9 +11968,7 @@ class FunctionsAPI:
         self._api.do("DELETE", f"/api/2.1/unity-catalog/functions/{name}", query=query, headers=headers)
 
     def get(self, name: str, *, include_browse: Optional[bool] = None) -> FunctionInfo:
-        """Get a function.
-
-        Gets a function from within a parent catalog and schema. For the fetch to succeed, the user must
+        """Gets a function from within a parent catalog and schema. For the fetch to succeed, the user must
         satisfy one of the following requirements: - Is a metastore admin - Is an owner of the function's
         parent catalog - Have the **USE_CATALOG** privilege on the function's parent catalog and be the owner
         of the function - Have the **USE_CATALOG** privilege on the function's parent catalog, the
@@ -12700,9 +12004,7 @@ class FunctionsAPI:
         max_results: Optional[int] = None,
         page_token: Optional[str] = None,
     ) -> Iterator[FunctionInfo]:
-        """List functions.
-
-        List functions within the specified parent catalog and schema. If the user is a metastore admin, all
+        """List functions within the specified parent catalog and schema. If the user is a metastore admin, all
         functions are returned in the output list. Otherwise, the user must have the **USE_CATALOG** privilege
         on the catalog and the **USE_SCHEMA** privilege on the schema, and the output list contains only
         functions for which either the user has the **EXECUTE** privilege or the user is the owner. There is
@@ -12751,9 +12053,7 @@ class FunctionsAPI:
             query["page_token"] = json["next_page_token"]
 
     def update(self, name: str, *, owner: Optional[str] = None) -> FunctionInfo:
-        """Update a function.
-
-        Updates the function that matches the supplied name. Only the owner of the function can be updated. If
+        """Updates the function that matches the supplied name. Only the owner of the function can be updated. If
         the user is not a metastore admin, the user must be a member of the group that is the new function
         owner. - Is a metastore admin - Is the owner of the function's parent catalog - Is the owner of the
         function's parent schema and has the **USE_CATALOG** privilege on its parent catalog - Is the owner of
@@ -12794,22 +12094,44 @@ class GrantsAPI:
     def __init__(self, api_client):
         self._api = api_client
 
-    def get(self, securable_type: SecurableType, full_name: str, *, principal: Optional[str] = None) -> PermissionsList:
-        """Get permissions.
-
-        Gets the permissions for a securable.
+    def get(
+        self,
+        securable_type: str,
+        full_name: str,
+        *,
+        max_results: Optional[int] = None,
+        page_token: Optional[str] = None,
+        principal: Optional[str] = None,
+    ) -> GetPermissionsResponse:
+        """Gets the permissions for a securable. Does not include inherited permissions.
 
-        :param securable_type: :class:`SecurableType`
+        :param securable_type: str
           Type of securable.
         :param full_name: str
           Full name of securable.
+        :param max_results: int (optional)
+          Specifies the maximum number of privileges to return (page length). Every PrivilegeAssignment
+          present in a single page response is guaranteed to contain all the privileges granted on the
+          requested Securable for the respective principal.
+
+          If not set, all the permissions are returned. If set to - lesser than 0: invalid parameter error -
+          0: page length is set to a server configured value - lesser than 150 but greater than 0: invalid
+          parameter error (this is to ensure that server is able to return at least one complete
+          PrivilegeAssignment in a single page response) - greater than (or equal to) 150: page length is the
+          minimum of this value and a server configured value
+        :param page_token: str (optional)
+          Opaque pagination token to go to next page based on previous query.
         :param principal: str (optional)
           If provided, only the permissions for the specified principal (user or group) are returned.
 
-        :returns: :class:`PermissionsList`
+        :returns: :class:`GetPermissionsResponse`
         """
 
         query = {}
+        if max_results is not None:
+            query["max_results"] = max_results
+        if page_token is not None:
+            query["page_token"] = page_token
         if principal is not None:
             query["principal"] = principal
         headers = {
@@ -12817,24 +12139,39 @@ class GrantsAPI:
         }
 
         res = self._api.do(
-            "GET",
-            f"/api/2.1/unity-catalog/permissions/{securable_type.value}/{full_name}",
-            query=query,
-            headers=headers,
+            "GET", f"/api/2.1/unity-catalog/permissions/{securable_type}/{full_name}", query=query, headers=headers
         )
-        return PermissionsList.from_dict(res)
+        return GetPermissionsResponse.from_dict(res)
 
     def get_effective(
-        self, securable_type: SecurableType, full_name: str, *, principal: Optional[str] = None
+        self,
+        securable_type: str,
+        full_name: str,
+        *,
+        max_results: Optional[int] = None,
+        page_token: Optional[str] = None,
+        principal: Optional[str] = None,
     ) -> EffectivePermissionsList:
-        """Get effective permissions.
-
-        Gets the effective permissions for a securable.
+        """Gets the effective permissions for a securable. Includes inherited permissions from any parent
+        securables.
 
-        :param securable_type: :class:`SecurableType`
+        :param securable_type: str
           Type of securable.
         :param full_name: str
           Full name of securable.
+        :param max_results: int (optional)
+          Specifies the maximum number of privileges to return (page length). Every
+          EffectivePrivilegeAssignment present in a single page response is guaranteed to contain all the
+          effective privileges granted on (or inherited by) the requested Securable for the respective
+          principal.
+
+          If not set, all the effective permissions are returned. If set to - lesser than 0: invalid parameter
+          error - 0: page length is set to a server configured value - lesser than 150 but greater than 0:
+          invalid parameter error (this is to ensure that server is able to return at least one complete
+          EffectivePrivilegeAssignment in a single page response) - greater than (or equal to) 150: page
+          length is the minimum of this value and a server configured value
+        :param page_token: str (optional)
+          Opaque token for the next page of results (pagination).
         :param principal: str (optional)
           If provided, only the effective permissions for the specified principal (user or group) are
           returned.
@@ -12843,6 +12180,10 @@ class GrantsAPI:
         """
 
         query = {}
+        if max_results is not None:
+            query["max_results"] = max_results
+        if page_token is not None:
+            query["page_token"] = page_token
         if principal is not None:
             query["principal"] = principal
         headers = {
@@ -12851,27 +12192,25 @@ class GrantsAPI:
 
         res = self._api.do(
             "GET",
-            f"/api/2.1/unity-catalog/effective-permissions/{securable_type.value}/{full_name}",
+            f"/api/2.1/unity-catalog/effective-permissions/{securable_type}/{full_name}",
             query=query,
             headers=headers,
         )
         return EffectivePermissionsList.from_dict(res)
 
     def update(
-        self, securable_type: SecurableType, full_name: str, *, changes: Optional[List[PermissionsChange]] = None
-    ) -> PermissionsList:
-        """Update permissions.
-
-        Updates the permissions for a securable.
+        self, securable_type: str, full_name: str, *, changes: Optional[List[PermissionsChange]] = None
+    ) -> UpdatePermissionsResponse:
+        """Updates the permissions for a securable.
 
-        :param securable_type: :class:`SecurableType`
+        :param securable_type: str
           Type of securable.
         :param full_name: str
           Full name of securable.
         :param changes: List[:class:`PermissionsChange`] (optional)
           Array of permissions change objects.
 
-        :returns: :class:`PermissionsList`
+        :returns: :class:`UpdatePermissionsResponse`
         """
         body = {}
         if changes is not None:
@@ -12882,12 +12221,9 @@ class GrantsAPI:
         }
 
         res = self._api.do(
-            "PATCH",
-            f"/api/2.1/unity-catalog/permissions/{securable_type.value}/{full_name}",
-            body=body,
-            headers=headers,
+            "PATCH", f"/api/2.1/unity-catalog/permissions/{securable_type}/{full_name}", body=body, headers=headers
         )
-        return PermissionsList.from_dict(res)
+        return UpdatePermissionsResponse.from_dict(res)
 
 
 class MetastoresAPI:
@@ -12907,9 +12243,7 @@ class MetastoresAPI:
         self._api = api_client
 
     def assign(self, workspace_id: int, metastore_id: str, default_catalog_name: str):
-        """Create an assignment.
-
-        Creates a new metastore assignment. If an assignment for the same __workspace_id__ exists, it will be
+        """Creates a new metastore assignment. If an assignment for the same __workspace_id__ exists, it will be
         overwritten by the new __metastore_id__ and __default_catalog_name__. The caller must be an account
         admin.
 
@@ -12918,7 +12252,7 @@ class MetastoresAPI:
         :param metastore_id: str
           The unique ID of the metastore.
         :param default_catalog_name: str
-          The name of the default catalog in the metastore. This field is depracted. Please use "Default
+          The name of the default catalog in the metastore. This field is deprecated. Please use "Default
           Namespace API" to configure the default catalog for a Databricks workspace.
 
 
@@ -12936,9 +12270,7 @@ class MetastoresAPI:
         self._api.do("PUT", f"/api/2.1/unity-catalog/workspaces/{workspace_id}/metastore", body=body, headers=headers)
 
     def create(self, name: str, *, region: Optional[str] = None, storage_root: Optional[str] = None) -> MetastoreInfo:
-        """Create a metastore.
-
-        Creates a new metastore based on a provided name and optional storage root path. By default (if the
+        """Creates a new metastore based on a provided name and optional storage root path. By default (if the
         __owner__ field is not set), the owner of the new metastore is the user calling the
         __createMetastore__ API. If the __owner__ field is set to the empty string (**""**), the ownership is
         assigned to the System User instead.
@@ -12946,9 +12278,7 @@ class MetastoresAPI:
         :param name: str
           The user-specified name of the metastore.
         :param region: str (optional)
-          Cloud region which the metastore serves (e.g., `us-west-2`, `westus`). The field can be omitted in
-          the __workspace-level__ __API__ but not in the __account-level__ __API__. If this field is omitted,
-          the region of the workspace receiving the request will be used.
+          Cloud region which the metastore serves (e.g., `us-west-2`, `westus`).
         :param storage_root: str (optional)
           The storage root URL for metastore
 
@@ -12970,9 +12300,7 @@ class MetastoresAPI:
         return MetastoreInfo.from_dict(res)
 
     def current(self) -> MetastoreAssignment:
-        """Get metastore assignment for workspace.
-
-        Gets the metastore assignment for the workspace being accessed.
+        """Gets the metastore assignment for the workspace being accessed.
 
         :returns: :class:`MetastoreAssignment`
         """
@@ -12985,9 +12313,7 @@ class MetastoresAPI:
         return MetastoreAssignment.from_dict(res)
 
     def delete(self, id: str, *, force: Optional[bool] = None):
-        """Delete a metastore.
-
-        Deletes a metastore. The caller must be a metastore admin.
+        """Deletes a metastore. The caller must be a metastore admin.
 
         :param id: str
           Unique ID of the metastore.
@@ -13007,9 +12333,7 @@ class MetastoresAPI:
         self._api.do("DELETE", f"/api/2.1/unity-catalog/metastores/{id}", query=query, headers=headers)
 
     def get(self, id: str) -> MetastoreInfo:
-        """Get a metastore.
-
-        Gets a metastore that matches the supplied ID. The caller must be a metastore admin to retrieve this
+        """Gets a metastore that matches the supplied ID. The caller must be a metastore admin to retrieve this
         info.
 
         :param id: str
@@ -13025,27 +12349,44 @@ class MetastoresAPI:
         res = self._api.do("GET", f"/api/2.1/unity-catalog/metastores/{id}", headers=headers)
         return MetastoreInfo.from_dict(res)
 
-    def list(self) -> Iterator[MetastoreInfo]:
-        """List metastores.
-
-        Gets an array of the available metastores (as __MetastoreInfo__ objects). The caller must be an admin
+    def list(self, *, max_results: Optional[int] = None, page_token: Optional[str] = None) -> Iterator[MetastoreInfo]:
+        """Gets an array of the available metastores (as __MetastoreInfo__ objects). The caller must be an admin
         to retrieve this info. There is no guarantee of a specific ordering of the elements in the array.
 
+        :param max_results: int (optional)
+          Maximum number of metastores to return. - 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 0, the page length is set to a
+          server configured value (recommended); - when set to a value less than 0, an invalid parameter error
+          is returned; - If not set, all the metastores are returned (not recommended). - Note: The number of
+          returned metastores might be less than the specified max_results size, even zero. The only
+          definitive indication that no further metastores 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:`MetastoreInfo`
         """
 
+        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",
         }
 
-        json = self._api.do("GET", "/api/2.1/unity-catalog/metastores", headers=headers)
-        parsed = ListMetastoresResponse.from_dict(json).metastores
-        return parsed if parsed is not None else []
+        while True:
+            json = self._api.do("GET", "/api/2.1/unity-catalog/metastores", query=query, headers=headers)
+            if "metastores" in json:
+                for v in json["metastores"]:
+                    yield MetastoreInfo.from_dict(v)
+            if "next_page_token" not in json or not json["next_page_token"]:
+                return
+            query["page_token"] = json["next_page_token"]
 
     def summary(self) -> GetMetastoreSummaryResponse:
-        """Get a metastore summary.
-
-        Gets information about a metastore. This summary includes the storage credential, the cloud vendor,
+        """Gets information about a metastore. This summary includes the storage credential, the cloud vendor,
         the cloud region, and the global metastore ID.
 
         :returns: :class:`GetMetastoreSummaryResponse`
@@ -13059,9 +12400,7 @@ class MetastoresAPI:
         return GetMetastoreSummaryResponse.from_dict(res)
 
     def unassign(self, workspace_id: int, metastore_id: str):
-        """Delete an assignment.
-
-        Deletes a metastore assignment. The caller must be an account administrator.
+        """Deletes a metastore assignment. The caller must be an account administrator.
 
         :param workspace_id: int
           A workspace ID.
@@ -13088,15 +12427,13 @@ class MetastoresAPI:
         *,
         delta_sharing_organization_name: Optional[str] = None,
         delta_sharing_recipient_token_lifetime_in_seconds: Optional[int] = None,
-        delta_sharing_scope: Optional[UpdateMetastoreDeltaSharingScope] = None,
+        delta_sharing_scope: Optional[DeltaSharingScopeEnum] = None,
         new_name: Optional[str] = None,
         owner: Optional[str] = None,
         privilege_model_version: Optional[str] = None,
         storage_root_credential_id: Optional[str] = None,
     ) -> MetastoreInfo:
-        """Update a metastore.
-
-        Updates information for a specific metastore. The caller must be a metastore admin. If the __owner__
+        """Updates information for a specific metastore. The caller must be a metastore admin. If the __owner__
         field is set to the empty string (**""**), the ownership is updated to the System User.
 
         :param id: str
@@ -13106,7 +12443,7 @@ class MetastoresAPI:
           Sharing as the official name.
         :param delta_sharing_recipient_token_lifetime_in_seconds: int (optional)
           The lifetime of delta sharing recipient token in seconds.
-        :param delta_sharing_scope: :class:`UpdateMetastoreDeltaSharingScope` (optional)
+        :param delta_sharing_scope: :class:`DeltaSharingScopeEnum` (optional)
           The scope of Delta Sharing enabled for the metastore.
         :param new_name: str (optional)
           New name for the metastore.
@@ -13147,9 +12484,7 @@ class MetastoresAPI:
     def update_assignment(
         self, workspace_id: int, *, default_catalog_name: Optional[str] = None, metastore_id: Optional[str] = None
     ):
-        """Update an assignment.
-
-        Updates a metastore assignment. This operation can be used to update __metastore_id__ or
+        """Updates a metastore assignment. This operation can be used to update __metastore_id__ or
         __default_catalog_name__ for a specified Workspace, if the Workspace is already assigned a metastore.
         The caller must be an account admin to update __metastore_id__; otherwise, the caller can be a
         Workspace admin.
@@ -13157,7 +12492,7 @@ class MetastoresAPI:
         :param workspace_id: int
           A workspace ID.
         :param default_catalog_name: str (optional)
-          The name of the default catalog in the metastore. This field is depracted. Please use "Default
+          The name of the default catalog in the metastore. This field is deprecated. Please use "Default
           Namespace API" to configure the default catalog for a Databricks workspace.
         :param metastore_id: str (optional)
           The unique ID of the metastore.
@@ -13189,9 +12524,7 @@ class ModelVersionsAPI:
         self._api = api_client
 
     def delete(self, full_name: str, version: int):
-        """Delete a Model Version.
-
-        Deletes a model version from the specified registered model. Any aliases assigned to the model version
+        """Deletes a model version from the specified registered model. Any aliases assigned to the model version
         will also be deleted.
 
         The caller must be a metastore admin or an owner of the parent registered model. For the latter case,
@@ -13218,9 +12551,7 @@ class ModelVersionsAPI:
         include_aliases: Optional[bool] = None,
         include_browse: Optional[bool] = None,
     ) -> ModelVersionInfo:
-        """Get a Model Version.
-
-        Get a model version.
+        """Get a model version.
 
         The caller must be a metastore admin or an owner of (or have the **EXECUTE** privilege on) the parent
         registered model. For the latter case, the caller must also be the owner or have the **USE_CATALOG**
@@ -13254,9 +12585,7 @@ class ModelVersionsAPI:
         return ModelVersionInfo.from_dict(res)
 
     def get_by_alias(self, full_name: str, alias: str, *, include_aliases: Optional[bool] = None) -> ModelVersionInfo:
-        """Get Model Version By Alias.
-
-        Get a model version by alias.
+        """Get a model version by alias.
 
         The caller must be a metastore admin or an owner of (or have the **EXECUTE** privilege on) the
         registered model. For the latter case, the caller must also be the owner or have the **USE_CATALOG**
@@ -13292,9 +12621,7 @@ class ModelVersionsAPI:
         max_results: Optional[int] = None,
         page_token: Optional[str] = None,
     ) -> Iterator[ModelVersionInfo]:
-        """List Model Versions.
-
-        List model versions. You can list model versions under a particular schema, or list all model versions
+        """List model versions. You can list model versions under a particular schema, or list all model versions
         in the current metastore.
 
         The returned models are filtered based on the privileges of the calling user. For example, the
@@ -13346,9 +12673,7 @@ class ModelVersionsAPI:
             query["page_token"] = json["next_page_token"]
 
     def update(self, full_name: str, version: int, *, comment: Optional[str] = None) -> ModelVersionInfo:
-        """Update a Model Version.
-
-        Updates the specified model version.
+        """Updates the specified model version.
 
         The caller must be a metastore admin or an owner of the parent registered model. For the latter case,
         the caller must also be the owner or have the **USE_CATALOG** privilege on the parent catalog and the
@@ -13415,9 +12740,7 @@ class OnlineTablesAPI:
         raise TimeoutError(f"timed out after {timeout}: {status_message}")
 
     def create(self, table: OnlineTable) -> Wait[OnlineTable]:
-        """Create an Online Table.
-
-        Create a new Online Table.
+        """Create a new Online Table.
 
         :param table: :class:`OnlineTable`
           Online Table information.
@@ -13441,9 +12764,7 @@ class OnlineTablesAPI:
         return self.create(table=table).result(timeout=timeout)
 
     def delete(self, name: str):
-        """Delete an Online Table.
-
-        Delete an online table. Warning: This will delete all the data in the online table. If the source
+        """Delete an online table. Warning: This will delete all the data in the online table. If the source
         Delta table was deleted or modified since this Online Table was created, this will lose the data
         forever!
 
@@ -13460,9 +12781,7 @@ class OnlineTablesAPI:
         self._api.do("DELETE", f"/api/2.0/online-tables/{name}", headers=headers)
 
     def get(self, name: str) -> OnlineTable:
-        """Get an Online Table.
-
-        Get information about an existing online table and its status.
+        """Get information about an existing online table and its status.
 
         :param name: str
           Full three-part (catalog, schema, table) name of the table.
@@ -13490,9 +12809,7 @@ class QualityMonitorsAPI:
         self._api = api_client
 
     def cancel_refresh(self, table_name: str, refresh_id: str):
-        """Cancel refresh.
-
-        Cancel an active monitor refresh for the given refresh ID.
+        """Cancel an active monitor refresh for the given refresh ID.
 
         The caller must either: 1. be an owner of the table's parent catalog 2. have **USE_CATALOG** on the
         table's parent catalog and be an owner of the table's parent schema 3. have the following permissions:
@@ -13533,9 +12850,7 @@ class QualityMonitorsAPI:
         time_series: Optional[MonitorTimeSeries] = None,
         warehouse_id: Optional[str] = None,
     ) -> MonitorInfo:
-        """Create a table monitor.
-
-        Creates a new monitor for the specified table.
+        """Creates a new monitor for the specified table.
 
         The caller must either: 1. be an owner of the table's parent catalog, have **USE_SCHEMA** on the
         table's parent schema, and have **SELECT** access on the table 2. have **USE_CATALOG** on the table's
@@ -13617,9 +12932,7 @@ class QualityMonitorsAPI:
         return MonitorInfo.from_dict(res)
 
     def delete(self, table_name: str):
-        """Delete a table monitor.
-
-        Deletes a monitor for the specified table.
+        """Deletes a monitor for the specified table.
 
         The caller must either: 1. be an owner of the table's parent catalog 2. have **USE_CATALOG** on the
         table's parent catalog and be an owner of the table's parent schema 3. have the following permissions:
@@ -13642,9 +12955,7 @@ class QualityMonitorsAPI:
         self._api.do("DELETE", f"/api/2.1/unity-catalog/tables/{table_name}/monitor", headers=headers)
 
     def get(self, table_name: str) -> MonitorInfo:
-        """Get a table monitor.
-
-        Gets a monitor for the specified table.
+        """Gets a monitor for the specified table.
 
         The caller must either: 1. be an owner of the table's parent catalog 2. have **USE_CATALOG** on the
         table's parent catalog and be an owner of the table's parent schema. 3. have the following
@@ -13669,9 +12980,7 @@ class QualityMonitorsAPI:
         return MonitorInfo.from_dict(res)
 
     def get_refresh(self, table_name: str, refresh_id: str) -> MonitorRefreshInfo:
-        """Get refresh.
-
-        Gets info about a specific monitor refresh using the given refresh ID.
+        """Gets info about a specific monitor refresh using the given refresh ID.
 
         The caller must either: 1. be an owner of the table's parent catalog 2. have **USE_CATALOG** on the
         table's parent catalog and be an owner of the table's parent schema 3. have the following permissions:
@@ -13698,9 +13007,7 @@ class QualityMonitorsAPI:
         return MonitorRefreshInfo.from_dict(res)
 
     def list_refreshes(self, table_name: str) -> MonitorRefreshListResponse:
-        """List refreshes.
-
-        Gets an array containing the history of the most recent refreshes (up to 25) for this table.
+        """Gets an array containing the history of the most recent refreshes (up to 25) for this table.
 
         The caller must either: 1. be an owner of the table's parent catalog 2. have **USE_CATALOG** on the
         table's parent catalog and be an owner of the table's parent schema 3. have the following permissions:
@@ -13725,9 +13032,7 @@ class QualityMonitorsAPI:
     def regenerate_dashboard(
         self, table_name: str, *, warehouse_id: Optional[str] = None
     ) -> RegenerateDashboardResponse:
-        """Regenerate a monitoring dashboard.
-
-        Regenerates the monitoring dashboard for the specified table.
+        """Regenerates the monitoring dashboard for the specified table.
 
         The caller must either: 1. be an owner of the table's parent catalog 2. have **USE_CATALOG** on the
         table's parent catalog and be an owner of the table's parent schema 3. have the following permissions:
@@ -13759,9 +13064,7 @@ class QualityMonitorsAPI:
         return RegenerateDashboardResponse.from_dict(res)
 
     def run_refresh(self, table_name: str) -> MonitorRefreshInfo:
-        """Queue a metric refresh for a monitor.
-
-        Queues a metric refresh on the monitor for the specified table. The refresh will execute in the
+        """Queues a metric refresh on the monitor for the specified table. The refresh will execute in the
         background.
 
         The caller must either: 1. be an owner of the table's parent catalog 2. have **USE_CATALOG** on the
@@ -13800,9 +13103,7 @@ class QualityMonitorsAPI:
         snapshot: Optional[MonitorSnapshot] = None,
         time_series: Optional[MonitorTimeSeries] = None,
     ) -> MonitorInfo:
-        """Update a table monitor.
-
-        Updates a monitor for the specified table.
+        """Updates a monitor for the specified table.
 
         The caller must either: 1. be an owner of the table's parent catalog 2. have **USE_CATALOG** on the
         table's parent catalog and be an owner of the table's parent schema 3. have the following permissions:
@@ -13916,9 +13217,7 @@ class RegisteredModelsAPI:
         comment: Optional[str] = None,
         storage_location: Optional[str] = None,
     ) -> RegisteredModelInfo:
-        """Create a Registered Model.
-
-        Creates a new registered model in Unity Catalog.
+        """Creates a new registered model in Unity Catalog.
 
         File storage for model versions in the registered model will be located in the default location which
         is specified by the parent schema, or the parent catalog, or the Metastore.
@@ -13961,9 +13260,7 @@ class RegisteredModelsAPI:
         return RegisteredModelInfo.from_dict(res)
 
     def delete(self, full_name: str):
-        """Delete a Registered Model.
-
-        Deletes a registered model and all its model versions from the specified parent catalog and schema.
+        """Deletes a registered model and all its model versions from the specified parent catalog and schema.
 
         The caller must be a metastore admin or an owner of the registered model. For the latter case, the
         caller must also be the owner or have the **USE_CATALOG** privilege on the parent catalog and the
@@ -13980,9 +13277,7 @@ class RegisteredModelsAPI:
         self._api.do("DELETE", f"/api/2.1/unity-catalog/models/{full_name}", headers=headers)
 
     def delete_alias(self, full_name: str, alias: str):
-        """Delete a Registered Model Alias.
-
-        Deletes a registered model alias.
+        """Deletes a registered model alias.
 
         The caller must be a metastore admin or an owner of the registered model. For the latter case, the
         caller must also be the owner or have the **USE_CATALOG** privilege on the parent catalog and the
@@ -14003,9 +13298,7 @@ class RegisteredModelsAPI:
     def get(
         self, full_name: str, *, include_aliases: Optional[bool] = None, include_browse: Optional[bool] = None
     ) -> RegisteredModelInfo:
-        """Get a Registered Model.
-
-        Get a registered model.
+        """Get a registered model.
 
         The caller must be a metastore admin or an owner of (or have the **EXECUTE** privilege on) the
         registered model. For the latter case, the caller must also be the owner or have the **USE_CATALOG**
@@ -14043,9 +13336,7 @@ class RegisteredModelsAPI:
         page_token: Optional[str] = None,
         schema_name: Optional[str] = None,
     ) -> Iterator[RegisteredModelInfo]:
-        """List Registered Models.
-
-        List registered models. You can list registered models under a particular schema, or list all
+        """List registered models. You can list registered models under a particular schema, or list all
         registered models in the current metastore.
 
         The returned models are filtered based on the privileges of the calling user. For example, the
@@ -14110,9 +13401,7 @@ class RegisteredModelsAPI:
             query["page_token"] = json["next_page_token"]
 
     def set_alias(self, full_name: str, alias: str, version_num: int) -> RegisteredModelAlias:
-        """Set a Registered Model Alias.
-
-        Set an alias on the specified registered model.
+        """Set an alias on the specified registered model.
 
         The caller must be a metastore admin or an owner of the registered model. For the latter case, the
         caller must also be the owner or have the **USE_CATALOG** privilege on the parent catalog and the
@@ -14148,9 +13437,7 @@ class RegisteredModelsAPI:
         new_name: Optional[str] = None,
         owner: Optional[str] = None,
     ) -> RegisteredModelInfo:
-        """Update a Registered Model.
-
-        Updates the specified registered model.
+        """Updates the specified registered model.
 
         The caller must be a metastore admin or an owner of the registered model. For the latter case, the
         caller must also be the owner or have the **USE_CATALOG** privilege on the parent catalog and the
@@ -14198,9 +13485,7 @@ class ResourceQuotasAPI:
         self._api = api_client
 
     def get_quota(self, parent_securable_type: str, parent_full_name: str, quota_name: str) -> GetQuotaResponse:
-        """Get information for a single resource quota.
-
-        The GetQuota API returns usage information for a single resource quota, defined as a child-parent
+        """The GetQuota API returns usage information for a single resource quota, defined as a child-parent
         pair. This API also refreshes the quota count if it is out of date. Refreshes are triggered
         asynchronously. The updated count might not be returned in the first call.
 
@@ -14228,9 +13513,7 @@ class ResourceQuotasAPI:
     def list_quotas(
         self, *, max_results: Optional[int] = None, page_token: Optional[str] = None
     ) -> Iterator[QuotaInfo]:
-        """List all resource quotas under a metastore.
-
-        ListQuotas returns all quota values under the metastore. There are no SLAs on the freshness of the
+        """ListQuotas returns all quota values under the metastore. There are no SLAs on the freshness of the
         counts returned. This API does not trigger a refresh of quota counts.
 
         :param max_results: int (optional)
@@ -14280,9 +13563,7 @@ class SchemasAPI:
         properties: Optional[Dict[str, str]] = None,
         storage_root: Optional[str] = None,
     ) -> SchemaInfo:
-        """Create a schema.
-
-        Creates a new schema for catalog in the Metatastore. The caller must be a metastore admin, or have the
+        """Creates a new schema for catalog in the Metatastore. The caller must be a metastore admin, or have the
         **CREATE_SCHEMA** privilege in the parent catalog.
 
         :param name: str
@@ -14318,9 +13599,7 @@ class SchemasAPI:
         return SchemaInfo.from_dict(res)
 
     def delete(self, full_name: str, *, force: Optional[bool] = None):
-        """Delete a schema.
-
-        Deletes the specified schema from the parent catalog. The caller must be the owner of the schema or an
+        """Deletes the specified schema from the parent catalog. The caller must be the owner of the schema or an
         owner of the parent catalog.
 
         :param full_name: str
@@ -14341,9 +13620,7 @@ class SchemasAPI:
         self._api.do("DELETE", f"/api/2.1/unity-catalog/schemas/{full_name}", query=query, headers=headers)
 
     def get(self, full_name: str, *, include_browse: Optional[bool] = None) -> SchemaInfo:
-        """Get a schema.
-
-        Gets the specified schema within the metastore. The caller must be a metastore admin, the owner of the
+        """Gets the specified schema within the metastore. The caller must be a metastore admin, the owner of the
         schema, or a user that has the **USE_SCHEMA** privilege on the schema.
 
         :param full_name: str
@@ -14373,9 +13650,7 @@ class SchemasAPI:
         max_results: Optional[int] = None,
         page_token: Optional[str] = None,
     ) -> Iterator[SchemaInfo]:
-        """List schemas.
-
-        Gets an array of schemas for a catalog in the metastore. If the caller is the metastore admin or the
+        """Gets an array of schemas for a catalog in the metastore. If the caller is the metastore admin or the
         owner of the parent catalog, all schemas for the catalog will be retrieved. Otherwise, only schemas
         owned by the caller (or for which the caller has the **USE_SCHEMA** privilege) will be retrieved.
         There is no guarantee of a specific ordering of the elements in the array.
@@ -14409,8 +13684,6 @@ class SchemasAPI:
             "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/schemas", query=query, headers=headers)
             if "schemas" in json:
@@ -14430,9 +13703,7 @@ class SchemasAPI:
         owner: Optional[str] = None,
         properties: Optional[Dict[str, str]] = None,
     ) -> SchemaInfo:
-        """Update a schema.
-
-        Updates a schema for a catalog. The caller must be the owner of the schema or a metastore admin. If
+        """Updates a schema for a catalog. The caller must be the owner of the schema or a metastore admin. If
         the caller is a metastore admin, only the __owner__ field can be changed in the update. If the
         __name__ field must be updated, the caller must be a metastore admin or have the **CREATE_SCHEMA**
         privilege on the parent catalog.
@@ -14442,6 +13713,7 @@ class SchemasAPI:
         :param comment: str (optional)
           User-provided free-form text description.
         :param enable_predictive_optimization: :class:`EnablePredictiveOptimization` (optional)
+          Whether predictive optimization should be enabled for this object and objects under it.
         :param new_name: str (optional)
           New name for the schema.
         :param owner: str (optional)
@@ -14499,12 +13771,14 @@ class StorageCredentialsAPI:
         read_only: Optional[bool] = None,
         skip_validation: Optional[bool] = None,
     ) -> StorageCredentialInfo:
-        """Create a storage credential.
+        """Creates a new storage credential.
 
-        Creates a new storage credential.
+        The caller must be a metastore admin or have the **CREATE_STORAGE_CREDENTIAL** privilege on the
+        metastore.
 
         :param name: str
-          The credential name. The name must be unique within the metastore.
+          The credential name. The name must be unique among storage and service credentials within the
+          metastore.
         :param aws_iam_role: :class:`AwsIamRoleRequest` (optional)
           The AWS IAM role configuration.
         :param azure_managed_identity: :class:`AzureManagedIdentityRequest` (optional)
@@ -14518,7 +13792,8 @@ class StorageCredentialsAPI:
         :param databricks_gcp_service_account: :class:`DatabricksGcpServiceAccountRequest` (optional)
           The Databricks managed GCP service account configuration.
         :param read_only: bool (optional)
-          Whether the storage credential is only usable for read operations.
+          Whether the credential is usable only for read operations. Only applicable when purpose is
+          **STORAGE**.
         :param skip_validation: bool (optional)
           Supplying true to this argument skips validation of the created credential.
 
@@ -14552,15 +13827,14 @@ class StorageCredentialsAPI:
         return StorageCredentialInfo.from_dict(res)
 
     def delete(self, name: str, *, force: Optional[bool] = None):
-        """Delete a credential.
-
-        Deletes a storage credential from the metastore. The caller must be an owner of the storage
+        """Deletes a storage credential from the metastore. The caller must be an owner of the storage
         credential.
 
         :param name: str
           Name of the storage credential.
         :param force: bool (optional)
-          Force deletion even if there are dependent external locations or external tables.
+          Force an update even if there are dependent external locations or external tables (when purpose is
+          **STORAGE**) or dependent services (when purpose is **SERVICE**).
 
 
         """
@@ -14575,9 +13849,7 @@ class StorageCredentialsAPI:
         self._api.do("DELETE", f"/api/2.1/unity-catalog/storage-credentials/{name}", query=query, headers=headers)
 
     def get(self, name: str) -> StorageCredentialInfo:
-        """Get a credential.
-
-        Gets a storage credential from the metastore. The caller must be a metastore admin, the owner of the
+        """Gets a storage credential from the metastore. The caller must be a metastore admin, the owner of the
         storage credential, or have some permission on the storage credential.
 
         :param name: str
@@ -14596,9 +13868,7 @@ class StorageCredentialsAPI:
     def list(
         self, *, max_results: Optional[int] = None, page_token: Optional[str] = None
     ) -> Iterator[StorageCredentialInfo]:
-        """List credentials.
-
-        Gets an array of storage credentials (as __StorageCredentialInfo__ objects). The array is limited to
+        """Gets an array of storage credentials (as __StorageCredentialInfo__ objects). The array is limited to
         only those storage credentials the caller has permission to access. If the caller is a metastore
         admin, retrieval of credentials is unrestricted. There is no guarantee of a specific ordering of the
         elements in the array.
@@ -14624,8 +13894,6 @@ class StorageCredentialsAPI:
             "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/storage-credentials", query=query, headers=headers)
             if "storage_credentials" in json:
@@ -14652,9 +13920,10 @@ class StorageCredentialsAPI:
         read_only: Optional[bool] = None,
         skip_validation: Optional[bool] = None,
     ) -> StorageCredentialInfo:
-        """Update a credential.
+        """Updates a storage credential on the metastore.
 
-        Updates a storage credential on the metastore.
+        The caller must be the owner of the storage credential or a metastore admin. If the caller is a
+        metastore admin, only the **owner** field can be changed.
 
         :param name: str
           Name of the storage credential.
@@ -14673,12 +13942,14 @@ class StorageCredentialsAPI:
         :param force: bool (optional)
           Force update even if there are dependent external locations or external tables.
         :param isolation_mode: :class:`IsolationMode` (optional)
+          Whether the current securable is accessible from all workspaces or a specific set of workspaces.
         :param new_name: str (optional)
           New name for the storage credential.
         :param owner: str (optional)
           Username of current owner of credential.
         :param read_only: bool (optional)
-          Whether the storage credential is only usable for read operations.
+          Whether the credential is usable only for read operations. Only applicable when purpose is
+          **STORAGE**.
         :param skip_validation: bool (optional)
           Supplying true to this argument skips validation of the updated credential.
 
@@ -14730,9 +14001,7 @@ class StorageCredentialsAPI:
         storage_credential_name: Optional[str] = None,
         url: Optional[str] = None,
     ) -> ValidateStorageCredentialResponse:
-        """Validate a storage credential.
-
-        Validates a storage credential. At least one of __external_location_name__ and __url__ need to be
+        """Validates a storage credential. At least one of __external_location_name__ and __url__ need to be
         provided. If only one of them is provided, it will be used for validation. And if both are provided,
         the __url__ will be used for validation, and __external_location_name__ will be ignored when checking
         overlapping urls.
@@ -14757,7 +14026,7 @@ class StorageCredentialsAPI:
         :param read_only: bool (optional)
           Whether the storage credential is only usable for read operations.
         :param storage_credential_name: str (optional)
-          The name of the storage credential to validate.
+          Required. The name of an existing credential or long-lived cloud credential to validate.
         :param url: str (optional)
           The external location url to validate.
 
@@ -14799,9 +14068,7 @@ class SystemSchemasAPI:
         self._api = api_client
 
     def disable(self, metastore_id: str, schema_name: str):
-        """Disable a system schema.
-
-        Disables the system schema and removes it from the system catalog. The caller must be an account admin
+        """Disables the system schema and removes it from the system catalog. The caller must be an account admin
         or a metastore admin.
 
         :param metastore_id: str
@@ -14821,9 +14088,7 @@ class SystemSchemasAPI:
         )
 
     def enable(self, metastore_id: str, schema_name: str, *, catalog_name: Optional[str] = None):
-        """Enable a system schema.
-
-        Enables the system schema and adds it to the system catalog. The caller must be an account admin or a
+        """Enables the system schema and adds it to the system catalog. The caller must be an account admin or a
         metastore admin.
 
         :param metastore_id: str
@@ -14853,9 +14118,7 @@ class SystemSchemasAPI:
     def list(
         self, metastore_id: str, *, max_results: Optional[int] = None, page_token: Optional[str] = None
     ) -> Iterator[SystemSchemaInfo]:
-        """List system schemas.
-
-        Gets an array of system schemas for a metastore. The caller must be an account admin or a metastore
+        """Gets an array of system schemas for a metastore. The caller must be an account admin or a metastore
         admin.
 
         :param metastore_id: str
@@ -14908,9 +14171,7 @@ class TableConstraintsAPI:
         self._api = api_client
 
     def create(self, full_name_arg: str, constraint: TableConstraint) -> TableConstraint:
-        """Create a table constraint.
-
-        Creates a new table constraint.
+        """Creates a new table constraint.
 
         For the table constraint creation to succeed, the user must satisfy both of these conditions: - the
         user must have the **USE_CATALOG** privilege on the table's parent catalog, the **USE_SCHEMA**
@@ -14941,9 +14202,7 @@ class TableConstraintsAPI:
         return TableConstraint.from_dict(res)
 
     def delete(self, full_name: str, constraint_name: str, cascade: bool):
-        """Delete a table constraint.
-
-        Deletes a table constraint.
+        """Deletes a table constraint.
 
         For the table constraint deletion to succeed, the user must satisfy both of these conditions: - the
         user must have the **USE_CATALOG** privilege on the table's parent catalog, the **USE_SCHEMA**
@@ -14989,9 +14248,7 @@ class TablesAPI:
         self._api = api_client
 
     def delete(self, full_name: str):
-        """Delete a table.
-
-        Deletes a table from the specified parent catalog and schema. The caller must be the owner of the
+        """Deletes a table from the specified parent catalog and schema. The caller must be the owner of the
         parent catalog, have the **USE_CATALOG** privilege on the parent catalog and be the owner of the
         parent schema, or be the owner of the table and have the **USE_CATALOG** privilege on the parent
         catalog and the **USE_SCHEMA** privilege on the parent schema.
@@ -15009,9 +14266,7 @@ class TablesAPI:
         self._api.do("DELETE", f"/api/2.1/unity-catalog/tables/{full_name}", headers=headers)
 
     def exists(self, full_name: str) -> TableExistsResponse:
-        """Get boolean reflecting if table exists.
-
-        Gets if a table exists in the metastore for a specific catalog and schema. The caller must satisfy one
+        """Gets if a table exists in the metastore for a specific catalog and schema. The caller must satisfy one
         of the following requirements: * Be a metastore admin * Be the owner of the parent catalog * Be the
         owner of the parent schema and have the USE_CATALOG privilege on the parent catalog * Have the
         **USE_CATALOG** privilege on the parent catalog and the **USE_SCHEMA** privilege on the parent schema,
@@ -15039,9 +14294,7 @@ class TablesAPI:
         include_delta_metadata: Optional[bool] = None,
         include_manifest_capabilities: Optional[bool] = None,
     ) -> TableInfo:
-        """Get a table.
-
-        Gets a table from the metastore for a specific catalog and schema. The caller must satisfy one of the
+        """Gets a table from the metastore for a specific catalog and schema. The caller must satisfy one of the
         following requirements: * Be a metastore admin * Be the owner of the parent catalog * Be the owner of
         the parent schema and have the USE_CATALOG privilege on the parent catalog * Have the **USE_CATALOG**
         privilege on the parent catalog and the **USE_SCHEMA** privilege on the parent schema, and either be
@@ -15088,9 +14341,7 @@ class TablesAPI:
         omit_username: Optional[bool] = None,
         page_token: Optional[str] = None,
     ) -> Iterator[TableInfo]:
-        """List tables.
-
-        Gets an array of all tables for the current metastore under the parent catalog and schema. The caller
+        """Gets an array of all tables for the current metastore under the parent catalog and schema. The caller
         must be a metastore admin or an owner of (or have the **SELECT** privilege on) the table. For the
         latter case, the caller must also be the owner or have the **USE_CATALOG** privilege on the parent
         catalog and the **USE_SCHEMA** privilege on the parent schema. There is no guarantee of a specific
@@ -15171,9 +14422,7 @@ class TablesAPI:
         schema_name_pattern: Optional[str] = None,
         table_name_pattern: Optional[str] = None,
     ) -> Iterator[TableSummary]:
-        """List table summaries.
-
-        Gets an array of summaries for tables for a schema and catalog within the metastore. The table
+        """Gets an array of summaries for tables for a schema and catalog within the metastore. The table
         summaries returned are either:
 
         * summaries for tables (within the current metastore and parent catalog and schema), when the user is
@@ -15233,9 +14482,7 @@ class TablesAPI:
             query["page_token"] = json["next_page_token"]
 
     def update(self, full_name: str, *, owner: Optional[str] = None):
-        """Update a table owner.
-
-        Change the owner of the table. The caller must be the owner of the parent catalog, have the
+        """Change the owner of the table. The caller must be the owner of the parent catalog, have the
         **USE_CATALOG** privilege on the parent catalog and be the owner of the parent schema, or be the owner
         of the table and have the **USE_CATALOG** privilege on the parent catalog and the **USE_SCHEMA**
         privilege on the parent schema.
@@ -15277,9 +14524,7 @@ class TemporaryTableCredentialsAPI:
     def generate_temporary_table_credentials(
         self, *, operation: Optional[TableOperation] = None, table_id: Optional[str] = None
     ) -> GenerateTemporaryTableCredentialResponse:
-        """Generate a temporary table credential.
-
-        Get a short-lived credential for directly accessing the table data on cloud storage. The metastore
+        """Get a short-lived credential for directly accessing the table data on cloud storage. The metastore
         must have external_access_enabled flag set to true (default false). The caller must have
         EXTERNAL_USE_SCHEMA privilege on the parent schema and this privilege can only be granted by catalog
         owners.
@@ -15327,9 +14572,7 @@ class VolumesAPI:
         comment: Optional[str] = None,
         storage_location: Optional[str] = None,
     ) -> VolumeInfo:
-        """Create a Volume.
-
-        Creates a new volume.
+        """Creates a new volume.
 
         The user could create either an external volume or a managed volume. An external volume will be
         created in the specified external location, while a managed volume will be located in the default
@@ -15386,9 +14629,7 @@ class VolumesAPI:
         return VolumeInfo.from_dict(res)
 
     def delete(self, name: str):
-        """Delete a Volume.
-
-        Deletes a volume from the specified parent catalog and schema.
+        """Deletes a volume from the specified parent catalog and schema.
 
         The caller must be a metastore admin or an owner of the volume. For the latter case, the caller must
         also be the owner or have the **USE_CATALOG** privilege on the parent catalog and the **USE_SCHEMA**
@@ -15413,9 +14654,7 @@ class VolumesAPI:
         max_results: Optional[int] = None,
         page_token: Optional[str] = None,
     ) -> Iterator[VolumeInfo]:
-        """List Volumes.
-
-        Gets an array of volumes for the current metastore under the parent catalog and schema.
+        """Gets an array of volumes for the current metastore under the parent catalog and schema.
 
         The returned volumes are filtered based on the privileges of the calling user. For example, the
         metastore admin is able to list all the volumes. A regular user needs to be the owner or have the
@@ -15476,9 +14715,7 @@ class VolumesAPI:
             query["page_token"] = json["next_page_token"]
 
     def read(self, name: str, *, include_browse: Optional[bool] = None) -> VolumeInfo:
-        """Get a Volume.
-
-        Gets a volume from the metastore for a specific catalog and schema.
+        """Gets a volume from the metastore for a specific catalog and schema.
 
         The caller must be a metastore admin or an owner of (or have the **READ VOLUME** privilege on) the
         volume. For the latter case, the caller must also be the owner or have the **USE_CATALOG** privilege
@@ -15506,9 +14743,7 @@ class VolumesAPI:
     def update(
         self, name: str, *, comment: Optional[str] = None, new_name: Optional[str] = None, owner: Optional[str] = None
     ) -> VolumeInfo:
-        """Update a Volume.
-
-        Updates the specified volume under the specified parent catalog and schema.
+        """Updates the specified volume under the specified parent catalog and schema.
 
         The caller must be a metastore admin or an owner of the volume. For the latter case, the caller must
         also be the owner or have the **USE_CATALOG** privilege on the parent catalog and the **USE_SCHEMA**
@@ -15563,9 +14798,7 @@ class WorkspaceBindingsAPI:
         self._api = api_client
 
     def get(self, name: str) -> GetCatalogWorkspaceBindingsResponse:
-        """Get catalog workspace bindings.
-
-        Gets workspace bindings of the catalog. The caller must be a metastore admin or an owner of the
+        """Gets workspace bindings of the catalog. The caller must be a metastore admin or an owner of the
         catalog.
 
         :param name: str
@@ -15589,9 +14822,7 @@ class WorkspaceBindingsAPI:
         max_results: Optional[int] = None,
         page_token: Optional[str] = None,
     ) -> Iterator[WorkspaceBinding]:
-        """Get securable workspace bindings.
-
-        Gets workspace bindings of the securable. The caller must be a metastore admin or an owner of the
+        """Gets workspace bindings of the securable. The caller must be a metastore admin or an owner of the
         securable.
 
         :param securable_type: str
@@ -15640,9 +14871,7 @@ class WorkspaceBindingsAPI:
         assign_workspaces: Optional[List[int]] = None,
         unassign_workspaces: Optional[List[int]] = None,
     ) -> UpdateCatalogWorkspaceBindingsResponse:
-        """Update catalog workspace bindings.
-
-        Updates workspace bindings of the catalog. The caller must be a metastore admin or an owner of the
+        """Updates workspace bindings of the catalog. The caller must be a metastore admin or an owner of the
         catalog.
 
         :param name: str
@@ -15677,9 +14906,7 @@ class WorkspaceBindingsAPI:
         add: Optional[List[WorkspaceBinding]] = None,
         remove: Optional[List[WorkspaceBinding]] = None,
     ) -> UpdateWorkspaceBindingsResponse:
-        """Update securable workspace bindings.
-
-        Updates workspace bindings of the securable. The caller must be a metastore admin or an owner of the
+        """Updates workspace bindings of the securable. The caller must be a metastore admin or an owner of the
         securable.
 
         :param securable_type: str