Adjunta y configura políticas en la IU

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

Consulta la documentación de Apigee Edge.

Agregar capacidades basadas en políticas a un proxy de API es un proceso de dos pasos:

1. Configura una instancia de un tipo de política
2. Adjunta la instancia de política a un flujo

En el siguiente diagrama, se muestra la relación entre las políticas y los flujos. Como puedes ver, una política se adjunta a un flujo como un paso de procesamiento. A fin de configurar el comportamiento deseado para tu API, debes comprender un poco sobre los flujos. (Este tema se explicó antes en Configura flujos).

Un tipo de política que se usa con frecuencia es la política SpikeArrest. SpikeArrest evita los aumentos repentinos en el tráfico de los mensajes que podrían saturar los servicios de backend.

Conecta una política a un flujo

Nota: Apigee presenta una versión nueva del Editor de proxies, que facilitará la edición de los proxies.

En las instrucciones de las dos primeras pestañas a continuación, se explica cómo usar el Editor de proxies nuevo o el clásico.

Editor de proxies nuevo

Para conectar una política a un flujo, haz lo siguiente:

1. Selecciona un proxy de API y navega a la vista Develop.
2. En el panel de la izquierda, haz clic en el botón + en la fila Políticas.

3. En laCrear política haz clic en elSelecciona un tipo de política y desplázate hacia abajo hastaAdministración del tráfico y seleccioneProtección contra aumentos de tráfico.

4. De manera opcional, puedes cambiar el Nombre visible y el Nombre de la política.

   

   Cuando hayas terminado, haz clic en Crear para crear la política.

5. Ahora que creaste la política de Spike Arrest, puedes agregarla a un paso en el PreFlow. Para hacerlo, selecciona Proxy Endpoints > default > PreFlow en el panel izquierdo:

   

6. Haz clic en el botón + junto a PreFlow en el panel Respuesta en la esquina inferior derecha del editor visual:

   

7. En el cuadro de diálogo Agregar paso de la política, selecciona la política Spike Arrest.

8. Haz clic en Agregar para adjuntar la política.

   La política de Spike Arrest se muestra en el panel Respuesta:

   

   El siguiente código XML para el proxy se muestra en el editor de texto:

   <ProxyEndpoint name="default">
     <PreFlow name="PreFlow">
       <Request/>
       <Response>
         <Step><
           <Name>SA-</Name>
         </Step>
       </Response>
     </PreFlow>
     <Flows/>
     <PostFlow name="PostFlow">
       <Request/>
       <Response/>
     </PostFlow>
     <HTTPProxyConnection>
       <BasePath>/myproxy</BasePath>
     </HTTPProxyConnection>
     <RouteRule name="default">
       <TargetEndpoint>default</TargetEndpoint>
     </RouteRule>
   </ProxyEndpoint>
     

Desconecta políticas de un flujo

Para desconectar una política de un flujo, haz clic en el menú de tres puntos junto al flujo y selecciona Borrar paso de la política

Editor de proxies clásico

Para conectar una política a un flujo, haz lo siguiente:

1. Selecciona un proxy de API y navega a la vista Develop.
2. En el editor de proxy de API, selecciona el flujo al que deseas conectar una política en el panel de navegación.
   Por ejemplo, el flujo PreFlow se selecciona para el extremo del proxy de API predeterminado en la siguiente figura:
   
3. En la vista de diseño, haz clic en +Paso asociado con el flujo de solicitud o respuesta para conectar una política. Por ejemplo:
   
   Se abrirá el cuadro de diálogo Agregar paso que mostrará una lista clasificada de políticas.
   
4. Desplázate y selecciona el tipo de política que deseas conectar al flujo seleccionado.
5. Modifica los siguientes campos.

   • Nombre visible: Nombre visible único para la política. La IU generará un nombre predeterminado, pero se recomienda crear un nombre descriptivo para la política. Esto garantizará que otros desarrolladores de tu organización puedan comprender con facilidad lo que está destinado a hacer la política.

   • Nombre: Nombre único para la política. El nombre de la política coincide con el nombre visible, con las siguientes excepciones:

     • Los espacios se reemplazan por guiones.

     • Los guiones consecutivos se reemplazan por un solo guion.

     • A excepción de los guiones, guiones bajos y espacios (que se reemplazan, como se indica arriba), se quitan los caracteres que no son alfanuméricos, como signos numerales, signos de porcentaje, signos “&”, etc.

6. Haga clic en Add.

   La política se conecta al flujo seleccionado.

Una vez que se conecte la política, verás la política en la vista Diseñador para el flujo, en este ejemplo el PreFlow del extremo predeterminado del proxy y en la lista Políticas que se encuentra en el panel de navegación. La vista Código, que muestra el XML de la política recién conectada, se muestra debajo de la vista Diseñador. Edge genera una instancia de la política que contiene un conjunto de valores predeterminados razonables.

Agrega una política sin conectarla a un flujo

Para agregar una política sin conectarla a un flujo, que es útil para solucionar fallas, haz clic en + en la barra Políticas en la vista Navegador para abrir el diálogo Agregar política y agrega la política (como se describe en los pasos 4 a 6 en la sección anterior).

Una política que no está conectada a ningún flujo se marca con el ícono de desconectado en la lista de políticas, como se muestra junto a la política de mensaje de clave de API en la figura anterior.

Después de crear la política, puedes conectarla a un flujo si la arrastras y la sueltas desde la lista Políticas al flujo deseado en la vista Diseñador.

Desconecta políticas de un flujo

Para desconectar una política de un flujo, selecciona el flujo. Coloca el cursor sobre el ícono de la política en la vista Designer del flujo. Haz clic en la X del círculo que aparece en el ícono.

Borra una instancia de política

Para borrar una instancia de política, coloca el mouse sobre la entrada de la política en la vista Navigator. Haz clic en la X del círculo que aparece a la derecha de la entrada.

Configura políticas en la IU

Cuando la IU genera una instancia de política, aplica valores predeterminados razonables a las opciones de configuración comunes. Es posible que debas modificar esta configuración para cumplir con los requisitos.

Por ejemplo:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<SpikeArrest async="false" continueOnError="false" enabled="true" name="spikearrest-1">
  <DisplayName>SpikeArrest-1</DisplayName>
  <FaultRules/>
  <Properties/>
  <Identifier ref="request.header.some-header-name"/>
  <MessageWeight ref="request.header.weight"/>
  <Rate>30ps</Rate>
</SpikeArrest>

Para configurar una política, edita directamente su configuración XML en la vista Code. Por ejemplo, la tasa máxima de mensajes para la política de Spike Arrest se establece inicialmente en 30 mensajes por segundo. Puedes cambiar la tasa máxima si cambias el valor del elemento <Rate> en el XML de la política. Para obtener más detalles sobre la configuración de políticas, consulta la Referencia de políticas.

También puede cortar y pegar políticas en la vista Code. Esta es una excelente manera de volver a usar las políticas de las muestras disponibles en GitHub.

Cuando realizas cambios en la definición de una política en la vista Code, los cambios se reflejan en Property Inspector. Lo contrario también es cierto: realiza cambios en Property Inspector y aparecerán en el XML, en la vista Code.

Si deseas ver la documentación específica de la política de cuotas que se usa en este tema, consulta Política de cuotas.