Contact UsGet started
© 2025 Direct Cursus Technology L.L.C.

Managing resource labels

Written by
Updated at December 3, 2025

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. Go 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 installed 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.

  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. Go 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 installed 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.

  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. Go 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 installed 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.

  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
Disabling a resource
Next
Deleting a resource