Blobs lista

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

Pedir

O List Blobs pedido pode ser construído da 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

Ao fazer um pedido contra o serviço de armazenamento emulado, especifique o nome de anfitrião emulador e a porta de serviço Blob 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 a Utilização do Armazenamento Emulator Azure para Desenvolvimento e Testes.

Parâmetros do URI

Os seguintes parâmetros adicionais podem ser especificados no URI.

Parâmetro Descrição
prefix Opcional. Filtra os resultados para devolver apenas bolhas cujos nomes começam com o prefixo especificado.
delimiter Opcional. Quando o pedido inclui este parâmetro, a operação devolve um BlobPrefix elemento no corpo de resposta que funciona como espaço reservado para todas as bolhas cujos nomes começam com o mesmo substring 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. O valor do marcador pode então ser utilizado 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 devolverá 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 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 comprometidas com a lista de blocos de put,sejam incluídas na resposta.
- copy: Versão 2012-02-12 e mais recente. 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 mais recente. Especifica que as bolhas apagadas suaves devem ser incluídas na resposta.
-tags: Versão 2019-12-12 e mais recente. Especifica que as tags blob index definidas pelo utilizador devem ser incluídas na resposta.
-versions: Versão 2019-12-12 e mais recente. Especifica que as versões de bolhas devem ser incluídas na enumeração.
-deletedwithversions: Versão 2020-10-02 e mais recente. Especifica que as bolhas eliminadas com quaisquer versões (ativas ou eliminadas) devem ser incluídas na resposta com uma etiqueta <HasVersionsOnly> e valor verdadeiro.
-immutabilitypolicy: Versão 2020-06-12 e mais recente. Especifica que a política de imutabilidade até à data e o modo de política de imutabilidade dos blobs devem ser incluídos na enumeração.
-legalhold: Versão 2020-06-12 e mais recente. Especifica que a detenção legal de bolhas deve ser incluída na enumeração.
-permissions: Versão 2020-06-12 e mais recente. Suportado apenas para contas com um espaço hierárquico habilitado. Se um pedido incluir este parâmetro, então a Lista de Proprietários, Grupos, Permissões e Controlo de Acesso para as bolhas ou diretórios listados será incluída 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} Opcional. Versão 2020-08-04 e mais recente. Apenas para contas com espaço hierárquico habilitado. Quando um pedido inclui este parâmetro, a lista contém apenas bolhas apagadas suaves. Se incluir=eliminado também for especificado, o pedido falhará com o Mau Pedido (400).
timeout Opcional. O timeout parâmetro é expresso em segundos. Para obter mais informações, consulte os intervalos de definição para operações de serviço de blob.

Pedido cabeçalhos

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 à Azure Armazenamento.
Date ou x-ms-date Obrigatório. Especifica a Hora Universal Coordenada (UTC) do pedido. Para mais informações, consulte Os pedidos autorizados à Azure Armazenamento.
x-ms-version Requerido para todos os pedidos autorizados, 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 Azure Armazenamento.
x-ms-client-request-id Opcional. Fornece um valor opaco gerado pelo cliente com um limite de caracteres de 1 KiB que é gravado nos registos de análise quando o registo de análise de armazenamento está ativado. Recomenda-se a utilização deste cabeçalho para correlacionar as atividades do lado do cliente com os pedidos recebidos pelo servidor. Para obter mais informações, consulte Sobre Armazenamento Registos de Registos e Registos Azure: Utilização de Registos para rastrear pedidos de Armazenamento.
x-ms-upn Opcional. Válido apenas quando um espaço hierárquico estiver ativado para a conta e incluir=permissões é fornecido no pedido. Se for verdade, os valores de identidade do utilizador devolvidos no <Owner> , e os campos <Group> <Acl> serão transformados de Azure Ative Directory iDs de objeto para nomes principais do utilizador. Se forem falsos, os valores serão devolvidos como Azure Ative Directory identificações de objetos. O valor predefinido é falso. 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 enumerando recursos 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 em conformidade 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 obter mais informações, consulte as Operações da API de Resolução de Problemas.
x-ms-version Indica a versão do serviço Blob utilizado para executar o pedido. Este cabeçalho é devolvido para pedidos feitos usando a versão 2009-09-19 e mais recente.

Este cabeçalho também é devolvido para pedidos anónimos sem uma versão especificada se o recipiente foi marcado para acesso público usando a versão 2009-09-19 do serviço Blob.
Date Uma data/valor de hora UTC gerado pelo serviço que indica o momento em que a resposta foi iniciada.
x-ms-client-request-id Este cabeçalho pode ser usado 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 e o valor for 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 de Resposta

O formato da resposta XML é o seguinte.

Note que os Prefix Marker , e MaxResults Delimiter elementos só estão 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 recente, 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``LastModified(anteriormente)

  • Content-Length``Size(anteriormente)

  • Content-Type``ContentType(anteriormente)

  • Content-Encoding``ContentEncoding(anteriormente)

  • Content-Language``ContentLanguage(anteriormente)

O Content-MD5 elemento aparece para bolhas criadas com a versão 2009-09-19 e mais recentes. Na versão 2012-02-12 e mais recente, o serviço Blob calcula o Content-MD5 valor quando carrega uma bolha usando Put Blob,mas não o calcula quando cria uma bolha utilizando a Put Block List. 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 mais recentes, mas antes da versão 2015-02-21, chamar List Blobs um recipiente que inclua bolhas de apêndice falhará com o código de estado 409 (FeatureVersionMismatch) 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 , , , , e CopyProgress só aparecem na versão CopyCompletionTime CopyStatusDescription 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, ou se esta bolha foi modificada após uma operação concluída Copy Blob utilizando , ou . Set Blob Properties Put Blob 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 mais recente, o EnumerationResults elemento contém um atributo que especifica o ponto final do ServiceEndpoint blob, e 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 mais recente, o Url elemento em baixo foi Blob removido.

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

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

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

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

Para a versão 2017-04-17 e acima, List Blobs devolve o elemento nas contas AccessTierInferred Blob Armazenamento ou Finalidade Geral v2. Se a bolha de bloco não tiver o conjunto de nível de acesso, então inferimos o nível 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 obter informações detalhadas sobre o nível do bloco blob consulte as camadas de armazenamento quente, fresco e de arquivo.

Para a versão 2017-04-17 e acima, List Blobs devolve o elemento nas contas AccessTierChangeTime Blob Armazenamento ou Finalidade Geral v2. Isto só é devolvido se o nível da bolha de blocos alguma vez estiver definido. O formato de data segue o RFC 1123. Para mais informações, consulte Representação de Valores Date-Time em Cabeçalhos. Para obter informações detalhadas sobre o nível do bloco blob consulte as camadas de armazenamento quente, fresco e de arquivo.

Para a versão 2017-07-29 ou acima, Deleted e apareça quando esta DeletedTime RemainingRetentionDays operação incluir o include={deleted} parâmetro. Estes elementos não aparecem se esta bolha não for eliminada. Estes elementos aparecem para bolha ou instantâneo que são eliminados com DELETE o funcionamento quando a função de eliminação suave foi ativada. Deleted elemento é definido para verdadeiro para bolhas e instantâneos que são suaves apagados. Deleted-Time corresponde ao tempo em que a bolha foi apagada. RemainingRetentionDays indica o número de dias após o qual a bolha apagada suave será permanentemente eliminada pelo serviço blob.

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

Para a versão 2019-02-02 e acima, List Blobs devolve o elemento se a bolha estiver CustomerProvidedKeySha256 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 atributo para indicar que a bolha tem Encrypted="true" metadados que não podem ser desencriptados como parte da List Blobs operação. Ligue para Get Blob Properties ou Obtenha Metadados Blob com a chave fornecida pelo cliente para aceder aos metadados para estas bolhas.

Para a versão 2019-02-02 e acima, List Blobs devolve o elemento se a bolha for EncryptionScope 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 serão desencriptados e disponíveis de forma transparente no Metadata elemento.

Para a versão 2019-12-12 e acima, List Blobs devolve o elemento nas contas RehydratePriority Blob Armazenamento ou Finalidade Geral v2 se o objeto estiver em estado pendente de rehidrata. Valores válidos são High / Standard . Para obter informações detalhadas sobre o nível do bloco blob consulte as camadas de armazenamento quente, fresco e de arquivo.

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

Para a versão 2019-12-12 e acima, List Blobs devolve o elemento para a versão atual do IsCurrentVersion blob com o valor definido para true , para diferenciá-lo apenas a partir das versões geradas automaticamente pela leitura.

Para a versão 2019-12-12 e acima, List Blobs devolve o elemento para TagCount 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 acima, List Blobs devolve o elemento para Sealed Append Blobs. 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 acima, List Blobs devolve o LastAccessTime elemento. Os elementos mostram 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 será devolvido se a conta de armazenamento não tiver uma última política de rastreio do tempo de acesso, ou se a apólice for desativada. Para obter informações sobre a configuraçã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 quando os metadados da bolha são acedidos.

Para a versão 2020-06-12 e acima, 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 acima, List Blobs devolve o elemento quando esta LegalHold operação inclui o include={legalhold} parâmetro.

Para a versão 2020-06-12 e acima, para contas com um espaço hierárquico ativado, List Blobs devoluções Owner , e elemento quando o pedido contém Group Permissions Acl include={permissions} parâmetro. Note que Acl o elemento será uma lista combinada de Acl's de Acesso e Predefinido que foram definidos no ficheiro/diretório.

Para a versão 2020-08-04 e acima, para contas com o Namespace Hierárquico ativadas, List Blobs devolve o elemento para DeletionId bolhas apagadas. DeletionId é um identificador de 64 bits não assinado que identifica exclusivamente um caminho suave e eliminado para distingui-lo de outras bolhas apagadas com o mesmo caminho.

Para a versão 2020-10-02 e acima, para contas hierárquicas ativadas, List Blobs devolve o elemento de propriedade para o ResourceType caminho, que pode ser qualquer um file / directory .

Para a versão 2021-02-12 ou acima, List Blobs irá codificar por cento (por RFC 2396) valores de todos Blob Name ou BlobPrefix Name elementos que contenham caracteres inválidos em XML (especificamente, U+FFFE ou U+FFFF). Se codificado, o Name elemento incluirá um Encoded=true atributo. Note que isto só ocorrerá para os valores do Name elemento que contêm os caracteres inválidos em XML, e não os Name restantes elementos na resposta.

<?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>
        <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>
      </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 enumerando recursos 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 tiver solicitado que as bolhas não comprometidas sejam incluídas na enumeração, note que algumas propriedades não são definidas até que a bolha seja comprometida, pelo que algumas propriedades não podem 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 só aparece no organismo de resposta se tiver sido definido na bolha utilizando a versão 2009-09-19 ou posterior. Pode definir a Content-MD5 propriedade quando a bolha for criada ou chamando set Blob Properties. Na versão 2012-02-12 e mais recente, 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 parâmetro tiver sido especificado no include=metadata 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 serviço Blob. Começando por 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 as restrições de nomeação aplicadas pela versão 2009-09-19, o organismo de resposta indica o nome problemático dentro de um x-ms-invalid-name elemento, como mostra o seguinte fragmento de XML:

  
…  
<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 parâmetro tiver sido especificado no include=tags URI e se houver etiquetas na bolha. Dentro do TagSet elemento, são devolvidos até 10 Tag elementos, cada um contendo as key value etiquetas blob definidas pelo utilizador. A encomenda de etiquetas não está garantida na resposta.

Os Tags TagCount elementos e 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 a Blobs listas antes de serem visíveis para encontrar blobs por operações tags.

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. Os instantâneos listados na resposta não incluem o LeaseStatus elemento, uma vez que os instantâneos 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 invalidQueryParameter (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 enumeradas 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 de Locação, uma vez que as bolhas eliminadas 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 de List Blobs foi feita usando a 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 é um guia que representa o {policy-id} identificador de política de replicação de objetos na conta de armazenamento e {rule-id} é um guia que representa o identificador de regras no recipiente de armazenamento. Valores válidos são complete / 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 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> 

Apoio Legal na Resposta

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

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

Conjuntos de resultados de retorno usando 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 , o corpo de resposta maxresults conterá um elemento que indica a próxima NextMarker bolha a devolver num pedido subsequente. 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 NextMarker parâmetro do 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 cujos nomes começam com o mesmo substring até ao aparecimento do personagem delimiter. O valor do BlobPrefix elemento é substring+delimiter, onde sub-adstring é o subtípelinho comum que começa um ou mais nomes blob, e olimiter é o valor do parâmetro delimiter.

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

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 CopyStatusDescription

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

  • Quando uma tentativa de cópia falha e o serviço Blob ainda está a tentar novamente a operação, CopyStatus está definido para , e o texto descreve a falha que pode ter ocorrido durante a última pending tentativa de CopyStatusDescription cópia.

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

A tabela seguinte descreve os três campos de cada CopyStatusDescription valor.

Componente Descrição
Código de estado de HTTP Número inteiro padrão de 3 dígitos especificando a falha.
Código de erro Palavra-chave descrevendo erro fornecido pelo Azure no elemento <> ErrorCode. Se não aparecer nenhum elemento <> ErrorCode, é utilizada uma palavra-chave que contenha texto de erro padrão associado ao código de estado HTTP de 3 dígitos na especificação HTTP. Consulte códigos de erro comuns da APIREST .
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, pelo que não confie em corresponder a este texto exato.

Scenario Valor CopyStatus Valor de copyStatusDescription
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, mas a operação será novamente experimentada. 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, mas a operação será novamente experimentada. 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." Nota: Ao reportar este erro subjacente, o Azure retorna ResourceNotFound no elemento <> ErrorCode. Se nenhum elemento <ErrorCode > aparecer na resposta, aparecerá uma representação de cadeia padrão do estado HTTP, tal NotFound como.
O período de tempo limite limitando todas as operações de cópia decorridos. (Atualmente o período de tempo limite é de 2 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 2 semanas antes de falhar). falhou 500 OperaçãoCanceled "A cópia falhou ao ler a fonte."

Ver também

Códigos de Estado e erro
Códigos de Erro do Serviço de Blobs