最近更新时间:2026-09-14 17:12:32
本接口用于设置 CDN 域名的全网带宽限速策略,并配置触发限速后的后续处理方式。
本接口请求需要包含指定目录/V3/SetGlobalSpeedLimitConfig、公共请求 Header 和接口所特有的请求参数,具体请求语句参照下文请求示例。请求头需携带 X-VERSION 、 X-ACTION。
参数名 | 必选 | 类型及范围 | 说明 |
|---|---|---|---|
DomainId | 是 | String | 域名ID |
Enable | 是 | String | 开关,on/off |
BandwidthThresholdUnit | 否 | String | 带宽阈值单位,Mbps/Gbps |
BandwidthThresholdValue | 否 | String | 带宽阈值,取值范围为整数且≥0,无上限 |
SubsequentProcessingMode | 否 | String | 可选值:
|
SubsequentProcessingValue | 否 | String | SubsequentProcessingMode: backsource时必填非空URL, httpcode时必填合法码值,枚举值之一: speedlimit时必填非负整数 |
请求示例
POST方式:
POST /V3/SetGlobalSpeedLimitConfig
Host: cdn.api.ksyun.com
X-Amz-Date: date
Authorization:authorization string
X-Action: SetGlobalSpeedLimitConfig
X-Version: V3
Content-Type: application/json
{
"DomainId": "2D09M8B",
"Enable": "on",
"BandwidthThresholdUnit": "Mbps",
"BandwidthThresholdValue": "100",
"SubsequentProcessingMode": "speedlimit",
"SubsequentProcessingValue": "10"
}返回说明
本接口调用成功返回 200 状态码,响应体为空(无 JSON 返回);若调用失败,参数校验失败返回 400 + Error JSON(含Error.Code/Message);鉴权失败返回 403;具体错误原因详见【使用须知】中错误代码表说明。
纯净模式
