Anular a implementação de um proxy de API

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

Veja a documentação do Apigee Edge.

Nota: para anular a implementação de proxies de API em ambientes ativados para implementações de arquivo, consulte o artigo Implementar e gerir arquivos num ambiente do Apigee.

Anule a implementação de uma revisão do proxy de API do seu cluster, conforme descrito nas secções seguintes.

Tenha em atenção que, quando anula a implementação de uma revisão:

• O Apigee não reverte a revisão para a revisão implementada anteriormente.
• Após a anulação da implementação, não são implementadas revisões do proxy de API no ambiente.

A anulação da implementação de um proxy de API é semelhante à eliminação de um proxy de API, exceto que, quando anula a implementação de uma revisão, pode optar por editá-la na IU e implementá-la novamente mais tarde. Se eliminar o proxy de API, este deixa de estar disponível para edição.

Nota: a Apigee vai introduzir uma nova versão do editor de proxies, o que vai facilitar a gestão de proxies.

As instruções nos dois primeiros separadores abaixo explicam como usar o novo editor de proxies ou o editor de proxies clássico.

Novo editor de proxy

Para anular a implementação de um proxy de API através da IU:

1. Se estiver a usar a IU do Apigee na consola do Google Cloud: selecione Desenvolvimento de proxy > Proxies de API.

   Se estiver a usar a IU do Apigee clássica: selecione Develop > API Proxies e, no painel Proxies, selecione o ambiente para o proxy.

2. Selecione o proxy de API que quer anular a implementação. A IU apresenta a vista Vista geral do proxy de API.

   

3. Passe o cursor do rato sobre o ícone na coluna Estado e selecione Anular implementação:

   

Editor de proxy clássico

Para anular a implementação de um proxy de API através da IU:

1. Inicie sessão na IU do Apigee.
2. Selecione Desenvolver > Proxies de API.

   A IU apresenta uma lista dos proxies de API atuais para o ambiente selecionado:

   

3. Selecione o proxy de API que quer anular a implementação.

   A IU apresenta a vista Vista geral do proxy de API.

4. Na linha do ambiente pretendido, expanda a lista pendente Revisão e selecione Anular implementação:

   

   A IU pede-lhe que confirme a versão que quer anular a implementação:

   

5. Clique em Anular implementação.

   A IU atualiza o estado para mostrar que a revisão foi anulada a implementação do cluster imediatamente:

   

   No entanto, tenha em atenção que o processo de anulação da implementação pode demorar algum tempo (no modelo eventualmente consistente). Na verdade, quando clica em Anular implementação, o Apigee inicia o processo de anulação da implementação da revisão selecionada nesse ambiente no cluster.

   Para ver informações sobre como verificar o estado do proxy não implementado, consulte o artigo Ver o estado da implementação.

Em alternativa, pode anular a implementação da revisão atual que está a editar no separador Desenvolver:

1. Clique na lista pendente Implementar em: env_name:

   

   A IU apresenta uma lista de ambientes. Na coluna Revisão, a IU apresenta a revisão implementada atualmente (ou &emdash;, se não existir nenhuma) e apresenta os botões Implementar revision e Desimplementar.

2. Clique no botão Anular implementação para o ambiente pretendido.

   A IU pede-lhe que confirme a versão que quer anular a implementação:

   

3. Clique no botão Anular implementação.

   A IU atualiza o estado para mostrar que a revisão foi anulada imediatamente. No entanto, o processo de anulação da implementação pode demorar algum tempo (no modelo eventualmente consistente). Quando clica em Anular implementação, o Apigee inicia o processo de anulação da implementação da revisão selecionada nesse ambiente.

API Apigee

Para anular a implementação de um proxy de API, use a seguinte chamada da API:

curl "https://apigee.googleapis.com/v1/organizations/$ORG/environments/$ENV/apis/$API/revisions/$REV/deployments" \
  -X DELETE \
  -H "Authorization: Bearer $TOKEN"

Onde $TOKEN está definido como a sua chave de acesso OAuth 2.0, conforme descrito em Obter uma chave de acesso OAuth 2.0. Para informações sobre as opções de curl usadas neste exemplo, consulte a secção Usar o curl. Para uma descrição das variáveis de ambiente que pode usar, consulte o artigo Definir variáveis de ambiente para pedidos de API Apigee.

Segue-se um exemplo do resultado da resposta (uma resposta vazia):

{}

Para mais informações, consulte a API Undeploy API proxy revision.

gcloud

As secções seguintes fornecem exemplos de utilização de comandos da CLI para anular a implementação de revisões do proxy de API e validar a anulação da implementação.gcloud alpha apigee

• Anular a implementação de uma revisão do proxy de API com a CLI gcloud
• Validar a anulação da implementação de uma revisão do proxy de API através da CLI gcloud

Para mais informações e uma descrição das variáveis de ambiente usadas nos exemplos, consulte o artigo Introdução à utilização do gcloud com o Apigee.

Anular a implementação de uma revisão do proxy de API através da CLI gcloud

Para anular a implementação de uma revisão de proxy de API, use o seguinte comando gcloud:

gcloud alpha apigee apis undeploy $REV --api=$API --environment=$ENV

Segue-se um exemplo da resposta:

Using Apigee organization `my-org`

Validar a anulação da implementação de uma revisão do proxy de API através da CLI gcloud

Para validar que a revisão do proxy de API foi anulada a implementação no ambiente, use o seguinte comando gcloud:

gcloud alpha apigee deployments list --api=$API --environment=$ENV

Segue-se um exemplo da resposta:

Using Apigee organization `my-org`
Listed 0 items.

Para mais informações, consulte o artigo CLI de implementações de listas.