Definir e obter propriedades e metadados para recursos do serviço Blob

  • Artigo

Os contentores e blobs suportam metadados personalizados, representados como cabeçalhos HTTP. Os cabeçalhos de metadados podem ser definidos num pedido que cria um novo recurso de contentor ou blob ou num pedido que cria explicitamente uma propriedade num recurso existente.

Este tópico contém os seguintes subtópicos:

Formato de Cabeçalho de Metadados

Operações em Metadados

Propriedades HTTP Padrão para Contentores e Blobs

Os blobs também suportam etiquetas, um tipo especial de metadados personalizados que é indexado automaticamente pelo serviço Blob. Para obter mais informações, veja Gerir e localizar dados em Armazenamento de Blobs do Azure com o Índice de Blobs.

Formato de Cabeçalho de Metadados

Os cabeçalhos de metadados são pares 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 têm de cumprir as regras de nomenclatura dos identificadores C#.

Os nomes não são sensíveis a maiúsculas e minúsculas. Tenha em atenção que os nomes de metadados preservam o caso com o qual foram criados, mas não são sensíveis a maiúsculas e minúsculas quando definidos ou lidos. Se forem submetidos dois ou mais cabeçalhos de metadados com o mesmo nome para um recurso, o serviço Blob devolve o código de estado 400 (Pedido Incorreto).

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

Os pares de nomes/valores de metadados são cabeçalhos HTTP válidos e, por isso, cumprem todas as restrições que regem os cabeçalhos HTTP.

Operações em Metadados

Os metadados num recurso de blob ou contentor podem ser obtidos ou definidos diretamente, sem devolver ou alterar o conteúdo do recurso.

Tenha em atenção que os valores de metadados só podem ser lidos ou escritos na totalidade; as atualizações parciais não são suportadas. A definição de metadados num recurso substitui quaisquer valores de metadados existentes para esse recurso.

Obter Propriedades e Metadados

As operações GET e HEAD obtêm cabeçalhos de metadados para o contentor ou blob especificado. A operação HEAD devolve apenas cabeçalhos; não devolve um corpo de resposta.

A sintaxe do URI para obter cabeçalhos de metadados num contentor é a seguinte:

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

A sintaxe do URI para obter cabeçalhos de metadados num blob é a seguinte:

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

Definir Cabeçalhos de Metadados

A operação PUT define cabeçalhos de metadados no contentor ou blob especificado, substituindo os metadados existentes no recurso. Chamar PUT sem cabeçalhos no pedido limpa todos os metadados existentes no recurso.

A sintaxe do URI para definir cabeçalhos de metadados num contentor é a seguinte:

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

A sintaxe do URI para definir cabeçalhos de metadados num blob é a seguinte:

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

Propriedades HTTP Padrão para Contentores e Blobs

Os contentores e blobs também suportam determinadas propriedades HTTP padrão. As propriedades e metadados são representados como cabeçalhos HTTP padrão; a diferença entre os mesmos está na nomenclatura dos cabeçalhos. Os cabeçalhos de metadados são nomeados com o prefixo de cabeçalho x-ms-meta- e um nome personalizado. Os cabeçalhos de propriedade utilizam nomes de cabeçalho HTTP padrão, conforme especificado na secção Definições do Campo de Cabeçalho 14 da especificação do protocolo HTTP/1.1.

Os cabeçalhos HTTP padrão suportados em contentores incluem:

  • ETag

  • Last-Modified

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

  • ETag

  • Last-Modified

  • Content-Length

  • Content-Type

  • Content-MD5

  • Content-Encoding

  • Content-Language

  • Cache-Control

  • Origin

  • Range

Consulte também

Criar Contentor
Obter Propriedades do Contentor
Definir Metadados de Contentor
Colocar o Blob
Copiar Blob
Get Blob Properties (Obter Propriedades do Blob)
Obter Metadados de Blobs
Definir Metadados de Blobs
Conceitos do Serviço blob
Gerir e localizar dados no Armazenamento de Blobs do Azure com o Índice de Blobs