Discuss with expertTry it for free
© 2026 Direct Cursus Technology L.L.C.

Managing resource labels

Written by
Updated at August 5, 2026
View in Markdown

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

Adding or updating labels

  1. In the management console, select the folder the resource is in.
  2. Navigate to Cloud CDN.
  3. In the CDN resource row, click and select Edit.
  4. Under Content, find the Labels field.
  5. Click Add label.
  6. Enter a label in key: value format. To update an existing label, enter its key and a new value.
  7. Press Enter.
  8. Click Save.

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

The folder used by default is the one specified when creating the CLI profile. To change the default folder, use the yc config set folder-id <folder_ID> command. You can also specify a different folder for any command using --folder-name or --folder-id. If you access a resource by its name, the search will be limited to the default folder. If you access a resource by its ID, the search will be global, i.e., through all folders based on access permissions.

  1. View the description of the CLI command to update the CDN resource settings:

    yc cdn resource update --help

  2. 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"}                                       |
+----------------------+---------+--------------------------------+--------------------------------+--------+---------------------------------------------------------+

  3. 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 parameter to list CDN resource labels in key=value format.

    Result:

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

Viewing labels

  1. In the management console, select the folder the resource is in.
  2. Navigate to Cloud CDN.
  3. Navigate to the CDN resource.
  4. Under Content, find the Labels field.

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

The folder used by default is the one specified when creating the CLI profile. To change the default folder, use the yc config set folder-id <folder_ID> command. You can also specify a different folder for any command using --folder-name or --folder-id. If you access a resource by its name, the search will be limited to the default folder. If you access a resource by its ID, the search will be global, i.e., through all folders based on access permissions.

  1. View the description of the CLI command to update the CDN resource settings:

    yc cdn resource update --help

  2. 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"}                                       |
+----------------------+---------+--------------------------------+--------------------------------+--------+---------------------------------------------------------+

  3. 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

  1. In the management console, select the folder the resource is in.
  2. Navigate to Cloud CDN.
  3. In the CDN resource row, click and select Edit.
  4. Under Content, find the Labels field.
  5. Click next to the label.
  6. Click Save.

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

The folder used by default is the one specified when creating the CLI profile. To change the default folder, use the yc config set folder-id <folder_ID> command. You can also specify a different folder for any command using --folder-name or --folder-id. If you access a resource by its name, the search will be limited to the default folder. If you access a resource by its ID, the search will be global, i.e., through all folders based on access permissions.

  1. View the description of the CLI command to update the CDN resource settings:

    yc cdn resource update --help

  2. 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"}                                       |
+----------------------+---------+--------------------------------+--------------------------------+--------+---------------------------------------------------------+

  3. 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 parameter to list the keys of the CDN resource labels.

    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
Previous
Suspending and resuming a resource
Next
Configuring dedicated IP addressing