Yandex Cloud
КейсыДокументация
ПрезентацияСвязаться с намиНачать бесплатно
Создавайте контент и получайте гранты!Готовы написать своё руководство? Участвуйте в контент-программе и получайте гранты на работу с облачными сервисами!
Подробнее о программе
Сделано на Gravity UI
Проект Яндекса
© 2026 ООО «Яндекс.Облако»
Yandex API Gateway
  • Начало работы
    • Все инструкции
    • Создание API-шлюза
      • Изменить API-шлюз и его спецификацию
      • Подключить домен
      • Указать облачную сеть
      • Настроить переменные
      • Настроить канареечный релиз
      • Посмотреть графики мониторинга
      • Отключить домен
      • Остановить и запустить API-шлюз
      • Миграция в зону ru-central1-d
      • Удалить API-шлюз
    • Просмотр операций с ресурсами сервиса
  • Управление доступом
  • Инструменты
  • Правила тарификации
  • Справочник Terraform
  • Справочник метрик
  • Аудитные логи Audit Trails
  • Публичные материалы
  • История изменений
  • Вопросы и ответы
  • Обучающие курсы
  1. Пошаговые инструкции
  2. Управление API-шлюзом
  3. Отключить домен

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

Статья создана
Yandex Cloud
Улучшена
Обновлена 15 октября 2026 г.
Открыть в Markdown
Консоль управления
CLI
Terraform
API
  1. В консоли управления выберите каталог, в котором находится API-шлюз.

  2. Перейдите в сервис API Gateway.

  3. Нажмите на имя нужного API-шлюза.

  4. Перейдите на вкладку Домены.

  5. В строке с доменом нажмите кнопку и выберите Отключить.

  6. Подтвердите отключение.

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

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

      1. Перейдите в сервис Cloud DNS.
      2. Выберите зону, в которой находится домен.
      3. Нажмите в строке записи со значком и выберите Удалить.
      4. Подтвердите удаление.
    • Если вашим доменом управляет сторонний DNS-провайдер, удалите запись на странице управления доменом вашего провайдера.

Если у вас еще нет интерфейса командной строки 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-провайдер, удалите запись на странице управления доменом вашего провайдера.

Была ли статья полезна?

Предыдущая
Записать логи
Следующая
Остановить и запустить API-шлюз
Создавайте контент и получайте гранты!Готовы написать своё руководство? Участвуйте в контент-программе и получайте гранты на работу с облачными сервисами!
Подробнее о программе
Сделано на Gravity UI
Проект Яндекса
© 2026 ООО «Яндекс.Облако»