Límite de velocidad

Utilice la política Límite de velocidad para aplicar uno o más límites de velocidad, separación o recuento en cualquier punto del flujo de ensamblaje de API. Los límites de velocidad y ráfaga limitan el número de llamadas efectuadas a una API durante un período de tiempo especificado, mientas que los límites de recuento imponen un límite estricto sobre el número total de llamadas.

Soporte de pasarela

Tabla 1. Tabla que muestra qué puertas de enlace admiten esta política y la versión correspondiente de la misma
Pasarela Versión de política
DataPower® API Gateway 2.0.0

2.1.0 (DataPower API Gateway Versión 10.0.1.0 o posterior)

2.2.0 (DataPower API Gateway Versión 10.0.2.0 o posterior)

2.3.0 (DataPower API Gateway Versión 10.5.0.0

En este tema se describe cómo configurar la política en la interfaz de usuario de Assembly; para obtener más información sobre cómo configurar la política en su código fuente de OpenAPI, consulte ratelimit.

Acerca de

Los límites de velocidad, ráfaga y recuento definidos se aplican a lo que sigue en el flujo de ensamblaje. Por ejemplo, si una política Límite de velocidad se coloca antes de una política Invocar y la llamada realizada por la política Invocar sobrepasa los límites definidos por la política Límite de velocidad , la propia llamada de API falla.

Nota: Para obtener información sobre los límites de velocidad y los límites de separación en API ConnectAI Gateway, consulte Visión general de los límites de velocidad para las API y los planes.

Propiedades

En la tabla siguiente se listan las propiedades de política, se indica si se requiere una propiedad, y se especifica los valores válidos y predeterminados para la entrada, así como el tipo de datos de los valores.

Tabla 2. Propiedades de la política de limitación de solicitudes
Etiqueta de propiedad Obligatorio Descripción Tipo de datos
Título Nee El título de la política.

El valor predeterminado es ratelimit.

serie
Descripción Nee Una descripción de la política. serie
Origen La ubicación de todas las definiciones de límite de velocidad, límite de ráfaga y límite de recuento que se incluyen en esta política. Seleccione una de las opciones que aparecen continuación:
  • Catálogo por nombre: los límites que se deben aplicar se definen en el objeto api-collection adecuado en DataPower API Gateway, que es el objeto que representa el catálogo de API Connect en la configuración de pasarela.

    Para obtener más información sobre cómo configurar un límite de velocidad, ráfaga o recuento en el api-collection objeto, consulte «Configuración de un límite de velocidad, ráfaga o recuento» en DataPower API Gateway.

  • Plan por nombre: los límites que se deben aplicar son los límites de ráfaga de ensamblaje o los límites de recuento de ensamblaje definidos en el plan al que se ha suscrito la aplicación de llamada. Para obtener detalles sobre cómo configurar límites de separación de ensamblaje y límites de recuento de ensamblaje en un plan, consulte Edición de un borrador de producto.
    Nota: Las condiciones siguientes se aplican a una política de límite de velocidad de Plan por nombre :
    • Cada plan que contiene la API que se está limitando debe tener aplicado el límite de velocidad especificado.
    • Una política de límite de velocidad Plan por nombre no se puede utilizar con productos generados automáticamente.
  • Pasarela por nombre: los límites que se deben aplicar se definen en el objeto apigw , denominado apiconnect, en la pasarela DataPower API Gateway .

    Para obtener más información sobre cómo configurar un límite de velocidad, ráfaga o recuento en el apigw objeto, consulte «Configuración de un límite de velocidad, ráfaga o recuento» en DataPower API Gateway.

  • Valor predeterminado de plan: los límites de velocidad y ráfaga que se aplican son los predeterminados configurados en el plan al que se ha suscrito la aplicación de llamada. Para obtener detalles sobre cómo configurar la velocidad del plan predeterminada y los límites de separación, consulte Edición de un borrador de producto.
    Nota: El uso de esta opción no inhabilita ninguna política de límite de velocidad de preflujo automática que pueda estar en vigor y podría hacer que la aplicación de la limitación de velocidad se repita. Para obtener más información sobre las políticas de preflujo, consulte la sección «Personalización de las políticas de preflujo ».
serie
Nombre de límite de velocidad: 1 Si la propiedad Origen se establece en Catálogo por nombre, el nombre de un límite de velocidad tal como se define en la configuración de DataPower API Gateway ,

Para visualizar el campo Nombre de límite de velocidad, pulse Añadir límite de velocidad; puede añadir tantos límites de velocidad como desee.

1 Debe proporcionar como mínimo un límite de velocidad, ráfaga o recuento.

serie
Nombre de límite de ráfaga 2 Si la propiedad Origen se establece en Catálogo por nombre, el nombre de un límite de separación tal como se define en la configuración de DataPower API Gateway .

Si Origen se establece en Plan por nombre, nombre de un límite de ráfaga de ensamblaje en un plan.

Para visualizar el campo Nombre de límite de ráfaga, pulse Añadir límite de ráfaga; puede añadir tantos límites de ráfaga como desee.

2 Debe proporcionar como mínimo un límite de velocidad, ráfaga o recuento.

serie
Nombre de límite de recuento 3 Si la propiedad Origen se establece en Catálogo por nombre, el nombre de un límite de recuento tal como se define en la configuración de DataPower API Gateway .

Si Origen se establece en Plan por nombre, nombre de un límite de recuento de ensamblaje en un plan.

Para visualizar el campo Nombre de límite de recuento, pulse Añadir límite de recuento; puede añadir tantos límites de recuento como desee.

3 Debe proporcionar como mínimo un límite de velocidad, ráfaga o recuento.

serie
Operación Nee Para un límite de velocidad, seleccione una de las opciones siguientes:
  • Consume: la política reduce el saldo de las solicitudes disponibles que permanecen en el intervalo definido por el límite de velocidad especificado en el campo Nombre de límite de velocidad.

    La cantidad en la que se reduce el saldo restante es el valor resultante de la expresión de ponderación definida en el límite de velocidad especificado.

  • Replenish: la política aumenta el saldo de las solicitudes disponibles que permanecen en el intervalo definido por el límite de velocidad especificado en el campo Nombre de límite de velocidad.

    La cantidad en la que aumenta el saldo restante es el valor resultante de la expresión de ponderación definida en el límite de velocidad especificado.

    La finalidad de la operación replenish es restaurar una cantidad adecuada de saldo restante en los casos en que la cantidad calculada por una operación consume anterior resulta ser demasiado alta. Por ejemplo, para un límite de velocidad de ensamblaje con un límite de 100, una operación consume con una ponderación de 60 utiliza 60 solicitudes, dejando 40 solicitudes para el intervalo. Si la expresión de ponderación de la operación replenish subsiguiente se calcula en 15, lo que significa que la expresión de ponderación ha calculado que el uso real de solicitudes era de sólo 45, la operación replenish aumenta las solicitudes restantes en 15, hasta un saldo restante de 55.

    Tenga en cuenta que la operación replenish no puede aumentar las solicitudes restantes permitidas más allá del límite original definido en el esquema de límite de velocidad de ensamblaje. En este ejemplo, una operación replenish no puede reponer solicitudes más allá de 100. Una operación replenish se omite si la expresión de ponderación se evalúa como un valor inferior a 1.

    El valor predeterminado es Consume.

Para un límite de recuento, seleccione una de las opciones siguientes:
  • Incrementar: el recuento actual aumenta en el valor que resulta de la expresión de ponderación definida en el límite de recuento especificado en el campo Nombre de límite de recuento.
  • Disminuir: el recuento actual disminuye en el valor que resulta de la expresión de ponderación definida en el límite de recuento especificado en el campo Nombre de límite de recuento.

De forma predeterminada, el límite de recuento disminuye automáticamente al final del ensamblaje de API en la cantidad total incrementada durante el ensamblaje, menos las operaciones de disminución definidas en el ensamblaje. No es necesario definir explícitamente las operaciones de disminución, a menos que desee que las disminuciones se produzcan en puntos específicos del ensamblaje. Sin embargo, si la función de disminución automática se ha inhabilitado explícitamente en la configuración del límite de recuento, debe incluir una operación de disminución correspondiente; de lo contrario, cuando se alcance el límite de recuento, se bloquearán todas las llamadas futuras. Para obtener más información sobre cómo configurar un límite de recuento, consulte «Configuración de un límite de velocidad, ráfaga o recuento» en DataPower API Gateway.

El valor predeterminado es Increment.

Para un límite de ráfaga, la única opción posible es Consume, lo que significa que el límite aplicado es el definido en el límite de ráfaga especificado en el campo Nombre de límite de ráfaga.

serie