Настройка HTTP-заголовков запросов и ответов

Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.

По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>. Также для любой команды вы можете указать другой каталог с помощью параметров --folder-name или --folder-id.

1. Посмотрите описание команды CLI для редактирования ресурсов:

   yc cdn resource update --help
   

2. Получите список всех ресурсов в каталоге по умолчанию:

   yc cdn resource list --format yaml
   

   Результат:

   id: s0me1dkfjq********
   folder_id: s0mef01der7p********
   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
   

3. Чтобы добавить заголовки, выполните:

   yc cdn resource update <идентификатор_ресурса> \
     --static-request-headers <ключ>=<значение> \
     --static-headers <ключ>=<значение>
   

   Где:

   • --static-request-headers добавляет заголовки запроса к источнику. Удалить их можно с помощью флага --clear-static-request-headers.
   • --static-headers добавляет заголовки ответа клиента. Удалить их можно с помощью флага --clear-static-headers.

   Подробнее о команде yc cdn resource update см. в справочнике CLI.

Если у вас еще нет Terraform, установите его и настройте провайдер Yandex Cloud.

1. Опишите в конфигурационном файле параметры создаваемого CDN-ресурса:

   terraform {
     required_providers {
       yandex = {
         source  = "yandex-cloud/yandex"
         version = "0.69.0"
       }
     }
   }
   
   provider "yandex" {
     token     = "<OAuth-токен>"
     cloud_id  = "<идентификатор_облака>"
     folder_id = "<идентификатор_каталога>"
     zone      = "<зона_доступности>"
   }
   
   resource "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     = yandex_cdn_origin_group.my_group.id
       options {
         cache_http_headers = ["GET","PUT"]
         cors                 = ["*"]
         static_response_headers = { "world2" = "2hello" }
   
       }
   
   }
   

   Где:

   • cname — основное доменное имя для раздачи контента. Обязательный параметр.
   • active — флаг, указывающий на доступ к контенту для конечных пользователей. True — контент из CDN будет доступен клиентам. Необязательный параметр, значение по умолчанию: true.
   • origin_protocol — протокол для источников. Необязательный параметр, значение по умолчанию: http.
   • secondary_hostnames — дополнительные доменные имена. Необязательный параметр.
   • origin_group_id — идентификатор группы источников. Обязательный параметр. Используйте идентификатор из описания группы источников в ресурсе yandex_cdn_origin_group.
   • Блок options содержит дополнительные параметры CDN-ресурсов:
     • static_response_headers — пользовательские заголовки, которые CDN-серверы отправляют в ответ клиенту. Необязательный параметр.

   Более подробную информацию о параметрах yandex_cdn_resource в Terraform см. в документации провайдера.

2. В командной строке перейдите в папку, где расположен конфигурационный файл Terraform.

3. Проверьте конфигурацию командой:

   terraform validate
   

   Если конфигурация является корректной, появится сообщение:

   Success! The configuration is valid.
   

4. Выполните команду:

   terraform plan
   

   В терминале будет выведен список ресурсов с параметрами. На этом этапе изменения не будут внесены. Если в конфигурации есть ошибки, Terraform на них укажет.

5. Примените изменения конфигурации:

   terraform apply
   

6. Подтвердите изменения: введите в терминал слово yes и нажмите Enter.

   Проверить изменение CDN-ресурса можно в консоли управления или с помощью команды CLI:

   yc cdn resource list
   

Воспользуйтесь методом REST API update для ресурса Resource или вызовом gRPC API ResourceService/Update.