全部文档
当前文档

暂无内容

如果没有找到您期望的内容,请尝试其他搜索词

文档中心

全网限速

最近更新时间:2026-09-14 17:12:32

SetGlobalSpeedLimitConfig

描述

本接口用于设置 CDN 域名的全网带宽限速策略,并配置触发限速后的后续处理方式。

请求语法

本接口请求需要包含指定目录/V3/SetGlobalSpeedLimitConfig、公共请求 Header 和接口所特有的请求参数,具体请求语句参照下文请求示例。请求头需携带 X-VERSION 、 X-ACTION。

请求参数

参数名

必选

类型及范围

说明

DomainId

String

域名ID

Enable

String

开关,on/off

BandwidthThresholdUnit

String

带宽阈值单位,Mbps/Gbps

BandwidthThresholdValue

String

带宽阈值,取值范围为整数且≥0,无上限

SubsequentProcessingMode

String

可选值:

backsource:超阈值回源

httpcode:超阈值返回指定状态码

speedlimit:超阈值限速

SubsequentProcessingValue

String

SubsequentProcessingMode:

backsource时必填非空URL,

httpcode时必填合法码值,枚举值之一:403/404/409/412/416/500/502/503/504

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;具体错误原因详见【使用须知】中错误代码表说明。

文档导读
纯净模式常规模式

纯净模式

点击可全屏预览文档内容
文档反馈