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

  • Статья

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

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

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

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

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

Blob-объекты также поддерживают теги , специальный тип пользовательских метаданных, которые автоматически индексируются службой BLOB-объектов. Дополнительные сведения см. в статье Управление и поиск данных в Хранилище BLOB-объектов Azure с помощью индекса BLOB-объектов.

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

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

x-ms-meta-name:string-value

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

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

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

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

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

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

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

Извлечение свойств и метаданных

Обе операции, GET и HEAD, получают заголовки метаданных для указанного контейнера или большого двоичного объекта. Операция 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

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

Контейнеры и 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

См. также:

Create Container (Создание контейнера)
Получение свойств контейнера
Настройка метаданных контейнера
Put BLOB (Вставка BLOB-объекта)
Копирование BLOB-объекта
Получение свойств большого двоичного объекта
Get BLOB Metadata (Получение метаданных BLOB-объекта)
Set BLOB Metadata (Задание метаданных BLOB-объекта)
Основные понятия службы BLOB-объектов
Управление данными в хранилище BLOB-объектов Azure и их поиск с помощью индекса больших двоичных объектов