Vinculação de uma política de limitação de solicitação
Função
A política de limitação de solicitações vinculada a uma API controlará todo o acesso à API. Se o número de chamadas de API dentro de um período especificado atingir o limite, o acesso subsequente será rejeitado, protegendo a API de back-end de tráfego anormal e garantindo a execução estável do serviço.
Esta API é usada para vincular uma política de limitação de solicitações a uma API que foi publicada em um ambiente.
Você pode vincular diferentes políticas de limitação de solicitações a uma API em ambientes diferentes, mas pode vincular apenas uma política de limitação de solicitações à API em cada ambiente.
URI
A tabela a seguir lista o método de solicitação HTTP/HTTPS e o URI da API.
Método de solicitação |
URI |
---|---|
POST |
/v1.0/apigw/throttle-bindings |
Solicitação
Parâmetro |
Obrigatório |
Tipo |
Descrição |
---|---|---|---|
publish_ids |
Sim |
Array of strings |
ID do registro de publicação da API |
strategy_id |
Sim |
String |
ID de uma política de limitação de solicitações |
Exemplo de solicitação:
{ "publish_ids": [ "374a6d5a-20c7-4ea1-82e1-19fce4556956", "65e6fe53-1ac3-4481-ba36-9f0bc6f22057" ], "strategy_id": "0325b671-2d50-4614-9868-22102262695d" }
Resposta
Parâmetro |
Tipo |
Descrição |
---|---|---|
throttle_applys |
Dicionário |
Lista de vinculação |
Parâmetro |
Tipo |
Descrição |
---|---|---|
id |
String |
ID de vinculação |
strategy_id |
String |
ID de uma política de limitação de solicitações |
publish_id |
String |
ID do registro de publicação da API |
scope |
Integer |
Escopo da política de limitação de solicitação, que pode ser:
Atualmente, apenas 1 é suportado. |
apply_time |
Timestamp |
Hora em que a política de limitação de solicitações está vinculada à API |
Exemplo de resposta:
{ "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 status
Código de status |
Descrição |
---|---|
201 |
Criado |
400 |
Solicitação inválida |
401 |
Não autorizado |
403 |
Proibido |
404 |
Não encontrado |
500 |
Erro do servidor interno |