azure-mgmt-storage 22.0.0__py3-none-any.whl → 22.1.1__py3-none-any.whl

azure/mgmt/storage/{v2023_05_01 → v2024_01_01}/aio/operations/_deleted_accounts_operations.py

@@ -42,7 +42,7 @@ class DeletedAccountsOperations:
         **DO NOT** instantiate this class directly.
 
         Instead, you should access the following operations through
-        :class:`~azure.mgmt.storage.v2023_05_01.aio.StorageManagementClient`'s
+        :class:`~azure.mgmt.storage.v2024_01_01.aio.StorageManagementClient`'s
         :attr:`deleted_accounts` attribute.
     """
 
@@ -62,13 +62,13 @@ class DeletedAccountsOperations:
 
         :return: An iterator like instance of either DeletedAccount or the result of cls(response)
         :rtype:
-         ~azure.core.async_paging.AsyncItemPaged[~azure.mgmt.storage.v2023_05_01.models.DeletedAccount]
+         ~azure.core.async_paging.AsyncItemPaged[~azure.mgmt.storage.v2024_01_01.models.DeletedAccount]
         :raises ~azure.core.exceptions.HttpResponseError:
         """
         _headers = kwargs.pop("headers", {}) or {}
         _params = case_insensitive_dict(kwargs.pop("params", {}) or {})
 
-        api_version: str = kwargs.pop("api_version", _params.pop("api-version", self._api_version or "2023-05-01"))
+        api_version: str = kwargs.pop("api_version", _params.pop("api-version", self._api_version or "2024-01-01"))
         cls: ClsType[_models.DeletedAccountListResult] = kwargs.pop("cls", None)
 
         error_map: MutableMapping = {
@@ -141,7 +141,7 @@ class DeletedAccountsOperations:
         :param location: The location of the deleted storage account. Required.
         :type location: str
         :return: DeletedAccount or the result of cls(response)
-        :rtype: ~azure.mgmt.storage.v2023_05_01.models.DeletedAccount
+        :rtype: ~azure.mgmt.storage.v2024_01_01.models.DeletedAccount
         :raises ~azure.core.exceptions.HttpResponseError:
         """
         error_map: MutableMapping = {
@@ -155,7 +155,7 @@ class DeletedAccountsOperations:
         _headers = kwargs.pop("headers", {}) or {}
         _params = case_insensitive_dict(kwargs.pop("params", {}) or {})
 
-        api_version: str = kwargs.pop("api_version", _params.pop("api-version", self._api_version or "2023-05-01"))
+        api_version: str = kwargs.pop("api_version", _params.pop("api-version", self._api_version or "2024-01-01"))
         cls: ClsType[_models.DeletedAccount] = kwargs.pop("cls", None)
 
         _request = build_get_request(

azure/mgmt/storage/{v2023_05_01 → v2024_01_01}/aio/operations/_encryption_scopes_operations.py

@@ -48,7 +48,7 @@ class EncryptionScopesOperations:
         **DO NOT** instantiate this class directly.
 
         Instead, you should access the following operations through
-        :class:`~azure.mgmt.storage.v2023_05_01.aio.StorageManagementClient`'s
+        :class:`~azure.mgmt.storage.v2024_01_01.aio.StorageManagementClient`'s
         :attr:`encryption_scopes` attribute.
     """
 
@@ -91,12 +91,12 @@ class EncryptionScopesOperations:
         :type encryption_scope_name: str
         :param encryption_scope: Encryption scope properties to be used for the create or update.
          Required.
-        :type encryption_scope: ~azure.mgmt.storage.v2023_05_01.models.EncryptionScope
+        :type encryption_scope: ~azure.mgmt.storage.v2024_01_01.models.EncryptionScope
         :keyword content_type: Body Parameter content-type. Content type parameter for JSON body.
          Default value is "application/json".
         :paramtype content_type: str
         :return: EncryptionScope or the result of cls(response)
-        :rtype: ~azure.mgmt.storage.v2023_05_01.models.EncryptionScope
+        :rtype: ~azure.mgmt.storage.v2024_01_01.models.EncryptionScope
         :raises ~azure.core.exceptions.HttpResponseError:
         """
 
@@ -134,7 +134,7 @@ class EncryptionScopesOperations:
          Default value is "application/json".
         :paramtype content_type: str
         :return: EncryptionScope or the result of cls(response)
-        :rtype: ~azure.mgmt.storage.v2023_05_01.models.EncryptionScope
+        :rtype: ~azure.mgmt.storage.v2024_01_01.models.EncryptionScope
         :raises ~azure.core.exceptions.HttpResponseError:
         """
 
@@ -165,9 +165,9 @@ class EncryptionScopesOperations:
         :type encryption_scope_name: str
         :param encryption_scope: Encryption scope properties to be used for the create or update. Is
          either a EncryptionScope type or a IO[bytes] type. Required.
-        :type encryption_scope: ~azure.mgmt.storage.v2023_05_01.models.EncryptionScope or IO[bytes]
+        :type encryption_scope: ~azure.mgmt.storage.v2024_01_01.models.EncryptionScope or IO[bytes]
         :return: EncryptionScope or the result of cls(response)
-        :rtype: ~azure.mgmt.storage.v2023_05_01.models.EncryptionScope
+        :rtype: ~azure.mgmt.storage.v2024_01_01.models.EncryptionScope
         :raises ~azure.core.exceptions.HttpResponseError:
         """
         error_map: MutableMapping = {
@@ -181,7 +181,7 @@ class EncryptionScopesOperations:
         _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {})
         _params = case_insensitive_dict(kwargs.pop("params", {}) or {})
 
-        api_version: str = kwargs.pop("api_version", _params.pop("api-version", self._api_version or "2023-05-01"))
+        api_version: str = kwargs.pop("api_version", _params.pop("api-version", self._api_version or "2024-01-01"))
         content_type: Optional[str] = kwargs.pop("content_type", _headers.pop("Content-Type", None))
         cls: ClsType[_models.EncryptionScope] = kwargs.pop("cls", None)
 
@@ -253,12 +253,12 @@ class EncryptionScopesOperations:
          followed by a letter or number. Required.
         :type encryption_scope_name: str
         :param encryption_scope: Encryption scope properties to be used for the update. Required.
-        :type encryption_scope: ~azure.mgmt.storage.v2023_05_01.models.EncryptionScope
+        :type encryption_scope: ~azure.mgmt.storage.v2024_01_01.models.EncryptionScope
         :keyword content_type: Body Parameter content-type. Content type parameter for JSON body.
          Default value is "application/json".
         :paramtype content_type: str
         :return: EncryptionScope or the result of cls(response)
-        :rtype: ~azure.mgmt.storage.v2023_05_01.models.EncryptionScope
+        :rtype: ~azure.mgmt.storage.v2024_01_01.models.EncryptionScope
         :raises ~azure.core.exceptions.HttpResponseError:
         """
 
@@ -294,7 +294,7 @@ class EncryptionScopesOperations:
          Default value is "application/json".
         :paramtype content_type: str
         :return: EncryptionScope or the result of cls(response)
-        :rtype: ~azure.mgmt.storage.v2023_05_01.models.EncryptionScope
+        :rtype: ~azure.mgmt.storage.v2024_01_01.models.EncryptionScope
         :raises ~azure.core.exceptions.HttpResponseError:
         """
 
@@ -324,9 +324,9 @@ class EncryptionScopesOperations:
         :type encryption_scope_name: str
         :param encryption_scope: Encryption scope properties to be used for the update. Is either a
          EncryptionScope type or a IO[bytes] type. Required.
-        :type encryption_scope: ~azure.mgmt.storage.v2023_05_01.models.EncryptionScope or IO[bytes]
+        :type encryption_scope: ~azure.mgmt.storage.v2024_01_01.models.EncryptionScope or IO[bytes]
         :return: EncryptionScope or the result of cls(response)
-        :rtype: ~azure.mgmt.storage.v2023_05_01.models.EncryptionScope
+        :rtype: ~azure.mgmt.storage.v2024_01_01.models.EncryptionScope
         :raises ~azure.core.exceptions.HttpResponseError:
         """
         error_map: MutableMapping = {
@@ -340,7 +340,7 @@ class EncryptionScopesOperations:
         _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {})
         _params = case_insensitive_dict(kwargs.pop("params", {}) or {})
 
-        api_version: str = kwargs.pop("api_version", _params.pop("api-version", self._api_version or "2023-05-01"))
+        api_version: str = kwargs.pop("api_version", _params.pop("api-version", self._api_version or "2024-01-01"))
         content_type: Optional[str] = kwargs.pop("content_type", _headers.pop("Content-Type", None))
         cls: ClsType[_models.EncryptionScope] = kwargs.pop("cls", None)
 
@@ -404,7 +404,7 @@ class EncryptionScopesOperations:
          followed by a letter or number. Required.
         :type encryption_scope_name: str
         :return: EncryptionScope or the result of cls(response)
-        :rtype: ~azure.mgmt.storage.v2023_05_01.models.EncryptionScope
+        :rtype: ~azure.mgmt.storage.v2024_01_01.models.EncryptionScope
         :raises ~azure.core.exceptions.HttpResponseError:
         """
         error_map: MutableMapping = {
@@ -418,7 +418,7 @@ class EncryptionScopesOperations:
         _headers = kwargs.pop("headers", {}) or {}
         _params = case_insensitive_dict(kwargs.pop("params", {}) or {})
 
-        api_version: str = kwargs.pop("api_version", _params.pop("api-version", self._api_version or "2023-05-01"))
+        api_version: str = kwargs.pop("api_version", _params.pop("api-version", self._api_version or "2024-01-01"))
         cls: ClsType[_models.EncryptionScope] = kwargs.pop("cls", None)
 
         _request = build_get_request(
@@ -478,16 +478,16 @@ class EncryptionScopesOperations:
         :type filter: str
         :param include: Optional, when specified, will list encryption scopes with the specific state.
          Defaults to All. Known values are: "All", "Enabled", and "Disabled". Default value is None.
-        :type include: str or ~azure.mgmt.storage.v2023_05_01.models.ListEncryptionScopesInclude
+        :type include: str or ~azure.mgmt.storage.v2024_01_01.models.ListEncryptionScopesInclude
         :return: An iterator like instance of either EncryptionScope or the result of cls(response)
         :rtype:
-         ~azure.core.async_paging.AsyncItemPaged[~azure.mgmt.storage.v2023_05_01.models.EncryptionScope]
+         ~azure.core.async_paging.AsyncItemPaged[~azure.mgmt.storage.v2024_01_01.models.EncryptionScope]
         :raises ~azure.core.exceptions.HttpResponseError:
         """
         _headers = kwargs.pop("headers", {}) or {}
         _params = case_insensitive_dict(kwargs.pop("params", {}) or {})
 
-        api_version: str = kwargs.pop("api_version", _params.pop("api-version", self._api_version or "2023-05-01"))
+        api_version: str = kwargs.pop("api_version", _params.pop("api-version", self._api_version or "2024-01-01"))
         cls: ClsType[_models.EncryptionScopeListResult] = kwargs.pop("cls", None)
 
         error_map: MutableMapping = {

azure/mgmt/storage/{v2023_05_01 → v2024_01_01}/aio/operations/_file_services_operations.py

@@ -7,8 +7,10 @@
 # --------------------------------------------------------------------------
 from io import IOBase
 import sys
-from typing import Any, Callable, Dict, IO, Literal, Optional, TypeVar, Union, overload
+from typing import Any, AsyncIterable, Callable, Dict, IO, Literal, Optional, TypeVar, Union, overload
+import urllib.parse
 
+from azure.core.async_paging import AsyncItemPaged, AsyncList
 from azure.core.exceptions import (
     ClientAuthenticationError,
     HttpResponseError,
@@ -19,6 +21,7 @@ from azure.core.exceptions import (
 )
 from azure.core.pipeline import PipelineResponse
 from azure.core.rest import AsyncHttpResponse, HttpRequest
+from azure.core.tracing.decorator import distributed_trace
 from azure.core.tracing.decorator_async import distributed_trace_async
 from azure.core.utils import case_insensitive_dict
 from azure.mgmt.core.exceptions import ARMErrorFormat
@@ -26,7 +29,9 @@ from azure.mgmt.core.exceptions import ARMErrorFormat
 from ... import models as _models
 from ...operations._file_services_operations import (
     build_get_service_properties_request,
+    build_get_service_usage_request,
     build_list_request,
+    build_list_service_usages_request,
     build_set_service_properties_request,
 )
 
@@ -44,7 +49,7 @@ class FileServicesOperations:
         **DO NOT** instantiate this class directly.
 
         Instead, you should access the following operations through
-        :class:`~azure.mgmt.storage.v2023_05_01.aio.StorageManagementClient`'s
+        :class:`~azure.mgmt.storage.v2024_01_01.aio.StorageManagementClient`'s
         :attr:`file_services` attribute.
     """
 
@@ -70,7 +75,7 @@ class FileServicesOperations:
          lower-case letters only. Required.
         :type account_name: str
         :return: FileServiceItems or the result of cls(response)
-        :rtype: ~azure.mgmt.storage.v2023_05_01.models.FileServiceItems
+        :rtype: ~azure.mgmt.storage.v2024_01_01.models.FileServiceItems
         :raises ~azure.core.exceptions.HttpResponseError:
         """
         error_map: MutableMapping = {
@@ -84,7 +89,7 @@ class FileServicesOperations:
         _headers = kwargs.pop("headers", {}) or {}
         _params = case_insensitive_dict(kwargs.pop("params", {}) or {})
 
-        api_version: str = kwargs.pop("api_version", _params.pop("api-version", self._api_version or "2023-05-01"))
+        api_version: str = kwargs.pop("api_version", _params.pop("api-version", self._api_version or "2024-01-01"))
         cls: ClsType[_models.FileServiceItems] = kwargs.pop("cls", None)
 
         _request = build_list_request(
@@ -137,12 +142,12 @@ class FileServicesOperations:
         :type account_name: str
         :param parameters: The properties of file services in storage accounts, including CORS
          (Cross-Origin Resource Sharing) rules. Required.
-        :type parameters: ~azure.mgmt.storage.v2023_05_01.models.FileServiceProperties
+        :type parameters: ~azure.mgmt.storage.v2024_01_01.models.FileServiceProperties
         :keyword content_type: Body Parameter content-type. Content type parameter for JSON body.
          Default value is "application/json".
         :paramtype content_type: str
         :return: FileServiceProperties or the result of cls(response)
-        :rtype: ~azure.mgmt.storage.v2023_05_01.models.FileServiceProperties
+        :rtype: ~azure.mgmt.storage.v2024_01_01.models.FileServiceProperties
         :raises ~azure.core.exceptions.HttpResponseError:
         """
 
@@ -173,7 +178,7 @@ class FileServicesOperations:
          Default value is "application/json".
         :paramtype content_type: str
         :return: FileServiceProperties or the result of cls(response)
-        :rtype: ~azure.mgmt.storage.v2023_05_01.models.FileServiceProperties
+        :rtype: ~azure.mgmt.storage.v2024_01_01.models.FileServiceProperties
         :raises ~azure.core.exceptions.HttpResponseError:
         """
 
@@ -198,9 +203,9 @@ class FileServicesOperations:
         :param parameters: The properties of file services in storage accounts, including CORS
          (Cross-Origin Resource Sharing) rules. Is either a FileServiceProperties type or a IO[bytes]
          type. Required.
-        :type parameters: ~azure.mgmt.storage.v2023_05_01.models.FileServiceProperties or IO[bytes]
+        :type parameters: ~azure.mgmt.storage.v2024_01_01.models.FileServiceProperties or IO[bytes]
         :return: FileServiceProperties or the result of cls(response)
-        :rtype: ~azure.mgmt.storage.v2023_05_01.models.FileServiceProperties
+        :rtype: ~azure.mgmt.storage.v2024_01_01.models.FileServiceProperties
         :raises ~azure.core.exceptions.HttpResponseError:
         """
         error_map: MutableMapping = {
@@ -214,7 +219,7 @@ class FileServicesOperations:
         _headers = case_insensitive_dict(kwargs.pop("headers", {}) or {})
         _params = case_insensitive_dict(kwargs.pop("params", {}) or {})
 
-        api_version: str = kwargs.pop("api_version", _params.pop("api-version", self._api_version or "2023-05-01"))
+        api_version: str = kwargs.pop("api_version", _params.pop("api-version", self._api_version or "2024-01-01"))
         file_services_name: Literal["default"] = kwargs.pop("file_services_name", "default")
         content_type: Optional[str] = kwargs.pop("content_type", _headers.pop("Content-Type", None))
         cls: ClsType[_models.FileServiceProperties] = kwargs.pop("cls", None)
@@ -274,7 +279,7 @@ class FileServicesOperations:
          lower-case letters only. Required.
         :type account_name: str
         :return: FileServiceProperties or the result of cls(response)
-        :rtype: ~azure.mgmt.storage.v2023_05_01.models.FileServiceProperties
+        :rtype: ~azure.mgmt.storage.v2024_01_01.models.FileServiceProperties
         :raises ~azure.core.exceptions.HttpResponseError:
         """
         error_map: MutableMapping = {
@@ -288,7 +293,7 @@ class FileServicesOperations:
         _headers = kwargs.pop("headers", {}) or {}
         _params = case_insensitive_dict(kwargs.pop("params", {}) or {})
 
-        api_version: str = kwargs.pop("api_version", _params.pop("api-version", self._api_version or "2023-05-01"))
+        api_version: str = kwargs.pop("api_version", _params.pop("api-version", self._api_version or "2024-01-01"))
         file_services_name: Literal["default"] = kwargs.pop("file_services_name", "default")
         cls: ClsType[_models.FileServiceProperties] = kwargs.pop("cls", None)
 
@@ -320,3 +325,159 @@ class FileServicesOperations:
             return cls(pipeline_response, deserialized, {})  # type: ignore
 
         return deserialized  # type: ignore
+
+    @distributed_trace
+    def list_service_usages(
+        self, resource_group_name: str, account_name: str, maxpagesize: Optional[int] = None, **kwargs: Any
+    ) -> AsyncIterable["_models.FileServiceUsage"]:
+        """Gets the usages of file service in storage account.
+
+        :param resource_group_name: The name of the resource group within the user's subscription. The
+         name is case insensitive. Required.
+        :type resource_group_name: str
+        :param account_name: The name of the storage account within the specified resource group.
+         Storage account names must be between 3 and 24 characters in length and use numbers and
+         lower-case letters only. Required.
+        :type account_name: str
+        :param maxpagesize: Optional, specifies the maximum number of file service usages to be
+         included in the list response. Default value is None.
+        :type maxpagesize: int
+        :return: An iterator like instance of either FileServiceUsage or the result of cls(response)
+        :rtype:
+         ~azure.core.async_paging.AsyncItemPaged[~azure.mgmt.storage.v2024_01_01.models.FileServiceUsage]
+        :raises ~azure.core.exceptions.HttpResponseError:
+        """
+        _headers = kwargs.pop("headers", {}) or {}
+        _params = case_insensitive_dict(kwargs.pop("params", {}) or {})
+
+        api_version: str = kwargs.pop("api_version", _params.pop("api-version", self._api_version or "2024-01-01"))
+        file_services_name: Literal["default"] = kwargs.pop("file_services_name", "default")
+        cls: ClsType[_models.FileServiceUsages] = kwargs.pop("cls", None)
+
+        error_map: MutableMapping = {
+            401: ClientAuthenticationError,
+            404: ResourceNotFoundError,
+            409: ResourceExistsError,
+            304: ResourceNotModifiedError,
+        }
+        error_map.update(kwargs.pop("error_map", {}) or {})
+
+        def prepare_request(next_link=None):
+            if not next_link:
+
+                _request = build_list_service_usages_request(
+                    resource_group_name=resource_group_name,
+                    account_name=account_name,
+                    subscription_id=self._config.subscription_id,
+                    maxpagesize=maxpagesize,
+                    api_version=api_version,
+                    file_services_name=file_services_name,
+                    headers=_headers,
+                    params=_params,
+                )
+                _request.url = self._client.format_url(_request.url)
+
+            else:
+                # make call to next link with the client's api-version
+                _parsed_next_link = urllib.parse.urlparse(next_link)
+                _next_request_params = case_insensitive_dict(
+                    {
+                        key: [urllib.parse.quote(v) for v in value]
+                        for key, value in urllib.parse.parse_qs(_parsed_next_link.query).items()
+                    }
+                )
+                _next_request_params["api-version"] = self._api_version
+                _request = HttpRequest(
+                    "GET", urllib.parse.urljoin(next_link, _parsed_next_link.path), params=_next_request_params
+                )
+                _request.url = self._client.format_url(_request.url)
+                _request.method = "GET"
+            return _request
+
+        async def extract_data(pipeline_response):
+            deserialized = self._deserialize("FileServiceUsages", pipeline_response)
+            list_of_elem = deserialized.value
+            if cls:
+                list_of_elem = cls(list_of_elem)  # type: ignore
+            return deserialized.next_link or None, AsyncList(list_of_elem)
+
+        async def get_next(next_link=None):
+            _request = prepare_request(next_link)
+
+            _stream = False
+            pipeline_response: PipelineResponse = await self._client._pipeline.run(  # pylint: disable=protected-access
+                _request, stream=_stream, **kwargs
+            )
+            response = pipeline_response.http_response
+
+            if response.status_code not in [200]:
+                map_error(status_code=response.status_code, response=response, error_map=error_map)
+                raise HttpResponseError(response=response, error_format=ARMErrorFormat)
+
+            return pipeline_response
+
+        return AsyncItemPaged(get_next, extract_data)
+
+    @distributed_trace_async
+    async def get_service_usage(
+        self, resource_group_name: str, account_name: str, **kwargs: Any
+    ) -> _models.FileServiceUsage:
+        """Gets the usage of file service in storage account including account limits, file share limits
+        and constants used in recommendations and bursting formula.
+
+        :param resource_group_name: The name of the resource group within the user's subscription. The
+         name is case insensitive. Required.
+        :type resource_group_name: str
+        :param account_name: The name of the storage account within the specified resource group.
+         Storage account names must be between 3 and 24 characters in length and use numbers and
+         lower-case letters only. Required.
+        :type account_name: str
+        :return: FileServiceUsage or the result of cls(response)
+        :rtype: ~azure.mgmt.storage.v2024_01_01.models.FileServiceUsage
+        :raises ~azure.core.exceptions.HttpResponseError:
+        """
+        error_map: MutableMapping = {
+            401: ClientAuthenticationError,
+            404: ResourceNotFoundError,
+            409: ResourceExistsError,
+            304: ResourceNotModifiedError,
+        }
+        error_map.update(kwargs.pop("error_map", {}) or {})
+
+        _headers = kwargs.pop("headers", {}) or {}
+        _params = case_insensitive_dict(kwargs.pop("params", {}) or {})
+
+        api_version: str = kwargs.pop("api_version", _params.pop("api-version", self._api_version or "2024-01-01"))
+        file_services_name: Literal["default"] = kwargs.pop("file_services_name", "default")
+        file_service_usages_name: Literal["default"] = kwargs.pop("file_service_usages_name", "default")
+        cls: ClsType[_models.FileServiceUsage] = kwargs.pop("cls", None)
+
+        _request = build_get_service_usage_request(
+            resource_group_name=resource_group_name,
+            account_name=account_name,
+            subscription_id=self._config.subscription_id,
+            api_version=api_version,
+            file_services_name=file_services_name,
+            file_service_usages_name=file_service_usages_name,
+            headers=_headers,
+            params=_params,
+        )
+        _request.url = self._client.format_url(_request.url)
+
+        _stream = False
+        pipeline_response: PipelineResponse = await self._client._pipeline.run(  # pylint: disable=protected-access
+            _request, stream=_stream, **kwargs
+        )
+
+        response = pipeline_response.http_response
+
+        if response.status_code not in [200]:
+            map_error(status_code=response.status_code, response=response, error_map=error_map)
+            raise HttpResponseError(response=response, error_format=ARMErrorFormat)
+
+        deserialized = self._deserialize("FileServiceUsage", pipeline_response.http_response)
+
+        if cls:
+            return cls(pipeline_response, deserialized, {})  # type: ignore
+
+        return deserialized  # type: ignore