Отключить домен

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

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

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

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

   yc serverless api-gateway remove-domain --help
   

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

   yc serverless api-gateway remove-domain <идентификатор_API-шлюза> --domain-id <идентификатор_домена>
   

3. Удалите ресурсную запись, созданную при подключении домена к API-шлюзу:

   • Если ваш домен делегирован Cloud DNS:

     1. Получите список всех записей в зоне DNS, указав идентификатор этой зоны:

        yc dns zone list-records <идентификатор_зоны_DNS>
        

        Нужная запись имеет тип ANAME и значение вида d5dm1lba80md********.i9******.apigw.yandexcloud.net.

     2. Удалите запись:

        yc dns zone delete-records <идентификатор_зоны_DNS> \
          --record "<доменное_имя> <TTL> <тип_записи> <значение>"
        

   • Если вашим доменом управляет сторонний DNS-провайдер, удалите запись на странице управления доменом вашего провайдера.

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 и удалите блок custom_domains с отключаемым доменом из описания ресурса yandex_api_gateway:

   resource "yandex_api_gateway" "<имя_API-шлюза>" {
     name = "<имя_API-шлюза>"
     ...
     custom_domains {
       fqdn           = "<доменное_имя>"
       certificate_id = "<идентификатор_сертификата>"
     }
   }
   

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

2. Примените изменения:

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

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

      terraform validate
      

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

      Success! The configuration is valid.
      

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

      terraform plan
      

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

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

      terraform apply
      

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

3. Удалите ресурсную запись, созданную при подключении домена к API-шлюзу:

   • Если ваш домен делегирован Cloud DNS, удалите ANAME-запись в зоне DNS.

   • Если вашим доменом управляет сторонний DNS-провайдер, удалите запись на странице управления доменом вашего провайдера.

Чтобы отключить домен от API-шлюза, воспользуйтесь методом REST API removeDomain для ресурса ApiGateway или вызовом gRPC API ApiGatewayService/RemoveDomain.

Удалите ресурсную запись, созданную при подключении домена к API-шлюзу:

• Если ваш домен делегирован Cloud DNS, воспользуйтесь методом REST API updateRecordSets для ресурса DnsZone или вызовом gRPC API DnsZoneService/UpdateRecordSets.

• Если вашим доменом управляет сторонний DNS-провайдер, удалите запись на странице управления доменом вашего провайдера.