Listar Contentores

A List Containers operação devolve uma lista dos contentores na conta de armazenamento especificada.

Pedir

Pode construir o pedido da List Containers seguinte forma. É recomendado HTTPS. Substitua myaccount pelo nome da sua conta de armazenamento.

Tenha em atenção que o URI tem de incluir sempre a barra (/) para separar o nome do anfitrião das partes de caminho e consulta do URI. No caso da List Containers operação, a parte do caminho do URI está vazia.

Pedido de serviço de armazenamento emulado

Quando fizer um pedido contra o serviço de armazenamento emulado, especifique o nome do anfitrião do emulador e Armazenamento de Blobs do Azure porta como 127.0.0.1:10000, seguido do nome da conta de armazenamento emulada.

Tenha em atenção que o armazenamento emulado só suporta tamanhos de blobs até 2 GiB.

Para obter mais informações, veja Utilizar o emulador Azurite para desenvolvimento do Armazenamento do Azure local e Diferenças entre o emulador de Armazenamento e os serviços de Armazenamento do Azure.

Parâmetros URI

Pode especificar os seguintes parâmetros adicionais no URI do pedido.

Cabeçalhos do pedido

A tabela seguinte descreve os cabeçalhos de pedido obrigatórios e opcionais.

Corpo do pedido

Nenhum.

Resposta

A resposta inclui um código de estado HTTP, um conjunto de cabeçalhos de resposta e um corpo de resposta no formato XML.

Código de estado

Uma operação bem-sucedida devolve o código de estado 200 (OK). Para obter informações sobre códigos de estado, veja Códigos de estado e de erro.

Cabeçalhos de resposta

A resposta para esta operação inclui os seguintes cabeçalhos. A resposta também inclui cabeçalhos HTTP padrão adicionais. Todos os cabeçalhos padrão estão em conformidade com a especificação do protocolo HTTP/1.1.

Corpo da resposta

O formato do corpo da resposta é o seguinte.

<?xml version="1.0" encoding="utf-8"?>  
<EnumerationResults ServiceEndpoint="https://myaccount.blob.core.windows.net">  
  <Prefix>string-value</Prefix>  
  <Marker>string-value</Marker>  
  <MaxResults>int-value</MaxResults>  
  <Containers>  
    <Container>  
      <Name>container-name</Name>  
      <Version>container-version</Version>
      <Deleted>true</Deleted>
      <Properties>  
        <Last-Modified>date/time-value</Last-Modified>  
        <Etag>etag</Etag>  
        <LeaseStatus>locked | unlocked</LeaseStatus>  
        <LeaseState>available | leased | expired | breaking | broken</LeaseState>  
        <LeaseDuration>infinite | fixed</LeaseDuration> 
        <PublicAccess>container | blob</PublicAccess>
        <HasImmutabilityPolicy>true | false</HasImmutabilityPolicy>
        <HasLegalHold>true | false</HasLegalHold>
        <DeletedTime>datetime</DeletedTime>
        <RemainingRetentionDays>no-of-days</RemainingRetentionDays>
      </Properties>  
      <Metadata>  
        <metadata-name>value</metadata-name>  
      </Metadata>  
    </Container>  
  </Containers>  
  <NextMarker>marker-value</NextMarker>  
</EnumerationResults>  

LeaseStatus, LeaseStatee LeaseDuration só aparecem na versão 2012-02-12 e posterior.

A partir da versão 2013-08-15, o AccountName atributo do EnumerationResults elemento foi mudado para ServiceEndpoint. O URL elemento também foi removido do Container elemento . Para versões anteriores a 2013-08-15, o URL do contentor, conforme especificado pelo URL campo, não inclui o restype=container parâmetro . Se utilizar este valor para fazer pedidos subsequentes relativamente aos contentores enumerados, confirme que acrescenta este parâmetro para indicar que o tipo de recurso é um contentor.

Os Prefixelementos , Markere MaxResults só estão presentes se os especificar no URI. O NextMarker elemento só tem um valor se os resultados da lista não estiverem concluídos.

O Metadata elemento só está presente se especificar o include=metadata parâmetro no URI. Metadata No elemento , o valor de cada par nome-valor é listado dentro de um elemento correspondente ao nome do par.

Se um par nome-valor de metadados violar as restrições de nomenclatura impostas pela versão 2009-09-19, o corpo da resposta indica o nome problemático dentro de um x-ms-invalid-name elemento. O fragmento XML seguinte mostra o seguinte:

  
<Metadata>  
  <MyMetadata1>first value</MyMetadata1>  
  <MyMetadata2>second value</MyMetadata2>  
  <x-ms-invalid-name>invalid-metadata-name</x-ms-invalid-name>  
</Metadata>  
  

A partir da versão 2016-05-31, as permissões públicas do contentor são fornecidas na PublicAccess propriedade . Indica se os dados no contentor podem ser acedidos publicamente e o nível de acesso. Valores possíveis incluem:

• container: indica acesso de leitura público completo para dados de contentores e blobs. Os clientes podem enumerar blobs no contentor através de um pedido anónimo, mas não podem enumerar contentores na conta de armazenamento.
• blob: indica o acesso de leitura público para blobs. Os dados de blobs neste contentor podem ser lidos através de um pedido anónimo, mas os dados de contentor não estão disponíveis. Os clientes não podem enumerar blobs no contentor através de um pedido anónimo.

Se esta propriedade não for especificada na <properties> secção , o contentor é privado para o proprietário da conta.

HasImmutabilityPolicy e HasLegalHold só aparecem na versão 2017-11-09 e posterior. HasImmutabilityPolicy é true se o contentor tiver uma política de imutabilidade definida, caso false contrário. HasLegalHold se true o contentor tiver uma ou mais retenções legais, caso false contrário.

Os Versionelementos , Deleted, DeletedTimee RemainingRetentiondays só aparecem na versão 2019-12-12 e posterior se especificar o deleted valor para o parâmetro includede consulta . Estes elementos só aparecem se o contentor for eliminado de forma recuperável e for elegível para ser restaurado. Os Versionelementos , Deleted, DeletedTimee RemainingRetentiondays só aparecem na versão 2019-12-12 e posterior se o valor eliminado for especificado para o include parâmetro de consulta e se o contentor for eliminado de forma recuperável e elegível para ser restaurado.

Autorização

A autorização é necessária ao chamar qualquer operação de acesso a dados no Armazenamento do Azure. Pode autorizar a List Containers operação conforme descrito abaixo.

Observações

Se especificar um valor para o maxresults parâmetro e o número de contentores a devolver exceder este valor ou exceder o valor predefinido para maxresults, o corpo da resposta irá conter o NextMarker elemento . (Isto também é referido como um token de continuação).

NextMarker indica o contentor seguinte a devolver num pedido subsequente. Para devolver o próximo conjunto de itens, especifique o valor de NextMarker para o marker parâmetro no URI para o pedido subsequente. Tenha em atenção que o valor de NextMarker deve ser tratado como opaco.

Se a operação de listagem atravessar um limite de partição, o serviço devolverá um valor para o NextMarker elemento para obter o resto dos resultados da partição seguinte. Uma operação de listagem que abrange mais do que uma partição resulta na devolução de um conjunto mais pequeno de itens do que o especificado por maxresultsou do que a predefinição de 5000. A sua aplicação deve sempre verificar a presença do NextMarker elemento quando executa uma operação de listagem e processá-lo em conformidade.

Os contentores são listados por ordem alfabética no corpo da resposta.

A List Containers operação excede o limite de tempo após 30 segundos.

Faturação

Os pedidos de preços podem ter origem em clientes que utilizam APIs de Armazenamento de Blobs, diretamente através da API REST do Armazenamento de Blobs ou a partir de uma biblioteca de cliente do Armazenamento do Azure. Estes pedidos acumulam custos por transação. O tipo de transação afeta a forma como a conta é cobrada. Por exemplo, as transações de leitura acumulam-se numa categoria de faturação diferente das transações de escrita. A tabela seguinte mostra a categoria de faturação dos List Containers pedidos com base no tipo de conta de armazenamento:

Para saber mais sobre os preços da categoria de faturação especificada, veja Preços do Armazenamento de Blobs do Azure.

Pedido e resposta de exemplo

O URI de exemplo seguinte pede a lista de contentores para uma conta, definindo os resultados máximos a devolver para a operação inicial para três.

GET https://myaccount.blob.core.windows.net/?comp=list&maxresults=3 HTTP/1.1  

O pedido é enviado com estes cabeçalhos:

x-ms-version: 2016-05-31  
x-ms-date: Wed, 26 Oct 2016 22:08:44 GMT  
Authorization: SharedKey myaccount:CY1OP3O3jGFpYFbTCBimLn0Xov0vt0khH/D5Gy0fXvg=  

O código de estado e os cabeçalhos de resposta são devolvidos da seguinte forma:

HTTP/1.1 200 OK  
Transfer-Encoding: chunked  
Content-Type: application/xml  
Date: Wed, 26 Oct 2016 22:08:54 GMT  
x-ms-version: 2016-05-31  
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0  
  

O XML de resposta para este pedido é o seguinte. Tenha em atenção que o NextMarker elemento segue o conjunto de contentores e inclui o nome do contentor seguinte a ser devolvido.

<?xml version="1.0" encoding="utf-8"?>  
<EnumerationResults ServiceEndpoint="https://myaccount.blob.core.windows.net/">  
  <MaxResults>3</MaxResults>  
  <Containers>  
    <Container>  
      <Name>audio</Name>  
      <Properties>  
        <Last-Modified>Wed, 26 Oct 2016 20:39:39 GMT</Last-Modified>  
        <Etag>0x8CACB9BD7C6B1B2</Etag> 
        <PublicAccess>container</PublicAccess> 
      </Properties>  
    </Container>  
    <Container>  
      <Name>images</Name>  
      <Properties>  
        <Last-Modified>Wed, 26 Oct 2016 20:39:39 GMT</Last-Modified>  
        <Etag>0x8CACB9BD7C1EEEC</Etag>  
      </Properties>  
    </Container>  
    <Container>  
      <Name>textfiles</Name>  
      <Properties>  
        <Last-Modified>Wed, 26 Oct 2016 20:39:39 GMT</Last-Modified>  
        <Etag>0x8CACB9BD7BACAC3</Etag>  
      </Properties>  
    </Container>  
  </Containers>  
  <NextMarker>video</NextMarker>  
</EnumerationResults>  

A operação de lista subsequente especifica o marcador no URI do pedido, da seguinte forma. O próximo conjunto de resultados é devolvido, começando pelo contentor especificado pelo marcador.

https://myaccount.blob.core.windows.net/?comp=list&maxresults=3&marker=video  

Ver também

Autorizar pedidos para o Armazenamento do Azure
Códigos de estado e de erro
Códigos de erro do Armazenamento de Blobs
Enumerar recursos de blobs
Utilizar o emulador do Armazenamento do Azure para desenvolvimento e teste
Definir tempos limite para operações de Armazenamento de Blobs