Connecting an origin group to a resource

Written by

Connecting an origin group when creating a resource
Connecting an origin group when editing resource settings

To connect an origin group to the resource, under Content, select Origin group when creating or updating resource settings.

Connecting an origin group when creating a resource

Management console

CLI

Terraform

In the management console, select the folder where you want to create a resource.
Select Cloud CDN.
Click Create resource.
Under Content, select From origin group in the Content query field.
Select an origin group.
Specify the other resource settings. For more information, see Creating a resource.
Click Create.

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 create resource command:
```
yc cdn resource create --help
```

Get a list of all origin groups in the default folder:

yc cdn origin-group list --format yaml

Result:

- id: "90209"
  folder_id: b1g86q4m5vej8lkljme5
  name: test-group-1
  use_next: true
  origins:
  - id: "561547"
    origin_group_id: "90209"
    source: www.example2.com
    enabled: true
    backup: true
  - id: "561546"
    origin_group_id: "90209"
    source: www.example1.com
    enabled: true
- id: "90208"
  folder_id: b1g86q4m5vej8lkljme5
  name: test-group
  use_next: true
  origins:
  - id: "561545"
    origin_group_id: "90208"
    source: www.a2.com
    enabled: true
    backup: true
  - id: "561544"
    origin_group_id: "90208"
    source: www.a1.com
    enabled: true

Create a resource with the connected origin group:

yc cdn resource create --cname <resource domain name> \
  --origin-group-id <origin group ID> \
  --origin-protocol https

Where:

origin-group-id: Origin group ID.
origin-protocol: Origin protocol.

Result:

id: bc855oumelrqw3ceywih
folder_id: b1g86q4m5vej8lkljme5
cname: res1.example.com
created_at: "2022-01-15T15:13:42.827643Z"
updated_at: "2022-01-15T15:13:42.827671Z"
active: true
options:
  edge_cache_settings:
    enabled: true
    default_value: "345600"
  cache_http_headers:
    value:
    - accept-ranges
    - cache-control
    - connection
    - content-encoding
    - content-length
    - content-type
    - date
    - etag
    - expires
    - keep-alive
    - last-modified
    - server
    - vary
  stale:
    enabled: true
    value:
    - error
    - updating
  allowed_http_methods:
    value:
    - GET
    - POST
    - HEAD
    - OPTIONS
origin_group_id: "90208"
origin_group_name: test-group-22
origin_protocol: HTTPS
ssl_certificate:
  type: DONT_USE
  status: READY

For more information about the yc cdn resource create command, see the CLI reference.

If you don't have Terraform, install it and configure the Yandex Cloud provider.

Describe the resource parameters in the yandex_cdn_resource configuration file.

Example configuration file structure:

provider "yandex" {
  token     = "<OAuth>"
  cloud_id  = "<cloud ID>"
  folder_id = "<folder ID>"
  zone      = "<default availability zone>"
}

resource "yandex_cdn_resource" "my_resource" {
  cname = "<resource domain name>"
  active = true
  origin_protocol = "https"
  origin_group_id = <origin group ID>
}

For more information about the resources you can create using Terraform, see the provider documentation.

Make sure the settings are correct.
1. Using the command line, navigate to the folder that contains the up-to-date Terraform configuration files with an infrastructure plan.
2. Run the command:
```
terraform validate
```
  If there are errors in the configuration files, Terraform will point to them.
Create an origin group.
1. Run the command to view planned changes:
```
terraform plan
```
  If the resource configuration descriptions are correct, the terminal will display a list of the resources to modify and their parameters. This is a test step. No resources are updated.
2. If you are happy with the planned changes, apply them:
  1. Run the command:
```
terraform apply
```
  2. Confirm the update of resources.
  3. Wait for the operation to complete.

Connecting an origin group when editing resource settings

Management console

CLI

In the management console, select the folder where you a resource is located.
Select Cloud CDN.
Click the name of the desired resource.
In the top right-hand corner, click Edit.
Select an origin group.
Enter the other resource settings if needed. For more information, see Editing the basic settings of a resource.
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: bc82xll34xuc4kymnpqq
  folder_id: b1g86q4m5vej8lkljme5
  cname: res1.example.com
  created_at: "2022-01-21T08:17:48.850086Z"
  updated_at: "2022-01-21T08:17:48.850125Z"
  active: true
  options:
    edge_cache_settings:
      enabled: true
      default_value: "345600"
    cache_http_headers:
      value:
      - accept-ranges
      - cache-control
      - connection
      - content-encoding
      - content-length
      - content-type
      - date
      - etag
      - expires
      - keep-alive
      - last-modified
      - server
      - vary
    stale:
      enabled: true
      value:
      - error
      - updating
    allowed_http_methods:
      value:
      - GET
      - POST
      - HEAD
      - OPTIONS
  origin_group_id: "90208"
  origin_group_name: test-group
  origin_protocol: HTTPS
  ssl_certificate:
    type: DONT_USE
    status: READY

Get a list of all origin groups in the default folder and select the ID of the appropriate group:

yc cdn origin-group list --format yaml

Result:

- id: "90209"
  folder_id: b1g86q4m5vej8lkljme5
  name: test-group-1
  use_next: true
  origins:
  - id: "561547"
    origin_group_id: "90209"
    source: www.example2.com
    enabled: true
    backup: true
  - id: "561546"
    origin_group_id: "90209"
    source: www.example1.com
    enabled: true
- id: "90208"
  folder_id: b1g86q4m5vej8lkljme5
  name: test-group
  use_next: true
  origins:
  - id: "561545"
    origin_group_id: "90208"
    source: www.a2.com
    enabled: true
    backup: true
  - id: "561544"
    origin_group_id: "90208"
    source: www.a1.com
    enabled: true

Update resource settings by specifying the ID of the appropriate origin group:

yc cdn resource update --id <resource ID> \
  --origin-group-id <origin group ID>

Result:

id: bc8krsk72icwnvyvs6c3
folder_id: b1g86q4m5vej8lkljme5
cname: res2.example.com
created_at: "2022-01-15T15:29:19.103653Z"
updated_at: "2022-01-15T15:33:22.819916Z"
active: true
options:
  edge_cache_settings:
    enabled: true
    default_value: "345600"
  cache_http_headers:
    value:
    - accept-ranges
    - cache-control
    - connection
    - content-encoding
    - content-length
    - content-type
    - date
    - etag
    - expires
    - keep-alive
    - last-modified
    - server
    - vary
  stale:
    enabled: true
    value:
    - error
    - updating
  allowed_http_methods:
    value:
    - GET
    - POST
    - HEAD
    - OPTIONS
origin_group_id: "90209"
origin_group_name: test-group-1
origin_protocol: HTTPS
ssl_certificate:
  type: DONT_USE
  status: READY

For more information about the yc cdn resource update command, see the CLI reference.

It may take up to 15 minutes for the new resource settings to apply to CDN servers. After that, we recommend purging the resource cache.

Connecting an origin group to a resource

Connecting an origin group when creating a resource

Connecting an origin group when editing resource settings

Was the article helpful?