Get Blob Metadata

A operação Get Blob Metadata retorna todos os metadados definidos pelo usuário para o blob ou o instantâneo especificado.

Solicitação

A solicitação Get Blob Metadata 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 ou HEAD Versão de HTTP
https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=metadata

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

https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=metadata&versionid=<DateTime>
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 ou HEAD Versão de HTTP
http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob?comp=metadata HTTP/1.1

Para obter mais informações, consulte Usando o Azure Armazenamento Emulator 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 que, quando presente, especifica a Versão do blob a DateTime ser recuperada.
timeout Opcional. O parâmetro timeout é expresso em segundos. Para obter mais informações, consulte Setting Timeouts for Blob Service Operations.

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 obter mais informações, consulte Autorizar solicitações para o Azure Armazenamento.
Date ou x-ms-date Obrigatórios. Especifica o UTC (Tempo Universal Coordenado) para a solicitação. Para obter mais informações, consulte Autorizar solicitações para o Azure Armazenamento.
x-ms-version Necessá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. Para obter mais informações, consulte Versioning for the Azure Armazenamento Services.
x-ms-lease-id:<ID> Opcional. Se esse cabeçalho for especificado, a operação Get Blob Metadata 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 nenhuma dessas condições for atendida, a solicitação não será feita e ocorrerá uma falha na operação Get Blob Metadata com o código de status 412 (Falha na Pré-condição).
x-ms-client-request-id Opcional. Fornece um valor opaco gerado pelo cliente com um limite de 1 caractere 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 o log Armazenamento Analytics e Log do Azure: usando logspara rastrear Armazenamento solicitações .

Essa operação também dará suporte ao uso de cabeçalhos condicionais para obter a operação de metadados de 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.

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

A partir da versão 2019-02-02, os seguintes headers 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 headers) é opcional. Se um blob tiver sido criptografado anteriormente com uma chave fornecida pelo cliente, esses headers 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 e um conjunto de cabeçalhos de resposta.

Código de status

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

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 de protocolo HTTP/1.1.

Cabeçalho de resposta Descrição
x-ms-meta-name:value Retorna um valor de metadados para o contêiner.
Last-Modified A data e a hora da última modificação feita no blob. O formato da data segue RFC 1123. Para obter mais informações, consulte Representação de Date-Time valores em 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.
ETag A ETag do blob. Se a versão da solicitação for a 2011-08-18 ou mais recente, o valor de ETag será exibido entre aspas.
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. Esse cabeçalho é retornado para solicitações feitas na 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.
Date Um valor de data/hora UTC gerado pelo serviço que indica a hora em que a resposta foi iniciada.
x-ms-client-request-id Esse header pode ser usado para solucionar problemas de solicitações e respostas correspondentes. O valor desse header será igual ao valor do header se ele estiver presente na solicitação e o valor for, no máximo, x-ms-client-request-id 1024 caracteres ASCII visíveis. Se o x-ms-client-request-id header não estiver presente na solicitação, esse header não estará presente na resposta.

Corpo da resposta

Nenhum.

Autorização

Essa operação poderá ser executada pelo proprietário da conta ou por qualquer pessoa que estiver usando uma assinatura de acesso compartilhado que tenha permissão para ler o blob. Se a ACL do contêiner estiver definido para permitir acesso anônimo, qualquer cliente poderá chamar essa operação.

Comentários

Nenhum.

Confira também

Autorizar solicitações para o Azure Armazenamento
Status e códigos de erro
Códigos de erro do serviço Blob