Connecting a domain

Add a CNAME record to your DNS provider or to your own DNS server:

<domain> IN CNAME <API_gateway_service_domain>

To find out an API gateway's service domain:

1. Go to the management console.
2. Select the folder where the API gateway is located, and in the service list, select API Gateway.
3. Select the API gateway.
4. You can see the service domain in the Default domain field.

Domain names must end in a dot.

To use a top-level domain or higher, delegate it to Yandex Cloud DNS and create an ANAME record in the DNS zone. You can create a record in Yandex Cloud DNS both before and after creating the domain. For more information, see step 6.

In the management console, select the folder containing the API gateway.

In the list of services, select Certificate Manager and:

1. Add a Let's Encrypt^® certificate or a user certificate for the domain you are connecting.

   Note

   Make sure to timely update your certificates. Learn more about updating Let's Encrypt^® certificates and custom certificates.

2. Wait until the certificate status switches to Issued.

Go back to the folder page.

In the list of services, select API Gateway and:

1. Select the API gateway.
2. In the window that opens, go to Domains.
3. Click Attach, select a certificate, and enter a domain name (FQDN).

If you skipped step 1 and did not add a CNAME record, create an ANAME record in Yandex Cloud DNS:

1. Click Create record in the domain row.
2. If you do not have a DNS zone with the same name as the domain, create one. To do this, click Create zone.
3. Select a different value in the TTL (in seconds) field, if required.
4. Click Create.