azure.mgmt.storage.v2020_08_01_preview.operations.StorageAccountsOperations.yml

### YamlMime:PythonClass
uid: azure.mgmt.storage.v2020_08_01_preview.operations.StorageAccountsOperations
name: StorageAccountsOperations
fullName: azure.mgmt.storage.v2020_08_01_preview.operations.StorageAccountsOperations
module: azure.mgmt.storage.v2020_08_01_preview.operations
inheritances:
- builtins.object
summary: "> [!WARNING]\n> DO NOT instantiate this class directly.\n>\n> \n>\n> Instead,\
  \ you should access the following operations through\n>\n> <xref:azure.mgmt.storage.v2020_08_01_preview.StorageManagementClient>'s\n\
  >\n> <xref:storage_accounts> attribute.\n>"
constructor:
  syntax: StorageAccountsOperations(*args, **kwargs)
methods:
- uid: azure.mgmt.storage.v2020_08_01_preview.operations.StorageAccountsOperations.begin_create
  name: begin_create
  summary: '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.'
  signature: 'begin_create(resource_group_name: str, account_name: str, parameters:
    _models.StorageAccountCreateParameters, *, content_type: str = ''application/json'',
    **kwargs: Any) -> LROPoller[_models.StorageAccount]'
  parameters:
  - name: resource_group_name
    description: 'The name of the resource group within the user''s subscription.
      The

      name is case insensitive. Required.'
    isRequired: true
    types:
    - <xref:str>
  - name: account_name
    description: '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.'
    isRequired: true
    types:
    - <xref:str>
  - name: parameters
    description: 'The parameters to provide for the created account. Is either a

      StorageAccountCreateParameters type or a IO[bytes] type. Required.'
    isRequired: true
    types:
    - <xref:azure.mgmt.storage.v2020_08_01_preview.models.StorageAccountCreateParameters>
    - <xref:typing.IO>[<xref:bytes>]
  return:
    description: 'An instance of LROPoller that returns either StorageAccount or the
      result of

      cls(response)'
    types:
    - <xref:azure.core.polling.LROPoller>[<xref:azure.mgmt.storage.v2020_08_01_preview.models.StorageAccount>]
  exceptions:
  - type: azure.core.exceptions.HttpResponseError
- uid: azure.mgmt.storage.v2020_08_01_preview.operations.StorageAccountsOperations.begin_failover
  name: begin_failover
  summary: 'Failover request can be triggered for a storage account in case of availability
    issues. The

    failover occurs from the storage account''s primary cluster to secondary cluster
    for RA-GRS

    accounts. The secondary cluster will become primary after failover.'
  signature: 'begin_failover(resource_group_name: str, account_name: str, **kwargs:
    Any) -> LROPoller[None]'
  parameters:
  - name: resource_group_name
    description: 'The name of the resource group within the user''s subscription.
      The

      name is case insensitive. Required.'
    isRequired: true
    types:
    - <xref:str>
  - name: account_name
    description: '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.'
    isRequired: true
    types:
    - <xref:str>
  return:
    description: An instance of LROPoller that returns either None or the result of
      cls(response)
    types:
    - <xref:azure.core.polling.LROPoller>[<xref:None>]
  exceptions:
  - type: azure.core.exceptions.HttpResponseError
- uid: azure.mgmt.storage.v2020_08_01_preview.operations.StorageAccountsOperations.begin_restore_blob_ranges
  name: begin_restore_blob_ranges
  summary: Restore blobs in the specified blob ranges.
  signature: 'begin_restore_blob_ranges(resource_group_name: str, account_name: str,
    parameters: _models.BlobRestoreParameters, *, content_type: str = ''application/json'',
    **kwargs: Any) -> LROPoller[_models.BlobRestoreStatus]'
  parameters:
  - name: resource_group_name
    description: 'The name of the resource group within the user''s subscription.
      The

      name is case insensitive. Required.'
    isRequired: true
    types:
    - <xref:str>
  - name: account_name
    description: '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.'
    isRequired: true
    types:
    - <xref:str>
  - name: parameters
    description: 'The parameters to provide for restore blob ranges. Is either a

      BlobRestoreParameters type or a IO[bytes] type. Required.'
    isRequired: true
    types:
    - <xref:azure.mgmt.storage.v2020_08_01_preview.models.BlobRestoreParameters>
    - <xref:typing.IO>[<xref:bytes>]
  return:
    description: 'An instance of LROPoller that returns either BlobRestoreStatus or
      the result of

      cls(response)'
    types:
    - <xref:azure.core.polling.LROPoller>[<xref:azure.mgmt.storage.v2020_08_01_preview.models.BlobRestoreStatus>]
  exceptions:
  - type: azure.core.exceptions.HttpResponseError
- uid: azure.mgmt.storage.v2020_08_01_preview.operations.StorageAccountsOperations.check_name_availability
  name: check_name_availability
  summary: Checks that the storage account name is valid and is not already in use.
  signature: 'check_name_availability(account_name: _models.StorageAccountCheckNameAvailabilityParameters,
    *, content_type: str = ''application/json'', **kwargs: Any) -> _models.CheckNameAvailabilityResult'
  parameters:
  - name: account_name
    description: '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.'
    isRequired: true
    types:
    - <xref:azure.mgmt.storage.v2020_08_01_preview.models.StorageAccountCheckNameAvailabilityParameters>
    - <xref:typing.IO>[<xref:bytes>]
  return:
    description: CheckNameAvailabilityResult or the result of cls(response)
    types:
    - <xref:azure.mgmt.storage.v2020_08_01_preview.models.CheckNameAvailabilityResult>
  exceptions:
  - type: azure.core.exceptions.HttpResponseError
- uid: azure.mgmt.storage.v2020_08_01_preview.operations.StorageAccountsOperations.delete
  name: delete
  summary: Deletes a storage account in Microsoft Azure.
  signature: 'delete(resource_group_name: str, account_name: str, **kwargs: Any) ->
    None'
  parameters:
  - name: resource_group_name
    description: 'The name of the resource group within the user''s subscription.
      The

      name is case insensitive. Required.'
    isRequired: true
    types:
    - <xref:str>
  - name: account_name
    description: '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.'
    isRequired: true
    types:
    - <xref:str>
  return:
    description: None or the result of cls(response)
    types:
    - <xref:None>
  exceptions:
  - type: azure.core.exceptions.HttpResponseError
- uid: azure.mgmt.storage.v2020_08_01_preview.operations.StorageAccountsOperations.get_properties
  name: get_properties
  summary: '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.'
  signature: 'get_properties(resource_group_name: str, account_name: str, expand:
    str | StorageAccountExpand | None = None, **kwargs: Any) -> StorageAccount'
  parameters:
  - name: resource_group_name
    description: 'The name of the resource group within the user''s subscription.
      The

      name is case insensitive. Required.'
    isRequired: true
    types:
    - <xref:str>
  - name: account_name
    description: '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.'
    isRequired: true
    types:
    - <xref:str>
  - name: expand
    description: '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.'
    isRequired: true
    types:
    - <xref:str>
    - <xref:azure.mgmt.storage.v2020_08_01_preview.models.StorageAccountExpand>
  return:
    description: StorageAccount or the result of cls(response)
    types:
    - <xref:azure.mgmt.storage.v2020_08_01_preview.models.StorageAccount>
  exceptions:
  - type: azure.core.exceptions.HttpResponseError
- uid: azure.mgmt.storage.v2020_08_01_preview.operations.StorageAccountsOperations.list
  name: list
  summary: 'Lists all the storage accounts available under the subscription. Note
    that storage keys are not

    returned; use the ListKeys operation for this.'
  signature: 'list(**kwargs: Any) -> Iterable[StorageAccount]'
  return:
    description: An iterator like instance of either StorageAccount or the result
      of cls(response)
    types:
    - <xref:azure.core.paging.ItemPaged>[<xref:azure.mgmt.storage.v2020_08_01_preview.models.StorageAccount>]
  exceptions:
  - type: azure.core.exceptions.HttpResponseError
- uid: azure.mgmt.storage.v2020_08_01_preview.operations.StorageAccountsOperations.list_account_sas
  name: list_account_sas
  summary: List SAS credentials of a storage account.
  signature: 'list_account_sas(resource_group_name: str, account_name: str, parameters:
    _models.AccountSasParameters, *, content_type: str = ''application/json'', **kwargs:
    Any) -> _models.ListAccountSasResponse'
  parameters:
  - name: resource_group_name
    description: 'The name of the resource group within the user''s subscription.
      The

      name is case insensitive. Required.'
    isRequired: true
    types:
    - <xref:str>
  - name: account_name
    description: '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.'
    isRequired: true
    types:
    - <xref:str>
  - name: parameters
    description: 'The parameters to provide to list SAS credentials for the storage
      account.

      Is either a AccountSasParameters type or a IO[bytes] type. Required.'
    isRequired: true
    types:
    - <xref:azure.mgmt.storage.v2020_08_01_preview.models.AccountSasParameters>
    - <xref:typing.IO>[<xref:bytes>]
  return:
    description: ListAccountSasResponse or the result of cls(response)
    types:
    - <xref:azure.mgmt.storage.v2020_08_01_preview.models.ListAccountSasResponse>
  exceptions:
  - type: azure.core.exceptions.HttpResponseError
- uid: azure.mgmt.storage.v2020_08_01_preview.operations.StorageAccountsOperations.list_by_resource_group
  name: list_by_resource_group
  summary: 'Lists all the storage accounts available under the given resource group.
    Note that storage keys

    are not returned; use the ListKeys operation for this.'
  signature: 'list_by_resource_group(resource_group_name: str, **kwargs: Any) -> Iterable[StorageAccount]'
  parameters:
  - name: resource_group_name
    description: 'The name of the resource group within the user''s subscription.
      The

      name is case insensitive. Required.'
    isRequired: true
    types:
    - <xref:str>
  return:
    description: An iterator like instance of either StorageAccount or the result
      of cls(response)
    types:
    - <xref:azure.core.paging.ItemPaged>[<xref:azure.mgmt.storage.v2020_08_01_preview.models.StorageAccount>]
  exceptions:
  - type: azure.core.exceptions.HttpResponseError
- uid: azure.mgmt.storage.v2020_08_01_preview.operations.StorageAccountsOperations.list_keys
  name: list_keys
  summary: 'Lists the access keys or Kerberos keys (if active directory enabled) for
    the specified storage

    account.'
  signature: 'list_keys(resource_group_name: str, account_name: str, expand: Literal[''kerb'']
    = ''kerb'', **kwargs: Any) -> StorageAccountListKeysResult'
  parameters:
  - name: resource_group_name
    description: 'The name of the resource group within the user''s subscription.
      The

      name is case insensitive. Required.'
    isRequired: true
    types:
    - <xref:str>
  - name: account_name
    description: '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.'
    isRequired: true
    types:
    - <xref:str>
  - name: expand
    description: 'Specifies type of the key to be listed. Possible value is kerb.
      Known values are

      "kerb" and None. Default value is "kerb".'
    isRequired: true
    types:
    - <xref:str>
  return:
    description: StorageAccountListKeysResult or the result of cls(response)
    types:
    - <xref:azure.mgmt.storage.v2020_08_01_preview.models.StorageAccountListKeysResult>
  exceptions:
  - type: azure.core.exceptions.HttpResponseError
- uid: azure.mgmt.storage.v2020_08_01_preview.operations.StorageAccountsOperations.list_service_sas
  name: list_service_sas
  summary: List service SAS credentials of a specific resource.
  signature: 'list_service_sas(resource_group_name: str, account_name: str, parameters:
    _models.ServiceSasParameters, *, content_type: str = ''application/json'', **kwargs:
    Any) -> _models.ListServiceSasResponse'
  parameters:
  - name: resource_group_name
    description: 'The name of the resource group within the user''s subscription.
      The

      name is case insensitive. Required.'
    isRequired: true
    types:
    - <xref:str>
  - name: account_name
    description: '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.'
    isRequired: true
    types:
    - <xref:str>
  - name: parameters
    description: 'The parameters to provide to list service SAS credentials. Is either
      a

      ServiceSasParameters type or a IO[bytes] type. Required.'
    isRequired: true
    types:
    - <xref:azure.mgmt.storage.v2020_08_01_preview.models.ServiceSasParameters>
    - <xref:typing.IO>[<xref:bytes>]
  return:
    description: ListServiceSasResponse or the result of cls(response)
    types:
    - <xref:azure.mgmt.storage.v2020_08_01_preview.models.ListServiceSasResponse>
  exceptions:
  - type: azure.core.exceptions.HttpResponseError
- uid: azure.mgmt.storage.v2020_08_01_preview.operations.StorageAccountsOperations.regenerate_key
  name: regenerate_key
  summary: Regenerates one of the access keys or Kerberos keys for the specified storage
    account.
  signature: 'regenerate_key(resource_group_name: str, account_name: str, regenerate_key:
    _models.StorageAccountRegenerateKeyParameters, *, content_type: str = ''application/json'',
    **kwargs: Any) -> _models.StorageAccountListKeysResult'
  parameters:
  - name: resource_group_name
    description: 'The name of the resource group within the user''s subscription.
      The

      name is case insensitive. Required.'
    isRequired: true
    types:
    - <xref:str>
  - name: account_name
    description: '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.'
    isRequired: true
    types:
    - <xref:str>
  - name: regenerate_key
    description: "Specifies name of the key which should be regenerated \u2013 key1,\
      \ key2,\nkerb1, kerb2. Is either a StorageAccountRegenerateKeyParameters type\
      \ or a IO[bytes] type.\nRequired."
    isRequired: true
    types:
    - <xref:azure.mgmt.storage.v2020_08_01_preview.models.StorageAccountRegenerateKeyParameters>
    - <xref:typing.IO>[<xref:bytes>]
  return:
    description: StorageAccountListKeysResult or the result of cls(response)
    types:
    - <xref:azure.mgmt.storage.v2020_08_01_preview.models.StorageAccountListKeysResult>
  exceptions:
  - type: azure.core.exceptions.HttpResponseError
- uid: azure.mgmt.storage.v2020_08_01_preview.operations.StorageAccountsOperations.revoke_user_delegation_keys
  name: revoke_user_delegation_keys
  summary: Revoke user delegation keys.
  signature: 'revoke_user_delegation_keys(resource_group_name: str, account_name:
    str, **kwargs: Any) -> None'
  parameters:
  - name: resource_group_name
    description: 'The name of the resource group within the user''s subscription.
      The

      name is case insensitive. Required.'
    isRequired: true
    types:
    - <xref:str>
  - name: account_name
    description: '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.'
    isRequired: true
    types:
    - <xref:str>
  return:
    description: None or the result of cls(response)
    types:
    - <xref:None>
  exceptions:
  - type: azure.core.exceptions.HttpResponseError
- uid: azure.mgmt.storage.v2020_08_01_preview.operations.StorageAccountsOperations.update
  name: update
  summary: '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.'
  signature: 'update(resource_group_name: str, account_name: str, parameters: _models.StorageAccountUpdateParameters,
    *, content_type: str = ''application/json'', **kwargs: Any) -> _models.StorageAccount'
  parameters:
  - name: resource_group_name
    description: 'The name of the resource group within the user''s subscription.
      The

      name is case insensitive. Required.'
    isRequired: true
    types:
    - <xref:str>
  - name: account_name
    description: '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.'
    isRequired: true
    types:
    - <xref:str>
  - name: parameters
    description: 'The parameters to provide for the updated account. Is either a

      StorageAccountUpdateParameters type or a IO[bytes] type. Required.'
    isRequired: true
    types:
    - <xref:azure.mgmt.storage.v2020_08_01_preview.models.StorageAccountUpdateParameters>
    - <xref:typing.IO>[<xref:bytes>]
  return:
    description: StorageAccount or the result of cls(response)
    types:
    - <xref:azure.mgmt.storage.v2020_08_01_preview.models.StorageAccount>
  exceptions:
  - type: azure.core.exceptions.HttpResponseError
attributes:
- uid: azure.mgmt.storage.v2020_08_01_preview.operations.StorageAccountsOperations.models
  name: models
  signature: models = <module 'azure.mgmt.storage.v2020_08_01_preview.models' from
    'C:\\hostedtoolcache\\windows\\Python\\3.11.9\\x64\\Lib\\site-packages\\azure\\mgmt\\storage\\v2020_08_01_preview\\models\\__init__.py'>