Поделиться через

Set BLOB Properties (Задание свойств службы BLOB-объекта)

  • Статья

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

Запрос

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

URI запроса метода PUT параметр "Версия HTTP"
https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=properties HTTP/1.1

Имитированный URI службы хранилища

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

URI запроса метода PUT параметр "Версия HTTP"
http://127.0.0.1:10000/ devstoreaccount1/mycontainer/myblob?comp=properties HTTP/1.1

Дополнительные сведения см. в статье Использование эмулятора Azurite для разработки и тестирования службы хранилища Azure.

Параметры универсального кода ресурса (URI)

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

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

Заголовки запросов (все типы BLOB-объектов)

В следующей таблице описаны обязательные и необязательные заголовки запросов для всех типов BLOB-объектов.

Заголовок запроса Описание
Authorization Обязательный. Указывает схему авторизации, имя учетной записи и подпись. Дополнительные сведения см. в статье Авторизация запросов к Службе хранилища Azure.
Date или x-ms-date Обязательный. Задает время запроса в формате UTC. Дополнительные сведения см. в статье Авторизация запросов к Службе хранилища Azure.
x-ms-version Требуется для всех авторизованных запросов. Задает версию операции, используемой для этого запроса. Дополнительные сведения см. в разделе Управление версиями для служб хранилища Azure.
x-ms-blob-cache-control Необязательный элемент. Изменяет строку управления кэшем для большого двоичного объекта.

Если это свойство не указано в запросе, свойство очищается для большого двоичного объекта. Последующие вызовы Get Blob Properties не возвращают это свойство, если оно не будет явно задано для большого двоичного объекта снова.
x-ms-blob-content-type Необязательный элемент. Задает тип содержимого большого двоичного объекта.

Если это свойство не указано в запросе, свойство очищается для большого двоичного объекта. Последующие вызовы Get Blob Properties не возвращают это свойство, если оно не будет явно задано для большого двоичного объекта снова.
x-ms-blob-content-md5 Необязательный элемент. Задает хэш MD5 большого двоичного объекта.

Если это свойство не указано в запросе, свойство очищается для большого двоичного объекта. Последующие вызовы Get Blob Properties не возвращают это свойство, если оно не будет явно задано для большого двоичного объекта снова.
x-ms-blob-content-encoding Необязательный элемент. Задает кодировку содержимого большого двоичного объекта.

Если это свойство не указано в запросе, свойство очищается для большого двоичного объекта. Последующие вызовы Get Blob Properties не возвращают это свойство, если оно не будет явно задано для большого двоичного объекта снова.
x-ms-blob-content-language Необязательный элемент. Задает язык содержимого большого двоичного объекта.

Если это свойство не указано в запросе, свойство очищается для большого двоичного объекта. Последующие вызовы Get Blob Properties не возвращают это свойство, если оно не будет явно задано для большого двоичного объекта снова.
x-ms-lease-id:<ID> Требуется, если у большого двоичного объекта имеется активная аренда. Для выполнения этой операции в большом двоичном объекте с активной арендой укажите допустимый идентификатор аренды для этого заголовка.
x-ms-client-request-id Необязательный элемент. Предоставляет созданное клиентом непрозрачное значение с ограничением в 1 кибибайт (КиБ), которое записывается в журналы при настройке ведения журнала. Мы настоятельно рекомендуем использовать этот заголовок для сопоставления действий на стороне клиента с запросами, получаемыми сервером. Дополнительные сведения см. в разделе Мониторинг Хранилище BLOB-объектов Azure.
x-ms-blob-content-disposition Необязательный элемент. Задает заголовок Content-Disposition большого двоичного объекта. Доступно для версии 15.08.2013 и более поздних версий.

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

Ответ от операций Get Blob и Get Blob Properties содержит content-disposition заголовок .
Origin Необязательный элемент. Указывает источник, от которого выдан запрос. Наличие этого заголовка приводит к присутствию в ответе заголовков совместного использования ресурсов. Дополнительные сведения см. в статье Поддержка CORS (общий доступ к ресурсам между источниками) для служб хранилища Azure.

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

Заголовки запросов (только страничные BLOB-объекты)

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

Заголовок запроса Описание
x-ms-blob-content-length: byte value Необязательный элемент. Изменяет размер большого двоичного объекта на указанный. Если указанное значение меньше текущего размера большого двоичного объекта, удаляются все страничные BLOB-объекты со значениями, превышающими указанное значение.

Это свойство нельзя использовать для изменения размера блочного или добавочного BLOB-объекта. Задание этого свойства для блочного или добавочного BLOB-объекта возвращает код состояния 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 Содержит значение, которое можно использовать для условного выполнения операций. Дополнительные сведения см. в разделе Указание условных заголовков для операций с хранилищем 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-client-request-id Может использоваться для устранения неполадок с запросами и соответствующими ответами. Значение этого заголовка равно значению заголовка x-ms-client-request-id , если он присутствует в запросе и содержит не более 1024 видимых символов ASCII. Если заголовок x-ms-client-request-id отсутствует в запросе, он не будет присутствовать в ответе.

Текст ответа

Нет.

Авторизация

При вызове любой операции доступа к данным в службе хранилища Azure требуется авторизация. Вы можете авторизовать Set Blob Properties операцию, как описано ниже.

Важно!

Корпорация Майкрософт рекомендует использовать Microsoft Entra ID с управляемыми удостоверениями для авторизации запросов к службе хранилища Azure. Microsoft Entra ID обеспечивает более высокий уровень безопасности и простоту использования по сравнению с авторизацией с общим ключом.

Служба хранилища Azure поддерживает использование Microsoft Entra ID для авторизации запросов к данным BLOB-объектов. С помощью Microsoft Entra ID можно использовать управление доступом на основе ролей Azure (Azure RBAC) для предоставления разрешений субъекту безопасности. Субъект безопасности может быть пользователем, группой, субъектом-службой приложения или управляемым удостоверением Azure. Субъект безопасности проходит проверку подлинности с помощью Microsoft Entra ID для возврата маркера OAuth 2.0. Затем маркер можно использовать для авторизации запроса к службе BLOB-объектов.

Дополнительные сведения об авторизации с помощью Microsoft Entra ID см. в статье Авторизация доступа к BLOB-объектам с помощью Microsoft Entra ID.

Разрешения

Ниже перечислены действия RBAC, необходимые Microsoft Entra пользователю, группе, управляемому удостоверению или субъекту-службе для вызова Set Blob Properties операции, а также встроенная роль Azure RBAC с наименьшими привилегиями, которая включает это действие:

Дополнительные сведения о назначении ролей с помощью Azure RBAC см. в статье Назначение роли Azure для доступа к данным BLOB-объектов.

Комментарии

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

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

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

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

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

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

  • Если запрос задает только 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-адреса (SAS) можно переопределить определенные свойства, хранящиеся для большого двоичного объекта, указав параметры запроса в составе подписанного URL-адреса. В число этих свойств входят свойства cache-control, content-type, content-encoding, content-language и content-disposition. Дополнительные сведения см. в статье Create SAS службы.

Выставление счетов

Запросы на ценообразование могут исходить от клиентов, использующих API хранилища BLOB-объектов, напрямую через REST API хранилища BLOB-объектов или из клиентской библиотеки службы хранилища Azure. Эти запросы начисляют плату за каждую транзакцию. Тип транзакции влияет на способ оплаты учетной записи. Например, транзакции чтения начисляются на категорию выставления счетов, отличную от категории операций записи. В следующей таблице показана категория выставления счетов для Set Blob Properties запросов на основе типа учетной записи хранения.

Операция Тип учетной записи хранения Категория выставления счетов
Set BLOB Properties (Задание свойств службы BLOB-объекта) Блочный BLOB-объект (ценовая категории "Премиум")
Общего назначения версии 2 (цен. категория "Стандартный")		 Другие операции
Set BLOB Properties (Задание свойств службы BLOB-объекта) Стандартная общего назначения версии 1 Операции записи

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

См. также раздел