Управление метками
Вы можете добавить, удалить или изменить метку ресурса с помощью консоли управления, командной строки Yandex Cloud и Terraform.
Метки поддерживаются в определенных сервисах. Управление метками в некоторых сервисах может отличаться, например в Object Storage.
Добавить метку
В примере ниже показано добавление метки к виртуальной машине Compute Cloud. Аналогично вы можете добавить метку другому ресурсу.
- В консоли управления
выберите каталог, в котором находится ВМ. - В списке сервисов выберите Compute Cloud.
- На панели слева выберите
Виртуальные машины. - В списке ВМ выберите нужную.
- Нажмите
и выберите Редактировать. - В поле Метки нажмите Добавить метку.
- Введите ключ и значение и нажмите Enter.
Если у вас еще нет интерфейса командной строки Yandex Cloud, установите и инициализируйте его.
По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name
или --folder-id
.
Чтобы добавить или обновить существующую метку ресурса сервиса, воспользуйтесь командой:
yc <имя_сервиса> <тип_ресурса> add-labels <имя_или_идентификатор_ресурса> \
--labels <имя_метки>=<значение_метки>
Пример
Добавить метку виртуальной машине:
yc compute instance add-labels cl123g4dridnn5cn****-**** --labels project=test
Результат:
done (5s) id: fhm1pr2bu3p4******** folder_id: b1g23ga45mev******** created_at: "2020-08-07T11:29:18Z" name: cl123g4dridnn5cn****-**** labels: project: test zone_id: ru-central1-a ...
Если у вас еще нет Terraform, установите его и настройте провайдер Yandex Cloud.
-
Добавьте к ресурсу в конфигурационном файле следующий фрагмент:
labels = { <ключ_метки> = "<значение_метки>" }
-
Примените изменения:
-
В терминале перейдите в папку, где вы отредактировали конфигурационный файл.
-
Проверьте корректность конфигурационного файла с помощью команды:
terraform validate
Если конфигурация является корректной, появится сообщение:
Success! The configuration is valid.
-
Выполните команду:
terraform plan
В терминале будет выведен список ресурсов с параметрами. На этом этапе изменения не будут внесены. Если в конфигурации есть ошибки, Terraform на них укажет.
-
Примените изменения конфигурации:
terraform apply
-
Подтвердите изменения: введите в терминале слово
yes
и нажмите Enter.
-
После этого к ресурсу будет добавлена метка. Проверить появление метки можно в консоли управления
yc <имя_сервиса> <тип_ресурса> get <имя_или_идентификатор_ресурса>
Пример
Описание метки для секрета Yandex Lockbox:
resource "yandex_lockbox_secret" "my_secret" { name = lockbox-test-secret labels = { label-test-key = "label-test-value" } }
Вы можете завести одну метку с несколькими значениями. Например, создать метку my-cloud
с несколькими значениями:
my-vm
— для виртуальной машины;my-disk
— для диска.
Изменить метку
Изменить метки ресурса можно только с помощью командной строки Yandex Cloud и Terraform.
Если у вас еще нет интерфейса командной строки Yandex Cloud, установите и инициализируйте его.
По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name
или --folder-id
.
Важно
Существующий набор labels
полностью перезаписывается набором, переданным в запросе.
Чтобы изменить метку ресурса сервиса воспользуйтесь командой:
yc <имя_сервиса> <тип_ресурса> update <имя_или_идентификатор_ресурса> \
--labels <имя_метки>=<значение_метки>
Пример
Изменение метки для кластера Kubernetes:
yc managed-kubernetes cluster update k8s-gpu --labels new_lable=test_label
Результат:
done (1m36s) id: cat1hknor234******** folder_id: b1g23ga45mev******** created_at: "2020-08-07T11:15:59Z" name: cluster labels: new_lable: test_label status: RUNNING ...
Если у вас еще нет Terraform, установите его и настройте провайдер Yandex Cloud.
-
Найдите в конфигурационном файле следующий фрагмент:
labels = { <ключ_метки> = <значение_метки> }
-
Измените ключ и значение метки на новые.
-
Примените изменения:
-
В терминале перейдите в папку, где вы отредактировали конфигурационный файл.
-
Проверьте корректность конфигурационного файла с помощью команды:
terraform validate
Если конфигурация является корректной, появится сообщение:
Success! The configuration is valid.
-
Выполните команду:
terraform plan
В терминале будет выведен список ресурсов с параметрами. На этом этапе изменения не будут внесены. Если в конфигурации есть ошибки, Terraform на них укажет.
-
Примените изменения конфигурации:
terraform apply
-
Подтвердите изменения: введите в терминале слово
yes
и нажмите Enter.
-
После этого у ресурса будет изменена метка. Проверить изменение метки можно в консоли управления
yc <имя_сервиса> <тип_ресурса> get <имя_или_идентификатор_ресурса>
Удалить метку
В примере ниже показано удаление метки виртуальной машины Compute Cloud. Аналогично вы можете удалить метку другого ресурса.
- В консоли управления
выберите каталог, в котором находится ВМ. - В списке сервисов выберите Compute Cloud.
- На панели слева выберите
Виртуальные машины. - В списке ВМ выберите нужную.
- Нажмите
и выберите Редактировать. - В поле Метки выберите нужную метку и нажмите
справа от ее имени.
Если у вас еще нет интерфейса командной строки Yandex Cloud, установите и инициализируйте его.
По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name
или --folder-id
.
Удалите метку ресурса сервиса:
yc <имя_сервиса> <тип_ресурса> remove-labels <имя_или_идентификатор_ресурса> \
--labels <имя_метки>
Пример
Удаление метки для кластера Managed Service for MySQL®:
yc managed-mysql cluster remove-labels mysql123 --labels my_lable
Результат:
id: c1qmjaatlurm******** folder_id: b1g23ga45mev******** created_at: "2020-08-20T11:53:20.015543Z" name: mysql123 environment: PRODUCTION ...
Если у вас еще нет Terraform, установите его и настройте провайдер Yandex Cloud.
-
Найдите в конфигурационном файле следующий фрагмент:
labels = { <ключ_метки> = "<значение_метки>" }
-
Удалите фрагмент.
-
Примените изменения:
-
В терминале перейдите в папку, где вы отредактировали конфигурационный файл.
-
Проверьте корректность конфигурационного файла с помощью команды:
terraform validate
Если конфигурация является корректной, появится сообщение:
Success! The configuration is valid.
-
Выполните команду:
terraform plan
В терминале будет выведен список ресурсов с параметрами. На этом этапе изменения не будут внесены. Если в конфигурации есть ошибки, Terraform на них укажет.
-
Примените изменения конфигурации:
terraform apply
-
Подтвердите изменения: введите в терминале слово
yes
и нажмите Enter.
-
После этого у ресурса будет удалена метка. Проверить удаление метки можно в консоли управления
yc <имя_сервиса> <тип_ресурса> get <имя_или_идентификатор_ресурса>