Связаться с намиПодключиться

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

Статья создана
Улучшена
Обновлена 11 июля 2025 г.

Вы можете добавить, удалить или изменить метку ресурса с помощью консоли управления, командной строки Yandex Cloud и Terraform.

Метки поддерживаются в определенных сервисах. Управление метками в некоторых сервисах может отличаться, например в Object Storage.

Добавить метку

В примере ниже показано добавление метки к виртуальной машине Compute Cloud. Аналогично вы можете добавить метку другому ресурсу.

  1. В консоли управления выберите каталог, в котором находится ВМ.
  2. В списке сервисов выберите Compute Cloud.
  3. На панели слева выберите Виртуальные машины.
  4. В списке ВМ выберите нужную.
  5. Нажмите и выберите Редактировать.
  6. В поле Метки нажмите Добавить метку.
  7. Введите ключ и значение и нажмите Enter.

Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.

По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>. Также для любой команды вы можете указать другой каталог с помощью параметров --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: kz1-a
...

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

  1. Добавьте к ресурсу в конфигурационном файле следующий фрагмент:

      labels = {
    <ключ_метки> = "<значение_метки>"
  }

  2. Примените изменения:

    1. В терминале перейдите в папку, где вы отредактировали конфигурационный файл.

    2. Проверьте корректность конфигурационного файла с помощью команды:

      terraform validate

      Если конфигурация является корректной, появится сообщение:

      Success! The configuration is valid.

    3. Выполните команду:

      terraform plan

      В терминале будет выведен список ресурсов с параметрами. На этом этапе изменения не будут внесены. Если в конфигурации есть ошибки, Terraform на них укажет.

    4. Примените изменения конфигурации:

      terraform apply

    5. Подтвердите изменения: введите в терминале слово yes и нажмите Enter.

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

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), установите и инициализируйте его.

По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>. Также для любой команды вы можете указать другой каталог с помощью параметров --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.

  1. Найдите в конфигурационном файле следующий фрагмент:

      labels = {
    <ключ_метки> = <значение_метки>
  }

  2. Измените ключ и значение метки на новые.

  3. Примените изменения:

    1. В терминале перейдите в папку, где вы отредактировали конфигурационный файл.

    2. Проверьте корректность конфигурационного файла с помощью команды:

      terraform validate

      Если конфигурация является корректной, появится сообщение:

      Success! The configuration is valid.

    3. Выполните команду:

      terraform plan

      В терминале будет выведен список ресурсов с параметрами. На этом этапе изменения не будут внесены. Если в конфигурации есть ошибки, Terraform на них укажет.

    4. Примените изменения конфигурации:

      terraform apply

    5. Подтвердите изменения: введите в терминале слово yes и нажмите Enter.

После этого у ресурса будет изменена метка. Проверить изменение метки можно в консоли управления или с помощью команды CLI:

yc <имя_сервиса> <тип_ресурса> get <имя_или_идентификатор_ресурса>

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

В примере ниже показано удаление метки виртуальной машины Compute Cloud. Аналогично вы можете удалить метку другого ресурса.

  1. В консоли управления выберите каталог, в котором находится ВМ.
  2. В списке сервисов выберите Compute Cloud.
  3. На панели слева выберите Виртуальные машины.
  4. В списке ВМ выберите нужную.
  5. Нажмите и выберите Редактировать.
  6. В поле Метки выберите нужную метку и нажмите справа от ее имени.

Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.

По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>. Также для любой команды вы можете указать другой каталог с помощью параметров --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.

  1. Найдите в конфигурационном файле следующий фрагмент:

      labels = {
    <ключ_метки> = "<значение_метки>"
  }

  2. Удалите фрагмент.

  3. Примените изменения:

    1. В терминале перейдите в папку, где вы отредактировали конфигурационный файл.

    2. Проверьте корректность конфигурационного файла с помощью команды:

      terraform validate

      Если конфигурация является корректной, появится сообщение:

      Success! The configuration is valid.

    3. Выполните команду:

      terraform plan

      В терминале будет выведен список ресурсов с параметрами. На этом этапе изменения не будут внесены. Если в конфигурации есть ошибки, Terraform на них укажет.

    4. Примените изменения конфигурации:

      terraform apply

    5. Подтвердите изменения: введите в терминале слово yes и нажмите Enter.

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

yc <имя_сервиса> <тип_ресурса> get <имя_или_идентификатор_ресурса>
Предыдущая
Все инструкции
Следующая
Создание облака