Criar uma API HTTP - API Gateway: Central de Documentação do Alibaba Cloud

Baseadas no protocolo HTTP, as APIs HTTP permitem expor rapidamente serviços de sistemas distribuídos. Este tópico descreve como criar uma API HTTP no console do Cloud-native API Gateway.

Casos de uso

É possível criar APIs dentro ou fora de uma instância. Cada abordagem atende a diferentes cenários.

Criar uma API dentro de uma instância

Gerenciamento dedicado de recursos: uso exclusivo da API em uma instância específica para gerenciar recursos determinados ou lógica interna.
Segurança e isolamento: ideal quando dados ou funcionalidades exigem isolamento rigoroso e acesso restrito ao interior da instância.
Configuração simplificada de serviços: facilita o gerenciamento de APIs ao restringir a configuração a uma instância específica.

Criar uma API fora de uma instância

Acesso compartilhado entre instâncias: permite que várias instâncias compartilhem uma única definição de API.
Gerenciamento e monitoramento centralizados: oferece controle unificado de permissões, registro de logs e gerenciamento de tráfego.

Importante

As APIs criadas dentro de uma instância do Cloud-native API Gateway são visíveis e gerenciáveis apenas nessa instância.
As APIs criadas fora de uma instância do Cloud-native API Gateway não podem ser modificadas nem excluídas na instância. Se você criar a API externamente, exclua-a exclusivamente na lista de APIs externas.

Criar uma API HTTP no console do Cloud-native API Gateway

Crie uma API dentro ou fora de uma instância do Cloud-native API Gateway.
External API
1. Faça login no console do Cloud-native API Gateway. No painel de navegação à esquerda, clique em API. Na barra de navegação superior, selecione uma região.
2. Clique em Create API. No cartão HTTP API, clique em Create.
Internal API
1. Faça login no console do Cloud-native API Gateway. No painel de navegação à esquerda, clique em Instance. Na barra de navegação superior, selecione uma região.
2. Na página Instance, clique no ID da instância do Cloud-native API Gateway que deseja gerenciar. No painel de navegação à esquerda, clique em API. Na página exibida, clique em Create API no canto superior direito.
3. No cartão HTTP API, clique em Create.

No painel Create HTTP API, configure os parâmetros e clique em OK.

Parâmetro	Descrição
API Name	Insira um nome para a API. O nome da API deve ser globalmente único.
Description	Insira uma descrição para a API.
Resource Group	Selecione o grupo de recursos desejado. Clique em Create Resource Group para criar um novo grupo de recursos.

Importar um Ingress para criar uma API HTTP

Pré-requisitos

Uma source de serviço do tipo Container Service for Kubernetes (ACK) já deve estar criada no console do Cloud-native API Gateway. Para mais informações, consulte Gerenciar sources de serviço.

Procedimento

Crie uma API dentro ou fora de uma instância do Cloud-native API Gateway.
External API
1. Faça login no console do Cloud-native API Gateway. No painel de navegação à esquerda, clique em API. Na barra de navegação superior, selecione uma região.
2. Clique em Create API. Na caixa de diálogo Create API, clique em Import Ingress no cartão HTTP API.
Internal API
1. Faça login no console do Cloud-native API Gateway. No painel de navegação à esquerda, clique em Instance. Na barra de navegação superior, selecione uma região.
2. Na página Instance, clique no ID da instância do Cloud-native API Gateway que deseja gerenciar. No painel de navegação à esquerda, clique em API. Na página exibida, clique em Create API no canto superior direito.
3. No cartão HTTP API, clique em Import Ingress.

No cartão HTTP API, clique em Import Ingress. No painel Import Ingress, configure os parâmetros e clique em OK.

Parâmetro	Descrição
API Name	Especifique um nome para a API. Clique em Add Description para adicionar uma descrição ao Ingress.
Description	Insira uma descrição para a API. A descrição pode ter até 255 caracteres.
Instance	Selecione a instância correspondente do Cloud-native API Gateway.
Source Cluster	Selecione o cluster ACK ao qual o Ingress pertence.
Resource Group	Selecione o grupo de recursos desejado.
Namespace	Especifique um namespace para monitoramento. Se este parâmetro ficar vazio, o sistema monitorará todos os recursos de Ingress em todos os namespaces.
IngressClass	Especifique a IngressClass a ser monitorada. Se este parâmetro ficar vazio, o sistema monitorará todos os tipos de recursos de Ingress.
Update Ingress Status	Ao ativar esta opção, o endpoint de status do Ingress monitorado será substituído pelo endpoint de ingress da instância do gateway.