Agregar funciones con 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 con políticas 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 permitirle agregar de manera eficiente y confiable tipos comunes de capacidades de administración a una API.

Las políticas proporcionan funciones como seguridad, limitación de velocidad, transformación y capacidades de mediación, lo que le evita tener que crear y mantener el código por su 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. Dependiendo del tipo de política, es posible que deba crear un recurso, como se describe en Administrar recursos. También consulta Administra carpetas y archivos en un lugar de trabajo de Apigee.

Crear una política

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

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

    Adjuntar a Acción
    proxy de API Realiza una de las siguientes acciones:
    • Coloque el cursor sobre una de las siguientes carpetas, haga clic en Ícono de Crear política de Apigee y seleccione 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 Ícono de proxy de API.
    Flujo compartido Realiza una de las siguientes acciones:
    • Coloque el cursor sobre una de las siguientes carpetas, haga clic en Crea el ícono de flujo compartido y seleccione 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 el í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. Cree recursos si así lo requiere el tipo de política, como se describe en Administrar recursos.

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