As APIs HTTP usam o protocolo HTTP para expor rapidamente serviços internos em um sistema distribuído. Este tópico descreve como criar uma API HTTP no console.
Casos de uso
Você pode criar APIs dentro ou fora de uma instância, conforme o caso de uso.
Criar uma API dentro de uma instância
Gerenciamento dedicado de recursos: a API gerencia recursos ou lógica interna exclusivamente em uma instância específica.
Segurança e isolamento: dados ou funcionalidades exigem isolamento rigoroso e são acessíveis apenas de dentro da instância.
Configuração simplificada de service: restringir a configuração a uma instância específica facilita o gerenciamento da API.
Criar uma API fora de uma instância
Acesso compartilhado entre instâncias: várias instâncias compartilham uma única definição de API.
Gerenciamento e monitoramento centralizados: controle unificado de permissões, logs e gerenciamento de tráfego.
As APIs criadas dentro de uma instância ficam visíveis e gerenciáveis apenas nessa instância.
Não é possível editar nem excluir APIs criadas fora de uma instância a partir dela. Gerencie-as pela lista externa de APIs.
Criar uma API HTTP no console
-
Há duas formas de criar uma API no Cloud-native API Gateway:
External API
Faça login no console do Cloud-native API Gateway. No painel de navegação à esquerda, escolha API. Na barra de menu superior, selecione uma região.
Clique em Create API e, em seguida, clique em Create no cartão HTTP API.
In-instance API
Faça login no console do Cloud-native API Gateway. No painel de navegação à esquerda, escolha Instance. Na barra de menu superior, selecione uma região.
Na página Instance, clique no ID da instância de gateway desejada. No painel de navegação à esquerda, escolha API. No canto superior direito, clique em Create API.
Clique em Create no cartão HTTP API.
-
No painel Create REST API, configure os parâmetros e clique em OK.
Item de configuração
Descrição
API Name
Nome personalizado para a API. O nome da API deve ser globalmente único.
Description
Insira uma descrição para a API.
resource
Selecione o grupo de recursos desejado. Você também pode clicar em Create Resource Group à direita.
Criar uma API HTTP importando um Ingress
Pré-requisitos
Crie uma origem do Container Service no Cloud-native API Gateway. Para mais informações, consulte Manage service sources.
Procedimento
-
Há duas formas de criar uma API no Cloud-native API Gateway:
Outside an instance
Faça login no console do Cloud-native API Gateway. No painel de navegação à esquerda, escolha API. Na barra de menu superior, selecione uma região.
Clique em Create API e, em seguida, clique em Import Ingress no cartão HTTP API.
In-instance API
Faça login no console do Cloud-native API Gateway. No painel de navegação à esquerda, escolha Instance. Na barra de menu superior, selecione uma região.
Na página Instance, clique no ID da instância de gateway desejada. No painel de navegação à esquerda, escolha API. No canto superior direito, clique em Create API.
Clique em Import Ingress no cartão HTTP API.
-
Na seção HTTP API, clique em Import Ingress. Na página Import Ingress, configure os parâmetros do Ingress e clique em OK.
Item de configuração
Descrição
API Name
Nome da API. Você também pode clicar em Add Description para adicionar uma descrição ao roteamento.
Description
Descrição da API. Pode ter até 255 caracteres.
Instance
Selecione a instância do Cloud-native API Gateway.
Source Cluster
A origem do service é o cluster do Container Service onde o Ingress reside.
resource
Selecione o grupo de recursos.
Namespace
O namespace a ser monitorado. Se deixado em branco, o gateway monitorará recursos de Ingress em todos os namespaces.
IngressClass
A IngressClass a ser monitorada. Se deixado em branco, o gateway monitorará todos os tipos de recursos de Ingress.
Update Ingress Status
Ao ativar este recurso, o Status Endpoint no Ingress monitorado será substituído pelo endpoint de entrada do gateway.