Managing resource labels

Written by

Yandex Cloud

Updated at May 5, 2025

Adding or updating labels
Viewing labels
Deleting labels

CDN resource labels are key-value pairs used for logical CDN resource labeling.

Adding or updating labels

Management console

CLI

In the management console, select Cloud CDN from the list of services.
In the line with the CDN resource, click and select Edit.
Under Content, find the Labels field.
Click Add label.
Enter a label in key: value format. To edit an existing label, enter its key and a new value.
Click Enter.
Click Save.

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

The folder specified when creating the CLI profile is used by default. To change the default folder, use the yc config set folder-id <folder_ID> command. You can specify a different folder using the --folder-name or --folder-id parameter.

View the description of the CLI command to update the CDN resource settings:
```
yc cdn resource update --help
```

Get a list of CDN resources in the default folder:

yc cdn resource list

Result:

+----------------------+---------+--------------------------------+--------------------------------+--------+---------------------------------------------------------+
|          ID          |  CNAME  |           CREATED AT           |           UPDATED AT           | ACTIVE |                         OPTIONS                         |
+----------------------+---------+--------------------------------+--------------------------------+--------+---------------------------------------------------------+
| bc8jhcx5o47p******** | ****.ru | seconds:1734615244             | seconds:1734615244             | false  | edge_cache_settings:{enabled:true                       |
|                      |         | nanos:439618000                | nanos:439638000                |        |  default_value:345600}                                  |
|                      |         |                                |                                |        | query_params_options:{ignore_query_string:{enabled:true |
|                      |         |                                |                                |        |  value:true}}  stale:{enabled:true  value:"error"       |
|                      |         |                                |                                |        | value:"updating"}                                       |
+----------------------+---------+--------------------------------+--------------------------------+--------+---------------------------------------------------------+

Add labels by specifying the name of the CDN resource:

yc cdn resource update <CDN_resource_ID> \
  --add-labels <label_1_key>=<label_1_value>,<label_2_key>=<label_2_value>,...,<label_n_key>=<label_n_value>

Where --add-labels is a flag to list the CDN resource labels in key=value format.

Result:

id: bc8jhcx5o47p********
folder_id: b1g681qpemb4********
cname: ****.ru
...
labels:
  key2: value2
  key3: value3
  key4: value4

Viewing labels

Management console

CLI

In the management console, select Cloud CDN from the list of services.
Navigate to the CDN resource.
Under Content, find the Labels field.

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

View the description of the CLI command to update the CDN resource settings:
```
yc cdn resource update --help
```

Get a list of CDN resources in the default folder:

yc cdn resource list

Result:

+----------------------+---------+--------------------------------+--------------------------------+--------+---------------------------------------------------------+
|          ID          |  CNAME  |           CREATED AT           |           UPDATED AT           | ACTIVE |                         OPTIONS                         |
+----------------------+---------+--------------------------------+--------------------------------+--------+---------------------------------------------------------+
| bc8jhcx5o47p******** | ****.ru | seconds:1734615244             | seconds:1734615244             | false  | edge_cache_settings:{enabled:true                       |
|                      |         | nanos:439618000                | nanos:439638000                |        |  default_value:345600}                                  |
|                      |         |                                |                                |        | query_params_options:{ignore_query_string:{enabled:true |
|                      |         |                                |                                |        |  value:true}}  stale:{enabled:true  value:"error"       |
|                      |         |                                |                                |        | value:"updating"}                                       |
+----------------------+---------+--------------------------------+--------------------------------+--------+---------------------------------------------------------+

Get information about the labels by specifying the name of the CDN resource:

yc cdn resource get <CDN_resource_ID>

Result:

id: bc8jhcx5o47p********
folder_id: b1g681qpemb4********
cname: ****.ru
...
labels:
  key2: value2
  key3: value3
  key4: value4

Deleting labels

Management console

CLI

In the management console, select Cloud CDN from the list of services.
In the line with the CDN resource, click and select Edit.
Under Content, find the Labels field.
Click next to the label.
Click Save.

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

View the description of the CLI command to update the CDN resource settings:
```
yc cdn resource update --help
```

Get a list of CDN resources in the default folder:

yc cdn resource list

Result:

+----------------------+---------+--------------------------------+--------------------------------+--------+---------------------------------------------------------+
|          ID          |  CNAME  |           CREATED AT           |           UPDATED AT           | ACTIVE |                         OPTIONS                         |
+----------------------+---------+--------------------------------+--------------------------------+--------+---------------------------------------------------------+
| bc8jhcx5o47p******** | ****.ru | seconds:1734615244             | seconds:1734615244             | false  | edge_cache_settings:{enabled:true                       |
|                      |         | nanos:439618000                | nanos:439638000                |        |  default_value:345600}                                  |
|                      |         |                                |                                |        | query_params_options:{ignore_query_string:{enabled:true |
|                      |         |                                |                                |        |  value:true}}  stale:{enabled:true  value:"error"       |
|                      |         |                                |                                |        | value:"updating"}                                       |
+----------------------+---------+--------------------------------+--------------------------------+--------+---------------------------------------------------------+

Delete labels by specifying the name of the CDN resource:

yc cdn resource update <CDN_resource_ID> \
  --remove-labels <label_1_key>,<label_2_key>,...,<label_n_key>

Where --remove-labels is a flag to list the CDN resource label keys.

Result:

id: bc8jhcx5o47p********
folder_id: b1g681qpemb4********
cname: ****.ru
...
labels:
  key2: value2
  key3: value3
  key4: value4

To delete all labels, use the --remove-all-labels flag:

yc cdn resource update <CDN_resource_ID> \
  --remove-all-labels

Managing resource labels

Adding or updating labelsAdding or updating labels

Viewing labelsViewing labels

Deleting labelsDeleting labels

Was the article helpful?

Adding or updating labels

Viewing labels

Deleting labels