API Gateway:Vincule 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 roteia cada requisiçã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.

Arquivamento 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, você deve obter um número ICP ou adicionar a Alibaba Cloud como provedor de services em seu arquivamento ICP. Nenhum arquivamento ICP é necessário fora da China continental.

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

Você só pode 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 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 do 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 o nome do host (RR) b7eb2f79e64f4431b08bbb948ed2567e.yourdomain.com e o 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 Manage APIs > API Groups e selecione uma região.

2. Na página API Groups, clique no grupo de APIs de destino 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 seguintes parâmetros e clique em Confirm.

   Parâmetro	Descrição
   Domain Name	O nome de domínio a ser vinculado ao grupo de APIs.
   Environment	O ambiente para o 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 nome de domínio

Verifique as chamadas de API

Após a vinculação, use o nome de domínio para chamar APIs. Exemplo de requisiçã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

Vincule um nome de domínio curinga

O processo é semelhante a {{XREF_11}}. 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.

Notas de uso

1. Verifique a propriedade do nome de domínio curinga antes da vinculação. {{XREF_12}}.

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 correspondentes, como {groupId}.api.foo.com ou {userId}.user.api.foo.com, separados por Enter, vírgula ou ponto e vírgula. Clique em OK.