调用DescribeDcdnDomainConfigs获取加速域名的配置信息。

说明 一次可查询多个功能配置信息。

调试

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

请求参数

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

系统规定参数。取值:DescribeDcdnDomainConfigs

DomainName String example.com

加速域名,仅支持查询单个域名。

FunctionNames String filetype_based_ttl_set,set_req_host_header

功能列表名称,多个用英文逗号(,)分隔。

功能列表如下表所示。

名称

参数

referer_white_list_set:Referer防盗链白名单

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

allow_empty:是否允许空Referer字段访问DCDN资源,取值:on或off。

referer_black_list_set:Referer防盗链黑名单

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

allow_empty:是否允许空Referer字段访问DCDN资源,取值:on或off。

filetype_based_ttl_set:文件类型缓存过期时间设置

ttl:缓存时间,单位为秒。

file_type:文件类型。多个文件类型用英文逗号(,)分隔,例如TXT,JPG。

weight:权重。

path_based_ttl_set:目录类型缓存过期时间设置

ttl:缓存时间,单位为秒。

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

weight:权重。

oss_auth:OSS鉴权Bucket

oss_bucket_id:您的Bucket地址。

ip_black_list_set:IP黑名单

ip_list:IP列表,多个用英文逗号(,)分隔。

ip_allow_list_set:IP白名单

ip_list:IP列表,多个用英文逗号(,)分隔。

error_page:错误页面重定向

error_code:错误码。

rewrite_page:重定向页面。

set_req_host_header:修改回源自定义头

domain_name:回源HOST头内容。

set_hashkey_args:忽略URL参数

hashkey_args:保留参数列表,多个用英文逗号(,)分隔,最多支持填写10个。

disable:等于on表示忽略所有参数,off表示不忽略(缓存hashkey忽略所有参数,优先级低于保留缓存参数列表)。

keep_oss_args:等于on表示回源保留所有参数,off表示与缓存hashkey的参数一致。

aliauth:阿里鉴权

auth_type:鉴权类型。no_auth:无鉴权;type_a:鉴权方式A;type_b:鉴权方式B;type_c:鉴权方式C。

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

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

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

key(必填):响应头。

value(必填):响应头内容,删除填写null。

header_operation_type:请求头操作,支持add、delete、modify、rewrite,添加add、删除delete、变更modify、替换rewrite。

duplicate:是否允许重复,支持on或off。

header_source:查找。

header_destination:替换为。

match_all:匹配所有,支持on或off。

https_force:强制HTTPS跳转

enable:功能开关,取值:on或off。

http_force:强制HTTP跳转

enable:功能开关,取值:on或off。

https_option:HTTPS基础参数

http2:HTTP2开关,取值:on或off。

ocsp_stapling:OCSP Stapling开关,取值:on或off。

forward_scheme:静态协议跟随回源

enable:开关,取值:on或off。

scheme_origin:回源协议类型,支持http、https和follow(跟随)。

dynamic:全站加速相关配置

enable(必填):开关,支持on或off。

static_route_type:静态加速文件后缀。

static_route_url:静态加速URI。

static_route_path:静态加速PATH。

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

dynamic_route_round_robin:开启负载均衡开关,支持on或off。

dynamic_route_adapt_cache:开启自适应缓存开关,支持on或off。

set_req_header:自定义回源HTTP头

key:回源头。

value:回源头内容。

l2_oss_key:阿里云OSS私有Bucket回源

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

range:range回源

enable:开关,支持on、off。

video_seek:视频拖拽播放

enable(必填):开关,支持on或off。

flv_seek_by_time:开启FLV按时间拖拽,支持on或off。

mp4_seek_start:自定义MP4开始参数。

mp4_seek_end:自定义MP4结束参数。

flv_seek_start:自定义FLV开始参数。

flv_seek_end:自定义FLV结束参数。

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:智能压缩

enable(必填):功能开关,支持on或off。

tesla:页面优化

enable(必填):功能开关,支持on或off。

trim_js:支持on或off,开启该功能,优化html中内嵌的js代码。

trim_css:支持on或off,开启该功能,优化html中内嵌的css代码。

https_origin_sni:回源SNI

enabled:功能开关,支持on或off。

https_origin_sni(必填):回源SNI。

protogw:IP应用加速

realip(必填):源站IP透传方式,支持off、toa、pp。

port(必填):服务端口。

patten:模式字符串。

host_redirect:重写功能

regex:需要重写的URL,例如:^/$。

replacement:目标URL,例如: /go/act/sale/tbzlsy.php。

flag:仅支持redirect、break。

forward_timeout:回源请求超时时间

forward_timeout:单位为秒,配置时建议不要大于100秒。

ipv6:IPv6配置

switch(必填):开关,支持on或off,on表示开启,off表示关闭。

region:开启IPv6功能的地区,支持星号(*)。

edge_function:边缘函数

rule(必填):DSL规则。

pri(必填):优先级。

enable(必填):本条规则是否生效,取值:on或off。

name:规则名称。

pos:规则执行位置。全站加速域名仅支持head,不支持foot。

brk:命中本条规则后,当前执行位置剩余规则均跳过。

option:option管控。

grammar:grammar管控,可选值:空、es2、js。

jsmode:js域名白单管控,可选值:redirect、bypass。

brotli:Brotli压缩

enable(必填):功能开关,支持on或off。

brotli_level:压缩等级,取值范围[1,11]。

ali_ua:User-Agent黑/白名单

ua:User-Agent。

type:名单类型,black或white。

返回数据

名称 类型 示例值 描述
DomainConfigs Array of DomainConfig

域名配置。

DomainConfig
ConfigId String 5068995

配置ID。

FunctionArgs Array of FunctionArg

功能配置。

FunctionArg
ArgName String ttl

配置名称。

ArgValue String 13

配置值。

FunctionName String set_req_host_header

功能名称。

Status String success

状态。取值:

  • success:成功。
  • testing:测试中。
  • failed:失败。
  • configuring:配置中。
RequestId String F8AA0364-0FDB-4AD5-AC74-D69FAB8924ED

请求ID。

示例

请求示例

http(s)://dcdn.aliyuncs.com/?Action=DescribeDcdnDomainConfigs
&DomainName=example.com
&FunctionNames=filetype_based_ttl_set,set_req_host_header
&<公共请求参数>

正常返回示例

XML格式

<DescribeDcdnDomainConfigsResponse>
	  <RequestId>F8AA0364-0FDB-4AD5-AC74-D69FAB8924ED</RequestId>
	  <DomainConfigs>
		    <DomainConfig>
			      <FunctionArgs>
				        <FunctionArg>
					          <ArgName>domain_name</ArgName>
					          <ArgValue>testdcdn3.cdnpe.com</ArgValue>
				        </FunctionArg>
			      </FunctionArgs>
			      <ConfigId>5003576</ConfigId>
			      <FunctionName>set_req_host_header</FunctionName>
		    </DomainConfig>
		    <DomainConfig>
			      <FunctionArgs>
				        <FunctionArg>
					          <ArgName>file_type</ArgName>
					          <ArgValue>txt</ArgValue>
				        </FunctionArg>
				        <FunctionArg>
					          <ArgName>ttl</ArgName>
					          <ArgValue>13</ArgValue>
				        </FunctionArg>
			      </FunctionArgs>
			      <ConfigId>5068995</ConfigId>
			      <FunctionName>filetype_based_ttl_set</FunctionName>
		    </DomainConfig>
	  </DomainConfigs>
</DescribeDcdnDomainConfigsResponse>

JSON格式

{
  "RequestId": "F8AA0364-0FDB-4AD5-AC74-D69FAB8924ED",
  "DomainConfigs": {
    "DomainConfig": [
      {
        "FunctionArgs": {
          "FunctionArg": [
            {
              "ArgName": "domain_name",
              "ArgValue": "testdcdn3.cdnpe.com"
            }
          ]
        },
        "ConfigId": 5003576,
        "FunctionName": "set_req_host_header"
      },
      {
        "FunctionArgs": {
          "FunctionArg": [
            {
              "ArgName": "file_type",
              "ArgValue": "txt"
            },
            {
              "ArgName": "ttl",
              "ArgValue": "13"
            }
          ]
        },
        "ConfigId": 5068995,
        "FunctionName": "filetype_based_ttl_set"
      }
    ]
  }
}

错误码

HttpCode 错误码 错误信息 描述
400 Invalid%s.ValueNotSupported FunctionName [%s] is not supported. 不支持该配置,请重新查询。

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