调用BatchSetDcdnIpaDomainConfigsIP4层应用加速域名批量配置。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
| 名称 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | BatchSetDcdnIpaDomainConfigs |
系统规定参数。取值：BatchSetDcdnIpaDomainConfigs。 |
| DomainNames | String | 是 | example.com |
您的IP4层应用加速域名，多个用逗号（,）分隔。 |
| Functions | String | 是 | [{"functionArgs":[{"argName":"domain_name","argValue":"api.xxx.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~99。 |
|
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：错误页面重定向回源Host头内容 |
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.xxx.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服务。 |
访问错误中心查看更多错误码。