Managing labels

Custom labels are a pair of <label name>=<label value>. You can label resources so that a file with expense details contains a column like label.user_labels.<label name>. Each resource can be assigned multiple labels.

For example, if all VMs belong to two projects, you can add the project=1 or project=2 label to each VM. After that, the label.user_labels.project column with the corresponding values appears in the file with details.

Adding a label

yc <service name> <resource type> add-labels <resource name or ID> \
  --labels <label name>=<label value>

Updating a label

yc <service name> <resource type> update <resource name or ID> \
  --labels <label name>=<label value>

Deleting a label

yc <service name> <resource type> remove-labels <resource name or ID> \
  --labels <label name>

Examples of label management

Adding a label

Add a label to a VM:

yc compute instance add-labels cl123g4dridnn5cna6df-yduv --labels project=test

Command execution result:

done (5s)
id: fhm1pr2bu3p45s6ildh7
folder_id: b1g23ga45mev6cljderg
created_at: "2020-08-07T11:29:18Z"
name: cl123g4dridnn5cna6df-yduv
labels:
  project: test
zone_id: ru-central1-a
...

Updating a label

Change the Kubernetes cluster label:

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

Command execution result:

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

Deleting a label

Remove a label from a Managed Service for MySQL cluster:

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

Command execution result:

id: c1qmjaatlurm2bcoi34i
folder_id: b1g23ga45mev6cljderg
created_at: "2020-08-20T11:53:20.015543Z"
name: mysql123
environment: PRODUCTION
...