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 |