Criar uma configuração de API
Esta página descreve como criar uma configuração da API para implementar no API Gateway.
Antes de começar
Antes de criar uma configuração de API, confirme que tem:
Preparou o seu ambiente de desenvolvimento conforme descrito em Configurar o ambiente de desenvolvimento.
Criou uma definição de API como uma especificação OpenAPI.
Criou opcionalmente uma API, conforme descrito em Criar uma API. Se a API ainda não existir, a criação da configuração da API cria-a.
Requisitos do ID de configuração da API
Muitos dos comandos gcloud apresentados neste tutorial requerem que especifique o ID da configuração da API no formato: CONFIG_ID.
O API Gateway aplica os seguintes requisitos ao ID de configuração da API:
- Tem de ter um comprimento máximo de 63 carateres.
- Tem de conter apenas letras minúsculas, números ou travessões.
- Não pode começar com um traço.
- Não pode conter um sublinhado.
Criar uma configuração de API
Use a CLI Google Cloud para carregar a definição da API e criar uma configuração da API. Quando carrega a definição da API, tem de especificar o nome da API. Se a API ainda não existir no API Gateway, este comando também a cria.
Para criar uma configuração de API:
Altere o diretório para o diretório que contém a definição da API.
Para saber mais sobre como criar a especificação OpenAPI para a definição da sua API, consulte a vista geral da OpenAPI e o guia de início rápido: implemente uma API no API Gateway.
Para mais informações sobre como criar uma definição e uma configuração de serviço gRPC para a sua definição de API, consulte os artigos Configurar um serviço gRPC e Introdução ao API Gateway e ao Cloud Run para gRPC.
Valide o ID do projeto devolvido pelo comando seguinte para se certificar de que o serviço não é criado no projeto errado.
gcloud config list project
Se precisar de alterar o projeto predefinido, execute o seguinte comando e substitua PROJECT_ID pelo Google Cloud ID do projeto Google Cloud no qual quer criar o serviço: