Blobs lista

A List Blobs operação devolve uma lista das bolhas sob o recipiente especificado.

Pedir

Pode construir o pedido da List Blobs seguinte forma. HTTPS é recomendado. Substitua a minha conta pelo nome da sua conta de armazenamento.

Método URI do pedido Versão HTTP
GET https://myaccount.blob.core.windows.net/mycontainer?restype=container&comp=list HTTP/1.1

Serviço de armazenamento emulsionado URI

Quando fizer um pedido contra o serviço de armazenamento emulsionado, especifique o nome de 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.

Método URI do pedido Versão HTTP
GET http://127.0.0.1:10000/devstoreaccount1/mycontainer?restype=container&comp=list HTTP/1.1

Para obter mais informações, consulte o emulador Azurite para o desenvolvimento local do Armazenamento Azure.

Parâmetros URI

Pode especificar os seguintes parâmetros adicionais no URI.

Parâmetro Description
prefix Opcional. Filtra os resultados para devolver apenas bolhas com nomes que começam com o prefixo especificado.
delimiter Opcional. Quando o pedido inclui este parâmetro, a operação devolve um BlobPrefix elemento no organismo de resposta. Este elemento funciona como um espaço reservado para todas as bolhas com nomes que começam com o mesmo sub-atrof, até ao aparecimento do personagem delimiter. O delimiter pode ser um único personagem ou uma corda.
marker Opcional. Um valor de cadeia que identifica a parte da lista a ser devolvida com a próxima operação da lista. A operação devolve um valor de marcador dentro do organismo de resposta se a lista devolvida não estiver completa. Em seguida, pode utilizar o valor do marcador numa chamada posterior para solicitar o próximo conjunto de itens de lista.

O valor do marcador é opaco para o cliente.
maxresults Opcional. Especifica o número máximo de bolhas para devolver, incluindo todos os BlobPrefix elementos. Se o pedido não especificar maxresults, ou especificar um valor superior a 5.000, o servidor retornará até 5.000 itens. Se houver resultados adicionais para devolver, o serviço devolve um sinal de continuação no NextMarker elemento de resposta. Em certos casos, o serviço pode devolver menos resultados do que o especificado por maxresults, e também devolver um token de continuação.

Definir maxresults um valor inferior ou igual a zero resulta no código de resposta de erro 400 (Mau Pedido).
include={snapshots,metadata,uncommittedblobs,copy,deleted,tags,versions,
deletedwithversions,immutabilitypolicy,legalhold,permissions}
Opcional. Especifica um ou mais conjuntos de dados para incluir na resposta:

- snapshots: Especifica que os instantâneos devem ser incluídos na enumeração. Os instantâneos são listados do mais antigo ao mais recente na resposta.
- metadata: Especifica que os metadados blob sejam devolvidos na resposta.
- uncommittedblobs: Especifica que as bolhas para as quais os blocos foram carregados, mas que não foram cometidas utilizando a Lista de Blocos de Put, sejam incluídas na resposta.
- copy: Versão 2012-02-12 e posterior. Especifica que os metadados relacionados com qualquer operação corrente ou anterior Copy Blob devem ser incluídos na resposta.
-deleted: Versão 2017-07-29 e posterior. Especifica que as bolhas apagadas devem ser incluídas na resposta.
-tags: Versão 2019-12-12 e posterior. Especifica que as tags de índice blob definidas pelo utilizador devem ser incluídas na resposta.
-versions: Versão 2019-12-12 e posterior. Especifica que as versões de bolhas devem ser incluídas na enumeração.
-deletedwithversions: Versão 2020-10-02 e posterior. Especifica que as bolhas eliminadas com quaisquer versões (ativas ou eliminadas) devem ser incluídas na resposta. Use a etiqueta \<HasVersionsOnly\>, e o valor true.
-immutabilitypolicy: Versão 2020-06-12 e posterior. Especifica que a enumeração deve incluir a política de imutabilidade até à data e o modo de política de imutabilidade das bolhas.
-legalhold: Versão 2020-06-12 e posterior. Especifica que a enumeração deve incluir o porão legal de bolhas.
-permissions: Versão 2020-06-12 e posterior. Suportado apenas para contas com um espaço hierárquico habilitado. Se um pedido incluir este parâmetro, então o proprietário, grupo, permissões e lista de controlo de acesso para as bolhas ou diretórios listados serão incluídos na enumeração.

Para especificar mais de uma destas opções no URI, deve separar cada opção com uma vírgula codificada por URL ("%82").
showonly={deleted,files,directories} Opcional. Especifica um destes conjuntos de dados a devolver na resposta:

-deleted: Opcional. Versão 2020-08-04 e depois. Apenas para contas ativadas com espaço hierárquico de nomes. Quando um pedido inclui este parâmetro, a lista contém apenas bolhas apagadas suaves. Se include=deleted também for especificado, o pedido falha com Mau Pedido (400).
-files: Opcional. Versão 2020-12-06 e depois. Apenas para contas ativadas com espaço hierárquico de nomes. Quando um pedido inclui este parâmetro, a lista contém apenas ficheiros.
-directories: Opcional. Versão 2020-12-06 e depois. Apenas para contas ativadas com espaço hierárquico de nomes. Quando um pedido inclui este parâmetro, a lista contém apenas diretórios.
timeout Opcional. O timeout parâmetro é expresso em segundos. Para obter mais informações, consulte os intervalos de definição para as operações de Armazenamento blob.

Cabeçalhos do pedido

A tabela seguinte descreve os cabeçalhos de pedido necessários e opcionais.

Cabeçalho do pedido Description
Authorization Obrigatório. Especifica o esquema de autorização, nome da conta e assinatura. Para mais informações, consulte Os pedidos autorizados para o Armazenamento Azure.
Date ou x-ms-date Obrigatório. Especifica a Hora Universal Coordenada (UTC) do pedido. Para mais informações, consulte Os pedidos autorizados para o Armazenamento Azure.
x-ms-version Requerido para todos os pedidos autorizados, e opcional para pedidos anónimos. Especifica a versão da operação a utilizar para este pedido. Para mais informações, consulte a versão para os serviços de Armazenamento Azure.
x-ms-client-request-id Opcional. Fornece um valor opaco gerado pelo cliente com um limite de caracteres de 1 kibibyte (KiB) que é gravado nos registos do Monitor Azure quando o registo é configurado. Recomendamos vivamente que utilize este cabeçalho para correlacionar as atividades do lado do cliente com os pedidos que o servidor recebe. Para mais informações, consulte monitor Armazenamento de Blobs do Azure.
x-ms-upn Opcional. Válido apenas quando um espaço hierárquico estiver ativado para a conta, e include=permissions é fornecido no pedido. Setrue, os valores de identidade do <utilizador devolvidos nos campos Proprietário>, <Grupo> e <Acl> forem transformados de IDs de objeto Azure Ative (Azure AD) para nomes principais do utilizador. Sefalse, os valores forem devolvidos como Azure AD iDs de objeto. O valor predefinido é false. Note que os IDs de grupo e de objetos de aplicação não são traduzidos porque não têm nomes amigáveis únicos.

Corpo do pedido

Nenhum.

Pedido de amostra

Consulte os recursos de enumeração blob para um pedido de amostra.

Resposta

A resposta inclui um código de estado HTTP, um conjunto de cabeçalhos de resposta e um corpo de resposta em 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, consulte 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 pode incluir cabeçalhos HTTP padrão adicionais. Todos os cabeçalhos standard estão de acordo com a especificação do protocolo HTTP/1.1.

Cabeçalho de resposta Descrição
Content-Type Especifica o formato em que os resultados são devolvidos. Atualmente este valor é application/xml.
x-ms-request-id Este cabeçalho identifica exclusivamente o pedido que foi feito, e pode ser usado para resolver problemas no pedido. Para mais informações, consulte as operações da API de resolução de problemas.
x-ms-version Indica a versão do Blob Storage usada para executar o pedido. Este cabeçalho é devolvido para pedidos feitos utilizando a versão 2009-09-19 e mais tarde.

Este cabeçalho também é devolvido para pedidos anónimos, sem uma versão especificada, se o recipiente foi marcado para acesso público utilizando a versão 2009-09-19 do Blob Storage.
Date Um valor de data/hora UTC que indica a hora em que a resposta foi iniciada. O serviço gera este valor.
x-ms-client-request-id Pode utilizar este cabeçalho para resolver pedidos e respostas correspondentes. O valor deste cabeçalho é igual ao valor do x-ms-client-request-id cabeçalho, se estiver presente no pedido. O valor é no máximo 1024 caracteres ASCII visíveis. Se o x-ms-client-request-id cabeçalho não estiver presente no pedido, este cabeçalho não estará presente na resposta.

Corpo da resposta

O formato da resposta XML é o seguinte.

Note que os Prefix, Markere MaxResultselementos só estão Delimiter presentes se forem especificados no pedido URI. O NextMarker elemento só tem um valor se os resultados da lista não estiverem completos.

Os instantâneos, metadados blob e bolhas não comprometidas só estão incluídos na resposta se forem especificados com o include parâmetro do pedido URI.

Na versão 2009-09-19 e mais tarde, as propriedades da bolha são encapsuladas dentro de um Properties elemento.

Começando pela versão 2009-09-19, List Blobs devolve os seguintes elementos renomeados no organismo de resposta:

  • Last-Modified (anteriormente LastModified)

  • Content-Length (anteriormente Size)

  • Content-Type (anteriormente ContentType)

  • Content-Encoding (anteriormente ContentEncoding)

  • Content-Language (anteriormente ContentLanguage)

O Content-MD5 elemento aparece para bolhas criadas com a versão 2009-09-19 e mais tarde. Na versão 2012-02-12 e mais tarde, o Blob Storage calcula o Content-MD5 valor quando carrega uma bolha utilizando o Put Blob. O Blob Storage não calcula isto quando cria uma bolha utilizando a Lista de Blocos de Put. Pode definir explicitamente o Content-MD5 valor quando criar a bolha, ou ligando para as operações 'Put Block List' ou "set Blob Properties ".

Para versões de 2009-09-19 e posteriormente, mas antes da versão 2015-02-21, não pode recorrer List Blobs a um recipiente que inclua bolhas de apêndice. O serviço devolve o código de estado 409 (Conflito) se o resultado da listagem contiver uma bolha de apêndice.

LeaseState e LeaseDuration aparecer apenas na versão 2012-02-12 e mais tarde.

CopyId, CopyStatus, CopySource, CopyProgress, , CopyCompletionTimee CopyStatusDescription só aparecem na versão 2012-02-12 e mais tarde, quando esta operação inclui o include={copy} parâmetro. Estes elementos não aparecem se esta bolha nunca foi o destino de uma Copy Blob operação. Os elementos não aparecem se esta bolha tiver sido modificada após uma operação concluída Copy Blob , utilizando Set Blob Properties, Put Blobou Put Block List. Estes elementos também não aparecem com uma bolha criada por Copy Blob, antes da versão 2012-02-12.

Na versão 2013-08-15 e posteriormente, o EnumerationResults elemento contém um ServiceEndpoint atributo que especifica o ponto final do blob. Este elemento também contém um ContainerName campo que especifica o nome do recipiente. Em versões anteriores, estes dois atributos foram combinados no ContainerName campo. Também na versão 2013-08-15 e posteriormente, o Url elemento sob Blob foi removido.

Para a versão 2015-02-21 e posteriormente, List Blobs devolve blobs de todos os tipos (bloco, página e bolhas de apêndice).

Para a versão 2015-12-11 e mais tarde, List Blobs devolve o ServerEncrypted elemento. Este elemento é definido para true se os metadados blob e aplicação estiverem completamente encriptados, e false de outra forma.

Para a versão 2016-05-31 e posteriormente, List Blobs devolve o IncrementalCopy elemento para bolhas e instantâneos de cópia incremental, com o valor definido para true.

Para a versão 2017-04-17 e posteriormente, List Blobs devolve o AccessTier elemento se um nível de acesso tiver sido explicitamente definido. Para obter uma lista de níveis de blob de página premium permitidos, consulte o armazenamento premium de alto desempenho e discos geridos para VMs. Para o Armazenamento blob ou contas v2 para fins gerais, os valores válidos são Hot, Coole Archive. Se a bolha estiver no estado pendente de reidratação, então ArchiveStatus o elemento é devolvido com um dos valores válidos (rehydrate-pending-to-hot ou rehydrate-pending-to-cool. Para obter informações detalhadas sobre o nível do bloco blob consulte os níveis de armazenamento quente, fresco e de arquivo.

Para a versão 2017-04-17 e posteriormente, List Blobs devolve o AccessTierInferred elemento nas contas Blob Storage ou v2 de uso geral. Se a bolha de bloco não tiver o conjunto de nível de acesso, a informação de nível é deduzida das propriedades da conta de armazenamento, e este valor está definido para true. Este cabeçalho só está presente se o nível for deduzido da propriedade da conta.

Para a versão 2017-04-17 e posteriormente, List Blobs devolve o AccessTierChangeTime elemento nas contas Blob Storage ou v2 de uso geral. Isto só é devolvido se o nível da bolha de blocos alguma vez estiver definido. Para obter mais informações, consulte Representação dos valores da data-hora nos cabeçalhos.

Para a versão 2017-07-29 e posterior, DeletedDeletedTimee RemainingRetentionDays apareça quando esta operação incluir o include={deleted} parâmetro. Estes elementos não aparecem se esta bolha não foi apagada. Estes elementos aparecem para bolhas ou instantâneos que são eliminados com a DELETE operação, quando a função de eliminação suave foi ativada. O Deleted elemento está definido para true bolhas e instantâneos que são apagados suavemente. Deleted-Time corresponde ao momento em que a bolha foi eliminada. RemainingRetentionDays indica o número de dias após o qual uma bolha de sossa é permanentemente eliminada.

Para a versão 2017-11-09 e mais tarde, Creation-Time devolve o momento em que esta bolha foi criada.

Para a versão 2019-02-02 e posteriormente, List Blobs devolve o CustomerProvidedKeySha256 elemento se a bolha estiver encriptada com uma chave fornecida pelo cliente. O valor será definido para o hash SHA-256 da chave utilizada para encriptar a bolha. Além disso, se a operação incluir o include={metadata} parâmetro, e houver metadados de aplicação presentes numa bolha encriptada com uma chave fornecida pelo cliente, o Metadata elemento terá um Encrypted="true" atributo. Este atributo indica que a bolha tem metadados que não podem ser desencriptados como parte da List Blobs operação. Para aceder aos metadados destas bolhas, ligue para Get Blob Properties ou Obter Metadados Blob com a chave fornecida pelo cliente.

Para a versão 2019-02-02 e posteriormente, List Blobs devolve o EncryptionScope elemento se a bolha for encriptada com um âmbito de encriptação. O valor será definido para o nome do âmbito de encriptação utilizado para encriptar a bolha. Se a operação incluir o include={metadata} parâmetro, os metadados de aplicação na bolha são desencriptados de forma transparente e disponíveis no Metadata elemento.

Para a versão 2019-12-12 e posteriormente, List Blobs devolve o RehydratePriority elemento nas contas Blob Storage ou v2 de uso geral, se o objeto estiver no rehydrate pending estado. Valores válidos são High e Standard.

Para a versão 2019-12-12 e posteriormente, List Blobs devolve o VersionId elemento para bolhas e versões blob geradas, quando a versão está ativada na conta.

Para a versão 2019-12-12 e mais tarde, List Blobs devolve o IsCurrentVersion elemento para a versão atual do blob. O valor está definido para true. Este elemento permite-lhe diferenciar a versão atual das versões geradas automaticamente apenas por leitura.

Para a versão 2019-12-12 e mais tarde, List Blobs devolve o TagCount elemento para bolhas com qualquer etiqueta. O Tags elemento só aparece quando esta operação inclui o include={tags} parâmetro. Estes elementos não aparecem se não houver etiquetas na bolha.

Para a versão 2019-12-12 e mais tarde, List Blobs devolve o Sealed elemento para as bolhas de apêndice. O Sealed elemento só aparece quando a bolha do apêndice foi selada. Estes elementos não aparecem se a bolha do apêndice não estiver selada.

Para a versão 2020-02-10 e mais tarde, List Blobs devolve o LastAccessTime elemento. O elemento mostra quando os dados da bolha foram acedidos pela última vez, de acordo com a última política de rastreio do tempo de acesso da conta de armazenamento. O elemento não é devolvido se a conta de armazenamento não tiver esta apólice, ou se a apólice for desativada. Para obter informações sobre a definição da última política de rastreio do tempo de acesso da conta, consulte a API do Serviço Blob. O LastAccessTime elemento não rastreia a última vez que os metadados da bolha são acedidos.

Para a versão 2020-06-12 e posteriormente, List Blobs devolve os ImmutabilityPolicyUntilDate elementos e ImmutabilityPolicyMode elementos, quando esta operação inclui o include={immutabilitypolicy} parâmetro.

Para a versão 2020-06-12 e posteriormente, List Blobs devolve o LegalHold elemento, quando esta operação inclui o include={legalhold} parâmetro.

Para a versão 2020-06-12 e posteriormente, para contas com um espaço hierárquico habilitado, List Blobs devolve o Owner, GroupPermissionse Acl elementos. O pedido deve conter o include={permissions} parâmetro. Note que o Acl elemento é uma lista combinada de listas de controlo de acesso e de acesso predefinido que foram definidas no ficheiro ou diretório.

Para a versão 2020-06-12 e posterior, para contas com um espaço hierárquico habilitado, List Blobs com um delimiter devolve o Properties elemento no BlobPrefix elemento. Isto corresponde às propriedades do diretório.

Para a versão 2020-08-04 e mais tarde, para contas com um espaço hierárquico ativado, List Blobs devolve o DeletionId elemento para bolhas apagadas. DeletionId é um identificador não assinado de 64 bits. O elemento identifica exclusivamente um caminho de apagamento suave, para distingui-lo de outras bolhas apagadas com o mesmo caminho.

Para a versão 2020-10-02 e mais tarde, para contas com um espaço hierárquico habilitado, List Blobs devolve o ResourceType elemento de propriedade para o caminho. Isto pode ser ou.filedirectory

Para a versão 2021-02-12 e posteriormente, List Blobs irá codificar por cento (por RFC 2396) valores de todos BlobName ou BlobPrefixName elementos. Especificamente, fá-lo-á para os valores que contêm caracteres que não são válidos em XML (U+FFFE ou U+FFFF). Se codificado, o Name elemento incluirá um Encoded=true atributo. Note que isto ocorre apenas para os valores de Name elementos que contêm os caracteres inválidos em XML, e não os Name restantes elementos na resposta.

Para a versão 2021-06-08 e mais tarde, para contas com um espaço hierárquico ativado, List Blobs devolve o Placeholder elemento de propriedades. Devolve este elemento no elemento para diretórios BlobPrefix de espaços reservados, ao enumerar bolhas apagadas com um delimiter. Estes diretórios de espaços reservados existem para facilitar a navegação a bolhas de apagamento suave.

Para a versão 2020-02-10 e mais tarde, para contas com um espaço hierárquico ativado, List Blobs devolve o Expiry-Time elemento para bolhas apagadas. Expiry-Time é o momento em que o ficheiro expirará, e é devolvido para o ficheiro se a expiração for definida na mesma.

<?xml version="1.0" encoding="utf-8"?>  
<EnumerationResults ServiceEndpoint="http://myaccount.blob.core.windows.net/"  ContainerName="mycontainer">  
  <Prefix>string-value</Prefix>  
  <Marker>string-value</Marker>  
  <MaxResults>int-value</MaxResults>  
  <Delimiter>string-value</Delimiter>  
  <Blobs>  
    <Blob>  
      <Name>blob-name</name>  
      <Snapshot>date-time-value</Snapshot>  
      <VersionId>date-time-vlue</VersionId>
      <IsCurrentVersion>true</IsCurrentVersion>
      <Deleted>true</Deleted>
      <Properties> 
        <Creation-Time>date-time-value</Creation-Time>
        <Last-Modified>date-time-value</Last-Modified>  
        <Etag>etag</Etag>
        <Owner>owner user id</Owner>
        <Group>owning group id</Group>
        <Permissions>permission string</Permissions>
        <Acl>access control list</Acl>
        <ResourceType>file | directory</ResourceType>
        <Placeholder>true</Placeholder>
        <Content-Length>size-in-bytes</Content-Length>  
        <Content-Type>blob-content-type</Content-Type>  
        <Content-Encoding />  
        <Content-Language />  
        <Content-MD5 />  
        <Cache-Control />  
        <x-ms-blob-sequence-number>sequence-number</x-ms-blob-sequence-number>  
        <BlobType>BlockBlob|PageBlob|AppendBlob</BlobType>  
        <AccessTier>tier</AccessTier>  
        <LeaseStatus>locked|unlocked</LeaseStatus>  
        <LeaseState>available | leased | expired | breaking | broken</LeaseState>  
        <LeaseDuration>infinite | fixed</LeaseDuration>  
        <CopyId>id</CopyId>  
        <CopyStatus>pending | success | aborted | failed </CopyStatus>  
        <CopySource>source url</CopySource>  
        <CopyProgress>bytes copied/bytes total</CopyProgress>  
        <CopyCompletionTime>datetime</CopyCompletionTime>  
        <CopyStatusDescription>error string</CopyStatusDescription>  
        <ServerEncrypted>true</ServerEncrypted> 
        <CustomerProvidedKeySha256>encryption-key-sha256</CustomerProvidedKeySha256>
        <EncryptionScope>encryption-scope-name</EncryptionScope>
        <IncrementalCopy>true</IncrementalCopy>
        <AccessTierInferred>true</AccessTierInferred>
        <AccessTierChangeTime>datetime</AccessTierChangeTime>
        <DeletedTime>datetime</DeletedTime>
        <RemainingRetentionDays>no-of-days</RemainingRetentionDays>
        <TagCount>number of tags between 1 to 10</TagCount>
        <RehydratePriority>rehydrate priority</RehydratePriority>
        <Expiry-Time>date-time-value</Expiry-Time>
      </Properties>  
      <Metadata>     
        <Name>value</Name>  
      </Metadata>  
      <Tags>
          <TagSet>
              <Tag>
                  <Key>TagName</Key>
                  <Value>TagValue</Value>
              </Tag>
          </TagSet>
      </Tags>
      <OrMetadata />
    </Blob>  
    <BlobPrefix>  
      <Name>blob-prefix</Name>  
    </BlobPrefix>  
  </Blobs>  
  <NextMarker />  
</EnumerationResults>  

Resposta de amostra

Consulte os recursos de enumeração blob para obter uma resposta de amostra.

Autorização

Se a lista de controlo de acesso do contentor (ACL) estiver definida para permitir o acesso anónimo ao contentor, qualquer cliente pode ligar para esta operação. Caso contrário, esta operação pode ser chamada pelo proprietário da conta, e por qualquer pessoa com uma assinatura de acesso partilhado que tenha permissão para listar bolhas num recipiente.

Observações

Blob propriedades na resposta

Se você solicitou que as bolhas não comprometidas fossem incluídas na enumeração, note que algumas propriedades não são definidas até que a bolha seja comprometida. Algumas propriedades podem não ser devolvidas na resposta.

O x-ms-blob-sequence-number elemento só é devolvido para bolhas de página.

O OrMetadata elemento só é devolvido para bolhas de bloco.

Para as bolhas de página, o valor devolvido no Content-Length elemento corresponde ao valor do cabeçalho da x-ms-blob-content-length bolha.

O Content-MD5 elemento aparece no organismo de resposta, apenas se tiver sido definido no blob utilizando a versão 2009-09-19 ou posterior. Pode configurar a Content-MD5 propriedade quando a bolha for criada, ou chamando set Blob Properties. Na versão 2012-02-12 e mais tarde, Put Blob define o valor MD5 de uma blob de bloco, mesmo quando o Put Blob pedido não inclui um cabeçalho MD5.

Metadados na resposta

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

Note que os metadados solicitados com este parâmetro devem ser armazenados de acordo com as restrições de nomeação impostas pela versão 2009-09-19 do Blob Storage. Começando com esta versão, todos os nomes de metadados devem aderir às convenções de nomeação para identificadores C#.

Se um par de nomes de metadados violar estas restrições de nomeação, o organismo de resposta indica o nome problemático dentro de um x-ms-invalid-name elemento. O seguinte fragmento de XML mostra isto:

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

Etiquetas na resposta

O Tags elemento só está presente se o include=tags parâmetro tiver sido especificado no URI, e se houver etiquetas na bolha. Dentro do TagSet elemento, são devolvidos até 10 Tag elementos, cada um contendo as key etiquetas de índice blob definidas pelo utilizador e value definidas pelo utilizador. A encomenda de etiquetas não está garantida na resposta.

Os Tags elementos e TagCount elementos não são devolvidos se não houver etiquetas na bolha.

O serviço de armazenamento mantém uma forte consistência entre uma bolha e as suas etiquetas, mas o índice secundário é eventualmente consistente. As etiquetas podem ser visíveis numa resposta antes de List Blobs serem visíveis às Find Blobs by Tags operações.

Instantâneos na resposta

As imagens instantâneas só são listadas na resposta se o include=snapshots parâmetro tiver sido especificado no URI. As imagens listadas na resposta não incluem o elemento, porque as LeaseStatus fotos não podem ter locações ativas.

Se ligar List Blobs com umlimiter, também não pode incluir instantâneos na enumeração. Um pedido que inclui ambos devolve um erro (código de estado HTTP 400 – Mau Pedido).

Bolhas não comprometidas na resposta

As bolhas não comprometidas só são listadas na resposta se o include=uncommittedblobs parâmetro tiver sido especificado no URI. As bolhas não comprometidas listadas na resposta não incluem nenhum dos seguintes elementos:

  • Last-Modified

  • Etag

  • Content-Type

  • Content-Encoding

  • Content-Language

  • Content-MD5

  • Cache-Control

  • Metadata

Bolhas apagadas na resposta

As bolhas eliminadas só são listadas na resposta se o include=deleted parâmetro tiver sido especificado no URI. As bolhas eliminadas listadas na resposta não incluem os elementos do Lease , porque as bolhas apagadas não podem ter locações ativas.

As imagens eliminadas são incluídas na resposta da lista se include=deleted,snapshot forem especificadas no URI.

Metadados de replicação de objetos na resposta

O OrMetadata elemento está presente quando uma política de replicação de objetos foi avaliada numa bolha, e a chamada foi feita utilizando a List Blobs versão 2019-12-12 ou mais tarde. Dentro do OrMetadata elemento, o valor de cada par de valor-nome é listado dentro de um elemento correspondente ao nome do par. O formato do nome é or-{policy-id}_{rule-id}, onde {policy-id} é um GUID que representa o identificador de política de replicação de objetos na conta de armazenamento. {rule-id} é um GUID que representa o identificador de regras no recipiente de armazenamento. Valores válidos são complete ou failed.

  
…  
<OrMetadata>  
  <or-e524bba7-4323-4b93-91f8-d09d5d0b7057_d86c51de-ef02-4264-bdcf-dcd389a6c7ac>complete</or-e524bba7-4323-4b93-91f8-d09d5d0b7057_d86c51de-ef02-4264-bdcf-dcd389a6c7ac>  
  <or-2b302b5d-fcd5-44d6-a5ed-455bf27e17ea_4a398ff5-2a89-4090-879b-10248f23428e>failed</or-2b302b5d-fcd5-44d6-a5ed-455bf27e17ea_4a398ff5-2a89-4090-879b-10248f23428e>  
</OrMetadata>  
…  
  

Política de imutabilidade na resposta

Os ImmutabilityPolicyUntilDate elementos e ImmutabilityPolicyMode elementos só estão presentes se o include=immutabilitypolicy parâmetro tiver sido especificado no URI.

<Properties> 
   <ImmutabilityPolicyUntilDate>date-time-value</ImmutabilityPolicyUntilDate>   
   <ImmutabilityPolicyMode>unlocked | locked </ImmutabilityPolicyMode>  
</Properties> 

O LegalHold elemento só está presente se o include=legalhold parâmetro tiver sido especificado no URI.

<Properties> 
  <LegalHold>true | false </LegalHold>  
</Properties> 

Conjuntos de resultados de retorno utilizando um valor marcador

Se especificar um valor para o maxresults parâmetro, e o número de bolhas a devolver exceder este valor, ou exceder o valor padrão para maxresults, o corpo de resposta contém um NextMarker elemento. Este elemento indica que a próxima bolha deve voltar a ser solicitada. Em certos casos, o serviço pode devolver o NextMarker elemento mesmo que o número de resultados devolvidos seja inferior ao valor de maxresults.

Para devolver o próximo conjunto de itens, especifique o valor do parâmetro do NextMarker marcador no URI para o pedido subsequente. Note que o valor de NextMarker deve ser tratado como opaco.

Usando um delimiter para atravessar o espaço de nome blob

O delimiter parâmetro permite que o chamador percorda o espaço de nome blob utilizando umlimiter configurado pelo utilizador. Desta forma, pode-se atravessar uma hierarquia virtual de bolhas como se fosse um sistema de ficheiros. O delimiter pode ser um único personagem ou uma corda.

Quando o pedido inclui este parâmetro, a operação devolve um BlobPrefix elemento. O BlobPrefix elemento é devolvido no lugar de todas as bolhas com nomes que começam com o mesmo sub-cordão, até ao aparecimento do personagem delimiter. O valor do BlobPrefix elemento é substring+delimiter, onde sub-corda é o sublpeso comum que começa um ou mais nomes blob, e delimiter é o valor do delimiter parâmetro.

Pode utilizar o valor de BlobPrefix fazer uma chamada subsequente para listar as bolhas que começam com este prefixo. Fá-lo especificando o valor do BlobPrefixprefix parâmetro no pedido URI.

Note que cada BlobPrefix elemento devolvido conta para o resultado máximo, assim como cada Blob elemento.

As bolhas são listadas por ordem alfabética no corpo de resposta, com letras maiúsculas listadas primeiro.

Erros de cópia na Descrição do Estado da Cópia

CopyStatusDescription contém mais informações sobre a Copy Blob falha.

  • Quando uma tentativa de cópia falhar, CopyStatus é definida para pending se o Blob Storage ainda estiver a tentar novamente a operação. O CopyStatusDescription texto descreve a falha que pode ter ocorrido durante a última tentativa de cópia.

  • Quando CopyStatus estiver definido, failedo CopyStatusDescription texto descreve o erro que fez com que a operação da cópia falhasse.

A tabela seguinte descreve os campos de cada CopyStatusDescription valor.

Componente Descrição
Código de estado de HTTP Número inteiro padrão de três dígitos especificando a falha.
Código de erro Palavra-chave que descreve o erro. É fornecido pelo Azure no <elemento ErrorCode> . Se não aparecer nenhum <elemento ErrorCode> , o serviço devolve uma palavra-chave que contém texto de erro padrão associado ao código de estado HTTP de três dígitos na especificação HTTP. Para obter mais informações, consulte códigos de erro da API Common REST.
Informações Descrição detalhada do fracasso, em aspas.

A tabela seguinte descreve os CopyStatus valores e CopyStatusDescription valores dos cenários comuns de falha.

Importante

O texto de descrição mostrado aqui pode ser alterado sem aviso prévio, mesmo sem uma alteração de versão. Não confie em combinar este texto exato.

Scenario Valor do Estado da Cópia Valor de descrição do estado da cópia
A operação de cópia concluída com sucesso. exito vazio
O utilizador abortou a operação de cópia antes de ser concluída. abortado vazio
Ocorreu uma falha durante a leitura da bolha de origem durante uma operação de cópia. A operação será tentada novamente. pendente 502 BadGateway "Encontrou um erro redacionável ao ler a fonte. Vai tentar novamente. Tempo de insucesso: <tempo>"
Ocorreu uma falha ao escrever para a bolha de destino de uma operação de cópia. A operação será tentada novamente. pendente 500 InternalServerError "Encontrou um erro redator. Vai tentar novamente. Tempo de insucesso: <tempo>"
Ocorreu uma falha irrecuperável ao ler a partir da bolha de origem de uma operação de cópia. falhou 404 ResourceNotFound "A cópia falhou ao ler a fonte." Quando o serviço reporta este erro subjacente, retorna ResourceNotFound no <elemento ErrorCode> . Se nenhum <elemento ErrorCode> aparecer na resposta, aparece uma representação de cadeia padrão do estado HTTP, tal como NotFound, aparece.
O período de tempo limite limitando todas as operações de cópia decorridos. (Atualmente o período de tempo limite é de duas semanas.) falhou 500 OperaçãoCanceled "A cópia excedeu o tempo máximo permitido."
A operação de cópia falhou demasiadas vezes ao ler a partir da fonte, e não cumpriu um rácio mínimo de tentativas de sucesso. (Este intervalo evita voltar a tentar uma fonte muito pobre mais de duas semanas antes de falhar). falhou 500 OperaçãoCanceled "A cópia falhou ao ler a fonte."

Ver também

Códigos de estado e de erro
Códigos de erro de armazenamento de bolhas