Была ли эта страница полезной?
Ваш отзыв об этом контенте важен для нас. Расскажите нам о том, что вы думаете.
Дополнительный отзыв?
1500 символов осталось
Экспорт (0) Печать
Развернуть все

Задание свойств больших двоичных объектов

Обновлено: Апрель 2015 г.

Операция Set Blob Properties задает системные свойства для большого двоичного объекта.

Запрос Set Blob Properties можно составить следующим образом. Рекомендуется использовать протокол HTTPS. Замените myaccount именем нужной учетной записи хранения.

 

  URI запроса метода PUT Версия HTTP

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

HTTP/1.1

При построении запроса к эмулированной службе хранилища укажите имя узла эмулятора и порт службы BLOB-объектов как 127.0.0.1:10000, затем укажите имя эмулированной учетной записи хранилища.

 

  URI запроса метода PUT Версия HTTP

http://127.0.0.1:10000/ devstoreaccount1/mycontainer/myblob?comp=properties

HTTP/1.1

Дополнительные сведения см. в Using the Azure Storage Emulator for Development and Testing.

В URI запроса могут быть заданы следующие дополнительные параметры.

 

Параметр Описание

timeout

Необязательно. Параметр timeout указывается в секундах. Дополнительные сведения см. в Задание времени ожидания для операций службы BLOB-объектов.

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

 

Заголовок запроса Описание

Authorization

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

Date или x-ms-date

Обязательно. Задает время в формате UTC для запроса. Дополнительные сведения см. в Проверка подлинности для служб хранения Azure.

x-ms-version

Требуется для запросов с проверкой подлинности. Задает версию операции, используемой для этого запроса. Дополнительные сведения см. в Управление версиями для служб хранилища Azure.

x-ms-blob-cache-control

Необязательно. Изменяет строку управления кэшем для большого двоичного объекта.

Если это свойство не задано в запросе, то это свойство большого двоичного объекта будет очищено. Последующие вызовы Получение свойств больших двоичных объектов не будут возвращать это свойство, если оно не будет повторно явно задано для большого двоичного объекта.

x-ms-blob-content-type

Необязательно. Задает тип содержимого большого двоичного объекта.

Если это свойство не задано в запросе, то это свойство большого двоичного объекта будет очищено. Последующие вызовы Получение свойств больших двоичных объектов не будут возвращать это свойство, если оно не будет повторно явно задано для большого двоичного объекта.

x-ms-blob-content-md5

Необязательно. Задает хэш MD5 большого двоичного объекта.

Если это свойство не задано в запросе, то это свойство большого двоичного объекта будет очищено. Последующие вызовы Получение свойств больших двоичных объектов не будут возвращать это свойство, если оно не будет повторно явно задано для большого двоичного объекта.

x-ms-blob-content-encoding

Необязательно. Задает кодировку содержимого большого двоичного объекта.

Если это свойство не задано в запросе, то это свойство большого двоичного объекта будет очищено. Последующие вызовы Получение свойств больших двоичных объектов не будут возвращать это свойство, если оно не будет повторно явно задано для большого двоичного объекта.

x-ms-blob-content-language

Необязательно. Задает язык содержимого большого двоичного объекта.

Если это свойство не задано в запросе, то это свойство большого двоичного объекта будет очищено. Последующие вызовы Получение свойств больших двоичных объектов не будут возвращать это свойство, если оно не будет повторно явно задано для большого двоичного объекта.

x-ms-lease-id:<ID>

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

x-ms-client-request-id

Необязательно. Предоставляет сформированное клиентом непрозрачное значение с ограничением в 1 КБ, которое записывается в журналы аналитики, когда включено ведение журналов аналитики хранилища. Этот заголовок настоятельно рекомендуется использовать для соотнесения действий, выполняемых на стороне клиента, с запросами, получаемыми сервером. Дополнительные сведения см. в разделах Сведения о ведении журнала службы аналитики хранилища и Ведение журналов в Azure: использование журналов для отслеживания запросов к хранилищу.

x-ms-blob-content-disposition

Необязательно. Задает заголовок Content-Disposition большого двоичного объекта. Доступно в версии 2013-08-15 и выше.

Поле заголовка ответа Content-Disposition предоставляет дополнительные сведения о том, как обрабатывать полезные данные ответа, а также может использоваться для присоединения дополнительных метаданных. Например, если ему задано значение attachment, то это значит, что агент пользователя не покажет ответ, а выведет на экран диалоговое окно Сохранить как с именем файла, отличным от имени указанного большого двоичного объекта.

Ответ от операций Получение большого двоичного объекта и Получение свойств больших двоичных объектов содержит заголовок content-disposition.

Origin

Необязательно. Указывает источник, от которого выдан запрос. Наличие этого заголовка приводит к присутствию в ответе заголовков совместного использования ресурсов. Более подробные сведения см. в разделе Поддержка общего доступа к ресурсам независимо от источника (CORS) для служб хранилища Azure.

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

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

 

Заголовок запроса Описание

x-ms-blob-content-length: byte value

Необязательно. Изменяет размер большого двоичного объекта на указанный. Если указанное значение меньше текущего размера большого двоичного объекта, то все страницы за пределами указанного размера очищаются.

Это свойство нельзя использовать для изменения размера блочного большого двоичного объекта. При установке этого свойства для блочного большого двоичного объекта возвращается код состояния 400 (неверный запрос).

x-ms-sequence-number-action: {max, update, increment}

Необязательный параметр, но требуется в случае задания заголовка x-ms-blob-sequence-number для запроса. Это свойство применяется только к страничным большим двоичным объектам.

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

  • max: устанавливает более высокий порядковый номер, чем приведенное в запросе и в данный момент хранимое в большом двоичном объекте значение.

  • update: устанавливает порядковый номер равным включенному в запрос значению.

  • increment: увеличивает значение порядкового номера на 1. При указании этого параметра не используйте x-ms-blob-sequence-number header, в противном случае будет возвращен код состояния 400 (неверный запрос).

x-ms-blob-sequence-number: <num>

Не обязателен, но требуется, если свойство x-ms-sequence-number-action установлено в значение max или update. Это свойство применяется только к страничным большим двоичным объектам.

Это свойство задает порядковый номер большого двоичного объекта. Порядковый номер является подконтрольным пользователю свойством, с помощью которого можно отслеживать запросы и решать вопросы параллелизма. Дополнительные сведения см. в описании операции Вставка страницы.

Используйте это свойство совместно с x-ms-sequence-number-action для обновления порядкового номера большого двоичного объекта либо на указанное значение, либо на наибольшее из двух значений (значение, указанное в запросе, и значение, в настоящий момент хранящееся в большом двоичном объекте). Этот заголовок не следует указывать, если для свойства x-ms-sequence-number-action задано значение increment. В этом случае служба автоматически увеличивает порядковый номер на единицу.

Чтобы задать произвольный порядковый номер, необходимо задать это свойство в запросе совместно с x-ms-sequence-number-action.

Отсутствует.

Ответ включает код состояния HTTP и набор заголовков ответа.

Успешная операция возвращает код состояния 200 (ОК).

Сведения о кодах состояния см. в разделе Коды состояний и ошибок.

Ответ для этой операции включает следующие заголовки. Ответ может также включать дополнительные стандартные заголовки HTTP. Все стандартные заголовки соответствуют спецификации протокола HTTP/1.1.

 

Синтаксис Описание

ETag

ETag содержит значение, которое позволяет выполнять операции условно. Дополнительные сведения см. в разделе Указание условных заголовков для операций службы BLOB-объектов. Если версия запроса 2011-08-18 или более поздняя, то значение ETag будет указано в кавычках.

Last-Modified

Дата и время последнего изменения BLOB-объекта. Дата в формате согласно RFC 1123. Дополнительные сведения см. в разделе Представление значений даты и времени в заголовках.

Любая операция записи в большой двоичный объект (включая обновления метаданных и свойств) меняет время последнего изменения большого двоичного объекта.

x-ms-blob-sequence-number

Если большой двоичный объект является страничным, то в этом заголовке возвращается текущий порядковый номер большого двоичного объекта.

x-ms-request-id

Этот заголовок однозначно определяет выполненный запрос, его также можно использовать для устранения связанных с запросом неполадок. Дополнительные сведения см. в Устранение неполадок при API-операциях.

x-ms-version

Указывает версию службы BLOB-объектов, используемую для выполнения запроса. Этот заголовок возвращается для запросов к версии 2009-09-19 и более поздним версиям.

Date

Значение даты и времени в формате UTC, сформированное службой и указывающее время, когда был инициирован ответ.

Access-Control-Allow-Origin

Возвращается, если запрос содержит заголовок Origin и включен CORS с совпадающим правилом. В случае совпадения этот заголовок возвращает значение заголовка источника запроса.

Access-Control-Expose-Headers

Возвращается, если запрос содержит заголовок Origin и включен CORS с совпадающим правилом. Возвращает список заголовков ответа, которые должны быть предоставлены клиенту или отправителю запроса.

Access-Control-Allow-Credentials

Возвращается, если запрос содержит заголовок Origin и включен CORS с совпадающим правилом, которое не допускает использования всех источников. Этот заголовок будет установлен в значение true.

Отсутствует.

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

Семантика обновления свойств большого двоичного объекта следующая.

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

    • Запрос задает для свойства x-ms-sequence-number-action значение max или update, а также задает значение заголовка x-ms-blob-sequence-number.

    • Запрос задает для свойства x-ms-sequence-number-action значение increment, указывающее, что служба должна увеличить порядковый номер на единицу.

  • Размер страничного большого двоичного объекта изменяется, только если в запросе задано значение заголовка x-ms-content-length.

  • Если запрос устанавливает только значение свойства x-ms-blob-sequence-number или x-ms-content-length, но не других свойств, то ни одно из прочих свойств большого двоичного объекта не изменяется.

  • Если в запросе задано одно или несколько следующих свойств, то все эти свойства задаются совместно. В случае, если для отдельных свойств не задано значение, когда задано значение хотя бы одного из перечисленных далее свойств, такое свойство большого двоичного объекта очищается.

    • x-ms-blob-cache-control

    • x-ms-blob-content-type

    • x-ms-blob-content-md5

    • x-ms-blob-content-encoding

    • x-ms-blob-content-language

    • x-ms-blob-content-disposition

Обратите внимание, что для подписанного URL-адреса можно переопределять некоторые свойства, которые хранятся для больших двоичных объектов, путем указания параметров запроса как части подписанного URL-адреса. В число этих свойств входят свойства cache-control, content-type, content-encoding, content-language и content-disposition. Дополнительные сведения см. в Создание URI подписанного URL-адреса.

Показ:
© 2015 Microsoft