查询带宽封顶
更新时间:2021-07-22
查询带宽封顶
接口描述
本接口用于查询指定加速域名的带宽封顶配置。
权限说明
所有API的安全认证一律采用Access Key与请求签名机制。 Access Key由Access Key ID和Secret Access Key组成,均为字符串。 对于每个HTTP请求,使用下面所描述的算法生成一个认证字符串。提交认证字符串放在Authorization头域里。服务端根据生成算法验证认证字符串的正确性。 认证字符串的格式为bce-auth-v{version}/{accessKeyId}/{timestamp}/{expirationPeriodInSeconds}/{signedHeaders}/{signature}
。
- version是正整数。
- timestamp是生成签名时的UTC时间。
- expirationPeriodInSeconds表示签名有效期限。
- signedHeaders是签名算法中涉及到的头域列表。头域名之间用分号(;)分隔,如host;x-bce-date。列表按照字典序排列。(本API签名仅使用host和x-bce-date两个header)
- signature是256位签名的十六进制表示,由64个小写字母组成。
当百度智能云接收到用户的请求后,系统将使用相同的SK和同样的认证机制生成认证字符串,并与用户请求中包含的认证字符串进行比对。如果认证字符串相同,系统认为用户拥有指定的操作权限,并执行相关操作;如果认证字符串不同,系统将忽略该操作并返回错误码。
鉴权认证机制的详细内容请参见鉴权认证。
请求语法
Method | Path | 说明 |
---|---|---|
GET | /v2/domain/{domain}/config?limitBandwidth | 查询域名带宽封顶配置 |
domain: 需要查询CDN的加速域名
请求头域
除公共头域外,无其它特殊头域。
请求参数
除limitBandwidth外无其他url参数,无body参数
响应头域
除公共头域外,无其它特殊头域
响应参数
参数 | 类型 | 说明 |
---|---|---|
limitBandwidth | LimitBandwidth | 带宽封顶配置 |
LimitBandwidth类型说明
参数 | 可选 | 类型 | 说明 |
---|---|---|---|
enabled | 必选 | bool | 开启/关闭带宽封顶配置 |
threshold | 必选 | string | 带宽封顶阈值,带单位G,如"1G", "200G"。enable为true时必选 |
action | 必选 | string | 带宽达到阈值时触发的动作,值为deny/stop,"stop"表示stop加速域名,"deny"表示拒绝所有请求。当enabled为true时必选 |
actived | 必选 | bool | 当前周期action是否被触发 |
请求示例
GET /v2/domain/myself.baidu.com/config?limitBandwidth HTTP/1.1
Host: cdn.baidubce.com
响应示例
HTTP/1.1 200 OK
Server: nginx/1.1.10
Date: Wed, 21 Jul 2021 08:39:42 GMT
Content-Type: application/json; charset=utf-8
Transfer-Encoding: chunked
Connection: keep-alive
X-Powered-By: PHP/7.2.28
x-bce-request-id: cc72ab66-1798-aa32-6d3b-d1a4a600fd31
{
"limitBandwidth": {
"enabled": true,
"threshold": "2G",
"action": "deny",
"actived": false
}
}