Vinculación de una política de limitación de solicitudes
Función
La política de limitación de solicitudes vinculada a una API controlará todo el acceso a la API. Si el número de invocaciones a la API dentro de un período especificado alcanza el límite, se rechazará el acceso posterior, protegiendo la API de backend del tráfico anormal y asegurando un funcionamiento estable del servicio.
Esta API se utiliza para vincular una política de limitación de solicitudes a una API que se ha publicado en un entorno.
Puede vincular diferentes políticas de limitación de solicitudes a una API en entornos diferentes, pero solo puede vincular una política de limitación de solicitudes a la API en cada entorno.
URI
La siguiente tabla muestra el método de solicitud HTTP/HTTPS y el URI de la API.
|
Método de solicitud |
URI |
|---|---|
|
POST |
/v1.0/apigw/throttle-bindings |
Solicitud
|
Parámetro |
Obligatorio |
Tipo |
Descripción |
|---|---|---|---|
|
publish_ids |
Sí |
Array of strings |
ID de registro de publicación de API |
|
strategy_id |
Sí |
String |
ID de una política de limitación de solicitudes |
Ejemplo de solicitud:
{
"publish_ids": [
"374a6d5a-20c7-4ea1-82e1-19fce4556956",
"65e6fe53-1ac3-4481-ba36-9f0bc6f22057"
],
"strategy_id": "0325b671-2d50-4614-9868-22102262695d"
}
Respuesta
|
Parámetro |
Tipo |
Descripción |
|---|---|---|
|
throttle_applys |
Dictionary |
Lista de vinculación |
|
Parámetro |
Tipo |
Descripción |
|---|---|---|
|
id |
String |
ID de vinculación |
|
strategy_id |
String |
ID de una política de limitación de solicitudes |
|
publish_id |
String |
ID de registro de publicación de API |
|
scope |
Integer |
Alcance de la política de limitación de solicitudes, que puede ser:
Actualmente, solo se admite 1. |
|
apply_time |
Timestamp |
Hora en la que la política de limitación de solicitudes está vinculada a la API |
Ejemplo de respuesta:
{
"throttle_applys": [{
"id": "507c6a9f-8322-4dc2-8ba5-b4d74e3690d3",
"strategy_id": "0325b671-2d50-4614-9868-22102262695d",
"publish_id": "374a6d5a-20c7-4ea1-82e1-19fce4556956",
"scope": 1,
"apply_time": "2017-12-29T03:01:11.138456Z"
},
{
"id": "90f05978-06a3-4096-8bea-b5e2fa12b843",
"strategy_id": "0325b671-2d50-4614-9868-22102262695d",
"publish_id": "65e6fe53-1ac3-4481-ba36-9f0bc6f22057",
"scope": 1,
"apply_time": "2017-12-29T03:01:11.138456Z"
}]
}
Códigos de estado
|
Código de estado |
Descripción |
|---|---|
|
201 |
Created |
|
400 |
Bad Request |
|
401 |
Unauthorized |
|
403 |
Forbidden |
|
404 |
Not Found |
|
500 |
Server Internal Error |