Get Blob

A operação Get Blob lê ou baixa um blob do sistema, incluindo seus metadados e propriedades. Você também pode chamar Get Blob para ler um instantâneo.

Solicitação

A solicitação Get Blob pode ser criada da seguinte maneira. HTTPS é recomendado. Substitua myaccount pelo nome da sua conta de armazenamento:

URI de solicitação do método GET Versão de HTTP
https://myaccount.blob.core.windows.net/mycontainer/myblob

https://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot=<DateTime>

https://myaccount.blob.core.windows.net/mycontainer/myblob?versionid=<DateTime>

HTTP/1.0

HTTP/1.1

URI do serviço de armazenamento emulado

Ao fazer uma solicitação no serviço de armazenamento emulado, especifique o nome de host do emulador e a porta do serviço Blob como 127.0.0.1:10000, seguido pelo nome da conta de armazenamento emulado:

URI de solicitação do método GET Versão de HTTP
http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob HTTP/1.0

HTTP/1.1

Para obter mais informações, consulte Como usar o Emulador de Armazenamento do Azure para desenvolvimento e teste.

Parâmetros do URI

Os seguintes parâmetros adicionais podem ser especificados no URI de solicitação.

Parâmetro Descrição
snapshot Opcional. O parâmetro de instantâneo é um valor DateTime opaco que, quando presente, especifica o instantâneo de blob a ser recuperado. Para obter mais informações sobre como trabalhar com instantâneos de blob, consulte Criando um instantâneo de um Blob.
versionid Opcional, versão 2019-12-12 e mais recente. O parâmetro versionid é um valor opaco DateTime que, quando presente, especifica a versão do blob a ser recuperada.
timeout Opcional. O parâmetro timeout é expresso em segundos. Para obter mais informações, consulte Configurando tempos limite para operações de serviço de blob.

Cabeçalhos de solicitação

A tabela a seguir descreve os cabeçalhos de solicitação obrigatórios e opcionais.

Cabeçalho da solicitação Descrição
Authorization Obrigatórios. Especifica o esquema de autorização, o nome da conta e a assinatura. Para saber mais, confira Autorizar solicitações para o Armazenamento do Azure.
Date ou x-ms-date Obrigatórios. Especifica o UTC (Tempo Universal Coordenado) para a solicitação. Para saber mais, confira Autorizar solicitações para o Armazenamento do Azure.
x-ms-version Obrigatório para todas as solicitações autorizadas, opcional para solicitações anônimas. Especifica a versão da operação a ser usada para esta solicitação. Se esse cabeçalho for omitido para uma solicitação anônima, o serviço executará a solicitação com a versão 2009-09-19. Para obter mais informações, consulte Controle de versão para os Serviços de Armazenamento do Azure.
Range Opcional. Retornar somente os bytes do blob no intervalo especificado.
x-ms-range Opcional. Retornar somente os bytes do blob no intervalo especificado. Se Range e x-ms-range forem especificados, o serviço usará o valor de x-ms-range. Se nenhum for especificado, todo o conteúdo do blob será retornado. Consulte Especificando o cabeçalho de intervalo para operações de serviço blob para obter mais informações.
x-ms-lease-id: <ID> Opcional. Se esse cabeçalho for especificado, a operação será executada apenas se as seguintes condições forem atendidas:

- A concessão do blob está ativa no momento.
- A ID de concessão especificada na solicitação corresponde à do blob.

Se esse cabeçalho for especificado e nenhuma dessas condições for atendida, a solicitação não será feita e ocorrerá uma falha na operação Get Blob com o código de status 412 (Falha na Pré-condição).
x-ms-range-get-content-md5: true Opcional. Quando esse cabeçalho é definido true e especificado junto com o Range cabeçalho, o serviço retorna o hash MD5 para o intervalo, desde que o intervalo seja menor ou igual a 4 MiB de tamanho.

Se esse cabeçalho for especificado sem o cabeçalho Range, o serviço retornará o código de status 400 (Solicitação Incorreta).

Se esse cabeçalho for definido para true quando o intervalo exceder 4 MiB de tamanho, o serviço retornará o código de status 400 (Solicitação Incorreta).
x-ms-range-get-content-crc64: true Opcional. Quando esse cabeçalho é definido true e especificado junto com o Range cabeçalho, o serviço retorna o hash CRC64 para o intervalo, desde que o intervalo seja menor ou igual a 4 MiB de tamanho.

Se esse cabeçalho for especificado sem o cabeçalho Range, o serviço retornará o código de status 400 (Solicitação Incorreta).

Se esse cabeçalho for definido para true quando o intervalo exceder 4 MiB de tamanho, o serviço retornará o código de status 400 (Solicitação Incorreta).

Se ambos e x-ms-range-get-content-md5x-ms-range-get-content-crc64 cabeçalhos estiverem presentes, a solicitação falhará com um 400 (Solicitação Incorreta).

Esse cabeçalho tem suporte nas versões 2019-02-02 ou posterior.
Origin Opcional. Especifica a origem da qual a solicitação será emitida. A presença desse cabeçalho resulta em recursos de origens cruzadas compartilhando (CORS) cabeçalhos na resposta.
x-ms-client-request-id Opcional. Fornece um valor opaco gerado pelo cliente com um limite de caracteres de 1 KiB que é registrado nos logs de análise quando o log de análise de armazenamento está habilitado. O uso desse cabeçalho é altamente recomendável para correlacionar as atividades do lado do cliente com as solicitações recebidas pelo servidor. Para obter mais informações, consulte Sobre Análise de Armazenamento registro em log e log do Azure: usando logs para rastrear solicitações de armazenamento.

Essa operação também dará suporte ao uso de cabeçalhos condicionais para ler o blob somente se uma determinada condição for atendida. Para obter mais informações, confira Como especificar cabeçalhos condicionais para operações de serviço Blob.

Cabeçalhos de solicitação (chaves de criptografia fornecidas pelo cliente)

A partir da versão 2019-02-02, os cabeçalhos a seguir podem ser especificados na solicitação para ler um blob criptografado com uma chave fornecida pelo cliente. A criptografia com uma chave fornecida pelo cliente (e o conjunto correspondente de cabeçalhos) é opcional. Se um blob tiver sido criptografado anteriormente com uma chave fornecida pelo cliente, esses cabeçalhos deverão ser incluídos na solicitação para concluir a operação de leitura com êxito.

Cabeçalho da solicitação Descrição
x-ms-encryption-key Obrigatórios. A chave de criptografia AES-256 codificada em Base64.
x-ms-encryption-key-sha256 Opcional. O hash SHA256 codificado em Base64 da chave de criptografia.
x-ms-encryption-algorithm: AES256 Obrigatórios. Especifica o algoritmo a ser usado para criptografia. O valor deste cabeçalho deve ser AES256.

Corpo da solicitação

Nenhum.

Resposta

A resposta inclui um código de status HTTP, um conjunto de cabeçalhos de resposta e o corpo de resposta, que tem o conteúdo do blob.

Código de status

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

Uma operação bem-sucedida para ler um intervalo especificado retorna o código de status 206 (conteúdo parcial).

Para obter informações sobre códigos de status, consulte Status 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 estão em conformidade com a especificação do protocolo HTTP/1.1.

Sintaxe Descrição
Last-Modified A data e a hora da última modificação feita no blob. O formato da data segue RFC 1123.

Qualquer operação que modificar o blob, incluindo uma atualização dos metadados ou das propriedades do blob, alterará a hora da última modificação do blob.
x-ms-creation-time Versão 2017-11-09 e mais recente. A data/hora em que o blob foi criado. O formato da data segue RFC 1123.
x-ms-meta-name:value Um conjunto de pares de nome-valor associados a esse blob como metadados definidos pelo usuário.
x-ms-tag-count Versão 2019-12-12 ou mais recente. Se o blob tiver marcas, retornará o número de marcas armazenadas no blob. Esse cabeçalho não será retornado se não houver marcas no blob.
Content-Length O número de bytes presentes no corpo da resposta.
Content-Type O tipo de conteúdo especificado para o blob. O tipo de conteúdo padrão é application/octet-stream.
Content-Range Indica o intervalo de bytes retornado, se o cliente tiver solicitado um subconjunto do blob definindo o cabeçalho de solicitação Range.
ETag A ETag contém um valor que você pode usar para executar operações de forma condicional. Consulte Especificando cabeçalhos condicionais para operações de serviço blob para obter mais informações. Se a versão da solicitação for a 2011-08-18 ou mais recente, o valor de ETag será exibido entre aspas.
Content-MD5 Se o blob tiver um hash MD5 e essa operação Get Blob tiver o objetivo de ler todo o blob, esse cabeçalho de resposta será retornado de modo que o cliente possa verificar a integridade do conteúdo da mensagem.

Na versão 2012-02-12 e mais recente, Put Blob define um valor de hash MD5 de um blob de blocos mesmo quando a solicitação Put Blob não inclui um cabeçalho MD5.

Se a solicitação for para ler um intervalo especificado e o x-ms-range-get-content-md5 estiver definido como true, a solicitação retornará um hash MD5 para o intervalo, desde que o tamanho do intervalo seja menor ou igual a 4 MiB.

Se nenhum desses conjuntos de condições for verdadeiro, nenhum valor será retornado para o cabeçalho Content-MD5.

Se x-ms-range-get-content-md5 for especificado sem o cabeçalho Range, o serviço retornará o código de status 400 (Solicitação Incorreta).

Se x-ms-range-get-content-md5 for definido true como quando o intervalo exceder 4 MiB de tamanho, o serviço retornará o código de status 400 (Solicitação Incorreta).
x-ms-content-crc64 Se a solicitação for para ler um intervalo especificado e o x-ms-range-get-content-crc64 estiver definido como true, a solicitação retornará um hash CRC64 para o intervalo, desde que o tamanho do intervalo seja menor ou igual a 4 MiB.

Se x-ms-range-get-content-crc64 for especificado sem o cabeçalho Range, o serviço retornará o código de status 400 (Solicitação Incorreta).

Se x-ms-range-get-content-crc64 for definido true como quando o intervalo exceder 4 MiB de tamanho, o serviço retornará o código de status 400 (Solicitação Incorreta).
Content-Encoding Esse cabeçalho retorna o valor que foi especificado para o cabeçalho de solicitação Content-Encoding.
Content-Language Esse cabeçalho retorna o valor que foi especificado para o cabeçalho de solicitação Content-Language.
Cache-Control Esse cabeçalho será retornado, caso tenha sido especificado antes para o blob.
Content-Disposition Retornado para solicitações na versão 2013-08-15 e mais recente. Esse cabeçalho retorna o valor que foi especificado para o cabeçalho x-ms-blob-content-disposition.

O campo do cabeçalho de resposta Content-Disposition transmite informações adicionais sobre como processar a carga de resposta, e também pode ser usado para anexar metadados adicionais. Por exemplo, se for definido como attachment, ele indicará que o usuário agente não deve exibir a resposta, mas em vez disso, mostra uma caixa de diálogo Salvar como com um nome de arquivo diferente do nome de blob especificado.
x-ms-blob-sequence-number O número de sequência atual de um blob de páginas.

Esse cabeçalho não é retornado para blobs de blocos ou blobs de acréscimo.
x-ms-blob-type: <BlockBlob | PageBlob | AppendBlob> Retorna o tipo de blob.
x-ms-copy-completion-time: <datetime> Versão 2012-02-12 e mais recente. A hora da conclusão da última tentativa de executar a operação Copy Blob em que esse blob foi o blob de destino. Esse valor pode especificar a hora de uma tentativa de cópia concluída, cancelada o com falha. Esse cabeçalho não será exibido se uma cópia estiver pendente, se esse blob nunca tiver sido o destino em uma operação Copy Blob ou se esse blob tiver sido alterado depois de uma operação Copy Blob concluída usando Set Blob Properties, Put Blob ou Put Block List.
x-ms-copy-status-description: <error string> Versão 2012-02-12 e mais recente. Aparece somente quando x-ms-copy-status é failed ou pending. Descreve a causa da última falha fatal ou não fatal da operação de cópia. Esse cabeçalho não será exibido se esse blob nunca tiver sido o destino em uma operação Copy Blob ou se esse blob tiver sido alterado depois de uma operação Copy Blob concluída usando Set Blob Properties, Put Blob ou Put Block List.
x-ms-copy-id: <id> Versão 2012-02-12 e mais recente. Identificador de cadeia de caracteres para a última tentativa de executar a operação Copy Blob em que esse blob foi o destino. Esse cabeçalho não será exibido se esse blob nunca tiver sido o destino em uma operação Copy Blob ou se esse blob tiver sido alterado depois de uma operação Copy Blob concluída usando Set Blob Properties, Put Blob ou Put Block List.
x-ms-copy-progress: <bytes copied/bytes total> Versão 2012-02-12 e mais recente. Contém o número de bytes copiados e o total de bytes na origem na última tentativa de executar a operação Copy Blob em que esse blob foi o destino. Pode mostrar entre 0 e Content-Length bytes copiados. Esse cabeçalho não será exibido se esse blob nunca tiver sido o destino em uma operação Copy Blob ou se esse blob tiver sido alterado depois de uma operação Copy Blob concluída usando Set Blob Properties, Put Blob ou Put Block List.
x-ms-copy-source: url Versão 2012-02-12 e mais recente. URL de até 2 KiB de comprimento que especifica o blob de origem ou arquivo usado na última tentativa Copy Blob de operação em que esse blob foi o blob de destino. Esse cabeçalho não será exibido se esse blob nunca tiver sido o destino em uma operação Copy Blob ou se esse blob tiver sido alterado depois de uma operação Copy Blob concluída usando Set Blob Properties, Put Blob ou Put Block List.

A URL retornada nesse cabeçalho contém todos os parâmetros de solicitação usados na operação de cópia no blob de origem, incluindo o token SAS usado para acessar o blob de origem.
x-ms-copy-status: <pending | success | aborted | failed> Versão 2012-02-12 e mais recente. Estado da operação de cópia identificada por x-ms-copy-id, com estes valores:

- success: cópia concluída com êxito.
- pending: a cópia está em andamento. Verifique x-ms-copy-status-description se erros intermitentes e não fatais tornarem lento o andamento da cópia, mas não causarem falha.
- aborted: a cópia foi encerrada por Abort Copy Blob.
- failed: falha na cópia. Consulte x-ms-copy-status-description para obter detalhes sobre a falha.

Esse cabeçalho não será exibido se esse blob nunca tiver sido o destino em uma operação Copy Blob ou se esse blob tiver sido alterado depois de uma operação Copy Blob concluída usando Set Blob Properties, Put Blob ou Put Block List.
x-ms-lease-duration: <infinite | fixed> Versão 2012-02-12 e mais recente. Quando um blob é concedido, especifica se a concessão tem duração infinita ou fixa.
x-ms-lease-state: <available | leased | expired | breaking | broken> Versão 2012-02-12 e mais recente. Estado da concessão do blob.
x-ms-lease-status:<locked | unlocked> O status da concessão atual do blob.
x-ms-request-id Esse cabeçalho identifica a solicitação que foi feita de forma exclusiva e pode ser usado para solucionar problemas na solicitação. Para obter mais informações, consulte Solução de problemas de operações de API.
x-ms-version Indica a versão do serviço Blob usado para executar a solicitação. Incluído para solicitações feitas usando a versão 2009-09-19 e mais recente.

Esse cabeçalho será retornado também para solicitações anônimas sem uma versão especificada se o contêiner foi marcado para acesso público usando a versão 2009-09-19 do serviço Blob.
Accept-Ranges: bytes Indica se o serviço oferece suporte a solicitações de conteúdo de blob parcial. Incluído para solicitações feitas com a versão 2011-08-18 e mais recente, e para o serviço de armazenamento local na versão 1.6 do SDK ou mais recente.
Date Um valor de data/hora UTC gerado pelo serviço que indica a hora em que a resposta foi iniciada.
Access-Control-Allow-Origin Retornado se a solicitação incluir um cabeçalho Origin e CORS estiver habilitado com uma regra de correspondência. Este cabeçalho retorna o valor do cabeçalho de solicitação de origem no caso de uma correspondência.
Access-Control-Expose-Headers Retornado se a solicitação incluir um cabeçalho Origin e CORS estiver habilitado com uma regra de correspondência. Retorna a lista de cabeçalhos de resposta que devem ser expostos ao cliente ou ao emissor da solicitação.
Vary Retornado com o valor do cabeçalho Origin quando as regras de CORS são especificadas. Consulte o suporte do CORS para os Serviços de Armazenamento para obter detalhes.
Access-Control-Allow-Credentials Retornado se a solicitação incluir um cabeçalho Origin e CORS estiver habilitado com uma regra de correspondência. que não permite todas as origens. Esse cabeçalho será definido como verdadeiro.
x-ms-blob-committed-block-count O número de blocos confirmados presentes no blob. Esse cabeçalho é retornado somente para blobs de acréscimo.
x-ms-server-encrypted: true/false Versão 2015-12-11 ou mais recente. O valor desse cabeçalho será definido como true se os dados de blob e os metadados do aplicativo forem completamente criptografados usando o algoritmo especificado. Caso contrário, o valor será definido false como (quando o blob não for criptografado ou se apenas partes dos metadados de blob/aplicativo forem criptografadas).
x-ms-encryption-key-sha256 Versão 2019-02-02 ou mais recente. Esse cabeçalho será retornado se o blob for criptografado com uma chave fornecida pelo cliente.
x-ms-encryption-scope Versão 2019-02-02 ou mais recente. Esse cabeçalho será retornado se o blob for criptografado com um escopo de criptografia.
x-ms-blob-content-md5 A partir da versão 2016-05-31, se o blob tiver um hash MD5 e se a solicitação contiver o cabeçalho de intervalo (Intervalo ou x-ms-range), esse cabeçalho de resposta será retornado com o valor do MD5 do blob inteiro. Esse valor pode ou não ser igual ao valor retornado no cabeçalho Content-MD5, com este último calculado do intervalo solicitado.
x-ms-client-request-id Esse cabeçalho pode ser usado para solucionar problemas de solicitações e respostas correspondentes. O valor desse cabeçalho será igual ao valor do x-ms-client-request-id cabeçalho se ele estiver presente na solicitação e o valor estiver no máximo 1024 caracteres ASCII visíveis. Se o x-ms-client-request-id cabeçalho não estiver presente na solicitação, esse cabeçalho não estará presente na resposta.
x-ms-last-access-time Versão 2020-02-10 ou mais recente. Indica a última vez em que os dados do blob foram acessados com base na política de controle de tempo de acesso da última conta de armazenamento. O cabeçalho não será retornado se a conta de armazenamento não tiver uma política de acompanhamento de hora de acesso ou se a política estiver desabilitada. Para obter informações sobre como definir a política de controle de tempo de acesso da última conta de armazenamento, consulte a API do Serviço de Blob.
x-ms-blob-sealed Versão 2019-12-12 ou mais recente, retornada somente para blobs de acréscimo. Se o blob de acréscimo tiver sido lacrado, o valor será verdadeiro, consulte Blobs do Seal Append
x-ms-immutability-policy-until-date Versão 2020-06-12 ou mais recente. Especifica a data de 'retenção até' definida no blob. Essa é a data até a qual o blob pode ser protegido contra modificação ou exclusão. Retornado somente se uma política de imutabilidade for definida no blob. O valor desse cabeçalho é o formato RFC1123.
x-ms-immutability-policy-mode: unlocked/locked Versão 2020-06-12 ou mais recente. O modo de política de imutabilidade, retornado se uma política de imutabilidade for definida no blob. Os valores são unlocked/locked. unlocked indica que o usuário pode alterar a política aumentando ou diminuindo a retenção até a data. locked indica que essas ações são proibidas.
x-ms-legal-hold: true/false Versão 2020-06-12 ou mais recente. Esse cabeçalho não será retornado se não houver nenhuma retenção legal no blob. O valor desse cabeçalho será definido como true se o blob contiver uma retenção legal e seu valor for verdadeiro. Caso contrário, o valor será definido como false se o blob contiver uma retenção legal e seu valor falso.
x-ms-owner Versão 2020-06-12 ou mais recente apenas para contas com namespace hierárquico habilitado. Retorna o usuário proprietário do arquivo ou diretório.
x-ms-group Versão 2020-06-12 ou mais recente apenas para contas com namespace hierárquico habilitado. Retorna o grupo proprietário do arquivo ou diretório.
x-ms-permissions Versão 2020-06-12 ou mais recente apenas para contas com namespace hierárquico habilitado. Retorna as permissões definidas para 'user', 'group' e 'other' no arquivo ou diretório. Cada permissão individual está no formato [r,w,x,-]{3} .
x-ms-resource-type Versão 2020-10-02 ou mais recente somente para contas com namespace hierárquico habilitado. Retorna o tipo de recurso para o caminho, que pode ser qualquer um file/directory.

Corpo da resposta

O corpo da resposta tem o conteúdo do blob.

Exemplo de Resposta

Status Response:  
HTTP/1.1 200 OK  
  
Response Headers:  
x-ms-blob-type: BlockBlob  
x-ms-lease-status: unlocked  
x-ms-lease-state: available  
x-ms-meta-m1: v1  
x-ms-meta-m2: v2  
Content-Length: 11  
Content-Type: text/plain; charset=UTF-8  
Date: <date>  
ETag: "0x8CB171DBEAD6A6B"  
Vary: Origin  
Last-Modified: <date>  
x-ms-version: 2015-02-21  
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0  
x-ms-copy-id: 36650d67-05c9-4a24-9a7d-a2213e53caf6  
x-ms-copy-source: <url>  
x-ms-copy-status: success  
x-ms-copy-progress: 11/11  
x-ms-copy-completion-time: <date>  
  

Autorização

Se a lista de controle de acesso (ACL) do contêiner for definida para permitir o acesso anônimo ao blob, qualquer cliente poderá chamar essa operação. Se o contêiner for privado, essa operação poderá ser executada pelo proprietário da conta e por qualquer pessoa com uma assinatura compartilhada de acesso que tenha permissão para ler o blob.

Comentários

Para um blob de páginas, uma operação Get Blob em um intervalo de páginas que ainda não têm conteúdo ou que foi limpo retorna zeros para esses bytes.

Se você chamar Get Blob em um blob de páginas sem o intervalo especificado, o serviço retornará o intervalo de páginas até o valor especificado para o cabeçalho x-ms-blob-content-length. Para todas as páginas que carecem de conteúdo, o serviço retornará zero para esses bytes.

Para um blob de acréscimo, a operação retorna x-ms-blob-committed-block-count o Get Blob cabeçalho. Esse cabeçalho indica o número de blocos confirmados no blob. O x-ms-blob-committed-block-count cabeçalho não é retornado para blobs de blocos ou blobs de página.

Uma Get Blob operação tem permissão de 2 minutos por MiB para ser concluída. Se a operação estiver demorando mais de 2 minutos por MiB, em média, a operação acabará.

O cabeçalho x-ms-version é necessário para recuperar um blob que pertence a um contêiner privado. Se o blob pertencer a um contêiner disponível para acesso público completo ou parcial, qualquer cliente poderá lê-lo sem especificar uma versão; a versão do serviço não é necessária para recuperar um blob que pertence a um contêiner público. Consulte Restringir o acesso aos contêineres e Blobs (a página pode estar em inglês) para obter mais informações.

Um Get Blob blob de bloco arquivado falhará.

Copiar operações

Para determinar se uma operação Copy Blob foi concluída, primeiro verifique se o valor de cabeçalho x-ms-copy-id do blob de destino corresponde à ID da cópia fornecida pela chamada original para Copy Blob. Uma correspondência assegura que outro aplicativo não anulou a cópia e iniciou uma nova operação Copy Blob. Então, verifique o cabeçalho x-ms-copy-status: success. No entanto, lembre-se de que todas as operações de gravação em um blob, exceto as operações Lease, Put Page e Put Block, removem todas as propriedades x-ms-copy-* do blob. Essas propriedades também não são copiadas por operações Copy Blob que usam versões anteriores a 2012-02-12.

Aviso

A URL retornada no cabeçalho contém todos os x-ms-copy-source parâmetros de solicitação usados na operação de cópia no blob de origem. Se um token SAS for usado para acessar o blob de origem, esse token SAS aparecerá no x-ms-copy-source cabeçalho quando Get Blob for chamado no blob de destino.

Quando x-ms-copy-status: failed aparece na resposta, x-ms-copy-status-description contém mais informações sobre a falha de Copy Blob.

A tabela a seguir descreve os três campos de cada valor x-ms-copy-status-description.

Componente Descrição
Código de status HTTP O valor inteiro de três dígitos que especifica a falha.
Código do erro Palavra-chave que descreve o erro fornecido pelo Azure no <elemento ErrorCode> . Se nenhum <elemento ErrorCode> for exibido, será usada uma palavra-chave que contém o texto de erro padrão associado ao código de status HTTP de 3 dígitos na especificação HTTP. Consulte códigos de erro comuns da API REST.
Informações Descrição detalhada da falha, entre aspas.

A tabela a seguir descreve os valores x-ms-copy-status e x-ms-copy-status-description de cenários de falha comuns.

Importante

O texto da descrição mostrado aqui pode ser alterado sem aviso, mesmo sem uma alteração da versão, portanto, não conte com a correspondência exata a esse texto.

Cenário Valor x-ms-copy-status Valor x-ms-copy-status-description
Operação de cópia concluída com êxito. sucesso empty
O usuário anulou a operação de cópia antes da conclusão. aborted empty
Falha na leitura do blob de origem durante uma operação de cópia, mas a operação será repetida. pending 502 BadGateway "Encontrado um erro reproduzível ao ler a origem. Uma nova tentativa será realizada. Tempo de falha: <tempo>"
Falha ao gravar no blob de destino de uma operação de cópia, mas a operação será repetida. pending 500 InternalServerError "Encontrado um erro reproduzível. Uma nova tentativa será realizada. Tempo de falha: <tempo>"
Falha irrecuperável durante a leitura do blob de origem de uma operação de cópia. falhou 404 ResourceNotFound "Falha na cópia ao ler a origem.”

Nota: Ao relatar esse erro subjacente, o Azure retorna ResourceNotFound no ErrorCode elemento. Se nenhum ErrorCode elemento aparecesse na resposta, uma representação de cadeia de caracteres padrão do status HTTP, como NotFound seria exibido.
O tempo limite que limita todas as operações de cópia expirou. (Atualmente, o tempo limite é duas semanas.) falhou 500 OperationCancelled "A cópia excedeu o tempo máximo permitido.”
Ocorreram falhas muito frequentes na leitura da origem, e uma proporção mínima de tentativas e êxitos não foi atendida. (Esse tempo limite impede tentativas a partir de uma origem muito ruim por duas semanas antes da falha). falhou 500 OperationCancelled "Falha na cópia durante a leitura da origem.”

x-ms-last-access-time controla a hora em que os dados do blob foram acessados com base na política de controle de tempo de acesso da última conta de armazenamento. Acessar os metadados de um blob não altera a hora do último acesso.

Confira também

Autorizar solicitações ao Armazenamento do Azure
Status e códigos de erro
Códigos de erro do serviço Blob
Configurando os tempos limite para operações de serviço do Blob