databricks-sdk 0.56.0__py3-none-any.whl → 0.58.0__py3-none-any.whl

databricks/sdk/service/provisioning.py

@@ -133,7 +133,6 @@ class CloudResourceContainer:
     """The general workspace configurations that are specific to cloud providers."""
 
     gcp: Optional[CustomerFacingGcpCloudResourceContainer] = None
-    """The general workspace configurations that are specific to Google Cloud."""
 
     def as_dict(self) -> dict:
         """Serializes the CloudResourceContainer into a dictionary suitable for use as a JSON request body."""
@@ -356,8 +355,6 @@ class CreateNetworkRequest:
     """The human-readable name of the network configuration."""
 
     gcp_network_info: Optional[GcpNetworkInfo] = None
-    """The Google Cloud specific information for this network (for example, the VPC ID, subnet ID, and
-    secondary IP ranges)."""
 
     security_group_ids: Optional[List[str]] = None
     """IDs of one to five security groups associated with this network. Security group IDs **cannot**
@@ -368,10 +365,6 @@ class CreateNetworkRequest:
     multiple network configurations."""
 
     vpc_endpoints: Optional[NetworkVpcEndpoints] = None
-    """If specified, contains the VPC endpoints used to allow cluster communication from this VPC over
-    [AWS PrivateLink].
-    
-    [AWS PrivateLink]: https://aws.amazon.com/privatelink/"""
 
     vpc_id: Optional[str] = None
     """The ID of the VPC associated with this network. VPC IDs can be used in multiple network
@@ -430,7 +423,6 @@ class CreateStorageConfigurationRequest:
     """The human-readable name of the storage configuration."""
 
     root_bucket_info: RootBucketInfo
-    """Root S3 bucket information."""
 
     def as_dict(self) -> dict:
         """Serializes the CreateStorageConfigurationRequest into a dictionary suitable for use as a JSON request body."""
@@ -468,7 +460,6 @@ class CreateVpcEndpointRequest:
     """The ID of the VPC endpoint object in AWS."""
 
     gcp_vpc_endpoint_info: Optional[GcpVpcEndpointInfo] = None
-    """The Google Cloud specific information for this Private Service Connect endpoint."""
 
     region: Optional[str] = None
     """The AWS region in which this VPC endpoint object exists."""
@@ -523,7 +514,6 @@ class CreateWorkspaceRequest:
     to `gcp`."""
 
     cloud_resource_container: Optional[CloudResourceContainer] = None
-    """The general workspace configurations that are specific to cloud providers."""
 
     credentials_id: Optional[str] = None
     """ID of the workspace's credential configuration object."""
@@ -559,27 +549,8 @@ class CreateWorkspaceRequest:
     with the pattern `dbc-xxxxxxxx-xxxx`."""
 
     gcp_managed_network_config: Optional[GcpManagedNetworkConfig] = None
-    """The network settings for the workspace. The configurations are only for Databricks-managed VPCs.
-    It is ignored if you specify a customer-managed VPC in the `network_id` field.", All the IP
-    range configurations must be mutually exclusive. An attempt to create a workspace fails if
-    Databricks detects an IP range overlap.
-    
-    Specify custom IP ranges in CIDR format. The IP ranges for these fields must not overlap, and
-    all IP addresses must be entirely within the following ranges: `10.0.0.0/8`, `100.64.0.0/10`,
-    `172.16.0.0/12`, `192.168.0.0/16`, and `240.0.0.0/4`.
-    
-    The sizes of these IP ranges affect the maximum number of nodes for the workspace.
-    
-    **Important**: Confirm the IP ranges used by your Databricks workspace before creating the
-    workspace. You cannot change them after your workspace is deployed. If the IP address ranges for
-    your Databricks are too small, IP exhaustion can occur, causing your Databricks jobs to fail. To
-    determine the address range sizes that you need, Databricks provides a calculator as a Microsoft
-    Excel spreadsheet. See [calculate subnet sizes for a new workspace].
-    
-    [calculate subnet sizes for a new workspace]: https://docs.gcp.databricks.com/administration-guide/cloud-configurations/gcp/network-sizing.html"""
 
     gke_config: Optional[GkeConfig] = None
-    """The configurations for the GKE cluster of a Databricks workspace."""
 
     is_no_public_ip_enabled: Optional[bool] = None
     """Whether no public IP is enabled for the workspace."""
@@ -597,9 +568,6 @@ class CreateWorkspaceRequest:
     network_id: Optional[str] = None
 
     pricing_tier: Optional[PricingTier] = None
-    """The pricing tier of the workspace. For pricing tier information, see [AWS Pricing].
-    
-    [AWS Pricing]: https://databricks.com/product/aws-pricing"""
 
     private_access_settings_id: Optional[str] = None
     """ID of the workspace's private access settings object. Only used for PrivateLink. This ID must be
@@ -1259,8 +1227,6 @@ class Network:
     """Array of error messages about the network configuration."""
 
     gcp_network_info: Optional[GcpNetworkInfo] = None
-    """The Google Cloud specific information for this network (for example, the VPC ID, subnet ID, and
-    secondary IP ranges)."""
 
     network_id: Optional[str] = None
     """The Databricks network configuration ID."""
@@ -1273,18 +1239,12 @@ class Network:
     subnet_ids: Optional[List[str]] = None
 
     vpc_endpoints: Optional[NetworkVpcEndpoints] = None
-    """If specified, contains the VPC endpoints used to allow cluster communication from this VPC over
-    [AWS PrivateLink].
-    
-    [AWS PrivateLink]: https://aws.amazon.com/privatelink/"""
 
     vpc_id: Optional[str] = None
     """The ID of the VPC associated with this network configuration. VPC IDs can be used in multiple
     networks."""
 
     vpc_status: Optional[VpcStatus] = None
-    """The status of this network configuration object in terms of its use in a workspace: *
-    `UNATTACHED`: Unattached. * `VALID`: Valid. * `BROKEN`: Broken. * `WARNED`: Warned."""
 
     warning_messages: Optional[List[NetworkWarning]] = None
     """Array of warning messages about the network configuration."""
@@ -1380,8 +1340,6 @@ class NetworkHealth:
     """Details of the error."""
 
     error_type: Optional[ErrorType] = None
-    """The AWS resource associated with this error: credentials, VPC, subnet, security group, or
-    network ACL."""
 
     def as_dict(self) -> dict:
         """Serializes the NetworkHealth into a dictionary suitable for use as a JSON request body."""
@@ -1451,7 +1409,6 @@ class NetworkWarning:
     """Details of the warning."""
 
     warning_type: Optional[WarningType] = None
-    """The AWS resource associated with this warning: a subnet or a security group."""
 
     def as_dict(self) -> dict:
         """Serializes the NetworkWarning into a dictionary suitable for use as a JSON request body."""
@@ -1510,11 +1467,6 @@ class PrivateAccessSettings:
     """An array of Databricks VPC endpoint IDs."""
 
     private_access_level: Optional[PrivateAccessLevel] = None
-    """The private access level controls which VPC endpoints can connect to the UI or API of any
-    workspace that attaches this private access settings object. * `ACCOUNT` level access (the
-    default) allows only VPC endpoints that are registered in your Databricks account connect to
-    your workspace. * `ENDPOINT` level access allows only specified VPC endpoints connect to your
-    workspace. For details, see `allowed_vpc_endpoint_ids`."""
 
     private_access_settings_id: Optional[str] = None
     """Databricks private access settings ID."""
@@ -1637,7 +1589,6 @@ class StorageConfiguration:
     """Time in epoch milliseconds when the storage configuration was created."""
 
     root_bucket_info: Optional[RootBucketInfo] = None
-    """Root S3 bucket information."""
 
     storage_configuration_id: Optional[str] = None
     """Databricks storage configuration ID."""
@@ -1869,11 +1820,6 @@ class UpsertPrivateAccessSettingsRequest:
     [IP access lists]: https://docs.databricks.com/security/network/ip-access-list.html"""
 
     private_access_level: Optional[PrivateAccessLevel] = None
-    """The private access level controls which VPC endpoints can connect to the UI or API of any
-    workspace that attaches this private access settings object. * `ACCOUNT` level access (the
-    default) allows only VPC endpoints that are registered in your Databricks account connect to
-    your workspace. * `ENDPOINT` level access allows only specified VPC endpoints connect to your
-    workspace. For details, see `allowed_vpc_endpoint_ids`."""
 
     private_access_settings_id: Optional[str] = None
     """Databricks Account API private access settings ID."""
@@ -1951,7 +1897,6 @@ class VpcEndpoint:
     """The ID of the VPC endpoint object in AWS."""
 
     gcp_vpc_endpoint_info: Optional[GcpVpcEndpointInfo] = None
-    """The Google Cloud specific information for this Private Service Connect endpoint."""
 
     region: Optional[str] = None
     """The AWS region in which this VPC endpoint object exists."""
@@ -1963,10 +1908,6 @@ class VpcEndpoint:
     [AWS DescribeVpcEndpoint documentation]: https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-vpc-endpoints.html"""
 
     use_case: Optional[EndpointUseCase] = None
-    """This enumeration represents the type of Databricks VPC [endpoint service] that was used when
-    creating this VPC endpoint.
-    
-    [endpoint service]: https://docs.aws.amazon.com/vpc/latest/privatelink/endpoint-service.html"""
 
     vpc_endpoint_id: Optional[str] = None
     """Databricks VPC endpoint ID. This is the Databricks-specific name of the VPC endpoint. Do not
@@ -2073,7 +2014,6 @@ class Workspace:
     """The cloud name. This field always has the value `gcp`."""
 
     cloud_resource_container: Optional[CloudResourceContainer] = None
-    """The general workspace configurations that are specific to cloud providers."""
 
     creation_time: Optional[int] = None
     """Time in epoch milliseconds when the workspace was created."""
@@ -2097,27 +2037,8 @@ class Workspace:
     workspace is not for a external customer, then external_customer_info is empty."""
 
     gcp_managed_network_config: Optional[GcpManagedNetworkConfig] = None
-    """The network settings for the workspace. The configurations are only for Databricks-managed VPCs.
-    It is ignored if you specify a customer-managed VPC in the `network_id` field.", All the IP
-    range configurations must be mutually exclusive. An attempt to create a workspace fails if
-    Databricks detects an IP range overlap.
-    
-    Specify custom IP ranges in CIDR format. The IP ranges for these fields must not overlap, and
-    all IP addresses must be entirely within the following ranges: `10.0.0.0/8`, `100.64.0.0/10`,
-    `172.16.0.0/12`, `192.168.0.0/16`, and `240.0.0.0/4`.
-    
-    The sizes of these IP ranges affect the maximum number of nodes for the workspace.
-    
-    **Important**: Confirm the IP ranges used by your Databricks workspace before creating the
-    workspace. You cannot change them after your workspace is deployed. If the IP address ranges for
-    your Databricks are too small, IP exhaustion can occur, causing your Databricks jobs to fail. To
-    determine the address range sizes that you need, Databricks provides a calculator as a Microsoft
-    Excel spreadsheet. See [calculate subnet sizes for a new workspace].
-    
-    [calculate subnet sizes for a new workspace]: https://docs.gcp.databricks.com/administration-guide/cloud-configurations/gcp/network-sizing.html"""
 
     gke_config: Optional[GkeConfig] = None
-    """The configurations for the GKE cluster of a Databricks workspace."""
 
     is_no_public_ip_enabled: Optional[bool] = None
     """Whether no public IP is enabled for the workspace."""
@@ -2134,9 +2055,6 @@ class Workspace:
     the network is a customer-managed network."""
 
     pricing_tier: Optional[PricingTier] = None
-    """The pricing tier of the workspace. For pricing tier information, see [AWS Pricing].
-    
-    [AWS Pricing]: https://databricks.com/product/aws-pricing"""
 
     private_access_settings_id: Optional[str] = None
     """ID of the workspace's private access settings object. Only used for PrivateLink. You must
@@ -2161,8 +2079,6 @@ class Workspace:
     """The human-readable name of the workspace."""
 
     workspace_status: Optional[WorkspaceStatus] = None
-    """The status of the workspace. For workspace creation, usually it is set to `PROVISIONING`
-    initially. Continue to check the status until the status is `RUNNING`."""
 
     workspace_status_message: Optional[str] = None
     """Message describing the current workspace status."""
@@ -2326,9 +2242,7 @@ class CredentialsAPI:
         self._api = api_client
 
     def create(self, credentials_name: str, aws_credentials: CreateCredentialAwsCredentials) -> Credential:
-        """Create credential configuration.
-
-        Creates a Databricks credential configuration that represents cloud cross-account credentials for a
+        """Creates a Databricks credential configuration that represents cloud cross-account credentials for a
         specified account. Databricks uses this to set up network infrastructure properly to host Databricks
         clusters. For your AWS IAM role, you need to trust the External ID (the Databricks Account API account
         ID) in the returned credential object, and configure the required access policy.
@@ -2361,9 +2275,7 @@ class CredentialsAPI:
         return Credential.from_dict(res)
 
     def delete(self, credentials_id: str):
-        """Delete credential configuration.
-
-        Deletes a Databricks credential configuration object for an account, both specified by ID. You cannot
+        """Deletes a Databricks credential configuration object for an account, both specified by ID. You cannot
         delete a credential that is associated with any workspace.
 
         :param credentials_id: str
@@ -2381,9 +2293,7 @@ class CredentialsAPI:
         )
 
     def get(self, credentials_id: str) -> Credential:
-        """Get credential configuration.
-
-        Gets a Databricks credential configuration object for an account, both specified by ID.
+        """Gets a Databricks credential configuration object for an account, both specified by ID.
 
         :param credentials_id: str
           Databricks Account API credential configuration ID
@@ -2401,9 +2311,8 @@ class CredentialsAPI:
         return Credential.from_dict(res)
 
     def list(self) -> Iterator[Credential]:
-        """Get all credential configurations.
+        """Gets all Databricks credential configurations associated with an account specified by ID.
 
-        Gets all Databricks credential configurations associated with an account specified by ID.
 
         :returns: Iterator over :class:`Credential`
         """
@@ -2441,9 +2350,7 @@ class EncryptionKeysAPI:
         aws_key_info: Optional[CreateAwsKeyInfo] = None,
         gcp_key_info: Optional[CreateGcpKeyInfo] = None,
     ) -> CustomerManagedKey:
-        """Create encryption key configuration.
-
-        Creates a customer-managed key configuration object for an account, specified by ID. This operation
+        """Creates a customer-managed key configuration object for an account, specified by ID. This operation
         uploads a reference to a customer-managed key to Databricks. If the key is assigned as a workspace's
         customer-managed key for managed services, Databricks uses the key to encrypt the workspaces notebooks
         and secrets in the control plane, in addition to Databricks SQL queries and query history. If it is
@@ -2482,9 +2389,7 @@ class EncryptionKeysAPI:
         return CustomerManagedKey.from_dict(res)
 
     def delete(self, customer_managed_key_id: str):
-        """Delete encryption key configuration.
-
-        Deletes a customer-managed key configuration object for an account. You cannot delete a configuration
+        """Deletes a customer-managed key configuration object for an account. You cannot delete a configuration
         that is associated with a running workspace.
 
         :param customer_managed_key_id: str
@@ -2504,9 +2409,7 @@ class EncryptionKeysAPI:
         )
 
     def get(self, customer_managed_key_id: str) -> CustomerManagedKey:
-        """Get encryption key configuration.
-
-        Gets a customer-managed key configuration object for an account, specified by ID. This operation
+        """Gets a customer-managed key configuration object for an account, specified by ID. This operation
         uploads a reference to a customer-managed key to Databricks. If assigned as a workspace's
         customer-managed key for managed services, Databricks uses the key to encrypt the workspaces notebooks
         and secrets in the control plane, in addition to Databricks SQL queries and query history. If it is
@@ -2537,9 +2440,7 @@ class EncryptionKeysAPI:
         return CustomerManagedKey.from_dict(res)
 
     def list(self) -> Iterator[CustomerManagedKey]:
-        """Get all encryption key configurations.
-
-        Gets all customer-managed key configuration objects for an account. If the key is specified as a
+        """Gets all customer-managed key configuration objects for an account. If the key is specified as a
         workspace's managed services customer-managed key, Databricks uses the key to encrypt the workspace's
         notebooks and secrets in the control plane, in addition to Databricks SQL queries and query history.
         If the key is specified as a workspace's storage customer-managed key, the key is used to encrypt the
@@ -2550,6 +2451,7 @@ class EncryptionKeysAPI:
 
         This operation is available only if your account is on the E2 version of the platform.
 
+
         :returns: Iterator over :class:`CustomerManagedKey`
         """
 
@@ -2578,16 +2480,12 @@ class NetworksAPI:
         vpc_endpoints: Optional[NetworkVpcEndpoints] = None,
         vpc_id: Optional[str] = None,
     ) -> Network:
-        """Create network configuration.
-
-        Creates a Databricks network configuration that represents an VPC and its resources. The VPC will be
+        """Creates a Databricks network configuration that represents an VPC and its resources. The VPC will be
         used for new Databricks clusters. This requires a pre-existing VPC and subnets.
 
         :param network_name: str
           The human-readable name of the network configuration.
         :param gcp_network_info: :class:`GcpNetworkInfo` (optional)
-          The Google Cloud specific information for this network (for example, the VPC ID, subnet ID, and
-          secondary IP ranges).
         :param security_group_ids: List[str] (optional)
           IDs of one to five security groups associated with this network. Security group IDs **cannot** be
           used in multiple network configurations.
@@ -2595,10 +2493,6 @@ class NetworksAPI:
           IDs of at least two subnets associated with this network. Subnet IDs **cannot** be used in multiple
           network configurations.
         :param vpc_endpoints: :class:`NetworkVpcEndpoints` (optional)
-          If specified, contains the VPC endpoints used to allow cluster communication from this VPC over [AWS
-          PrivateLink].
-
-          [AWS PrivateLink]: https://aws.amazon.com/privatelink/
         :param vpc_id: str (optional)
           The ID of the VPC associated with this network. VPC IDs can be used in multiple network
           configurations.
@@ -2627,9 +2521,7 @@ class NetworksAPI:
         return Network.from_dict(res)
 
     def delete(self, network_id: str):
-        """Delete a network configuration.
-
-        Deletes a Databricks network configuration, which represents a cloud VPC and its resources. You cannot
+        """Deletes a Databricks network configuration, which represents a cloud VPC and its resources. You cannot
         delete a network that is associated with a workspace.
 
         This operation is available only if your account is on the E2 version of the platform.
@@ -2647,9 +2539,7 @@ class NetworksAPI:
         self._api.do("DELETE", f"/api/2.0/accounts/{self._api.account_id}/networks/{network_id}", headers=headers)
 
     def get(self, network_id: str) -> Network:
-        """Get a network configuration.
-
-        Gets a Databricks network configuration, which represents a cloud VPC and its resources.
+        """Gets a Databricks network configuration, which represents a cloud VPC and its resources.
 
         :param network_id: str
           Databricks Account API network configuration ID.
@@ -2665,12 +2555,11 @@ class NetworksAPI:
         return Network.from_dict(res)
 
     def list(self) -> Iterator[Network]:
-        """Get all network configurations.
-
-        Gets a list of all Databricks network configurations for an account, specified by ID.
+        """Gets a list of all Databricks network configurations for an account, specified by ID.
 
         This operation is available only if your account is on the E2 version of the platform.
 
+
         :returns: Iterator over :class:`Network`
         """
 
@@ -2697,9 +2586,7 @@ class PrivateAccessAPI:
         private_access_level: Optional[PrivateAccessLevel] = None,
         public_access_enabled: Optional[bool] = None,
     ) -> PrivateAccessSettings:
-        """Create private access settings.
-
-        Creates a private access settings object, which specifies how your workspace is accessed over [AWS
+        """Creates a private access settings object, which specifies how your workspace is accessed over [AWS
         PrivateLink]. To use AWS PrivateLink, a workspace must have a private access settings object
         referenced by ID in the workspace's `private_access_settings_id` property.
 
@@ -2730,11 +2617,6 @@ class PrivateAccessAPI:
 
           [IP access lists]: https://docs.databricks.com/security/network/ip-access-list.html
         :param private_access_level: :class:`PrivateAccessLevel` (optional)
-          The private access level controls which VPC endpoints can connect to the UI or API of any workspace
-          that attaches this private access settings object. * `ACCOUNT` level access (the default) allows
-          only VPC endpoints that are registered in your Databricks account connect to your workspace. *
-          `ENDPOINT` level access allows only specified VPC endpoints connect to your workspace. For details,
-          see `allowed_vpc_endpoint_ids`.
         :param public_access_enabled: bool (optional)
           Determines if the workspace can be accessed over public internet. For fully private workspaces, you
           can optionally specify `false`, but only if you implement both the front-end and the back-end
@@ -2764,9 +2646,7 @@ class PrivateAccessAPI:
         return PrivateAccessSettings.from_dict(res)
 
     def delete(self, private_access_settings_id: str):
-        """Delete a private access settings object.
-
-        Deletes a private access settings object, which determines how your workspace is accessed over [AWS
+        """Deletes a private access settings object, which determines how your workspace is accessed over [AWS
         PrivateLink].
 
         Before configuring PrivateLink, read the [Databricks article about PrivateLink].",
@@ -2791,9 +2671,7 @@ class PrivateAccessAPI:
         )
 
     def get(self, private_access_settings_id: str) -> PrivateAccessSettings:
-        """Get a private access settings object.
-
-        Gets a private access settings object, which specifies how your workspace is accessed over [AWS
+        """Gets a private access settings object, which specifies how your workspace is accessed over [AWS
         PrivateLink].
 
         Before configuring PrivateLink, read the [Databricks article about PrivateLink].",
@@ -2819,9 +2697,8 @@ class PrivateAccessAPI:
         return PrivateAccessSettings.from_dict(res)
 
     def list(self) -> Iterator[PrivateAccessSettings]:
-        """Get all private access settings objects.
+        """Gets a list of all private access settings objects for an account, specified by ID.
 
-        Gets a list of all private access settings objects for an account, specified by ID.
 
         :returns: Iterator over :class:`PrivateAccessSettings`
         """
@@ -2843,9 +2720,7 @@ class PrivateAccessAPI:
         private_access_level: Optional[PrivateAccessLevel] = None,
         public_access_enabled: Optional[bool] = None,
     ):
-        """Replace private access settings.
-
-        Updates an existing private access settings object, which specifies how your workspace is accessed
+        """Updates an existing private access settings object, which specifies how your workspace is accessed
         over [AWS PrivateLink]. To use AWS PrivateLink, a workspace must have a private access settings object
         referenced by ID in the workspace's `private_access_settings_id` property.
 
@@ -2883,11 +2758,6 @@ class PrivateAccessAPI:
 
           [IP access lists]: https://docs.databricks.com/security/network/ip-access-list.html
         :param private_access_level: :class:`PrivateAccessLevel` (optional)
-          The private access level controls which VPC endpoints can connect to the UI or API of any workspace
-          that attaches this private access settings object. * `ACCOUNT` level access (the default) allows
-          only VPC endpoints that are registered in your Databricks account connect to your workspace. *
-          `ENDPOINT` level access allows only specified VPC endpoints connect to your workspace. For details,
-          see `allowed_vpc_endpoint_ids`.
         :param public_access_enabled: bool (optional)
           Determines if the workspace can be accessed over public internet. For fully private workspaces, you
           can optionally specify `false`, but only if you implement both the front-end and the back-end
@@ -2929,9 +2799,7 @@ class StorageAPI:
         self._api = api_client
 
     def create(self, storage_configuration_name: str, root_bucket_info: RootBucketInfo) -> StorageConfiguration:
-        """Create new storage configuration.
-
-        Creates new storage configuration for an account, specified by ID. Uploads a storage configuration
+        """Creates new storage configuration for an account, specified by ID. Uploads a storage configuration
         object that represents the root AWS S3 bucket in your account. Databricks stores related workspace
         assets including DBFS, cluster logs, and job results. For the AWS S3 bucket, you need to configure the
         required bucket policy.
@@ -2944,7 +2812,6 @@ class StorageAPI:
         :param storage_configuration_name: str
           The human-readable name of the storage configuration.
         :param root_bucket_info: :class:`RootBucketInfo`
-          Root S3 bucket information.
 
         :returns: :class:`StorageConfiguration`
         """
@@ -2964,9 +2831,7 @@ class StorageAPI:
         return StorageConfiguration.from_dict(res)
 
     def delete(self, storage_configuration_id: str):
-        """Delete storage configuration.
-
-        Deletes a Databricks storage configuration. You cannot delete a storage configuration that is
+        """Deletes a Databricks storage configuration. You cannot delete a storage configuration that is
         associated with any workspace.
 
         :param storage_configuration_id: str
@@ -2986,9 +2851,7 @@ class StorageAPI:
         )
 
     def get(self, storage_configuration_id: str) -> StorageConfiguration:
-        """Get storage configuration.
-
-        Gets a Databricks storage configuration for an account, both specified by ID.
+        """Gets a Databricks storage configuration for an account, both specified by ID.
 
         :param storage_configuration_id: str
           Databricks Account API storage configuration ID.
@@ -3008,9 +2871,8 @@ class StorageAPI:
         return StorageConfiguration.from_dict(res)
 
     def list(self) -> Iterator[StorageConfiguration]:
-        """Get all storage configurations.
+        """Gets a list of all Databricks storage configurations for your account, specified by ID.
 
-        Gets a list of all Databricks storage configurations for your account, specified by ID.
 
         :returns: Iterator over :class:`StorageConfiguration`
         """
@@ -3037,9 +2899,7 @@ class VpcEndpointsAPI:
         gcp_vpc_endpoint_info: Optional[GcpVpcEndpointInfo] = None,
         region: Optional[str] = None,
     ) -> VpcEndpoint:
-        """Create VPC endpoint configuration.
-
-        Creates a VPC endpoint configuration, which represents a [VPC endpoint] object in AWS used to
+        """Creates a VPC endpoint configuration, which represents a [VPC endpoint] object in AWS used to
         communicate privately with Databricks over [AWS PrivateLink].
 
         After you create the VPC endpoint configuration, the Databricks [endpoint service] automatically
@@ -3057,7 +2917,6 @@ class VpcEndpointsAPI:
         :param aws_vpc_endpoint_id: str (optional)
           The ID of the VPC endpoint object in AWS.
         :param gcp_vpc_endpoint_info: :class:`GcpVpcEndpointInfo` (optional)
-          The Google Cloud specific information for this Private Service Connect endpoint.
         :param region: str (optional)
           The AWS region in which this VPC endpoint object exists.
 
@@ -3083,9 +2942,7 @@ class VpcEndpointsAPI:
         return VpcEndpoint.from_dict(res)
 
     def delete(self, vpc_endpoint_id: str):
-        """Delete VPC endpoint configuration.
-
-        Deletes a VPC endpoint configuration, which represents an [AWS VPC endpoint] that can communicate
+        """Deletes a VPC endpoint configuration, which represents an [AWS VPC endpoint] that can communicate
         privately with Databricks over [AWS PrivateLink].
 
         Before configuring PrivateLink, read the [Databricks article about PrivateLink].
@@ -3109,9 +2966,7 @@ class VpcEndpointsAPI:
         )
 
     def get(self, vpc_endpoint_id: str) -> VpcEndpoint:
-        """Get a VPC endpoint configuration.
-
-        Gets a VPC endpoint configuration, which represents a [VPC endpoint] object in AWS used to communicate
+        """Gets a VPC endpoint configuration, which represents a [VPC endpoint] object in AWS used to communicate
         privately with Databricks over [AWS PrivateLink].
 
         [AWS PrivateLink]: https://aws.amazon.com/privatelink
@@ -3133,14 +2988,13 @@ class VpcEndpointsAPI:
         return VpcEndpoint.from_dict(res)
 
     def list(self) -> Iterator[VpcEndpoint]:
-        """Get all VPC endpoint configurations.
-
-        Gets a list of all VPC endpoints for an account, specified by ID.
+        """Gets a list of all VPC endpoints for an account, specified by ID.
 
         Before configuring PrivateLink, read the [Databricks article about PrivateLink].
 
         [Databricks article about PrivateLink]: https://docs.databricks.com/administration-guide/cloud-configurations/aws/privatelink.html
 
+
         :returns: Iterator over :class:`VpcEndpoint`
         """
 
@@ -3216,9 +3070,7 @@ class WorkspacesAPI:
         storage_configuration_id: Optional[str] = None,
         storage_customer_managed_key_id: Optional[str] = None,
     ) -> Wait[Workspace]:
-        """Create a new workspace.
-
-        Creates a new workspace.
+        """Creates a new workspace.
 
         **Important**: This operation is asynchronous. A response with HTTP status code 200 means the request
         has been accepted and is in progress, but does not mean that the workspace deployed successfully and
@@ -3235,7 +3087,6 @@ class WorkspacesAPI:
           The cloud provider which the workspace uses. For Google Cloud workspaces, always set this field to
           `gcp`.
         :param cloud_resource_container: :class:`CloudResourceContainer` (optional)
-          The general workspace configurations that are specific to cloud providers.
         :param credentials_id: str (optional)
           ID of the workspace's credential configuration object.
         :param custom_tags: Dict[str,str] (optional)
@@ -3267,26 +3118,7 @@ class WorkspacesAPI:
           If a new workspace omits this property, the server generates a unique deployment name for you with
           the pattern `dbc-xxxxxxxx-xxxx`.
         :param gcp_managed_network_config: :class:`GcpManagedNetworkConfig` (optional)
-          The network settings for the workspace. The configurations are only for Databricks-managed VPCs. It
-          is ignored if you specify a customer-managed VPC in the `network_id` field.", All the IP range
-          configurations must be mutually exclusive. An attempt to create a workspace fails if Databricks
-          detects an IP range overlap.
-
-          Specify custom IP ranges in CIDR format. The IP ranges for these fields must not overlap, and all IP
-          addresses must be entirely within the following ranges: `10.0.0.0/8`, `100.64.0.0/10`,
-          `172.16.0.0/12`, `192.168.0.0/16`, and `240.0.0.0/4`.
-
-          The sizes of these IP ranges affect the maximum number of nodes for the workspace.
-
-          **Important**: Confirm the IP ranges used by your Databricks workspace before creating the
-          workspace. You cannot change them after your workspace is deployed. If the IP address ranges for
-          your Databricks are too small, IP exhaustion can occur, causing your Databricks jobs to fail. To
-          determine the address range sizes that you need, Databricks provides a calculator as a Microsoft
-          Excel spreadsheet. See [calculate subnet sizes for a new workspace].
-
-          [calculate subnet sizes for a new workspace]: https://docs.gcp.databricks.com/administration-guide/cloud-configurations/gcp/network-sizing.html
         :param gke_config: :class:`GkeConfig` (optional)
-          The configurations for the GKE cluster of a Databricks workspace.
         :param is_no_public_ip_enabled: bool (optional)
           Whether no public IP is enabled for the workspace.
         :param location: str (optional)
@@ -3297,9 +3129,6 @@ class WorkspacesAPI:
           history. The provided key configuration object property `use_cases` must contain `MANAGED_SERVICES`.
         :param network_id: str (optional)
         :param pricing_tier: :class:`PricingTier` (optional)
-          The pricing tier of the workspace. For pricing tier information, see [AWS Pricing].
-
-          [AWS Pricing]: https://databricks.com/product/aws-pricing
         :param private_access_settings_id: str (optional)
           ID of the workspace's private access settings object. Only used for PrivateLink. This ID must be
           specified for customers using [AWS PrivateLink] for either front-end (user-to-workspace connection),
@@ -3412,9 +3241,7 @@ class WorkspacesAPI:
         ).result(timeout=timeout)
 
     def delete(self, workspace_id: int):
-        """Delete a workspace.
-
-        Terminates and deletes a Databricks workspace. From an API perspective, deletion is immediate.
+        """Terminates and deletes a Databricks workspace. From an API perspective, deletion is immediate.
         However, it might take a few minutes for all workspaces resources to be deleted, depending on the size
         and number of workspace resources.
 
@@ -3434,9 +3261,7 @@ class WorkspacesAPI:
         self._api.do("DELETE", f"/api/2.0/accounts/{self._api.account_id}/workspaces/{workspace_id}", headers=headers)
 
     def get(self, workspace_id: int) -> Workspace:
-        """Get a workspace.
-
-        Gets information including status for a Databricks workspace, specified by ID. In the response, the
+        """Gets information including status for a Databricks workspace, specified by ID. In the response, the
         `workspace_status` field indicates the current status. After initial workspace creation (which is
         asynchronous), make repeated `GET` requests with the workspace ID and check its status. The workspace
         becomes available when the status changes to `RUNNING`.
@@ -3465,13 +3290,12 @@ class WorkspacesAPI:
         return Workspace.from_dict(res)
 
     def list(self) -> Iterator[Workspace]:
-        """Get all workspaces.
-
-        Gets a list of all workspaces associated with an account, specified by ID.
+        """Gets a list of all workspaces associated with an account, specified by ID.
 
         This operation is available only if your account is on the E2 version of the platform or on a select
         custom plan that allows multiple workspaces per account.
 
+
         :returns: Iterator over :class:`Workspace`
         """
 
@@ -3496,9 +3320,7 @@ class WorkspacesAPI:
         storage_configuration_id: Optional[str] = None,
         storage_customer_managed_key_id: Optional[str] = None,
     ) -> Wait[Workspace]:
-        """Update workspace configuration.
-
-        Updates a workspace configuration for either a running workspace or a failed workspace. The elements
+        """Updates a workspace configuration for either a running workspace or a failed workspace. The elements
         that can be updated varies between these two use cases.
 
         ### Update a failed workspace You can update a Databricks workspace configuration for failed workspace