Установка и получение свойств и метаданных для ресурсов больших двоичных объектов
Данная статья переведена автоматически. Наведите указатель мыши на предложения статьи, чтобы просмотреть исходный текст. Дополнительные сведения.
Перевод
Текст оригинала

Установка и получение свойств и метаданных для ресурсов BLOB-объектов

 

Контейнеры и большие двоичные объекты поддерживают пользовательские метаданные, представленные в виде заголовков HTTP. Заголовки метаданных можно задать в запросе, создающем новый ресурс контейнера или большого двоичного объекта, или в запросе, явно создающем свойство для существующего ресурса.

Эта тема описана в следующих подразделах:

Формат заголовка метаданных

Операции на метаданных

Стандартные свойства HTTP для контейнеров и BLOB-объектов

Заголовки метаданных представлены парами «имя-значение». Формат заголовка выглядит так:

x-ms-meta-name:string-value

Начиная с версии 2009-09-19, имена метаданных должны соответствовать правилам именования для идентификаторов C#.

В именах не учитывается регистр. Обратите внимание, что имена метаданных сохраняют регистр, с которым они были созданы, однако при задании и чтении регистр не учитывается. Если в ресурс отправляются два или более заголовка метаданных с одним именем, то служба BLOB-объектов возвращает код состояния 400 (неправильный запрос).

Общий размер метаданных, включая имя и значение вместе взятые, не может превышать 8 КБ.

Пары «имя-значение» метаданных являются допустимыми заголовками HTTP, поэтому должны соответствовать всем ограничениям, относящихся к заголовкам HTTP.

Метаданные ресурса BLOB-объектов или контейнера можно извлекать или задавать напрямую, без возврата или изменения содержимого ресурса.

Обратите внимание, что значения метаданных можно читать или записывать только полностью; частичные обновления также не поддерживаются. Помещение метаданных в ресурс перезаписывает все существующие значения метаданных для этого ресурса.

Обе операции, GET и HEAD, получают заголовки метаданных для указанного контейнера или большого двоичного объекта. Эти операции возвращают только заголовки и не возвращают текст ответа.

Синтаксис URI для получения заголовков метаданных в контейнере выглядит следующим образом:

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

Синтаксис URI для получения заголовков метаданных в BLOB-объекте выглядит следующим образом:

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

Операция PUT задает заголовки метаданных в указанном контейнере или BLOB-объекте, перезаписывая все существующие метаданные ресурса. При вызове PUT без заголовков в запросе будут очищены все существующие метаданные ресурса.

Синтаксис URI для задания заголовков метаданных в контейнере выглядит следующим образом:

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

Синтаксис URI для задания заголовков метаданных в BLOB-объекте выглядит следующим образом:

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

Контейнеры и BLOB-объекты поддерживают также некоторые стандартные свойства HTTP. Свойства и метаданные представлены как стандартные заголовки HTTP; различие между ними — в именовании заголовков. Заголовки метаданных именуются с префиксом заголовка x-ms-meta- и пользовательское имя. Заголовки свойства используют стандартные заголовки HTTP, как указано в разделе определения полей заголовков 14 спецификации протокола HTTP/1.1.

Стандартные заголовки HTTP, поддерживаемые для контейнеров, включают:

  • ETag

  • Last-Modified

Стандартные заголовки HTTP, поддерживаемые для BLOB-объектов, включают:

  • ETag

  • Last-Modified

  • Content-Length

  • Content-Type

  • Content-MD5

  • Content-Encoding

  • Content-Language

  • Cache-Control

  • Origin

  • Range

Показ:
© 2016 Microsoft