调用BatchSetDcdnDomainConfigs实现域名批量配置功能。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String BatchSetDcdnDomainConfigs

操作接口名,系统规定参数,取值:BatchSetDcdnDomainConfigs

DomainNames String example.com

您的加速域名,多个用逗号(,)分隔。

Functions String [{"functionArgs":[{"argName":"domain_name","argValue":"api.hellodtworld.com"}],"functionName":"set_req_host_header"}]

功能列表。

Functions功能说明:所有参数值均按照字符串类型处理。

某些功能,如filetype_based_ttl_set,可以设置多条纪录,当需要更新其中某条纪录时,可通过该条纪录的configId来指定。{"functionArgs":[{"argName":"file_type","argValue":"jpg"},{"argName":"ttl","argValue":"18"},{"argName":"weight","argValue":"30"},"functionName":"filetype_based_ttl_set","configId":5068995}]

功能列表如下所示。

名称

参数

referer_white_list_set:refer白名单

refer_domain_allow_list:白名单列表,多个逗号(,)分隔。

allow_empty:是否允许空refer进入,取值范围:on/off。

referer_black_list_set:refer黑名单

refer_domain_deny_list:黑名单列表,多个逗号(,)分隔。

allow_empty:是否允许空refer进入,取值范围:on/off。

filetype_based_ttl_set:文件过期时间设置

ttl:cache时间,单位:秒。

file_type:支持多个文件类型。用逗号(,)隔开。例如:txt,jpg。weight:权重。取值范围:1~199。

path_based_ttl_set:目录过期时间设置

ttl:cache时间,单位:秒。

path:目录,必须以正斜线(/)开头。

weight:权重。取值范围:1~99。

oss_auth:OSS鉴权Bucket

oss_bucket_id:用户bucket地址。

ip_black_list_set:IP黑名单

ip_list:IP列表多个用逗号(,)隔开。

ip_allow_list_set:IP白名单

ip_list:IP列表多个用逗号(,)隔开。

ip_white_list_set:TMD免拦截

ip_list:IP列表多个用逗号(,)隔开。

error_page:错误页面重定向

error_code:错误码。rewrite_page:重定向页面。

set_req_host_header:修改回源自定义头

domain_name:回源Host头内容。

set_hashkey_args:忽略url参数

hashkey_args:保留参数的列表,多个用逗号(,)分隔。

disable:disable等于on表示忽略所有参数,等于off表示不忽略。

aliauth:阿里鉴权

auth_type:鉴权类型。取值范围:”no_auth”、”type_a”、”type_b”、”type_c”

auth_key1:鉴权key1。auth_key2:鉴权key2。

ali_auth_delta:自定义鉴权缓冲时间。

set_resp_header:设置响应头(浏览器端可见)

key:响应头。value:响应头内容,删除填写null。

https_force:强制HTTPS跳转

enable:功能开关,取值范围:on/off。

http_force:强制HTTP跳转

enable:功能开关,取值范围:on/off。

https_option:HTTPS基础参数

http2:http2开关,取值范围:on/off。

l2_oss_key:L2 OSS 回源私钥

private_oss_auth:是否开启私有oss鉴权功能,取值范围:on/off。

forward_scheme:swift自适应回源

enable:开关,取值范围:on/off。

scheme_origin:回源站协议,支持http、https和follow。

green_manager 鉴黄功能

enable:是否开启鉴黄功能,取值范围:on/off。

tmd_signature:TMD自定义规则

name:规则名称,域名内不可重复。

path:可重复,需校验uri路径合法性。

pathType:匹配规则。0表示前缀匹配,1表示完全匹配。interval:监测时长,单位秒,参数限制必须≥10。

count:单IP访问次数。

action:阻断类型。0表示封禁,1表示人机识别。ttl:阻断时长。单位:秒。

dynamic:全站加速相关配置

enable:开关。必填,支持on/off。

static_route_type:静态加速文件后缀。

static_route_url:静态加速URI。

static_route_path:静态加速PATH。

dynamic_route_origin:回源路由scheme,支持http、https和follow。

返回数据

名称 类型 示例值 描述
RequestId String 04F0F334-1335-436C-A1D7-6C044FE73368

请求ID。

示例

请求示例

http://dcdn.aliyuncs.com/?Action=BatchSetDcdnDomainConfigs
&DomainName=example.com
&Functions=[{"functionArgs":[{"argName":"domain_name","argValue":"api.hellodtworld.com"}],"functionName":"set_req_host_header"}]
&<公共请求参数>

正常返回示例

XML 格式

<BatchSetDcdnDomainConfigsResponse>
	  <RequestId>04F0F334-1335-436C-A1D7-6C044FE73368</RequestId>
</BatchSetDcdnDomainConfigsResponse>

JSON 格式

{
	"RequestId":"04F0F334-1335-436C-A1D7-6C044FE73368"
}

错误码

HttpCode 错误码 错误信息 描述
400 InvalidFunctions.Malformed The specified Functions is invalid. 不支持该配置,请重新填写。
400 InvalidArgValue.Malformed The specified ArgValue is invalid. ArgValue错误,请重新填写。
400 Invalid%s.ValueNotSupported [%s] is not supported. 不支持该设置。
400 Invalid%s.Malformed The specified ArgValue [%s] is invalid. 不支持该ArgValue,请填写正确的ArgValue。

访问错误中心查看更多错误码。