Listar contas de armazenamento

  • Artigo

 

O List Storage Accounts operação lista as contas de armazenamento estão disponíveis na assinatura especificada.

Solicitação

O List Storage Accounts solicitação pode ser especificada da seguinte maneira. Substitua <subscription-id> pela sua ID de assinatura.

Método URI de solicitação
GET https://management.core.windows.net/<subscription-id>/services/storageservices

Verifique se a solicitação feita ao serviço de gerenciamento é segura. Para obter mais detalhes, consulte solicitações de gerenciamento de serviço de autenticação.

Parâmetros URI

Nenhuma.

Cabeçalhos de solicitação

A tabela a seguir descreve os cabeçalhos da solicitação.

Cabeçalho de solicitação Descrição
x-ms-version Obrigatório. Especifica a versão da operação a ser usada para esta solicitação. Este cabeçalho deve ser definido como 2009-10-01 ou superior. Para obter mais informações sobre cabeçalhos de controle de versão, consulte o controle de versão do serviço de gerenciamento.

Corpo da solicitação

Nenhuma.

Resposta

A resposta inclui um código de status HTTP, um conjunto de cabeçalhos de resposta e um corpo de resposta.

Código de status

Uma operação bem-sucedida retorna o código de status 200 (OK).

Para obter informações sobre códigos de status, consulte Status do gerenciamento de serviço e códigos de erro.

Cabeçalhos de resposta

A resposta para esta operação inclui os cabeçalhos a seguir. A resposta também pode incluir cabeçalhos padrão HTTP adicionais. Todos os cabeçalhos padrão obedecem a especificação de protocolo HTTP/1.1.

Cabeçalho de resposta Descrição
x-ms-request-id Um valor que identifica exclusivamente uma solicitação feita no serviço de gerenciamento.

Corpo da resposta

Formato do corpo da resposta:

  
<?xml version="1.0" encoding="utf-8"?> <StorageServices xmlns=”https://schemas.microsoft.com/windowsazure”> <StorageService> <Url>storage-service-address</Url> <ServiceName>storage-service-name</ServiceName> <StorageServiceProperties> <Description>description</Description> <AffinityGroup>affinity-group</AffinityGroup> <Location>location-of-storage-account</Location> <Label>base64-encoded-label</Label> <Status>status</Status> <Endpoints> <Endpoint>storage-service-blob-endpoint</Endpoint> <Endpoint>storage-service-queue-endpoint</Endpoint> <Endpoint>storage-service-table-endpoint</Endpoint> <Endpoint>storage-service-file-endpoint</Endpoint> </Endpoints> <GeoReplicationEnabled>geo-replication-indicator</GeoReplicationEnabled> <GeoPrimaryRegion>primary-region</GeoPrimaryRegion> <StatusOfPrimary>primary-status</StatusOfPrimary> <LastGeoFailoverTime>DateTime</LastGeoFailoverTime> <GeoSecondaryRegion>secondary-region</GeoSecondaryRegion> <StatusOfSecondary>secondary-status</StatusOfSecondary> <CreationTime>time-of-creation</CreationTime> <CustomDomains> <CustomDomain> <Name>name-of-custom-domain</Name> </CustomDomain> </CustomDomains> <SecondaryReadEnabled>secondary-read-indicator</SecondaryReadEnabled> <SecondaryEndpoints> <Endpoint>storage-secondary-service-blob-endpoint</Endpoint> <Endpoint>storage-secondary-service-queue-endpoint</Endpoint> <Endpoint>storage-secondary-service-table-endpoint</Endpoint> </SecondaryEndpoints> <AccountType>type-of-storage-account</AccountType> </StorageServiceProperties> <ExtendedProperties> <ExtendedProperty> <Name>property-name</Name> <Value>property-value</Value> </ExtendedProperty> </ExtendedProperties> </StorageService> </StorageServices>

A tabela a seguir descreve os elementos do corpo da resposta.

Nome do elemento Descrição
Url Especifica o URI da conta de armazenamento.
ServiceName Especifica o nome da conta de armazenamento. Esse nome é o nome do prefixo DNS e pode ser usado para acessar blobs, filas e tabelas na conta de armazenamento.

Por exemplo, se o nome do serviço é MyStorageAccount poderá acessar os contêineres de blob chamando: http://MyStorageAccount.blob.core.windows.net/mycontainer/
StorageServiceProperties Especifica as propriedades da conta de armazenamento.
ExtendedProperties Especifica o nome e o valor de uma propriedade estendida que foi adicionada à conta de armazenamento.

StorageServiceProperties

Especifica as propriedades da conta de armazenamento.

Nome do elemento Descrição
Descrição Opcional. Uma descrição para a conta de armazenamento. A descrição pode ter até 1024 caracteres.

O Description elemento só está disponível com a versão 2012-03-01 ou superior.
AffinityGroup Necessário se Location não for especificado. O nome de um grupo de afinidade existente associado a essa assinatura. Esse nome é um GUID e pode ser recuperada, examinando o elemento de nome do corpo da resposta retornado pelo Listar grupos de afinidade operação.

O AffinityGroup elemento só está disponível com a versão 2012-03-01 ou superior.
Local Necessário se AffinityGroup não for especificado. O local em que a conta de armazenamento será criada.

O Location elemento só está disponível com a versão 2012-03-01 ou superior.
Rótulo Obrigatório. Um nome para o serviço hospedado codificado em base 64. O nome pode ter até 100 caracteres. O nome pode ser usado para identificar a conta de armazenamento para suas finalidades de acompanhamento.

O Label elemento só está disponível com a versão 2012-03-01 ou superior.
Status O status da conta de armazenamento. Os possíveis valores são:

- Creating
- Created
- Deleting
- Deleted
- Changing
- ResolvingDns

O Status elemento só está disponível com a versão 2012-03-01 ou superior.
Pontos de extremidade O blob, a tabela, a fila e os pontos de extremidade do arquivo.

Observação 1: O ponto de extremidade do arquivo está no modo de visualização e será retornado apenas para assinaturas de visualização.

Observe também que 2 Observação: o tipo de conta Standard_ZRS, somente o ponto de extremidade do blob será retornado. O ZRS também suporta apenas blocos de blobs, não páginas de blobs, e não é compatível com o IaaS VMs.

Observação 3: Para o tipo de conta Premium_LRS, apenas o ponto de extremidade blob é retornado.
GeoReplicationEnabled Indica se os dados na conta de armazenamento são replicados em mais de um local geográfico para habilitar a resiliência caso ocorra uma perda catastrófica do serviço. O valor é true se a replicação geográfica estiver habilitada; caso contrário false.

O GeoReplicationEnabled elemento só está disponível com a versão 2012-03-01 ou superior e é substituído pelo elemento AccountType com a versão 2014-06-01 ou superior.
GeoPrimaryRegion Indica a região geográfica principal em que a conta de armazenamento existe no momento.

O GeoPrimaryRegion elemento só está disponível com a versão 2012-03-01 ou superior.
StatusOfPrimary Indica se a região de armazenamento primária está disponível.

Os possíveis valores são:

- Available
- Unavailable

O StatusOfPrimary elemento só está disponível com a versão 2013-11-01 ou superior.
LastGeoFailoverTime Um carimbo de data/hora que indica a instância mais recente de um failover na região secundária. No caso de vários failovers, somente a data e a hora mais recentes de failover serão mantidas.

O formato de carimbo de data/hora retornada é: [AnoDe4Dígitos]-[MêsDe2Dígitos]-[DiaDe2Dígitos]T[MinutosDe2Dígitos]:[SegundosDe2Dígitos]:[7DígitosDePrecisão]Z

Por exemplo: < LastGeoFailoverTime > 2010-01-18T13:15:30.0000000Z < / LastGeoFailoverTime >

LastGeoFailoverTime não será retornado se não houver uma instância de um failover.

O LastGeoFailoverTime elemento só está disponível com a versão 2012-03-01 ou superior.
GeoSecondaryRegion Indica a região geográfica em que a conta de armazenamento está sendo replicada

O elemento GeoSecondaryRegion não será retornado se a replicação geográfica estiver desativada para esta conta.

O GeoSecondaryRegion elemento só está disponível com a versão 2012-03-01 ou superior.
StatusOfSecondary Indica se a região de armazenamento secundária está disponível.

O StatusOfSecondary elemento só está disponível com a versão 2013-11-01 ou superior.

Os possíveis valores são:

- Available
- Unavailable
CreationTime Especifica a data em que a conta de armazenamento foi criada.
CustomDomains Especifica os domínios personalizados que são associados à conta de armazenamento.

O CustomDomains elemento só está disponível com a versão 2013-06-01 ou superior.
SecondaryReadEnabled Indica que a leitura secundária está habilitada para a conta de armazenamento.

Os possíveis valores são:

- true
- false

O SecondaryReadEnabled elemento só está disponível com a versão 2013-11-01 ou superior e é substituído pelo elemento AccountType com a versão 2014-06-01 ou superior.
SecondaryEndpoints Especifica os pontos de extremidade secundários da conta de armazenamento.

O SecondaryEndpoints elemento só está disponível com a versão 2013-11-01 ou superior.
AccountType Especifica se a conta comporta armazenamento com redundância local, armazenamento com redundância geográfica, armazenamento com redundância de zona ou armazenamento com redundância geográfica com acesso de leitura.

Os possíveis valores são:

- Standard_LRS
- Standard_ZRS
- Standard_GRS
- Standard_RAGRS
- Premium_LRS

O AccountType elemento só está disponível com a versão 2014-06-01 ou superior e substitui os elementos SecondaryReadEnabled e GeoReplicationEnabled.

O Premium_LRS elemento só está disponível com a versão 2014-10-01 ou superior.

Pontos de extremidade

Especifica os pontos de extremidade da conta de armazenamento.

Nome do elemento Descrição
Ponto de Extremidade Contém o ponto de extremidade de serviço blob no seguinte formato: https://<storage-service-name>.blob.core.windows.net

O Endpoint elemento só está disponível com a versão 2012-03-01 ou superior. Os pontos de extremidade http são retornados com a versão 01/04/2014 ou anterior.
Ponto de Extremidade Contém o ponto de extremidade do serviço de fila no seguinte formato: https://<storage-service-name>.queue.core.windows.net

O Endpoint elemento só está disponível com a versão 2012-03-01 ou superior. Os pontos de extremidade http são retornados com a versão 01/04/2014 ou anterior.
Ponto de Extremidade Contém o ponto de extremidade do serviço de tabela no seguinte formato: https://<storage-service-name>.table.core.windows.net

O Endpoint elemento só está disponível com a versão 2012-03-01 ou superior. Os pontos de extremidade http são retornados com a versão 01/04/2014 ou anterior.
Ponto de Extremidade Contém o ponto de extremidade de serviço de arquivo no seguinte formato: https://<storage-service-name>.file.core.windows.net

O Endpoint elemento só está disponível com a versão 2012-03-01 ou superior. Os pontos de extremidade http são retornados com a versão 01/04/2014 ou anterior.

CustomDomains

Especifica os domínios personalizados que são associados à conta de armazenamento.

Nome do elemento Descrição
CustomDomain Especifica informações sobre um domínio personalizado que é associado à conta de armazenamento.
Nome Especifica o nome do domínio personalizado.

SecondaryEndpoints

Especifica os pontos de extremidade secundários da conta de armazenamento.

Nome do elemento Descrição
Ponto de Extremidade Contém o ponto de extremidade de serviço secundário de blob no seguinte formato: https://<storage-secondary-service-name>.blob.core.windows.net

Os pontos de extremidade http são retornados com a versão 01/04/2014 ou anterior.
Ponto de Extremidade Contém o ponto de extremidade do serviço de fila no seguinte formato: https://<storage-secondary-service-name>.queue.core.windows.net

Os pontos de extremidade http são retornados com a versão 01/04/2014 ou anterior.
Ponto de Extremidade Contém o ponto de extremidade do serviço de tabela no seguinte formato: https://<storage-secondary-service-name>.table.core.windows.net

Os pontos de extremidade http são retornados com a versão 01/04/2014 ou anterior.

ExtendedProperties

Especifica o nome e o valor de uma propriedade estendida que foi adicionada à conta de armazenamento.

Nome do elemento Descrição
Nome Opcional. Representa o nome de uma propriedade estendida da conta de armazenamento. Cada propriedade estendida deve ter um nome e um valor definido. Você pode ter um máximo de 50 propriedades estendidas como pares de nome/valor.

O comprimento máximo do elemento Nome é de 64 caracteres, somente os caracteres alfanuméricos e sublinhados são válidos no Nome, e o nome deve começar com uma letra. Tentar usar outros caracteres, começar o Nome com um caractere diferente de letra ou inserir um nome que seja idêntico ao de outra propriedade estendida de propriedade da mesma conta de armazenamento resultará em um erro de código de status 400 (Solicitação Incorreta).

O Name elemento só está disponível com a versão 2012-03-01 ou superior.
Valor Opcional. Representa o valor de uma propriedade estendida da conta de armazenamento. Cada propriedade estendida deve ter um nome e um valor definido. Você pode ter até 50 pares de nome/valor da propriedade estendida, e cada valor de propriedade estendida terá um comprimento máximo de 255 caracteres.

O Value elemento só está disponível com a versão 2012-03-01 ou superior.

Comentários

Se o x-ms-version for 2012-03-01 ou posterior e o grupo de afinidade foi criado em uma das regiões Anywhere US, Anywhere Europe, Anywhere Asia regiões, o Location elemento retornará o local onde esse grupo de afinidade estiver alocado agora.

O List Storage Accounts operação pode ser usada para obter os URIs a ser usado para outras operações em contas de armazenamento, como Obter propriedades da conta de armazenamento, Obter Chaves da Conta de Armazenamento, Excluir conta de armazenamento, e Atualizar conta de armazenamento.

Exemplo

O programa de exemplo a seguir usa a ID da assinatura, uma impressão digital do certificado de gerenciamento associado e a cadeia de caracteres da versão da operação, e imprime as chaves da conta de armazenamento retornadas para o console. Inicializar o msVersion, subscriptionId, e thumbprint variáveis com seus próprios valores para executar o código de exemplo. Este exemplo usa x-ms-version 2011-10-01.

using System; using System.Collections.Generic; using System.Net; using System.Security.Cryptography.X509Certificates; using System.Xml; using System.Xml.Linq; class Program { static void Main(string[] args) { string msVersion = "2011-10-01"; string subscriptionId = "subscription-id-guid"; string thumbprint = "certificate-thumbprint"; try { // Obtain the certificate with the specified thumbprint X509Certificate2 certificate = GetCertificate(thumbprint); ListStorageAccountsExample(subscriptionId, certificate, msVersion); } catch (Exception ex) { Console.WriteLine("Exception caught in Main:"); Console.WriteLine(ex.Message); } } public static X509Certificate2 GetCertificate(string thumbprint) { List<StoreLocation> locations = new List<StoreLocation> { StoreLocation.CurrentUser, StoreLocation.LocalMachine }; foreach (var location in locations) { X509Store store = new X509Store("My", location); try { store.Open(OpenFlags.ReadOnly | OpenFlags.OpenExistingOnly); X509Certificate2Collection certificates = store.Certificates.Find( X509FindType.FindByThumbprint, thumbprint, false); if (certificates.Count == 1) { return certificates[0]; } } finally { store.Close(); } } throw new ArgumentException(string.Format( "A certificate with thumbprint '{0}' could not be located.", thumbprint)); } public static void ListStorageAccountsExample( string subscriptionId, X509Certificate2 certificate, string version) { string uriFormat = "https://management.core.windows.net/{0}/services/storageservices"; Uri uri = new Uri(String.Format(uriFormat, subscriptionId)); HttpWebRequest request = (HttpWebRequest)HttpWebRequest.Create(uri); request.Method = "GET"; request.Headers.Add("x-ms-version", version); request.ClientCertificates.Add(certificate); request.ContentType = "application/xml"; XDocument responseBody = null; HttpStatusCode statusCode; HttpWebResponse response; try { response = (HttpWebResponse)request.GetResponse(); } catch (WebException ex) { // GetResponse throws a WebException for 400 and 500 status codes response = (HttpWebResponse)ex.Response; } statusCode = response.StatusCode; if (response.ContentLength > 0) { using (XmlReader reader = XmlReader.Create(response.GetResponseStream())) { responseBody = XDocument.Load(reader); } } response.Close(); if (statusCode.Equals(HttpStatusCode.OK)) { XNamespace wa = "https://schemas.microsoft.com/windowsazure"; XElement storageServices = responseBody.Element(wa + "StorageServices"); int storageCount = 0; foreach (XElement storageService in storageServices.Elements(wa + "StorageService")) { string url = storageService.Element(wa + "Url").Value; string serviceName = storageService.Element(wa + "ServiceName").Value; Console.WriteLine( "Location[{0}]{1}  Name: {2}{1}  DisplayName: {3}", storageCount++, Environment.NewLine, url, serviceName); } } else { Console.WriteLine("Call to List Storage Accounts returned an error:"); Console.WriteLine("Status Code: {0} ({1}):{2}{3}", (int)statusCode, statusCode, Environment.NewLine, responseBody.ToString(SaveOptions.OmitDuplicateNamespaces)); } return; } }