Obtenha metadados blob

A Get Blob Metadata operação devolve todos os metadados definidos pelo utilizador para a bolha ou instantâneo especificados.

Pedir

O Get Blob Metadata pedido pode ser construído da seguinte forma. HTTPS é recomendado. Substitua a minha conta pelo nome da sua conta de armazenamento:

Pedido de método get ou cabeça URI Versão 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

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:

Pedido de método get ou cabeça URI Versão HTTP
http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob?comp=metadata HTTP/1.1

Para obter mais informações, consulte a Utilização do Armazenamento Emulator Azure para Desenvolvimento e Testes.

Parâmetros URI

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

Parâmetro Descrição
snapshot Opcional. O parâmetro instantâneo é um valor opaco DateTime que, quando presente, especifica o instantâneo blob para recuperar. Para obter mais informações sobre o trabalho com imagens blob, consulte Criar um Instantâneo de uma Bolha
versionid Opcional, versão 2019-12-12 e mais recente. O parâmetro versãoid é um valor opaco DateTime que, quando presente, especifica a versão do blob para recuperar.
timeout Opcional. O timeout parâmetro é expresso em segundos. Para obter mais informações, consulte a definição de intervalos 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-lease-id:<ID> Opcional. Se este cabeçalho for especificado, a Get Blob Metadata operação só será realizada se ambas as seguintes condições forem satisfeitas:

- O arrendamento da blob está ativo.
- A identificação do arrendamento especificada no pedido corresponde à da bolha.

Se ambas as condições não forem satisfeitas, o pedido falhará e a operação falhará com o Get Blob Metadata código de estado 412 (Pré-condição Falhada).
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 Análise de Armazenamento registo de registos e registos Azure: Utilizar registos para rastrear pedidos de Armazenamento.

Esta operação também suporta a utilização de cabeçalhos condicional para obter a operação de metadados da bolha apenas se uma condição especificada for satisfeita. Para obter mais informações, consulte especificar cabeçalhos condicional para operações de serviço de bolhas.

Pedido cabeçalhos (chaves de encriptação fornecidas pelo cliente)

Começando pela versão 2019-02-02, os seguintes cabeçalhos podem ser especificados no pedido de leitura de uma bolha encriptada com uma chave fornecida pelo cliente. A encriptação com uma chave fornecida pelo cliente (e o conjunto correspondente de cabeçalhos) é opcional. Se uma bolha tiver sido encriptada previamente com uma chave fornecida pelo cliente, então estes cabeçalhos devem ser incluídos no pedido para completar a operação de leitura com sucesso.

Cabeçalho do pedido Description
x-ms-encryption-key Obrigatório. A chave de encriptação AES-256 codificada pela Base64.
x-ms-encryption-key-sha256 Opcional. O hash SHA256 codificado pela Base64 da chave de encriptação.
x-ms-encryption-algorithm: AES256 Obrigatório. Especifica o algoritmo a utilizar para encriptação. O valor deste cabeçalho deve ser AES256.

Corpo do Pedido

Nenhum.

Resposta

A resposta inclui um código de estado HTTP e um conjunto de cabeçalhos de resposta.

Código de Estado

Uma operação bem sucedida devolve o código de estado 200 (OK).

Para obter informações sobre códigos de estado, consulte códigos de estado e de erro.

Cabeçalhos de Resposta

A resposta para esta operação inclui os seguintes cabeçalhos. A resposta também pode incluir cabeçalhos HTTP padrão adicionais. Todos os cabeçalhos standard estão de acordo com a especificação do protocolo HTTP/1.1.

Cabeçalho de resposta Descrição
x-ms-meta-name:value Devolve um valor de metadados para o recipiente.
Last-Modified A data/hora em que a bolha foi modificada pela última vez. O formato de data segue o RFC 1123. Para mais informações, consulte Representação de Valores Date-Time em Cabeçalhos.

Qualquer operação que modifie a bolha, incluindo uma atualização dos metadados ou propriedades da bolha, altera o último tempo modificado da bolha.
ETag O ETag para a bolha. Se a versão de pedido for 2011-08-18 ou mais recente, o valor ETag estará em aspas.
x-ms-request-id Este cabeçalho identifica exclusivamente o pedido que foi feito e pode ser usado para resolver problemas no pedido. Para mais informações, consulte operações de resolução de problemas da API.
x-ms-version Indica a versão do serviço Blob utilizado para executar o pedido. Este cabeçalho é devolvido para pedidos feitos contra a versão 2009-09-19 e mais tarde.

Este cabeçalho também é devolvido para pedidos anónimos sem uma versão especificada se o recipiente foi marcado para acesso público 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

Nenhum.

Autorização

Esta operação pode ser realizada pelo proprietário da conta ou por qualquer pessoa que utilize uma Assinatura de Acesso Partilhado que tenha permissão para ler a bolha. Se a ACL do contentor estiver definida para permitir o acesso anónimo, qualquer cliente pode ligar para esta operação.

Observações

Nenhum.

Ver também

Autorizar pedidos à Azure Armazenamento
Códigos de Estado e erro
Códigos de Erro do Serviço de Blobs