Agregar 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 la API mediante policies sin escribir código. Una política es como un módulo que implementa una función de administración específica y limitada. Las políticas están diseñadas para permitirte agregar tipos comunes de capacidades de administración a una API de forma eficiente y confiable.

Las políticas proporcionan funciones como la seguridad, los límites de frecuencia, la transformación y la mediación, lo que evita que tengas que compilar y mantener el código por tu cuenta. No estás limitado al conjunto de tipos de políticas que proporciona Apigee. También puedes escribir secuencias de comandos y códigos personalizados (como aplicaciones JavaScript) que extienden la funcionalidad del proxy de API y te permiten innovar con las capacidades de administración básicas compatibles con las políticas de Apigee.

Crea y adjunta políticas de proxies de API y flujos compartidos mediante Apigee en Cloud Code, como se describe en las siguientes secciones. Según el tipo de política, es posible que debas crear un recurso, como se describe en Administra recursos. También consulta Administra carpetas y archivos en un lugar de trabajo de Apigee.

Crea una política

Para crear una política mediante Apigee en Cloud Code, haz lo siguiente:

  1. En tu lugar de trabajo de Apigee, realiza una de las siguientes acciones en función del lugar en el que deseas 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 Ícono para crear una política de Apigee y selecciona Crear política:
      • Paquete del proxy apiproxy-name
      • apiproxy-name/apiproxy
    • Coloca el cursor sobre la carpeta apiproxy-name/apiproxy/policies del proxy de API y haz clic en Crea un ícono de proxy de API.
    Flujo compartido Realiza una de las siguientes acciones:
    • Coloca el cursor sobre una de las siguientes carpetas, haz clic en Crea un ícono 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 para el flujo compartido y haz clic en Crea un ícono de flujo compartido.

Se abrirá el asistente de creación de políticas.

  1. Selecciona la categoría de la política que deseas crear de la lista. Para obtener una descripción de las categorías de la política, consulta Descripción general de la referencia de la política.

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

  3. Edita el archivo, según sea necesario, y selecciona Archivo > Guardar o ⌘S para guardar las ediciones. Para obtener más información sobre la configuración de la política, consulta Descripción general de la referencia de la política.

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

Conecta una política a un flujo

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

Por ejemplo, la siguiente configuración adjunta una QuotaPolicy a la <PreFlow> del ProxyEndpoint para configurar la cantidad de mensajes de solicitud que permite un proxy de API durante un período.

<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>