Etapa 3: usar uma política Extension callout

Você está vendo a documentação do Apigee Edge.
Acesse a documentação da Apigee X. informações

Ao desenvolver um proxy de API, você pode adicionar compatibilidade com uma extensão adicionando uma política Extension callout ao proxy. Se quiser ajuda para criar um proxy simples, consulte Criar seu primeiro proxy.

Quando você adiciona suporte para uma extensão, está associando a política ExtensionHeadline a uma extensão configurada. As configurações dessa extensão definem como ela interage com o recurso de back-end a que está se conectando. É essa extensão configurada especificamente que a política Extension callout integra ao proxy de API.

Para adicionar uma extensão ao proxy de API:

1. Abra o proxy de API no console do Apigee Edge, na visualização Desenvolver.

   Você precisa ser um administrador da organização para criar uma extensão, mas qualquer função do usuário pode adicioná-la a um proxy de API.

2. No painel Navigator, selecione o PreFlow.

   

3. No canto superior direito, clique no botão + Step para adicionar uma política.

   

4. Na caixa de diálogo Add Step, na lista de políticas à esquerda, clique em Extension callout.

   

   Se a política Extension callout não aparecer na lista, verifique se você está usando a nova interface do Edge. Além disso, as extensões da Apigee estão disponíveis atualmente apenas para clientes do Apigee Edge Cloud Enterprise.

5. No painel à direita, selecione as opções para configurar a política:

   Campo	Descrição
   Display Name	Digite o nome de exibição da política.
   Nome	Digite o nome a ser usado para a política de maneira programática. Precisa ser exclusivo no proxy.
   Extensão	Escolha a extensão que será usada. Essa é a extensão que você configurou anteriormente.
   Actions	Selecione a ação "registrar".

6. Clique em Adicionar.
7. Na visualização de fluxo, clique na política para ver o XML de configuração.

   

   Ao adicionar a extensão, você recebe um XML de política de exemplo. Note que ele inclui um esquema que descreve como estruturar a configuração do elemento <Input>. Você pode ignorar o esquema do elemento <Output>, já que não há um corpo de resposta retornado pela ação "log" da extensão.

8. Edite o XML da política para que ele fique assim:

   <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
   <ConnectorCallout async="false" continueOnError="true" enabled="true" name="Extension-Callout-Beta-1">
     <DisplayName>Logging Extension</DisplayName>
     <Connector>my-logging-extension</Connector>
     <Action>log</Action>
     <Input>{
       "logName": "example-log",
       "metadata": {
         "resource": {
           "type": "global",
           "labels": {
             "project_id": "my-gcp-project"
           }
         }
       },
       "message": "This is a test"
     }</Input>
   </ConnectorCallout><!--
   Input JSON Schema for package=gcp-stackdriver-logging version=0.0.4
   {"type":"object","properties":{"logName":{"type":"string"},"metadata":{"type":"string"},"message":{"type":"string"}},"required":["logName","message"]}
   -->
   <!--
   Output JSON Schema for package=gcp-stackdriver-logging version=0.0.4
   {"type":"object","properties":{"content":{"type":"string"}},"required":[]}
   -->

   Aqui, o <Input> define o seguinte:

   • logName é o nome do registro em que a gravação será feita. Se não existir, ele será criado pela extensão.
   • metadata especifica as informações que podem ser usadas para procurar o registro no console do Stackdriver.
   • message é simplesmente a mensagem de registro que você quer gravar.
9. Clique no botão Salvar.

Próxima etapa

Etapa 1 Etapa 2 Etapa 3 Etapa 4: implantar o proxy Etapa 5