azure-storage-blob 12.26.0__py3-none-any.whl → 12.27.0__py3-none-any.whl

azure/storage/blob/_blob_service_client.py

@@ -131,7 +131,23 @@ class BlobServiceClient(StorageAccountHostsMixin, StorageEncryptionMixin):
         self._client._config.version = get_api_version(kwargs)  # type: ignore [assignment]
         self._configure_encryption(kwargs)
 
-    def _format_url(self, hostname):
+    def __enter__(self) -> Self:
+        self._client.__enter__()
+        return self
+
+    def __exit__(self, *args) -> None:
+        self._client.__exit__(*args)
+
+    def close(self) -> None:
+        """This method is to close the sockets opened by the client.
+        It need not be used when using with a context manager.
+
+        :return: None
+        :rtype: None
+        """
+        self._client.close()
+
+    def _format_url(self, hostname: str) -> str:
         """Format the endpoint URL according to the current location
         mode hostname.
 
@@ -166,6 +182,27 @@ class BlobServiceClient(StorageAccountHostsMixin, StorageEncryptionMixin):
             ~azure.core.credentials.AzureSasCredential or
             ~azure.core.credentials.TokenCredential or
             str or dict[str, str] or None
+        :keyword str api_version:
+            The Storage API version to use for requests. Default value is the most recent service version that is
+            compatible with the current SDK. Setting to an older version may result in reduced feature compatibility.
+
+            .. versionadded:: 12.2.0
+
+        :keyword str secondary_hostname:
+            The hostname of the secondary endpoint.
+        :keyword int max_block_size: The maximum chunk size for uploading a block blob in chunks.
+            Defaults to 4*1024*1024, or 4MB.
+        :keyword int max_single_put_size: If the blob size is less than or equal max_single_put_size, then the blob will
+            be uploaded with only one http PUT request. If the blob size is larger than max_single_put_size,
+            the blob will be uploaded in chunks. Defaults to 64*1024*1024, or 64MB.
+        :keyword int min_large_block_upload_threshold: The minimum chunk size required to use the memory efficient
+            algorithm when uploading a block blob. Defaults to 4*1024*1024+1.
+        :keyword bool use_byte_buffer: Use a byte buffer for block blob uploads. Defaults to False.
+        :keyword int max_page_size: The maximum chunk size for uploading a page blob. Defaults to 4*1024*1024, or 4MB.
+        :keyword int max_single_get_size: The maximum size for a blob to be downloaded in a single call,
+            the exceeded part will be downloaded in chunks (could be parallel). Defaults to 32*1024*1024, or 32MB.
+        :keyword int max_chunk_get_size: The maximum chunk size used for downloading a blob. Defaults to 4*1024*1024,
+            or 4MB.
         :keyword str audience: The audience to use when requesting tokens for Azure Active Directory
             authentication. Only has an effect when credential is of type TokenCredential. The value could be
             https://storage.azure.com/ (default) or https://<account>.blob.core.windows.net.
@@ -228,7 +265,7 @@ class BlobServiceClient(StorageAccountHostsMixin, StorageEncryptionMixin):
         The keys in the returned dictionary include 'sku_name' and 'account_kind'.
 
         :return: A dict of account information (SKU and account type).
-        :rtype: dict(str, str)
+        :rtype: Dict[str, str]
 
         .. admonition:: Example:
 
@@ -522,7 +559,7 @@ class BlobServiceClient(StorageAccountHostsMixin, StorageEncryptionMixin):
         :param metadata:
             A dict with name-value pairs to associate with the
             container as metadata. Example: `{'Category':'test'}`
-        :type metadata: dict(str, str)
+        :type metadata: Dict[str, str]
         :param public_access:
             Possible values include: 'container', 'blob'.
         :type public_access: str or ~azure.storage.blob.PublicAccess
@@ -750,7 +787,7 @@ class BlobServiceClient(StorageAccountHostsMixin, StorageEncryptionMixin):
         :param snapshot:
             The optional blob snapshot on which to operate. This can either be the ID of the snapshot,
             or a dictionary output returned by :func:`~azure.storage.blob.BlobClient.create_snapshot()`.
-        :type snapshot: str or dict(str, Any)
+        :type snapshot: str or Dict[str, Any]
         :keyword str version_id: The version id parameter is an opaque DateTime value that, when present,
             specifies the version of the blob to operate on.
         :return: A BlobClient.

azure/storage/blob/_blob_service_client.pyi

@@ -0,0 +1,182 @@
+# -------------------------------------------------------------------------
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License. See License.txt in the project root for
+# license information.
+# --------------------------------------------------------------------------
+# pylint: skip-file
+
+from datetime import datetime
+from types import TracebackType
+from typing import (
+    Any,
+    Dict,
+    List,
+    Optional,
+    Union,
+)
+from typing_extensions import Self
+
+from azure.core import MatchConditions
+from azure.core.credentials import AzureNamedKeyCredential, AzureSasCredential, TokenCredential
+from azure.core.paging import ItemPaged
+from azure.core.tracing.decorator import distributed_trace
+from ._blob_client import BlobClient
+from ._container_client import ContainerClient
+from ._encryption import StorageEncryptionMixin
+from ._lease import BlobLeaseClient
+from ._models import (
+    BlobAnalyticsLogging,
+    ContainerEncryptionScope,
+    ContainerProperties,
+    CorsRule,
+    FilteredBlob,
+    Metrics,
+    PublicAccess,
+    RetentionPolicy,
+    StaticWebsite,
+)
+from ._shared.base_client import StorageAccountHostsMixin
+from ._shared.models import UserDelegationKey
+
+class BlobServiceClient(StorageAccountHostsMixin, StorageEncryptionMixin):
+    def __init__(
+        self,
+        account_url: str,
+        credential: Optional[
+            Union[str, Dict[str, str], AzureNamedKeyCredential, AzureSasCredential, TokenCredential]
+        ] = None,
+        *,
+        api_version: Optional[str] = None,
+        secondary_hostname: Optional[str] = None,
+        max_block_size: int = 4 * 1024 * 1024,
+        max_single_put_size: int = 64 * 1024 * 1024,
+        min_large_block_upload_threshold: int = 4 * 1024 * 1024 + 1,
+        use_byte_buffer: bool = False,
+        max_page_size: int = 4 * 1024 * 1024,
+        max_single_get_size: int = 32 * 1024 * 1024,
+        max_chunk_get_size: int = 4 * 1024 * 1024,
+        audience: Optional[str] = None,
+        **kwargs: Any
+    ) -> None: ...
+    def __enter__(self) -> Self: ...
+    def __exit__(
+        self, typ: Optional[type[BaseException]], exc: Optional[BaseException], tb: Optional[TracebackType]
+    ) -> None: ...
+    def close(self) -> None: ...
+    @classmethod
+    def from_connection_string(
+        cls,
+        conn_str: str,
+        credential: Optional[
+            Union[str, Dict[str, str], AzureNamedKeyCredential, AzureSasCredential, TokenCredential]
+        ] = None,
+        *,
+        api_version: Optional[str] = None,
+        secondary_hostname: Optional[str] = None,
+        max_block_size: int = 4 * 1024 * 1024,
+        max_single_put_size: int = 64 * 1024 * 1024,
+        min_large_block_upload_threshold: int = 4 * 1024 * 1024 + 1,
+        use_byte_buffer: bool = False,
+        max_page_size: int = 4 * 1024 * 1024,
+        max_single_get_size: int = 32 * 1024 * 1024,
+        max_chunk_get_size: int = 4 * 1024 * 1024,
+        audience: Optional[str] = None,
+        **kwargs: Any
+    ) -> Self: ...
+    @distributed_trace
+    def get_user_delegation_key(
+        self, key_start_time: datetime, key_expiry_time: datetime, *, timeout: Optional[int] = None, **kwargs: Any
+    ) -> UserDelegationKey: ...
+    @distributed_trace
+    def get_account_information(self, **kwargs: Any) -> Dict[str, str]: ...
+    @distributed_trace
+    def get_service_stats(self, *, timeout: Optional[int] = None, **kwargs: Any) -> Dict[str, Any]: ...
+    @distributed_trace
+    def get_service_properties(self, *, timeout: Optional[int] = None, **kwargs: Any) -> Dict[str, Any]: ...
+    @distributed_trace
+    def set_service_properties(
+        self,
+        analytics_logging: Optional[BlobAnalyticsLogging] = None,
+        hour_metrics: Optional[Metrics] = None,
+        minute_metrics: Optional[Metrics] = None,
+        cors: Optional[List[CorsRule]] = None,
+        target_version: Optional[str] = None,
+        delete_retention_policy: Optional[RetentionPolicy] = None,
+        static_website: Optional[StaticWebsite] = None,
+        *,
+        timeout: Optional[int] = None,
+        **kwargs: Any
+    ) -> None: ...
+    @distributed_trace
+    def list_containers(
+        self,
+        name_starts_with: Optional[str] = None,
+        include_metadata: bool = False,
+        *,
+        include_deleted: Optional[bool] = None,
+        include_system: Optional[bool] = None,
+        results_per_page: Optional[int] = None,
+        timeout: Optional[int] = None,
+        **kwargs: Any
+    ) -> ItemPaged[ContainerProperties]: ...
+    @distributed_trace
+    def find_blobs_by_tags(
+        self,
+        filter_expression: str,
+        *,
+        results_per_page: Optional[int] = None,
+        timeout: Optional[int] = None,
+        **kwargs: Any
+    ) -> ItemPaged[FilteredBlob]: ...
+    @distributed_trace
+    def create_container(
+        self,
+        name: str,
+        metadata: Optional[Dict[str, str]] = None,
+        public_access: Optional[Union[PublicAccess, str]] = None,
+        *,
+        container_encryption_scope: Optional[Union[dict, ContainerEncryptionScope]] = None,
+        timeout: Optional[int] = None,
+        **kwargs: Any
+    ) -> ContainerClient: ...
+    @distributed_trace
+    def delete_container(
+        self,
+        container: Union[ContainerProperties, str],
+        lease: Optional[Union[BlobLeaseClient, str]] = None,
+        *,
+        if_modified_since: Optional[datetime] = None,
+        if_unmodified_since: Optional[datetime] = None,
+        etag: Optional[str] = None,
+        match_condition: Optional[MatchConditions] = None,
+        timeout: Optional[int] = None,
+        **kwargs: Any
+    ) -> None: ...
+    @distributed_trace
+    def _rename_container(
+        self,
+        name: str,
+        new_name: str,
+        *,
+        lease: Optional[Union[BlobLeaseClient, str]] = None,
+        timeout: Optional[int] = None,
+        **kwargs: Any
+    ) -> ContainerClient: ...
+    @distributed_trace
+    def undelete_container(
+        self,
+        deleted_container_name: str,
+        deleted_container_version: str,
+        *,
+        timeout: Optional[int] = None,
+        **kwargs: Any
+    ) -> ContainerClient: ...
+    def get_container_client(self, container: Union[ContainerProperties, str]) -> ContainerClient: ...
+    def get_blob_client(
+        self,
+        container: Union[ContainerProperties, str],
+        blob: str,
+        snapshot: Optional[Union[Dict[str, Any], str]] = None,
+        *,
+        version_id: Optional[str] = None
+    ) -> BlobClient: ...

azure/storage/blob/_container_client.py

@@ -150,6 +150,22 @@ class ContainerClient(StorageAccountHostsMixin, StorageEncryptionMixin):    # py
         self._client = self._build_generated_client()
         self._configure_encryption(kwargs)
 
+    def __enter__(self) -> Self:
+        self._client.__enter__()
+        return self
+
+    def __exit__(self, *args) -> None:
+        self._client.__exit__(*args)
+
+    def close(self) -> None:
+        """This method is to close the sockets opened by the client.
+        It need not be used when using with a context manager.
+
+        :return: None
+        :rtype: None
+        """
+        self._client.close()
+
     def _build_generated_client(self) -> AzureBlobStorage:
         client = AzureBlobStorage(self.url, base_url=self.url, pipeline=self._pipeline)
         client._config.version = self._api_version  # type: ignore [assignment] # pylint: disable=protected-access
@@ -796,6 +812,9 @@ class ContainerClient(StorageAccountHostsMixin, StorageEncryptionMixin):    # py
             Options include: 'snapshots', 'metadata', 'uncommittedblobs', 'copy', 'deleted', 'deletedwithversions',
             'tags', 'versions', 'immutabilitypolicy', 'legalhold'.
         :type include: list[str] or str
+        :keyword int results_per_page:
+            Controls the maximum number of Blobs that will be included in each page of results if using
+            `ItemPaged.by_page()`.
         :keyword int timeout:
             Sets the server-side timeout for the operation in seconds. For more details see
             https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations.
@@ -845,6 +864,9 @@ class ContainerClient(StorageAccountHostsMixin, StorageEncryptionMixin):    # py
         :keyword str name_starts_with:
             Filters the results to return only blobs whose names
             begin with the specified prefix.
+        :keyword int results_per_page:
+            Controls the maximum number of Blobs that will be included in each page of results if using
+            `ItemPaged.by_page()`.
         :keyword int timeout:
             Sets the server-side timeout for the operation in seconds. For more details see
             https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations.

azure/storage/blob/_container_client.pyi

@@ -0,0 +1,380 @@
+# -------------------------------------------------------------------------
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License. See License.txt in the project root for
+# license information.
+# --------------------------------------------------------------------------
+# pylint: skip-file
+
+from datetime import datetime
+from types import TracebackType
+from typing import (
+    Any,
+    AnyStr,
+    Callable,
+    Dict,
+    List,
+    IO,
+    Iterable,
+    Iterator,
+    Optional,
+    overload,
+    Union,
+)
+from typing_extensions import Self
+
+from azure.core import MatchConditions
+from azure.core.credentials import AzureNamedKeyCredential, AzureSasCredential, TokenCredential
+from azure.core.paging import ItemPaged
+from azure.core.pipeline.transport import HttpResponse
+from azure.core.tracing.decorator import distributed_trace
+from ._blob_client import BlobClient
+from ._blob_service_client import BlobServiceClient
+from ._download import StorageStreamDownloader
+from ._encryption import StorageEncryptionMixin
+from ._generated.models import RehydratePriority
+from ._lease import BlobLeaseClient
+from ._list_blobs_helper import BlobPrefix
+from ._models import (
+    AccessPolicy,
+    BlobProperties,
+    BlobType,
+    ContainerEncryptionScope,
+    ContainerProperties,
+    ContentSettings,
+    CustomerProvidedEncryptionKey,
+    FilteredBlob,
+    PremiumPageBlobTier,
+    PublicAccess,
+    StandardBlobTier,
+)
+from ._shared.base_client import StorageAccountHostsMixin
+
+class ContainerClient(StorageAccountHostsMixin, StorageEncryptionMixin):
+    account_name: str
+    container_name: str
+    def __init__(
+        self,
+        account_url: str,
+        container_name: str,
+        credential: Optional[
+            Union[str, Dict[str, str], AzureNamedKeyCredential, AzureSasCredential, TokenCredential]
+        ] = None,
+        *,
+        api_version: Optional[str] = None,
+        secondary_hostname: Optional[str] = None,
+        audience: Optional[str] = None,
+        max_block_size: int = 4 * 1024 * 1024,
+        max_page_size: int = 4 * 1024 * 1024,
+        max_chunk_get_size: int = 4 * 1024 * 1024,
+        max_single_put_size: int = 64 * 1024 * 1024,
+        max_single_get_size: int = 32 * 1024 * 1024,
+        min_large_block_upload_threshold: int = 4 * 1024 * 1024 + 1,
+        use_byte_buffer: Optional[bool] = None,
+        **kwargs: Any,
+    ) -> None: ...
+    def __enter__(self) -> Self: ...
+    def __exit__(
+        self, typ: Optional[type[BaseException]], exc: Optional[BaseException], tb: Optional[TracebackType]
+    ) -> None: ...
+    def close(self) -> None: ...
+    @classmethod
+    def from_container_url(
+        cls,
+        container_url: str,
+        credential: Optional[
+            Union[str, Dict[str, str], AzureNamedKeyCredential, AzureSasCredential, TokenCredential]
+        ] = None,
+        *,
+        api_version: Optional[str] = None,
+        secondary_hostname: Optional[str] = None,
+        audience: Optional[str] = None,
+        max_block_size: int = 4 * 1024 * 1024,
+        max_page_size: int = 4 * 1024 * 1024,
+        max_chunk_get_size: int = 4 * 1024 * 1024,
+        max_single_put_size: int = 64 * 1024 * 1024,
+        max_single_get_size: int = 32 * 1024 * 1024,
+        min_large_block_upload_threshold: int = 4 * 1024 * 1024 + 1,
+        use_byte_buffer: Optional[bool] = None,
+        **kwargs: Any,
+    ) -> Self: ...
+    @classmethod
+    def from_connection_string(
+        cls,
+        conn_str: str,
+        container_name: str,
+        credential: Optional[
+            Union[str, Dict[str, str], AzureNamedKeyCredential, AzureSasCredential, TokenCredential]
+        ] = None,
+        *,
+        api_version: Optional[str] = None,
+        secondary_hostname: Optional[str] = None,
+        audience: Optional[str] = None,
+        max_block_size: int = 4 * 1024 * 1024,
+        max_page_size: int = 4 * 1024 * 1024,
+        max_chunk_get_size: int = 4 * 1024 * 1024,
+        max_single_put_size: int = 64 * 1024 * 1024,
+        max_single_get_size: int = 32 * 1024 * 1024,
+        min_large_block_upload_threshold: int = 4 * 1024 * 1024 + 1,
+        use_byte_buffer: Optional[bool] = None,
+        **kwargs: Any,
+    ) -> Self: ...
+    @distributed_trace
+    def create_container(
+        self,
+        metadata: Optional[Dict[str, str]] = None,
+        public_access: Optional[Union[PublicAccess, str]] = None,
+        *,
+        container_encryption_scope: Optional[Union[Dict[str, Any], ContainerEncryptionScope]] = None,
+        timeout: Optional[int] = None,
+        **kwargs: Any,
+    ) -> Dict[str, Union[str, datetime]]: ...
+    @distributed_trace
+    def _rename_container(
+        self,
+        new_name: str,
+        *,
+        lease: Optional[Union[BlobLeaseClient, str]] = None,
+        timeout: Optional[int] = None,
+        **kwargs: Any,
+    ) -> "ContainerClient": ...
+    @distributed_trace
+    def delete_container(
+        self,
+        *,
+        lease: Optional[Union[BlobLeaseClient, str]] = None,
+        if_modified_since: Optional[datetime] = None,
+        if_unmodified_since: Optional[datetime] = None,
+        etag: Optional[str] = None,
+        match_condition: Optional[MatchConditions] = None,
+        timeout: Optional[int] = None,
+        **kwargs: Any,
+    ) -> None: ...
+    @distributed_trace
+    def acquire_lease(
+        self,
+        lease_duration: int = -1,
+        lease_id: Optional[str] = None,
+        *,
+        if_modified_since: Optional[datetime] = None,
+        if_unmodified_since: Optional[datetime] = None,
+        etag: Optional[str] = None,
+        match_condition: Optional[MatchConditions] = None,
+        timeout: Optional[int] = None,
+        **kwargs: Any,
+    ) -> BlobLeaseClient: ...
+    @distributed_trace
+    def get_account_information(self, **kwargs: Any) -> Dict[str, str]: ...
+    @distributed_trace
+    def get_container_properties(
+        self, *, lease: Optional[Union[BlobLeaseClient, str]] = None, timeout: Optional[int] = None, **kwargs: Any
+    ) -> ContainerProperties: ...
+    @distributed_trace
+    def exists(self, *, timeout: Optional[int] = None, **kwargs: Any) -> bool: ...
+    @distributed_trace
+    def set_container_metadata(
+        self,
+        metadata: Optional[Dict[str, str]] = None,
+        *,
+        lease: Optional[Union[BlobLeaseClient, str]] = None,
+        if_modified_since: Optional[datetime] = None,
+        if_unmodified_since: Optional[datetime] = None,
+        etag: Optional[str] = None,
+        match_condition: Optional[MatchConditions] = None,
+        timeout: Optional[int] = None,
+        **kwargs: Any,
+    ) -> Dict[str, Union[str, datetime]]: ...
+    @distributed_trace
+    def _get_blob_service_client(self) -> BlobServiceClient: ...
+    @distributed_trace
+    def get_container_access_policy(
+        self, *, lease: Optional[Union[BlobLeaseClient, str]] = None, timeout: Optional[int] = None, **kwargs: Any
+    ) -> Dict[str, Any]: ...
+    @distributed_trace
+    def set_container_access_policy(
+        self,
+        signed_identifiers: Dict[str, AccessPolicy],
+        public_access: Optional[Union[str, PublicAccess]] = None,
+        *,
+        lease: Optional[Union[BlobLeaseClient, str]] = None,
+        if_modified_since: Optional[datetime] = None,
+        if_unmodified_since: Optional[datetime] = None,
+        timeout: Optional[int] = None,
+        **kwargs: Any,
+    ) -> Dict[str, Union[str, datetime]]: ...
+    @distributed_trace
+    def list_blobs(
+        self,
+        name_starts_with: Optional[str] = None,
+        include: Optional[Union[str, List[str]]] = None,
+        *,
+        timeout: Optional[int] = None,
+        **kwargs: Any,
+    ) -> ItemPaged[BlobProperties]: ...
+    @distributed_trace
+    def list_blob_names(
+        self, *, name_starts_with: Optional[str] = None, timeout: Optional[int] = None, **kwargs: Any
+    ) -> ItemPaged[str]: ...
+    @distributed_trace
+    def walk_blobs(
+        self,
+        name_starts_with: Optional[str] = None,
+        include: Optional[Union[List[str], str]] = None,
+        delimiter: str = "/",
+        *,
+        timeout: Optional[int] = None,
+        **kwargs: Any,
+    ) -> ItemPaged[Union[BlobProperties, BlobPrefix]]: ...
+    @distributed_trace
+    def find_blobs_by_tags(
+        self,
+        filter_expression: str,
+        *,
+        results_per_page: Optional[int] = None,
+        timeout: Optional[int] = None,
+        **kwargs: Any,
+    ) -> ItemPaged[FilteredBlob]: ...
+    @distributed_trace
+    def upload_blob(
+        self,
+        name: str,
+        data: Union[bytes, str, Iterable[AnyStr], IO[AnyStr]],
+        blob_type: Union[str, BlobType] = BlobType.BLOCKBLOB,
+        length: Optional[int] = None,
+        metadata: Optional[Dict[str, str]] = None,
+        *,
+        overwrite: Optional[bool] = None,
+        content_settings: Optional[ContentSettings] = None,
+        validate_content: Optional[bool] = None,
+        lease: Optional[Union[BlobLeaseClient, str]] = None,
+        if_modified_since: Optional[datetime] = None,
+        if_unmodified_since: Optional[datetime] = None,
+        etag: Optional[str] = None,
+        match_condition: Optional[MatchConditions] = None,
+        if_tags_match_condition: Optional[str] = None,
+        timeout: Optional[int] = None,
+        premium_page_blob_tier: Optional[PremiumPageBlobTier] = None,
+        standard_blob_tier: Optional[StandardBlobTier] = None,
+        maxsize_condition: Optional[int] = None,
+        max_concurrency: Optional[int] = None,
+        cpk: Optional[CustomerProvidedEncryptionKey] = None,
+        encryption_scope: Optional[str] = None,
+        encoding: Optional[str] = None,
+        progress_hook: Optional[Callable[[int, Optional[int]], None]] = None,
+        **kwargs: Any,
+    ) -> BlobClient: ...
+    @distributed_trace
+    def delete_blob(
+        self,
+        blob: str,
+        delete_snapshots: Optional[str] = None,
+        *,
+        version_id: Optional[str] = None,
+        lease: Optional[Union[BlobLeaseClient, str]] = None,
+        if_modified_since: Optional[datetime] = None,
+        if_unmodified_since: Optional[datetime] = None,
+        etag: Optional[str] = None,
+        match_condition: Optional[MatchConditions] = None,
+        if_tags_match_condition: Optional[str] = None,
+        timeout: Optional[int] = None,
+        **kwargs: Any,
+    ) -> None: ...
+    @overload
+    def download_blob(
+        self,
+        blob: str,
+        offset: Optional[int] = None,
+        length: Optional[int] = None,
+        *,
+        version_id: Optional[str] = None,
+        validate_content: Optional[bool] = None,
+        lease: Optional[Union[BlobLeaseClient, str]] = None,
+        if_modified_since: Optional[datetime] = None,
+        if_unmodified_since: Optional[datetime] = None,
+        etag: Optional[str] = None,
+        match_condition: Optional[MatchConditions] = None,
+        if_tags_match_condition: Optional[str] = None,
+        cpk: Optional[CustomerProvidedEncryptionKey] = None,
+        max_concurrency: Optional[int] = None,
+        encoding: str,
+        progress_hook: Optional[Callable[[int, int], None]] = None,
+        timeout: Optional[int] = None,
+    ) -> StorageStreamDownloader[str]: ...
+    @overload
+    def download_blob(
+        self,
+        blob: str,
+        offset: Optional[int] = None,
+        length: Optional[int] = None,
+        *,
+        version_id: Optional[str] = None,
+        validate_content: Optional[bool] = None,
+        lease: Optional[Union[BlobLeaseClient, str]] = None,
+        if_modified_since: Optional[datetime] = None,
+        if_unmodified_since: Optional[datetime] = None,
+        etag: Optional[str] = None,
+        match_condition: Optional[MatchConditions] = None,
+        if_tags_match_condition: Optional[str] = None,
+        cpk: Optional[CustomerProvidedEncryptionKey] = None,
+        max_concurrency: Optional[int] = None,
+        encoding: None = None,
+        progress_hook: Optional[Callable[[int, int], None]] = None,
+        timeout: Optional[int] = None,
+        **kwargs: Any,
+    ) -> StorageStreamDownloader[bytes]: ...
+    @distributed_trace  # type: ignore[misc]
+    def download_blob(
+        self,
+        blob: str,
+        offset: Optional[int] = None,
+        length: Optional[int] = None,
+        *,
+        version_id: Optional[str] = None,
+        validate_content: Optional[bool] = None,
+        lease: Optional[Union[BlobLeaseClient, str]] = None,
+        if_modified_since: Optional[datetime] = None,
+        if_unmodified_since: Optional[datetime] = None,
+        etag: Optional[str] = None,
+        match_condition: Optional[MatchConditions] = None,
+        if_tags_match_condition: Optional[str] = None,
+        cpk: Optional[CustomerProvidedEncryptionKey] = None,
+        max_concurrency: Optional[int] = None,
+        encoding: Optional[str] = None,
+        progress_hook: Optional[Callable[[int, int], None]] = None,
+        timeout: Optional[int] = None,
+        **kwargs: Any,
+    ) -> Union[StorageStreamDownloader[str], StorageStreamDownloader[bytes]]: ...
+    @distributed_trace
+    def delete_blobs(
+        self,
+        *blobs: Union[str, Dict[str, Any], BlobProperties],
+        delete_snapshots: Optional[str] = None,
+        if_modified_since: Optional[datetime] = None,
+        if_unmodified_since: Optional[datetime] = None,
+        if_tags_match_condition: Optional[str] = None,
+        raise_on_any_failure: bool = True,
+        timeout: Optional[int] = None,
+        **kwargs: Any,
+    ) -> Iterator[HttpResponse]: ...
+    @distributed_trace
+    def set_standard_blob_tier_blobs(
+        self,
+        standard_blob_tier: Optional[Union[str, StandardBlobTier]],
+        *blobs: Union[str, Dict[str, Any], BlobProperties],
+        rehydrate_priority: Optional[RehydratePriority] = None,
+        if_tags_match_condition: Optional[str] = None,
+        raise_on_any_failure: bool = True,
+        timeout: Optional[int] = None,
+        **kwargs: Any,
+    ) -> Iterator[HttpResponse]: ...
+    @distributed_trace
+    def set_premium_page_blob_tier_blobs(
+        self,
+        premium_page_blob_tier: Optional[Union[str, PremiumPageBlobTier]],
+        *blobs: Union[str, Dict[str, Any], BlobProperties],
+        raise_on_any_failure: bool = True,
+        timeout: Optional[int] = None,
+        **kwargs: Any,
+    ) -> Iterator[HttpResponse]: ...
+    def get_blob_client(
+        self, blob: str, snapshot: Optional[str] = None, *, version_id: Optional[str] = None
+    ) -> BlobClient: ...