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

Для дополнительной систематизации и классификации объектов можно использовать теги. Теги представляют собой пары “ключ – значение”, которые содержат дополнительную информацию объекте.

Теги могут потребоваться:

если нужно классифицировать объекты по типу данных, проектам, клиентам – например, черновикам документов можно назначить тег docs:drafts;
если нужно установить единые правила жизненного цикла для определенной группы объектов – например, автоматически удалять объекты с тегом server:logs через 7 дней после создания.

Теги можно назначить объекту в любой момент после его загрузки.

Особенности и ограничения

Объекту можно назначить до 10 тегов.
В ключах и значениях тегов можно использовать буквы латинского и русского алфавитов, цифры, пробелы и символы - = . _ : / @.
Длина ключа не может превышать 128 символов, длина значения — 256 символов.

Получить теги

Веб-консоль
AWS CLI
Python
Go

В веб-консоли выберите нужный проект.
В списке сервисов выберите Object Storage.
Нажмите на имя нужного бакета.
Нажмите на значок … для нужного объекта и выберите Управлять тегами.

Если объекту назначены теги, вы увидите их в открывшемся окне.

1
aws s3api get-object-tagging --bucket <имя бакета> --key <ключ объекта>

Приведенный код на Python:

Импортирует библиотеку boto3 — официальный AWS SDK для Python.
Создает сессию с использованием профиля по умолчанию, который хранится в файле ~/.aws/credentials.
Создает клиент для подключения к Object Storage.
Определяет имя бакета и имя объекта, для которого нужно просмотреть список тегов.
Вызывает метод s3.get_object_tagging и получает список тегов, назначенных объекту.
Выводит список тегов.

1
import boto3
2
session = boto3.session.Session(profile_name='default')
3
s3 = session.client(
4
  service_name='s3',
5
  endpoint_url='https://storage.mwsapis.ru/'
6
)
7
bucket='bucket'
8
key ='file.txt'
9
response = s3.get_object_tagging(
10
   Bucket=bucket,
11
   Key=key
12
)
13
print (response)

Приведенный код на Go:

Импортирует необходимые пакеты, в том числе AWS SDK для Go.
Определяет имя бакета и ключ объекта, для которого нужно посмотреть список тегов.
Подгружает конфигурацию из файлов ~/.aws/*.
Создает клиент для доступа к Object Storage.
Получает список тегов, назначенных указанному объекту.
Выводит имя объекта и список назначенных ему тегов.

1
package main
2

3
import (
4
    "context"
5
    "log"
6
    "github.com/aws/aws-sdk-go-v2/aws"
7
    "github.com/aws/aws-sdk-go-v2/config"
8
    "github.com/aws/aws-sdk-go-v2/service/s3"
9
)
10

11
func main() {
12
    // Задаем имя бакета и ключ объекта
13
    bucketName := "bucket"
14
    objectKey := "file.txt"
15

16
    // Подгружаем конфигурацию из ~/.aws/*
17
    cfg, err := config.LoadDefaultConfig(context.TODO())
18
    if err != nil {
19
        log.Fatal(err)
20
    }
21

22
    // Создаем клиент для доступа к ObjectStorage
23
    client := s3.NewFromConfig(cfg)
24

25
    // Выводим список тегов для объекта
26
    result, err := client.GetObjectTagging(context.TODO(), &s3.GetObjectTaggingInput{
27
        Bucket: aws.String(bucketName),
28
        Key:    aws.String(objectKey),
29
    })
30
    if err != nil {
31
        log.Fatal(err)
32
    } else {
33
        log.Printf("Object %s/%s is tagged with:", bucketName, objectKey)
34
        for _, tag := range result.TagSet {
35
            log.Printf("\t%s: %s", *tag.Key, *tag.Value)
36
        }
37
    }
38
}

Добавить теги

Веб-консоль
AWS CLI
Python
Go

В веб-консоли выберите нужный проект.
В списке сервисов выберите Object Storage.
Нажмите на имя нужного бакета.
Нажмите на значок … для нужного объекта и выберите Управлять тегами.
Нажмите Добавить тег.
Введите ключи и значения для новых тегов.
Нажмите кнопку Cохранить.

1
aws s3api put-object-tagging --bucket <имя бакета> --key <ключ объекта> --tagging TagSet='[{Key=key1,Value=value1},{Key=key2,Value=value2}]'

Приведенный код на Python:

Импортирует библиотеку boto3 — официальный AWS SDK для Python.
Создает сессию с использованием профиля по умолчанию, который хранится в файле ~/.aws/credentials.
Создает клиент для подключения к Object Storage.
Определяет имя бакета и ключ объекта, которому нужно назначить теги.
Создает словарь tagging с набором тегов, которые нужно назначить объекту.
Вызывает метод put_object_tagging, назначает объекту теги и сохраняет результат в переменной response.
Выводит значение переменной response, которое представляет собой информацию об успешном или неуспешном выполнении операции добавления тегов.

1
import boto3
2
session = boto3.session.Session(profile_name='default')
3
s3 = session.client(
4
   service_name='s3',
5
   endpoint_url='https://storage.mwsapis.ru/'
6
)
7
#определяем имя бакета и ключ объекта
8
bucket='bucket'
9
key='file.txt'
10
#определем набор тегов
11
tagging={
12
        'TagSet': [
13
            {
14
                'Key': 'Key1',
15
                'Value': 'Value1',
16
            },
17
            {
18
                'Key': 'Key2',
19
                'Value': 'Value2',
20
            },
21
        ],
22
    }
23
    #добавляем теги
24
response = s3.put_object_tagging(
25
    Bucket=bucket,
26
    Key=key,
27
    Tagging=tagging
28
)
29
print (response)

Приведенный код на Go:

Импортирует необходимые пакеты, в том числе AWS SDK для Go.
Определяет имя бакета и ключ объекта, у которого нужно удалить теги.
Подгружает конфигурацию из файлов ~/.aws/*.
Создает клиент для доступа к Object Storage.
Удаляет теги объекта.
Выводит сообщение об успешном удалении тегов.

1
package main
2

3
import (
4
    "context"
5
    "log"
6
    "github.com/aws/aws-sdk-go-v2/aws"
7
    "github.com/aws/aws-sdk-go-v2/config"
8
    "github.com/aws/aws-sdk-go-v2/service/s3"
9
    "github.com/aws/aws-sdk-go-v2/service/s3/types"
10
)
11

12
func main() {
13
    // Определяем имя бакета и ключ объекта
14
    bucketName := "bucket"
15
    objectKey := "file.txt"
16

17
    // Подгружаем конфигурацию из ~/.aws/*
18
    cfg, err := config.LoadDefaultConfig(context.TODO())
19
    if err != nil {
20
        log.Fatal(err)
21
    }
22

23
    // Создаем клиента для доступа к хранилищу S3
24
    client := s3.NewFromConfig(cfg)
25

26
    // Определяем новые теги для добавления
27
    var Tags []types.Tag
28
    Tags = []types.Tag{
29
        {
30
            Key:   aws.String("Key1"),
31
            Value: aws.String("Value1"),
32
        },
33
        {
34
            Key:   aws.String("Key2"),
35
            Value: aws.String("Value2"),
36
        },
37
    }
38

39
    // Добавляем новые теги к объекту
40
    _, err = client.PutObjectTagging(context.TODO(), &s3.PutObjectTaggingInput{
41
        Bucket: aws.String(bucketName),
42
        Key:    aws.String(objectKey),
43
        Tagging: &types.Tagging{
44
            TagSet: Tags,
45
        },
46
    })
47
    if err != nil {
48
        log.Fatal(err)
49
    }
50

51
    log.Printf("New tags added to object %s in bucket %s", objectKey, bucketName)
52
}

Удалить теги

Веб-консоль
AWS CLI
Python
Go

В веб-консоли выберите нужный проект.
В списке сервисов выберите Object Storage.
Нажмите на имя нужного бакета.
Нажмите на значок … для объекта, теги которого нужно удалить, и выберите Управлять тегами.
Нажмите на значок удаления для каждого удаляемого тега.
Нажмите кнопку Сохранить.

1
aws s3api delete-object-tagging --bucket <имя бакета> --key <ключ объекта>

Приведенный код на Python:

Импортирует библиотеку boto3 — официальный AWS SDK для Python.
Создает сессию с использованием профиля по умолчанию, который хранится в файле ~/.aws/credentials.
Создает клиент для подключения к Object Storage.
Определяет имя бакета и имя объекта, у которого нужно удалить теги.
Вызывает метод s3.delete_object_tagging и удаляет список тегов, назначенных объекту. Сохраняет результат в переменной response.
Выводит значение переменной response, которое представляет собой сообщение об успешном или неуспешном удалении тегов.

1
import boto3
2
session = boto3.session.Session(profile_name='default')
3
s3 = session.client(
4
   service_name='s3',
5
   endpoint_url='https://storage.mwsapis.ru/'
6
)
7
#определяем имя бакета и ключ объекта
8
bucket='bucket'
9
key='file.txt'
10
#удаляем теги
11
response = s3.delete_object_tagging(
12
    Bucket=bucket,
13
    Key=key
14
)
15
print (response)

Приведенный код на Go:

Импортирует необходимые пакеты, в том числе AWS SDK для Go.
Определяет имя бакета и ключ объекта, у которого нужно удалить теги.
Подгружает конфигурацию из файлов ~/.aws/*.
Создает клиент для доступа к Object Storage.
Удаляет теги объекта.
Выводит сообщение об успешном удалении тегов.

1
package main
2

3
import (
4
    "log"
5
   "context"
6
    "github.com/aws/aws-sdk-go-v2/aws"
7
    "github.com/aws/aws-sdk-go-v2/config"
8
    "github.com/aws/aws-sdk-go-v2/service/s3"
9
)
10

11
func main() {
12
    // Получаем имя бакета и имя объекта из аргументов командной строки
13
    bucketName := "bucket"
14
    objectKey := "file.txt"
15

16

17
    // Подгружаем конфигурацию из ~/.aws/*
18
    cfg, err := config.LoadDefaultConfig(context.TODO())
19
    if err != nil {
20
        log.Fatal(err)
21
    }
22

23
    // Создаем клиент для доступа к Object Storage
24
    client := s3.NewFromConfig(cfg)
25

26
    // Удаляем теги
27
    _, err = client.DeleteObjectTagging(context.TODO(), &s3.DeleteObjectTaggingInput{
28
        Bucket: aws.String(bucketName),
29
        Key: aws.String(objectKey),
30
    })
31
    if err != nil {
32
        log.Fatal(err)
33
    } else {
34
        log.Printf("Tags for the object %s in the bucket %s have been deleted", objectKey, bucketName)
35
    }
36
}