Получение информации об источниках

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

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

Если вы обращаетесь к ресурсу по имени, поиск будет выполнен в каталоге по умолчанию. Если вы обращаетесь к ресурсу по идентификатору, поиск будет выполнен глобально — во всех каталогах с учетом прав доступа.

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

   yc cdn origin get --help
   

2. Получите информацию об источнике, указав его идентификатор или имя:

   yc cdn origin get <идентификатор_источника>
   

   Результат:

   id: "152152********"
   origin_group_id: "2128********"
   source: test-cdn-1.storage.yandexcloud.net
   enabled: true
   meta:
     bucket:
       name: test-cdn-1
   

Чтобы получить подробную информацию об источнике, воспользуйтесь методом REST API get для ресурса Origin или вызовом gRPC API OriginService/Get.

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

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

Если вы обращаетесь к ресурсу по имени, поиск будет выполнен в каталоге по умолчанию. Если вы обращаетесь к ресурсу по идентификатору, поиск будет выполнен глобально — во всех каталогах с учетом прав доступа.

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

   yc cdn origin-group get --help
   

2. Получите информацию о группе источников, указав ее идентификатор или имя:

   yc cdn origin-group get <идентификатор_группы_источников>
   

   Результат:

   id: "2149********"
   folder_id: b1ggmp8es27t********
   name: test-cdn-group
   use_next: true
   origins:
   - id: "2741********"
     origin_group_id: "2149********"
     source: test-cdn-1-2.storage.yandexcloud.net
     enabled: true
     backup: true
     meta:
       bucket:
         name: test-cdn-1-2
   - id: "2742********"
     origin_group_id: "2149********"
     source: test-cdn-1-1.storage.yandexcloud.net
     enabled: true
     meta:
       bucket:
         name: test-cdn-1-1
   

Terraform позволяет быстро создать облачную инфраструктуру в Yandex Cloud и управлять ею с помощью файлов конфигураций. В файлах конфигураций хранится описание инфраструктуры на языке HCL (HashiCorp Configuration Language). При изменении файлов конфигураций Terraform автоматически определяет, какая часть вашей конфигурации уже развернута, что следует добавить или удалить.

Terraform распространяется под лицензией Business Source License, а провайдер Yandex Cloud для Terraform — под лицензией MPL-2.0.

Подробная информация о ресурсах провайдера в документации на сайте Terraform или в зеркале.

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

Чтобы управлять инфраструктурой с помощью Terraform от имени сервисного аккаунта или пользовательских аккаунтов: аккаунта на Яндексе, федеративного аккаунта и локального пользователя, аутентифицируйтесь соответствующим способом.

1. Добавьте в конфигурационный файл Terraform блоки data и output:

   data "yandex_cdn_origin_group" "my_group" {
     origin_group_id = "<идентификатор_группы>"
   }
   
   output "my_group_origin" {
     value = "${data.yandex_cdn_origin_group.my_group.origin}"
   }
   

   Где:

   • data "yandex_cdn_origin_group" — описание группы источников в качестве источника данных:
     • origin_group_id — идентификатор группы источников.
   • output "my_group_origin" — выходная переменная, которая содержит информацию о группе источников:
     • value — возвращаемое значение.

   Вместо origin вы можете выбрать любой другой параметр для получения информации. Подробнее о параметрах источника данных yandex_cdn_origin_group в документации провайдера.

2. Создайте ресурсы:

   1. В терминале перейдите в директорию с конфигурационным файлом.

   2. Проверьте корректность конфигурации с помощью команды:

      terraform validate
      

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

      Success! The configuration is valid.
      

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

      terraform plan
      

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

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

      terraform apply
      

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

   Terraform создаст все требуемые ресурсы и отобразит значения выходных переменных в терминале. Чтобы проверить результат, выполните команду:

   terraform output
   

   Результат:

   my_group_origin = toset([
     {
       "backup" = false
       "enabled" = true
       "origin_group_id" = 2149********
       "source" = "test-cdn-1-2"
     },
     {
       "backup" = true
       "enabled" = true
       "origin_group_id" = 2149********
       "source" = "test-cdn-1-1"
     },
   ])
   

Чтобы получить подробную информацию о группе источников, воспользуйтесь методом REST API get для ресурса OriginGroup или вызовом gRPC API OriginGroupService/Get.