Añadir funciones mediante políticas

Esta página se aplica a Apigee y Apigee Hybrid.

Consulta la documentación de Apigee Edge.

Apigee te permite programar el comportamiento de las APIs sin tener que escribir código mediante políticas. Una política es como un módulo que implementa una función de gestión específica y limitada. Las políticas se han diseñado para que puedas añadir de forma eficiente y fiable tipos comunes de funciones de gestión a una API.

Las políticas proporcionan funciones como seguridad, limitación de frecuencia, transformación y mediación, lo que te ahorra tener que crear y mantener el código por tu cuenta. No tienes por qué limitarte al conjunto de tipos de políticas que proporciona Apigee. También puedes escribir secuencias de comandos y código personalizados (como aplicaciones JavaScript) que amplíen las funciones del proxy de API y te permitan innovar a partir de las funciones de gestión básicas que admiten las políticas de Apigee.

Crea y asigna políticas a proxies de API y flujos compartidos mediante Apigee en Cloud Code, tal como se describe en las siguientes secciones. En función del tipo de política, es posible que tengas que crear un recurso, tal como se describe en Gestionar recursos. Consulta también Gestionar carpetas y archivos en un espacio de trabajo de Apigee.

Crear una política

Para crear una política con Apigee en Cloud Code, sigue estos pasos:

  1. En tu espacio de trabajo de Apigee, realiza una de las siguientes acciones en función de dónde quieras adjuntar la política:

    Adjuntar a Acción
    proxy de API Realiza una de las siguientes acciones:
    • Coloca el cursor sobre una de las siguientes carpetas, haz clic en Icono de crear política de Apigee y selecciona Crear política:
      • Paquete de proxy apiproxy-name
      • apiproxy-name/apiproxy
    • Coloca el cursor sobre la carpeta apiproxy-name/apiproxy/policies del proxy de API y haz clic en Icono Crear proxy de API.
    Flujo compartido Realiza una de las siguientes acciones:
    • Coloca el cursor sobre una de las siguientes carpetas, haz clic en Crear icono de flujo compartido y selecciona Crear política:
      • sharedflow-name paquete de flujo compartido
      • sharedflow-name/sharedflowbundle
    • Coloca el cursor sobre la carpeta sharedflow-name/sharedflowbundle/policies del flujo compartido y haz clic en Crear icono de flujo compartido.

Se abrirá el asistente para crear políticas.

  1. Selecciona la categoría de la política que quieras crear en la lista. Para ver una descripción de las categorías de políticas, consulta el artículo Descripción general de la referencia de las políticas.

  2. Introduce un nombre único para la política y pulsa Intro. La política se añade a la carpeta /policies del proxy de API o del flujo compartido en la sección Apigee y se abre en el editor.

  3. Edita el archivo como quieras y selecciona Archivo > Guardar o ⌘S para guardar los cambios. Para obtener más información sobre cómo configurar la política, consulta la descripción general de la referencia de la política.

  4. Crea recursos si el tipo de política lo requiere, tal como se describe en Gestionar recursos.

Vincular una política a un flujo

Las políticas no se ejecutan hasta que se adjuntan a un flujo. Para adjuntar una política a un flujo, añada el elemento <Step> al elemento de flujo de solicitud o respuesta adecuado en una configuración de ProxyEndpoint o TargetEndpoint, tal como se describe en los siguientes temas:

Por ejemplo, la siguiente configuración asocia una QuotaPolicy al <PreFlow> de ProxyEndpoint para configurar el número de mensajes de solicitud que permite un proxy de API durante un periodo.

<ProxyEndpoint name="default">
  <PreFlow>
    <Request>
      <Step><Name>QuotaPolicy</Name></Step>
    </Request>
  </PreFlow>
  <HTTPProxyConnection>
    <BasePath>/weather</BasePath>
  </HTTPProxyConnection>
  <RouteRule name="default">
    <TargetEndpoint>default</TargetEndpoint>
  </RouteRule>
</ProxyEndpoint>