Data Types

Prev Next

search by keyword

Recent Pages

Documentation

Download PDF

Last updated: 2022-06-15 09:55:14

Download PDF

AccessControl

Request header and request URL access control

Used by actions: DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Switch	String	Yes	Whether to enable request header and request URL access control. Valid values: on, off
AccessControlRules	Array of AccessControlRule	No	Request header and request URL access rule Note: this field may return null, indicating that no valid values can be obtained.
ReturnCode	Integer	No	Returned status code Note: this field may return null, indicating that no valid values can be obtained.

AccessControlRule

Access control rule

Used by actions: DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
RuleType	String	Yes	requestHeader: access control over request header url: access control over access URL Note: this field may return null, indicating that no valid values can be obtained.
RuleContent	String	Yes	Blocked content Note: this field may return null, indicating that no valid values can be obtained.
Regex	String	Yes	on: regular match off: exact match Note: this field may return null, indicating that no valid values can be obtained.
RuleHeader	String	No	This parameter is required only if `RuleType` is `requestHeader` Note: this field may return null, indicating that no valid values can be obtained.

AdvanceCacheRule

Advanced cache configuration rules

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
CacheType	String	Yes	Rule types: `all`: effective for all files `file`: effective for specified file suffixes `directory`: effective for specified paths `path`: effective for specified absolute paths `default`: the cache rules when the origin server has not returned max-age Note: this field may return null, indicating that no valid values can be obtained.
CacheContents	Array of String	Yes	Content for each CacheType: For `all`, enter an asterisk (*). For `file`, enter the suffix, such as jpg, txt. For `directory`, enter the path, such as /xxx/test/. For `path`, enter the corresponding absolute path, such as /xxx/test.html. For `default`, enter "no max-age". Note: this field may return null, indicating that no valid values can be obtained.
CacheTime	Integer	Yes	Cache expiration time Unit: second. The maximum value is 365 days. Note: this field may return null, indicating that no valid values can be obtained.

AdvanceConfig

Advanced configuration set

Used by actions: DescribeDomainsConfig.

Name	Type	Description
Name	String	Advanced configuration name Note: this field may return `null`, indicating that no valid values can be obtained.
Value	String	Whether advanced configuration is supported: `on`: support `off`: do not support Note: this field may return `null`, indicating that no valid values can be obtained.

AdvanceHttps

Custom HTTPS forwarding configuration

Used by actions: AddCdnDomain, DescribeDomains, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
CustomTlsStatus	String	No	Custom TLS data switch Note: this field may return `null`, indicating that no valid values can be obtained.
TlsVersion	Array of String	No	Specifies the TLS version. Valid values: `TLSv1`, `TLSV1.1`, `TLSV1.2`, and `TLSv1.3`. Only consecutive versions can be enabled at the same time. Note: this field may return `null`, indicating that no valid values can be obtained.
Cipher	String	No	Custom encryption suite Note: this field may return `null`, indicating that no valid values can be obtained.
VerifyOriginType	String	No	Origin authentication type `off`: disable authentication `oneWay`: authenticate the origin `twoWay`: two-way authentication Note: this field may return `null`, indicating that no valid values can be obtained.
CertInfo	ServerCert	No	Information of the origin-pull certificate Note: this field may return `null`, indicating that no valid values can be obtained.
OriginCertInfo	ClientCert	No	Information of the origin server certificate Note: this field may return `null`, indicating that no valid values can be obtained.

AdvancedAuthentication

Timestamp hotlink protection advanced configuration (allowlist feature)

Used by actions: DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Switch	String	Yes	Hotlink protection configuration switch (which can be on or off). If it is enabled, only one mode can and must be configured, while other modes are null.
TypeA	AdvancedAuthenticationTypeA	No	Timestamp hotlink protection advanced configuration mode A Note: this field may return `null`, indicating that no valid values can be obtained.
TypeB	AdvancedAuthenticationTypeB	No	Timestamp hotlink protection advanced configuration mode B Note: this field may return `null`, indicating that no valid values can be obtained.
TypeC	AdvancedAuthenticationTypeC	No	Timestamp hotlink protection advanced configuration mode C Note: this field may return `null`, indicating that no valid values can be obtained.
TypeD	AdvancedAuthenticationTypeD	No	Timestamp hotlink protection advanced configuration mode D Note: this field may return `null`, indicating that no valid values can be obtained.
TypeE	AdvancedAuthenticationTypeE	No	Timestamp hotlink protection advanced configuration mode E Note: this field may return `null`, indicating that no valid values can be obtained.
TypeF	AdvancedAuthenticationTypeF	No	Timestamp hotlink protection advanced configuration mode F Note: this field may return `null`, indicating that no valid values can be obtained.

AdvancedAuthenticationTypeA

Timestamp hotlink protection advanced configuration mode A

Used by actions: DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
SecretKey	String	Yes	Key used for signature calculation, allowing 6 to 32 bytes of letters and digits.
SignParam	String	Yes	Signature field name in the URI string, starting with a letter, and consisting of letters, digits, and underscores.
TimeParam	String	Yes	Time field name in the URI string, starting with a letter, and consisting of letters, digits, and underscores.
ExpireTime	Integer	Yes	Expiration time in seconds
ExpireTimeRequired	Boolean	Yes	Whether the expiration time parameter is required
Format	String	Yes	URL composition, e.g., `${private_key}${schema}${host}${full_uri}`.
TimeFormat	String	Yes	Time format. Valid values: dec (decimal), hex (hexadecimal).
FailCode	Integer	Yes	Status code returned when the authentication failed
ExpireCode	Integer	Yes	Status code returned when the URL expired
RulePaths	Array of String	Yes	List of URLs to be authenticated
Transformation	Integer	No	Reserved field

AdvancedAuthenticationTypeB

Timestamp hotlink protection advanced configuration mode B

Used by actions: DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
KeyAlpha	String	Yes	Alpha key name
KeyBeta	String	Yes	Beta key name
KeyGamma	String	Yes	Gamma key name
SignParam	String	Yes	Signature field name in the URI string, starting with a letter, and consisting of letters, digits, and underscores.
TimeParam	String	Yes	Time field name in the URI string, starting with a letter, and consisting of letters, digits, and underscores.
ExpireTime	Integer	Yes	Expiration time in seconds
TimeFormat	String	Yes	Time format. Valid values: dec (decimal), hex (hexadecimal).
FailCode	Integer	Yes	Status code returned when the authentication failed
ExpireCode	Integer	Yes	Status code returned when the URL expired
RulePaths	Array of String	Yes	List of URLs to be authenticated

AdvancedAuthenticationTypeC

Timestamp hotlink protection advanced configuration mode C

Used by actions: DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
AccessKey	String	Yes	Access key
SecretKey	String	Yes	Authentication key

AdvancedAuthenticationTypeD

Timestamp hotlink protection advanced configuration mode D

Used by actions: DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
SecretKey	String	Yes	Key used for signature calculation, allowing 6 to 32 bytes of letters and digits.
BackupSecretKey	String	Yes	Alternative key used for authentication after the authentication key (`SecretKey`) failed
SignParam	String	Yes	Signature field name in the URI string, starting with a letter, and consisting of letters, digits, and underscores.
TimeParam	String	Yes	Time field name in the URI string, starting with a letter, and consisting of letters, digits, and underscores.
ExpireTime	Integer	Yes	Expiration time in seconds
TimeFormat	String	Yes	Time format. Valid values: dec (decimal), hex (hexadecimal).

AdvancedAuthenticationTypeE

Timestamp hotlink protection advanced configuration mode E

Used by actions: DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
SecretKey	String	Yes	Key used for signature calculation, allowing 6 to 32 bytes of letters and digits. Note: this field may return `null`, indicating that no valid values can be obtained.
SignParam	String	Yes	Signature field name in the URI string, starting with a letter, and consisting of letters, digits, and underscores. Note: this field may return `null`, indicating that no valid values can be obtained.
AclSignParam	String	Yes	ACL signature field name in the URI string, starting with a letter, and consisting of letters, digits, and underscores. Note: this field may return `null`, indicating that no valid values can be obtained.
StartTimeParam	String	Yes	Start time field name in the URI string, starting with a letter, and consisting of letters, digits, and underscores. Note: this field may return `null`, indicating that no valid values can be obtained.
ExpireTimeParam	String	Yes	Expiration time field name in the URI string, starting with a letter, and consisting of letters, digits, and underscores. Note: this field may return `null`, indicating that no valid values can be obtained.
TimeFormat	String	Yes	Time format (dec) Note: this field may return `null`, indicating that no valid values can be obtained.

AdvancedAuthenticationTypeF

Timestamp hotlink protection advanced authentication configuration mode F (TypeF)

Used by actions: DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
SignParam	String	Yes	Signature field name in the URI string, starting with a letter, and consisting of letters, digits, and underscores. Note: this field may return `null`, indicating that no valid values can be obtained.
TimeParam	String	Yes	Time field name in the URI string, starting with a letter, and consisting of letters, digits, and underscores. Note: this field may return `null`, indicating that no valid values can be obtained.
TransactionParam	String	Yes	Transaction field name in the URI string, starting with a letter, and consisting of letters, digits, and underscores. Note: this field may return `null`, indicating that no valid values can be obtained.
SecretKey	String	Yes	CMK used for signature calculation, allowing 6 to 32 bytes of letters and digits. Note: this field may return `null`, indicating that no valid values can be obtained.
BackupSecretKey	String	No	Alternative key used for signature calculation, which is used after the CMK fails in authentication. It allows 6 to 32 bytes of letters and digits. Note: this field may return `null`, indicating that no valid values can be obtained.

AdvancedCCRules

SCDN custom CC rules

Used by actions: UpdateScdnDomain.

Name	Type	Required	Description
RuleName	String	No	Rule name
DetectionTime	Integer	No	Detection duration Note: this field may return `null`, indicating that no valid values can be obtained.
FrequencyLimit	Integer	No	Detection frequency threshold Note: this field may return `null`, indicating that no valid values can be obtained.
PunishmentSwitch	String	No	Whether to enable IP penalty. Valid values: `on` and `off`. Note: this field may return `null`, indicating that no valid values can be obtained.
PunishmentTime	Integer	No	IP penalty duration Note: this field may return `null`, indicating that no valid values can be obtained.
Action	String	No	Action. Valid values: `intercept` and `redirect`. Note: this field may return `null`, indicating that no valid values can be obtained.
RedirectUrl	String	No	A redirection URL used when Action is `redirect` Note: this field may return `null`, indicating that no valid values can be obtained.
Configure	Array of ScdnSevenLayerRules	No	Layer-7 rule configuration for CC frequency limiting Note: this field may return `null`, indicating that no valid values can be obtained.

AdvancedCache

(Disused) Advanced cache validity configuration. You can use RuleCache instead.

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
CacheRules	Array of AdvanceCacheRule	Yes	Cache expiration rule Note: this field may return null, indicating that no valid values can be obtained.
IgnoreCacheControl	String	Yes	Forced cache configuration on: enabled off: disabled When this is enabled, if the origin server returns no-cache, no-store headers, node caching will still be performed according to the cache expiration rules. This is disabled by default Note: this field may return null, indicating that no valid values can be obtained.
IgnoreSetCookie	String	Yes	Whether to cache the header and body on cache nodes if the origin server returns the header `Set-Cookie`. on: Enable; do not cache the header and body. off: Disable; follow the custom cache rules of cache nodes. It is disabled by default. Note: this field may return `null`, indicating that no valid values can be obtained.

AdvancedScdnAclGroup

SCDN precise access control configuration

Used by actions: UpdateScdnDomain.

Name	Type	Required	Description
RuleName	String	Yes	Rule name
Configure	Array of AdvancedScdnAclRule	Yes	Specific configurations
Result	String	Yes	Action. Valid values: `intercept` and `redirect`.
Status	String	No	Whether the rule is activated. Valid values: `active` and `inactive`.
ErrorPage	ScdnErrorPage	No	Error page configuration

AdvancedScdnAclRule

Precise access control rule

Used by actions: UpdateScdnDomain.

Name	Type	Required	Description
MatchKey	String	Yes	Keyword. Valid values: `protocol`: HTTP protocol `httpVersion`: HTTP version `method`: request method `ip`: requester IP `ipAsn`: ASN of the requester IP `ipCountry`: country/region of the requester IP `ipArea`: region of the requester IP `xForwardFor`: X-Forward-For request header `directory`: path `index`: homepage `path`: full path of a file `file`: file extension `param`: request parameter `referer`: Referer request header `cookie`: Cookie request header `userAgent`: User-Agent request header `head`: custom request header
LogicOperator	String	Yes	Logical operator. Valid values: `exclude`: the keyword is not included `include`: the keyword is included `notequal`: not the same as the keyword `equal`: the same as the keyword `matching`: the prefix is matched `null`: empty or does not exist
MatchValue	Array of String	Yes	Match value When `MatchKey` is `protocol`, Values: `HTTP` and `HTTPS`. When `MatchKey` is `httpVersion`, Values: `HTTP/1.0`, `HTTP/1.1`, `HTTP/1.2`, `HTTP/2`, and `HTTP/3`. When `MatchKey` is `method`, Values: `HEAD`, `GET`, `POST`, `PUT`, `OPTIONS`, `TRACE`, `DELETE`, `PATCH` and `CONNECT`. When `MatchKey` is `ipCountry`, valid values include: `OTHER`: other countries/regions `VE`: Venezuela `UY`: Uruguay `SR`: Suriname `PY`: Paraguay `PE`: Peru `GY`: Guyana `EC`: Ecuador `CO`: Colombia `CL`: Chile `BR`: Brazil `BO`: Bolivia `AR`: Argentina `NZ`: New Zealand `WS`: Samoa `VU`: Vanuatu `TV`: Tuvalu `TO`: Tonga `TK`: Tokelau `PW`: Palau `NU`: Niue `NR`: Nauru `KI`: Kiribati `GU`: Guam `FM`: Micronesia `AU`: Australia `US`: United States `PR`: Puerto Rico `DO`: Dominican Republic `CR`: Costa Rica `AS`: American Samoa `AG`: Antigua and Barbuda `PA`: Panama `NI`: Nicaragua `MX`: Mexico `JM`: Jamaica `HT`: Haiti `HN`: Honduras `GT`: Guatemala `GP`: Guadeloupe `GL`: Greenland `GD`: Grenada `CU`: Cuba `CA`: Canada `BZ`: Belize `BS`: Bahamas `BM`: Bermuda `BB`: Barbados `AW`: Aruba `AI`: Anguilla `VA`: Vatican `SK`: Slovakia `RU`: Russia `GB`: United Kingdom `CZ`: Czech Republic `UA`: Ukraine `TR`: Turkey `SI`: Slovenia `SE`: Sweden `RS`: Republic of Serbia `RO`: Romania `PT`: Portugal `PL`: Poland `NO`: Norway `NL`: Netherlands `MT`: Malta `MK`: Macedonia `ME`: Montenegro `MD`: Moldova `MC`: Monaco `LV`: Latvia `LU`: Luxembourg `LT`: Lithuania `LI`: Liechtenstein `KZ`: Kazakhstan `IT`: Italy `IS`: Iceland `IE`: Ireland `HU`: Hungary `HR`: Croatia `GR`: Greece `GI`: Gibraltar `GG`: Guernsey `GE`: Georgia `FR`: France `FI`: Finland `ES`: Spain `EE`: Estonia `DK`: Denmark `DE`: Germany `CY`: Cyprus `CH`: Switzerland `BY`: Belarus `BG`: Bulgaria `BE`: Belgium `AZ`: Azerbaijan `AT`: Austria `AM`: Armenia `AL`: Albania `AD`: Andorra `TL`: East Timor `SY`: Syria `SA`: Saudi Arabia `PS`: Palestine `LK`: Sri Lanka `LK`: Sri Lanka `KP`: North Korea `KG`: Kyrgyzstan `HK`: Hong Kong, China `BN`: Brunei `BD`: Bangladesh `AE`: United Arab Emirates `YE`: Yemen `VN`: Vietnam `UZ`: Uzbekistan `TW`: Taiwan, China `TM`: Turkmenistan `TJ`: Tajikistan `TH`: Thailand `SG`: Singapore `QA`: Qatar `PK`: Pakistan `PH`: Philippines `OM`: Oman `NP`: Nepal `MY`: Malaysia `MV`: Maldives `MO`: Macao, China `MN`: Mongolia `MM`: Myanmar `LB`: Lebanon `KW`: Kuwait `KR`: South Korea `KH`: Cambodia `JP`: Japan `JO`: Jordan `IR`: Iran `IQ`: Iraq `IN`: India `IL`: Israel `ID`: Indonesia `CN`: China `BT`: Bhutan `BH`: Bahrain `AF`: Afghanistan `LY`: Libya `CD`: Democratic Republic of the Congo `RE`: La Réunion `SZ`: Swaziland `ZW`: Zimbabwe `ZM`: Zambia `YT`: Mayotte `UG`: Uganda `TZ`: Tanzania `TN`: Tunisia `TG`: Togo `TD`: Chad `SO`: Somalia `SN`: Senegal `SD`: Sudan `SC`: Seychelles `RW`: Rwanda `NG`: Nigeria `NE`: Niger `NA`: Namibia `MZ`: Mozambique `MW`: Malawi `MU`: Mauritius `MR`: Mauritania `ML`: Mali `MG`: Madagascar `MA`: Morocco `LS`: Lesotho `LR`: Liberia `KM`: Comoros `KE`: Kenya `GN`: Guinea `GM`: Gambia `GH`: Ghana `GA`: Gabon `ET`: Ethiopia `ER`: Eritrea `EG`: Egypt `DZ`: Algeria `DJ`: Djibouti `CM`: Cameroon `CG`: Republic of the Congo `BW`: Botswana `BJ`: Benin `BI`: Burundi `AO`: Angola When MatchKey is `ipArea`, valid values include: `OTHER`: other areas `AS`: Asia `EU`: Europe `AN`: Antarctica `AF`: Africa `OC`: Oceania `NA`: North America `SA`: South America When MatchKey is `index`, valid value is `/;/index.html`.
CaseSensitive	Boolean	No	Whether to distinguish uppercase or lowercase letters. `true`: case sensitive; `false`: case insensitive.
MatchKeyParam	String	No	This field is required when `MatchKey` is `param` or `cookie`. For `param`, it indicates a key value of the request parameter if MatchKey is `param`, while a key value of the Cookie request header if MatchKey is `cookie`.

Authentication

Timestamp hotlink protection configuration

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Switch	String	Yes	Hotlink protection configuration switch on: enabled off: disabled When this is enabled, one mode needs to be configured. Other modes need to be set to null.
TypeA	AuthenticationTypeA	No	Timestamp hotlink protection mode A configuration Note: this field may return null, indicating that no valid values can be obtained.
TypeB	AuthenticationTypeB	No	Timestamp hotlink protection mode B configuration (mode B is being upgraded and is currently not supported) Note: this field may return null, indicating that no valid values can be obtained.
TypeC	AuthenticationTypeC	No	Timestamp hotlink protection mode C configuration Note: this field may return null, indicating that no valid values can be obtained.
TypeD	AuthenticationTypeD	No	Timestamp hotlink protection mode D configuration Note: this field may return null, indicating that no valid values can be obtained.

AuthenticationTypeA

Timestamp hotlink protection mode A configuration
The access URL format of timestamp hotlink protection mode A is as follows: http://DomainName/Filename?sign=timestamp-rand-uid-md5hash
Here, timestamp is a decimal timestamp in Unix format;
rand is a random string composed of 0-100 characters, including digits, upper and lower-case letters.
uid is 0;
md5hash: MD5 (file path-timestamp-rand-uid-custom key)

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
SecretKey	String	Yes	The key for signature calculation Only digits, upper and lower-case letters are allowed. Length limit: 6-32 characters. Note: this field may return null, indicating that no valid values can be obtained.
SignParam	String	Yes	Signature parameter name Only upper and lower-case letters, digits, and underscores (_) are allowed. It cannot start with a digit. Length limit: 1-100 characters.
ExpireTime	Integer	Yes	Signature expiration time Unit: second. The maximum value is 630720000.
FileExtensions	Array of String	Yes	File extension list settings determining if authentication should be performed If it contains an asterisk (*), this indicates all files.
FilterType	String	Yes	allowlist: indicates that all file types apart from the FileExtensions list are authenticated blacklist: indicates that only the file types in the FileExtensions list are authenticated
BackupSecretKey	String	No	Backup key, which is used to calculate a signature. 6-32 characters. Only digits and letters are allowed. Note: this field may return `null`, indicating that no valid values can be obtained.

AuthenticationTypeB

Timestamp hotlink protection mode B configuration (mode B is being upgraded and is currently not supported)

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
SecretKey	String	Yes	The key for signature calculation Only digits, upper and lower-case letters are allowed. Length limit: 6-32 characters. Note: this field may return null, indicating that no valid values can be obtained.
ExpireTime	Integer	Yes	Signature expiration time Unit: second. The maximum value is 630720000.
FileExtensions	Array of String	Yes	File extension list settings determining if authentication should be performed If it contains an asterisk (*), this indicates all files.
FilterType	String	Yes	allowlist: indicates that all file types apart from the FileExtensions list are authenticated blacklist: indicates that only the file types in the FileExtensions list are authenticated
BackupSecretKey	String	No	Backup key, which is used to calculate a signature. 6-32 characters. Only digits and letters are allowed. Note: this field may return `null`, indicating that no valid values can be obtained.

AuthenticationTypeC

Timestamp hotlink protection mode C configuration
The access URL format of timestamp hotlink protection mode C is as follows: http://DomainName/md5hash/timestamp/FileName
Here, timestamp is a hexadecimal timestamp in Unix format;
md5hash: MD5 (custom key + file path + timestamp)

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
SecretKey	String	Yes	The key for signature calculation Only digits, upper and lower-case letters are allowed. Length limit: 6-32 characters. Note: this field may return null, indicating that no valid values can be obtained.
ExpireTime	Integer	Yes	Signature expiration time Unit: second. The maximum value is 630720000.
FileExtensions	Array of String	Yes	File extension list settings determining if authentication should be performed If it contains an asterisk (*), this indicates all files.
FilterType	String	Yes	allowlist: indicates that all file types apart from the FileExtensions list are authenticated blacklist: indicates that only the file types in the FileExtensions list are authenticated
TimeFormat	String	No	Timestamp settings dec: decimal hex: hexadecimal Note: this field may return `null`, indicating that no valid value is obtained.
BackupSecretKey	String	No	Backup key, which is used to calculate a signature. 6-32 characters. Only digits and letters are allowed. Note: this field may return `null`, indicating that no valid values can be obtained.

AuthenticationTypeD

Timestamp hotlink protection mode D configuration
The access URL format of timestamp hotlink protection mode D is as follows: http://DomainName/FileName?sign=md5hash&t=timestamp
Here, timestamp is a decimal or hexadecimal timestamp in Unix format;
md5hash: MD5 (custom key + file path + timestamp)

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
SecretKey	String	Yes	The key for signature calculation Only digits, upper and lower-case letters are allowed. Length limit: 6-32 characters. Note: this field may return null, indicating that no valid values can be obtained.
ExpireTime	Integer	Yes	Signature expiration time Unit: second. The maximum value is 630720000.
FileExtensions	Array of String	Yes	File extension list settings determining if authentication should be performed If it contains an asterisk (*), this indicates all files.
FilterType	String	Yes	allowlist: indicates that all file types apart from the FileExtensions list are authenticated blacklist: indicates that only the file types in the FileExtensions list are authenticated
SignParam	String	Yes	Signature parameter name Only upper and lower-case letters, digits, and underscores (_) are allowed. It cannot start with a digit. Length limit: 1-100 characters.
TimeParam	String	Yes	Timestamp parameter name Only upper and lower-case letters, digits, and underscores (_) are allowed. It cannot start with a digit. Length limit: 1-100 characters.
TimeFormat	String	Yes	Timestamp settings dec: decimal hex: hexadecimal
BackupSecretKey	String	No	Backup key, which is used to calculate a signature. 6-32 characters. Only digits and letters are allowed. Note: this field may return `null`, indicating that no valid values can be obtained.

AwsPrivateAccess

Origin access authentication for S3 bucket.

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Switch	String	Yes	Switch, which can be set to on or off.
AccessKey	String	No	Access ID. Note: this field may return null, indicating that no valid values can be obtained.
SecretKey	String	No	Key. Note: this field may return null, indicating that no valid values can be obtained.

BandwidthAlert

Bandwidth cap configuration. This is disabled by default.

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Switch	String	Yes	Specifies whether to enable the bandwidth cap `on`: enable `off`: disable
BpsThreshold	Integer	No	The upper limit of bandwidth usage (in bps) or traffic usage (in bytes). Note: this field may return `null`, indicating that no valid values can be obtained.
CounterMeasure	String	No	Action taken when threshold is reached RESOLVE_DNS_TO_ORIGIN: requests will be forwarded to the origin server. This is only supported for domain names of external origin. RETURN_404: a 404 error will be returned for all requests. Note: this field may return null, indicating that no valid values can be obtained.
LastTriggerTime	Timestamp	No	The last time when the usage upper limit in the Chinese mainland was reached Note: this field may return `null`, indicating that no valid values can be obtained.
AlertSwitch	String	No	Indicates whether to trigger alerts when the upper limit is reached `on`: enable `off`: disable Note: this field may return `null`, indicating that no valid values can be obtained.
AlertPercentage	Integer	No	Triggers alarms when the ratio of bandwidth or traffic usage to the usage upper limit reaches the specified value Note: this field may return `null`, indicating that no valid values can be obtained.
LastTriggerTimeOverseas	Timestamp	No	The last time when the usage outside the Chinese mainland reached the upper limit Note: this field may return `null`, indicating that no valid values can be obtained.
Metric	String	No	Dimension of the usage limit `bandwidth`: bandwidth `flux`: traffic Note: this field may return `null`, indicating that no valid values can be obtained.

BotCookie

Bot cookie policy

Used by actions: UpdateScdnDomain.

Name	Type	Required	Description
Switch	String	Yes	Valid values: `on` and `off`.
RuleType	String	Yes	Rule type, which can only be `all` currently.
RuleValue	Array of String	Yes	Rule value. Valid value: `*`.
Action	String	Yes	Action. Valid values: `monitor`, `intercept`, `redirect`, and `captcha`.
RedirectUrl	String	No	Redirection target page Note: this field may return `null`, indicating that no valid values can be obtained.
UpdateTime	Timestamp	No	Update time Note: this field may return `null`, indicating that no valid values can be obtained.

BotJavaScript

Bot JS policy

Used by actions: UpdateScdnDomain.

Name	Type	Required	Description
Switch	String	Yes	Valid values: `on` and `off`.
RuleType	String	Yes	Rule type, which can only be `file` currently.
RuleValue	Array of String	Yes	Rule value. Valid values: `html` and `htm`.
Action	String	Yes	Action. Valid values: `monitor`, `intercept`, `redirect`, and `captcha`.
RedirectUrl	String	No	Redirection target page Note: this field may return `null`, indicating that no valid values can be obtained.
UpdateTime	Timestamp	No	Update time Note: this field may return `null`, indicating that no valid values can be obtained.

BriefDomain

Basic domain configuration information, including CNAME, status, service type, acceleration region, creation time, last modified time, and origin server configuration.

Used by actions: DescribeDomains.

Name	Type	Description
ResourceId	String	Domain name ID
AppId	Integer	Tencent Cloud account ID
Domain	String	Acceleration domain name
Cname	String	CNAME address of domain name
Status	String	Acceleration service status rejected: the domain name is rejected due to expiration/deregistration of its ICP filing processing: deploying online: activated offline: disabled
ProjectId	Integer	Project ID, which can be viewed on the Tencent Cloud project management page
ServiceType	String	Domain name service type web: static acceleration download: download acceleration media: streaming VOD acceleration
CreateTime	Timestamp	Domain name creation time
UpdateTime	Timestamp	Last modified time of domain name
Origin	Origin	Origin server configuration details
Disable	String	Domain name block status normal: normal overdue: the domain name has been disabled due to account arrears. The acceleration service can be resumed after the account is topped up. malicious: the acceleration service has been forcibly disabled due to detection of malicious behavior. ddos: the acceleration service has been disabled due to large-scale DDoS attacks to the domain name idle: no operations or data has been detected for more than 90 days. The domain name is determined to be inactive which automatically disables the acceleration service. You can restart the service. unlicensed: the acceleration service has been automatically disabled as the domain name has no ICP filing or its ICP filing is deregistered. Service can be resumed after an ICP filing is obtained. capping: the configured upper limit for bandwidth has been reached. readonly: the domain name has a special configuration and has been locked.
Area	String	Acceleration region mainland: acceleration in Mainland China overseas: acceleration outside Mainland China global: global acceleration
Readonly	String	Domain name lock status normal: not locked mainland: locked in Mainland China overseas: locked outside Mainland China global: locked globally
Product	String	Product of the domain name, either `cdn` or `ecdn`.
ParentHost	String	Primary domain name

Cache

Node cache expiration time configuration. There are two types of configuration:

Basic cache expiration rules configuration
Advanced cache expiration rules configuration

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
SimpleCache	SimpleCache	No	Basic cache expiration time configuration Note: this field may return null, indicating that no valid values can be obtained.
AdvancedCache	AdvancedCache	No	(Disused) Advanced cache validity configuration Note: this field may return `null`, indicating that no valid values can be obtained.
RuleCache	Array of RuleCache	No	Advanced path cache configuration Note: this field may return null, indicating that no valid value is obtained.

CacheConfigCache

Path cache configuration

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Switch	String	Yes	Cache configuration switch on: enable off: disable Note: this field may return null, indicating that no valid value is obtained.
CacheTime	Integer	Yes	Cache expiration time settings Unit: second. The maximum value is 365 days. Note: this field may return null, indicating that no valid value is obtained.
CompareMaxAge	String	Yes	Advanced cache expiration configuration. If this is enabled, the max-age value returned by the origin server will be compared with the cache expiration time set in CacheRules, and the smallest value will be cached on the node. on: enable off: disable This is disabled by default. Note: this field may return null, indicating that no valid value is obtained.
IgnoreCacheControl	String	Yes	Force cache on: enable off: disable This is disabled by default. If enabled, the `no-store` and `no-cache` resources returned from the origin server will be cached according to `CacheRules` rules. Note: this field may return null, indicating that no valid value is obtained.
IgnoreSetCookie	String	Yes	Whether to ignore the header and body on cache nodes if the origin server returns the header `Set-Cookie`. `on`: Ignore; do not cache the header and body. `off`: Do not ignore; follow the custom cache rules of cache nodes. It is disabled by default. Note: This field may return `null`, indicating that no valid value can be obtained.

CacheConfigFollowOrigin

Path cache configuration follows the origin server configuration.

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Switch	String	Yes	Follow origin server switch configuration on: enable off: disable

CacheConfigNoCache

Path cache/no cache configuration.

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Switch	String	Yes	No cache configuration switch on: enable off: disable Note: this field may return null, indicating that no valid value is obtained.
Revalidate	String	Yes	Always forwards to the origin server for verification on: enable off: disable This is disabled by default. Note: this field may return null, indicating that no valid value is obtained.

CacheKey

Cache key configuration (Ignore Query String configuration)

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
FullUrlCache	String	No	Whether to enable full-path cache `on`: enables full-path cache (i.e., disables Ignore Query String) `off`: disables full-path cache (i.e., enables Ignore Query String)
IgnoreCase	String	No	Whether caches are case insensitive Note: this field may return null, indicating that no valid values can be obtained.
QueryString	QueryStringKey	No	Request parameter contained in `CacheKey` Note: this field may return null, indicating that no valid values can be obtained.
Cookie	CookieKey	No	Cookie contained in `CacheKey` Note: this field may return null, indicating that no valid values can be obtained.
Header	HeaderKey	No	Request header contained in `CacheKey` Note: this field may return null, indicating that no valid values can be obtained.
CacheTag	CacheTagKey	No	Custom string contained in `CacheKey` Note: this field may return null, indicating that no valid values can be obtained.
Scheme	SchemeKey	No	Request protocol contained in `CacheKey` Note: this field may return null, indicating that no valid values can be obtained.
KeyRules	Array of KeyRule	No	Path-based cache key configuration Note: this field may return null, indicating that no valid value is obtained.

CacheOptResult

Result of blocking/unblocking URLs

Used by actions: DisableCaches, EnableCaches.

Name	Type	Description
SuccessUrls	Array of String	List of succeeded URLs Note: This field may return null, indicating that no valid values can be obtained.
FailUrls	Array of String	List of failed URLs Note: This field may return null, indicating that no valid values can be obtained.

CacheTagKey

A part of CacheKey

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Switch	String	Yes	Whether to use `CacheTag` as part of `CacheKey` Note: this field may return null, indicating that no valid values can be obtained.
Value	String	No	Value of custom `CacheTag` Note: this field may return null, indicating that no valid values can be obtained.

CappingRule

Downstream speed limit configuration rules. Up to 100 entries can be configured.

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
RuleType	String	Yes	Rule types: `all`: effective for all files `file`: effective for specified file suffixes `directory`: effective for specified paths `path`: effective for specified absolute paths
RulePaths	Array of String	Yes	Content for each RuleType: For `all`, enter an asterisk (*). For `file`, enter the suffix, such as jpg, txt. For `directory`, enter the path, such as /xxx/test/. For `path`, enter the corresponding absolute path, such as /xxx/test.html.
KBpsThreshold	Integer	Yes	Downstream speed value settings (in KB/s)

CdnData

Detailed access data

Used by actions: DescribeBillingData, DescribeCdnData, DescribeIpVisit, DescribeOriginData.

Name	Type	Description
Metric	String	Queries the specified metric: flux: traffic (in bytes) bandwidth: bandwidth (in bps) request: number of requests fluxHitRate: traffic hit rate (in %) statusCode: status code. The aggregate data for 2xx, 3xx, 4xx, and 5xx status codes will be returned (in entries) 2XX: Returns the aggregate list of 2xx status codes and the data for status codes starting with 2 (in entries) 3XX: Returns the aggregate list of 3xx status codes and the data for status codes starting with 3 (in entries) 4XX: Returns the aggregate list of 4xx status codes and the data for status codes starting with 4 (in entries) 5XX: Returns the aggregate list of 5xx status codes and the data for status codes starting with 5 (in entries) Alternatively, you can specify a status code for querying.
DetailData	Array of TimestampData	Detailed data combination
SummarizedData	SummarizedData	Aggregate data combination

CdnIp

IP attribute information

Used by actions: DescribeCdnIp.

Name	Type	Description
Ip	String	IP to be queried
Platform	String	IP ownership: yes: Tencent Cloud CDN node no: non-Tencent Cloud CDN node
Location	String	Node district/country unknown: unknown node location
History	Array of CdnIpHistory	Node activation and deactivation history
Area	String	Node region mainland: cache node in Mainland China overseas: cache node outside Mainland China unknown: service region unknown
City	String	City where the node resides Note: this field may return `null`, indicating that no valid value is obtained.

CdnIpHistory

CDN node activation and deactivation history

Used by actions: DescribeCdnIp.

Name	Type	Description
Status	String	Operation type online: node is online offline: node is offline
Datetime	Timestamp	Operation time corresponding to operation type If this value is null, there are no status change records Note: this field may return null, indicating that no valid values can be obtained.

ClientCert

HTTPS client certificate configuration

Used by actions: AddCdnDomain, DescribeDomains, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Certificate	String	Yes	Client Certificate PEM format, requires Base64 encoding. Note: this field may return null, indicating that no valid values can be obtained.
CertName	String	No	Client certificate name Note: this field may return null, indicating that no valid values can be obtained.
ExpireTime	Timestamp	No	Certificate expiration time When this is used as an input parameter, it can be left blank. Note: this field may return null, indicating that no valid values can be obtained.
DeployTime	Timestamp	No	Certificate issuance time When this is used as an input parameter, it can be left blank. Note: this field may return null, indicating that no valid values can be obtained.

ClsLogObject

CLS log search object

Used by actions: SearchClsLog.

Name	Type	Description
TopicId	String	Topic ID
TopicName	String	Topic name
Timestamp	String	Log time
Content	String	Log content
Filename	String	Capture path
Source	String	Log source device

ClsSearchLogs

CLS log search result

Used by actions: SearchClsLog.

Name	Type	Description
Context	String	Cursor for more search results
Listover	Boolean	Whether all search results have been returned
Results	Array of ClsLogObject	Log content information

Compatibility

Old configuration compatibility check

Used by actions: DescribeDomainsConfig.

Name	Type	Description
Code	Integer	Compatibility flag status code. Note: this field may return null, indicating that no valid values can be obtained.

Compression

Smart compression configuration. By default, Gzip compression is performed for files with js, html, css, xml, json, shtml, and htm suffixes, and with sizes between 256 and 2097152 bytes.

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Switch	String	Yes	Smart compression configuration switch on: enabled off: disabled
CompressionRules	Array of CompressionRule	No	Compression rules array Note: this field may return null, indicating that no valid values can be obtained.

CompressionRule

Intelligent compression rule configuration

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Compress	Boolean	Yes	true: must be set as true, enables compression Note: this field may return null, indicating that no valid values can be obtained.
MinLength	Integer	Yes	The minimum file size to trigger compression (in bytes) Note: this field may return null, indicating that no valid values can be obtained.
MaxLength	Integer	Yes	The maximum file size to trigger compression (in bytes) The maximum value is 30 MB Note: this field may return null, indicating that no valid values can be obtained.
Algorithms	Array of String	Yes	File compression algorithm gzip: specifies Gzip compression brotli: specifies Brotli compression Note: this field may return null, indicating that no valid values can be obtained.
FileExtensions	Array of String	No	Compress according to the file suffix type Such as: jpg, txt Note: this field may return null, indicating that no valid values can be obtained.
RuleType	String	No	Rule types: `all`: effective for all files. `file`: effective for specified file suffixes. `directory`: effective for specified paths. `path`: effective for specified absolute paths. `contentType`: effective when the `ContentType` is specified If this field is specified, `FileExtensions` does not take effect. Note: this field may return `null`, indicating that no valid values can be obtained.
RulePaths	Array of String	No	Content for each `CacheType`: For `all`, enter a wildcard `*`. For `file`, enter a suffix, e.g., `jpg` or `txt`. For `directory`, enter a path, e.g., `/xxx/test/`. For `path`, enter an absolute path, e.g., `/xxx/test.html`. For `contentType`, enter `text/html`. Note: this field may return `null`, indicating that no valid values can be obtained.

CookieKey

A part of CacheKey

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Switch	String	Yes	Whether to use `Cookie` as part of `CacheKey`. Valid values: on, off Note: this field may return null, indicating that no valid values can be obtained.
Value	String	No	Used cookies (separated by ';') Note: this field may return null, indicating that no valid values can be obtained.

DetailDomain

Complete acceleration domain configuration information

Used by actions: DescribeDomainsConfig.

Name	Type	Description
ResourceId	String	Domain name ID
AppId	Integer	Tencent Cloud account ID
Domain	String	Acceleration domain name
Cname	String	CNAME address of domain name Note: this field may return null, indicating that no valid values can be obtained.
Status	String	Acceleration service status rejected: the domain name is rejected due to expiration/deregistration of its ICP filing processing: deploying online: activated offline: disabled
ProjectId	Integer	Project ID, which can be viewed on the Tencent Cloud project management page
ServiceType	String	Acceleration domain name service type `web`: Webpage file downloads `download`: Large file downloads `media`: Audio and video on demand acceleration `hybrid`: Dynamic and static content acceleration `dynamic`: Dynamic content acceleration
CreateTime	Timestamp	Domain name creation time
UpdateTime	Timestamp	Last modified time of domain name
Origin	Origin	Origin server configuration
IpFilter	IpFilter	IP blacklist/whitelist configuration Note: this field may return null, indicating that no valid values can be obtained.
IpFreqLimit	IpFreqLimit	IP access frequency limit configuration Note: this field may return null, indicating that no valid values can be obtained.
StatusCodeCache	StatusCodeCache	Status code cache configuration Note: this field may return null, indicating that no valid values can be obtained.
Compression	Compression	Smart compression configuration Note: this field may return null, indicating that no valid values can be obtained.
BandwidthAlert	BandwidthAlert	Bandwidth cap configuration Note: this field may return null, indicating that no valid values can be obtained.
RangeOriginPull	RangeOriginPull	Range GETs configuration Note: this field may return null, indicating that no valid values can be obtained.
FollowRedirect	FollowRedirect	301/302 origin-pull follow-redirect configuration Note: this field may return null, indicating that no valid values can be obtained.
ErrorPage	ErrorPage	Configuration of custom error page Note: this field may return `null`, indicating that no valid values can be obtained.
RequestHeader	RequestHeader	Custom request header configuration Note: this field may return null, indicating that no valid values can be obtained.
ResponseHeader	ResponseHeader	Custom response header configuration Note: this field may return null, indicating that no valid values can be obtained.
DownstreamCapping	DownstreamCapping	Single-link downstream speed limit configuration Note: this field may return null, indicating that no valid values can be obtained.
CacheKey	CacheKey	Configuration of cache with/without parameter Note: this field may return null, indicating that no valid values can be obtained.
ResponseHeaderCache	ResponseHeaderCache	Origin server header cache configuration Note: this field may return null, indicating that no valid values can be obtained.
VideoSeek	VideoSeek	Video dragging configuration Note: this field may return null, indicating that no valid values can be obtained.
Cache	Cache	Node cache expiration rule configuration Note: this field may return null, indicating that no valid values can be obtained.
OriginPullOptimization	OriginPullOptimization	Cross-border linkage optimization configuration (in beta) Note: this field may return null, indicating that no valid values can be obtained.
Https	Https	HTTPS acceleration configuration Note: this field may return null, indicating that no valid values can be obtained.
Authentication	Authentication	Timestamp hotlink protection configuration Note: this field may return null, indicating that no valid values can be obtained.
Seo	Seo	SEO configuration Note: this field may return null, indicating that no valid values can be obtained.
Disable	String	Domain name block status normal: normal overdue: the domain name has been disabled due to account arrears. The acceleration service can be resumed after the account is topped up. malicious: the acceleration service has been forcibly disabled due to detection of malicious behavior. ddos: the acceleration service has been disabled due to large-scale DDoS attacks to the domain name idle: no operations or data has been detected for more than 90 days. The domain name is determined to be inactive which automatically disables the acceleration service. You can restart the service. unlicensed: the acceleration service has been automatically disabled as the domain name has no ICP filing or its ICP filing is deregistered. Service can be resumed after an ICP filing is obtained. capping: the configured upper limit for bandwidth has been reached. readonly: the domain name has a special configuration and has been locked. Note: this field may return null, indicating that no valid values can be obtained.
ForceRedirect	ForceRedirect	Access protocol forced redirect configuration Note: this field may return null, indicating that no valid values can be obtained.
Referer	Referer	Referer hotlink protection configuration Note: this field may return null, indicating that no valid values can be obtained.
MaxAge	MaxAge	Browser cache expiration rule configuration (in beta) Note: this field may return null, indicating that no valid values can be obtained.
Ipv6	Ipv6	IPv6 origin-pull configuration (in beta) Note: this field may return `null`, indicating that no valid values can be obtained.
Compatibility	Compatibility	Backwards compatibility configuration (compatibility field for internal use) Note: this field may return null, indicating that no valid values can be obtained.
SpecificConfig	SpecificConfig	Region-specific configuration Note: this field may return null, indicating that no valid values can be obtained.
Area	String	Acceleration region mainland: acceleration in Mainland China overseas: acceleration outside Mainland China global: global acceleration Note: this field may return null, indicating that no valid values can be obtained.
Readonly	String	Domain name lock status normal: not locked mainland: locked in Mainland China overseas: locked outside Mainland China global: locked globally Note: this field may return null, indicating that no valid values can be obtained.
OriginPullTimeout	OriginPullTimeout	Origin-pull timeout configuration Note: this field may return null, indicating that no valid values can be obtained.
AwsPrivateAccess	AwsPrivateAccess	S3 bucket origin access authentication configuration Note: this field may return null, indicating that no valid values can be obtained.
SecurityConfig	SecurityConfig	SCDN configuration
ImageOptimization	ImageOptimization	Image Optimization configuration
UserAgentFilter	UserAgentFilter	`UA` blocklist/allowlist configuration
AccessControl	AccessControl	Access control
Advance	String	Whether to support advanced configuration items on: supported off: not supported Note: this field may return null, indicating that no valid values can be obtained.
UrlRedirect	UrlRedirect	URL redirect configuration Note: this field may return null, indicating that no valid values can be obtained.
AccessPort	Array of Integer	Access port configuration Note: this field may return null, indicating that no valid values can be obtained.
Tag	Array of Tag	Tag configuration Note: this field may return null, indicating that no valid value is obtained.
AdvancedAuthentication	AdvancedAuthentication	Timestamp hotlink protection advanced configuration (allowlist feature) Note: this field may return `null`, indicating that no valid values can be obtained.
OriginAuthentication	OriginAuthentication	Origin-pull authentication advanced configuration (allowlist feature) Note: this field may return `null`, indicating that no valid values can be obtained.
Ipv6Access	Ipv6Access	IPv6 access configuration Note: this field may return `null`, indicating that no valid values can be obtained.
AdvanceSet	Array of AdvanceConfig	Advanced configuration settings Note: this field may return `null`, indicating that no valid values can be obtained.
OfflineCache	OfflineCache	Offline cache (only available to beta users) Note: this field may return `null`, indicating that no valid values can be obtained.
OriginCombine	OriginCombine	Merging origin-pull requests (only available to beta users) Note: this field may return `null`, indicating that no valid values can be obtained.
PostMaxSize	PostSize	POST request configuration item Note: this field may return `null`, indicating that no valid values can be obtained.
Quic	Quic	QUIC configuration Note: this field may return `null`, indicating that no valid values can be obtained.
OssPrivateAccess	OssPrivateAccess	Access authentication for OSS origin Note: this field may return `null`, indicating that no valid values can be obtained.
WebSocket	WebSocket	WebSocket configuration. Note: this field may return `null`, indicating that no valid values can be obtained.
RemoteAuthentication	RemoteAuthentication	Remote authentication configuration Note: this field may return `null`, indicating that no valid values can be obtained.
ShareCname	ShareCname	Shared CNAME configuration (only available to beta users) Note: this field may return `null`, indicating that no valid values can be obtained.
RuleEngine	RuleEngine	Rule engine Note: This field may return `null`, indicating that no valid values can be obtained.
ParentHost	String	Primary domain name Note: This field may return `null`, indicating that no valid value was found.
HwPrivateAccess	HwPrivateAccess
QnPrivateAccess	QnPrivateAccess

DomainAreaConfig

Domain name region configuration

Used by actions: CreateClsLogTopic, ListClsTopicDomains, ManageClsTopicDomains.

Name	Type	Required	Description
Domain	String	Yes	Domain name
Area	Array of String	Yes	Region list, where the element can be `mainland/overseas`

DomainFilter

Filter conditions for domain name query.

Used by actions: DescribeDomains, DescribeDomainsConfig.

Name	Type	Required	Description
Name	String	Yes	Filters by the field name, which includes: - `origin`: Primary origin server. - `domain`: Domain name. - `resourceId`: Domain name ID. - `status`: Domain name status. Valid values: `online`, `offline`, and `processing`. - `serviceType`: Service type. Valid values: `web`, `download`, `media`, `hybrid` and `dynamic`. - `projectId`: Project ID. - `domainType`: Primary origin server type. Valid values: `cname` (customer origin), `COS` (COS origin), and `third_party` (third-party object storage origin). - `fullUrlCache`: Whether to enable full-path cache, which can be `on` or `off`. - `https`: Whether to configure HTTPS, which can be `on`, `off` or `processing`. - `originPullProtocol`: Origin-pull protocol type, which can be `http`, `follow`, or `https`. - `tagKey`: Tag key.
Value	Array of String	Yes	Filter field value.
Fuzzy	Boolean	No	Whether to enable fuzzy query. Only `origin` or `domain` is supported for the filter field name. When fuzzy query is enabled, the maximum Value length is 1. When fuzzy query is disabled, the maximum Value length is 5.

DomainLog

Details about a log package download link

Used by actions: DescribeCdnDomainLogs.

Name	Type	Description
StartTime	Timestamp	Starting time of the log package
EndTime	Timestamp	End time of the log package
LogPath	String	Log package download link
Area	String	Acceleration region corresponding to the log package `mainland`: within Mainland China `overseas`: outside Mainland China
LogName	String	Log package filename

DownstreamCapping

Single link downstream speed limit configuration. This is disabled by default.

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Switch	String	Yes	Downstream speed configuration switch on: enabled off: disabled
CappingRules	Array of CappingRule	No	Downstream speed limiting rules Note: this field may return null, indicating that no valid values can be obtained.

ErrorPage

Status code redirect configuration, which is disabled by default.

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Switch	String	Yes	Status code redirect configuration switch on: enabled off: disabled Note: this field may return null, indicating that no valid values can be obtained.
PageRules	Array of ErrorPageRule	No	Status code redirect rules configuration Note: this field may return null, indicating that no valid values can be obtained.

ErrorPageRule

Status code redirect rules configuration

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
StatusCode	Integer	Yes	Status code Supports 400, 403, 404, 500.
RedirectCode	Integer	Yes	Redirect status code settings Supports 301 or 302.
RedirectUrl	String	Yes	Redirect URL Requires a full redirect path, such as https://www.test.com/error.html.

ExtraLogset

Information of logsets and log topics (except those created in the Shanghai region)

Used by actions: ListClsLogTopics.

Name	Type	Description
Logset	LogSetInfo	Logset information Note: this field may return `null`, indicating that no valid values can be obtained.
Topics	Array of TopicInfo	Log topic information Note: this field may return `null`, indicating that no valid values can be obtained.

FollowRedirect

301/302 automatic origin-pull follow-redirect configuration. It is disabled by default.

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Switch	String	Yes	Origin-pull follow-redirect switch on: enabled off: disabled

ForceRedirect

Access protocol forced redirect configuration. This is disabled by default.

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Switch	String	Yes	Access forced redirect configuration switch on: enabled off: disabled Note: this field may return null, indicating that no valid values can be obtained.
RedirectType	String	No	Access forced redirect types http: forced HTTP redirect https: forced HTTPS redirect Note: this field may return null, indicating that no valid values can be obtained.
RedirectStatusCode	Integer	No	Status code returned for forced redirect Supports 301, 302. Note: this field may return null, indicating that no valid values can be obtained.
CarryHeaders	String	No	Whether to return the added header in forced redirection. Note: this field may return `null`, indicating that no valid values can be obtained.

GuetzliAdapter

Image optimization - GuetzliAdapter configuration

Used by actions: DescribeDomainsConfig.

Name	Type	Required	Description
Switch	String	No	Switch. Valid values: on, off Note: this field may return null, indicating that no valid values can be obtained.

HeaderKey

A part of CacheKey

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Switch	String	No	Whether to use it as part of `CacheKey` Note: this field may return null, indicating that no valid values can be obtained.
Value	String	No	Array of headers that make up the `CacheKey` (separated by ';') Note: this field may return null, indicating that no valid values can be obtained.

Hsts

HSTS configuration.

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Switch	String	Yes	Whether to enable. Valid values: on, off.
MaxAge	Integer	No	`MaxAge` value. Note: this field may return null, indicating that no valid values can be obtained.
IncludeSubDomains	String	No	Whether to include subdomain names. Valid values: on, off. Note: this field may return null, indicating that no valid values can be obtained.

HttpHeaderPathRule

HTTP header setting rules. Up to 100 entries can be set.

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
HeaderMode	String	Yes	HTTP header setting methods `set`: sets a value for an existing header parameter, a new header parameter, or multiple header parameters. Multiple header parameters will be merged into one. `del`: deletes a header parameter. `add`: adds a header parameter. By default, you can repeat the same action to add the same header parameter, which may affect browser response. Please consider the set operation first. Note: This field may return `null`, indicating that no valid values can be obtained.
HeaderName	String	Yes	HTTP header name. Up to 100 characters can be set. Note: this field may return null, indicating that no valid values can be obtained.
HeaderValue	String	Yes	HTTP header value. Up to 1000 characters can be set. Not required when Mode is del Required when Mode is add/set Note: this field may return null, indicating that no valid values can be obtained.
RuleType	String	Yes	Rule types: `all`: effective for all files `file`: effective for specified file suffixes `directory`: effective for specified paths `path`: effective for specified absolute paths Note: this field may return null, indicating that no valid values can be obtained.
RulePaths	Array of String	Yes	Content for each RuleType: For `all`, enter an asterisk (*). For `file`, enter the suffix, such as jpg, txt. For `directory`, enter the path, such as /xxx/test/. For `path`, enter the corresponding absolute path, such as /xxx/test.html. Note: this field may return null, indicating that no valid values can be obtained.

HttpHeaderRule

HTTP header setting rules.

Used by actions: AddCdnDomain, DescribeDomains, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
HeaderMode	String	Yes	HTTP header setting method. Valid values: `add` (add header), `set` (set header) or `del` (delete header).
HeaderName	String	Yes	HTTP header name
HeaderValue	String	Yes	HTTP header value

Https

Domain name HTTPS acceleration configuration. This is disabled by default.

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Switch	String	Yes	HTTPS configuration switch on: enabled off: disabled Note: this field may return null, indicating that no valid values can be obtained.
Http2	String	No	HTTP2 configuration switch on: enabled off: disabled Enabling HTTPS acceleration for the first time will enable HTTP2 configuration by default. Note: this field may return null, indicating that no valid values can be obtained.
OcspStapling	String	No	OCSP configuration switch on: enabled off: disabled This is disabled by default Note: this field may return null, indicating that no valid values can be obtained.
VerifyClient	String	No	Client certificate authentication feature on: enabled off: disabled This is disabled by default. The client certificate information is needed when enabled. This is still in beta and not generally available yet. Note: this field may return null, indicating that no valid values can be obtained.
CertInfo	ServerCert	No	Server certificate configuration information Note: this field may return null, indicating that no valid values can be obtained.
ClientCertInfo	ClientCert	No	Client certificate configuration information Note: this field may return null, indicating that no valid values can be obtained.
Spdy	String	No	Spdy configuration switch on: enabled off: disabled This is disabled by default Note: this field may return null, indicating that no valid values can be obtained.
SslStatus	String	No	HTTPS certificate deployment status closed: already closed deploying: in deployment deployed: successfully deployed failed: deployment failed Note: this field may return null, indicating that no valid values can be obtained.
Hsts	Hsts	No	HSTS configuration
TlsVersion	Array of String	No	TLS version settings, which only support certain advanced domain names. Valid values: `TLSv1`, `TLSV1.1`, `TLSV1.2`, and `TLSv1.3`. Only consecutive versions can be enabled at the same time. Note: this field may return `null`, indicating that no valid values can be obtained.

HwPrivateAccess

Used by actions: DescribeDomainsConfig.

Name	Type	Required	Description
Switch	String	Yes
AccessKey	String	No
SecretKey	String	No
Bucket	String	No	bucketname

ImageOptimization

ImageOptimization configuration

Used by actions: DescribeDomainsConfig.

Name	Type	Description
WebpAdapter	WebpAdapter	`WebpAdapter` configuration Note: this field may return null, indicating that no valid values can be obtained.
TpgAdapter	TpgAdapter	`TpgAdapter` configuration Note: this field may return null, indicating that no valid values can be obtained.
GuetzliAdapter	GuetzliAdapter	`GuetzliAdapter` configuration Note: this field may return null, indicating that no valid values can be obtained.

IpFilter

IP blocklist/allowlist configuration. This is disabled by default.

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Switch	String	Yes	IP blocklist/allowlist configuration switch on: enabled off: disabled
FilterType	String	No	IP blocklist/allowlist type whitelist: allowlist blacklist: blocklist Note: this field may return null, indicating that no valid values can be obtained.
Filters	Array of String	No	IP blocklist/allowlist list Supports IPs in X.X.X.X format, or /8, /16, /24 format IP ranges. Up to 50 allowlists or blocklists can be entered Note: this field may return null, indicating that no valid values can be obtained.
FilterRules	Array of IpFilterPathRule	No	IP blocklist/allowlist path-based configuration. This feature is only available to selected beta customers. Note: this field may return `null`, indicating that no valid value is obtained.
ReturnCode	Integer	No	HTTP code returned when the IP allowlist/blocklist verification fails Valid values: 400-499 Note: this field may return `null`, indicating that no valid values can be obtained.

IpFilterPathRule

IP blocklist/allowlist path-based configuration

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
FilterType	String	Yes	IP blocklist/allowlist type `whitelist`: allowlist IPs `blacklist`: blocklist IPs Note: this field may return `null`, indicating that no valid value is obtained.
Filters	Array of String	Yes	IP blocklist/allowlist list Supports IPs in X.X.X.X format, or /8, /16, /24 format IP ranges. Up to 50 allowlists or blocklists can be entered. Note: this field may return `null`, indicating that no valid value is obtained.
RuleType	String	Yes	Rule types: `all`: effective for all files `file`: effective for specified file suffixes `directory`: effective for specified paths `path`: effective for specified absolute paths Note: this field may return `null`, indicating that no valid value is obtained.
RulePaths	Array of String	Yes	Content for each RuleType: For `all`, enter an asterisk (*). For `file`, enter the suffix, such as jpg, txt. For `directory`, enter the path, such as /xxx/test/. For `path`, enter the corresponding absolute path, such as /xxx/test.html. Note: this field may return `null`, indicating that no valid value is obtained.

IpFreqLimit

Access limit configuration for a single IP of a single node. This is disabled by default.

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Switch	String	Yes	IP access limit configuration switch on: enabled off: disabled
Qps	Integer	No	Sets the limited number of requests per second 514 will be returned for requests that exceed the limit Note: this field may return null, indicating that no valid values can be obtained.

IpStatus

Node IP information

Used by actions: DescribeIpStatus.

Name	Type	Description
Ip	String	Node IP
District	String	Node region
Isp	String	Node ISP
City	String	Node city
Status	String	Node status online: the node is online; scheduling service running offline: the node is offline

Ipv6

IPv6 activation configurations, which cannot be changed.

Used by actions: AddCdnDomain, DescribeDomainsConfig.

Name	Type	Description
Switch	String	Whether to enable the IPv6 feature for a domain name. Values include `on` or `off`. Note: this field may return null, indicating that no valid values can be obtained.

Ipv6Access

IPv6 access configuration

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Switch	String	Yes	Whether to enable the IPv6 access feature for a domain name. Valid values: `on` and `off`. Note: this field may return `null`, indicating that no valid values can be obtained.

KeyRule

Path-based cache key configuration

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
RulePaths	Array of String	Yes	Content for each CacheType: For `file`, enter the suffix, such as jpg, txt. For `directory`, enter the path, such as /xxx/test/. For `path`, enter the corresponding absolute path, such as /xxx/test.html. For `index`, enter a backslash (/). Note: this field may return null, indicating that no valid value is obtained.
RuleType	String	Yes	Rule types: `file`: effective for specified file suffixes `directory`: effective for specified paths `path`: effective for specified absolute paths `index`: home page Note: this field may return null, indicating that no valid value is obtained.
FullUrlCache	String	Yes	Whether full-path cache is enaled `on`: enables full-path cache (i.e., disables ignore query string) `off`: disables full-path cache (i.e., enables ignore query string) Note: this field may return `null`, indicating that no valid value can be obtained.
IgnoreCase	String	Yes	Whether caches are case insensitive Note: this field may return null, indicating that no valid value is obtained.
QueryString	RuleQueryString	Yes	Request parameter contained in `CacheKey` Note: this field may return null, indicating that no valid value is obtained.
RuleTag	String	Yes	Path cache key tag, the value "user" is passed. Note: this field may return null, indicating that no valid value is obtained.

LogSetInfo

Logset information

Used by actions: ListClsLogTopics.

Name	Type	Description
AppId	Integer	Developer ID
Channel	String	Channel Note: this field may return null, indicating that no valid values can be obtained.
LogsetId	String	Logset ID
LogsetName	String	Logset name
IsDefault	Integer	Whether it is the default logset
LogsetSavePeriod	Integer	Log retention period in days
CreateTime	Timestamp	Creation date
Region	String	Region
Deleted	String	Whether the logset has been removed from CLS Note: this field may return `null`, indicating that no valid values can be obtained.
RegionEn	String	Whether English is used in this region Note: this field may return `null`, indicating that no valid values can be obtained.

MainlandConfig

Specific configuration for domain names in the mainland China by region. UpdateDomainConfig API only supports modification of certain region configurations. A list of differences that may exist for older configurations will be provided for a compatibility check. The supported configuration list is as follows:

Authentication
BandwidthAlert
ErrorPage
IpFilter
Origin
Referer

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Authentication	Authentication	No	Timestamp hotlink protection configuration. Note: this field may return null, indicating that no valid values can be obtained.
BandwidthAlert	BandwidthAlert	No	Bandwidth cap configuration. Note: this field may return null, indicating that no valid values can be obtained.
Cache	Cache	No	Cache rules configuration. Note: this field may return null, indicating that no valid values can be obtained.
CacheKey	CacheKey	No	Cache configurations. Note: this field may return null, indicating that no valid values can be obtained.
Compression	Compression	No	Smart compression configuration. Note: this field may return null, indicating that no valid values can be obtained.
DownstreamCapping	DownstreamCapping	No	Download speed limit configuration. Note: this field may return null, indicating that no valid values can be obtained.
ErrorPage	ErrorPage	No	Error code redirect configuration. Note: this field may return null, indicating that no valid values can be obtained.
FollowRedirect	FollowRedirect	No	301 and 302 automatic origin-pull follow-redirect configuration. Note: this field may return null, indicating that no valid values can be obtained.
ForceRedirect	ForceRedirect	No	Access protocol forced redirect configuration. Note: this field may return null, indicating that no valid values can be obtained.
Https	Https	No	HTTPS configuration. Note: this field may return null, indicating that no valid values can be obtained.
IpFilter	IpFilter	No	IP blocklist/allowlist configuration. Note: this field may return null, indicating that no valid values can be obtained.
IpFreqLimit	IpFreqLimit	No	IP access limit configuration. Note: this field may return null, indicating that no valid values can be obtained.
MaxAge	MaxAge	No	Browser cache rules configuration. Note: this field may return null, indicating that no valid values can be obtained.
Origin	Origin	No	Origin server configuration. Note: this field may return null, indicating that no valid values can be obtained.
OriginPullOptimization	OriginPullOptimization	No	Cross-border optimization configuration. Note: this field may return null, indicating that no valid values can be obtained.
RangeOriginPull	RangeOriginPull	No	Range GETs configuration. Note: this field may return null, indicating that no valid values can be obtained.
Referer	Referer	No	Hotlink protection configuration. Note: this field may return null, indicating that no valid values can be obtained.
RequestHeader	RequestHeader	No	Origin-pull request header configuration. Note: this field may return null, indicating that no valid values can be obtained.
ResponseHeader	ResponseHeader	No	Origin server response header configuration. Note: this field may return null, indicating that no valid values can be obtained.
ResponseHeaderCache	ResponseHeaderCache	No	Follows origin server cache header configuration. Note: this field may return null, indicating that no valid values can be obtained.
Seo	Seo	No	SEO configuration. Note: this field may return null, indicating that no valid values can be obtained.
ServiceType	String	No	Domain name service type. `web`: static acceleration; `download`: download acceleration; `media`: streaming media acceleration. Note: this field may return null, indicating that no valid values can be obtained.
StatusCodeCache	StatusCodeCache	No	Status code cache configuration. Note: this field may return null, indicating that no valid values can be obtained.
VideoSeek	VideoSeek	No	Video dragging configuration. Note: this field may return null, indicating that no valid values can be obtained.
AwsPrivateAccess	AwsPrivateAccess	No	Private access for S3 origin Note: this field may return `null`, indicating that no valid values can be obtained.
OssPrivateAccess	OssPrivateAccess	No	Private access for OSS origin Note: this field may return `null`, indicating that no valid values can be obtained.

MapInfo

Mapping between a name and an ID

Used by actions: DescribeMapInfo.

Name	Type	Description
Id	Integer	Object ID
Name	String	Object name

MaxAge

Browser cache rule configuration, which is used to set the default value of MaxAge and is disabled by default.

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Switch	String	Yes	Browser cache configuration switch on: enabled off: disabled Note: this field may return null, indicating that no valid values can be obtained.
MaxAgeRules	Array of MaxAgeRule	No	MaxAge rule Note: this field may return null, indicating that no valid values can be obtained.

MaxAgeRule

MaxAge rules configuration

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
MaxAgeType	String	Yes	Rule types: `all`: effective for all files. `file`: effective for specified file suffixes. `directory`: effective for specified paths. `path`: effective for specified absolute paths. `index`: effective for specified homepages.
MaxAgeContents	Array of String	Yes	Content for each `MaxAgeType`: For `all`, enter a wildcard `*`. For `file`, enter a suffix, e.g., `jpg` or `txt`. For `directory`, enter a path, e.g., `/xxx/test/`. For `path`, enter an absolute path, e.g., `/xxx/test.html`. For `index`, enter a forward slash `/`. Note: the rule `all` cannot be deleted. It follows origin by default and can be modified.
MaxAgeTime	Integer	Yes	MaxAge time (in seconds) Note: the value `0` means not to cache.
FollowOrigin	String	No	Whether to follow the origin server. Valid values: `on` and `off`. If it's on, `MaxAgeTime` is ignored. Note: this field may return `null`, indicating that no valid values can be obtained.

OfflineCache

Whether to enable offline cache

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Switch	String	Yes	Whether to enable offline cache. Valid values: `on` and `off`.

Origin

Complex origin server configurations. The following configurations are supported:

Origin server specified as a single domain name
Origin server specified as multiple IPs. Supported port range: 1-65535; Supported weight range: 1-100. Format: IP:Port:Weight.
Origin-pull domain name configuration
Cloud Object Storage (COS) specified as origin server
Hot backup origin server specified as a single domain name
Hot backup origin server specified as multiple IPs. Supported port range: 1-65535. At present, weight configuration is not supported.
Hot backup origin server origin-pull domain name configuration

Used by actions: AddCdnDomain, DescribeDomains, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Origins	Array of String	No	Master origin server list When modifying the origin server, you need to enter the corresponding OriginType. Note: this field may return null, indicating that no valid values can be obtained.
OriginType	String	No	Primary origin server type Input: `domain`: Domain name `domainv6`: IPv6 domain name `cos`: COS bucket address `ip`: IP address `ipv6`: A single IPv6 address `ip_ipv6`: Multiple IPv4 addresses and one IPv6 address `ip_domain`: IP addresses and domain names (only available to beta users) `ip_domainv6`: Multiple IPv4 addresses and one IPv6 domain name `ipv6_domain`: Multiple IPv6 addresses and one domain name `ipv6_domainv6`: Multiple IPv6 addresses and one IPv6 domain name `domain_domainv6`: Multiple IPv4 domain names and one IPv6 domain name `ip_ipv6_domain`: Multiple IPv4 and IPv6 addresses and one domain name `ip_ipv6_domainv6`: Multiple IPv4 and IPv6 addresses and one IPv6 domain name `ip_domain_domainv6`: Multiple IPv4 addresses and IPv4 domain names and one IPv6 domain name `ipv6_domain_domainv6`: Multiple IPv4 domain names and IPv6 addresses and one IPv6 domain name `ip_ipv6_domain_domainv6`: Multiple IPv4 and IPv6 addresses and IPv4 domain names and one IPv6 domain name Output: `image`: Cloud Infinite origin `ftp`: FTP origin (disused) When modifying `Origins`, you need to enter the corresponding `OriginType`. The IPv6 feature is now only available to beta users. Please submit an application to use this feature. Note: This field may return `null`, indicating that no valid value was found.
ServerName	String	No	Host header used when accessing the master origin server. If left empty, the acceleration domain name will be used by default. If a wildcard domain name is accessed, then the sub-domain name during the access will be used by default. Note: this field may return null, indicating that no valid values can be obtained.
CosPrivateAccess	String	No	When OriginType is COS, you can specify if access to private buckets is allowed. Note: to enable this configuration, you need to first grant CDN access to the private bucket. Note: this field may return null, indicating that no valid values can be obtained.
OriginPullProtocol	String	No	Origin-pull protocol configuration http: forced HTTP origin-pull follow: protocol follow origin-pull https: forced HTTPS origin-pull. This only supports origin server port 443 for origin-pull. Note: this field may return null, indicating that no valid values can be obtained.
BackupOrigins	Array of String	No	Backup origin server list When modifying the backup origin server, you need to enter the corresponding BackupOriginType. Note: this field may return null, indicating that no valid values can be obtained.
BackupOriginType	String	No	Secondary origin type. Values: `domain`: domain name `ip`: IP address When modifying `BackupOrigins`, you need to enter the corresponding `BackupOriginType`. The following backup origin servers are only available to beta users. Submit an application if you want to become a beta user. `ipv6_domain`: multiple IPv6 addresses and one domain name `ip_ipv6`: multiple IPv4 addresses and one IPv6 address `ipv6_domain`: multiple IPv6 addresses and one domain name `ip_ipv6_domain`: multiple IPv4 and IPv6 addresses and one domain name Note: this field may return `null`, indicating that no valid values can be obtained.
BackupServerName	String	No	Host header used when accessing the backup origin server. If left empty, the ServerName of master origin server will be used by default. Note: this field may return null, indicating that no valid values can be obtained.
BasePath	String	No
PathRules	Array of PathRule	No	Origin URL rewrite rule configuration Note: this field may return `null`, indicating that no valid values can be obtained.
PathBasedOrigin	Array of PathBasedOriginRule	No	Path-based origin-pull configurations Note: this field may return `null`, indicating that no valid values can be obtained.
AdvanceHttps	AdvanceHttps	No	Advanced HTTPS forwarding configuration Note: this field may return `null`, indicating that no valid values can be obtained.
OriginCompany	String	No

OriginAuthentication

Origin-pull authentication advanced configuration

Used by actions: DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Switch	String	Yes	Authentication switch, which can be on or off. Note: this field may return `null`, indicating that no valid values can be obtained.
TypeA	OriginAuthenticationTypeA	No	Authentication type configuration A Note: this field may return `null`, indicating that no valid values can be obtained.

OriginAuthenticationTypeA

Origin-pull authentication advanced configuration TypeA

Used by actions: DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
SecretKey	String	Yes	Key used for signature calculation, allowing 6 to 32 bytes of letters and digits. Note: this field may return `null`, indicating that no valid values can be obtained.

OriginCombine

Merging pull requests configurations

Used by actions: DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Switch	String	Yes	Whether to enable the merging pull requests feature. Valid values: `on` and `off`.

OriginIp

IP information of CDN intermediate nodes

Used by actions: DescribeCdnOriginIp.

Name	Type	Description
Ip	String	Intermediate IP range/intermediate IP. The IP range information is returned by default.

OriginPullOptimization

Cross-border origin-pull optimization configuration. This is disabled by default. (This feature is in beta and not generally available yet.)

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Switch	String	Yes	Cross-border origin-pull optimization configuration switch on: enabled off: disabled
OptimizationType	String	No	Cross-border types OVToCN: origin-pull from outside mainland China to inside mainland China CNToOV: origin-pull from inside mainland China to outside mainland China Note: this field may return null, indicating that no valid values can be obtained.

OriginPullTimeout

Origin-pull timeout configuration

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
ConnectTimeout	Integer	Yes	The origin-pull connection timeout (in seconds). Valid range: 5-60. Note: this field may return null, indicating that no valid values can be obtained.
ReceiveTimeout	Integer	Yes	The origin-pull receipt timeout (in seconds). Valid range: 10-60. Note: this field may return null, indicating that no valid values can be obtained.

OssPrivateAccess

Access authentication configuration for OSS origin

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Switch	String	Yes	Whether to enable access authentication. Valid values: `on`, `off`.
AccessKey	String	No	Access ID. Note: this field may return `null`, indicating that no valid values can be obtained.
SecretKey	String	No	Key. Note: this field may return `null`, indicating that no valid values can be obtained.

OverseaConfig

Specific configuration for domain names outside mainland China. UpdateDomainConfig API only supports modification of some region configurations. A list of differences that may exist for older configurations will be provided for a compatibility check. The supported configuration list is as follows:

Authentication
BandwidthAlert
ErrorPage
IpFilter
Origin
Referer

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Authentication	Authentication	No	Timestamp hotlink protection configuration. Note: this field may return null, indicating that no valid values can be obtained.
BandwidthAlert	BandwidthAlert	No	Bandwidth cap configuration. Note: this field may return null, indicating that no valid values can be obtained.
Cache	Cache	No	Cache rules configuration. Note: this field may return null, indicating that no valid values can be obtained.
CacheKey	CacheKey	No	Cache configurations. Note: this field may return null, indicating that no valid values can be obtained.
Compression	Compression	No	Smart compression configuration. Note: this field may return null, indicating that no valid values can be obtained.
DownstreamCapping	DownstreamCapping	No	Download speed limit configuration. Note: this field may return null, indicating that no valid values can be obtained.
ErrorPage	ErrorPage	No	Error code redirect configuration. Note: this field may return null, indicating that no valid values can be obtained.
FollowRedirect	FollowRedirect	No	301 and 302 automatic origin-pull follow-redirect configuration. Note: this field may return null, indicating that no valid values can be obtained.
ForceRedirect	ForceRedirect	No	Access protocol forced redirect configuration. Note: this field may return null, indicating that no valid values can be obtained.
Https	Https	No	HTTPS configuration. Note: this field may return null, indicating that no valid values can be obtained.
IpFilter	IpFilter	No	IP blocklist/allowlist configuration. Note: this field may return null, indicating that no valid values can be obtained.
IpFreqLimit	IpFreqLimit	No	IP access limit configuration. Note: this field may return null, indicating that no valid values can be obtained.
MaxAge	MaxAge	No	Browser cache rules configuration. Note: this field may return null, indicating that no valid values can be obtained.
Origin	Origin	No	Origin server configuration. Note: this field may return null, indicating that no valid values can be obtained.
OriginPullOptimization	OriginPullOptimization	No	Cross-border optimization configuration. Note: this field may return null, indicating that no valid values can be obtained.
RangeOriginPull	RangeOriginPull	No	Range GETs configuration. Note: this field may return null, indicating that no valid values can be obtained.
Referer	Referer	No	Hotlink protection configuration. Note: this field may return null, indicating that no valid values can be obtained.
RequestHeader	RequestHeader	No	Origin-pull request header configuration. Note: this field may return null, indicating that no valid values can be obtained.
ResponseHeader	ResponseHeader	No	Origin server response header configuration. Note: this field may return null, indicating that no valid values can be obtained.
ResponseHeaderCache	ResponseHeaderCache	No	Follows origin server cache header configuration. Note: this field may return null, indicating that no valid values can be obtained.
Seo	Seo	No	SEO configuration. Note: this field may return null, indicating that no valid values can be obtained.
ServiceType	String	No	Domain name service type. `web`: static acceleration; `download`: download acceleration; `media`: streaming media acceleration. Note: this field may return null, indicating that no valid values can be obtained.
StatusCodeCache	StatusCodeCache	No	Status code cache configuration. Note: this field may return null, indicating that no valid values can be obtained.
VideoSeek	VideoSeek	No	Video dragging configuration. Note: this field may return null, indicating that no valid values can be obtained.
AwsPrivateAccess	AwsPrivateAccess	No	Private access for S3 origin Note: this field may return `null`, indicating that no valid values can be obtained.
OssPrivateAccess	OssPrivateAccess	No	Private access for OSS origin Note: this field may return `null`, indicating that no valid values can be obtained.

PathBasedOriginRule

Path-based origin-pull rules

Used by actions: AddCdnDomain, DescribeDomains, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
RuleType	String	Yes	Rule types: `file`: effective for files with specified suffixes. `directory`: effective for specified paths. `path`: effective for specified absolute paths. `index`: effective for specified homepages.
RulePaths	Array of String	Yes	Content for each `RuleType`: For `file`, enter a suffix, e.g., `jpg` or `txt`. For `directory`, enter a path, e.g., `/xxx/test/`. For `path`, enter an absolute path, e.g., `/xxx/test.html`. For `index`, enter a forward slash `/`.
Origin	Array of String	Yes	Origin server list. Domain names and IPv4 addresses are supported.

PathRule

Path-based origin-pull configuration rules

Used by actions: AddCdnDomain, DescribeDomains, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Regex	Boolean	Yes	Whether to enable wildcard match (`*`). false: disable true: enable Note: this field may return `null`, indicating that no valid values can be obtained.
Path	String	Yes	Matched URL. Only URLs are supported, while parameters are not. The exact match is used by default. If wildcard match is enabled, up to 5 wildcards are supported. The URL can contain up to 1,024 characters. Note: this field may return `null`, indicating that no valid values can be obtained.
Origin	String	No	Origin server when the path matches. COS origin with private read/write is not supported. The default origin server will be used by default when this field is left empty. Note: this field may return `null`, indicating that no valid values can be obtained.
ServerName	String	No	Origin server host header when the path matches. The default `ServerName` will be used by default when this field is left empty. Note: this field may return `null`, indicating that no valid values can be obtained.
OriginArea	String	No	Origin server region. Valid values: `CN` and `OV`. CN: the Chinese mainland OV: outside the Chinese mainland Default value: `CN`. Note: this field may return `null`, indicating that no valid values can be obtained.
ForwardUri	String	No	Origin server URI path when the path matches, starting with `/` and excluding parameters. The path can contain up to 1,024 characters. The wildcards in the match path can be respectively captured using `$1`, `$2`, `$3`, `$4`, and `$5`. Up to 10 values can be captured. Note: this field may return `null`, indicating that no valid values can be obtained.
RequestHeaders	Array of HttpHeaderRule	No	Origin-pull header setting when the path matches. Note: this field may return `null`, indicating that no valid value is obtained.
FullMatch	Boolean	No	When `Regex` is `false`, this parameter should be `true`. `false`: disabled `true`: enabled Note: this field may return `null`, indicating that no valid value can be obtained.

PostSize

Maximum size of the file uploaded for streaming via a POST request

Used by actions: DescribeDomainsConfig.

Name	Type	Required	Description
Switch	String	Yes	Limit the size of a POST request. The default value is 32 MB. off: Disable on: Enable
MaxSize	Integer	No	Maximum size. Value range: 1 MB to 200 MB.

PurgeTask

Purge task details.

Used by actions: DescribePurgeTasks.

Name	Type	Description
TaskId	String	Purge task ID
Url	String	Purged URL
Status	String	Purge task status `fail`: purge failed `done`: purge succeeded `process`: purge in progress
PurgeType	String	Purge type `url`: URL purge `path`: directory purge
FlushType	String	Purge method `flush`: purges updated resources; this type is available only for directory purges `delete`: purges all resources
CreateTime	Timestamp	Purge task submission time

PushTask

Prefetch task details.

Used by actions: DescribePushTasks.

Name	Type	Description
TaskId	String	Prefetch task ID
Url	String	Prefetched URL
Status	String	Prefetch task status `fail`: prefetch failed `done`: prefetch succeeded `process`: prefetch in progress `invalid`: invalid prefetch with 4XX/5XX status code returned from the origin server
Percent	Integer	Prefetch progress in percentage
CreateTime	Timestamp	Prefetch task submission time
Area	String	Prefetch region `mainland`: within Mainland China `overseas`: outside Mainland China `global`: global
UpdateTime	Timestamp	Prefetch task update time Note: this field may return null, indicating that no valid values can be obtained.

QnPrivateAccess

Used by actions: DescribeDomainsConfig.

Name	Type	Required
Switch	String	Yes
AccessKey	String	No
SecretKey	String	No

QueryStringKey

A part of CacheKey

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Switch	String	Yes	Whether to use `QueryString` as part of `CacheKey`. Valid values: on, off Note: this field may return null, indicating that no valid values can be obtained.
Reorder	String	No	Whether to sort again Note: this field may return null, indicating that no valid values can be obtained.
Action	String	No	Include/exclude query parameters. Valid values: `includeAll`, `excludeAll`, `includeCustom`, `excludeAll` Note: this field may return null, indicating that no valid values can be obtained.
Value	String	No	Array of included/excluded URL parameters (separated by ';') Note: this field may return null, indicating that no valid values can be obtained.

Quic

QUIC configuration item

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Switch	String	Yes	Whether to enable QUIC

Quota

Purge/Prefetch available usage and quota

Used by actions: DescribePurgeQuota, DescribePushQuota.

Name	Type	Description
Batch	Integer	Quota limit for one batch submission request.
Total	Integer	Daily submission quota limit.
Available	Integer	Remaining daily submission quota.
Area	String	Quota region.

RangeOriginPull

Range GETs configuration which is enabled by default

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Switch	String	Yes	Range GETs configuration switch on: enabled off: disabled
RangeRules	Array of RangeOriginPullRule	No	Range GETs configuration Note: this field may return `null`, indicating that no valid values can be obtained.

RangeOriginPullRule

Range GETs configuration

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Switch	String	Yes	Specifies whether Range GETs is enabled
RuleType	String	Yes	Rule types: `file`: effective for specified file suffixes. `directory`: effective for specified paths. `path`: effective for specified absolute paths. Note: this field may return `null`, indicating that no valid values can be obtained.
RulePaths	Array of String	Yes	Content for each `RuleType`: For `file`, enter a suffix, e.g., `jpg` or `txt`. For `directory`, enter a path, e.g., `/xxx/test/`. For `path`, enter an absolute path, e.g., `/xxx/test.html`. Note: this field may return `null`, indicating that no valid values can be obtained.

Referer

Referer blocklist/allowlist configuration. This is disabled by default.

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Switch	String	Yes	Referer blocklist/allowlist configuration switch on: enabled off: disabled
RefererRules	Array of RefererRule	No	Referer blocklist/allowlist configuration rule Note: this field may return null, indicating that no valid values can be obtained.

RefererRule

Referer blocklist/allowlist configuration rules, which is effective for specific resources.

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
RuleType	String	Yes	Rule types: `all`: effective for all files `file`: effective for specified file suffixes `directory`: effective for specified paths `path`: effective for specified absolute paths
RulePaths	Array of String	Yes	Content for each RuleType: For `all`, enter an asterisk (*). For `file`, enter the suffix, such as jpg, txt. For `directory`, enter the path, such as /xxx/test/. For `path`, enter the corresponding absolute path, such as /xxx/test.html.
RefererType	String	Yes	Referer configuration types whitelist: allowlist blacklist: blocklist
Referers	Array of String	Yes	Referer content list
AllowEmpty	Boolean	Yes	Whether to allow empty referer true: allow empty referer false: do not allow empty referer

RegionMapRelation

Association between a region ID and sub-region IDs.

Used by actions: DescribeMapInfo.

Name	Type	Description
RegionId	Integer	Region ID
SubRegionIdList	Array of Integer	List of sub-region IDs

RemoteAuthentication

Configuration of remote authentication rules. Setting up multiple rules is supported.
RemoteAuthenticationRules and Server cannot be configured at the same time.
If only Server is configured, all parameters of RemoteAuthenticationRules will be set to the default values. The default values are described in each configuration parameter.

Used by actions: DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Switch	String	Yes	Remote authentication switch `on`: enable `off`: disable Note: this field may return `null`, indicating that no valid values can be obtained.
RemoteAuthenticationRules	Array of RemoteAuthenticationRule	No	Remote authentication rule configuration Note: this field may return `null`, indicating that no valid values can be obtained.
Server	String	No	Remote authentication server Note: this field may return `null`, indicating that no valid values can be obtained.

RemoteAuthenticationRule

Remote authentication rule

Used by actions: DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Server	String	Yes	Remote authentication server The server configured in `RemoteAutherntication` is used by default.
AuthMethod	String	Yes	HTTP method used by the remote authentication server. Valid values: `get`, `post`, `head`, and `all`. `all`: the remote authentication server follows the client request method. Default: `all`
RuleType	String	Yes	Rule types: `all`: apply to all files `file`: apply to files with the specified suffixes `directory`: apply to the specified directories `path`: apply to the specified absolute paths Default: `all`.
RulePaths	Array of String	Yes	Content for each `RuleType`: For `all`, enter a wildcard ``. For `file`, enter a suffix, e.g., `jpg` or `txt`. For `directory`, enter a path, e.g., `/xxx/test/`. For `path`, enter an absolute path, e.g., `/xxx/test.html`. For `index`, enter a forward slash `/`. Default: ``
AuthTimeout	Integer	Yes	Timeout period of the remote authentication server. Unit: ms. Value range: [1, 30,000] Default: 20000
AuthTimeoutAction	String	Yes	Whether to deny or allow the request when the remote authentication server is timed out: `RETURN_200`: the request is allowed when the remote authentication server is timed out. `RETURN_403`: the request is denied when the remote authentication server is timed out. Default: `RETURN_200`

ReportData

CDN report data

Used by actions: DescribeReportData.

Name	Type	Description
ResourceId	String	Project ID/domain name ID.
Resource	String	Project name/domain name.
Value	Integer	Total traffic/max bandwidth in bytes and bps, respectively.
Percentage	Float	Percentage of individual resource out of all resources.
BillingValue	Integer	Total billable traffic/max billable bandwidth in bytes and bps, respectively.
BillingPercentage	Float	Percentage of billable amount out of total amount.

RequestHeader

Custom request header configuration. This is disabled by default.

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Switch	String	Yes	Custom request header configuration switch on: enabled off: disabled
HeaderRules	Array of HttpHeaderPathRule	No	Custom request header configuration rules Note: this field may return null, indicating that no valid values can be obtained.

ResourceBillingData

Billing data details

Used by actions: DescribeBillingData.

Name	Type	Description
Resource	String	Resource name, which is categorized as follows based on different query conditions: Specific domain name: domain name details multiDomains: aggregated details of multiple domain names Project ID: displays the ID of the specified project to be queried all: the details at the account level
BillingData	Array of CdnData	Billing data details

ResourceData

This API is used to query an object and its access details

Used by actions: DescribeCdnData, DescribeIpVisit.

Name	Type	Description
Resource	String	Resource name, which is classified as follows based on different query filters: A single domain name: queries domain name details by a domain name. The details of the domain name will be displayed when the passed parameter `detail` is `true` (the `detail` parameter defaults to `false`). Multiple domain names: queries domain name details by multiple domain names. The aggregated details of the domain names will be displayed. Project ID: queries domain name details by a project ID. The aggregated details of the domain names of the project will be displayed. `all`: account-level data, which is aggregated details of all domain names of an account.
CdnData	Array of CdnData	Data details of a resource

ResourceOriginData

This API is used to query an object and its origin-pull details

Used by actions: DescribeOriginData.

Name	Type	Description
Resource	String	Resource name, which is classified as follows based on different query conditions: A specific domain name: This indicates the details of this domain name multiDomains: This indicates the aggregate details of multiple domain names Project ID: This displays the ID of the specifically queried project all: This indicates the details at the account level
OriginData	Array of CdnData	Origin-pull data details

ResponseHeader

Custom response header configuration. This is disabled by default.

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Switch	String	Yes	Custom response header switch on: enabled off: disabled
HeaderRules	Array of HttpHeaderPathRule	No	Custom response header rules Note: this field may return null, indicating that no valid values can be obtained.

ResponseHeaderCache

Origin server header cache configuration. This is enabled by default and caches all the header information.

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Switch	String	Yes	Origin server header cache switch on: enabled off: disabled

Revalidate

Whether to forward to the origin server for verification

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Switch	String	Yes	Whether to always forward to the origin server for verification. Valid values: on, off Note: this field may return null, indicating that no valid values can be obtained.
Path	String	No	Forwards to the origin server for verification only for specific request path Note: this field may return null, indicating that no valid values can be obtained.

RuleCache

Path-based cache rule configuration
The cache expiration time for all files is 30 days by default.
Static acceleration type domain names .php, .jsp, .asp, and .aspx are not cached by default.

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
RulePaths	Array of String	Yes	Content for each `CacheType`: For `all`, enter a wildcard `*`. For `file`, enter the suffix, e.g., `jpg` or `txt`. For `directory`, enter the path, e.g., `/xxx/test/`. For `path`, enter the absolute path, e.g., `/xxx/test.html`. For `index`, enter a forward slash `/`. Note: This field may return `null`, indicating that no valid values can be obtained.
RuleType	String	Yes	Rule types: `all`: effective for all files. `file`: effective for specified file suffixes. `directory`: effective for specified paths. `path`: effective for specified absolute paths. `index`: homepage. Note: This field may return `null`, indicating that no valid values can be obtained.
CacheConfig	RuleCacheConfig	Yes	Cache configuration Note: this field may return null, indicating that no valid value is obtained.

RuleCacheConfig

Path cache configuration, choose one from the following three cache modes.

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Cache	CacheConfigCache	Yes	Cache configuration Note: this field may return `null`, indicating that no valid value is obtained.
NoCache	CacheConfigNoCache	Yes	No cache configuration Note: this field may return null, indicating that no valid value is obtained.
FollowOrigin	CacheConfigFollowOrigin	Yes	Follows the origin server configuration Note: this field may return null, indicating that no valid value is obtained.

RuleEngine

Rule engine configuration

Used by actions: DescribeDomainsConfig.

Name	Type	Required	Description
Switch	String	Yes	Specifies whether to enable rule engine `on`: Enable `off`: Disable
Content	String	No	Rule Note: This field may return `null`, indicating that no valid values can be obtained.

RuleQueryString

Configuration to retain query strings for this path

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Switch	String	Yes	Whether to use `QueryString` as part of `CacheKey`. Valid values: on, off Note: this field may return null, indicating that no valid value is obtained.
Action	String	Yes	`includeCustom` will retain partial query strings Note: this field may return null, indicating that no valid value is obtained.
Value	String	Yes	Array of included/excluded query strings (separated by ';') Note: this field may return null, indicating that no valid value is obtained.

ScdnAclConfig

SCDN access control

Used by actions: UpdateScdnDomain.

Name	Type	Required	Description
Switch	String	Yes	Whether to enable. Valid values: `on` and `off`.
ScriptData	Array of ScdnAclGroup	No	This field is disused. Please use `AdvancedScriptData` instead. Note: this field may return `null`, indicating that no valid values can be obtained.
ErrorPage	ScdnErrorPage	No	Error page configuration Note: this field may return `null`, indicating that no valid values can be obtained.
AdvancedScriptData	Array of AdvancedScdnAclGroup	No	ACL rule group, which is required when the access control is on. Note: this field may return `null`, indicating that no valid values can be obtained.

ScdnAclGroup

SCDN precise access control configuration

Used by actions: UpdateScdnDomain.

Name	Type	Required	Description
RuleName	String	Yes	Rule name
Configure	Array of ScdnAclRule	Yes	Specific configurations
Result	String	Yes	Action. Valid values: `intercept` and `redirect`.
Status	String	No	Whether the rule is effective. Valid values: `active` and `inactive`.
ErrorPage	ScdnErrorPage	No	Error page configuration. Note: this field may return `null`, indicating that no valid values can be obtained.

ScdnAclRule

Precise access control match rule

Used by actions: UpdateScdnDomain.

Name	Type	Required	Description
MatchKey	String	Yes	Keyword
LogiOperator	String	Yes	Logical operator. Valid values:
MatchValue	String	Yes	Matched value

ScdnBotConfig

Bot configuration

Used by actions: UpdateScdnDomain.

Name	Type	Required	Description
Switch	String	Yes	Valid values: `on` and `off`.
BotCookie	Array of BotCookie	No	Bot cookie policy Note: this field may return `null`, indicating that no valid values can be obtained.
BotJavaScript	Array of BotJavaScript	No	Bot JS policy Note: this field may return `null`, indicating that no valid values can be obtained.

ScdnCCRules

SCDN custom CC rules

Used by actions: UpdateScdnDomain.

Name	Type	Required	Description
RuleType	String	Yes	Rule types: `all`: effective for all files. `file`: effective for specified file suffixes. `directory`: effective for specified paths. `path`: effective for specified absolute paths. `index`: effective for web homepages and root directories.
RuleValue	Array of String	Yes	Rule value (blocking condition)
Qps	Integer	No	IP access limit rule
DetectionTime	Integer	No	Detection granularity Note: this field may return `null`, indicating that no valid values can be obtained.
FrequencyLimit	Integer	No	Frequency threshold Note: this field may return `null`, indicating that no valid values can be obtained.
PunishmentSwitch	String	No	Whether to block or redirect requests from suspicious IPs. Valid values: `on` and `off`. Note: this field may return `null`, indicating that no valid values can be obtained.
PunishmentTime	Integer	No	Suspicious IP restriction duration Note: this field may return `null`, indicating that no valid values can be obtained.
Action	String	No	Action. Valid values: `intercept` and `redirect`. Note: this field may return `null`, indicating that no valid values can be obtained.
RedirectUrl	String	No	The redirection target URL used when the `Action` is `redirect` Note: this field may return `null`, indicating that no valid values can be obtained.

ScdnConfig

CC attack defense configuration

Used by actions: UpdateScdnDomain.

Name	Type	Required	Description
Switch	String	Yes	Valid values: `on` and `off`.
Rules	Array of ScdnCCRules	No	Custom CC attack defense rule Note: this field may return `null`, indicating that no valid values can be obtained.
AdvancedRules	Array of AdvancedCCRules	No	Advanced custom CC attack defense rule Note: this field may return `null`, indicating that no valid values can be obtained.

ScdnDdosConfig

DDoS configuration

Used by actions: UpdateScdnDomain.

Name	Type	Required	Description
Switch	String	Yes	Whether to enable DDoS defense. Valid values: `on` and `off`.

ScdnErrorPage

ACL error page

Used by actions: UpdateScdnDomain.

Name	Type	Required	Description
RedirectCode	Integer	Yes	Status code `403` is passed in when the action is `intercept`. `301` is passed in when the action is `redirect`.
RedirectUrl	String	Yes	Redirection URL

ScdnSevenLayerRules

SCDN layer-7 rule configuration for CC frequency limiting

Used by actions: UpdateScdnDomain.

Name	Type	Required	Description
CaseSensitive	Boolean	Yes	Whether values are case sensitive
RuleType	String	Yes	Rule types: `protocol`: protocol. Valid values: `HTTP` and `HTTPS`. `method`: request method. Valid values: `HEAD`, `GET`, `POST`, `PUT`, `OPTIONS`, `TRACE`, `DELETE`, `PATCH` and `CONNECT`. `all`: domain name. The matching content is `` and cannot be edited. `ip`: IP in CIDR format. `directory`: path starting with a slash (/). You can specify a directory or specific path using up to 128 characters. `index`: default homepage, which is specified by `/;/index.html` and cannot be edited. `path`: full path of the file, such as `/acb/test.png`. Wildcard is supported, such as `/abc/.jpg`. `file`: file extension, such as `jpg`, `png` and `css`. `param`: request parameter. The value can contain up to 512 characters. `referer`: Referer. The value can contain up to 512 characters. `cookie`: Cookie. The value can contain up to 512 characters. `user-agent`: User-Agent. The value can contain up to 512 characters. `head`: custom header. The value can contain up to 512 characters. If the matching content is blank or does not exist, enter the matching parameter directly.
LogicOperator	String	Yes	Logical operator, which connects the relation between RuleType and RuleValue. Valid values: `exclude`: the rule value is not contained. `include`: the rule value is contained. `notequal`: the rule value is not equal to the specified rule type. `equal`: the rule value is equal to the specified rule type. `matching`: the rule value matches with the prefix of the specified rule type. `null`: the rule value is empty or does not exist.
RuleValue	Array of String	No	Rule value Note: this field may return `null`, indicating that no valid values can be obtained.
RuleParam	String	No	Matched parameter. Only request parameters, Cookie, and custom request headers have a value. Note: this field may return `null`, indicating that no valid values can be obtained.

ScdnWafConfig

WAF configuration

Used by actions: UpdateScdnDomain.

Name	Type	Required	Description
Switch	String	Yes	Whether to enable WAF. Valid values: `on` and `off`.
Mode	String	No	WAF protection mode. Valid values: `intercept` and `observe`. Default value: `intercept`. Note: this field may return `null`, indicating that no valid values can be obtained.
ErrorPage	ScdnErrorPage	No	Redirection error page Note: this field may return `null`, indicating that no valid values can be obtained.
WebShellSwitch	String	No	Whether to enable Web shell blocking. Valid values: `on` and `off`. Default value: `off`. Note: this field may return `null`, indicating that no valid values can be obtained.
Rules	Array of ScdnWafRule	No	Attack blocking rules Note: this field may return `null`, indicating that no valid values can be obtained.
Level	Integer	No	WAF rule level. Valid values: 100, 200, and 300. Note: this field may return `null`, indicating that no valid values can be obtained.
SubRuleSwitch	Array of WafSubRuleStatus	No	WAF sub-rule switch Note: this field may return `null`, indicating that no valid values can be obtained.

ScdnWafRule

WAF rule information

Used by actions: UpdateScdnDomain.

Name	Type	Required	Description
AttackType	String	Yes	Attack type
Operate	String	Yes	Defense action. Valid value: `observe`.

SchemeKey

A part of CacheKey

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Switch	String	Yes	Whether to use the scheme as part of the cache key. Valid values: on, off Note: this field may return null, indicating that no valid values can be obtained.

SecurityConfig

SCDN configuration

Used by actions: DescribeDomainsConfig.

Name	Type	Description
Switch	String	on\|off

Seo

SEO configuration. This is disabled by default.

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Switch	String	Yes	SEO configuration switch on: enabled off: disabled Note: this field may return null, indicating that no valid values can be obtained.

ServerCert

HTTPS acceleration server certificate configuration:

Supports deployment with certificates that are being hosted by the SSL Certificate Services
Supports uploading certificates of PEM format for deployment
Note: when uploading certificates of PEM format, the Base64 encoding is required.

Used by actions: AddCdnDomain, DescribeDomains, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
CertId	String	No	Server certificate ID, which is auto-generated when the certificate is added to Tencent Cloud SSL Certificates Note: this field may return `null`, indicating that no valid values can be obtained.
CertName	String	No	Server certificate name This is auto-generated when the certificate is being hosted by the SSL Certificate Service Note: this field may return null, indicating that no valid values can be obtained.
Certificate	String	No	Server certificate information This is required when uploading an external certificate, which should contain the complete certificate chain. Note: this field may return null, indicating that no valid values can be obtained.
PrivateKey	String	No	Server key information This is required when uploading an external certificate. Note: this field may return null, indicating that no valid values can be obtained.
ExpireTime	Timestamp	No	Certificate expiration time Can be left blank when used as an input parameter Note: this field may return null, indicating that no valid values can be obtained.
DeployTime	Timestamp	No	Certificate issuance time Can be left blank when used as an input parameter Note: this field may return null, indicating that no valid values can be obtained.
Message	String	No	Certificate remarks Note: this field may return null, indicating that no valid values can be obtained.
From	String	No	Certificate source Note: This field may return `null`, indicating that no valid values can be obtained.

ShareCname

Shared CNAME configuration

Used by actions: DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Switch	String	Yes	Specifies whether to enable Shared CNAME. If it is set to `off`, the default CNAME is used. If it is set to `on`, a shared CNAME is used. * ShareCname is only available to beta users. To use this feature, please submit a ticket for application.
Cname	String	No	Shared CNAME to be configured Note: this field may return `null`, indicating that no valid values can be obtained.

SimpleCache

Cache configuration basic version
The cache expiration time for all files is 30 days by default.
Static acceleration type domain names .php, .jsp, .asp, and .aspx are not cached by default
Note: this version does not support setting cache expiration rules if the origin server does not return max-age

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
CacheRules	Array of SimpleCacheRule	Yes	Cache expiration time rules Note: this field may return null, indicating that no valid values can be obtained.
FollowOrigin	String	Yes	Follows origin server Cache-Control: max-age configurations on: enabled off: disabled If this is enabled, resources that do not match CacheRules rules will be cached by the node according to the max-age value returned by the origin server. Resources that match CacheRules rules will be cached on the node according to the cache expiration time set in CacheRules. This conflicts with CompareMaxAge. The two cannot be enabled at the same time. Note: this field may return null, indicating that no valid values can be obtained.
IgnoreCacheControl	String	Yes	Forced cache on: enable off: disable This is disabled by default. If enabled, the `no-store` and `no-cache` resources returned from the origin server will be cached according to `CacheRules` rules. Note: this field may return null, indicating that no valid values can be obtained.
IgnoreSetCookie	String	Yes	Ignores the Set-Cookie header of the origin server on: enabled off: disabled This is disabled by default Note: this field may return null, indicating that no valid values can be obtained.
CompareMaxAge	String	Yes	Advanced cache expiration configuration. If this is enabled, the max-age value returned by the origin server will be compared with the cache expiration time set in CacheRules, and the smallest value will be cached on the node. on: enabled off: disabled This is disabled by default Note: this field may return null, indicating that no valid values can be obtained.
Revalidate	Revalidate	No	Always forwards to the origin server for verification Note: this field may return null, indicating that no valid values can be obtained.

SimpleCacheRule

Cache expiration rules configuration

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
CacheType	String	Yes	Rule types: `all`: effective for all files `file`: effective for specified file suffixes `directory`: effective for specified paths `path`: effective for specified absolute paths index: home page
CacheContents	Array of String	Yes	Content for each CacheType: Enter `*` for `all` Enter an extension for `file`, such as `jpg` or `txt` Enter a path for `directory`, such as `/xxx/test` Enter an absolute path for `path`, such as `/xxx/test.html` Enter `/` for `index`
CacheTime	Integer	Yes	Cache expiration time settings Unit: second. The maximum value is 365 days.

Sort

Sorting conditions for query results.

Used by actions: DescribeDomainsConfig.

Name	Type	Required	Description
Key	String	No	Fields that can be sorted. Currently supports: `createTime`: domain name creation time. `certExpireTime`: certificate expiration time. Default value: createTime.
Sequence	String	No	`asc` or `desc`. Default: `desc`.

SpecificConfig

Specific configuration for domain names inside and outside mainland China by regions.

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Mainland	MainlandConfig	No	Specific configuration for domain name inside mainland China. Note: this field may return null, indicating that no valid values can be obtained.
Overseas	OverseaConfig	No	Specific configuration for domain name outside mainland China. Note: this field may return null, indicating that no valid values can be obtained.

StatusCodeCache

Status code cache expiration configuration. 404 status codes are cached for 10 seconds by default

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Switch	String	Yes	Status code cache expiration configuration switch on: enabled off: disabled Note: this field may return null, indicating that no valid values can be obtained.
CacheRules	Array of StatusCodeCacheRule	No	Status code cache expiration rules details Note: this field may return null, indicating that no valid values can be obtained.

StatusCodeCacheRule

Status code cache expiration time rule configuration

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
StatusCode	String	Yes	HTTP status code Supports 403 and 404 status codes
CacheTime	Integer	Yes	Status code cache expiration time (in seconds)

SummarizedData

Aggregate values of details; each metric has different aggregation methods based on its characteristics

Used by actions: DescribeBillingData, DescribeCdnData, DescribeIpVisit, DescribeOriginData.

Name	Type	Description
Name	String	Aggregation method, which can be: sum: aggregate summation max: maximum value; in bandwidth mode, the peak bandwidth is calculated based on the aggregate data with 5-minute granularity. avg: average value
Value	Float	Aggregate data value

Tag

Domain name tag configuration

Used by actions: AddCdnDomain, DescribeDomainsConfig.

Name	Type	Required	Description
TagKey	String	Yes	Tag key Note: this field may return null, indicating that no valid value is obtained.
TagValue	String	Yes	Tag value. Note: this field may return null, indicating that no valid value is obtained.

TimestampData

Timestamp and its corresponding value

Used by actions: DescribeBillingData, DescribeCdnData, DescribeIpVisit, DescribeOriginData.

Name	Type	Description
Time	Timestamp	Statistical point in time in forward rounding mode Taking the 5-minute granularity as an example, 13:35:00 indicates that the statistical interval is between 13:35:00 and 13:39:59.
Value	Float	Data value

TopData

Data structure of sorted data

Used by actions: ListTopData.

Name	Type	Description
Resource	String	Resource name, which is classified as follows based on different query conditions: A specific domain name: This indicates the details of this domain name multiDomains: This indicates the aggregate details of multiple domain names Project ID: This displays the ID of the specifically queried project all: This indicates the details at the account level
DetailData	Array of TopDetailData	Detailed sorting results

TopDetailData

Data structure of sorted data

Used by actions: ListTopData.

Name	Type	Description
Name	String	Datatype name
Value	Float	Data value

TopicInfo

CLS topic information

Used by actions: ListClsLogTopics.

Name	Type	Description
TopicId	String	Topic ID
TopicName	String	Topic name
Enabled	Integer	Whether to enable publishing
CreateTime	Timestamp	Creation time Note: this field may return null, indicating that no valid values can be obtained.
Channel	String	Either `cdn` or `ecdn`. Note: this field may return `null`, indicating that no valid values can be obtained.
Deleted	String	Whether the log topic has been removed from CLS Note: this field may return `null`, indicating that no valid values can be obtained.

TpgAdapter

Image optimization - TpgAdapter configuration

Used by actions: DescribeDomainsConfig.

Name	Type	Required	Description
Switch	String	No	Switch. Valid values: on, off Note: this field may return null, indicating that no valid values can be obtained.

UrlRecord

Details of the blocked URLs

Used by actions: GetDisableRecords.

Name	Type	Description
Status	String	Status (disable: blocked; enable: unblocked) Note: This field may return null, indicating that no valid values can be obtained.
RealUrl	String	Corresponding URL Note: This field may return null, indicating that no valid values can be obtained.
CreateTime	String	Creation time Note: This field may return null, indicating that no valid values can be obtained.
UpdateTime	String	Update time Note: This field may return null, indicating that no valid values can be obtained.

UrlRedirect

Configuration of URL rewriting

Used by actions: DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Switch	String	Yes	Whether URL rewriting is enabled `on`: enabled `off`: disabled
PathRules	Array of UrlRedirectRule	No	Rule of URL rewriting rule, which is required if `Switch` is `on`. There can be up to 10 rules. Note: this field may return `null`, indicating that no valid value can be obtained.

UrlRedirectRule

URL redirect rule configuration

Used by actions: DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
RedirectStatusCode	Integer	Yes	Redirect status code. Valid values: 301, 302
Pattern	String	Yes	URL to be matched. Only URLs are supported, while parameters are not. The exact match is used by default. In regex match, up to 5 wildcards `*` are supported. The URL can contain up to 1,024 characters.
RedirectUrl	String	Yes	Target URL, starting with `/` and excluding parameters. The path can contain up to 1,024 characters. The wildcards in the matching path can be respectively captured using `$1`, `$2`, `$3`, `$4`, and `$5`. Up to 10 values can be captured.
RedirectHost	String	No	Target host. It should be a standard domain name starting with `http://` or `https://`. If it is left empty, “http://[current domain name]” will be used by default. Note: this field may return `null`, indicating that no valid values can be obtained.
FullMatch	Boolean	No	Whether to use full-path matching or arbitrary matching Note: this field may return `null`, indicating that no valid values can be obtained.

UserAgentFilter

UserAgent blocklist/allowlist configuration

Used by actions: DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Switch	String	Yes	Switch. Valid values: on, off Note: this field may return null, indicating that no valid values can be obtained.
FilterRules	Array of UserAgentFilterRule	No	UA blocklist/allowlist effect rule list Note: this field may return null, indicating that no valid values can be obtained.

UserAgentFilterRule

UserAgent blocklist/allowlist rule configuration

Used by actions: DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
RuleType	String	Yes	Effective access path type all: all access paths are effective file: effective by file extension directory: effective by directory path: effective by full access path Note: this field may return null, indicating that no valid values can be obtained.
RulePaths	Array of String	Yes	Effective access paths Note: this field may return null, indicating that no valid values can be obtained.
UserAgents	Array of String	Yes	`UserAgent` list Note: this field may return null, indicating that no valid values can be obtained.
FilterType	String	Yes	blocklist or allowlist. Valid values: blacklist, whitelist Note: this field may return null, indicating that no valid values can be obtained.

VideoSeek

Video dragging configuration. This is disabled by default.

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Switch	String	Yes	Video dragging switch on: enabled off: disabled

ViolationUrl

Details of URLs in violation

Used by actions: DescribeUrlViolations.

Name	Type	Description
Id	Integer	ID
RealUrl	String	Origin access URL of the resource in violation
DownloadUrl	String	Snapshot path. This is used to display a snapshot of the content in violation on the console.
UrlStatus	String	Current status of the resources in violation forbid: blocked release: unblocked delay: processing delayed reject: appeal dismissed. The status is still blocked. complain: appeal in process
CreateTime	Timestamp	Creation time
UpdateTime	Timestamp	Update time

WafSubRuleStatus

WAF sub-rule switch status

Used by actions: UpdateScdnDomain.

Name	Type	Required	Description
Switch	String	Yes	Sub-rule status. Valid values: `on` and `off`.
SubIds	Array of Integer	Yes	List of rule IDs

WebSocket

WebSocket configuration.

Used by actions: DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Switch	String	Yes	Whether to enable custom WebSocket timeout setting. When it’s `off`: WebSocket connection is supported, and the default timeout period is 15 seconds. To change the timeout period, please set it to `on`. * WebSocket is now only available for beta users. To use it, please submit a ticket.
Timeout	Integer	No	Sets the timeout period in seconds. Maximum value: 65. Note: this field may return `null`, indicating that no valid values can be obtained.

WebpAdapter

Image optimization - WebpAdapter configuration

Used by actions: DescribeDomainsConfig.

Name	Type	Required	Description
Switch	String	No	Switch. Valid values: on, off Note: this field may return null, indicating that no valid values can be obtained.

Contact Us

Contact our sales team or business advisors to help your business.

Technical Support

Open a ticket if you're looking for further assistance. Our Ticket is 7x24 avaliable.

7x24 Phone Support

tencent cloud

Become a Partner

Tencent Cloud Partner Network

Become a Partner

Training & Support

International Partner Academy

Sign Up

Log in

Recent Pages

Data Types

AccessControl

AccessControlRule

AdvanceCacheRule

AdvanceConfig

AdvanceHttps

AdvancedAuthentication

AdvancedAuthenticationTypeA

AdvancedAuthenticationTypeB

AdvancedAuthenticationTypeC

AdvancedAuthenticationTypeD

AdvancedAuthenticationTypeE

AdvancedAuthenticationTypeF

AdvancedCCRules

AdvancedCache

AdvancedScdnAclGroup

AdvancedScdnAclRule

Authentication

AuthenticationTypeA

AuthenticationTypeB

AuthenticationTypeC

AuthenticationTypeD

AwsPrivateAccess

BandwidthAlert

BotCookie

BotJavaScript

BriefDomain

Cache

CacheConfigCache

CacheConfigFollowOrigin

CacheConfigNoCache

CacheKey

CacheOptResult

CacheTagKey

CappingRule

CdnData

CdnIp

CdnIpHistory

ClientCert

ClsLogObject

ClsSearchLogs

Compatibility

Compression

CompressionRule

CookieKey

DetailDomain

DomainAreaConfig

DomainFilter

DomainLog

DownstreamCapping

ErrorPage

ErrorPageRule

ExtraLogset

FollowRedirect

ForceRedirect

GuetzliAdapter

HeaderKey

Hsts

HttpHeaderPathRule

HttpHeaderRule

Https

HwPrivateAccess

ImageOptimization

IpFilter

IpFilterPathRule

IpFreqLimit

IpStatus

Ipv6

Ipv6Access

KeyRule

LogSetInfo