更新时间:2023-11-28 GMT+08:00

创建特殊设置

功能介绍

流控策略可以限制一段时间内可以访问API的最大次数,也可以限制一段时间内单个租户和单个APP可以访问API的最大次数。

如果想要对某个特定的APP进行特殊设置,例如设置所有APP每分钟的访问次数为500次,但想设置APP1每分钟的访问次数为800次,可以通过在流控策略中设置特殊APP来实现该功能。

为流控策略添加一个特殊设置的对象,可以是APP,也可以是租户。

URI

HTTP/HTTPS请求方法以及URI如下表所示。

表1 HTTP/HTTPS请求方法以及URI

请求方法

URI

POST

/v1.0/apigw/throttle-specials

请求消息

表2 参数说明

参数

是否必选

类型

说明

call_limits

Integer

流控时间内特殊对象能够访问API的最大次数限制

instance_id

String

特殊APP的编号或特殊租户的账号ID

instance_type

String

对象类型:APP/USER

strategy_id

String

流控策略编号

请求消息样例:

{
	"call_limits": 150,
	"instance_id": "98efd77d-10b5-4eca-8170-ed30a4a286a4",
	"instance_type": "APP",
	"strategy_id": "a3106cfe-801f-4919-b0d7-d785dc5b47f9"
}

响应消息

表3 参数说明

参数

类型

说明

id

String

特殊配置的编号

strategy_id

String

流控策略编号

instance_id

Integer

特殊对象的身份标识

instance_name

String

作用的APP或租户的名称

instance_type

Integer

特殊对象的类型

call_limits

Integer

特殊对象在流控时间内能够访问API的最大次数限制

apply_time

Timestamp

设置时间

app_id

String

作用的APP编号

app_name

String

作用的APP名称

响应消息样例:

{
  "id": "778879b8-df10-495b-a087-874859fdea6d",
  "strategy_id": "a3106cfe-801f-4919-b0d7-d785dc5b47f9",
  "instance_id": "98efd77d-10b5-4eca-8170-ed30a4a286a4",
  "instance_name": "app_002",
  "instance_type": "APP",
  "call_limits": 150,
  "apply_time": "2017-12-29T03: 11: 18.2698381Z",
  "app_id": "98efd77d-10b5-4eca-8170-ed30a4a286a4",
  "app_name": "app_002"
}

状态码

表4 返回消息说明

状态码

说明

201

Created

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

Server Internal Error