All Products
Search
Document Center

API Gateway:Domain name issues

Last Updated:Jan 09, 2025

This topic provides answers to frequently asked questions (FAQ) about domain names in API Gateway.

Domain name issues

What is a second-level domain name and what limits does it have?

API Gateway assigns a public second-level domain name to each API group by default.

The egress IP address of API Gateway may change. Therefore, you must create a CNAME record for your independent domain name and map the CNAME record to a fixed second-level domain name. This way, you can access API Gateway over the Internet reliably.

Note: The system-assigned second-level domain name is for testing purposes only. You can use it directly to make a limited number of API calls. For regions outside the Chinese mainland, the limit is 100 calls per day. For regions inside the Chinese mainland, the limit is 1,000 calls per day. You must bind your own independent domain name to provide your APIs.

How long does it take for a bound domain name to take effect?

If you are using an Alibaba Cloud domain name:

  1. A newly added domain name resolution takes effect within one minute.

  2. An edited domain name resolution takes effect a little longer after than the Time to Live (TTL) configured for the previous resolution.

If you are using a non-Alibaba Cloud domain name, the policy of the domain name provider prevails.

How do I use an independent domain name to call an API?

You can bind one or more domain names of your own to an API group and use the domain names to call an API in the group.

Do I need to file my domain name with ICP by using Alibaba Cloud before I can use the domain name to open APIs?

Yes.

How is a domain name resolved?

First, you bind the domain name to your API group. Then, you map the CNAME record of the domain name to the second-level domain name that is assigned to the API group. This way, the bound domain name can be resolved to the second-level domain name and the associated API can be called normally.

How many domain names can I bind to an API group?

You can bind up to five public domain names and five internal domain names to an API group.