Criação de um grupo de APIs
Um grupo de APIs contém APIs usadas para o mesmo serviço. Você pode gerenciar APIs por grupo e deve criar um grupo antes de criar uma API.
Você pode criar um grupo de APIs usando os seguintes métodos:
- Criação de um grupo de APIs diretamente
Você pode criar APIs para o grupo conforme necessário.
- Importação de um arquivo de design de API
Importe um arquivo de API para criar um grupo.
- Importação de uma carga de trabalho do CCE
Ao importar cargas de trabalho do Cloud Container Engine (CCE), você pode abrir seus recursos de serviço CCE. Para mais detalhes, consulte Importação de uma carga de trabalho do CCE.
- Para disponibilizar suas APIs para acesso dos usuários, vincule nomes de domínio independentes ao grupo ao qual as APIs pertencem.
- Cada API pode pertencer a apenas um grupo.
- O sistema aloca automaticamente um nome de subdomínio para cada grupo de APIs para testes internos. O nome do subdomínio pode ser acessado 1000 vezes por dia. Você também pode desativar a opção Depuração de nome de domínio. Quando desativada, a depuração de nome de domínio fica oculta e as APIs não podem ser chamadas por meio dela.
- O grupo de APIs DEFAULT é gerado automaticamente para cada gateway. As APIs neste grupo podem ser chamadas usando o endereço IP da Virtual Private Cloud (VPC) onde o gateway está implementado.
Pré-requisitos
Você criou um gateway.
Criação de um grupo de APIs diretamente
- Vá para o console do APIG.
- Selecione um gateway dedicado na parte superior do painel de navegação.
- Escolha API Management > API Groups.
- Escolha Create API group > Create Directly e insira as informações do grupo.
Tabela 1 Informações do grupo Parâmetro
Descrição
Name
Nome do grupo de APIs.
Description
Descrição do grupo de APIs.
- Clique em OK.
Importação de um arquivo de design de API
- Vá para o console do APIG.
- Selecione um gateway dedicado na parte superior do painel de navegação.
- Escolha API Management > API Groups.
- Escolha Create API Group > Import API Design File.
- Selecione um arquivo de API e clique em Open.
- Defina os parâmetros de importação.
Tabela 2 Parâmetros para importar APIs Parâmetro
Descrição
Import
Opções:
- New group: importar APIs para um novo grupo de APIs. Se você selecionar essa opção, o sistema criará automaticamente um grupo de APIs e importará as APIs para esse grupo.
- Existing group: importar APIs para um grupo de APIs existente. Se você selecionar essa opção, o sistema adicionará as APIs ao grupo de APIs selecionado, mantendo as APIs existentes no grupo de APIs.
API group
Selecione um grupo de API se você definir Import para Existing group.
Basic Definition Overwrite
Determine se deve substituir uma API existente se o nome da API for o mesmo de uma API importada.
Este parâmetro está disponível somente se você definir Import para Existing group.
Extended Definition Overwrite
Se essa opção estiver selecionada, os itens de definição estendida (controle de acesso e políticas de limitação de solicitações) de uma API importada substituirão as políticas existentes com o mesmo nome.
- (Opcional) Para configurar as APIs, clique em Configure Global Settings.
- Altere o modo de autenticação. Para mais detalhes, consulte 5.b.
- Modifique a configuração da solicitação de back-end. Para mais detalhes, consulte 1.
- Clique em Next. Você pode visualizar os detalhes de configuração no formato de formulário, JSON ou YAML.
- Confirme as configurações e clique em Submit.
- Clique em Import Now e determine se deseja publicar as APIs.
- Now: publicar as APIs em um ambiente especificado agora.
- Later: publicar as APIs mais tarde.
- Clique em OK. A guia APIs é exibida, mostrando as APIs importadas.
Operações de acompanhamento
Depois que um grupo de APIs for criado, vincule nomes de domínio independentes a ele para que os chamadores da API possam usá-los para chamar APIs abertas no grupo.