azure.mgmt.storage.v2024_01_01.operations module
- class azure.mgmt.storage.v2024_01_01.operations.BlobContainersOperations(*args, **kwargs)[source]
Bases:
objectWarning
DO NOT instantiate this class directly.
Instead, you should access the following operations through
StorageManagementClient’sblob_containersattribute.- begin_object_level_worm(resource_group_name: str, account_name: str, container_name: str, **kwargs: Any) LROPoller[None][source]
This operation migrates a blob container from container level WORM to object level immutability enabled container. Prerequisites require a container level immutability policy either in locked or unlocked state, Account level versioning must be enabled and there should be no Legal hold on the container.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
container_name (str) – The name of the blob container within the specified storage account. Blob container names must be between 3 and 63 characters in length and use numbers, lower-case letters and dash (-) only. Every dash (-) character must be immediately preceded and followed by a letter or number. Required.
- Returns:
An instance of LROPoller that returns either None or the result of cls(response)
- Return type:
LROPoller[None]
- Raises:
- clear_legal_hold(resource_group_name: str, account_name: str, container_name: str, legal_hold: LegalHold | IO[bytes], **kwargs: Any) LegalHold[source]
Clears legal hold tags. Clearing the same or non-existent tag results in an idempotent operation. ClearLegalHold clears out only the specified tags in the request.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
container_name (str) – The name of the blob container within the specified storage account. Blob container names must be between 3 and 63 characters in length and use numbers, lower-case letters and dash (-) only. Every dash (-) character must be immediately preceded and followed by a letter or number. Required.
legal_hold (LegalHold or IO[bytes]) – The LegalHold property that will be clear from a blob container. Is either a LegalHold type or a IO[bytes] type. Required.
- Returns:
LegalHold or the result of cls(response)
- Return type:
- Raises:
- create(resource_group_name: str, account_name: str, container_name: str, blob_container: BlobContainer | IO[bytes], **kwargs: Any) BlobContainer[source]
Creates a new container under the specified account as described by request body. The container resource includes metadata and properties for that container. It does not include a list of the blobs contained by the container.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
container_name (str) – The name of the blob container within the specified storage account. Blob container names must be between 3 and 63 characters in length and use numbers, lower-case letters and dash (-) only. Every dash (-) character must be immediately preceded and followed by a letter or number. Required.
blob_container (BlobContainer or IO[bytes]) – Properties of the blob container to create. Is either a BlobContainer type or a IO[bytes] type. Required.
- Returns:
BlobContainer or the result of cls(response)
- Return type:
- Raises:
- create_or_update_immutability_policy(resource_group_name: str, account_name: str, container_name: str, if_match: str | None = None, parameters: ImmutabilityPolicy | IO[bytes] | None = None, **kwargs: Any) ImmutabilityPolicy[source]
Creates or updates an unlocked immutability policy. ETag in If-Match is honored if given but not required for this operation.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
container_name (str) – The name of the blob container within the specified storage account. Blob container names must be between 3 and 63 characters in length and use numbers, lower-case letters and dash (-) only. Every dash (-) character must be immediately preceded and followed by a letter or number. Required.
if_match (str) – The entity state (ETag) version of the immutability policy to update must be returned to the server for all update operations. The ETag value must include the leading and trailing double quotes as returned by the service. Default value is None.
parameters (ImmutabilityPolicy or IO[bytes]) – The ImmutabilityPolicy Properties that will be created or updated to a blob container. Is either a ImmutabilityPolicy type or a IO[bytes] type. Default value is None.
- Returns:
ImmutabilityPolicy or the result of cls(response)
- Return type:
- Raises:
- delete(resource_group_name: str, account_name: str, container_name: str, **kwargs: Any) None[source]
Deletes specified container under its account.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
container_name (str) – The name of the blob container within the specified storage account. Blob container names must be between 3 and 63 characters in length and use numbers, lower-case letters and dash (-) only. Every dash (-) character must be immediately preceded and followed by a letter or number. Required.
- Returns:
None or the result of cls(response)
- Return type:
None
- Raises:
- delete_immutability_policy(resource_group_name: str, account_name: str, container_name: str, if_match: str, **kwargs: Any) ImmutabilityPolicy[source]
Aborts an unlocked immutability policy. The response of delete has immutabilityPeriodSinceCreationInDays set to 0. ETag in If-Match is required for this operation. Deleting a locked immutability policy is not allowed, the only way is to delete the container after deleting all expired blobs inside the policy locked container.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
container_name (str) – The name of the blob container within the specified storage account. Blob container names must be between 3 and 63 characters in length and use numbers, lower-case letters and dash (-) only. Every dash (-) character must be immediately preceded and followed by a letter or number. Required.
if_match (str) – The entity state (ETag) version of the immutability policy to update must be returned to the server for all update operations. The ETag value must include the leading and trailing double quotes as returned by the service. Required.
- Returns:
ImmutabilityPolicy or the result of cls(response)
- Return type:
- Raises:
- extend_immutability_policy(resource_group_name: str, account_name: str, container_name: str, if_match: str, parameters: ImmutabilityPolicy | IO[bytes] | None = None, **kwargs: Any) ImmutabilityPolicy[source]
Extends the immutabilityPeriodSinceCreationInDays of a locked immutabilityPolicy. The only action allowed on a Locked policy will be this action. ETag in If-Match is required for this operation.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
container_name (str) – The name of the blob container within the specified storage account. Blob container names must be between 3 and 63 characters in length and use numbers, lower-case letters and dash (-) only. Every dash (-) character must be immediately preceded and followed by a letter or number. Required.
if_match (str) – The entity state (ETag) version of the immutability policy to update must be returned to the server for all update operations. The ETag value must include the leading and trailing double quotes as returned by the service. Required.
parameters (ImmutabilityPolicy or IO[bytes]) – The ImmutabilityPolicy Properties that will be extended for a blob container. Is either a ImmutabilityPolicy type or a IO[bytes] type. Default value is None.
- Returns:
ImmutabilityPolicy or the result of cls(response)
- Return type:
- Raises:
- get(resource_group_name: str, account_name: str, container_name: str, **kwargs: Any) BlobContainer[source]
Gets properties of a specified container.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
container_name (str) – The name of the blob container within the specified storage account. Blob container names must be between 3 and 63 characters in length and use numbers, lower-case letters and dash (-) only. Every dash (-) character must be immediately preceded and followed by a letter or number. Required.
- Returns:
BlobContainer or the result of cls(response)
- Return type:
- Raises:
- get_immutability_policy(resource_group_name: str, account_name: str, container_name: str, if_match: str | None = None, **kwargs: Any) ImmutabilityPolicy[source]
Gets the existing immutability policy along with the corresponding ETag in response headers and body.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
container_name (str) – The name of the blob container within the specified storage account. Blob container names must be between 3 and 63 characters in length and use numbers, lower-case letters and dash (-) only. Every dash (-) character must be immediately preceded and followed by a letter or number. Required.
if_match (str) – The entity state (ETag) version of the immutability policy to update must be returned to the server for all update operations. The ETag value must include the leading and trailing double quotes as returned by the service. Default value is None.
- Returns:
ImmutabilityPolicy or the result of cls(response)
- Return type:
- Raises:
- lease(resource_group_name: str, account_name: str, container_name: str, parameters: LeaseContainerRequest | IO[bytes] | None = None, **kwargs: Any) LeaseContainerResponse[source]
The Lease Container operation establishes and manages a lock on a container for delete operations. The lock duration can be 15 to 60 seconds, or can be infinite.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
container_name (str) – The name of the blob container within the specified storage account. Blob container names must be between 3 and 63 characters in length and use numbers, lower-case letters and dash (-) only. Every dash (-) character must be immediately preceded and followed by a letter or number. Required.
parameters (LeaseContainerRequest or IO[bytes]) – Lease Container request body. Is either a LeaseContainerRequest type or a IO[bytes] type. Default value is None.
- Returns:
LeaseContainerResponse or the result of cls(response)
- Return type:
- Raises:
- list(resource_group_name: str, account_name: str, maxpagesize: str | None = None, filter: str | None = None, include: str | ListContainersInclude | None = None, **kwargs: Any) Iterable[ListContainerItem][source]
Lists all containers and does not support a prefix like data plane. Also SRP today does not return continuation token.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
maxpagesize (str) – Optional. Specified maximum number of containers that can be included in the list. Default value is None.
filter (str) – Optional. When specified, only container names starting with the filter will be listed. Default value is None.
include (str or ListContainersInclude) – Optional, used to include the properties for soft deleted blob containers. “deleted” Default value is None.
- Returns:
An iterator like instance of either ListContainerItem or the result of cls(response)
- Return type:
- Raises:
- lock_immutability_policy(resource_group_name: str, account_name: str, container_name: str, if_match: str, **kwargs: Any) ImmutabilityPolicy[source]
Sets the ImmutabilityPolicy to Locked state. The only action allowed on a Locked policy is ExtendImmutabilityPolicy action. ETag in If-Match is required for this operation.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
container_name (str) – The name of the blob container within the specified storage account. Blob container names must be between 3 and 63 characters in length and use numbers, lower-case letters and dash (-) only. Every dash (-) character must be immediately preceded and followed by a letter or number. Required.
if_match (str) – The entity state (ETag) version of the immutability policy to update must be returned to the server for all update operations. The ETag value must include the leading and trailing double quotes as returned by the service. Required.
- Returns:
ImmutabilityPolicy or the result of cls(response)
- Return type:
- Raises:
- set_legal_hold(resource_group_name: str, account_name: str, container_name: str, legal_hold: LegalHold | IO[bytes], **kwargs: Any) LegalHold[source]
Sets legal hold tags. Setting the same tag results in an idempotent operation. SetLegalHold follows an append pattern and does not clear out the existing tags that are not specified in the request.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
container_name (str) – The name of the blob container within the specified storage account. Blob container names must be between 3 and 63 characters in length and use numbers, lower-case letters and dash (-) only. Every dash (-) character must be immediately preceded and followed by a letter or number. Required.
legal_hold (LegalHold or IO[bytes]) – The LegalHold property that will be set to a blob container. Is either a LegalHold type or a IO[bytes] type. Required.
- Returns:
LegalHold or the result of cls(response)
- Return type:
- Raises:
- update(resource_group_name: str, account_name: str, container_name: str, blob_container: BlobContainer | IO[bytes], **kwargs: Any) BlobContainer[source]
Updates container properties as specified in request body. Properties not mentioned in the request will be unchanged. Update fails if the specified container doesn’t already exist.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
container_name (str) – The name of the blob container within the specified storage account. Blob container names must be between 3 and 63 characters in length and use numbers, lower-case letters and dash (-) only. Every dash (-) character must be immediately preceded and followed by a letter or number. Required.
blob_container (BlobContainer or IO[bytes]) – Properties to update for the blob container. Is either a BlobContainer type or a IO[bytes] type. Required.
- Returns:
BlobContainer or the result of cls(response)
- Return type:
- Raises:
- models = <module 'azure.mgmt.storage.v2024_01_01.models' from '/mnt/vss/_work/1/s/sdk/storage/azure-mgmt-storage/.tox/sphinx/lib/python3.13/site-packages/azure/mgmt/storage/v2024_01_01/models/__init__.py'>
- class azure.mgmt.storage.v2024_01_01.operations.BlobInventoryPoliciesOperations(*args, **kwargs)[source]
Bases:
objectWarning
DO NOT instantiate this class directly.
Instead, you should access the following operations through
StorageManagementClient’sblob_inventory_policiesattribute.- create_or_update(resource_group_name: str, account_name: str, blob_inventory_policy_name: str | BlobInventoryPolicyName, properties: BlobInventoryPolicy | IO[bytes], **kwargs: Any) BlobInventoryPolicy[source]
Sets the blob inventory policy to the specified storage account.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
blob_inventory_policy_name (str or BlobInventoryPolicyName) – The name of the storage account blob inventory policy. It should always be ‘default’. “default” Required.
properties (BlobInventoryPolicy or IO[bytes]) – The blob inventory policy set to a storage account. Is either a BlobInventoryPolicy type or a IO[bytes] type. Required.
- Returns:
BlobInventoryPolicy or the result of cls(response)
- Return type:
- Raises:
- delete(resource_group_name: str, account_name: str, blob_inventory_policy_name: str | BlobInventoryPolicyName, **kwargs: Any) None[source]
Deletes the blob inventory policy associated with the specified storage account.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
blob_inventory_policy_name (str or BlobInventoryPolicyName) – The name of the storage account blob inventory policy. It should always be ‘default’. “default” Required.
- Returns:
None or the result of cls(response)
- Return type:
None
- Raises:
- get(resource_group_name: str, account_name: str, blob_inventory_policy_name: str | BlobInventoryPolicyName, **kwargs: Any) BlobInventoryPolicy[source]
Gets the blob inventory policy associated with the specified storage account.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
blob_inventory_policy_name (str or BlobInventoryPolicyName) – The name of the storage account blob inventory policy. It should always be ‘default’. “default” Required.
- Returns:
BlobInventoryPolicy or the result of cls(response)
- Return type:
- Raises:
- list(resource_group_name: str, account_name: str, **kwargs: Any) Iterable[BlobInventoryPolicy][source]
Gets the blob inventory policy associated with the specified storage account.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
- Returns:
An iterator like instance of either BlobInventoryPolicy or the result of cls(response)
- Return type:
- Raises:
- models = <module 'azure.mgmt.storage.v2024_01_01.models' from '/mnt/vss/_work/1/s/sdk/storage/azure-mgmt-storage/.tox/sphinx/lib/python3.13/site-packages/azure/mgmt/storage/v2024_01_01/models/__init__.py'>
- class azure.mgmt.storage.v2024_01_01.operations.BlobServicesOperations(*args, **kwargs)[source]
Bases:
objectWarning
DO NOT instantiate this class directly.
Instead, you should access the following operations through
StorageManagementClient’sblob_servicesattribute.- get_service_properties(resource_group_name: str, account_name: str, **kwargs: Any) BlobServiceProperties[source]
Gets the properties of a storage account’s Blob service, including properties for Storage Analytics and CORS (Cross-Origin Resource Sharing) rules.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
- Returns:
BlobServiceProperties or the result of cls(response)
- Return type:
- Raises:
- list(resource_group_name: str, account_name: str, **kwargs: Any) Iterable[BlobServiceProperties][source]
List blob services of storage account. It returns a collection of one object named default.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
- Returns:
An iterator like instance of either BlobServiceProperties or the result of cls(response)
- Return type:
- Raises:
- set_service_properties(resource_group_name: str, account_name: str, parameters: BlobServiceProperties | IO[bytes], **kwargs: Any) BlobServiceProperties[source]
Sets the properties of a storage account’s Blob service, including properties for Storage Analytics and CORS (Cross-Origin Resource Sharing) rules.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
parameters (BlobServiceProperties or IO[bytes]) – The properties of a storage account’s Blob service, including properties for Storage Analytics and CORS (Cross-Origin Resource Sharing) rules. Is either a BlobServiceProperties type or a IO[bytes] type. Required.
- Returns:
BlobServiceProperties or the result of cls(response)
- Return type:
- Raises:
- models = <module 'azure.mgmt.storage.v2024_01_01.models' from '/mnt/vss/_work/1/s/sdk/storage/azure-mgmt-storage/.tox/sphinx/lib/python3.13/site-packages/azure/mgmt/storage/v2024_01_01/models/__init__.py'>
- class azure.mgmt.storage.v2024_01_01.operations.DeletedAccountsOperations(*args, **kwargs)[source]
Bases:
objectWarning
DO NOT instantiate this class directly.
Instead, you should access the following operations through
StorageManagementClient’sdeleted_accountsattribute.- get(deleted_account_name: str, location: str, **kwargs: Any) DeletedAccount[source]
Get properties of specified deleted account resource.
- Parameters:
- Returns:
DeletedAccount or the result of cls(response)
- Return type:
- Raises:
- list(**kwargs: Any) Iterable[DeletedAccount][source]
Lists deleted accounts under the subscription.
- Returns:
An iterator like instance of either DeletedAccount or the result of cls(response)
- Return type:
- Raises:
- models = <module 'azure.mgmt.storage.v2024_01_01.models' from '/mnt/vss/_work/1/s/sdk/storage/azure-mgmt-storage/.tox/sphinx/lib/python3.13/site-packages/azure/mgmt/storage/v2024_01_01/models/__init__.py'>
- class azure.mgmt.storage.v2024_01_01.operations.EncryptionScopesOperations(*args, **kwargs)[source]
Bases:
objectWarning
DO NOT instantiate this class directly.
Instead, you should access the following operations through
StorageManagementClient’sencryption_scopesattribute.- get(resource_group_name: str, account_name: str, encryption_scope_name: str, **kwargs: Any) EncryptionScope[source]
Returns the properties for the specified encryption scope.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
encryption_scope_name (str) – The name of the encryption scope within the specified storage account. Encryption scope names must be between 3 and 63 characters in length and use numbers, lower-case letters and dash (-) only. Every dash (-) character must be immediately preceded and followed by a letter or number. Required.
- Returns:
EncryptionScope or the result of cls(response)
- Return type:
- Raises:
- list(resource_group_name: str, account_name: str, maxpagesize: int | None = None, filter: str | None = None, include: str | ListEncryptionScopesInclude | None = None, **kwargs: Any) Iterable[EncryptionScope][source]
Lists all the encryption scopes available under the specified storage account.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
maxpagesize (int) – Optional, specifies the maximum number of encryption scopes that will be included in the list response. Default value is None.
filter (str) – Optional. When specified, only encryption scope names starting with the filter will be listed. Default value is None.
include (str or ListEncryptionScopesInclude) – 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.
- Returns:
An iterator like instance of either EncryptionScope or the result of cls(response)
- Return type:
- Raises:
- patch(resource_group_name: str, account_name: str, encryption_scope_name: str, encryption_scope: EncryptionScope | IO[bytes], **kwargs: Any) EncryptionScope[source]
Update encryption scope properties as specified in the request body. Update fails if the specified encryption scope does not already exist.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
encryption_scope_name (str) – The name of the encryption scope within the specified storage account. Encryption scope names must be between 3 and 63 characters in length and use numbers, lower-case letters and dash (-) only. Every dash (-) character must be immediately preceded and followed by a letter or number. Required.
encryption_scope (EncryptionScope or IO[bytes]) – Encryption scope properties to be used for the update. Is either a EncryptionScope type or a IO[bytes] type. Required.
- Returns:
EncryptionScope or the result of cls(response)
- Return type:
- Raises:
- put(resource_group_name: str, account_name: str, encryption_scope_name: str, encryption_scope: EncryptionScope | IO[bytes], **kwargs: Any) EncryptionScope[source]
Synchronously creates or updates an encryption scope under the specified storage account. If an encryption scope is already created and a subsequent request is issued with different properties, the encryption scope properties will be updated per the specified request.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
encryption_scope_name (str) – The name of the encryption scope within the specified storage account. Encryption scope names must be between 3 and 63 characters in length and use numbers, lower-case letters and dash (-) only. Every dash (-) character must be immediately preceded and followed by a letter or number. Required.
encryption_scope (EncryptionScope or IO[bytes]) – Encryption scope properties to be used for the create or update. Is either a EncryptionScope type or a IO[bytes] type. Required.
- Returns:
EncryptionScope or the result of cls(response)
- Return type:
- Raises:
- models = <module 'azure.mgmt.storage.v2024_01_01.models' from '/mnt/vss/_work/1/s/sdk/storage/azure-mgmt-storage/.tox/sphinx/lib/python3.13/site-packages/azure/mgmt/storage/v2024_01_01/models/__init__.py'>
- class azure.mgmt.storage.v2024_01_01.operations.FileServicesOperations(*args, **kwargs)[source]
Bases:
objectWarning
DO NOT instantiate this class directly.
Instead, you should access the following operations through
StorageManagementClient’sfile_servicesattribute.- get_service_properties(resource_group_name: str, account_name: str, **kwargs: Any) FileServiceProperties[source]
Gets the properties of file services in storage accounts, including CORS (Cross-Origin Resource Sharing) rules.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
- Returns:
FileServiceProperties or the result of cls(response)
- Return type:
- Raises:
- get_service_usage(resource_group_name: str, account_name: str, **kwargs: Any) FileServiceUsage[source]
Gets the usage of file service in storage account including account limits, file share limits and constants used in recommendations and bursting formula.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
- Returns:
FileServiceUsage or the result of cls(response)
- Return type:
- Raises:
- list(resource_group_name: str, account_name: str, **kwargs: Any) FileServiceItems[source]
List all file services in storage accounts.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
- Returns:
FileServiceItems or the result of cls(response)
- Return type:
- Raises:
- list_service_usages(resource_group_name: str, account_name: str, maxpagesize: int | None = None, **kwargs: Any) Iterable[FileServiceUsage][source]
Gets the usages of file service in storage account.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
maxpagesize (int) – Optional, specifies the maximum number of file service usages to be included in the list response. Default value is None.
- Returns:
An iterator like instance of either FileServiceUsage or the result of cls(response)
- Return type:
- Raises:
- set_service_properties(resource_group_name: str, account_name: str, parameters: FileServiceProperties | IO[bytes], **kwargs: Any) FileServiceProperties[source]
Sets the properties of file services in storage accounts, including CORS (Cross-Origin Resource Sharing) rules.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
parameters (FileServiceProperties or IO[bytes]) – 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.
- Returns:
FileServiceProperties or the result of cls(response)
- Return type:
- Raises:
- models = <module 'azure.mgmt.storage.v2024_01_01.models' from '/mnt/vss/_work/1/s/sdk/storage/azure-mgmt-storage/.tox/sphinx/lib/python3.13/site-packages/azure/mgmt/storage/v2024_01_01/models/__init__.py'>
Bases:
objectWarning
DO NOT instantiate this class directly.
Instead, you should access the following operations through
StorageManagementClient’sfile_sharesattribute.Creates a new share under the specified account as described by request body. The share resource includes metadata and properties for that share. It does not include a list of the files contained by the share.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
share_name (str) – The name of the file share within the specified storage account. File share names must be between 3 and 63 characters in length and use numbers, lower-case letters and dash (-) only. Every dash (-) character must be immediately preceded and followed by a letter or number. Required.
file_share (FileShare or IO[bytes]) – Properties of the file share to create. Is either a FileShare type or a IO[bytes] type. Required.
expand (str) – Optional, used to expand the properties within share’s properties. Valid values are: snapshots. Should be passed as a string with delimiter ‘,’. Default value is None.
- Returns:
FileShare or the result of cls(response)
- Return type:
- Raises:
Deletes specified share under its account.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
share_name (str) – The name of the file share within the specified storage account. File share names must be between 3 and 63 characters in length and use numbers, lower-case letters and dash (-) only. Every dash (-) character must be immediately preceded and followed by a letter or number. Required.
x_ms_snapshot (str) – Optional, used to delete a snapshot. Default value is None.
include (str) – Optional. Valid values are: snapshots, leased-snapshots, none. The default value is snapshots. For ‘snapshots’, the file share is deleted including all of its file share snapshots. If the file share contains leased-snapshots, the deletion fails. For ‘leased-snapshots’, the file share is deleted included all of its file share snapshots (leased/unleased). For ‘none’, the file share is deleted if it has no share snapshots. If the file share contains any snapshots (leased or unleased), the deletion fails. Default value is None.
- Returns:
None or the result of cls(response)
- Return type:
None
- Raises:
Gets properties of a specified share.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
share_name (str) – The name of the file share within the specified storage account. File share names must be between 3 and 63 characters in length and use numbers, lower-case letters and dash (-) only. Every dash (-) character must be immediately preceded and followed by a letter or number. Required.
expand (str) – Optional, used to expand the properties within share’s properties. Valid values are: stats. Should be passed as a string with delimiter ‘,’. Default value is None.
x_ms_snapshot (str) – Optional, used to retrieve properties of a snapshot. Default value is None.
- Returns:
FileShare or the result of cls(response)
- Return type:
- Raises:
The Lease Share operation establishes and manages a lock on a share for delete operations. The lock duration can be 15 to 60 seconds, or can be infinite.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
share_name (str) – The name of the file share within the specified storage account. File share names must be between 3 and 63 characters in length and use numbers, lower-case letters and dash (-) only. Every dash (-) character must be immediately preceded and followed by a letter or number. Required.
x_ms_snapshot (str) – Optional. Specify the snapshot time to lease a snapshot. Default value is None.
parameters (LeaseShareRequest or IO[bytes]) – Lease Share request body. Is either a LeaseShareRequest type or a IO[bytes] type. Default value is None.
- Returns:
LeaseShareResponse or the result of cls(response)
- Return type:
- Raises:
Lists all shares.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
maxpagesize (str) – Optional. Specified maximum number of shares that can be included in the list. Default value is None.
filter (str) – Optional. When specified, only share names starting with the filter will be listed. Default value is None.
expand (str) – Optional, used to expand the properties within share’s properties. Valid values are: deleted, snapshots. Should be passed as a string with delimiter ‘,’. Default value is None.
- Returns:
An iterator like instance of either FileShareItem or the result of cls(response)
- Return type:
- Raises:
Restore a file share within a valid retention days if share soft delete is enabled.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
share_name (str) – The name of the file share within the specified storage account. File share names must be between 3 and 63 characters in length and use numbers, lower-case letters and dash (-) only. Every dash (-) character must be immediately preceded and followed by a letter or number. Required.
deleted_share (DeletedShare or IO[bytes]) – Is either a DeletedShare type or a IO[bytes] type. Required.
- Returns:
None or the result of cls(response)
- Return type:
None
- Raises:
Updates share properties as specified in request body. Properties not mentioned in the request will not be changed. Update fails if the specified share does not already exist.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
share_name (str) – The name of the file share within the specified storage account. File share names must be between 3 and 63 characters in length and use numbers, lower-case letters and dash (-) only. Every dash (-) character must be immediately preceded and followed by a letter or number. Required.
file_share (FileShare or IO[bytes]) – Properties to update for the file share. Is either a FileShare type or a IO[bytes] type. Required.
- Returns:
FileShare or the result of cls(response)
- Return type:
- Raises:
- class azure.mgmt.storage.v2024_01_01.operations.LocalUsersOperations(*args, **kwargs)[source]
Bases:
objectWarning
DO NOT instantiate this class directly.
Instead, you should access the following operations through
StorageManagementClient’slocal_usersattribute.- create_or_update(resource_group_name: str, account_name: str, username: str, properties: LocalUser | IO[bytes], **kwargs: Any) LocalUser[source]
Create or update the properties of a local user associated with the storage account. Properties for NFSv3 enablement and extended groups cannot be set with other properties.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
username (str) – The name of local user. The username must contain lowercase letters and numbers only. It must be unique only within the storage account. Required.
properties (LocalUser or IO[bytes]) – The local user associated with a storage account. Is either a LocalUser type or a IO[bytes] type. Required.
- Returns:
LocalUser or the result of cls(response)
- Return type:
- Raises:
- delete(resource_group_name: str, account_name: str, username: str, **kwargs: Any) None[source]
Deletes the local user associated with the specified storage account.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
username (str) – The name of local user. The username must contain lowercase letters and numbers only. It must be unique only within the storage account. Required.
- Returns:
None or the result of cls(response)
- Return type:
None
- Raises:
- get(resource_group_name: str, account_name: str, username: str, **kwargs: Any) LocalUser[source]
Get the local user of the storage account by username.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
username (str) – The name of local user. The username must contain lowercase letters and numbers only. It must be unique only within the storage account. Required.
- Returns:
LocalUser or the result of cls(response)
- Return type:
- Raises:
- list(resource_group_name: str, account_name: str, maxpagesize: int | None = None, filter: str | None = None, include: str | ListLocalUserIncludeParam | None = None, **kwargs: Any) Iterable[LocalUser][source]
List the local users associated with the storage account.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
maxpagesize (int) – Optional, specifies the maximum number of local users that will be included in the list response. Default value is None.
filter (str) – Optional. When specified, only local user names starting with the filter will be listed. Default value is None.
include (str or ListLocalUserIncludeParam) – Optional, when specified, will list local users enabled for the specific protocol. Lists all users by default. “nfsv3” Default value is None.
- Returns:
An iterator like instance of either LocalUser or the result of cls(response)
- Return type:
- Raises:
- list_keys(resource_group_name: str, account_name: str, username: str, **kwargs: Any) LocalUserKeys[source]
List SSH authorized keys and shared key of the local user.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
username (str) – The name of local user. The username must contain lowercase letters and numbers only. It must be unique only within the storage account. Required.
- Returns:
LocalUserKeys or the result of cls(response)
- Return type:
- Raises:
- regenerate_password(resource_group_name: str, account_name: str, username: str, **kwargs: Any) LocalUserRegeneratePasswordResult[source]
Regenerate the local user SSH password.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
username (str) – The name of local user. The username must contain lowercase letters and numbers only. It must be unique only within the storage account. Required.
- Returns:
LocalUserRegeneratePasswordResult or the result of cls(response)
- Return type:
- Raises:
- models = <module 'azure.mgmt.storage.v2024_01_01.models' from '/mnt/vss/_work/1/s/sdk/storage/azure-mgmt-storage/.tox/sphinx/lib/python3.13/site-packages/azure/mgmt/storage/v2024_01_01/models/__init__.py'>
- class azure.mgmt.storage.v2024_01_01.operations.ManagementPoliciesOperations(*args, **kwargs)[source]
Bases:
objectWarning
DO NOT instantiate this class directly.
Instead, you should access the following operations through
StorageManagementClient’smanagement_policiesattribute.- create_or_update(resource_group_name: str, account_name: str, management_policy_name: str | ManagementPolicyName, properties: ManagementPolicy | IO[bytes], **kwargs: Any) ManagementPolicy[source]
Sets the managementpolicy to the specified storage account.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
management_policy_name (str or ManagementPolicyName) – The name of the Storage Account Management Policy. It should always be ‘default’. “default” Required.
properties (ManagementPolicy or IO[bytes]) – The ManagementPolicy set to a storage account. Is either a ManagementPolicy type or a IO[bytes] type. Required.
- Returns:
ManagementPolicy or the result of cls(response)
- Return type:
- Raises:
- delete(resource_group_name: str, account_name: str, management_policy_name: str | ManagementPolicyName, **kwargs: Any) None[source]
Deletes the managementpolicy associated with the specified storage account.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
management_policy_name (str or ManagementPolicyName) – The name of the Storage Account Management Policy. It should always be ‘default’. “default” Required.
- Returns:
None or the result of cls(response)
- Return type:
None
- Raises:
- get(resource_group_name: str, account_name: str, management_policy_name: str | ManagementPolicyName, **kwargs: Any) ManagementPolicy[source]
Gets the managementpolicy associated with the specified storage account.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
management_policy_name (str or ManagementPolicyName) – The name of the Storage Account Management Policy. It should always be ‘default’. “default” Required.
- Returns:
ManagementPolicy or the result of cls(response)
- Return type:
- Raises:
- models = <module 'azure.mgmt.storage.v2024_01_01.models' from '/mnt/vss/_work/1/s/sdk/storage/azure-mgmt-storage/.tox/sphinx/lib/python3.13/site-packages/azure/mgmt/storage/v2024_01_01/models/__init__.py'>
- class azure.mgmt.storage.v2024_01_01.operations.NetworkSecurityPerimeterConfigurationsOperations(*args, **kwargs)[source]
Bases:
objectWarning
DO NOT instantiate this class directly.
Instead, you should access the following operations through
StorageManagementClient’snetwork_security_perimeter_configurationsattribute.- begin_reconcile(resource_group_name: str, account_name: str, network_security_perimeter_configuration_name: str, **kwargs: Any) LROPoller[None][source]
Refreshes any information about the association.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
network_security_perimeter_configuration_name (str) – The name for Network Security Perimeter configuration. Required.
- Returns:
An instance of LROPoller that returns either None or the result of cls(response)
- Return type:
LROPoller[None]
- Raises:
- get(resource_group_name: str, account_name: str, network_security_perimeter_configuration_name: str, **kwargs: Any) NetworkSecurityPerimeterConfiguration[source]
Gets effective NetworkSecurityPerimeterConfiguration for association.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
network_security_perimeter_configuration_name (str) – The name for Network Security Perimeter configuration. Required.
- Returns:
NetworkSecurityPerimeterConfiguration or the result of cls(response)
- Return type:
- Raises:
- list(resource_group_name: str, account_name: str, **kwargs: Any) Iterable[NetworkSecurityPerimeterConfiguration][source]
Gets list of effective NetworkSecurityPerimeterConfiguration for storage account.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
- Returns:
An iterator like instance of either NetworkSecurityPerimeterConfiguration or the result of cls(response)
- Return type:
- Raises:
- models = <module 'azure.mgmt.storage.v2024_01_01.models' from '/mnt/vss/_work/1/s/sdk/storage/azure-mgmt-storage/.tox/sphinx/lib/python3.13/site-packages/azure/mgmt/storage/v2024_01_01/models/__init__.py'>
- class azure.mgmt.storage.v2024_01_01.operations.ObjectReplicationPoliciesOperations(*args, **kwargs)[source]
Bases:
objectWarning
DO NOT instantiate this class directly.
Instead, you should access the following operations through
StorageManagementClient’sobject_replication_policiesattribute.- create_or_update(resource_group_name: str, account_name: str, object_replication_policy_id: str, properties: ObjectReplicationPolicy | IO[bytes], **kwargs: Any) ObjectReplicationPolicy[source]
Create or update the object replication policy of the storage account.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
object_replication_policy_id (str) – For the destination account, provide the value ‘default’. Configure the policy on the destination account first. For the source account, provide the value of the policy ID that is returned when you download the policy that was defined on the destination account. The policy is downloaded as a JSON file. Required.
properties (ObjectReplicationPolicy or IO[bytes]) – The object replication policy set to a storage account. A unique policy ID will be created if absent. Is either a ObjectReplicationPolicy type or a IO[bytes] type. Required.
- Returns:
ObjectReplicationPolicy or the result of cls(response)
- Return type:
- Raises:
- delete(resource_group_name: str, account_name: str, object_replication_policy_id: str, **kwargs: Any) None[source]
Deletes the object replication policy associated with the specified storage account.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
object_replication_policy_id (str) – For the destination account, provide the value ‘default’. Configure the policy on the destination account first. For the source account, provide the value of the policy ID that is returned when you download the policy that was defined on the destination account. The policy is downloaded as a JSON file. Required.
- Returns:
None or the result of cls(response)
- Return type:
None
- Raises:
- get(resource_group_name: str, account_name: str, object_replication_policy_id: str, **kwargs: Any) ObjectReplicationPolicy[source]
Get the object replication policy of the storage account by policy ID.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
object_replication_policy_id (str) – For the destination account, provide the value ‘default’. Configure the policy on the destination account first. For the source account, provide the value of the policy ID that is returned when you download the policy that was defined on the destination account. The policy is downloaded as a JSON file. Required.
- Returns:
ObjectReplicationPolicy or the result of cls(response)
- Return type:
- Raises:
- list(resource_group_name: str, account_name: str, **kwargs: Any) Iterable[ObjectReplicationPolicy][source]
List the object replication policies associated with the storage account.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
- Returns:
An iterator like instance of either ObjectReplicationPolicy or the result of cls(response)
- Return type:
- Raises:
- models = <module 'azure.mgmt.storage.v2024_01_01.models' from '/mnt/vss/_work/1/s/sdk/storage/azure-mgmt-storage/.tox/sphinx/lib/python3.13/site-packages/azure/mgmt/storage/v2024_01_01/models/__init__.py'>
- class azure.mgmt.storage.v2024_01_01.operations.Operations(*args, **kwargs)[source]
Bases:
objectWarning
DO NOT instantiate this class directly.
Instead, you should access the following operations through
StorageManagementClient’soperationsattribute.- list(**kwargs: Any) Iterable[Operation][source]
Lists all of the available Storage Rest API operations.
- Returns:
An iterator like instance of either Operation or the result of cls(response)
- Return type:
- Raises:
- models = <module 'azure.mgmt.storage.v2024_01_01.models' from '/mnt/vss/_work/1/s/sdk/storage/azure-mgmt-storage/.tox/sphinx/lib/python3.13/site-packages/azure/mgmt/storage/v2024_01_01/models/__init__.py'>
- class azure.mgmt.storage.v2024_01_01.operations.PrivateEndpointConnectionsOperations(*args, **kwargs)[source]
Bases:
objectWarning
DO NOT instantiate this class directly.
Instead, you should access the following operations through
StorageManagementClient’sprivate_endpoint_connectionsattribute.- delete(resource_group_name: str, account_name: str, private_endpoint_connection_name: str, **kwargs: Any) None[source]
Deletes the specified private endpoint connection associated with the storage account.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
private_endpoint_connection_name (str) – The name of the private endpoint connection associated with the Azure resource. Required.
- Returns:
None or the result of cls(response)
- Return type:
None
- Raises:
- get(resource_group_name: str, account_name: str, private_endpoint_connection_name: str, **kwargs: Any) PrivateEndpointConnection[source]
Gets the specified private endpoint connection associated with the storage account.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
private_endpoint_connection_name (str) – The name of the private endpoint connection associated with the Azure resource. Required.
- Returns:
PrivateEndpointConnection or the result of cls(response)
- Return type:
- Raises:
- list(resource_group_name: str, account_name: str, **kwargs: Any) Iterable[PrivateEndpointConnection][source]
List all the private endpoint connections associated with the storage account.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
- Returns:
An iterator like instance of either PrivateEndpointConnection or the result of cls(response)
- Return type:
- Raises:
- put(resource_group_name: str, account_name: str, private_endpoint_connection_name: str, properties: PrivateEndpointConnection | IO[bytes], **kwargs: Any) PrivateEndpointConnection[source]
Update the state of specified private endpoint connection associated with the storage account.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
private_endpoint_connection_name (str) – The name of the private endpoint connection associated with the Azure resource. Required.
properties (PrivateEndpointConnection or IO[bytes]) – The private endpoint connection properties. Is either a PrivateEndpointConnection type or a IO[bytes] type. Required.
- Returns:
PrivateEndpointConnection or the result of cls(response)
- Return type:
- Raises:
- models = <module 'azure.mgmt.storage.v2024_01_01.models' from '/mnt/vss/_work/1/s/sdk/storage/azure-mgmt-storage/.tox/sphinx/lib/python3.13/site-packages/azure/mgmt/storage/v2024_01_01/models/__init__.py'>
- class azure.mgmt.storage.v2024_01_01.operations.PrivateLinkResourcesOperations(*args, **kwargs)[source]
Bases:
objectWarning
DO NOT instantiate this class directly.
Instead, you should access the following operations through
StorageManagementClient’sprivate_link_resourcesattribute.- list_by_storage_account(resource_group_name: str, account_name: str, **kwargs: Any) PrivateLinkResourceListResult[source]
Gets the private link resources that need to be created for a storage account.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
- Returns:
PrivateLinkResourceListResult or the result of cls(response)
- Return type:
- Raises:
- models = <module 'azure.mgmt.storage.v2024_01_01.models' from '/mnt/vss/_work/1/s/sdk/storage/azure-mgmt-storage/.tox/sphinx/lib/python3.13/site-packages/azure/mgmt/storage/v2024_01_01/models/__init__.py'>
- class azure.mgmt.storage.v2024_01_01.operations.QueueOperations(*args, **kwargs)[source]
Bases:
objectWarning
DO NOT instantiate this class directly.
Instead, you should access the following operations through
StorageManagementClient’squeueattribute.- create(resource_group_name: str, account_name: str, queue_name: str, queue: StorageQueue | IO[bytes], **kwargs: Any) StorageQueue[source]
Creates a new queue with the specified queue name, under the specified account.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
queue_name (str) – A queue name must be unique within a storage account and must be between 3 and 63 characters.The name must comprise of lowercase alphanumeric and dash(-) characters only, it should begin and end with an alphanumeric character and it cannot have two consecutive dash(-) characters. Required.
queue (StorageQueue or IO[bytes]) – Queue properties and metadata to be created with. Is either a StorageQueue type or a IO[bytes] type. Required.
- Returns:
StorageQueue or the result of cls(response)
- Return type:
- Raises:
- delete(resource_group_name: str, account_name: str, queue_name: str, **kwargs: Any) None[source]
Deletes the queue with the specified queue name, under the specified account if it exists.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
queue_name (str) – A queue name must be unique within a storage account and must be between 3 and 63 characters.The name must comprise of lowercase alphanumeric and dash(-) characters only, it should begin and end with an alphanumeric character and it cannot have two consecutive dash(-) characters. Required.
- Returns:
None or the result of cls(response)
- Return type:
None
- Raises:
- get(resource_group_name: str, account_name: str, queue_name: str, **kwargs: Any) StorageQueue[source]
Gets the queue with the specified queue name, under the specified account if it exists.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
queue_name (str) – A queue name must be unique within a storage account and must be between 3 and 63 characters.The name must comprise of lowercase alphanumeric and dash(-) characters only, it should begin and end with an alphanumeric character and it cannot have two consecutive dash(-) characters. Required.
- Returns:
StorageQueue or the result of cls(response)
- Return type:
- Raises:
- list(resource_group_name: str, account_name: str, maxpagesize: str | None = None, filter: str | None = None, **kwargs: Any) Iterable[ListQueue][source]
Gets a list of all the queues under the specified storage account.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
maxpagesize (str) – Optional, a maximum number of queues that should be included in a list queue response. Default value is None.
filter (str) – Optional, When specified, only the queues with a name starting with the given filter will be listed. Default value is None.
- Returns:
An iterator like instance of either ListQueue or the result of cls(response)
- Return type:
- Raises:
- update(resource_group_name: str, account_name: str, queue_name: str, queue: StorageQueue | IO[bytes], **kwargs: Any) StorageQueue[source]
Creates a new queue with the specified queue name, under the specified account.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
queue_name (str) – A queue name must be unique within a storage account and must be between 3 and 63 characters.The name must comprise of lowercase alphanumeric and dash(-) characters only, it should begin and end with an alphanumeric character and it cannot have two consecutive dash(-) characters. Required.
queue (StorageQueue or IO[bytes]) – Queue properties and metadata to be created with. Is either a StorageQueue type or a IO[bytes] type. Required.
- Returns:
StorageQueue or the result of cls(response)
- Return type:
- Raises:
- models = <module 'azure.mgmt.storage.v2024_01_01.models' from '/mnt/vss/_work/1/s/sdk/storage/azure-mgmt-storage/.tox/sphinx/lib/python3.13/site-packages/azure/mgmt/storage/v2024_01_01/models/__init__.py'>
- class azure.mgmt.storage.v2024_01_01.operations.QueueServicesOperations(*args, **kwargs)[source]
Bases:
objectWarning
DO NOT instantiate this class directly.
Instead, you should access the following operations through
StorageManagementClient’squeue_servicesattribute.- get_service_properties(resource_group_name: str, account_name: str, **kwargs: Any) QueueServiceProperties[source]
Gets the properties of a storage account’s Queue service, including properties for Storage Analytics and CORS (Cross-Origin Resource Sharing) rules.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
- Returns:
QueueServiceProperties or the result of cls(response)
- Return type:
- Raises:
- list(resource_group_name: str, account_name: str, **kwargs: Any) ListQueueServices[source]
List all queue services for the storage account.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
- Returns:
ListQueueServices or the result of cls(response)
- Return type:
- Raises:
- set_service_properties(resource_group_name: str, account_name: str, parameters: QueueServiceProperties | IO[bytes], **kwargs: Any) QueueServiceProperties[source]
Sets the properties of a storage account’s Queue service, including properties for Storage Analytics and CORS (Cross-Origin Resource Sharing) rules.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
parameters (QueueServiceProperties or IO[bytes]) – The properties of a storage account’s Queue service, only properties for Storage Analytics and CORS (Cross-Origin Resource Sharing) rules can be specified. Is either a QueueServiceProperties type or a IO[bytes] type. Required.
- Returns:
QueueServiceProperties or the result of cls(response)
- Return type:
- Raises:
- models = <module 'azure.mgmt.storage.v2024_01_01.models' from '/mnt/vss/_work/1/s/sdk/storage/azure-mgmt-storage/.tox/sphinx/lib/python3.13/site-packages/azure/mgmt/storage/v2024_01_01/models/__init__.py'>
- class azure.mgmt.storage.v2024_01_01.operations.SkusOperations(*args, **kwargs)[source]
Bases:
objectWarning
DO NOT instantiate this class directly.
Instead, you should access the following operations through
StorageManagementClient’sskusattribute.- list(**kwargs: Any) Iterable[SkuInformation][source]
Lists the available SKUs supported by Microsoft.Storage for given subscription.
- Returns:
An iterator like instance of either SkuInformation or the result of cls(response)
- Return type:
- Raises:
- models = <module 'azure.mgmt.storage.v2024_01_01.models' from '/mnt/vss/_work/1/s/sdk/storage/azure-mgmt-storage/.tox/sphinx/lib/python3.13/site-packages/azure/mgmt/storage/v2024_01_01/models/__init__.py'>
- class azure.mgmt.storage.v2024_01_01.operations.StorageAccountsOperations(*args, **kwargs)[source]
Bases:
objectWarning
DO NOT instantiate this class directly.
Instead, you should access the following operations through
StorageManagementClient’sstorage_accountsattribute.- begin_abort_hierarchical_namespace_migration(resource_group_name: str, account_name: str, **kwargs: Any) LROPoller[None][source]
Abort live Migration of storage account to enable Hns.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
- Returns:
An instance of LROPoller that returns either None or the result of cls(response)
- Return type:
LROPoller[None]
- Raises:
- begin_create(resource_group_name: str, account_name: str, parameters: StorageAccountCreateParameters | IO[bytes], **kwargs: Any) LROPoller[StorageAccount][source]
Asynchronously creates a new storage account with the specified parameters. If an account is already created and a subsequent create request is issued with different properties, the account properties will be updated. If an account is already created and a subsequent create or update request is issued with the exact same set of properties, the request will succeed.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
parameters (StorageAccountCreateParameters or IO[bytes]) – The parameters to provide for the created account. Is either a StorageAccountCreateParameters type or a IO[bytes] type. Required.
- Returns:
An instance of LROPoller that returns either StorageAccount or the result of cls(response)
- Return type:
- Raises:
- begin_customer_initiated_migration(resource_group_name: str, account_name: str, parameters: StorageAccountMigration | IO[bytes], **kwargs: Any) LROPoller[None][source]
Account Migration request can be triggered for a storage account to change its redundancy level. The migration updates the non-zonal redundant storage account to a zonal redundant account or vice-versa in order to have better reliability and availability. Zone-redundant storage (ZRS) replicates your storage account synchronously across three Azure availability zones in the primary region.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
parameters (StorageAccountMigration or IO[bytes]) – The request parameters required to perform storage account migration. Is either a StorageAccountMigration type or a IO[bytes] type. Required.
- Returns:
An instance of LROPoller that returns either None or the result of cls(response)
- Return type:
LROPoller[None]
- Raises:
- begin_failover(resource_group_name: str, account_name: str, failover_type: Literal['Planned'] = 'Planned', **kwargs: Any) LROPoller[None][source]
A failover request can be triggered for a storage account in the event a primary endpoint becomes unavailable for any reason. The failover occurs from the storage account’s primary cluster to the secondary cluster for RA-GRS accounts. The secondary cluster will become primary after failover and the account is converted to LRS. In the case of a Planned Failover, the primary and secondary clusters are swapped after failover and the account remains geo-replicated. Failover should continue to be used in the event of availability issues as Planned failover is only available while the primary and secondary endpoints are available. The primary use case of a Planned Failover is disaster recovery testing drills. This type of failover is invoked by setting FailoverType parameter to ‘Planned’. Learn more about the failover options here- https://learn.microsoft.com/azure/storage/common/storage-disaster-recovery-guidance.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
failover_type (str) – The parameter is set to ‘Planned’ to indicate whether a Planned failover is requested. Known values are “Planned” and None. Default value is “Planned”.
- Returns:
An instance of LROPoller that returns either None or the result of cls(response)
- Return type:
LROPoller[None]
- Raises:
- begin_hierarchical_namespace_migration(resource_group_name: str, account_name: str, request_type: str, **kwargs: Any) LROPoller[None][source]
Live Migration of storage account to enable Hns.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
request_type (str) – Required. Hierarchical namespace migration type can either be a hierarchical namespace validation request ‘HnsOnValidationRequest’ or a hydration request ‘HnsOnHydrationRequest’. The validation request will validate the migration whereas the hydration request will migrate the account. Required.
- Returns:
An instance of LROPoller that returns either None or the result of cls(response)
- Return type:
LROPoller[None]
- Raises:
- begin_restore_blob_ranges(resource_group_name: str, account_name: str, parameters: BlobRestoreParameters | IO[bytes], **kwargs: Any) LROPoller[BlobRestoreStatus][source]
Restore blobs in the specified blob ranges.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
parameters (BlobRestoreParameters or IO[bytes]) – The parameters to provide for restore blob ranges. Is either a BlobRestoreParameters type or a IO[bytes] type. Required.
- Returns:
An instance of LROPoller that returns either BlobRestoreStatus or the result of cls(response)
- Return type:
- Raises:
- check_name_availability(account_name: StorageAccountCheckNameAvailabilityParameters | IO[bytes], **kwargs: Any) CheckNameAvailabilityResult[source]
Checks that the storage account name is valid and is not already in use.
- Parameters:
account_name (StorageAccountCheckNameAvailabilityParameters or IO[bytes]) – 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. Is either a StorageAccountCheckNameAvailabilityParameters type or a IO[bytes] type. Required.
- Returns:
CheckNameAvailabilityResult or the result of cls(response)
- Return type:
- Raises:
- delete(resource_group_name: str, account_name: str, **kwargs: Any) None[source]
Deletes a storage account in Microsoft Azure.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
- Returns:
None or the result of cls(response)
- Return type:
None
- Raises:
- get_customer_initiated_migration(resource_group_name: str, account_name: str, migration_name: str | MigrationName, **kwargs: Any) StorageAccountMigration[source]
Gets the status of the ongoing migration for the specified storage account.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
migration_name (str or MigrationName) – The name of the Storage Account Migration. It should always be ‘default’. “default” Required.
- Returns:
StorageAccountMigration or the result of cls(response)
- Return type:
- Raises:
- get_properties(resource_group_name: str, account_name: str, expand: str | StorageAccountExpand | None = None, **kwargs: Any) StorageAccount[source]
Returns the properties for the specified storage account including but not limited to name, SKU name, location, and account status. The ListKeys operation should be used to retrieve storage keys.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
expand (str or StorageAccountExpand) – May be used to expand the properties within account’s properties. By default, data is not included when fetching properties. Currently we only support geoReplicationStats and blobRestoreStatus. Known values are: “geoReplicationStats” and “blobRestoreStatus”. Default value is None.
- Returns:
StorageAccount or the result of cls(response)
- Return type:
- Raises:
- list(**kwargs: Any) Iterable[StorageAccount][source]
Lists all the storage accounts available under the subscription. Note that storage keys are not returned; use the ListKeys operation for this.
- Returns:
An iterator like instance of either StorageAccount or the result of cls(response)
- Return type:
- Raises:
- list_account_sas(resource_group_name: str, account_name: str, parameters: AccountSasParameters | IO[bytes], **kwargs: Any) ListAccountSasResponse[source]
List SAS credentials of a storage account.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
parameters (AccountSasParameters or IO[bytes]) – The parameters to provide to list SAS credentials for the storage account. Is either a AccountSasParameters type or a IO[bytes] type. Required.
- Returns:
ListAccountSasResponse or the result of cls(response)
- Return type:
- Raises:
- list_by_resource_group(resource_group_name: str, **kwargs: Any) Iterable[StorageAccount][source]
Lists all the storage accounts available under the given resource group. Note that storage keys are not returned; use the ListKeys operation for this.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
- Returns:
An iterator like instance of either StorageAccount or the result of cls(response)
- Return type:
- Raises:
- list_keys(resource_group_name: str, account_name: str, expand: Literal['kerb'] = 'kerb', **kwargs: Any) StorageAccountListKeysResult[source]
Lists the access keys or Kerberos keys (if active directory enabled) for the specified storage account.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
expand (str) – Specifies type of the key to be listed. Possible value is kerb. Known values are “kerb” and None. Default value is “kerb”.
- Returns:
StorageAccountListKeysResult or the result of cls(response)
- Return type:
- Raises:
- list_service_sas(resource_group_name: str, account_name: str, parameters: ServiceSasParameters | IO[bytes], **kwargs: Any) ListServiceSasResponse[source]
List service SAS credentials of a specific resource.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
parameters (ServiceSasParameters or IO[bytes]) – The parameters to provide to list service SAS credentials. Is either a ServiceSasParameters type or a IO[bytes] type. Required.
- Returns:
ListServiceSasResponse or the result of cls(response)
- Return type:
- Raises:
- regenerate_key(resource_group_name: str, account_name: str, regenerate_key: StorageAccountRegenerateKeyParameters | IO[bytes], **kwargs: Any) StorageAccountListKeysResult[source]
Regenerates one of the access keys or Kerberos keys for the specified storage account.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
regenerate_key (StorageAccountRegenerateKeyParameters or IO[bytes]) – Specifies name of the key which should be regenerated – key1, key2, kerb1, kerb2. Is either a StorageAccountRegenerateKeyParameters type or a IO[bytes] type. Required.
- Returns:
StorageAccountListKeysResult or the result of cls(response)
- Return type:
- Raises:
- revoke_user_delegation_keys(resource_group_name: str, account_name: str, **kwargs: Any) None[source]
Revoke user delegation keys.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
- Returns:
None or the result of cls(response)
- Return type:
None
- Raises:
- update(resource_group_name: str, account_name: str, parameters: StorageAccountUpdateParameters | IO[bytes], **kwargs: Any) StorageAccount[source]
The update operation can be used to update the SKU, encryption, access tier, or tags for a storage account. It can also be used to map the account to a custom domain. Only one custom domain is supported per storage account; the replacement/change of custom domain is not supported. In order to replace an old custom domain, the old value must be cleared/unregistered before a new value can be set. The update of multiple properties is supported. This call does not change the storage keys for the account. If you want to change the storage account keys, use the regenerate keys operation. The location and name of the storage account cannot be changed after creation.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
parameters (StorageAccountUpdateParameters or IO[bytes]) – The parameters to provide for the updated account. Is either a StorageAccountUpdateParameters type or a IO[bytes] type. Required.
- Returns:
StorageAccount or the result of cls(response)
- Return type:
- Raises:
- models = <module 'azure.mgmt.storage.v2024_01_01.models' from '/mnt/vss/_work/1/s/sdk/storage/azure-mgmt-storage/.tox/sphinx/lib/python3.13/site-packages/azure/mgmt/storage/v2024_01_01/models/__init__.py'>
- class azure.mgmt.storage.v2024_01_01.operations.StorageTaskAssignmentInstancesReportOperations(*args, **kwargs)[source]
Bases:
objectWarning
DO NOT instantiate this class directly.
Instead, you should access the following operations through
StorageManagementClient’sstorage_task_assignment_instances_reportattribute.- list(resource_group_name: str, account_name: str, storage_task_assignment_name: str, maxpagesize: int | None = None, filter: str | None = None, **kwargs: Any) Iterable[StorageTaskReportInstance][source]
Fetch the report summary of a single storage task assignment’s instances.
- Parameters:
resource_group_name (str) – The name of the resource group. The name is case insensitive. Required.
account_name (str) – 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.
storage_task_assignment_name (str) – The name of the storage task assignment within the specified resource group. Storage task assignment names must be between 3 and 24 characters in length and use numbers and lower-case letters only. Required.
maxpagesize (int) – Optional, specifies the maximum number of storage task assignment instances to be included in the list response. Default value is None.
filter (str) – Optional. When specified, it can be used to query using reporting properties. See Constructing Filter Strings for details. Default value is None.
- Returns:
An iterator like instance of either StorageTaskReportInstance or the result of cls(response)
- Return type:
- Raises:
- models = <module 'azure.mgmt.storage.v2024_01_01.models' from '/mnt/vss/_work/1/s/sdk/storage/azure-mgmt-storage/.tox/sphinx/lib/python3.13/site-packages/azure/mgmt/storage/v2024_01_01/models/__init__.py'>
- class azure.mgmt.storage.v2024_01_01.operations.StorageTaskAssignmentsInstancesReportOperations(*args, **kwargs)[source]
Bases:
objectWarning
DO NOT instantiate this class directly.
Instead, you should access the following operations through
StorageManagementClient’sstorage_task_assignments_instances_reportattribute.- list(resource_group_name: str, account_name: str, maxpagesize: int | None = None, filter: str | None = None, **kwargs: Any) Iterable[StorageTaskReportInstance][source]
Fetch the report summary of all the storage task assignments and instances in an account.
- Parameters:
resource_group_name (str) – The name of the resource group. The name is case insensitive. Required.
account_name (str) – 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.
maxpagesize (int) – Optional, specifies the maximum number of storage task assignment instances to be included in the list response. Default value is None.
filter (str) –
Optional. When specified, it can be used to query using reporting properties. See Constructing Filter Strings for details. Default value is None.
- Returns:
An iterator like instance of either StorageTaskReportInstance or the result of cls(response)
- Return type:
- Raises:
- models = <module 'azure.mgmt.storage.v2024_01_01.models' from '/mnt/vss/_work/1/s/sdk/storage/azure-mgmt-storage/.tox/sphinx/lib/python3.13/site-packages/azure/mgmt/storage/v2024_01_01/models/__init__.py'>
- class azure.mgmt.storage.v2024_01_01.operations.StorageTaskAssignmentsOperations(*args, **kwargs)[source]
Bases:
objectWarning
DO NOT instantiate this class directly.
Instead, you should access the following operations through
StorageManagementClient’sstorage_task_assignmentsattribute.- begin_create(resource_group_name: str, account_name: str, storage_task_assignment_name: str, parameters: StorageTaskAssignment | IO[bytes], **kwargs: Any) LROPoller[StorageTaskAssignment][source]
Asynchronously creates a new storage task assignment sub-resource with the specified parameters. If a storage task assignment is already created and a subsequent create request is issued with different properties, the storage task assignment properties will be updated. If a storage task assignment is already created and a subsequent create or update request is issued with the exact same set of properties, the request will succeed.
- Parameters:
resource_group_name (str) – The name of the resource group. The name is case insensitive. Required.
account_name (str) – 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.
storage_task_assignment_name (str) – The name of the storage task assignment within the specified resource group. Storage task assignment names must be between 3 and 24 characters in length and use numbers and lower-case letters only. Required.
parameters (StorageTaskAssignment or IO[bytes]) – The parameters to create a Storage Task Assignment. Is either a StorageTaskAssignment type or a IO[bytes] type. Required.
- Returns:
An instance of LROPoller that returns either StorageTaskAssignment or the result of cls(response)
- Return type:
- Raises:
- begin_delete(resource_group_name: str, account_name: str, storage_task_assignment_name: str, **kwargs: Any) LROPoller[None][source]
Delete the storage task assignment sub-resource.
- Parameters:
resource_group_name (str) – The name of the resource group. The name is case insensitive. Required.
account_name (str) – 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.
storage_task_assignment_name (str) – The name of the storage task assignment within the specified resource group. Storage task assignment names must be between 3 and 24 characters in length and use numbers and lower-case letters only. Required.
- Returns:
An instance of LROPoller that returns either None or the result of cls(response)
- Return type:
LROPoller[None]
- Raises:
- begin_update(resource_group_name: str, account_name: str, storage_task_assignment_name: str, parameters: StorageTaskAssignmentUpdateParameters | IO[bytes], **kwargs: Any) LROPoller[StorageTaskAssignment][source]
Update storage task assignment properties.
- Parameters:
resource_group_name (str) – The name of the resource group. The name is case insensitive. Required.
account_name (str) – 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.
storage_task_assignment_name (str) – The name of the storage task assignment within the specified resource group. Storage task assignment names must be between 3 and 24 characters in length and use numbers and lower-case letters only. Required.
parameters (StorageTaskAssignmentUpdateParameters or IO[bytes]) – The parameters to update a Storage Task Assignment. Is either a StorageTaskAssignmentUpdateParameters type or a IO[bytes] type. Required.
- Returns:
An instance of LROPoller that returns either StorageTaskAssignment or the result of cls(response)
- Return type:
- Raises:
- get(resource_group_name: str, account_name: str, storage_task_assignment_name: str, **kwargs: Any) StorageTaskAssignment[source]
Get the storage task assignment properties.
- Parameters:
resource_group_name (str) – The name of the resource group. The name is case insensitive. Required.
account_name (str) – 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.
storage_task_assignment_name (str) – The name of the storage task assignment within the specified resource group. Storage task assignment names must be between 3 and 24 characters in length and use numbers and lower-case letters only. Required.
- Returns:
StorageTaskAssignment or the result of cls(response)
- Return type:
- Raises:
- list(resource_group_name: str, account_name: str, maxpagesize: int | None = None, **kwargs: Any) Iterable[StorageTaskAssignment][source]
List all the storage task assignments in an account.
- Parameters:
resource_group_name (str) – The name of the resource group. The name is case insensitive. Required.
account_name (str) – 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.
maxpagesize (int) – Optional, specifies the maximum number of storage task assignment Ids to be included in the list response. Default value is None.
- Returns:
An iterator like instance of either StorageTaskAssignment or the result of cls(response)
- Return type:
- Raises:
- models = <module 'azure.mgmt.storage.v2024_01_01.models' from '/mnt/vss/_work/1/s/sdk/storage/azure-mgmt-storage/.tox/sphinx/lib/python3.13/site-packages/azure/mgmt/storage/v2024_01_01/models/__init__.py'>
- class azure.mgmt.storage.v2024_01_01.operations.TableOperations(*args, **kwargs)[source]
Bases:
objectWarning
DO NOT instantiate this class directly.
Instead, you should access the following operations through
StorageManagementClient’stableattribute.- create(resource_group_name: str, account_name: str, table_name: str, parameters: Table | IO[bytes] | None = None, **kwargs: Any) Table[source]
Creates a new table with the specified table name, under the specified account.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
table_name (str) – A table name must be unique within a storage account and must be between 3 and 63 characters.The name must comprise of only alphanumeric characters and it cannot begin with a numeric character. Required.
parameters (Table or IO[bytes]) – The parameters to provide to create a table. Is either a Table type or a IO[bytes] type. Default value is None.
- Returns:
Table or the result of cls(response)
- Return type:
- Raises:
- delete(resource_group_name: str, account_name: str, table_name: str, **kwargs: Any) None[source]
Deletes the table with the specified table name, under the specified account if it exists.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
table_name (str) – A table name must be unique within a storage account and must be between 3 and 63 characters.The name must comprise of only alphanumeric characters and it cannot begin with a numeric character. Required.
- Returns:
None or the result of cls(response)
- Return type:
None
- Raises:
- get(resource_group_name: str, account_name: str, table_name: str, **kwargs: Any) Table[source]
Gets the table with the specified table name, under the specified account if it exists.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
table_name (str) – A table name must be unique within a storage account and must be between 3 and 63 characters.The name must comprise of only alphanumeric characters and it cannot begin with a numeric character. Required.
- Returns:
Table or the result of cls(response)
- Return type:
- Raises:
- list(resource_group_name: str, account_name: str, **kwargs: Any) Iterable[Table][source]
Gets a list of all the tables under the specified storage account.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
- Returns:
An iterator like instance of either Table or the result of cls(response)
- Return type:
- Raises:
- update(resource_group_name: str, account_name: str, table_name: str, parameters: Table | IO[bytes] | None = None, **kwargs: Any) Table[source]
Creates a new table with the specified table name, under the specified account.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
table_name (str) – A table name must be unique within a storage account and must be between 3 and 63 characters.The name must comprise of only alphanumeric characters and it cannot begin with a numeric character. Required.
parameters (Table or IO[bytes]) – The parameters to provide to create a table. Is either a Table type or a IO[bytes] type. Default value is None.
- Returns:
Table or the result of cls(response)
- Return type:
- Raises:
- models = <module 'azure.mgmt.storage.v2024_01_01.models' from '/mnt/vss/_work/1/s/sdk/storage/azure-mgmt-storage/.tox/sphinx/lib/python3.13/site-packages/azure/mgmt/storage/v2024_01_01/models/__init__.py'>
- class azure.mgmt.storage.v2024_01_01.operations.TableServicesOperations(*args, **kwargs)[source]
Bases:
objectWarning
DO NOT instantiate this class directly.
Instead, you should access the following operations through
StorageManagementClient’stable_servicesattribute.- get_service_properties(resource_group_name: str, account_name: str, **kwargs: Any) TableServiceProperties[source]
Gets the properties of a storage account’s Table service, including properties for Storage Analytics and CORS (Cross-Origin Resource Sharing) rules.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
- Returns:
TableServiceProperties or the result of cls(response)
- Return type:
- Raises:
- list(resource_group_name: str, account_name: str, **kwargs: Any) ListTableServices[source]
List all table services for the storage account.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
- Returns:
ListTableServices or the result of cls(response)
- Return type:
- Raises:
- set_service_properties(resource_group_name: str, account_name: str, parameters: TableServiceProperties | IO[bytes], **kwargs: Any) TableServiceProperties[source]
Sets the properties of a storage account’s Table service, including properties for Storage Analytics and CORS (Cross-Origin Resource Sharing) rules.
- Parameters:
resource_group_name (str) – The name of the resource group within the user’s subscription. The name is case insensitive. Required.
account_name (str) – 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.
parameters (TableServiceProperties or IO[bytes]) – The properties of a storage account’s Table service, only properties for Storage Analytics and CORS (Cross-Origin Resource Sharing) rules can be specified. Is either a TableServiceProperties type or a IO[bytes] type. Required.
- Returns:
TableServiceProperties or the result of cls(response)
- Return type:
- Raises:
- models = <module 'azure.mgmt.storage.v2024_01_01.models' from '/mnt/vss/_work/1/s/sdk/storage/azure-mgmt-storage/.tox/sphinx/lib/python3.13/site-packages/azure/mgmt/storage/v2024_01_01/models/__init__.py'>
- class azure.mgmt.storage.v2024_01_01.operations.UsagesOperations(*args, **kwargs)[source]
Bases:
objectWarning
DO NOT instantiate this class directly.
Instead, you should access the following operations through
StorageManagementClient’susagesattribute.- list_by_location(location: str, **kwargs: Any) Iterable[Usage][source]
Gets the current usage count and the limit for the resources of the location under the subscription.
- Parameters:
location (str) – The location of the Azure Storage resource. Required.
- Returns:
An iterator like instance of either Usage or the result of cls(response)
- Return type:
- Raises:
- models = <module 'azure.mgmt.storage.v2024_01_01.models' from '/mnt/vss/_work/1/s/sdk/storage/azure-mgmt-storage/.tox/sphinx/lib/python3.13/site-packages/azure/mgmt/storage/v2024_01_01/models/__init__.py'>