调用BatchSetDcdnIpaDomainConfigsIP4层应用加速域名批量配置。

调试

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

请求参数

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

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

DomainNames String example.com

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

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

功能列表。

某些功能,如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:响应头,取值范围:Content-Type、Cache-Control、Content-Disposition、Content-Language、Expires、Access-Control-Allow-Origin、Access-Control-Allow-Methods、Access-Control-Allow-Headers、Access-Control-Max-Age、Access-Control-Expose-Headers;

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:静态协议跟随回源

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

set_req_header:自定义回源HTTP头

key:回源头;

value:回源头内容

l2_oss_key:私有buckct回源

private_oss_auth:私有Bucket回源开关,支持on/off

range:range回源

enable:开关,支持on/off

video_seek:视频拖拽播放

enable:开关,支持on/off

websocket:Websocket

enabled:必填,是否开启,取值范围:on/off

origin_scheme:回源scheme,支持http、https和follow

heartbeat:心跳时间,默认60,支持1-300秒

ali_remove_args:忽略url参数(删除)

ali_remove_args:必填,删除指定的参数,多个参数之间用空格隔开,剩余参数将作为hashkey中URL args部分;keep_oss_args:支持on/off.on表示回源保留所有参数,off表示与缓存hashkey的参数一致

https_tls_version:TLS协议版本

tls10:开启 TLSv1.0 默认:on,支持on/off;

tls11:开启 TLSv1.1 默认:on,支持on/off

tls12:开启 TLSv1.2 默认:on,支持on/off

tls13:开启 TLSv1.3 默认:off,支持on/off

HSTS:HSTS

enabled:必填,开关,默认: off,支持on/off;

https_hsts_max_age:必填,过期时间,单位:ms,建议填写5184000000ms(60天)

https_hsts_include_subdomains:HSTS 头包含 includeSubDomains 参数,支持on/off。请谨慎开启,开启前,请确保该加速域名所有子域名都已开启 HTTPS,否则会导致子域名自动跳转到 HTTPS 后无法访问

filetype_force_ttl_code:文件状态码过期时间设置

file_type:必填,文件类型:支持多个,用逗号(,)隔开,如txt,jpg;code_string:必填,状态码,例:302=0,301=0,4xx=2

path_force_ttl_code:路径状态码过期时间设置

path:必填,必须以/开头,举例:/image;code_string:必填,状态码,例:302=0,301=0,4xx=2

gzip:页面Gzip优化

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

tesla:页面优化加速

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

protogw:IP应用加速

realip:必填,源站ip透传方式,支持off/toa/pp。port:必填,服务端口

返回数据

名称 类型 示例值 描述
RequestId String 0AEDAF20-4DDF-4165-8750-47FF9C1929C9

请求ID。

示例

请求示例

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

正常返回示例

XML 格式

<BatchSetDcdnIpaDomainConfigsResponse>
	  <RequestId>0AEDAF20-4DDF-4165-8750-47FF9C1929C9</RequestId>
</BatchSetDcdnIpaDomainConfigsResponse>

JSON 格式

{
	"RequestId":"0AEDAF20-4DDF-4165-8750-47FF9C1929C9"
}

错误码

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。
403 DcdnIpaServiceNotFound The DCDN IPA service has not been activated. 没有开通Dcdn Ipa服务。

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