Paso 3: Usa una política ExtensionExtension

Estás consultando la documentación de Apigee Edge.
Consulta la documentación de Apigee X.
Información

Cuando desarrollas un proxy de API, puedes agregar compatibilidad con una extensión. Para ello, agrega una política ExtensionExtension al proxy. (Si necesitas ayuda para crear un proxy simple, consulta Cómo compilar tu primer proxy).

Cuando agregas compatibilidad con una extensión, asocias la política ExtensionExtension con una extensión configurada. La configuración de esa extensión define cómo la extensión interactúa con el recurso de backend al que se conecta. Es esta extensión configurada de forma específica la que la política ExtensionExtension integra en el proxy de API.

Para agregar una extensión a tu proxy de API, haz lo siguiente:

  1. Abre tu proxy de API en la consola de Apigee Edge, en la vista Develop.

    Si bien debes ser administrador de la organización para crear una extensión, cualquier rol del usuario puede agregar la extensión a un proxy de API.

  2. En el panel Navigator, selecciona PreFlow.

  3. En la esquina superior derecha, haz clic en el botón + Paso para agregar una política.

  4. En el diálogo Add Step, en la lista de políticas del lado izquierdo, haz clic en Extension Extension.

    Si no ves la política ExtensionExtension en la lista, asegúrate de estar usando la nueva IU de Edge. Además, en la actualidad, las extensiones de Apigee están disponibles solo para los clientes de Cloud Enterprise de Apigee Edge.

  5. En el panel derecho, selecciona las opciones para configurar la política:
    Campo Descripción
    Nombre visible Ingresa el nombre visible de la política.
    Nombre Ingresa el nombre que se usará para la política de manera programática. Debe ser único en el proxy.
    Extensión Elige la extensión que quieres usar. Esta es la extensión que configuraste antes.
    Actions Selecciona la acción “log”.
  6. Haz clic en Agregar.
  7. En la vista de flujo, haz clic en la política para ver su XML de configuración.

    Cuando agregues la extensión, obtendrás un XML de políticas de ejemplo. Ten en cuenta que se incluye un esquema que describe cómo estructurar la configuración del elemento <Input>. (Puedes ignorar el esquema del elemento <Output>, ya que la acción “log” de la extensión no muestra ningún cuerpo de respuesta).

  8. Edita el XML de tu política para que se vea de la siguiente manera:
    <?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":[]}
    -->

    Aquí, <Input> define lo siguiente:

    • logName es el nombre del registro en el que se escribirá. Si no existe, la creará la extensión.
    • metadata especifica la información que puedes usar para buscar el registro en la consola de Stackdriver.
    • message es solo el mensaje de registro que deseas escribir.
  9. Haga clic en el botón Guardar.

Próximo paso

Paso 1 Paso 2 Paso 3 Paso 4: Implementa el proxy Paso 5