Compartilhar via


Configuração e recuperação de propriedades e metadados para recursos do serviço Blob

Contêineres e blobs dão suporte a metadados personalizados, representados como cabeçalhos HTTP. Os cabeçalhos de metadados podem ser definidos em uma solicitação que cria um novo contêiner ou recurso de blob, ou em uma solicitação que cria explicitamente uma propriedade em um recurso existente.

Este tópico inclui os seguintes subtópicos:

Formato de cabeçalho de metadados

Operações em metadados

Propriedades HTTP padrão para contêineres e blobs

Os blobs também dão suporte a marcas, um tipo especial de metadados personalizados que é indexado automaticamente pelo serviço Blob. Para obter mais informações, consulte Gerenciar e localizar dados em Armazenamento de Blobs do Azure com o Índice de Blobs.

Formato de cabeçalho de metadados

Cabeçalhos de metadados são pares de nome/valor. O formato do cabeçalho é:

x-ms-meta-name:string-value  

A partir da versão 2009-09-19, os nomes de metadados devem seguir as regras de nomenclatura para identificadores C#.

Os nomes não diferenciam maiúsculas de minúsculas. Observe que os nomes de metadados preservam a forma com a qual foram criados, mas não diferenciam maiúsculas de minúsculas quando definidos ou lidos. Se dois ou mais cabeçalhos de metadados com o mesmo nome forem enviados para um recurso, o serviço Blob retornará o código de status 400 (Solicitação Incorreta).

Os metadados consistem em pares nome-valor. O tamanho total de todos os pares de metadados pode ser de até 8 KB.

Os pares de nome/valor de metadados são cabeçalhos HTTP válidos, portanto, seguem todas as restrições que regem cabeçalhos HTTP.

Operações em metadados

Os metadados em um recurso de blob ou contêiner podem ser recuperados ou definidos diretamente, sem retornar nem alterar o conteúdo do recurso.

Observe que os valores de metadados somente podem ser lidos ou gravados completamente; não há suporte para atualizações parciais. A definição de metadados em um recurso substitui todos os valores de metadados existentes para esse recurso.

Recuperando propriedades e metadados

As operações GET e de HEAD recuperam cabeçalhos de metadados para o contêiner ou o blob especificado. A operação HEAD retorna apenas cabeçalhos; ela não retorna um corpo de resposta.

A sintaxe de URI para recuperar cabeçalhos de metadados em um contêiner é a seguinte:

GET/HEAD https://myaccount.blob.core.windows.net/mycontainer?restype=container  

A sintaxe de URI para recuperar cabeçalhos de metadados em um blob é a seguinte:

GET/HEAD https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=metadata  

Definindo cabeçalhos de metadados

A operação PUT define cabeçalhos de metadados no contêiner ou no blob especificado, substituindo alguns metadados existentes no recurso. Se você chamar PUT sem nenhum cabeçalho na solicitação, todos os metadados existentes no recurso serão limpos.

A sintaxe de URI para definir cabeçalhos de metadados em um contêiner é a seguinte:

PUT https://myaccount.blob.core.windows.net/mycontainer?comp=metadata?restype=container  

A sintaxe de URI para definir cabeçalhos de metadados em um blob é a seguinte:

PUT https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=metadata  

Propriedades HTTP padrão para contêineres e blobs

Os contêineres e os blobs também dão suporte a certas propriedades HTTP padrão. As propriedades e os metadados são representados como cabeçalhos HTTP padrão; a diferença entre eles consiste na denominação dos cabeçalhos. Os cabeçalhos de metadados são denominados com o prefixo x-ms-meta- de cabeçalho e um nome personalizado. Os cabeçalhos de propriedade usam nomes de cabeçalho HTTP padrão, conforme especificado na seção Definições de Campo de Cabeçalho 14 da especificação do protocolo HTTP/1.1.

Os cabeçalhos HTTP padrão com suporte em contêineres incluem:

  • ETag

  • Last-Modified

Os cabeçalhos HTTP padrão com suporte em blobs incluem:

  • ETag

  • Last-Modified

  • Content-Length

  • Content-Type

  • Content-MD5

  • Content-Encoding

  • Content-Language

  • Cache-Control

  • Origin

  • Range

Consulte Também

Create Container
Obter Propriedades de Contêiner
Definir Metadados de Contêiner
Put Blob
Copiar blob
Obter propriedades do blob
Get Blob Metadata
Set Blob Metadata
Conceitos do Serviço blob
Gerenciar e localizar dados no Armazenamento de Blobs do Azure com o Índice de Blobs