Управление метками объекта

Статья создана

Обновлена 4 октября 2024 г.

Добавить или изменить метки
Посмотреть метки
Удалить метки

Метки объектов — это пары ключ-значение для логической маркировки объектов.

Примечание

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

Добавить или изменить метки

AWS CLI

Terraform

API

Если у вас еще нет интерфейса командной строки AWS CLI, установите и сконфигурируйте его.

В терминале выполните команду, которая перезаписывает все имеющиеся у объекта метки:

aws s3api put-object-tagging \
  --bucket <имя_бакета> \
  --key <ключ_объекта> \
  --tagging 'TagSet=[{Key=<ключ_метки>,Value=<значение_метки>},{Key=<ключ_метки>,Value=<значение_метки>}]' \
  --endpoint-url=https://storage.yandexcloud.net

Где:

--bucket — имя бакета.
--key — ключ объекта в бакете.
--tagging — массив меток объекта, где:
- Key — ключ метки, тип: string.
- Value — значение метки, тип: string.
--endpoint-url — эндпоинт Object Storage.

Примечание

Terraform взаимодействует с Object Storage от имени сервисного аккаунта. Назначьте сервисному аккаунту нужную роль, например storage.admin, на каталог, в котором будут создаваться ресурсы.

Если у вас еще нет Terraform, установите его и настройте провайдер Yandex Cloud.

Откройте файл конфигурации Terraform и добавьте блок tags во фрагмент с описанием объекта:

resource "yandex_storage_object" "test-object" {
  access_key       = "<идентификатор_статического_ключа>"
  secret_key       = "<секретный_ключ>"
  bucket           = "<имя_бакета>"
  key              = "<имя_объекта>"
  source           = "<путь_к_файлу>"
  tags             = {
    <ключ_метки_1> = "<значение_метки_1>"
    <ключ_метки_2> = "<значение_метки_2>"
  }
}

Где tags — массив меток объекта в формате <ключ> = "<значение>".

Более подробную информацию о параметрах ресурса yandex_storage_object в Terraform, см. в документации провайдера.

Примените изменения:
1. В терминале перейдите в папку, где вы отредактировали конфигурационный файл.
2. Проверьте корректность конфигурационного файла с помощью команды:
```
terraform validate
```
  Если конфигурация является корректной, появится сообщение:
```
Success! The configuration is valid.
```
3. Выполните команду:
```
terraform plan
```
  В терминале будет выведен список ресурсов с параметрами. На этом этапе изменения не будут внесены. Если в конфигурации есть ошибки, Terraform на них укажет.
4. Примените изменения конфигурации:
```
terraform apply
```
5. Подтвердите изменения: введите в терминале слово yes и нажмите Enter.

После этого к объекту будут добавлены метки. Проверить появление меток и настройки объекта можно с помощью AWS CLI или S3 API.

Чтобы добавить или изменить метки объекта, воспользуйтесь методом S3 API putObjectTagging.

Посмотреть метки

AWS CLI

API

Если у вас еще нет интерфейса командной строки AWS CLI, установите и сконфигурируйте его.

В терминале выполните команду:

aws s3api get-object-tagging \
  --bucket <имя_бакета> \
  --key <ключ_объекта> \
  --endpoint-url=https://storage.yandexcloud.net

Где:

--bucket — имя бакета.
--key — ключ объекта в бакете.
--endpoint-url — эндпоинт Object Storage.

Результат:

{
    "TagSet": [
        {
            "Key": "test-key-1",
            "Value": "test-value-1"
        },
        {
            "Key": "test-key-2",
            "Value": "test-value-2"
        }
    ]
}

Чтобы посмотреть метки объекта, воспользуйтесь методом S3 API getObjectTagging.

Удалить метки

AWS CLI

Terraform

API

Если у вас еще нет интерфейса командной строки AWS CLI, установите и сконфигурируйте его.

В терминале выполните команду:

aws s3api delete-object-tagging \
  --bucket <имя_бакета> \
  --key <ключ_объекта> \
  --endpoint-url=https://storage.yandexcloud.net

Где:

--bucket — имя бакета.
--key — ключ объекта в бакете.
--endpoint-url — эндпоинт Object Storage.

Если у вас еще нет Terraform, установите его и настройте провайдер Yandex Cloud.

Откройте файл конфигураций Terraform и удалите блок tags из фрагмента с описанием объекта.
Пример описания тегов объекта в конфигурации Terraform
```
 resource "yandex_storage_object" "test-object" {
   ...
   tags             = {
     <ключ_метки_1> = "<значение_метки_1>"
     <ключ_метки_2> = "<значение_метки_2>"
   }
 }
...
```
Примените изменения:
1. В терминале перейдите в папку, где вы отредактировали конфигурационный файл.
2. Проверьте корректность конфигурационного файла с помощью команды:
```
terraform validate
```
  Если конфигурация является корректной, появится сообщение:
```
Success! The configuration is valid.
```
3. Выполните команду:
```
terraform plan
```
  В терминале будет выведен список ресурсов с параметрами. На этом этапе изменения не будут внесены. Если в конфигурации есть ошибки, Terraform на них укажет.
4. Примените изменения конфигурации:
```
terraform apply
```
5. Подтвердите изменения: введите в терминале слово yes и нажмите Enter.

После этого у объекта будут удалены метки. Проверить удаление меток и настройки объекта можно с помощью AWS CLI или S3 API.

Чтобы удалить метки объекта, воспользуйтесь методом S3 API deleteObjectTagging.

Управление метками объекта

Добавить или изменить меткиДобавить или изменить метки

Посмотреть меткиПосмотреть метки

Удалить меткиУдалить метки

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

Добавить или изменить метки

Посмотреть метки

Удалить метки