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

Статья
02/03/2024

Операция 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` большого двоичного объекта. Доступно для версии 2013-08-15 и более поздних версий. Поле `Content-Disposition` заголовка ответа содержит дополнительные сведения о том, как обрабатывать полезные данные ответа, и его можно использовать для вложения дополнительных метаданных. Например, если задано значение `attachment`, это означает, что агент пользователя не должен отображать ответ, а отображать диалоговое окно "Сохранить как" с именем файла, отличного от указанного имени BLOB-объекта. Ответ от операций Получить BLOB-объект и Получить свойства BLOB-объекта включает заголовок `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`. Это свойство применяется только к страничным большим двоичным объектам. Свойство задает порядковый номер большого двоичного объекта. Порядковый номер является подконтрольным пользователю свойством, с помощью которого можно отслеживать запросы и решать вопросы параллелизма. Дополнительные сведения см. в разделе Операция Put Page . Используйте это свойство вместе с , `x-ms-sequence-number-action` чтобы обновить порядковый номер большого двоичного объекта до указанного или более высокого из значений, указанных в запросе или хранящихся в данный момент в большом двоичном объекте. Этот заголовок не следует указывать, если `x-ms-sequence-number-action` для задано значение `increment`, в этом случае служба автоматически увеличивает порядковый номер на единицу. Чтобы задать произвольный порядковый номер, необходимо задать это свойство в запросе совместно с `x-ms-sequence-number-action`.

Текст запроса

Нет.

Ответ

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

Код состояния

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

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

Заголовки ответов

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

Синтаксис	Описание
`ETag`	Содержит значение, которое можно использовать для условного выполнения операций. Дополнительные сведения см . в статье Указание условных заголовков для операций с хранилищем BLOB-объектов . Если версия запроса — 18.08.2011 или более поздняя, значение 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 как описано ниже.

Служба хранилища 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:Microsoft.Storage/storageAccounts/blobServices/containers/blobs/write
Встроенная роль с минимальными привилегиями:Участник данных BLOB-объектов хранилища

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

Подписанный URL-адрес (SAS) обеспечивает безопасный делегированный доступ к ресурсам в учетной записи хранения. С помощью SAS вы можете детально контролировать доступ клиента к данным. Вы можете указать, к какому ресурсу может обращаться клиент, какие у него есть разрешения для этих ресурсов и как долго будет действителен SAS.

Операция Set Blob Properties поддерживает три типа подписанных URL-адресов: SAS делегирования пользователей, SAS службы и SAS учетной записи.

В целях обеспечения безопасности рекомендуется использовать Microsoft Entra учетные данные, а не ключ учетной записи хранения, который проще скомпрометировать. Если для проектирования приложения требуются подписанные URL-адреса, по возможности используйте учетные данные Microsoft Entra, чтобы создать SAS для делегирования пользователей.

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

SAS для делегирования пользователей

SAS для делегирования пользователей защищен Microsoft Entra учетными данными, а также разрешениями, указанными для SAS.

Set Blob Properties Для вызова операции с использованием маркера SAS, делегированного контейнеру или ресурсу BLOB-объекта, требуется разрешение на запись (w) в составе маркера SAS делегирования пользователей.

Дополнительные сведения о SAS для делегирования пользователей см. в статье Создание SAS для делегирования пользователей.

SAS для службы

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

Дополнительные сведения о SAS службы см. в статье Создание SAS службы.

SAS для учетной записи

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

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

Операция	Подписанная служба	Подписанный тип ресурса	Подписанное разрешение
Set BLOB Properties (Задание свойств службы BLOB-объекта)	Большой двоичный объект (b)	Объект (o)	Запись (w)

Дополнительные сведения о SAS учетной записи см. в статье Создание SAS учетной записи.

Операция Set Blob Properties поддерживает авторизацию с общим ключом. Авторизация с помощью ключей учетной записи не рекомендуется в большинстве сценариев, так как она менее безопасна.

Корпорация Майкрософт рекомендует запретить авторизацию с общим ключом для учетной записи хранения, когда это возможно. Дополнительные сведения см. в статье Предотвращение авторизации с помощью общего ключа.

Порядковый номер страничного большого двоичного объекта обновляется только в случае, если запрос соответствует одному из следующих условий.
- Запрос задает 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. Дополнительные сведения см. в статье Создание SAS службы.

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

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

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

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