Começar a usar o gcloud com o Apigee

Esta página aplica-se ao Apigee e ao Apigee Hybrid.

Veja a documentação do Apigee Edge.

A CLI gcloud apigee permite-lhe realizar as seguintes ações:

  • Veja proxies de API
  • Crie e faça a gestão de produtos de API
  • Implemente e anule a implementação de proxies de API, e veja os detalhes da implementação
  • Veja informações sobre programadores e apps
  • Indique os seus ambientes e organizações
  • Faça a gestão de aplicações de terceiros que chamam proxies de API do Apigee

Além disso, a CLI gcloud beta apigee permite-lhe implementar e gerir arquivos no seu ambiente do Apigee.

As secções seguintes descrevem como instalar, autorizar e usar as CLIs gcloud apigee e gcloud beta apigee e, opcionalmente, definir variáveis de ambiente.

Antes de começar

Certifique-se de que cumpriu os pré-requisitos para usar o Apigee, incluindo a instalação do SDK do Google Cloud.

Instalar os componentes beta do gcloud apigee

Para aceder aos comandos gcloud beta apigee, tem de instalar o componente beta do gcloud completo, da seguinte forma:

gcloud components install beta

Para confirmar que o componente beta foi instalado, introduza o seguinte comando:

gcloud components list

Deverá ver o componente beta na lista, da seguinte forma:

Estado Nome ID Tamanho
Instalado Comandos gcloud Beta beta < 1 MiB

Para mais informações, consulte o artigo Gerir componentes do SDK.

Autorizar o acesso ao gcloud

Autorize o acesso à gloud CLI seguindo os passos descritos no artigo Autorizar ferramentas do SDK Cloud.

Por exemplo, para autorizar o acesso através da sua conta de utilizador e executar outros passos de configuração comuns do Cloud SDK, use o seguinte comando: 

gcloud init

Siga as instruções para autenticar a conta, conceder autorizações de acesso e inicializar a instalação do SDK do Google Cloud, conforme descrito no artigo Inicializar o SDK do Google Cloud.

Em alternativa, para autorizar o acesso sem efetuar qualquer configuração adicional, use o seguinte comando: 

gcloud auth login

Siga o fluxo de autorização baseado no navegador para autenticar a conta e conceder autorizações de acesso.

Para mais informações sobre a autorização e a revogação do acesso à CLI gcloud, consulte o artigo Credenciais.

Definir variáveis de ambiente para comandos gcloud

Os exemplos da API Apigee e da CLI gcloud fornecidos ao longo da documentação usam uma ou mais das variáveis de ambiente definidas na tabela seguinte.

Ao definir as variáveis de ambiente antecipadamente para valores significativos no seu ambiente, pode copiar e colar os pedidos de exemplo para os executar no seu próprio ambiente com modificações mínimas ou nulas.

Variável de ambiente Descrição
$API Nome do proxy de API.
$APIPRODUCT Nome do produto API.
$APP ID de uma app.
$DEVELOPER_EMAIL Endereço de email do programador.
$ENV Nome do seu ambiente, como test ou prod.
$ID ID do recurso.
$KEY Chave de consumidor.
$NAME Nome do recurso.
$ORG A sua organização do Apigee.
$REV Número de revisão do proxy de API.
$SHAREDFLOW Nome do fluxo partilhado.
$TYPE Tipo de recurso.

Usar a CLI gcloud

Use a CLI gcloud da seguinte forma: 

gcloud apigee GROUP [GCLOUD_WIDE_FLAG …]

Para mais informações sobre os grupos de comandos e as flags disponíveis, consulte gcloud apigee.

Por exemplo, o seguinte comando apresenta os proxies de API na sua organização: 

gcloud apigee apis list --organization=$ORG

Segue-se um exemplo da resposta para a organização my-org: 

Using Apigee organization `myorg`
 - hello-world
 - weather-app

Mais informações

Para mais informações, consulte: