Configure the key-rate-limit plug-in - API Gateway - Centro de documentación de Alibaba Cloud

El complemento key-rate-limit limita la velocidad de las solicitudes con base en valores de clave específicos. Estos valores se obtienen de los parámetros de URL o de los encabezados de solicitud HTTP.

Tipo de complemento

Complemento de limitación de velocidad.

Campos

Campo	Tipo de dato	Obligatorio	Valor predeterminado	Descripción
limit_by_header	string	No. Debe configurar limit_by_header o limit_by_param.	-	El encabezado de solicitud HTTP que proporciona el valor de clave para limitar la velocidad.
limit_by_param	string	No. Debe configurar limit_by_header o limit_by_param.	-	El parámetro de URL que proporciona el valor de clave para limitar la velocidad.
limit_keys	array of object	Sí	-	Las reglas de limitación de velocidad para valores de clave específicos.

Campos del objeto limit_keys:

Elemento de configuración	Tipo de dato	Obligatorio	Valor predeterminado	Descripción
key	string	Sí	-	El valor que se compara con las solicitudes entrantes.
query_per_second	number	No. Debe configurar query_per_second, query_per_minute, query_per_hour o query_per_day.	-	El número máximo de solicitudes permitidas por segundo.
query_per_minute	number	No. Debe configurar query_per_second, query_per_minute, query_per_hour o query_per_day.	-	El número máximo de solicitudes permitidas por minuto.
query_per_hour	number	No. Debe configurar query_per_second, query_per_minute, query_per_hour o query_per_day.	-	El número máximo de solicitudes permitidas por hora.
query_per_day	number	No. Debe configurar query_per_second, query_per_minute, query_per_hour o query_per_day.	-	El número máximo de solicitudes permitidas por día.

Ejemplos

Limite la velocidad de las solicitudes según el valor de clave del encabezado de solicitud x-ca-key.

limit_by_header: x-ca-key
limit_keys:
- key: 102234
  query_per_second: 10
- key: 308239
  query_per_hour: 10

Limite la velocidad de las solicitudes según el valor de clave del parámetro de solicitud apikey.

limit_by_param: apikey
limit_keys:
- key: 9a342114-ba8a-11ec-b1bf-00163e1250b5
  query_per_second: 10
- key: a6a6d7f2-ba8a-11ec-bec2-00163e1250b5
  query_per_minute: 100

Habilite la limitación de velocidad para rutas o nombres de dominio específicos.

Aplique a continuación las configuraciones del complemento a las rutas route-a y route-b:
```
  limit_by_header: x-ca-key
  limit_keys:
  - key: 102234
    query_per_second: 10
```
Aplique a continuación la configuración del complemento a los nombres de dominio *.example.com y test.com:
```
  limit_by_header: x-ca-key
  limit_keys:
  - key: 102234
    query_per_second: 100
```
Nota
- route-a y route-b hacen referencia a las rutas especificadas al crear las rutas de la puerta de enlace. Si una solicitud coincide con alguna de estas rutas, se aplican las reglas correspondientes.
- *.example.com y test.com coinciden con los nombres de dominio de las solicitudes. Si una solicitud coincide con alguno de estos dominios, se aplican las reglas correspondientes.
- Las reglas se aplican en orden secuencial. Si se cumple la primera regla, se ignoran las siguientes.