Storage Accounts - List

Lists all the storage accounts available under the subscription. Note that storage keys are not returned; use the ListKeys operation for this.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Storage/storageAccounts?api-version=2019-06-01

URI Parameters

Name In Required Type Description
subscriptionId
path True
  • string

The ID of the target subscription.

api-version
query True
  • string

The API version to use for this operation.

Responses

Name Type Description
200 OK

OK -- List of storage accounts was retrieved and returned successfully.

Security

azure_auth

Azure Active Directory OAuth2 Flow

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation impersonate your user account

Examples

StorageAccountList

Sample Request

GET https://management.azure.com/subscriptions/{subscription-id}/providers/Microsoft.Storage/storageAccounts?api-version=2019-06-01

Sample Response

{
  "value": [
    {
      "id": "/subscriptions/{subscription-id}/resourceGroups/res2627/providers/Microsoft.Storage/storageAccounts/sto1125",
      "kind": "Storage",
      "location": "eastus2euap",
      "name": "sto1125",
      "properties": {
        "isHnsEnabled": true,
        "creationTime": "2017-05-24T13:28:53.4540398Z",
        "primaryEndpoints": {
          "web": "https://sto1125.web.core.windows.net/",
          "dfs": "https://sto1125.dfs.core.windows.net/",
          "blob": "https://sto1125.blob.core.windows.net/",
          "file": "https://sto1125.file.core.windows.net/",
          "queue": "https://sto1125.queue.core.windows.net/",
          "table": "https://sto1125.table.core.windows.net/",
          "microsoftEndpoints": {
            "web": "https://sto1125-microsoftrouting.web.core.windows.net/",
            "dfs": "https://sto1125-microsoftrouting.dfs.core.windows.net/",
            "blob": "https://sto1125-microsoftrouting.blob.core.windows.net/",
            "file": "https://sto1125-microsoftrouting.file.core.windows.net/",
            "queue": "https://sto1125-microsoftrouting.queue.core.windows.net/",
            "table": "https://sto1125-microsoftrouting.table.core.windows.net/"
          },
          "internetEndpoints": {
            "web": "https://sto1125-internetrouting.web.core.windows.net/",
            "dfs": "https://sto1125-internetrouting.dfs.core.windows.net/",
            "blob": "https://sto1125-internetrouting.blob.core.windows.net/",
            "file": "https://sto1125-internetrouting.file.core.windows.net/"
          }
        },
        "primaryLocation": "eastus2euap",
        "provisioningState": "Succeeded",
        "routingPreference": {
          "routingChoice": "MicrosoftRouting",
          "publishMicrosoftEndpoints": true,
          "publishInternetEndpoints": true
        },
        "secondaryLocation": "centraluseuap",
        "statusOfPrimary": "available",
        "statusOfSecondary": "available",
        "supportsHttpsTrafficOnly": false
      },
      "sku": {
        "name": "Standard_GRS",
        "tier": "Standard"
      },
      "tags": {
        "key1": "value1",
        "key2": "value2"
      },
      "type": "Microsoft.Storage/storageAccounts"
    },
    {
      "id": "/subscriptions/{subscription-id}/resourceGroups/testcmk3/providers/Microsoft.Storage/storageAccounts/sto3699",
      "identity": {
        "principalId": "356d057d-cba5-44dd-8a30-b2e547bc416b",
        "tenantId": "72f988bf-86f1-41af-91ab-2d7cd011db47",
        "type": "SystemAssigned"
      },
      "kind": "Storage",
      "location": "eastus2euap",
      "name": "sto3699",
      "properties": {
        "creationTime": "2017-05-24T10:06:30.6093014Z",
        "primaryEndpoints": {
          "blob": "https://sto3699.blob.core.windows.net/",
          "file": "https://sto3699.file.core.windows.net/",
          "queue": "https://sto3699.queue.core.windows.net/",
          "table": "https://sto3699.table.core.windows.net/"
        },
        "primaryLocation": "eastus2euap",
        "provisioningState": "Succeeded",
        "secondaryLocation": "centraluseuap",
        "statusOfPrimary": "available",
        "statusOfSecondary": "available",
        "supportsHttpsTrafficOnly": false
      },
      "sku": {
        "name": "Standard_GRS",
        "tier": "Standard"
      },
      "tags": {
        "key1": "value1",
        "key2": "value2"
      },
      "type": "Microsoft.Storage/storageAccounts"
    },
    {
      "id": "/subscriptions/{subscription-id}/resourceGroups/testcmk3/providers/Microsoft.Storage/storageAccounts/sto6637",
      "identity": {
        "principalId": "911871cc-ffd1-4fc4-ac11-7a316433ea66",
        "tenantId": "72f988bf-86f1-41af-91ab-2d7cd011db47",
        "type": "SystemAssigned"
      },
      "kind": "Storage",
      "location": "eastus2euap",
      "name": "sto6637",
      "properties": {
        "creationTime": "2017-05-24T10:09:39.5625175Z",
        "primaryEndpoints": {
          "blob": "https://sto6637.blob.core.windows.net/",
          "file": "https://sto6637.file.core.windows.net/",
          "queue": "https://sto6637.queue.core.windows.net/",
          "table": "https://sto6637.table.core.windows.net/"
        },
        "primaryLocation": "eastus2euap",
        "provisioningState": "Succeeded",
        "secondaryLocation": "centraluseuap",
        "statusOfPrimary": "available",
        "statusOfSecondary": "available",
        "supportsHttpsTrafficOnly": false
      },
      "sku": {
        "name": "Standard_GRS",
        "tier": "Standard"
      },
      "tags": {
        "key1": "value1",
        "key2": "value2"
      },
      "type": "Microsoft.Storage/storageAccounts"
    },
    {
      "id": "/subscriptions/{subscription-id}/resourceGroups/res8186/providers/Microsoft.Storage/storageAccounts/sto834",
      "kind": "Storage",
      "location": "eastus2euap",
      "name": "sto834",
      "properties": {
        "creationTime": "2017-05-24T13:28:20.8686541Z",
        "primaryEndpoints": {
          "blob": "https://sto834.blob.core.windows.net/",
          "file": "https://sto834.file.core.windows.net/",
          "queue": "https://sto834.queue.core.windows.net/",
          "table": "https://sto834.table.core.windows.net/"
        },
        "primaryLocation": "eastus2euap",
        "provisioningState": "Succeeded",
        "secondaryLocation": "centraluseuap",
        "statusOfPrimary": "available",
        "statusOfSecondary": "available",
        "supportsHttpsTrafficOnly": false
      },
      "sku": {
        "name": "Standard_GRS",
        "tier": "Standard"
      },
      "tags": {
        "key1": "value1",
        "key2": "value2"
      },
      "type": "Microsoft.Storage/storageAccounts"
    },
    {
      "id": "/subscriptions/{subscription-id}/resourceGroups/testcmk3/providers/Microsoft.Storage/storageAccounts/sto9174",
      "identity": {
        "principalId": "933e3ddf-1802-4a51-9469-18a33b576f88",
        "tenantId": "72f988bf-86f1-41af-91ab-2d7cd011db47",
        "type": "SystemAssigned"
      },
      "kind": "Storage",
      "location": "eastus2euap",
      "name": "sto9174",
      "properties": {
        "creationTime": "2017-05-24T09:46:19.6556989Z",
        "primaryEndpoints": {
          "blob": "https://sto9174.blob.core.windows.net/",
          "file": "https://sto9174.file.core.windows.net/",
          "queue": "https://sto9174.queue.core.windows.net/",
          "table": "https://sto9174.table.core.windows.net/"
        },
        "primaryLocation": "eastus2euap",
        "provisioningState": "Succeeded",
        "secondaryLocation": "centraluseuap",
        "statusOfPrimary": "available",
        "statusOfSecondary": "available",
        "supportsHttpsTrafficOnly": false
      },
      "sku": {
        "name": "Standard_GRS",
        "tier": "Standard"
      },
      "tags": {
        "key1": "value1",
        "key2": "value2"
      },
      "type": "Microsoft.Storage/storageAccounts"
    }
  ]
}

Definitions

AccessTier

Required for storage accounts where kind = BlobStorage. The access tier used for billing.

AccountStatus

Gets the status indicating whether the primary location of the storage account is available or unavailable.

Action

The action of virtual network rule.

ActiveDirectoryProperties

Settings properties for Active Directory (AD).

AzureFilesIdentityBasedAuthentication

Settings for Azure Files identity based authentication.

Bypass

Specifies whether traffic is bypassed for Logging/Metrics/AzureServices. Possible values are any combination of Logging|Metrics|AzureServices (For example, "Logging, Metrics"), or None to bypass none of those traffics.

CustomDomain

The custom domain assigned to this storage account. This can be set via Update.

DefaultAction

Specifies the default action of allow or deny when no other rules match.

DirectoryServiceOptions

Indicates the directory service used.

Encryption

The encryption settings on the storage account.

EncryptionService

A service that allows server-side encryption to be used.

EncryptionServices

A list of services that support encryption.

Endpoints

The URIs that are used to perform a retrieval of a public blob, queue, table, web or dfs object.

GeoReplicationStats

Statistics related to replication for storage account's Blob, Table, Queue and File services. It is only available when geo-redundant replication is enabled for the storage account.

GeoReplicationStatus

The status of the secondary location. Possible values are: - Live: Indicates that the secondary location is active and operational. - Bootstrap: Indicates initial synchronization from the primary location to the secondary location is in progress.This typically occurs when replication is first enabled. - Unavailable: Indicates that the secondary location is temporarily unavailable.

Identity

Identity for the resource.

IdentityType

The identity type.

IPRule

IP rule with specific IP or IP range in CIDR format.

KeySource

The encryption keySource (provider). Possible values (case-insensitive): Microsoft.Storage, Microsoft.Keyvault

KeyVaultProperties

Properties of key vault.

Kind

Indicates the type of storage account.

LargeFileSharesState

Allow large file shares if sets to Enabled. It cannot be disabled once it is enabled.

NetworkRuleSet

Network rule set

PrivateEndpoint

The Private Endpoint resource.

PrivateEndpointConnection

The Private Endpoint Connection resource.

PrivateEndpointConnectionProvisioningState

The current provisioning state.

PrivateEndpointServiceConnectionStatus

The private endpoint connection status.

PrivateLinkServiceConnectionState

A collection of information about the state of the connection between service consumer and provider.

ProvisioningState

Gets the status of the storage account at the time the operation was called.

RoutingChoice

Routing Choice defines the kind of network routing opted by the user.

RoutingPreference

Routing preference defines the type of network, either microsoft or internet routing to be used to deliver the user data, the default option is microsoft routing

Sku

The SKU of the storage account.

SkuName

The SKU name. Required for account creation; optional for update. Note that in older versions, SKU name was called accountType.

SkuTier

The SKU tier. This is based on the SKU name.

State

Gets the state of virtual network rule.

StorageAccount

The storage account.

StorageAccountInternetEndpoints

The URIs that are used to perform a retrieval of a public blob, file, web or dfs object via a internet routing endpoint.

StorageAccountListResult

The response from the List Storage Accounts operation.

StorageAccountMicrosoftEndpoints

The URIs that are used to perform a retrieval of a public blob, queue, table, web or dfs object via a microsoft routing endpoint.

VirtualNetworkRule

Virtual Network rule.

AccessTier

Required for storage accounts where kind = BlobStorage. The access tier used for billing.

Name Type Description
Cool
  • string
Hot
  • string

AccountStatus

Gets the status indicating whether the primary location of the storage account is available or unavailable.

Name Type Description
available
  • string
unavailable
  • string

Action

The action of virtual network rule.

Name Type Description
Allow
  • string

ActiveDirectoryProperties

Settings properties for Active Directory (AD).

Name Type Description
azureStorageSid
  • string

Specifies the security identifier (SID) for Azure Storage.

domainGuid
  • string

Specifies the domain GUID.

domainName
  • string

Specifies the primary domain that the AD DNS server is authoritative for.

domainSid
  • string

Specifies the security identifier (SID).

forestName
  • string

Specifies the Active Directory forest to get.

netBiosDomainName
  • string

Specifies the NetBIOS domain name.

AzureFilesIdentityBasedAuthentication

Settings for Azure Files identity based authentication.

Name Type Description
activeDirectoryProperties

Required if choose AD.

directoryServiceOptions

Indicates the directory service used.

Bypass

Specifies whether traffic is bypassed for Logging/Metrics/AzureServices. Possible values are any combination of Logging|Metrics|AzureServices (For example, "Logging, Metrics"), or None to bypass none of those traffics.

Name Type Description
AzureServices
  • string
Logging
  • string
Metrics
  • string
None
  • string

CustomDomain

The custom domain assigned to this storage account. This can be set via Update.

Name Type Description
name
  • string

Gets or sets the custom domain name assigned to the storage account. Name is the CNAME source.

useSubDomainName
  • boolean

Indicates whether indirect CName validation is enabled. Default value is false. This should only be set on updates.

DefaultAction

Specifies the default action of allow or deny when no other rules match.

Name Type Description
Allow
  • string
Deny
  • string

DirectoryServiceOptions

Indicates the directory service used.

Name Type Description
AADDS
  • string
AD
  • string
None
  • string

Encryption

The encryption settings on the storage account.

Name Type Description
keySource

The encryption keySource (provider). Possible values (case-insensitive): Microsoft.Storage, Microsoft.Keyvault

keyvaultproperties

Properties provided by key vault.

services

List of services which support encryption.

EncryptionService

A service that allows server-side encryption to be used.

Name Type Description
enabled
  • boolean

A boolean indicating whether or not the service encrypts the data as it is stored.

lastEnabledTime
  • string

Gets a rough estimate of the date/time when the encryption was last enabled by the user. Only returned when encryption is enabled. There might be some unencrypted blobs which were written after this time, as it is just a rough estimate.

EncryptionServices

A list of services that support encryption.

Name Type Description
blob

The encryption function of the blob storage service.

file

The encryption function of the file storage service.

queue

The encryption function of the queue storage service.

table

The encryption function of the table storage service.

Endpoints

The URIs that are used to perform a retrieval of a public blob, queue, table, web or dfs object.

Name Type Description
blob
  • string

Gets the blob endpoint.

dfs
  • string

Gets the dfs endpoint.

file
  • string

Gets the file endpoint.

internetEndpoints

Gets the internet routing storage endpoints

microsoftEndpoints

Gets the microsoft routing storage endpoints.

queue
  • string

Gets the queue endpoint.

table
  • string

Gets the table endpoint.

web
  • string

Gets the web endpoint.

GeoReplicationStats

Statistics related to replication for storage account's Blob, Table, Queue and File services. It is only available when geo-redundant replication is enabled for the storage account.

Name Type Description
canFailover
  • boolean

A boolean flag which indicates whether or not account failover is supported for the account.

lastSyncTime
  • string

All primary writes preceding this UTC date/time value are guaranteed to be available for read operations. Primary writes following this point in time may or may not be available for reads. Element may be default value if value of LastSyncTime is not available, this can happen if secondary is offline or we are in bootstrap.

status

The status of the secondary location. Possible values are: - Live: Indicates that the secondary location is active and operational. - Bootstrap: Indicates initial synchronization from the primary location to the secondary location is in progress.This typically occurs when replication is first enabled. - Unavailable: Indicates that the secondary location is temporarily unavailable.

GeoReplicationStatus

The status of the secondary location. Possible values are: - Live: Indicates that the secondary location is active and operational. - Bootstrap: Indicates initial synchronization from the primary location to the secondary location is in progress.This typically occurs when replication is first enabled. - Unavailable: Indicates that the secondary location is temporarily unavailable.

Name Type Description
Bootstrap
  • string
Live
  • string
Unavailable
  • string

Identity

Identity for the resource.

Name Type Description
principalId
  • string

The principal ID of resource identity.

tenantId
  • string

The tenant ID of resource.

type

The identity type.

IdentityType

The identity type.

Name Type Description
SystemAssigned
  • string

IPRule

IP rule with specific IP or IP range in CIDR format.

Name Type Description
action

The action of IP ACL rule.

value
  • string

Specifies the IP or IP range in CIDR format. Only IPV4 address is allowed.

KeySource

The encryption keySource (provider). Possible values (case-insensitive): Microsoft.Storage, Microsoft.Keyvault

Name Type Description
Microsoft.Keyvault
  • string
Microsoft.Storage
  • string

KeyVaultProperties

Properties of key vault.

Name Type Description
keyname
  • string

The name of KeyVault key.

keyvaulturi
  • string

The Uri of KeyVault.

keyversion
  • string

The version of KeyVault key.

Kind

Indicates the type of storage account.

Name Type Description
BlobStorage
  • string
BlockBlobStorage
  • string
FileStorage
  • string
Storage
  • string
StorageV2
  • string

LargeFileSharesState

Allow large file shares if sets to Enabled. It cannot be disabled once it is enabled.

Name Type Description
Disabled
  • string
Enabled
  • string

NetworkRuleSet

Network rule set

Name Type Description
bypass

Specifies whether traffic is bypassed for Logging/Metrics/AzureServices. Possible values are any combination of Logging|Metrics|AzureServices (For example, "Logging, Metrics"), or None to bypass none of those traffics.

defaultAction

Specifies the default action of allow or deny when no other rules match.

ipRules

Sets the IP ACL rules

virtualNetworkRules

Sets the virtual network rules

PrivateEndpoint

The Private Endpoint resource.

Name Type Description
id
  • string

The ARM identifier for Private Endpoint

PrivateEndpointConnection

The Private Endpoint Connection resource.

Name Type Description
id
  • string

Fully qualified resource Id for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name
  • string

The name of the resource

properties.privateEndpoint

The resource of private end point.

properties.privateLinkServiceConnectionState

A collection of information about the state of the connection between service consumer and provider.

properties.provisioningState

The provisioning state of the private endpoint connection resource.

type
  • string

The type of the resource. Ex- Microsoft.Compute/virtualMachines or Microsoft.Storage/storageAccounts.

PrivateEndpointConnectionProvisioningState

The current provisioning state.

Name Type Description
Creating
  • string
Deleting
  • string
Failed
  • string
Succeeded
  • string

PrivateEndpointServiceConnectionStatus

The private endpoint connection status.

Name Type Description
Approved
  • string
Pending
  • string
Rejected
  • string

PrivateLinkServiceConnectionState

A collection of information about the state of the connection between service consumer and provider.

Name Type Description
actionRequired
  • string

A message indicating if changes on the service provider require any updates on the consumer.

description
  • string

The reason for approval/rejection of the connection.

status

Indicates whether the connection has been Approved/Rejected/Removed by the owner of the service.

ProvisioningState

Gets the status of the storage account at the time the operation was called.

Name Type Description
Creating
  • string
ResolvingDNS
  • string
Succeeded
  • string

RoutingChoice

Routing Choice defines the kind of network routing opted by the user.

Name Type Description
InternetRouting
  • string
MicrosoftRouting
  • string

RoutingPreference

Routing preference defines the type of network, either microsoft or internet routing to be used to deliver the user data, the default option is microsoft routing

Name Type Description
publishInternetEndpoints
  • boolean

A boolean flag which indicates whether internet routing storage endpoints are to be published

publishMicrosoftEndpoints
  • boolean

A boolean flag which indicates whether microsoft routing storage endpoints are to be published

routingChoice

Routing Choice defines the kind of network routing opted by the user.

Sku

The SKU of the storage account.

Name Type Description
name

The SKU name. Required for account creation; optional for update. Note that in older versions, SKU name was called accountType.

tier

The SKU tier. This is based on the SKU name.

SkuName

The SKU name. Required for account creation; optional for update. Note that in older versions, SKU name was called accountType.

Name Type Description
Premium_LRS
  • string
Premium_ZRS
  • string
Standard_GRS
  • string
Standard_GZRS
  • string
Standard_LRS
  • string
Standard_RAGRS
  • string
Standard_RAGZRS
  • string
Standard_ZRS
  • string

SkuTier

The SKU tier. This is based on the SKU name.

Name Type Description
Premium
  • string
Standard
  • string

State

Gets the state of virtual network rule.

Name Type Description
deprovisioning
  • string
failed
  • string
networkSourceDeleted
  • string
provisioning
  • string
succeeded
  • string

StorageAccount

The storage account.

Name Type Description
id
  • string

Fully qualified resource Id for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

identity

The identity of the resource.

kind

Gets the Kind.

location
  • string

The geo-location where the resource lives

name
  • string

The name of the resource

properties.accessTier

Required for storage accounts where kind = BlobStorage. The access tier used for billing.

properties.azureFilesIdentityBasedAuthentication

Provides the identity based authentication settings for Azure Files.

properties.creationTime
  • string

Gets the creation date and time of the storage account in UTC.

properties.customDomain

Gets the custom domain the user assigned to this storage account.

properties.encryption

Gets the encryption settings on the account. If unspecified, the account is unencrypted.

properties.failoverInProgress
  • boolean

If the failover is in progress, the value will be true, otherwise, it will be null.

properties.geoReplicationStats

Geo Replication Stats

properties.isHnsEnabled
  • boolean

Account HierarchicalNamespace enabled if sets to true.

properties.largeFileSharesState

Allow large file shares if sets to Enabled. It cannot be disabled once it is enabled.

properties.lastGeoFailoverTime
  • string

Gets the timestamp of the most recent instance of a failover to the secondary location. Only the most recent timestamp is retained. This element is not returned if there has never been a failover instance. Only available if the accountType is Standard_GRS or Standard_RAGRS.

properties.networkAcls

Network rule set

properties.primaryEndpoints

Gets the URLs that are used to perform a retrieval of a public blob, queue, or table object. Note that Standard_ZRS and Premium_LRS accounts only return the blob endpoint.

properties.primaryLocation
  • string

Gets the location of the primary data center for the storage account.

properties.privateEndpointConnections

List of private endpoint connection associated with the specified storage account

properties.provisioningState

Gets the status of the storage account at the time the operation was called.

properties.routingPreference

Maintains information about the network routing choice opted by the user for data transfer

properties.secondaryEndpoints

Gets the URLs that are used to perform a retrieval of a public blob, queue, or table object from the secondary location of the storage account. Only available if the SKU name is Standard_RAGRS.

properties.secondaryLocation
  • string

Gets the location of the geo-replicated secondary for the storage account. Only available if the accountType is Standard_GRS or Standard_RAGRS.

properties.statusOfPrimary

Gets the status indicating whether the primary location of the storage account is available or unavailable.

properties.statusOfSecondary

Gets the status indicating whether the secondary location of the storage account is available or unavailable. Only available if the SKU name is Standard_GRS or Standard_RAGRS.

properties.supportsHttpsTrafficOnly
  • boolean

Allows https traffic only to storage service if sets to true.

sku

Gets the SKU.

tags
  • object

Resource tags.

type
  • string

The type of the resource. Ex- Microsoft.Compute/virtualMachines or Microsoft.Storage/storageAccounts.

StorageAccountInternetEndpoints

The URIs that are used to perform a retrieval of a public blob, file, web or dfs object via a internet routing endpoint.

Name Type Description
blob
  • string

Gets the blob endpoint.

dfs
  • string

Gets the dfs endpoint.

file
  • string

Gets the file endpoint.

web
  • string

Gets the web endpoint.

StorageAccountListResult

The response from the List Storage Accounts operation.

Name Type Description
nextLink
  • string

Request URL that can be used to query next page of storage accounts. Returned when total number of requested storage accounts exceed maximum page size.

value

Gets the list of storage accounts and their properties.

StorageAccountMicrosoftEndpoints

The URIs that are used to perform a retrieval of a public blob, queue, table, web or dfs object via a microsoft routing endpoint.

Name Type Description
blob
  • string

Gets the blob endpoint.

dfs
  • string

Gets the dfs endpoint.

file
  • string

Gets the file endpoint.

queue
  • string

Gets the queue endpoint.

table
  • string

Gets the table endpoint.

web
  • string

Gets the web endpoint.

VirtualNetworkRule

Virtual Network rule.

Name Type Description
action

The action of virtual network rule.

id
  • string

Resource ID of a subnet, for example: /subscriptions/{subscriptionId}/resourceGroups/{groupName}/providers/Microsoft.Network/virtualNetworks/{vnetName}/subnets/{subnetName}.

state

Gets the state of virtual network rule.