修改域名全量配置接口

domain_name

是

String

参数解释：

加速域名

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

enterprise_project_id

否

String

参数解释：

企业项目id。您可以通过调用企业项目管理服务（EPS）的查询企业项目列表接口（ListEnterpriseProject）查询企业项目id

约束限制：

当用户开启企业项目功能时，该参数生效，表示查询资源所属项目，"all"表示所有项目

取值范围：

不涉及

默认取值：

不涉及

X-Auth-Token

是

String

参数解释：

用户鉴权Token，通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

configs

否

Configs object

参数解释：

配置项

约束限制：

不涉及

business_type

否

String

参数解释：

业务类型

约束限制：

暂不支持“全站加速”变更为其它业务类型

取值范围：

• web: 网站加速

• download: 文件下载加速

• video: 点播加速

默认取值：

不涉及

service_area

否

String

参数解释：

加速域名的服务范围，客户端访问将会调度到服务范围内的CDN节点，可根据用户聚集区域选择合适的范围

约束限制：

• 暂不支持“中国大陆”与“中国大陆境外”互相直接切换

• 服务范围修改为中国大陆或全球时，加速域名需要到工信部备案

取值范围：

• mainland_china：中国大陆

• global：全球

• outside_mainland_china：中国大陆境外

默认取值：

不涉及

remark

否

String

参数解释：

域名备注信息

约束限制：

不涉及

取值范围：

0-10000个字符

默认取值：

不涉及

origin_request_header

否

Array of OriginRequestHeader objects

参数解释：

回源请求头，CDN节点回源时，根据回源请求头配置操作请求的HTTP头部信息

约束限制：

• 修改时该功能将覆盖原有配置（清空之前的配置），在使用此接口时，请上传全量头部信息

• 如果域名在后台配置了特殊请求头，需要将对应的请求头一并传入

http_response_header

否

Array of HttpResponseHeader objects

参数解释：

HTTP响应头，CDN节点响应客户端时，根据HTTP响应头配置操作响应的HTTP头部信息

约束限制：

• 修改时该功能将覆盖原有配置（清空之前的配置），在使用此接口时，请上传全量头部信息

• 如果域名在后台配置了特殊响应头，需要将对应的响应头一并传入

url_auth

否

UrlAuth object

参数解释：

配置URL鉴权功能，通过计算出的鉴权URL访问用户站点资源，防止资源被用户恶意下载盗用

约束限制：

不涉及

https

否

HttpPutBody object

参数解释：

在CDN节点添加证书，支持客户端以HTTPS协议访问节点，实现HTTPS安全加速

约束限制：

不涉及

sources

否

Array of SourcesConfig objects

参数解释：

配置加速域名的源站，CDN通过加速域名将源站上需要加速的内容缓存到CDN节点，达到加速访问资源的效果

约束限制：

不涉及

origin_protocol

否

String

参数解释：

指定CDN回源时的请求协议

约束限制：

不涉及

取值范围：

• follow: 协议跟随

• http: http协议

• https: https协议

默认取值：

http: http协议

origin_follow302_status

否

String

参数解释：

开启回源跟随，当源站地址因业务需求做了301/302 重定向，CDN节点会先跳转到301/302对应地址获取资源，缓存后再返回给用户

约束限制：

不涉及

取值范围：

• on: 开启

• off: 关闭

默认取值：

不涉及

cache_rules

否

Array of CacheRules objects

参数解释：

通过不同参数控制源站资源在CDN节点的缓存时长

约束限制：

必须存在一条所有文件类型的规则

ip_filter

否

IpFilter object

参数解释：

IP黑白名单，对用户的请求IP地址进行过滤，从而限制访问来源

约束限制：

不涉及

referer

否

RefererConfig object

参数解释：

referer黑白名单，对访问者身份进行识别和过滤，从而限制访问来源

约束限制：

不涉及

force_redirect

否

ForceRedirectConfig object

参数解释：

强制客户端使用HTTPS或HTTP协议访问CDN节点

约束限制：

不涉及

compress

否

Compress object

参数解释：

智能压缩，压缩网站的静态资源，缩小传输文件的大小，提升传输效率，减少带宽消耗

约束限制：

不涉及

cache_url_parameter_filter

否

CacheUrlParameterFilter object

参数解释：

缓存url参数配置

约束限制：

不涉及

ipv6_accelerate

否

Integer

参数解释：

配置客户端用IPv6协议访问CDN节点

约束限制：

不涉及

取值范围：

• 1: 开启

• 0: 关闭

默认取值：

不涉及

error_code_cache

否

Array of ErrorCodeCache objects

参数解释：

将源站返回的错误状态码缓存到CDN节点，用户再次请求时由CDN直接响应给用户错误码

约束限制：

不涉及

origin_range_status

否

String

参数解释：

Range回源，开启后，源站在收到CDN节点回源请求时，根据HTTP请求头中的Range信息返回指定范围的数据给CDN节点

约束限制：

开启Range回源的前提是您的源站支持Range请求，即HTTP请求头中包含Range字段，否则可能导致回源失败

取值范围：

• on: 开启

• off: 关闭

默认取值：

不涉及

user_agent_filter

否

UserAgentFilter object

参数解释：

UA黑白名单，对用户请求使用的代理过滤，从而限制访问来源

约束限制：

不涉及

origin_request_url_rewrite

否

Array of OriginRequestUrlRewrite objects

参数解释：

回源URL改写，解决回源请求URL与源站URL不匹配的问题

约束限制：

最多配置20条

flexible_origin

否

Array of flexibleOrigins objects

参数解释：

高级回源，实现根据不同的资源类型或路径回源到不同源站

约束限制：

最多配置20条

slice_etag_status

否

String

参数解释：

回源是否校验ETag，开启此项配置后，当用户再次请求节点已缓存资源时，会将ETag的值加入到判断资源是否过期的逻辑

约束限制：

不涉及

取值范围：

• on: 开启

• off: 关闭

默认取值：

不涉及

origin_receive_timeout

否

Integer

参数解释：

自定义设置CDN节点回源时的超时时间，请求超时即表示此次回源失败

约束限制：

不涉及

取值范围：

5-300，单位：秒

默认取值：

不涉及

remote_auth

否

commonRemoteAuth object

参数解释：

配置远程鉴权，当用户向CDN节点请求资源时，CDN将用户请求转发到客户指定的鉴权服务器，CDN根据鉴权服务器返回的结果判断是否给用户返回资源

约束限制：

不涉及

websocket

否

webSocketSeek object

参数解释：

是否允许客户端使用websocket协议访问CDN节点

约束限制：

• 仅全站加速的域名支持该配置

• WebSocket协议和配置HTTP/2功能不兼容，请勿同时开启

video_seek

否

videoSeek object

参数解释：

视频拖拽配置，用户可随意拖拽播放进度且不影响观看效果

约束限制：

• 需同步开启FLV、MP4格式文件的URL参数功能，并选择“忽略参数”

• 关闭视频拖拽功能时，FLV时间拖拽功能失效

request_limit_rules

否

Array of RequestLimitRules objects

参数解释：

请求限速，将用户请求速度限制在指定范围内，一定程度上减少突发高带宽风险，节省成本

约束限制：

不涉及

ip_frequency_limit

否

IpFrequencyLimit object

参数解释：

IP访问限频，通过对单IP每秒访问单个节点的次数限制，实现CC攻击防御及恶意盗刷防护

约束限制：

不涉及

hsts

否

Hsts object

参数解释：

配置HSTS后，将强制客户端（如浏览器）使用 HTTPS 协议访问服务器，提升访问安全性

约束限制：

不涉及

quic

否

Quic object

参数解释：

QUIC协议，客户端使用QUIC协议访问CDN节点，提高了传输的安全性，减少传输和连接时的延时，避免网络拥塞

约束限制：

不涉及

error_code_redirect_rules

否

Array of ErrorCodeRedirectRules objects

参数解释：

自定义错误页面，当访问页面出错时，会给客户端返回指定的页面，优化用户体验

约束限制：

不涉及

sni

否

Sni object

参数解释：

回源SNI，如果源站IP绑定了多个域名，当CDN节点以HTTPS协议访问源站时，可以设置回源SNI，指定HTTPS协议握手时使用的SNI域名

约束限制：

不涉及

request_url_rewrite

否

Array of RequestUrlRewrite objects

参数解释：

访问URL重写，当用户请求URL与CDN节点缓存资源的URL不一致时，可以通过访问URL重写功能重定向到目标URL

约束限制：

不涉及

browser_cache_rules

否

Array of BrowserCacheRules objects

参数解释：

浏览器缓存过期时间，当终端用户请求资源时，如果浏览器有缓存，直接返回给用户

约束限制：

不涉及

access_area_filter

否

Array of AccessAreaFilter objects

参数解释：

区域访问控制，限制某些地理位置的用户访问

约束限制：

不涉及

client_cert

否

ClientCert object

参数解释：

客户端证书配置，实现客户端与CDN节点的双向证书认证，提高网站通信安全性

约束限制：

不涉及

name

是

String

参数解释：

设置回源请求头参数

约束限制：

不涉及

取值范围：

• 1-100个字符

• 由数字，大小写字母，中划线组成

• 只能以字母开头

默认取值：

不涉及

value

否

String

参数解释：

设置回源请求头参数的值

约束限制：

不涉及

取值范围：

• 1-1000个字符

• 由数字0 - 9、字符a - z、A - Z，及特殊符“.”、“-”、“_”、“*”、“#”、“!”、“&”、“+”、“|”、“^”、“~”、“'”、“"”、“/”、“:”、“;”、“,”、“=”、“@”、“?”、“<”、“>”组成

• 当为删除动作时，可不填

• 不支持中文

• 不支持变量配置，如：$client_ip,$remote_port等

默认取值：

不涉及

action

是

String

参数解释：

回源请求头设置类型

约束限制：

• 同一个请求头字段只允许删除或者设置

• action为set时，若原回源请求头参数不存在该字段，则执行新增动作。若存在，则执行修改动作

取值范围：

• delete: 删除

• set: 设置

默认取值：

不涉及

name

是

String

参数解释：

设置HTTP响应头参数

约束限制：

不涉及

取值范围：

• 1-100个字符

• 由数字，大小写字母，中划线组成，只能以字母开头

默认取值：

不涉及

value

否

String

参数解释：

设置HTTP响应头参数的值

约束限制：

不涉及

取值范围：

• 1-1000个字符

• 支持字母、数字和特定字符，如：.-_*#!&+|^~'"/:;,=@?<> 等

• 当为删除动作时，可不填

默认取值：

不涉及

action

是

String

参数解释：

设置HTTP响应头操作类型

约束限制：

• 同一个响应头字段只允许删除或者设置

• action为set时，若原HTTP响应头参数不存在该字段，则执行新增动作。若存在，则执行修改动作

取值范围：

• set: 设置

• delete: 删除

默认取值：

不涉及

status

是

String

参数解释：

是否开启URL鉴权

约束限制：

不涉及

取值范围：

• on: 开启

• off: 关闭

默认取值：

不涉及

type

否

String

参数解释：

鉴权方式

约束限制：

不涉及

取值范围：

• type_a: 鉴权方式A

• type_b: 鉴权方式B

• type_c1: 鉴权方式C1

• type_c2: 鉴权方式C2

默认取值：

不涉及

expire_time

否

Integer

参数解释：

鉴权URL的有效时间

约束限制：

不涉及

取值范围：

0-31536000，单位：秒

默认取值：

不涉及

sign_method

否

String

参数解释：

加密算法

约束限制：

不涉及

取值范围：

• md5

• sha256

默认取值：

不涉及

match_type

否

String

参数解释：

鉴权范围，指定哪些文件参与鉴权

约束限制：

不涉及

取值范围：

• all: 所有文件

• include_file_extension: 指定后缀文件参与鉴权

• exclude_file_extension: 指定后缀文件不参与鉴权

默认取值：

不涉及

match_rule

否

String

参数解释：

鉴权文件匹配规则

约束限制：

不涉及

取值范围：

• 当match_type为all时，置空

• 当match_type为include_file_extension或exclude_file_extension时，输入文件后缀，后缀以“.”为首字符，多个后缀以“,”分隔，如.jpg,.zip,.exe

默认取值：

不涉及

inherit_config

否

InheritConfig object

参数解释：

鉴权继承，为M3U8/MPD索引文件下的TS/MP4文件添加鉴权参数，解决因鉴权不通过导致的TS/MP4文件无法播放的问题

约束限制：

不涉及

key

否

String

参数解释：

鉴权密钥

约束限制：

不涉及

取值范围：

• 6-32个字符

• 由大小写字母、数字构成

默认取值：

不涉及

backup_key

否

String

参数解释：

备选鉴权密钥，当需要替换密钥时，如果需要新旧密钥同时生效，可设置备KEY。主、备KEY之一鉴权通过即可正常访问

约束限制：

不涉及

取值范围：

• 6-32个字符

• 由大小写字母、数字构成

默认取值：

不涉及

sign_arg

否

String

参数解释：

用户url中携带的鉴权信息参数名

约束限制：

鉴权方式为A或C2时需配置该参数

取值范围：

• 1-100个字符

• 由大小写字母、数字、下划线构成（不能以数字开头）

默认取值：

auth_key

time_format

否

String

参数解释：

时间格式

约束限制：

• 鉴权方式A: 只支持十进制

• 鉴权方式B: 只支持十进制

• 鉴权方式C1: 只支持十六进制

• 鉴权方式C2: 支持十进制/十六进制

取值范围：

• dec: 十进制

• hex: 十六进制

默认取值：

不涉及

time_arg

否

String

参数解释：

时间参数名称

约束限制：

鉴权方式为C2时，该字段可选

取值范围：

• 1-100个字符

• 以字母开头，支持数字、字母和下划线，不允许出现其他特殊符号

默认取值：

timestamp

status

是

String

参数解释：

是否开启鉴权继承

约束限制：

不涉及

取值范围：

• on: 开启

• off: 关闭

默认取值：

不涉及

inherit_type

否

String

参数解释：

鉴权继承配置

约束限制：

• 输入多个参数时用“,”分隔，例如“m3u8,mpd”

• 开启鉴权继承时，该参数必填

取值范围：

• m3u8

• mpd

默认取值：

不涉及

inherit_time_type

否

String

参数解释：

鉴权继承开始时间

约束限制：

开启鉴权继承时，该参数必填

取值范围：

• sys_time: 当前系统时间

• parent_url_time: 与m3u8和mpd访问链接保持一致

默认取值：

不涉及

https_status

否

String

参数解释：

证书配置开关

约束限制：

不涉及

取值范围：

• on: 开启

• off: 关闭

默认取值：

不涉及

certificate_type

否

String

参数解释：

证书类型

约束限制：

不涉及

取值范围：

• server: 国际证书

• server_sm: 国密证书

默认取值：

不涉及

certificate_source

否

Integer

参数解释：

证书来源

约束限制：

证书开启时必传

取值范围：

• 0: 自有证书

• 2: SCM证书

默认取值：

不涉及

scm_certificate_id

否

String

参数解释：

SCM证书ID，可使用云证书管理服务（CCM）的查询证书列表接口获取

约束限制：

配置SCM证书时必传

取值范围：

不涉及

默认取值：

不涉及

certificate_name

否

String

参数解释：

证书名称

约束限制：

• 当证书开启时必传

• 3-64个字符

取值范围：

不涉及

默认取值：

不涉及

certificate_value

否

String

参数解释：

HTTPS协议使用的证书内容

约束限制：

• 仅支持PEM编码格式

• 当证书开启时必传

• 需要传入完整证书链

取值范围：

证书链长度不超过20KB

默认取值：

不涉及

private_key

否

String

参数解释：

HTTPS协议使用的私钥

约束限制：

• 当证书开启时必传

• 仅支持PEM编码格式

取值范围：

不涉及

默认取值：

不涉及

enc_certificate_value

否

String

参数解释：

加密证书内容

约束限制：

• 证书类型为国密证书时必传

• 仅支持PEM编码格式

取值范围：

不涉及

默认取值：

不涉及

enc_private_key

否

String

参数解释：

加密私钥内容

约束限制：

• 证书类型为国密证书时必传

• 仅支持PEM编码格式

取值范围：

不涉及

默认取值：

不涉及

certificates

否

Array of CertificatesPutBody objects

参数解释：

证书配置请求体

约束限制：

• 配置双证书时必传

• 不支持配置两个国际证书或两个国密证书

• 如果certificates配置了证书（国际证书、国密证书或国际+国密双证书），外层证书配置将失效，仅保留当前参数传入的证书信息

http2_status

否

String

参数解释：

HTTP/2开关，支持客户端采用HTTP/2协议访问CDN节点

约束限制：

https_status=off时，该值不生效

取值范围：

• on: 是

• off: 否

默认取值：

off: 否

tls_version

否

String

参数解释：

传输层安全性协议，即TLS版本配置

约束限制：

• 不可全部关闭

• 需开启连续或单个版本号，例：不可仅开启TLS1.0/1.2而关闭TLS1.1

• 多版本开启时，使用“,”拼接，例：TLSv1.1,TLSv1.2

• 配置TLS版本需要先开启HTTPS国际证书

取值范围：

目前支持TLSv1.0/1.1/1.2/1.3四个版本的协议

默认取值：

TLS1.1/1.2/1.3

ocsp_stapling_status

否

String

参数解释：

是否开启ocsp stapling

约束限制：

不涉及

取值范围：

• on: 是

• off: 否

默认取值：

不涉及

certificate_source

否

Integer

参数解释：

证书来源

约束限制：

不涉及

取值范围：

• 0: 自有证书

• 2: SCM证书

默认取值：

不涉及

scm_certificate_id

否

String

参数解释：

SCM证书ID，可使用云证书管理服务（CCM）的查询证书列表接口获取

约束限制：

配置SCM证书时必传

取值范围：

不涉及

默认取值：

不涉及

certificate_type

是

String

参数解释：

证书类型

约束限制：

不涉及

取值范围：

• server: 国际证书

• server_sm: 国密证书

默认取值：

不涉及

certificate_name

是

String

参数解释：

证书名字

约束限制：

不涉及

取值范围：

3-64个字符

默认取值：

不涉及

certificate_value

是

String

参数解释：

HTTPS协议使用的证书内容

约束限制：

仅支持PEM编码格式

取值范围：

不涉及

默认取值：

不涉及

private_key

是

String

参数解释：

HTTPS协议使用的私钥

约束限制：

仅支持PEM编码格式

取值范围：

不涉及

默认取值：

不涉及

enc_certificate_value

否

String

参数解释：

加密证书内容

约束限制：

• 证书类型为国密证书时必传

• 仅支持PEM编码格式

取值范围：

不涉及

默认取值：

不涉及

enc_private_key

否

String

参数解释：

加密私钥内容

约束限制：

• 证书类型为国密证书时必传

• 仅支持PEM编码格式

取值范围：

不涉及

默认取值：

不涉及

origin_type

是

String

参数解释：

源站类型

约束限制：

不涉及

取值范围：

• ipaddr: 源站IP

• domain: 源站域名

• obs_bucket: OBS桶域名

• third_bucket: 第三方桶，使用该源站类型需要提交工单申请

默认取值：

不涉及

origin_addr

是

String

参数解释：

源站IP或者域名

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

priority

是

Integer

参数解释：

源站优先级

约束限制：

不涉及

取值范围：

1-100

默认取值：

不涉及

weight

否

Integer

参数解释：

权重

约束限制：

不涉及

取值范围：

1-100

默认取值：

不涉及

obs_web_hosting_status

否

String

参数解释：

是否开启OBS静态网站托管

约束限制：

源站类型为obs_bucket时传递

取值范围：

• on: 开启

• off: 关闭

默认取值：

不涉及

http_port

否

Integer

参数解释：

HTTP端口

约束限制：

不涉及

取值范围：

1-65535

默认取值：

80

https_port

否

Integer

参数解释：

HTTPS端口

约束限制：

不涉及

取值范围：

1-65535

默认取值：

443

host_name

否

String

参数解释：

回源HOST

约束限制：

不涉及

取值范围：

不涉及

默认取值：

加速域名

obs_bucket_type

否

String

参数解释：

OBS回源鉴权开关，适用于OBS桶源站场景，如果桶需要带鉴权访问，则需要打开OBS回源鉴权开关。如此，CDN节点回源时会携带鉴权信息，鉴权信息与OBS桶不匹配时，回源失败，避免非授权的请求盗刷流量

约束限制：

源站类型是“OBS桶域名”时需要传该参数

取值范围：

• private: 开启回源鉴权开关

• public: 关闭回源鉴权开关

默认取值：

public: 关闭回源鉴权开关

bucket_access_key

否

String

参数解释：

第三方对象存储访问密钥ID，即AK

约束限制：

源站类型为第三方桶时必填

取值范围：

不涉及

默认取值：

不涉及

bucket_secret_key

否

String

参数解释：

第三方对象存储私密访问密钥，即SK

约束限制：

源站类型为第三方桶时必填

取值范围：

不涉及

默认取值：

不涉及

bucket_region

否

String

参数解释：

第三方对象存储区域

约束限制：

源站类型为第三方桶时必填

取值范围：

不涉及

默认取值：

不涉及

bucket_name

否

String

参数解释：

第三方对象存储名称

约束限制：

源站类型为第三方桶时必填

取值范围：

不涉及

默认取值：

不涉及

match_type

是

String

参数解释：

匹配类型

约束限制：

不涉及

取值范围：

• all: 匹配所有文件

• file_extension: 按文件后缀匹配

• catalog: 按目录匹配

• full_path: 全路径匹配

• home_page: 按首页匹配

默认取值：

不涉及

match_value

否

String

参数解释：

缓存规则匹配内容

约束限制：

• 当match_type为all时，置空

• 当match_type为file_extension时，为文件后缀，输入首字符为“.”，以“,”或“;”分隔，如.jpg,.zip,.exe，并且输入的文件名后缀总数不超过100个，总字符不超过1000

• 当match_type为catalog时，为目录路径，输入要求以“/”作为首字符， 以“,”或“;”分隔，如/test/folder01,/test/folder02，并且输入的目录路径总数不超过20个，总字符不超过255

• 当match_type为full_path时，为全路径，输入要求以“/”作为首字符，支持匹配指定目录下的具体文件，或者带通配符“*”的文件，单条全路径缓存规则里仅支持配置一个全路径，如/test/index.html或/test/*.jpg，不可配置/*

• 当match_type为home_page时，置空

取值范围：

不涉及

默认取值：

不涉及

ttl

否

Integer

参数解释：

资源在CDN节点的缓存过期时间

约束限制：

最大支持365天

取值范围：

不涉及

默认取值：

0

ttl_unit

是

String

参数解释：

缓存过期时间单位

约束限制：

不涉及

取值范围：

• s: 秒

• m: 分

• h: 小时

• d: 天

默认取值：

不涉及

priority

是

Integer

参数解释：

缓存规则的优先级，数值越大，优先级越高

约束限制：

优先级不能相同

取值范围：

1-100

默认取值：

不涉及

follow_origin

否

String

参数解释：

缓存过期时间来源，设置CDN节点的缓存遵循源站还是CDN侧的配置

约束限制：

不涉及

取值范围：

• on: CDN节点的缓存过期时间遵循源站的设置

• off: CDN节点的缓存过期时间遵循“缓存规则”中的“缓存过期时间”

• min_ttl: CDN节点的缓存过期时间取缓存规则和源站二者的最小值

默认取值：

off: CDN节点的缓存过期时间遵循“缓存规则”中的“缓存过期时间”

force_cache

否

String

参数解释：

强制缓存：CDN节点缓存过期时间是否忽略源站响应头Cache-Control中的no-cache、private、no-store字段

约束限制：

强制缓存与缓存过期时间来源功能配合使用，具体使用限制及配置效果请参考CDN用户指南的配置节点缓存规则章节

取值范围：

• on: 打开强制缓存

• off: 关闭强制缓存

默认取值：

off: 关闭强制缓存

url_parameter_type

否

String

参数解释：

URL参数

约束限制：

不涉及

取值范围：

• del_params: 忽略指定URL参数

• reserve_params: 保留指定URL参数

• ignore_url_params: 忽略全部URL参数

• full_url: 使用完整URL参数

默认取值：

full_url: 使用完整URL参数

url_parameter_value

否

String

参数解释：

URL参数值

约束限制：

• 最多配置30条参数值

• 以“,”或“;”分隔

• 当url_parameter_type为del_params或reserve_params时必填

取值范围：

不涉及

默认取值：

不涉及

type

是

String

参数解释：

IP黑白名单类型

约束限制：

不涉及

取值范围：

• off: 关闭IP黑白名单

• black: IP黑名单

• white: IP白名单

默认取值：

不涉及

value

否

String

参数解释：

配置IP黑白名单

约束限制：

• 当type=off时，非必传

• 多条规则用“,”分隔

• 最多支持配置500条规则

• 多个完全重复的IP/IP段将合并为一条规则

• 不支持带通配符的地址，如192.168.0.*

取值范围：

不涉及

默认取值：

不涉及

type

是

String

参数解释：

Referer黑白名单类型

约束限制：

不涉及

取值范围：

• off: 关闭Referer黑白名单

• black: Referer黑名单

• white: Referer白名单

默认取值：

不涉及

value

否

String

参数解释：

域名或IP地址

约束限制：

• 以“,”进行分隔

• 域名、IP地址总数不超过1000个

• 端口取值范围1-65535

取值范围：

不涉及

默认取值：

不涉及

include_empty

否

Boolean

参数解释：

是否包含空Referer

约束限制：

不涉及

取值范围：

• true: 包含空

• false: 不包含空

默认取值：

false: 不包含空

status

是

String

参数解释：

强制跳转开关

约束限制：

不涉及

取值范围：

• on: 开启

• off: 关闭

默认取值：

不涉及

type

否

String

参数解释：

强制跳转类型

约束限制：

如果开启强制跳转HTTPS，请先配置HTTPS证书，否则将导致访问失败

取值范围：

• http: 强制跳转HTTP

• https: 强制跳转HTTPS

默认取值：

不涉及

redirect_code

否

Integer

参数解释：

重定向跳转码

约束限制：

不涉及

取值范围：

• 301

• 302

• 307

默认取值：

不涉及

status

是

String

参数解释：

智能压缩开关

约束限制：

不涉及

取值范围：

• on: 开启

• off: 关闭

默认取值：

不涉及

type

否

String

参数解释：

智能压缩类型

约束限制：

当配置了多种智能压缩类型时，优先使用brotli压缩

取值范围：

多种智能压缩类型用“,”分隔，可选值如下：

• gzip: gzip压缩

• br: brotli压缩

默认取值：

不涉及

file_type

否

String

参数解释：

需要压缩的文件类型

约束限制：

不涉及

取值范围：

• 内容总长度不可超过2000个字符

• 单个格式不可超过50个字符

• 多种格式用“,”分隔

默认取值：

开启状态下，首次传空时默认值为.js,.html,.css,.xml,.json,.shtml,.htm，否则为上次设置值

compress_min_length

否

Integer

参数解释：

压缩区间最小范围

约束限制：

如果未设置参与压缩的文件大小，默认大小为“0MB～30MB”的文件参与压缩。

取值范围：

• 文件大小范围（0MB～30MB），单位为Byte

默认取值：

不涉及

compress_max_length

否

Integer

参数解释：

压缩区间最大范围

约束限制：

如果未设置参与压缩的文件大小，默认大小为“0MB～30MB”的文件参与压缩。

取值范围：

• 文件大小范围（0MB～30MB），单位为Byte

默认取值：

不涉及

type

否

String

参数解释：

缓存URL参数操作类型，即资源缓存时，URL参数的缓存范围

约束限制：

不涉及

取值范围：

• full_url: 缓存所有参数

• ignore_url_params: 忽略所有参数

• del_params: 忽略指定URL参数

• reserve_params: 保留指定URL参数

默认取值：

不涉及

value

否

String

参数解释：

URL参数的取值

约束限制：

多个参数使用“;”分隔

取值范围：

不涉及

默认取值：

不涉及

code

否

Integer

参数解释：

需要缓存的错误码

约束限制：

不涉及

取值范围：

• 3xx: 301, 302

• 4xx: 400, 403, 404, 405, 407, 414, 416, 451

• 5xx: 500, 501, 502, 503, 504, 509, 514

默认取值：

不涉及

ttl

否

Integer

参数解释：

错误码缓存时间

约束限制：

不涉及

取值范围：

0-31536000，单位：秒

默认取值：

不涉及

type

是

String

参数解释：

UA黑白名单类型

约束限制：

不涉及

取值范围：

• off: 关闭UA黑白名单

• black: UA黑名单

• white: UA白名单

默认取值：

不涉及

value

否

String

参数解释：

UA黑白名单内容

约束限制：

• 当type=off时，非必传

• 最多配置50条规则

• 多条规则用“,”分隔

取值范围：

• 单条规则不超过200个字符

• 支持数字0-9、字符a-z、A-Z，空格，及特殊符"*"、"."、"-"、"_"、"("、")"、";"、","、"/"、"'"、"#"、"!"、"@"、"$"、"^"、"&"、"+"、"="、"~"、"?"、"""、"["、"]"、"{"、"}"、""、":"、"%"

默认取值：

不涉及

include_empty

否

Boolean

参数解释：

是否包含空UA

约束限制：

不涉及

取值范围：

true: 包含空

false:不包含空

默认取值：

• 当UA为黑名单时该字段默认值为false

• 当UA为白名单时该字段默认值为true

ua_list

否

Array of strings

参数解释：

配置UA黑白名单

约束限制：

• 当type=off时，非必传

• 最多配置50条规则

• 单条规则不超过200个字符

• 同时配置value和ua_list时，ua_list生效

priority

是

Integer

参数解释：

回源URL改写规则的优先级

约束限制：

• 不支持多条回源URL改写规则设置同一优先级

• 优先级不能输入为空

取值范围：

1-100

默认取值：

不涉及

match_type

是

String

参数解释：

匹配类型

约束限制：

不涉及

取值范围：

• all: 所有文件

• file_path: URI路径

• wildcard: 通配符

• full_path: 全路径

默认取值：

不涉及

source_url

否

String

参数解释：

需要替换的URI

约束限制：

匹配方式为“所有文件”时，不支持配置参数

取值范围：

• 1-512个字符

• 支持通配符*匹配，如：/test/*/*.mp4

• 以正斜线（/）开头的URI，不含http(s)://头及域名

默认取值：

不涉及

target_url

是

String

参数解释：

替换后的URI

约束限制：

取值范围：

• 1-256个字符

• 以正斜线（/）开头的URI，不含http(s)://头及域名

默认取值：

不涉及

match_type

是

String

参数解释：

URI的匹配方式

约束限制：

不涉及

取值范围：

• file_extension: 文件后缀匹配

• file_path: 目录路径

默认取值：

不涉及

match_pattern

是

String

参数解释：

URI的匹配规则

约束限制：

match_type为file_extension时：

• 支持所有格式的文件类型

• 输入首字符为“.”，以“;”进行分隔

• 输入的文件后缀名总数不能超过20个

match_type为file_path时：

• 要求以“/”作为首字符

• 以“;”进行分隔

• 输入的目录路径总数不能超过20个

取值范围：

1-512个字符

默认取值：

不涉及

priority

是

Integer

参数解释：

优先级

约束限制：

不涉及

取值范围：

1-100

默认取值：

不涉及

back_sources

是

Array of backSources objects

参数解释：

配置客户端请求匹配当前规则时，CDN节点回源访问的源站

约束限制：

每条规则的回源源站数量不超过1个

取值范围：

不涉及

默认取值：

不涉及

sources_type

是

String

参数解释：

源站类型

约束限制：

不涉及

取值范围：

• ipaddr: 源站IP

• domain: 源站域名

• obs_bucket: OBS桶域名

默认取值：

不涉及

ip_or_domain

是

String

参数解释：

源站IP或者域名

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

obs_bucket_type

否

String

参数解释：

OBS桶类型

约束限制：

不涉及

取值范围：

• private: 私有桶

• public: 公有桶

默认取值：

public: 公有桶

http_port

否

Integer

参数解释：

HTTP端口

约束限制：

不涉及

取值范围：

1-65535

默认取值：

80

https_port

否

Integer

参数解释：

HTTPS端口

约束限制：

不涉及

取值范围：

1-65535

默认取值：

443

remote_authentication

是

String

参数解释：

是否开启远程鉴权

约束限制：

不涉及

取值范围：

• on: 开启

• off: 关闭

默认取值：

不涉及

remote_auth_rules

是

RemoteAuthRule object

参数解释：

远程鉴权配置

约束限制：

不涉及

auth_server

是

String

参数解释：

可访问的鉴权服务器地址

约束限制：

• 输入的URL必须有“http”或“https”

• 不能是localhost或127.0.0.1这类本地地址

• 不能是CDN的加速域名

取值范围：

不涉及

默认取值：

不涉及

request_method

是

String

参数解释：

鉴权服务器支持的请求方法

约束限制：

不涉及

取值范围：

• GET

• POST

• HEAD

默认取值：

不涉及

file_type_setting

是

String

参数解释：

参与鉴权的文件类型

约束限制：

不涉及

取值范围：

• all: 所有文件均参与鉴权

• specific_file: 指定类型的文件参与鉴权。示例：jpg|MP4

默认取值：

不涉及

specified_file_type

否

String

参数解释：

参与鉴权的具体文件类型

约束限制：

• 当file_type_setting等于specific_file时为必选，其余情况为空

• 文件类型用竖线分隔，例如jpg|mp4

• 只有在必选情况下才会对该字段做校验

取值范围：

• 1-512个字符

• 由大小写字母和数字构成

默认取值：

不涉及

reserve_args_setting

是

String

参数解释：

参加鉴权的参数

约束限制：

不涉及

取值范围：

• reserve_all_args: 保留所有URL参数

• reserve_specific_args: 保留指定URL参数

• ignore_all_args: 忽略所有URL参数

默认取值：

不涉及

reserve_args

否

String

参数解释：

设置参数

约束限制：

• 当reserve_args_setting为reserve_specific_args时为必选，其余情况为空

• 多个参数用竖线分隔：key1|key2

取值范围：

不涉及

默认取值：

不涉及

add_custom_args_rules

否

Array of customArgs objects

参数解释：

设置CDN节点转发用户请求到远程鉴权服务器时需添加的参数

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

reserve_headers_setting

是

String

参数解释：

设置CDN节点转发用户请求到远程鉴权服务器时需要添加的请求头

约束限制：

不涉及

取值范围：

• reserve_all_headers: 保留所有请求头参数

• reserve_specific_headers: 保留指定请求头参数

• ignore_all_headers: 忽略所有请求头参数

默认取值：

不涉及

add_custom_headers_rules

否

Array of customArgs objects

参数解释：

请求头鉴权参数

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

auth_success_status

是

String

参数解释：

设置鉴权成功时远程鉴权服务器返回给CDN节点的状态码

约束限制：

不涉及

取值范围：

• 2xx

• 3xx

默认取值：

不涉及

auth_failed_status

是

String

参数解释：

设置鉴权失败时远程鉴权服务器返回给CDN节点的状态码

约束限制：

不涉及

取值范围：

• 4xx

• 5xx

默认取值：

不涉及

response_status

是

String

参数解释：

设置鉴权失败时CDN节点返回给用户的状态码

约束限制：

不涉及

取值范围：

• 2xx

• 3xx

• 4xx

• 5xx

默认取值：

不涉及

timeout

是

Integer

参数解释：

设置鉴权超时时间，即从CDN转发鉴权请求开始，到CDN节点收到远程鉴权服务器返回的结果的时间

约束限制：

不涉及

取值范围：

0或50-3000，单位：毫秒

默认取值：

不涉及

timeout_action

是

String

参数解释：

设置鉴权超时后，CDN节点如何处理用户请求

约束限制：

不涉及

取值范围：

• pass：鉴权超时后允许用户请求，返回对应的资源

• forbid：鉴权超时后拒绝用户请求，返回配置的响应自定义状态码给用户

默认取值：

不涉及

reserve_headers

否

String

参数解释：

要保留的请求头

约束限制：

• 当reserve_headers_setting为reserve_specific_headers时为必选，其余情况为空

• 多个请求头用竖线分隔：key1|key2

取值范围：

不涉及

默认取值：

不涉及

type

是

String

参数解释：

参数类型

约束限制：

不涉及

取值范围：

• custom_var: 自定义

• nginx_preset_var: 预置的变量

默认取值：

不涉及

key

是

String

参数解释：

参数名

约束限制：

不涉及

取值范围：

• 1-256个字符

• 由数字0-9、字符a-z、A-Z，及特殊字符._-*#%|+^@?=组成

默认取值：

不涉及

value

是

String

参数解释：

参数值

约束限制：

不涉及

取值范围：

• 当type为custom_var时支持1-256个字符，由数字0-9、字符a-z、A-Z，及特殊字符._-*#%|+^@?=组成

• 当type为nginx_preset_var时，value只能输入$http_host、$http_user_agent、$http_referer、$http_x_forwarded_for、$http_content_type、$remote_addr、$scheme、$server_protocol、$request_uri、$uri、$args、$request_method

默认取值：

不涉及

status

是

String

参数解释：

是否开启websocket协议

约束限制：

不涉及

取值范围：

• on: 开启

• off: 关闭

默认取值：

不涉及

timeout

否

Integer

参数解释：

请求建立连接后，会话的保持时间

约束限制：

不涉及

取值范围：

1-300，单位：秒，当status为on时必填

默认取值：

不涉及

enable_video_seek

是

Boolean

参数解释：

视频拖拽开关

约束限制：

当本字段设置为“false”时，查询域名配置接口将不会返回视频拖拽配置信息

取值范围：

• true: 开启

• false: 关闭

默认取值：

不涉及

enable_flv_by_time_seek

否

Boolean

参数解释：

flv时间拖拽开关

约束限制：

不涉及

取值范围：

• true: 开启

• false: 关闭

默认取值：

不涉及

start_parameter

否

String

参数解释：

自定义用户请求URL中视频播放的开始参数

约束限制：

不涉及

取值范围：

• 1-64个字符

• 支持使用数字0-9、字符a-z、A-Z，及"_"

默认取值：

不涉及

end_parameter

否

String

参数解释：

自定义用户请求URL中视频播放的结束参数

约束限制：

不涉及

取值范围：

• 1-64个字符

• 支持使用数字0-9、字符a-z、A-Z，及"_"

默认取值：

不涉及

status

否

String

参数解释：

是否开启请求限速

• 此为旧接口中的参数，后续将下线

• 只支持on，off无效

约束限制：

request_limit_rules字段置空时代表关闭请求限速功能

取值范围：

on

默认取值：

不涉及

priority

是

Integer

参数解释：

优先级

约束限制：

优先级不能相同

取值范围：

1-100

默认取值：

不涉及

match_type

是

String

参数解释：

匹配类型

约束限制：

不涉及

取值范围：

• all：所有文件

• catalog：目录

默认取值：

不涉及

match_value

否

String

参数解释：

匹配类型值

约束限制：

• 当match_type为all时传空值，例如：""

• 当match_type为catalog时传目录地址，以“/”作为首字符,例如："/test"

• 值为catalog的时候必填

取值范围：

不涉及

默认取值：

不涉及

type

是

String

参数解释：

限速方式

约束限制：

当前仅支持按流量大小限速，取值为size

取值范围：

不涉及

默认取值：

不涉及

limit_rate_after

是

Long

参数解释：

限速条件

约束限制：

不涉及

取值范围：

0-1073741824，单位：byte

默认取值：

不涉及

limit_rate_value

是

Integer

参数解释：

限速值，即达到限速条件后的最大访问速度

约束限制：

不涉及

取值范围：

0-104857600，单位：Bps

默认取值：

不涉及

limit_time

否

String

参数解释：

指明限速的时段

约束限制：

• 按照每天24小时设置限速时段，格式为：HHMM-HHMM（HH为时，MM为分，时区为UTC+8）

• 多个时段限速时用“,”分隔，例如：0100-0200,2200-2300

• 最多可配置10个时段

取值范围：

不涉及

默认取值：

0000-2400

status

是

String

参数解释：

IP访问限频状态开关

约束限制：

不涉及

取值范围：

• on: 开启

• off: 关闭

默认取值：

不涉及

qps

否

Integer

参数解释：

访问阈值

约束限制：

当开启ip限频时，访问阈值必填

取值范围：

1-100000，单位：次/秒

默认取值：

不涉及

status

是

String

参数解释：

HSTS功能状态开关

约束限制：

不涉及

取值范围：

• on: 开启

• off: 关闭

默认取值：

不涉及

max_age

否

Integer

参数解释：

过期时间，即响应头“Strict-Transport-Security”在客户端的缓存时间

约束限制：

status参数为on时，必传

取值范围：

0-63072000，单位：秒

默认取值：

不涉及

include_subdomains

否

String

参数解释：

是否包含子域名

约束限制：

status参数为on时，必传

取值范围：

• on: 包含

• off: 不包含

默认取值：

不涉及

status

是

String

参数解释：

QUIC功能状态开关

约束限制：

不涉及

取值范围：

• on: 开启

• off: 关闭

默认取值：

不涉及

error_code

是

Integer

参数解释：

重定向的错误码

约束限制：

不涉及

取值范围：

• 4xx: 400, 403, 404, 405, 414, 416, 451

• 5xx: 500, 501, 502, 503, 504

默认取值：

不涉及

target_code

是

Integer

参数解释：

重定向状态码

约束限制：

不涉及

取值范围：

• 301

• 302

默认取值：

不涉及

target_link

是

String

参数解释：

重定向的目标链接

约束限制：

必须以http://或https://开头

取值范围：

不涉及

默认取值：

不涉及

status

是

String

参数解释：

是否开启回源SNI

约束限制：

不涉及

取值范围：

• on: 开启

• off: 关闭

默认取值：

不涉及

server_name

否

String

参数解释：

CDN节点回源时使用HTTPS协议握手的sni域名

约束限制：

• 开启回源SNI时必填

取值范围：

• 仅支持输入数字、“-”、“.”、英文大小写字符

默认取值：

condition

是

UrlRewriteCondition object

参数解释：

匹配条件

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

redirect_status_code

否

Integer

参数解释：

重定向状态码

约束限制：

不涉及

取值范围：

• 301

• 302

• 303

• 307

默认取值：

不涉及

redirect_url

是

String

参数解释：

重定向URL

约束限制：

• 重定向后的URL，以正斜线（/）开头，不含http://头及域名，如：/test/index.html

• 当匹配类型为全路径时，"*"可以用“$1”捕获，例如：匹配内容为/test/*.jpg，重定向URL配置为/newtest/$1.jpg，则用户请求/test/11.jpg时，$1捕获11，重定向后请求的URL为/newtest/11.jpg

取值范围：

不涉及

默认取值：

不涉及

redirect_host

否

String

参数解释：

支持将客户端请求重定向到其他域名

约束限制：

不涉及

取值范围：

• 1-255个字符

• 必须以http://或https://开头

默认取值：

不填时默认为当前域名

execution_mode

是

String

参数解释：

执行规则

约束限制：

不涉及

取值范围：

• redirect: 如果请求的URL匹配了当前规则，该请求将被重定向到目标Path。执行完当前规则后，当存在其他配置规则时，会继续匹配剩余规则

• break: 如果请求的URL匹配了当前规则，请求将被改写为目标Path。执行完当前规则后，当存在其他配置规则时，将不再匹配剩余规则，此时不支持配置重定向Host和重定向状态码，返回状态码200

默认取值：

不涉及

match_type

是

String

参数解释：

匹配类型

约束限制：

不涉及

取值范围：

• catalog: 指定目录下的文件需执行访问URL重写规则

• full_path: 某个完整路径下的文件需执行访问URL重写规则

默认取值：

不涉及

match_value

是

String

参数解释：

匹配内容

约束限制：

• 当match_type为catalog时，为目录路径，输入要求以“/”作为首字符，以“,”进行分隔，如/test/folder01,/test/folder02，并且输入的目录路径总数不超过20个

• 当match_type为full_path时，为全路径，输入要求以“/”作为首字符，支持匹配指定目录下的具体文件，或者带通配符“*”的文件，单条全路径缓存规则里仅支持配置一个全路径，如/test/index.html或/test/*.jpg

取值范围：

不涉及

默认取值：

不涉及

priority

是

Integer

参数解释：

访问URL重写规则的优先级

约束限制：

不支持多条规则设置同一优先级

取值范围：

1-100

默认取值：

不涉及

condition

是

BrowserCacheRulesCondition object

参数解释：

匹配条件

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

cache_type

是

String

参数解释：

缓存生效类型

约束限制：

不涉及

取值范围：

• follow_origin: 遵循源站的缓存策略，即Cache-Control头部的设置

• ttl: 浏览器缓存遵循当前规则设置的过期时间

• never: 浏览器不缓存资源

默认取值：

不涉及

ttl

否

Integer

参数解释：

缓存过期时间

约束限制：

• 最大支持365天

• 当缓存生效类型为ttl时必填

取值范围：

不涉及

默认取值：

不涉及

ttl_unit

否

String

参数解释：

缓存过期时间单位

约束限制：

当缓存生效类型为ttl时必填

取值范围：

• s：秒

• m：分钟

• h：小时

• d：天

默认取值：

不涉及

match_type

是

String

参数解释：

匹配类型

约束限制：

不涉及

取值范围：

• all: 匹配所有文件

• file_extension: 按文件后缀匹配

• catalog: 按目录匹配

• full_path: 全路径匹配

• home_page: 按首页匹配

默认取值：

不涉及

match_value

否

String

参数解释：

缓存匹配设置

约束限制：

• 当match_type为all时，置空

• 当match_type为file_extension时，为文件后缀，输入首字符为“.”，以“,”进行分隔， 如.jpg,.zip,.exe，并且输入的文 件名后缀总数不超过20个

• 当match_type为catalog时，为目录，输入要求以“/”作为首字符， 以“,”进行分隔，如/test/folder01,/test/folder02，并且输入的目录路径总数不超过20个

• 当match_type为full_path时，为全路径，输入要求以“/”作为首字符，支持匹配指定目录下的具体文件，或者带通配符“*”的文件， “*”的位置必须在最后一个“/”的后一位，且不能以“*”结尾，单条全路径缓存规则里仅支持配置一个全路径，如/test/index.html或/test/*.jpg

• 当match_type为home_page时，置空

取值范围：

不涉及

默认取值：

不涉及

priority

是

Integer

参数解释：

浏览器缓存的优先级, 数值越大优先级越高

约束限制：

不支持多条规则设置同一优先级

取值范围：

不涉及

默认取值：

1-100

type

是

String

参数解释：

规则类型

约束限制：

不涉及

取值范围：

• black: 黑名单，如果匹配到黑名单规则，则黑名单所选区域内的用户将无法访问当前资源，返回403状态码

• white: 白名单，白名单所选区域以外的用户均无法访问当前资源，返回403状态码

默认取值：

不涉及

content_type

是

String

参数解释：

生效类型

约束限制：

不涉及

取值范围：

• all: 所有文件，所有文件均遵循配置的规则

• file_directory: 目录路径，指定目录路径的资源遵循配置的规则

• file_path: 全路径，指定路径的资源遵循配置的规则

默认取值：

不涉及

content_value

否

String

参数解释：

生效规则

约束限制：

• 当content_type为all时，置空或不传

• 当content_type为file_directory时，输入要求以“/”作为首字符，多个目录以“,”进行分隔，如/test/folder01,/test/folder02，并且输入的目录路径总数不超过100个

• 当content_type为file_path时，输入要求以“/”或“*”作为首字符，支持配置通配符“*”，通配符不能连续出现且不能超过两个。多个路径以“,”进行分隔，如/test/a.txt,/test/b.txt，并且输出的总数不能超过100个

• 不允许配置两条完全一样的白名单或黑名单规则

• 仅允许配置一条生效类型为“所有文件”的规则

取值范围：

不涉及

默认取值：

不涉及

area

是

String

参数解释：

配置规则适用的区域

约束限制：

• 多个区域以“,”进行分隔

• 支持的区域如：CN_IN：中国大陆，AF：阿富汗，IE：爱尔兰，EG：埃及，AU：澳大利亚等。具体的位置编码参见《附录-地理位置编码》查询

取值范围：

不涉及

默认取值：

不涉及

exception_ip

否

String

参数解释：

例外IP，配置指定IP不执行当前规则

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

status

是

String

参数解释：

客户端证书配置开关

约束限制：

不涉及

取值范围：

• on: 开启

• off: 关闭

默认取值：

不涉及

trusted_cert

是

String

参数解释：

客户端CA证书的内容

约束限制：

仅支持PEM格式

取值范围：

不涉及

默认取值：

不涉及

hosts

否

String

参数解释：

客户端CA证书指定的域名

约束限制：

• 如果不配置域名，则CDN会放行所有持有该CA证书的客户端请求

• 最多可配置100个域名

• 多个域名用“,”或“|”分隔

取值范围：

不涉及

默认取值：

不涉及