Get Blob PropertiesGet Blob Properties

A operação Get Blob Properties retorna todos os metadados definidos pelo usuário, propriedades HTTP padrão e propriedades do sistema para o blob.The Get Blob Properties operation returns all user-defined metadata, standard HTTP properties, and system properties for the blob. Ela não retorna o conteúdo do blob.It does not return the content of the blob.

SolicitaçãoRequest

A solicitação Get Blob Properties pode ser criada da seguinte maneira.The Get Blob Properties request may be constructed as follows. HTTPS é recomendado.HTTPS is recommended. Substitua myaccount pelo nome da sua conta de armazenamento:Replace myaccount with the name of your storage account:

URI de solicitação do método HEADHEAD Method Request URI Versão de HTTPHTTP Version
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.1HTTP/1.1

URI do serviço de armazenamento emuladoEmulated storage service URI

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:When making a request against the emulated storage service, specify the emulator hostname and Blob service port as 127.0.0.1:10000, followed by the emulated storage account name:

URI de solicitação do método HEADHEAD Method Request URI Versão de HTTPHTTP Version
http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob HTTP/1.1HTTP/1.1

Para obter mais informações, consulte usando o emulador de armazenamento do Azure para desenvolvimento e teste.For more information, see Using the Azure Storage Emulator for Development and Testing.

Parâmetros do URIURI parameters

Os seguintes parâmetros adicionais podem ser especificados no URI de solicitação.The following additional parameters may be specified on the request URI.

ParâmetroParameter DescriçãoDescription
snapshot Opcional.Optional. O parâmetro de instantâneo é um valor DateTime opaco que, quando presente, especifica o instantâneo de blob a ser recuperado.The snapshot parameter is an opaque DateTime value that, when present, specifies the blob snapshot to retrieve. Para obter mais informações sobre como trabalhar com instantâneos de BLOB, consulte criando um instantâneo de um blobFor more information on working with blob snapshots, see Creating a Snapshot of a Blob
versionid Opcional, versão 2019-12-12 e mais recente.Optional, version 2019-12-12 and newer. O parâmetro VersionId é um DateTime valor opaco que, quando presente, especifica a versão do blob a recuperar.The versionid parameter is an opaque DateTime value that, when present, specifies the Version of the blob to retrieve.
timeout Opcional.Optional. O parâmetro timeout é expresso em segundos.The timeout parameter is expressed in seconds. Para obter mais informações, consulte definindo tempos limite para operações do serviço blob.For more information, see Setting Timeouts for Blob Service Operations.

Cabeçalhos de solicitaçãoRequest Headers

A tabela a seguir descreve os cabeçalhos de solicitação obrigatórios e opcionais.The following table describes required and optional request headers.

Cabeçalho da solicitaçãoRequest Header DescriçãoDescription
Authorization Obrigatórios.Required. Especifica o esquema de autorização, o nome da conta e a assinatura.Specifies the authorization scheme, account name, and signature. Para obter mais informações, consulte autorizar solicitações ao armazenamento do Azure.For more information, see Authorize requests to Azure Storage.
Date ou x-ms-dateDate or x-ms-date Necessário.Required. Especifica o UTC (Tempo Universal Coordenado) para a solicitação.Specifies the Coordinated Universal Time (UTC) for the request. Para obter mais informações, consulte autorizar solicitações ao armazenamento do Azure.For more information, see Authorize requests to Azure Storage.
x-ms-version Necessário para todas as solicitações autorizadas, opcional para solicitações anônimas.Required for all authorized requests, optional for anonymous requests. Especifica a versão da operação a ser usada para esta solicitação.Specifies the version of the operation to use for this request. Para obter mais informações, consulte controle de versão para os serviços de armazenamento do Azure.For more information, see Versioning for the Azure Storage Services.
x-ms-lease-id: <ID> Opcional.Optional. Se esse cabeçalho for especificado, a operação Get Blob Properties será executada apenas se as seguintes condições forem atendidas:If this header is specified, the Get Blob Properties operation will be performed only if both of the following conditions are met:

-A concessão do blob está ativa no momento.- The blob's lease is currently active.
-A ID de concessão especificada na solicitação corresponde à do blob.- The lease ID specified in the request matches that of the blob.

Se nenhuma dessas condições for atendida, a solicitação não será feita e ocorrerá uma falha na operação Get Blob Properties com o código de status 412 (Falha na Pré-condição).If both of these conditions are not met, the request will fail and the Get Blob Properties operation will fail with status code 412 (Precondition Failed).
x-ms-client-request-id Opcional.Optional. 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 da análise de armazenamento está habilitado.Provides a client-generated, opaque value with a 1 KiB character limit that is recorded in the analytics logs when storage analytics logging is enabled. O uso desse cabeçalho é altamente recomendável para correlacionar as atividades do lado do cliente com as solicitações recebidas pelo servidor.Using this header is highly recommended for correlating client-side activities with requests received by the server. Para obter mais informações, consulte sobre log de análise de armazenamento e log do Azure: usando logs para rastrear solicitações de armazenamento.For more information, see About Storage Analytics Logging and Azure Logging: Using Logs to Track Storage Requests.

Essa operação também dará suporte ao uso de cabeçalhos condicionais para retornar propriedades de blob e metadados somente se uma determinada condição for atendida.This operation also supports the use of conditional headers to return blob properties and metadata only if a specified condition is met. Para obter mais informações, confira Como especificar cabeçalhos condicionais para operações de serviço Blob.For more information, see Specifying Conditional Headers for Blob Service Operations.

Cabeçalhos de solicitação (chaves de criptografia fornecidas pelo cliente)Request Headers (Customer-provided encryption keys)

A partir da versão 2019-02-02, os seguintes cabeçalhos podem ser especificados na solicitação para ler um blob criptografado com uma chave fornecida pelo cliente.Beginning with version 2019-02-02, the following headers may be specified on the request to read a blob encrypted with a customer-provided key. A criptografia com uma chave fornecida pelo cliente (e o conjunto de cabeçalhos correspondente) é opcional.Encryption with a customer-provided key (and the corresponding set of headers) is optional. 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.If a blob has previously been encrypted with a customer-provided key, then these headers must be included on the request to complete the read operation successfully.

Cabeçalho da solicitaçãoRequest header DescriçãoDescription
x-ms-encryption-key Obrigatórios.Required. A chave de criptografia AES-256 codificada em base64.The Base64-encoded AES-256 encryption key.
x-ms-encryption-key-sha256 Opcional.Optional. O hash SHA256 codificado em base64 da chave de criptografia.The Base64-encoded SHA256 hash of the encryption key.
x-ms-encryption-algorithm: AES256 Necessário.Required. Especifica o algoritmo a ser usado para criptografia.Specifies the algorithm to use for encryption. O valor desse cabeçalho deve ser AES256 .The value of this header must be AES256.

Corpo da solicitaçãoRequest Body

nenhuma.None.

RespostaResponse

A resposta inclui um código de status HTTP e um conjunto de cabeçalhos de resposta.The response includes an HTTP status code and a set of response headers.

Código de statusStatus Code

Uma operação bem-sucedida retorna o código de status 200 (OK).A successful operation returns status code 200 (OK).

Para obter informações sobre códigos de status, consulte status e códigos de erro.For information about status codes, see Status and Error Codes.

Cabeçalhos de respostaResponse Headers

A resposta para esta operação inclui os cabeçalhos a seguir.The response for this operation includes the following headers. A resposta também pode incluir cabeçalhos padrão HTTP adicionais.The response may also include additional standard HTTP headers. Todos os cabeçalhos padrão estão em conformidade com a especificação do protocolo HTTP/1.1.All standard headers conform to the HTTP/1.1 protocol specification.

Cabeçalho de respostaResponse header DescriçãoDescription
Last-Modified A data e a hora da última modificação feita no blob.The date/time that the blob was last modified. O formato da data segue RFC 1123.The date format follows RFC 1123. Para obter mais informações, consulte representação de valores de Date-Time nos cabeçalhos.For more information, see Representation of Date-Time Values in Headers.

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.Any operation that modifies the blob, including an update of the blob's metadata or properties, changes the last modified time of the blob.
x-ms-creation-time Versão 2017-11-09 e mais recente.Version 2017-11-09 and newer. A data/hora em que o blob foi criado.The date/time at which the blob was created. O formato da data segue RFC 1123.The date format follows RFC 1123. Para obter mais informações, consulte representação de valores de Date-Time nos cabeçalhos.For more information, see Representation of Date-Time Values in Headers.
x-ms-meta-name:value Conjunto de pares de nome-valor que correspondem aos metadados definidos pelo usuário associados a esse blob.A set of name-value pairs that correspond to the user-defined metadata associated with this blob.
x-ms-tag-count Versão 2019-12-12 ou mais recente.Version 2019-12-12 or newer. Se o blob tiver qualquer marca, retornará o número de marcas armazenadas no BLOB.If the blob has any tags, returns the number of tags stored on the blob. Esse cabeçalho não será retornado se não houver nenhuma marca no BLOB.This header is not returned if there are no tags on the blob.
x-ms-blob-type:<BlockBlob&#124;PageBlob&#124;AppendBlob> O tipo de blob.The blob type.
x-ms-copy-completion-time:<datetime> Versão 2012-02-12 e mais recente.Version 2012-02-12 and newer. A hora da conclusão da última tentativa de executar a operação Copy Blob em que esse blob foi o blob de destino.Conclusion time of the last attempted Copy Blob operation where this blob was the destination blob. Esse valor pode especificar a hora de uma tentativa de cópia concluída, cancelada o com falha.This value can specify the time of a completed, aborted, or failed copy attempt. 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.This header does not appear if a copy is pending, if this blob has never been the destination in a Copy Blob operation, or if this blob has been modified after a concluded Copy Blob operation using Set Blob Properties, Put Blob, or Put Block List.
x-ms-copy-status-description: <error string> A versão 2012-02-12 e mais recentes aparecem somente quando x-ms-copy-status é failed ou pending.Version 2012-02-12 and newer, only appears when x-ms-copy-status is failed or pending. Descreve a causa da falha fatal ou não fatal da operação de cópia.Describes cause of fatal or non-fatal copy operation failure. 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.This header does not appear if this blob has never been the destination in a Copy Blob operation, or if this blob has been modified after a concluded Copy Blob operation using Set Blob Properties, Put Blob, or Put Block List.
x-ms-copy-id: <id> Versão 2012-02-12 e mais recente.Version 2012-02-12 and newer. Identificador de cadeia de caracteres para a última tentativa de executar a operação Copy Blob em que esse blob foi o destino.String identifier for the last attempted Copy Blob operation where this blob was the destination blob. 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.This header does not appear if this blob has never been the destination in a Copy Blob operation, or if this blob has been modified after a concluded Copy Blob operation using Set Blob Properties, Put Blob, or Put Block List.
x-ms-copy-progress: <bytes copied/bytes total> Versão 2012-02-12 e mais recente.Version 2012-02-12 and newer. 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.Contains the number of bytes copied and the total bytes in the source in the last attempted Copy Blob operation where this blob was the destination blob. Pode mostrar entre 0 e Content-Length bytes copiados.Can show between 0 and Content-Length bytes copied. 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.This header does not appear if this blob has never been the destination in a Copy Blob operation, or if this blob has been modified after a concluded Copy Blob operation using Set Blob Properties, Put Blob, or Put Block List.
x-ms-copy-source: url Versão 2012-02-12 e mais recente.Version 2012-02-12 and newer. URL de até 2 KiB de comprimento que especifica o blob de origem usado na última tentativa de Copy Blob operação em que esse blob era o blob de destino.URL up to 2 KiB in length that specifies the source blob used in the last attempted Copy Blob operation where this blob was the destination blob. 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.This header does not appear if this blob has never been the destination in a Copy Blob operation, or if this blob has been modified after a concluded Copy Blob operation using Set Blob Properties, Put Blob, or Put Block List.
x-ms-copy-status: <pending &#124; success &#124; aborted &#124; failed> Versão 2012-02-12 e mais recente.Version 2012-02-12 and newer. Estado da operação de cópia identificada por x-ms-copy-id, com estes valores:State of the copy operation identified by x-ms-copy-id, with these values:

- success: Cópia concluída com êxito.- success: Copy completed successfully.
- pending: A cópia está em andamento.- pending: Copy is in progress. Verifique x-ms-copy-status-description se erros intermitentes e não fatais impedirem o andamento da cópia, mas não causarem falha.Check x-ms-copy-status-description if intermittent, non-fatal errors impede copy progress but don’t cause failure.
- aborted: A cópia foi finalizada por Abort Copy Blob .- aborted: Copy was ended by Abort Copy Blob.
- failed: Falha na cópia.- failed: Copy failed. Consulte x-ms-copy-status-description para obter detalhes da falha.See x-ms-copy-status-description for failure details.

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.This header does not appear if this blob has never been the destination in a Copy Blob operation, or if this blob has been modified after a completed Copy Blob operation using Set Blob Properties, Put Blob, or Put Block List.
x-ms-incremental-copy: true Versão 2016-05-31 e mais recente.Version 2016-05-31 and newer. Incluído se o blob for cópia incremental BLOB.Included if the blob is incremental copy blob.
x-ms-copy-destination-snapshot:<datetime> Versão 2016-05-31 e mais recente.Version 2016-05-31 and newer. Incluído se o blob for um blob de cópia incremental ou instantâneo de cópia incremental, se x-ms-copy-status for êxito.Included if the blob is incremental copy blob or incremental copy snapshot, if x-ms-copy-status is success. Hora do instantâneo do último instantâneo de cópia incremental com êxito para este BLOB.Snapshot time of the last successful incremental copy snapshot for this blob.
x-ms-lease-duration: <infinite &#124; fixed> Quando um blob é concedido, especifica se a concessão tem duração infinita ou fixa.When a blob is leased, specifies whether the lease is of infinite or fixed duration. Incluído para solicitações que usam a versão 2012-02-12 e mais recente.Included for requests using version 2012-02-12 and newer.
x-ms-lease-state: <available &#124; leased &#124; expired &#124; breaking &#124; broken> Estado da concessão do blob.Lease state of the blob. Incluído para solicitações feitas usando a versão 2012-02-12 e mais recente.Included for requests made using version 2012-02-12 and newer.
x-ms-lease-status:<locked&#124; unlocked> O status da concessão do blob.The lease status of the blob.
Content-Length O tamanho do blob em bytes.The size of the blob in bytes. Para um blob de páginas, esse cabeçalho retorna o valor do cabeçalho x-ms-blob-content-length que é armazenado com o blob.For a page blob, this header returns the value of the x-ms-blob-content-length header that is stored with the blob.
Content-Type O tipo de conteúdo especificado para o blob.The content type specified for the blob. Se nenhum tipo de conteúdo tiver sido especificado, o tipo de conteúdo padrão será application/octet-stream.If no content type was specified, the default content type is application/octet-stream.
Etag A ETag contém um valor que você pode usar para executar operações de forma condicional.The ETag contains a value that you can use to perform operations conditionally. Consulte especificando cabeçalhos condicionais para operações do serviço blob para obter mais informações.See Specifying Conditional Headers for Blob Service Operations for more information. Se a versão da solicitação for a 2011-08-18 ou mais recente, o valor de ETag será exibido entre aspas.If the request version is 2011-08-18 or newer, the ETag value will be in quotes.
Content-MD5 Se o cabeçalho Content-MD5 tiver sido definido para o blob, esse cabeçalho de resposta será retornado de modo que o cliente possa verificar a integridade do conteúdo da mensagem.If the Content-MD5 header has been set for the blob, this response header is returned so that the client can check for message content integrity.

Na versão 2012-02-12 e mais recente, Put Blob define o valor MD5 de um blob de blocos mesmo quando a solicitação Put Blob não inclui um cabeçalho MD5.In version 2012-02-12 and newer, Put Blob sets a block blob’s MD5 value even when the Put Blob request doesn’t include an MD5 header.
Content-Encoding Se o cabeçalho de solicitação Content-Encoding tiver sido definido previamente para o blob, esse valor será retornado nesse cabeçalho.If the Content-Encoding request header has previously been set for the blob, that value is returned in this header.
Content-Language Se o cabeçalho de solicitação Content-Language tiver sido definido previamente para o blob, esse valor será retornado nesse cabeçalho.If the Content-Language request header has previously been set for the blob, that value is returned in this header.
Content-Disposition Se o cabeçalho de solicitação Content-Disposition tiver sido definido previamente para o blob, esse valor será retornado nesse cabeçalho, para solicitações contra a versão 15-08-2013 e posterior.If the Content-Disposition request header has previously been set for the blob, that value is returned in this header, for requests against version 2013-08-15 and later.

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.The Content-Disposition response header field conveys additional information about how to process the response payload, and also can be used to attach additional metadata. Por exemplo, se for definido como attachment, indica que o agente de usuário não deve exibir a resposta, mas em vez disos mostra uma caixa de diálogo Salvar como.For example, if set to attachment, it indicates that the user-agent should not display the response, but instead show a Save As dialog.
Cache-Control Se o cabeçalho de solicitação Cache-Control tiver sido definido previamente para o blob, esse valor será retornado nesse cabeçalho.If the Cache-Control request header has previously been set for the blob, that value is returned in this header.
x-ms-blob-sequence-number O número de sequência atual de um blob de páginas.The current sequence number for a page blob.

Esse cabeçalho não é retornado para BLOBs de bloco ou BLOBs de acréscimo.This header is not returned for block blobs or append blobs.

Esse cabeçalho não é retornado para blobs de blocos.This header is not returned for block blobs.
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.This header uniquely identifies the request that was made and can be used for troubleshooting the request. Para obter mais informações, consulte Solucionando problemas de operações de API.For more information, see Troubleshooting API Operations.
x-ms-version Indica a versão do serviço Blob usado para executar a solicitação.Indicates the version of the Blob service used to execute the request. Esse cabeçalho é retornado para solicitações feitas na versão 2009-09-19 e mais recente.This header is returned for requests made against version 2009-09-19 and later.

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.This header is also returned for anonymous requests without a version specified if the container was marked for public access using the 2009-09-19 version of the Blob service.
Date Um valor de data/hora UTC gerado pelo serviço que indica a hora em que a resposta foi iniciada.A UTC date/time value generated by the service that indicates the time at which the response was initiated.
Accept-Ranges: bytes Indica se o serviço oferece suporte a solicitações de conteúdo de blob parcial.Indicates that the service supports requests for partial blob content. Incluído para solicitações feitas com a versão 15/08/2013 e mais recente.Included for requests made using version 2013-08-15 and newer.
x-ms-blob-committed-block-count O número de blocos confirmados presentes no BLOB.The number of committed blocks present in the blob. Esse cabeçalho é retornado somente para BLOBs de acréscimo.This header is returned only for append blobs.
x-ms-server-encrypted: true/false Versão 2015-12-11 ou mais recente.Version 2015-12-11 or newer. O valor desse cabeçalho será definido como true se os dados do blob e os metadados do aplicativo forem completamente criptografados usando o algoritmo especificado.The value of this header is set to true if the blob data and application metadata are completely encrypted using the specified algorithm. Caso contrário, o valor será definido como false (quando o blob for descriptografado, ou se apenas partes dos metadados de blob/aplicativo forem criptografadas).Otherwise, the value is set to false (when the blob is unencrypted, or if only parts of the blob/application metadata are encrypted).
x-ms-encryption-key-sha256 Versão 2019-02-02 ou mais recente.Version 2019-02-02 or newer. Esse cabeçalho será retornado se o blob for criptografado com uma chave fornecida pelo cliente.This header is returned if the blob is encrypted with a customer-provided key.
x-ms-encryption-scope Versão 2019-02-02 ou mais recente.Version 2019-02-02 or newer. Esse cabeçalho será retornado se o blob for criptografado com um escopo de criptografia.This header is returned if the blob is encrypted with an encryption scope.
x-ms-access-tier Versão 2017-04-17 ou mais recente.Version 2017-04-17 or newer. A camada de blob de páginas em uma conta de armazenamento Premium ou camada de blob de blocos no armazenamento de BLOBs ou conta de uso geral v2.The tier of page blob on a premium storage account or tier of block blob on blob storage or general purpose v2 account. Para obter uma lista de camadas de blob de páginas Premium permitidas, consulte armazenamento Premium de alto desempenho e discos gerenciados para VMs.For a list of allowed premium page blob tiers, see High-performance Premium Storage and managed disks for VMs. Para o armazenamento de BLOBs ou a conta de uso geral v2, os valores válidos são Hot / Cool / Archive .For blob storage or general purpose v2 account, valid values are Hot/Cool/Archive. Para obter informações detalhadas sobre camadas de nível de blob do bloco de conta de blob padrão , consulte camadas de armazenamento quentes, frias e de arquivo morto.For detailed information about standard blob account block blob level tiering see Hot, cool and archive storage tiers.
x-ms-access-tier-inferred: true Versão 2017-04-17 e mais recente.Version 2017-04-17 and newer. Somente para BLOBs de páginas em uma conta de armazenamento Premium.For page blobs on a premium storage account only. Se a camada de acesso não estiver definida explicitamente no BLOB, a camada será inferida com base no tamanho do conteúdo e esse cabeçalho será retornado com o true valor.If the access tier is not explicitly set on the blob, the tier is inferred based on its content length and this header will be returned with true value. Para BLOBs de blocos no armazenamento de BLOBs ou na conta de uso geral v2, se o BLOB não tiver a camada de acesso definida, inferirei a camada das propriedades da conta de armazenamento.For block blobs on Blob Storage or general purpose v2 account, if the blob does not have the access tier set then we infer the tier from the storage account properties. Esse cabeçalho será definido somente se a camada de blob de blocos for inferidaThis header is set only if the block blob tier is inferred
x-ms-archive-status Versão 2017-04-17 ou mais recente.Version 2017-04-17 or newer. Para o armazenamento de BLOBs ou a conta de uso geral v2, os valores válidos são rehydrate-pending-to-hot / rehydrate-pending-to-cool .For blob storage or general purpose v2 account, valid values are rehydrate-pending-to-hot/rehydrate-pending-to-cool. Se o blob estiver sendo alimentado e não for concluído, esse cabeçalho será retornado indicando que reidratar está pendente e também informa a camada de destino.If the blob is being rehydrated and is not complete then this header is returned indicating that rehydrate is pending and also tells the destination tier. Para obter informações detalhadas sobre camadas de nível de blob do bloco de conta de blob padrão , consulte camadas de armazenamento quentes, frias e de arquivo morto.For detailed information about standard blob account block blob level tiering see Hot, cool and archive storage tiers.
x-ms-access-tier-change-time Versão 2017-04-17 ou mais recente.Version 2017-04-17 or newer. Isso dá à última vez que a camada de tempo foi alterada no objeto.This gives the last time tier was changed on the object. Esse cabeçalho será retornado somente se a camada no blob de blocos já tiver sido definida.This header is returned only if tier on block blob was ever set. O formato da data segue RFC 1123.The date format follows RFC 1123. Para obter mais informações, consulte representação de valores de Date-Time nos cabeçalhos.For more information, see Representation of Date-Time Values in Headers. Para obter informações detalhadas sobre camadas de nível de blob do bloco de conta de blob padrão , consulte camadas de armazenamento quentes, frias e de arquivo morto.For detailed information about standard blob account block blob level tiering see Hot, cool and archive storage tiers.
x-ms-client-request-id Esse cabeçalho pode ser usado para solucionar problemas de solicitações e respostas correspondentes.This header can be used to troubleshoot requests and corresponding responses. O valor desse cabeçalho é igual ao valor do x-ms-client-request-id cabeçalho se estiver presente na solicitação e o valor for de no máximo 1024 caracteres ASCII visíveis.The value of this header is equal to the value of the x-ms-client-request-id header if it is present in the request and the value is at most 1024 visible ASCII characters. 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.If the x-ms-client-request-id header is not present in the request, this header will not be present in the response.
x-ms-rehydrate-priority Versão 2019-12-12 ou mais recente.Version 2019-12-12 or newer. Se um objeto estiver no estado reidratar Pending, esse cabeçalho será retornado com a prioridade de reidratar.If an object is in rehydrate pending state then this header is returned with priority of rehydrate. Os valores válidos são High / Standard .Valid values are High/Standard. Para obter informações detalhadas sobre camadas de nível de blob do bloco de conta de blob padrão , consulte camadas de armazenamento quentes, frias e de arquivo morto.For detailed information about standard blob account block blob level tiering see Hot, cool and archive storage tiers.
x-ms-or-{policy-id}_{rule-id} Versão 2019-12-12 ou mais recente, retornada somente para BLOBs de blocos.Version 2019-12-12 or newer, returned only for block blobs. policy-id é um valor de GUID que representa o identificador de uma política de replicação de objeto na conta de armazenamento.policy-id is a guid value representing the identifier of an object replication policy on the storage account. rule-id é um valor de GUID que representa o identificador de uma regra de política no contêiner de BLOB.rule-id is a guid value which represents the identifier of a policy rule on the blob container. Se a conta estiver ObjectReplication habilitada, o valor desse cabeçalho representará o status de replicação do blob com a política e os identificadores de regra fornecidos, complete ou failed .If the account is ObjectReplication enabled, the value of this header represents the replication status of blob with the given policy and rule identifiers, either complete or failed.
x-ms-or-policy-id Versão 2019-12-12 ou mais recente, retornada somente para BLOBs de blocos.Version 2019-12-12 or newer, returned only for block blobs. Se a conta estiver ObjectReplication habilitada, o valor desse cabeçalho representará a política que governa a replicação.If the account is ObjectReplication enabled, the value of this header represents the policy that governs the replication.
x-ms-last-access-time Versão 2020-02-10 ou mais recente.Version 2020-02-10 or newer. Indica a última vez em que os dados do blob foram acessados com base na última política de controle de tempo de acesso da conta de armazenamento.Indicates the last time when the blob's data was accessed based on the storage account's last access time tracking policy. O cabeçalho não será retornado se a conta de armazenamento não tiver uma política de controle de horário da última acesso ou se a política estiver desabilitada.The header will not be returned if the storage account does not have a last access time tracking policy, or the policy is disabled. Para obter informações sobre como definir a última política de controle de tempo de acesso da conta de armazenamento, consulte blob Service API.For information about setting the storage account's last access time tracking policy, see Blob Service API.

Corpo da respostaResponse Body

nenhuma.None.

Exemplo de RespostaSample Response

Response Status:  
HTTP/1.1 200 OK  
  
Response Headers:  
x-ms-meta-Name: myblob.txt  
x-ms-meta-DateUploaded: <date>  
x-ms-blob-type: AppendBlob  
x-ms-lease-status: unlocked  
x-ms-lease-state: available  
Content-Length: 11  
Content-Type: text/plain; charset=UTF-8  
Date: <date>  
ETag: "0x8CAE97120C1FF22"  
Accept-Ranges: bytes  
x-ms-blob-committed–block-count: 1  
x-ms-version: 2015-02-21  
Last-Modified: <date>  
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çãoAuthorization

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.If the container's access control list (ACL) is set to allow anonymous access to the blob, any client may call this operation. 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.If the container is private, this operation can be performed by the account owner and by anyone with a Shared Access Signature that has permission to read the blob.

ComentáriosRemarks

Para determinar se uma operação Copy Blob foi concluída, primeiro verifique se o valor de cabeçalho x-ms-copy-id corresponde à ID da cópia fornecida pela chamada original para Copy Blob.To determine if a Copy Blob operation has completed, first check that the x-ms-copy-id header value matches the copy ID provided by the original call to Copy Blob. Uma correspondência assegura que outro aplicativo não anulou a cópia e iniciou uma nova operação Copy Blob.A match assures that another application did not abort the copy and start a new Copy Blob operation. Então, verifique o cabeçalho x-ms-copy-status: success.Then check for the x-ms-copy-status: success header. 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.However, be aware that all write operations on a blob except Lease, Put Page and Put Block operations remove all x-ms-copy-* properties from the blob. Essas propriedades também não são copiadas por operações Copy Blob que usam versões anteriores a 2012-02-12.These properties are also not copied by Copy Blob operations that use versions before 2012-02-12.

x-ms-copy-status-description contém mais informações sobre a falha Copy Blob.x-ms-copy-status-description contains more information about the Copy Blob failure. A tabela a seguir mostra valores x-ms-copy-status-description e o significado.The following table shows x-ms-copy-status-description values and their meaning.

A tabela a seguir descreve os três campos de cada valor x-ms-copy-status-description.The following table describes the three fields of every x-ms-copy-status-description value.

ComponenteComponent DescriçãoDescription
Código de status HTTPHTTP status code O valor inteiro de três dígitos que especifica a falha.Standard 3-digit integer specifying the failure.
Código do erroError code Palavra-chave que descreve o erro fornecido pelo Azure no elemento <ErrorCode > .Keyword describing error that is provided by Azure in the <ErrorCode> element. Se nenhum elemento <ErrorCode > for exibido, uma palavra-chave contendo o texto de erro padrão associado ao código de status HTTP de 3 dígitos na especificação HTTP será usada.If no <ErrorCode> element appears, a keyword containing standard error text associated with the 3-digit HTTP status code in the HTTP specification is used. Consulte códigos de erro comuns da API REST.See Common REST API Error Codes.
InformaçõesInformation Descrição detalhada da falha, entre aspas.Detailed description of failure, in quotes.

A tabela a seguir descreve os valores x-ms-copy-status e x-ms-copy-status-description de cenários de falha comuns.The following table describes the x-ms-copy-status and x-ms-copy-status-description values of common failure scenarios.

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.Description text shown here can change without warning, even without a version change, so do not rely on matching this exact text.

CenárioScenario Valor x-ms-copy-statusx-ms-copy-status value Valor x-ms-copy-status-descriptionx-ms-copy-status-description value
Operação de cópia concluída com êxito.Copy operation completed successfully. sucessosuccess vazioempty
O usuário anulou a operação de cópia antes da conclusão.User aborted copy operation before it completed. abortedaborted vazioempty
Falha na leitura do blob de origem durante uma operação de cópia, mas a operação será repetida.A failure occurred when reading from the source blob during a copy operation, but the operation will be retried. pendingpending 502 BadGateway "Encontrado um erro reproduzível ao ler a origem.502 BadGateway "Encountered a retryable error when reading the source. Uma nova tentativa será realizada.Will retry. Hora da falha: tempo de <> "Time of failure: <time>"
Falha ao gravar no blob de destino de uma operação de cópia, mas a operação será repetida.A failure occurred when writing to the destination blob of a copy operation, but the operation will be retried. pendingpending 500 InternalServerError "Encontrado um erro reproduzível.500 InternalServerError "Encountered a retryable error. Uma nova tentativa será realizada.Will retry. Hora da falha: tempo de <> "Time of failure: <time>"
Falha irrecuperável durante a leitura do blob de origem de uma operação de cópia.An unrecoverable failure occurred when reading from the source blob of a copy operation. falhoufailed 404 ResourceNotFound "Falha na cópia ao ler a origem.”404 ResourceNotFound "Copy failed when reading the source." Observação: Ao relatar esse erro subjacente, o Azure retorna ResourceNotFound no elemento <ErrorCode > .Note: When reporting this underlying error, Azure returns ResourceNotFound in the <ErrorCode> element. Se nenhum elemento <ErrorCode > apareceu na resposta, uma representação de cadeia de caracteres padrão do status HTTP, como NotFound seria exibido.If no <ErrorCode> element appeared in the response, a standard string representation of the HTTP status such as NotFound would appear.
O tempo limite que limita todas as operações de cópia expirou.The timeout period limiting all copy operations elapsed. (Atualmente, o tempo limite é duas semanas.)(Currently the timeout period is 2 weeks.) falhoufailed 500 OperationCancelled "A cópia excedeu o tempo máximo permitido.”500 OperationCancelled "The copy exceeded the maximum allowed time."
Ocorreram falhas muito frequentes na leitura da origem, e uma proporção mínima de tentativas e êxitos não foi atendida.The copy operation failed too often when reading from the source, and didn’t meet a minimum ratio of attempts to successes. (Esse tempo limite impede tentativas a partir de uma origem muito ruim por duas semanas antes da falha).(This timeout prevents retrying a very poor source over 2 weeks before failing). falhoufailed 500 OperationCancelled "Falha na cópia durante a leitura da origem.”500 OperationCancelled "The copy failed when reading the source."

x-ms-last-access-time controla a hora em que os dados do blob foram acessados com base na última política de controle de tempo de acesso da conta de armazenamento.x-ms-last-access-time tracks the time when the blob's data was accessed based on the storage account's last access time tracking policy. O acesso aos metadados de um BLOB não altera sua última hora de acesso.Accessing a blob's metadata does not change its last access time.

Confira tambémSee also

Autorizar solicitações ao armazenamento do Azure Authorize requests to Azure Storage
Status e códigos de erro Status and Error Codes
Códigos de erro do serviço BlobBlob Service Error Codes