Editing the basic settings of a resource
To edit the basic settings of a resource:
-
In the management console, select the folder where your resource is located.
-
Select Cloud CDN.
-
Click the name of the desired resource.
-
In the top right-hand corner, click
Edit. -
Edit the resource settings.
Warning
You can't change the primary domain name used for content distribution.
-
Click Save.
If you don't have the Yandex Cloud command line interface yet, install and initialize it.
The folder specified in the CLI profile is used by default. You can specify a different folder using the --folder-name
or --folder-id
parameter.
-
View a description of the CLI update resource command:
yc cdn resource update --help
-
Get a list of all resources in the default folder:
yc cdn resource list --format yaml
Result:
id: someidkfjqjfl325fw folder_id: somefolder7p3l5eobbd cname: testexample.com created_at: "2022-01-19T09:23:57.921365Z" updated_at: "2022-01-19T10:55:30.305141Z" active: true options: edge_cache_settings: enabled: true default value: "345600" cache_http_headers: enabled: true value: - content-type - content-length - connection - server - date - test stale: enabled: true value: - error - updating allowed_http_methods: value: - GET - POST - HEAD - OPTIONS origin_group_id: "89783" origin_group_name: My origins group origin_protocol: HTTP ssl_certificate: type: DONT_USE status: READY
-
Edit the resource settings:
yc cdn resource update <resource ID> \ <flag> <new value>
For more information about the
yc cdn resource update
command, see the CLI reference.
If you don't have Terraform, install it and configure the Yandex Cloud provider.
To update the parameters of a CDN resource created using Terraform:
-
Open the Terraform configuration file and edit the fragment with the resource description.
An example of describing a CDN resource in the Terraform configurationresource "yandex_cdn_resource" "my_resource" { cname = "cdn1.yandex-example.ru" active = false origin_protocol = "https" secondary_hostnames = ["cdn-example-1.yandex.ru", "cdn-example-2.yandex.ru"] origin_group_id = "<origin group ID>" ... options { edge_cache_settings = "345600" ignore_cookie = true ... } }
For more information about
yandex_cdn_resource
parameters in Terraform, see the provider documentation. -
In the command line, go to the directory with the Terraform configuration file.
-
Check the configuration using the command:
terraform validate
If the configuration is correct, the following message is returned:
Success! The configuration is valid.
-
Run the command:
terraform plan
The terminal will display a list of resources with parameters. No changes are made at this step. If the configuration contains errors, Terraform will point them out.
-
Apply the configuration changes:
terraform apply
-
Confirm the changes: type
yes
into the terminal and press Enter.You can check the changes to the CDN resource in the management console or using the CLI:
yc cdn resource list
It may take up to 15 minutes for the new settings of the existing resource to apply to CDN servers. After that, we recommend purging the resource cache.
Examples
Change the protocol for origins from HTTP to HTTPS and select a Let's Encrypt® certificate:
yc cdn resource update someidkfjqjfl325fw \
--origin-protocol HTTPS \
--lets-encrypt-gcore-ssl-cert
Result:
id: someidkfjqjfl325fw
...
cname: testexample.com
active: true
...
origin_group_id: "89783"
origin_group_name: My origins group
origin_protocol: HTTPS
ssl_certificate:
type: LETS_ENCRYPT_GCORE
status: CREATING