API Gateway:Vincular um nome de domínio personalizado a um grupo de APIs

Nomes de domínio, grupos de APIs e APIs

• Vincule seu nome de domínio a um grupo de APIs para criar um mapeamento entre eles.

• O API Gateway encaminha cada solicitação HTTP recebida para o grupo de APIs e a API corretos com base no nome de domínio, no método HTTP e no caminho.

Registro ICP para um nome de domínio

Para vincular um nome de domínio a um grupo de APIs em uma região da China continental, obtenha um número ICP ou adicione a Alibaba Cloud como provedor de serviços em seu registro ICP. Fora da China continental, o registro ICP não é necessário.

Verificação de propriedade do nome de domínio

Só é possível vincular um nome de domínio a um grupo de APIs se ele ainda não estiver vinculado a outro grupo na mesma instância com o mesmo caminho base e se não entrar em conflito com nomes de domínio curinga existentes. Verifique a propriedade do domínio usando um dos seguintes métodos:

1. Adicione um registro CNAME que mapeie seu nome de domínio para o nome de domínio de segundo nível atribuído pelo sistema.

2. Adicione um registro TXT. Use o formato "ID do grupo de APIs.Nome de domínio" para o nome do host e "apigateway-domain-verification=Nome de domínio público de segundo nível" para o valor do registro.

   Por exemplo, se o ID do grupo de APIs for b7eb2f79e64f4431b08bbb948ed2567e, o nome de domínio público de segundo nível for b7eb2f79e64f4431b08bbb948ed2567e-cn-hangzhou.alicloudapi.com e o domínio vinculado for youdomain.com ou *.yourdomain, adicione um registro TXT com nome do host (RR) b7eb2f79e64f4431b08bbb948ed2567e.yourdomain.com e valor do registro apigateway-domain-verfication=b7eb2f79e64f4431b08bbb948ed2567e-cn-hangzhou.alicloudapi.com.

Resolução de nome de domínio

Vinculação de nome de domínio

1. Faça login no console do API Gateway. No painel de navegação à esquerda, escolha Gerencie APIs > API Groups e selecione uma região.

2. Na página API Groups, clique em no grupo de APIs desejado para abrir a página Group Details. Na seção Independent Domains, clique em Bind Domain Name.

3. Na caixa de diálogo Bind Domain Name, defina os parâmetros a seguir e clique em Confirm.

   Parâmetro	Descrição
   Domain Name	Nome de domínio a ser vinculado ao grupo de APIs.
   Environment	Ambiente do nome de domínio. Valores válidos: Test: Chama apenas APIs do ambiente de teste. Pre: Chama apenas APIs do ambiente de staging. Production: Chama apenas APIs do ambiente de produção. Default (X-Ca-Stage): Chama APIs em qualquer ambiente. Adicione o cabeçalho X-Ca-Stage para especificar o ambiente de destino.
   Network Type	Internet: Chamadas de API apenas pela Internet. Internal Network: Chamadas de API apenas por redes internas.

Perguntas frequentes sobre vinculação de nomes de domínio

Verificar chamadas de API

Após a vinculação, use o nome de domínio para chamar APIs. Exemplo de solicitação curl:

curl http://yourdomain.com/apipath -i
HTTP/1.1 200 OK
Date: Mon, 23 Mar 2020 08:40:01 GMT
Connection: keep-alive
Keep-Alive: timeout=25
Server: Jetty(7.2.2.v20101205)
X-Ca-Request-Id: E2B8CBAB-D6EF-4576-838F-44DDC1A6B20D

Vincular um nome de domínio curinga

O processo é semelhante a 1. Vincular um único nome de domínio. Por exemplo, para rotear todos os subdomínios de abc.com (como 1.abc.com e 2.abc.com) para o API Gateway:

1. No console de DNS, crie um registro CNAME mapeando *.abc.com para o nome de domínio público de segundo nível.

2. Na página Group Details no console do API Gateway, vincule *.abc.com ao grupo de APIs.

Observações de uso

1. Verifique a propriedade do nome de domínio curinga antes de vincular. Verificação de propriedade do nome de domínio.

2. Após a vinculação, configure um modelo de nome de domínio curinga na página Group Details para habilitar chamadas de API por meio do domínio curinga.

Clique em Edit Wildcard Domain Name Template na coluna Actions. Insira um ou mais modelos de correspondência, como {groupId}.api.foo.com ou {userId}.user.api.foo.com, separados por Enter, vírgula ou ponto e vírgula. Clique em OK.