Настройка тегов BLOB-объектов

Операция Set Blob Tags задает пользовательские теги для указанного большого двоичного объекта в виде одной или нескольких пар "ключ-значение".

Просьба

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

URI запроса метода PUT ВЕРСИЯ HTTP
https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=tags

https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=tags&versionid=<DateTime>

https://account.blob.core.windows.net/container/blob?comp=tags&snapshot=<DateTime>		 HTTP/1.1

Параметры URI

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

Параметр Описание
snapshot Необязательно для версии 2020-08-04 и более поздних версий. Параметр моментального снимка является непрозрачным значением DateTime, которое при наличии указывает моментальный снимок БОЛЬШОго двоичного объекта для задания тегов. Дополнительные сведения о работе с моментальными снимками BLOB-объектов см. в создании моментального снимка большого двоичного объекта.
versionid Необязательно для версии 2019-12-12 и более поздних версий. Параметр versionid — это непрозрачное DateTime значение, указывающее версию извлекаемого большого двоичного объекта.
timeout Необязательный. Параметр timeout выражается в секундах. Дополнительные сведения см. в разделе Настройка времени ожидания для операций хранилища BLOB-объектов.

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

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

Заголовок запроса Описание
Authorization Обязательно. Указывает схему авторизации, имя учетной записи и подпись. Дополнительные сведения см. в статье Авторизация запросов к службе хранилища Azure.
Date или x-ms-date Обязательно. Указывает универсальное время (UTC) для запроса. Дополнительные сведения см. в статье Авторизация запросов к службе хранилища Azure.
x-ms-version Требуется для всех авторизованных запросов. Указывает версию операции, используемой для этого запроса. Дополнительные сведения см. в разделе Управление версиями служб хранилища Azure.
Content-Length Обязательно. Длина содержимого запроса в байтах. Этот заголовок ссылается на длину содержимого документа тегов, а не самого большого двоичного объекта.
Content-Type Обязательно. Значение этого заголовка должно быть application/xml; charset=UTF-8.
Content-MD5 Необязательный. Хэш MD5 содержимого запроса. Этот хэш используется для проверки целостности содержимого запроса во время транспорта. Если два хэша не соответствуют, операция завершается ошибкой с кодом 400 (недопустимый запрос).

Этот заголовок связан с содержимым запроса, а не с содержимым самого большого двоичного объекта.
x-ms-content-crc64 Необязательный. Хэш CRC64 содержимого запроса. Этот хэш используется для проверки целостности содержимого запроса во время транспорта. Если два хэша не соответствуют, операция завершается ошибкой с кодом 400 (недопустимый запрос).

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

Если присутствуют оба заголовка Content-MD5 и x-ms-content-crc64, запрос завершается ошибкой с кодом 400 (недопустимый запрос).
x-ms-lease-id:<ID> Требуется, если большой двоичный объект имеет активную аренду.

Чтобы выполнить эту операцию в большом двоичном объекте с активной арендой, укажите допустимый идентификатор аренды для этого заголовка. Если допустимый идентификатор аренды не указан в запросе, операция завершается ошибкой с кодом состояния 403 (запрещено).
x-ms-client-request-id Необязательный. Предоставляет созданное клиентом непрозрачное значение с ограничением символов 1-kibibyte (KiB), записанным в журналах при настройке ведения журнала. Настоятельно рекомендуется использовать этот заголовок для сопоставления действий на стороне клиента с запросами, получаемыми сервером. Дополнительные сведения см. в статье Monitorхранилища BLOB-объектов Azure.

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

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

Формат текста запроса выглядит следующим образом:

<?xml version="1.0" encoding="utf-8"?>  
<Tags>  
    <TagSet>  
        <Tag>  
            <Key>tag-name-1</Key>  
            <Value>tag-value-1</Value>  
        </Tag>  
        <Tag>  
            <Key>tag-name-2</Key>  
            <Value>tag-value-2</Value>  
        </Tag>  
    </TagSet>  
</Tags>

Текст запроса должен быть хорошо сформированным XML-документом UTF-8 и содержать набор тегов, представляющий теги для большого двоичного объекта.

Набор тегов может содержать не более 10 тегов. Ключи и значения тегов чувствительны к регистру. Ключи тегов должны быть от 1 до 128 символов, а значения тегов должны составлять от 0 до 256 символов. Допустимые символы тегов и символов значений:

  • Строчные и прописные буквы (a-z, A-Z)
  • Цифры (0-9)
  • Пробел ()
  • Плюс (+), минус (-), период (.), косая черта (/), двоеточие (:), равно (=) и подчеркивание (_)

Ответ

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

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

Успешная операция возвращает код состояния 204 (нет содержимого).

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

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

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

Заголовок ответа Описание
x-ms-request-id Уникально идентифицирует выполненный запрос и может использоваться для устранения неполадок запроса. Дополнительные сведения см. в статье Устранение неполадок с операциями API.
x-ms-version Версия хранилища BLOB-объектов, используемая для выполнения запроса.
Date Значение даты и времени в формате UTC, созданное службой, указывающее время, когда был инициирован ответ.
x-ms-client-request-id Можно использовать для устранения неполадок запросов и соответствующих ответов. Значение этого заголовка равно значению заголовка x-ms-client-request-id, если оно присутствует в запросе, а значение содержит не более 1024 видимых символов ASCII. Если в запросе отсутствует заголовок x-ms-client-request-id, он не будет присутствовать в ответе.

Текст ответа

Никакой.

Авторизация

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

Важный

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

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

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

Разрешения

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

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

Замечания

Операция Set Blob Tags поддерживается в REST API версии 2019-12-12 и более поздних версиях.

Для аккаунтов с включённым иерархическим пространством имён эта Set Blob Tags операция поддерживается для версии 2024-11-04 x-ms-и и более поздней.

Примечание: Blob-теги для аккаунтов, поддерживающих иерархическое пространство имён, находятся в публичном предпросмотре и доступны через Microsoft.Storage/BlobIndexForHns флаг AFEC. Дополнительные сведения см. в статье "Настройка предварительных версий функций в подписке Azure".

Операция Set Blob Tags перезаписывает все существующие теги в большом двоичном объекте. Чтобы удалить все теги из большого двоичного объекта, отправьте запрос Set Blob Tags с пустым <TagSet>.

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

Служба хранилища обеспечивает надежную согласованность между большим двоичным объектом и его тегами. Изменения тегов BLOB-объектов сразу же отображаются при последующих операциях Get Blob Tags в большом двоичном объекте. Однако вторичный индекс в конечном итоге согласован. Изменения тегов большого двоичного объекта могут не сразу отображаться для операций Find Blobs by Tags.

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

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

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

Операция Тип учетной записи хранения Категория выставления счетов
Настройка тегов BLOB-объектов Большой двоичный объект класса Premium
Стандартный общего назначения версии 2		 Другие операции
Настройка тегов BLOB-объектов Стандартный общего назначения версии 1 Операции записи

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

См. также

Управление и поиск данных хранилища BLOB-объектов с помощью тегов индекса BLOB-объектов
Авторизация запросов в службу хранилища Azure
коды состояния и ошибок
коды ошибок хранилища BLOB-объектов

  • Last updated on