Yandex Cloud
Search
Contact UsGet started
  • Blog
  • Pricing
  • Documentation
  • All Services
  • System Status
    • Featured
    • Infrastructure & Network
    • Data Platform
    • Containers
    • Developer tools
    • Serverless
    • Security
    • Monitoring & Resources
    • ML & AI
    • Business tools
  • All Solutions
    • By industry
    • By use case
    • Economics and Pricing
    • Security
    • Technical Support
    • Customer Stories
    • Gateway to Russia
    • Cloud for Startups
    • Education and Science
  • Blog
  • Pricing
  • Documentation
Yandex project
© 2025 Yandex.Cloud LLC
Yandex Resource Manager
  • Getting started
    • All guides
    • Managing labels
    • Viewing service resource operations
  • Access management
  • Pricing policy
  • Terraform reference
  • Audit Trails events
  • Release notes
  • FAQ

In this article:

  • Adding a label
  • Updating a label
  • Deleting a label
  1. Step-by-step guides
  2. Managing labels

Managing labels

Written by
Yandex Cloud
Updated at May 29, 2025
  • Adding a label
  • Updating a label
  • Deleting a label

You can add, delete, or update resource labels in the management console, Yandex Cloud CLI, and Terraform.

Labels are supported in certain services. Label management in some services, such as Object Storage, may be different.

Adding a labelAdding a label

Management console
CLI
Terraform

The example below shows how to add a label to a Compute Cloud VM instance. You can add a label to another resource in the same way.

  1. In the management console, select the folder the VM is located in.
  2. In the list of services, select Compute Cloud.
  3. In the left-hand panel, select Virtual machines.
  4. Select the VM you need from the list.
  5. Click and select Edit.
  6. In the Labels field, click Add label.
  7. Enter the key and the value, and press Enter.

If you do not have the Yandex Cloud CLI yet, install and initialize it.

By default, the CLI uses the folder specified when creating the profile. To change the default folder, use the yc config set folder-id <folder_ID> command. You can also set a different folder for any specific command using the --folder-name or --folder-id parameter.

To add or update an existing service resource label, run this command:

yc <service_name> <resource_type> add-labels <resource_name_or_ID> \
  --labels <label_name>=<label_value>

Example

Adding a label to a VM:

yc compute instance add-labels cl123g4dridnn5cn****-**** --labels project=test

Result:

done (5s)
id: fhm1pr2bu3p4********
folder_id: b1g23ga45mev********
created_at: "2020-08-07T11:29:18Z"
name: cl123g4dridnn5cn****-****
labels:
  project: test
zone_id: ru-central1-a
...

If you do not have Terraform yet, install it and configure its Yandex Cloud provider.

  1. In the configuration file, add the following fragment to the resource:

      labels = {
        <label_key> = "<label_value>"
      }
    
  2. Apply the changes:

    1. In the terminal, go to the folder where you edited the configuration file.

    2. Make sure the configuration file is correct using this command:

      terraform validate
      

      If the configuration is correct, you will get this message:

      Success! The configuration is valid.
      
    3. Run this command:

      terraform plan
      

      The terminal will display a list of resources with their properties. No changes will be made at this step. If the configuration contains any errors, Terraform will point them out.

    4. Apply the changes:

      terraform apply
      
    5. Type yes and press Enter to confirm the changes.

That will add the label to the resource. You can check the new label using the management console or this CLI command:

yc <service_name> <resource_type> get <resource_name_or_ID>

Example

Defining a label for a Yandex Lockbox secret:

resource "yandex_lockbox_secret" "my_secret" {
  name   = lockbox-test-secret
  labels = {
    label-test-key = "label-test-value"
  }
}

You can create a label with multiple values. For example, create a label named my-cloud with multiple values:

  • my-vm: For the VM.
  • my-disk: For the disk.

Updating a labelUpdating a label

You can only edit resource labels using the Yandex Cloud CLI and Terraform.

CLI
Terraform

If you do not have the Yandex Cloud CLI yet, install and initialize it.

By default, the CLI uses the folder specified when creating the profile. To change the default folder, use the yc config set folder-id <folder_ID> command. You can also set a different folder for any specific command using the --folder-name or --folder-id parameter.

Warning

The existing labels (labels) will be completely overwritten by the ones you provide in your request.

To edit a label of a service resource, use this command:

yc <service_name> <resource_type> update <resource_name_or_ID> \
  --labels <label_name>=<label_value>

Example

Editing labels for Kubernetes cluster:

yc managed-kubernetes cluster update k8s-gpu --labels new_lable=test_label

Result:

done (1m36s)
id: cat1hknor234********
folder_id: b1g23ga45mev********
created_at: "2020-08-07T11:15:59Z"
name: cluster
labels:
  new_lable: test_label
status: RUNNING
...

If you do not have Terraform yet, install it and configure its Yandex Cloud provider.

  1. In the configuration file, find the following fragment:

      labels = {
        <label_key> = <label_value>
      }
    
  2. Update both the key and the value.

  3. Apply the changes:

    1. In the terminal, go to the folder where you edited the configuration file.

    2. Make sure the configuration file is correct using this command:

      terraform validate
      

      If the configuration is correct, you will get this message:

      Success! The configuration is valid.
      
    3. Run this command:

      terraform plan
      

      The terminal will display a list of resources with their properties. No changes will be made at this step. If the configuration contains any errors, Terraform will point them out.

    4. Apply the changes:

      terraform apply
      
    5. Type yes and press Enter to confirm the changes.

After that, the label for the resource will be updated. You can check the label update using the management console or this CLI command:

yc <service_name> <resource_type> get <resource_name_or_ID>

Deleting a labelDeleting a label

Management console
CLI
Terraform

The example below shows how to delete a label from a Compute Cloud VM. You can delete a label from another resource in the same way.

  1. In the management console, select the folder the VM is located in.
  2. In the list of services, select Compute Cloud.
  3. In the left-hand panel, select Virtual machines.
  4. Select the VM you need from the list.
  5. Click and select Edit.
  6. In the Labels field, select the appropriate label and click  next to its name.

If you do not have the Yandex Cloud CLI yet, install and initialize it.

By default, the CLI uses the folder specified when creating the profile. To change the default folder, use the yc config set folder-id <folder_ID> command. You can also set a different folder for any specific command using the --folder-name or --folder-id parameter.

Delete a service resource label:

yc <service_name> <resource_type> remove-labels <resource_name_or_ID> \
  --labels <label_name>

Example

Removing a label from a Managed Service for MySQL® cluster:

yc managed-mysql cluster remove-labels mysql123 --labels my_lable

Result:

id: c1qmjaatlurm********
folder_id: b1g23ga45mev********
created_at: "2020-08-20T11:53:20.015543Z"
name: mysql123
environment: PRODUCTION
...

If you do not have Terraform yet, install it and configure its Yandex Cloud provider.

  1. In the configuration file, find the following fragment:

      labels = {
        <label_key> = "<label_value>"
      }
    
  2. Delete the fragment.

  3. Apply the changes:

    1. In the terminal, go to the folder where you edited the configuration file.

    2. Make sure the configuration file is correct using this command:

      terraform validate
      

      If the configuration is correct, you will get this message:

      Success! The configuration is valid.
      
    3. Run this command:

      terraform plan
      

      The terminal will display a list of resources with their properties. No changes will be made at this step. If the configuration contains any errors, Terraform will point them out.

    4. Apply the changes:

      terraform apply
      
    5. Type yes and press Enter to confirm the changes.

After that, the label will be removed from the resource. You can check the deletion of the label using the management console or this CLI command:

yc <service_name> <resource_type> get <resource_name_or_ID>

Was the article helpful?

Previous
All guides
Next
Creating a cloud
Yandex project
© 2025 Yandex.Cloud LLC