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

С помощью тегов можно систематизировать и классифицировать бакеты. Теги имеют формат “ключ — значение”.

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

если в бакетах хранятся данные разных подразделений организации — например, documents:hr;
если бакеты используются для хранения конфиденциальных данных — например, access:restricted;
если в бакетах хранятся данные для тестового и продуктивного окружений — например, environment:prod.

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

Бакету можно назначить теги как при создании, так и в любой момент после создания.

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

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

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

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

В веб-консоли выберите нужный проект.
В списке сервисов выберите Object Storage.
Нажмите на имя нужного бакета и перейдите на вкладку Конфигурация.

Если у бакета есть теги, они будут отображены на вкладке.

1
aws s3api get-bucket-tagging --bucket <имя бакета>

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

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

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
response = s3.get_bucket_tagging(
8
    Bucket='bucket'
9
)
10
print (response)

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

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

1
package main
2

3
import (
4
    "context"
5
    "flag"
6
    "fmt"
7
    "log"
8

9
    "github.com/aws/aws-sdk-go-v2/aws"
10
    "github.com/aws/aws-sdk-go-v2/config"
11
    "github.com/aws/aws-sdk-go-v2/service/s3"
12
)
13

14
func main() {
15
    // Получаем имя бакета из аргумента командной строки
16
    bucketName := flag.String("b", "", "The name of the bucket")
17
    flag.Parse()
18

19
    if *bucketName == "" {
20
        fmt.Println("You must supply the name of a bucket (-b BUCKET)")
21
        return
22
    }
23

24
    // Подгружаем конфигурацию из ~/.aws/*
25
    cfg, err := config.LoadDefaultConfig(context.TODO())
26
    if err != nil {
27
        log.Fatal(err)
28
    }
29

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

33
  // Выводим список тегов
34
result, err := client.GetBucketTagging(context.TODO(), &s3.GetBucketTaggingInput{
35
    Bucket: aws.String(*bucketName),
36
})
37
if err != nil {
38
    log.Fatal(err)
39
} else {
40
        log.Printf("Bucket %s is tagged with:", *bucketName)
41
for _, tag := range result.TagSet {
42
    log.Printf("\t%s: %s", *tag.Key, *tag.Value)
43
  }
44
 }
45
}

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

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

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

1
aws s3api put-bucket-tagging --bucket <имя бакета> --tagging TagSet='[{Key=key1,Value=valuе1},{Key=key2,Value=value2}]'

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

Импортирует библиотеку boto3 — официальный AWS SDK для Python.
Создает сессию с использованием профиля по умолчанию, который хранится в файле ~/.aws/credentials .
Создает клиент для подключения к Object Storage.
Вызывает метод put_bucket_tagging, чтобы назначить теги указанному бакету. Bucket='bucket' указывает имя бакета, к которому применяются теги. Tagging={'TagSet': [...]} содержит список словарей, где каждый словарь представляет отдельный тег. Каждый тег состоит из ключа ('Key') и значения ('Value').
Сохраняет ответ от вызова метода put_bucket_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
response = s3.put_bucket_tagging(
8
   Bucket='bucket',
9
  Tagging={
10
       'TagSet': [
11
           {
12
               'Key': 'Key1',
13
               'Value': 'Value1',
14
           },
15
           {
16
               'Key': 'Key2',
17
               'Value': 'Value2',
18
           },
19
       ],
20
   },
21
)
22
print (response)

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

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

1
package main
2

3
import (
4
    "context"
5
    "flag"
6
    "fmt"
7
    "log"
8

9
    "github.com/aws/aws-sdk-go-v2/aws"
10
    "github.com/aws/aws-sdk-go-v2/config"
11
    "github.com/aws/aws-sdk-go-v2/service/s3"
12
    "github.com/aws/aws-sdk-go-v2/service/s3/types"
13
)
14

15
func main() {
16
    // Получаем имя бакета из аргумента командной строки
17
    bucketName := flag.String("b", "", "The name of the bucket")
18
    flag.Parse()
19

20
    if *bucketName == "" {
21
        fmt.Println("You must supply the name of a bucket (-b BUCKET)")
22
        return
23
    }
24

25
    // Подгружаем конфигурацию из ~/.aws/*
26
    cfg, err := config.LoadDefaultConfig(context.TODO())
27
    if err != nil {
28
        log.Fatal(err)
29
    }
30

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

34
    // Определяем новые теги для добавления
35
    Tags := []types.Tag{
36
        {
37
            Key:   aws.String("Key1"),
38
            Value: aws.String("Value1"),
39
        },
40
        {
41
            Key:   aws.String("Key2"),
42
            Value: aws.String("Value2"),
43
        },
44
    }
45

46
    // Добавляем новые теги
47
    _, err = client.PutBucketTagging(context.TODO(), &s3.PutBucketTaggingInput{
48
        Bucket: aws.String(*bucketName),
49
        Tagging: &types.Tagging{
50
            TagSet: Tags,
51
        },
52
    })
53
    if err != nil {
54
        log.Fatal(err)
55
    }
56

57
    log.Printf("New tags added to bucket %s", *bucketName)
58
}

Удалить теги

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

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

1
aws s3api delete-bucket-tagging --bucket <имя_бакета>

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

Импортирует библиотеку boto3 — официальный AWS SDK для Python.
Создает сессию с использованием профиля по умолчанию, который хранится в файле ~/.aws/credentials.
Создает клиент с использованием для подключения к Object Storage.
Вызывает метод delete_bucket_tagging, которые удаляет теги указанного бакета.
Сохраняет ответ от вызова метода delete_bucket_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
response = s3.delete_bucket_tagging(
8
    Bucket='bucket'
9
)
10
print (response)

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

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

1
package main
2

3
import (
4
    "context"
5
    "flag"
6
    "fmt"
7
    "log"
8

9
    "github.com/aws/aws-sdk-go-v2/aws"
10
    "github.com/aws/aws-sdk-go-v2/config"
11
    "github.com/aws/aws-sdk-go-v2/service/s3"
12
)
13

14
func main() {
15
    // Получаем имя бакета из аргумента командной строки
16
    bucketName := flag.String("b", "", "The name of the bucket")
17
    flag.Parse()
18

19
    if *bucketName == "" {
20
        fmt.Println("You must supply the name of a bucket (-b BUCKET)")
21
        return
22
    }
23

24
    // Подгружаем конфигурацию из ~/.aws/*
25
    cfg, err := config.LoadDefaultConfig(context.TODO())
26
    if err != nil {
27
        log.Fatal(err)
28
    }
29

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

33
    // Удаляем теги
34
    _, err = client.DeleteBucketTagging(context.TODO(), &s3.DeleteBucketTaggingInput{
35
        Bucket: aws.String(*bucketName),
36
    })
37
    if err != nil {
38
        log.Fatal(err)
39
    } else {
40
        log.Printf("Tags for the bucket %s have been deleted:", *bucketName)
41
    }
42
}