Yandex Cloud
КейсыДокументация
ПрезентацияСвязаться с намиНачать бесплатно
Создавайте контент и получайте гранты!Готовы написать своё руководство? Участвуйте в контент-программе и получайте гранты на работу с облачными сервисами!
Подробнее о программе
Сделано на Gravity UI
Проект Яндекса
© 2026 ООО «Яндекс.Облако»
Yandex Object Storage
  • Правила тарификации
  • Справочник Terraform
    • Аутентификация в API
      • Как пользоваться API
      • Подписывание запросов
      • Начало работы с S3 API
        • Все сервисы и методы
          • Все методы
          • PutObject
          • GetObject
          • patch
          • CopyObject
          • HeadObject
          • DeleteObject
          • DeleteObjects
          • options
          • SelectObjectContent
          • RestoreObject
          • PutObjectRetention
          • PutObjectLegalHold
          • GetObjectRetention
          • GetObjectLegalHold
          • PutObjectTagging
          • GetObjectTagging
          • DeleteObjectTagging
        • Общие заголовки запросов
        • Общие заголовки ответов
        • Ответы
  • Метрики Monitoring
  • Аудитные логи Audit Trails
  • Логи бакета
  • История изменений
  • Вопросы и ответы
  • Обучающие курсы

В этой статье:

  • Запрос
  • Path-параметры
  • Query-параметры
  • Заголовки
  • Ответ
  • Заголовки
  • Коды ответов
  • Схема данных
  1. Справочник API
  2. AWS S3 REST
  3. REST
  4. Object
  5. GetObjectTagging

Object Storage API, REST совместимый с Amazon S3: GetObjectTagging

Статья создана
Yandex Cloud
Обновлена 18 июня 2026 г.
Открыть в Markdown
  • Запрос
    • Path-параметры
    • Query-параметры
    • Заголовки
  • Ответ
    • Заголовки
    • Коды ответов
    • Схема данных

Возвращает метки объекта в бакете.

Примечание

В терминологии Yandex Cloud для логической маркировки ресурсов используется понятие метка (label). Object Storage поддерживает совместимость с Amazon S3 API, поэтому в командах для AWS CLI и в параметрах API применяется термин AWS — тег (tag).

Подробнее о подготовке к работе с API и общем виде запроса в разделе Как пользоваться S3 API.

ЗапросЗапрос

GET /{bucket}/{key}?tagging&versionId={versionId} HTTP/2

Path-параметрыPath-параметры

Параметр Описание
bucket Имя бакета.
key Ключ объекта.

Query-параметрыQuery-параметры

Параметр Описание
tagging Тип операции. Обязательный параметр.
versionId Идентификатор версии объекта. Обязательный параметр.

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

Используйте в запросе общие заголовки.

ОтветОтвет

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

Кроме общих заголовков, ответ может содержать:

Заголовок Описание
x-amz-version-id Идентификатор версии объекта.

Коды ответовКоды ответов

Перечень возможных ответов смотрите в разделе Ответы.

Успешный ответ содержит дополнительные данные в формате XML.

Схема данныхСхема данных

<?xml version="1.0" encoding="UTF-8" ?>
<Tagging xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
   <TagSet>
      <Tag>
         <Key>string</Key>
         <Value>string</Value>
      </Tag>
   </TagSet>
</Tagging>
Элемент Описание
Tagging Корневой элемент.
TagSet Массив меток.
Tag Контейнер для метки.
Key Ключ метки.
Тип: string.
Value Значение метки.
Тип: string.

Связанные статьиСвязанные статьи

  • Объект

  • Управлять метками объекта

Полезные ссылкиПолезные ссылки

  • Начало работы с AWS S3 API в Yandex Object Storage

  • Отладка запросов с помощью утилиты AWS CLI

  • Пример отправки подписанного запроса с помощью утилиты curl

  • Пример кода для генерации подписи

Была ли статья полезна?

Предыдущая
PutObjectTagging
Следующая
DeleteObjectTagging
Создавайте контент и получайте гранты!Готовы написать своё руководство? Участвуйте в контент-программе и получайте гранты на работу с облачными сервисами!
Подробнее о программе
Сделано на Gravity UI
Проект Яндекса
© 2026 ООО «Яндекс.Облако»