Получение тегов BLOB

Операция Get Blob Tags возвращает все пользовательские теги для указанного blob, версии или снимка.

запрос

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

URI запроса метода GET	Версия HTTP
`https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=tags` `https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=tags&snapshot=<DateTime>` `https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=tags&versionid=<DateTime>`	HTTP/1.1

Параметры URI

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

Параметр	Описание
`snapshot`	Необязательно. Параметр snapshot — это непрозрачное `DateTime` значение, которое, если оно присутствует, указывает моментальный снимок BLOB-объекта, который необходимо получить. Дополнительные сведения о работе с моментальными снимками BLOB-объектов см. в статье Создание моментального снимка BLOB-объекта.
`versionid`	Опционально для версий 2019-12-12 и более поздних. Параметр `versionid` — это непрозрачное `DateTime` значение, которое, когда оно присутствует, указывает версию blob-а, которую нужно извлечь.
`timeout`	Необязательно. Параметр `timeout` выражается в секундах. Для получения дополнительной информации см. раздел «Установка тайм-аутов для операций с Blob Storage».

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

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

Заголовок запроса	Описание
`Authorization`	Обязательно. Указывает схему авторизации, имя учетной записи и подпись. Дополнительные сведения см. в статье Авторизация запросов к службе хранилища Azure.
`Date` или `x-ms-date`	Обязательно. Указывает универсальное время (UTC) для запроса. Дополнительные сведения см. в статье Авторизация запросов к службе хранилища Azure.
`x-ms-version`	Требуется для всех авторизованных запросов. Необязательно для анонимных запросов. Указывает версию операции, используемой для этого запроса. Дополнительные сведения см. в разделе Управление версиями служб хранилища Azure.
`x-ms-lease-id:<ID>`	Требуется, если большой двоичный объект имеет действующую аренду. Чтобы выполнить эту операцию с большим двоичным объектом с активной арендой, укажите допустимый идентификатор аренды для этого заголовка. Если в запросе не указан действительный идентификатор аренды, операция заканчивается с кодом статуса 403 (Запрещено).
`x-ms-client-request-id`	Необязательно. Предоставляет созданное клиентом непрозрачное значение с ограничением символов 1-kibibyte (KiB), записанным в журналах при настройке ведения журнала. Настоятельно рекомендуется использовать этот заголовок для сопоставления действий на стороне клиента с запросами, получаемыми сервером. Дополнительные сведения см. в статье Monitorхранилища BLOB-объектов Azure.

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

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

Нет.

Ответ

Ответ включает HTTP-код статуса, заголовки ответов и тело ответа.

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

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

Сведения о кодах состояния см. в коды состояния и коды ошибок.

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

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

Заголовок ответа	Описание
`Content-Type`	`application/xml`
`Content-Length`	Размер возвращаемого XML-документа в байтах
`x-ms-request-id`	Уникально идентифицирует выполненный запрос, и его можно использовать для устранения неполадок запроса. Дополнительные сведения см. в статье Устранение неполадок с операциями API.
`x-ms-version`	Указывает версию хранилища BLOB-объектов, которая используется для выполнения запроса.
`Date`	Значение даты и времени в формате UTC, созданное службой, указывающее время, когда был инициирован ответ.
`x-ms-client-request-id`	Можно использовать для устранения неполадок запросов и их соответствующих ответов. Значение этого заголовка равно значению `x-ms-client-request-id` заголовка, если он присутствует в запросе, и значения не превышает 1 024 видимых ASCII-символов. Если в запросе отсутствует заголовок `x-ms-client-request-id`, этот заголовок отсутствует в ответе.

Основная часть ответа

Вот формат тела ответа:

<?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, представляющий все теги, хранящиеся на блобе.

Authorization

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

Это важно

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

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

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

Разрешения

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

Действие Azure RBAC:Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/read
встроенная роль с минимальными привилегиями:владельца данных BLOB-объектов хранилища

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

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

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

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

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

Делегирование пользователей с помощью SAS

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

Вызов Get Blob Tags операции с использованием токена SAS, делегированного ресурсу blob, требует разрешения на Tags (t ) в рамках токена SAS delegation пользователя.

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

Служба SAS

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

Вызов Get Blob Tags операции с использованием токена SAS, делегированного ресурсу blob, требует разрешения Tags (t ) как части токена сервиса SAS.

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

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

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

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

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

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

Замечания

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

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

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

Порядок тегов не гарантирован в ответе.

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

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

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

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

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

См. также

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

Last updated on 2026-03-27