Tencent Cloud

Prev Next

search by keyword

Recent Pages

Documentation

Data Types

Last updated: 2023-12-01 16:39:50

AccessControl

Request header and request URL access control

Used by actions: DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Switch	String	Yes	Whether to enable access control based on the request header and request URL. Values: `on`: Enable `off`: Disable
AccessControlRules	Array of AccessControlRule	No	Request header and request URL access rule Note: This field may return `null`, indicating that no valid value can be obtained.
ReturnCode	Integer	No	Returns status code Note: This field may return `null`, indicating that no valid value 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 value can be obtained.
RuleContent	String	Yes	Blocked content Note: This field may return `null`, indicating that no valid value can be obtained.
Regex	String	Yes	on: regular match off: exact match Note: This field may return `null`, indicating that no valid value 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 value can be obtained.

AdvanceCacheRule

Advanced cache configuration rules

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
CacheType	String	Yes	Rule types: `all`: Apply to all files. `file`: Apply to files with the specified suffixes. `directory`: Apply to specified paths. `path`: Apply to 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 value can be obtained.
CacheContents	Array of String	Yes	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 `default`, enter "no max-age". Note: This field may return `null`, indicating that no valid value 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 value can be obtained.

AdvanceConfig

Advanced configuration settings

Used by actions: DescribeDomainsConfig.

Name	Type	Description
Name	String	Advanced configuration name Note: This field may return `null`, indicating that no valid value can be obtained.
Value	String	Whether to support advanced configuration `on`: Supported `off`: Not supported Note: This field may return `null`, indicating that no valid value can be obtained.

AdvanceHttps

Custom HTTPS configuration for origin-pull

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	TLS version settings. 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-pull verification status `off`: Disables origin-pull verification `oneWay`: Only verify the origin `twoWay`: Enables two-way origin-pull verification Note: this field may return `null`, indicating that no valid values can be obtained.
CertInfo	ServerCert	No	Configuration information of the origin-pull certificate Note: this field may return `null`, indicating that no valid values can be obtained.
OriginCertInfo	ClientCert	No	Configuration 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	Whether to enable hot linking protection. Values: `on`: Enable `off`: Disable Only one advanced configuration can be enabled. Set the rests to `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 blocking. Values: `on`: Enable `off`: Disable 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.
Switch	String	No	Whether to enable custom CC rules. Values: `on`: Enable `off`: Disable 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 value can be 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.

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	Matched 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 areas `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 `GB`: United Kingdom `CZ`: Czech Republic `UA`: Ukraine `TR`: Türkiye `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	Whether to enable hot linking protection. Values: `on`: Enable `off`: Disable Only one advanced configuration can be enabled. Set the rests to `null`.
AuthAlgorithm	String	No	Authentication algorithm. Values: `md5`: Calculate the hash using MD5. `sha256`: Calculate the hash using SHA-256. Default value: `md5`. Note: This field may return·`null`, indicating that no valid values can be obtained.
TypeA	AuthenticationTypeA	No	Timestamp hotlink protection mode A configuration Note: This field may return `null`, indicating that no valid value 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 value can be obtained.
TypeC	AuthenticationTypeC	No	Timestamp hotlink protection mode C configuration Note: This field may return `null`, indicating that no valid value can be obtained.
TypeD	AuthenticationTypeD	No	Timestamp hotlink protection mode D configuration Note: This field may return `null`, indicating that no valid value 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 6-32 characters. Only digits and letters are allowed. 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	`whitelist`: All file types apart from the FileExtensions list are authenticated. `blacklist`: 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 value 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 6-32 characters. Only digits and letters are allowed. 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	whitelist: 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 value 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 6-32 characters. Only digits and letters are allowed. 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	`whitelist`: All file types apart from the FileExtensions list are authenticated. `blacklist`: 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 can be 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 value 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 6-32 characters. Only digits and letters are allowed. 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	`whitelist`: All file types apart from the FileExtensions list are authenticated. `blacklist`: 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 value can be obtained.

AvifAdapter

AVIF adapter, used for image optimization

Used by actions: DescribeDomainsConfig.

Name	Type	Required	Description
Switch	String	No	Whether to enable `AvifAdapter` for image optimization. Values: `on`: Enable `off`: Disable 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	Whether to enable origin-pull authentication for S3 buckets. `on`: Enable `off`: Disable
AccessKey	String	No	Access ID. Note: This field may return `null`, indicating that no valid value can be obtained.
SecretKey	String	No	Key. Note: This field may return `null`, indicating that no valid value can be obtained.
Region	String	No	Region. Note: This field may return `null`, indicating that no valid value can be obtained.
Bucket	String	No	BucketName Note: This field may return `null`, indicating that no valid value 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	Whether to enable usage limit. Values: `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 `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	Whether to enable alerts for usage limit. Values: `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 value can be obtained.
StatisticItems	Array of StatisticItem	No	Usage limit configuration Note: This field may return `null`, indicating that no valid value can be obtained.

BotCookie

Bot cookie policy

Used by actions: UpdateScdnDomain.

Name	Type	Required	Description
Switch	String	Yes	Whether to enable bot cookie policies. Values: `on`: Enable `off`: Disable
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	Whether to enable bot JS policies. Values: `on`: Enable `off`: Disable
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 `closing`: Disabling `online`: Enabled `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 media VOD acceleration
CreateTime	Timestamp	Domain name creation time.
UpdateTime	Timestamp	Domain name update time.
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 inside the Chinese mainland `overseas`: Acceleration outside the Chinese mainland `global`: Acceleration over the globe
Readonly	String	Domain name lock status `normal`: Not locked `mainland`: Locked in the Chinese mainland overseas: Locked outside the Chinese mainland 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 value can be obtained.
RuleCache	Array of RuleCache	No	Advanced path cache configuration Note: This field may return `null`, indicating that no valid value can be obtained.

CacheConfig

Heuristic cache validity configuration

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
HeuristicCacheTimeSwitch	String	Yes	Whether to enable heuristic cache validity. Values: `on`: Enable `off`: Disable Note: This field may return·`null`, indicating that no valid values can be obtained.
HeuristicCacheTime	Integer	Yes	Unit: Second Note: This field may return·`null`, indicating that no valid values can be obtained.

CacheConfigCache

Path cache configuration

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Switch	String	Yes	Whether to enable path cache. Values: `on`: Enable `off`: Disable Note: This field may return `null`, indicating that no valid values can be 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 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`: Enable `off`: Disable This is disabled by default. Note: This field may return `null`, indicating that no valid value can be 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 can be 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	Whether to follow the origin configuration for path cache. Values: `on`: Enable `off`: Disable
HeuristicCache	HeuristicCache	No	Heuristic cache configuration Note: This field may return `null`, indicating that no valid value can be obtained.

CacheConfigNoCache

Path cache/no cache configuration.

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Switch	String	Yes	Whether to enable no-caching at the path. Values: `on`: Enable `off`: Disable Note: This field may return `null`, indicating that no valid values can be obtained.
Revalidate	String	Yes	Always forwards to the origin server for verification `on`: Enable `off`: Disable It is disabled by default. Note: This field may return `null`, indicating that no valid value can be 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`: Enable full-path cache (i.e., disable Ignore Query String) `off`: Disable full-path cache (i.e., enable Ignore Query String)
IgnoreCase	String	No	Specifies whether the cache key is case sensitive Note: This field may return `null`, indicating that no valid value can be obtained.
QueryString	QueryStringKey	No	Request parameter contained in `CacheKey` Note: This field may return `null`, indicating that no valid value can be obtained.
Cookie	CookieKey	No	Cookie contained in `CacheKey` Note: This field may return `null`, indicating that no valid value can be obtained.
Header	HeaderKey	No	Request header contained in `CacheKey` Note: This field may return `null`, indicating that no valid value can be obtained.
CacheTag	CacheTagKey	No	Custom string contained in `CacheKey` Note: This field may return `null`, indicating that no valid value can be obtained.
Scheme	SchemeKey	No	Request protocol contained in `CacheKey` Note: This field may return `null`, indicating that no valid value can be obtained.
KeyRules	Array of KeyRule	No	Path-specific cache key configuration Note: This field may return `null`, indicating that no valid value can be 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 value can be obtained.
FailUrls	Array of String	List of failed URLs Note: This field may return `null`, indicating that no valid value can be obtained.

CacheTagKey

A part of CacheKey

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Switch	String	Yes	Whether to include `CacheTag` as part of `CacheKey`. Values: `on`: Yes `off`: No 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 value 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`: Apply to all files. `file`: Apply to files with the specified suffixes. `directory`: Apply to specified paths. `path`: Apply to specified absolute paths.
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`.
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 by 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) You can also 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	Activation and deactivation history of the node.
Area	String	Node region `mainland`: Acceleration nodes inside the Chinese mainland `overseas`: Acceleration nodes outside the Chinese mainland `unknown`: Service region unknown
City	String	City where the nodes reside Note: This field may return `null`, indicating that no valid value can be obtained.

CdnIpHistory

CDN node activation and deactivation history

Used by actions: DescribeCdnIp.

Name	Type	Description
Status	String	Operation type `online`: Nodes activated `offline`: Nodes deactivated
Datetime	Timestamp	Operation time corresponding to operation type If its value is `null`, it means there is no status change record. Note: This field may return `null`, indicating that no valid value 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 value can be obtained.
CertName	String	No	Client certificate name Note: This field may return `null`, indicating that no valid value 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 value 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 value 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 value 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	Whether to enable smart compression. Values: `on`: Enable `off`: Disable
CompressionRules	Array of CompressionRule	No	Compression rules array Note: This field may return `null`, indicating that no valid value 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 value can be obtained.
Algorithms	Array of String	Yes	File compression algorithm `gzip`: Gzip compression `brotli`: Brotli compression Note: This field may return `null`, indicating that no valid value can be obtained.
FileExtensions	Array of String	No	Compress based on file suffix. File suffixes such as jpg and txt are supported. Note: This field may return `null`, indicating that no valid value can be obtained.
RuleType	String	No	Rule types: `all`: Apply to all files. `file`: Apply to files with the specified suffixes. `directory`: Apply to specified paths. `path`: Apply to specified absolute paths. `contentType`: Apply 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 value 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 value can be obtained.

CookieKey

A part of CacheKey

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Switch	String	Yes	Whether to include Cookie as part of CacheKey. Values: `on`: Yes `off`: No 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 value 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	Accelerated 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 `closing`: Disabling `online`: Enabled `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	Domain name update time
Origin	Origin	Origin server configuration.
IpFilter	IpFilter	IP blocklist/allowlist configuration Note: This field may return `null`, indicating that no valid value can be obtained.
IpFreqLimit	IpFreqLimit	IP access limit configuration Note: This field may return `null`, indicating that no valid value can be obtained.
StatusCodeCache	StatusCodeCache	Status code cache configuration. Note: This field may return `null`, indicating that no valid value can be obtained.
Compression	Compression	Smart compression configuration. Note: This field may return `null`, indicating that no valid value can be obtained.
BandwidthAlert	BandwidthAlert	Bandwidth cap configuration Note: This field may return `null`, indicating that no valid value can be obtained.
RangeOriginPull	RangeOriginPull	Range GETs configuration Note: This field may return `null`, indicating that no valid value can be obtained.
FollowRedirect	FollowRedirect	301/302 origin-pull follow-redirect configuration Note: This field may return `null`, indicating that no valid value can be obtained.
ErrorPage	ErrorPage	Custom error page configuration Note: This field may return `null`, indicating that no valid value can be obtained.
RequestHeader	RequestHeader	Custom request header configuration Note: This field may return `null`, indicating that no valid value can be obtained.
ResponseHeader	ResponseHeader	Custom response header configuration Note: This field may return `null`, indicating that no valid value can be obtained.
DownstreamCapping	DownstreamCapping	Single-link downstream speed limit configuration Note: This field may return `null`, indicating that no valid value can be obtained.
CacheKey	CacheKey	Configuration of cache with/without parameter Note: This field may return `null`, indicating that no valid value can be obtained.
ResponseHeaderCache	ResponseHeaderCache	Origin server header cache configuration Note: This field may return `null`, indicating that no valid value can be obtained.
VideoSeek	VideoSeek	Video dragging configuration. Note: This field may return `null`, indicating that no valid value can be obtained.
Cache	Cache	Node cache expiration rule configuration Note: This field may return `null`, indicating that no valid value can be obtained.
OriginPullOptimization	OriginPullOptimization	Cross-border linkage optimization configuration (in beta) Note: This field may return `null`, indicating that no valid value can be obtained.
Https	Https	HTTPS Acceleration Configuration Guide Note: This field may return `null`, indicating that no valid value can be obtained.
Authentication	Authentication	Timestamp hotlink protection configuration. Note: This field may return `null`, indicating that no valid value can be obtained.
Seo	Seo	SEO configuration Note: This field may return `null`, indicating that no valid value 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 value can be obtained.
ForceRedirect	ForceRedirect	Access protocol forced redirect configuration Note: This field may return `null`, indicating that no valid value can be obtained.
Referer	Referer	Referer configuration Note: This field may return `null`, indicating that no valid value can be obtained.
MaxAge	MaxAge	Browser cache expiration rule configuration (in beta) Note: This field may return `null`, indicating that no valid value can be obtained.
Ipv6	Ipv6	IPv6 origin-pull configuration (in beta) Note: This field may return `null`, indicating that no valid value can be obtained.
Compatibility	Compatibility	Backwards compatibility configuration (compatibility field for internal use) Note: This field may return `null`, indicating that no valid value can be obtained.
SpecificConfig	SpecificConfig	Region-specific configuration Note: This field may return `null`, indicating that no valid value can be obtained.
Area	String	Acceleration region `mainland`: Acceleration inside the Chinese mainland `overseas`: Acceleration outside the Chinese mainland `global`: Acceleration over the globe Note: This field may return `null`, indicating that no valid value can be obtained.
Readonly	String	Domain name lock status `normal`: Not locked `mainland`: Locked in the Chinese mainland `overseas`: Locked outside the Chinese mainland global: Locked globally Note: This field may return `null`, indicating that no valid value can be obtained.
OriginPullTimeout	OriginPullTimeout	Origin-pull timeout configuration Note: This field may return `null`, indicating that no valid value can be obtained.
AwsPrivateAccess	AwsPrivateAccess	S3 bucket origin access authentication configuration Note: This field may return `null`, indicating that no valid value can be obtained.
SecurityConfig	SecurityConfig	SCDN configuration Note: This field may return `null`, indicating that no valid value can be obtained.
ImageOptimization	ImageOptimization	Image optimization configuration Note: This field may return `null`, indicating that no valid value can be obtained.
UserAgentFilter	UserAgentFilter	UA blocklist/allowlist configuration Note: This field may return `null`, indicating that no valid value can be obtained.
AccessControl	AccessControl	Access control Note: This field may return `null`, indicating that no valid value can be obtained.
Advance	String	Whether to support advanced configuration items `on`: Supported `off`: Not supported Note: This field may return `null`, indicating that no valid value can be obtained.
UrlRedirect	UrlRedirect	URL redirect configuration Note: This field may return `null`, indicating that no valid value can be obtained.
AccessPort	Array of Integer	Access port configuration Note: This field may return `null`, indicating that no valid value can be obtained.
Tag	Array of Tag	Tag configuration Note: This field may return `null`, indicating that no valid value can be obtained.
AdvancedAuthentication	AdvancedAuthentication	Timestamp hotlink protection advanced configuration (allowlist feature) Note: This field may return `null`, indicating that no valid value can be obtained.
OriginAuthentication	OriginAuthentication	Origin-pull authentication advanced configuration (allowlist feature) Note: This field may return `null`, indicating that no valid value can be obtained.
Ipv6Access	Ipv6Access	IPv6 access configuration Note: This field may return `null`, indicating that no valid value can be obtained.
AdvanceSet	Array of AdvanceConfig	Advanced configuration settings Note: This field may return `null`, indicating that no valid value can be obtained.
OfflineCache	OfflineCache	Offline cache (only available to beta users) Note: This field may return `null`, indicating that no valid value can be obtained.
OriginCombine	OriginCombine	Merging origin-pull requests (only available to beta users) Note: This field may return `null`, indicating that no valid value can be obtained.
PostMaxSize	PostSize	POST request configuration item Note: This field may return `null`, indicating that no valid value can be obtained.
Quic	Quic	QUIC configuration Note: This field may return `null`, indicating that no valid value can be obtained.
OssPrivateAccess	OssPrivateAccess	Access authentication for OSS origin Note: This field may return `null`, indicating that no valid value can be obtained.
WebSocket	WebSocket	WebSocket configuration. Note: This field may return `null`, indicating that no valid value can be obtained.
RemoteAuthentication	RemoteAuthentication	Remote authentication configuration Note: This field may return `null`, indicating that no valid value can be obtained.
ShareCname	ShareCname	Shared CNAME configuration (only available to beta users) Note: This field may return `null`, indicating that no valid value can be obtained.
RuleEngine	RuleEngine	Rule engine Note: This field may return `null`, indicating that no valid value can be obtained.
ParentHost	String	Primary domain name Note: This field may return `null`, indicating that no valid value can be obtained.
HwPrivateAccess	HwPrivateAccess	Access authentication for Huawei Cloud OBS origin Note: This field may return `null`, indicating that no valid value can be obtained.
QnPrivateAccess	QnPrivateAccess	Access authentication for QiNiu Cloud Kodo origin Note: This field may return `null`, indicating that no valid value can be obtained.
HttpsBilling	HttpsBilling	HTTPS (enabled by default) Note: This field may return `null`, indicating that no valid values can be obtained.
OthersPrivateAccess	OthersPrivateAccess	Origin-pull authentication for other origins Note: this field may return `null`, indicating that no valid values can be obtained.

DomainAreaConfig

Region configuration for domain names

Used by actions: AddCLSTopicDomains, 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	Filter filter. Values: - `origin`: Primary origin server. - `domain`: Domain name. - `resourceId`: Domain name ID. - `status`: Domain name status. Values: `online`, `offline`, and `processing`. - `serviceType`: Service type. Values: `web`, `download`, `media`, `hybrid` and `dynamic`. - `projectId`: Project ID. - `domainType`: Primary origin type. Values: `cname` (customer origin), `COS` (COS origin), `third_party` (third-party object storage origin), and `igtm` (IGTM origin). - `fullUrlCache`: Whether to enable path cache. Values: `on`, `off`. - `https`: Whether to configure HTTPS. Values: `on`, `off` and `processing`. - `originPullProtocol`: Origin-pull protocol type. Value: `http`, `follow`, and `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 the Chinese mainland `overseas`: Outside the Chinese mainland
LogName	String	Log package filename
FileSize	Integer	File size, in bytes. Note: This field may return `null`, indicating that no valid values can be obtained.

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	Whether to enable downstream speed limit. Values: `on`: Enable `off`: Disable
CappingRules	Array of CappingRule	No	Downstream speed limiting rules Note: This field may return `null`, indicating that no valid value 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	Whether to enable status code-based redirection. Values: `on`: Enable `off`: Disable 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 value 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	Whether to enable origin-pull to follow the origin configuration. Values: `on`: Enable `off`: Disable
RedirectConfig	RedirectConfig	No	Specifies a host header for 302 redirects. This feature is only available to beta users. To join the beta, please submit a ticket. Note: This field may return null, indicating that no valid values can be obtained.

ForceRedirect

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

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Switch	String	Yes	Whether to enable forced HTTPS redirects. Values: `on`: Enable `off`: Disable 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 value 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 value can be obtained.
CarryHeaders	String	No	Whether to return the newly added header during force redirection Note: This field may return `null`, indicating that no valid value can be obtained.

GuetzliAdapter

Image optimization - GuetzliAdapter configuration

Used by actions: DescribeDomainsConfig.

Name	Type	Required	Description
Switch	String	No	Whether to enable AvifAdapter for image optimization. Values: `on`: Enable `off`: Disable Note: This field may return·`null`, indicating that no valid values can be obtained.

HTTPHeader

HTTP request header

Used by actions: PushUrlsCache.

Name	Type	Required	Description
Name	String	Yes	Request header name
Value	String	Yes	Request header value

HeaderKey

A part of CacheKey

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Switch	String	No	Whether to enable Cachekey control. Values: `on`: Enable `off`: Disable 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 value can be obtained.

HeuristicCache

Heuristic cache configuration

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Switch	String	Yes	Whether to enable heuristic caching. Values: `on`: Enable `off`: Disable Note: This field may return·`null`, indicating that no valid values can be obtained.
CacheConfig	CacheConfig	No	Heuristic cache validity configuration 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 HSTS. Values: `on`: Enable `off`: Disable
MaxAge	Integer	No	`MaxAge` value. Note: This field may return `null`, indicating that no valid value 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 value 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 value 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 value can be obtained.
RuleType	String	Yes	Rule types: `all`: Apply to all files. `file`: Apply to files with the specified suffixes. `directory`: Apply to specified paths. `path`: Apply to specified absolute paths. Note: This field may return `null`, indicating that no valid value can be obtained.
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`. Note: This field may return `null`, indicating that no valid value 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	Whether to enable HTTPS. Values: `on`: Enable `off`: Disable Note: This field may return `null`, indicating that no valid values can be obtained.
Http2	String	No	Whether to enable HTTP2 `on`: Enable `off`: Disable Note: this field may return `null`, indicating that no valid values can be obtained.
OcspStapling	String	No	OCSP configuration switch `on`: Enable `off`: Disable It is disabled by default. Note: This field may return `null`, indicating that no valid value can be obtained.
VerifyClient	String	No	Client certificate authentication feature `on`: Enable `off`: Disable 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 value can be obtained.
CertInfo	ServerCert	No	Server certificate configuration information Note: This field may return `null`, indicating that no valid value can be obtained.
ClientCertInfo	ClientCert	No	Client certificate configuration information Note: This field may return `null`, indicating that no valid value can be obtained.
Spdy	String	No	Spdy configuration switch `on`: Enable `off`: Disable It is disabled by default. Note: This field may return `null`, indicating that no valid value 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 value can be obtained.
Hsts	Hsts	No	HSTS configuration Note: This field may return `null`, indicating that no valid value can be obtained.
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 value can be obtained.

HttpsBilling

HTTPS. When it’s disabled, HTTPS requests are blocked.

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Switch	String	Yes	Whether to enable HTTPS. Values: `on`: When it's enabled, HTTPS requests are allowed and incur charges. If not specified, his field uses the default value `on`. `off`: When it's disabled, HTTPS requests are blocked.

HwPrivateAccess

Origin-pull authentication for Huawei Cloud OBS origin

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Switch	String	Yes	Whether to enable origin-pull authentication for Huawei Cloud OBS origin. Values: `on`: Enable `off`: Disable
AccessKey	String	No	Access ID Note: This field may return `null`, indicating that no valid value can be obtained.
SecretKey	String	No	Key Note: This field may return `null`, indicating that no valid value can be obtained.
Bucket	String	No	BucketName Note: This field may return `null`, indicating that no valid value can be obtained.

ImageOptimization

Image optimization configuration

Used by actions: DescribeDomainsConfig.

Name	Type	Description
WebpAdapter	WebpAdapter	`WebpAdapter` configuration Note: This field may return `null`, indicating that no valid value can be obtained.
TpgAdapter	TpgAdapter	`TpgAdapter` configuration Note: This field may return `null`, indicating that no valid value can be obtained.
GuetzliAdapter	GuetzliAdapter	`GuetzliAdapter` configuration Note: This field may return `null`, indicating that no valid value can be obtained.
AvifAdapter	AvifAdapter	AVIF adapter configuration Note: This field may return `null`, indicating that no valid value 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	Whether to enable IP blocklist/allowlist. Values: `on`: Enable `off`: Disable
FilterType	String	No	IP blocklist/allowlist type `whitelist`: IP allowlist `blacklist`: IP blocklist Note: This field may return `null`, indicating that no valid value can be obtained.
Filters	Array of String	No	IP blocklist/allowlist Supports IPs in X.X.X.X format, or IP ranges in /8, /16, /24 format. Up to 50 whitelists or blacklists can be entered Note: This field may return `null`, indicating that no valid value 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 can be obtained.
ReturnCode	Integer	No	(Disused) Expected HTTP code to return when the IP allowlist/blocklist verification fails. The 514 code is used instead. 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 can be 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 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 value 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 value can be 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	Whether to enable IP rate limit. Values: `on`: Enable `off`: Disable
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 value can be obtained.

IpStatus

Node IP information

Used by actions: DescribeIpStatus.

Name	Type	Description
Ip	String	Node IP
District	String	Region of the node
Isp	String	ISP of the node
City	String	City of the node
Status	String	Status of the node `online`: The node is active and scheduling normally. `offline`: The node is inactive.

Ipv6

IPv6 origin configuration (changes not allowed).

Used by actions: AddCdnDomain, DescribeDomainsConfig.

Name	Type	Required	Description
Switch	String	Yes	Whether to enable an IPv6 address for the origin server. Values: `on`: Enable `off`: Disable 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 IPv6 access. Values: `on`: Enable `off`: Disable 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 a suffix, e.g., `jpg` or `txt`. For `directory`, enter the path, such as /xxx/test/. For `path`, enter an absolute path, e.g., `/xxx/test.html`. For `index`, enter a backslash (/). Note: this field may return `null`, indicating that no valid value can be obtained.
RuleType	String	Yes	Rule types: `file`: Apply to files with the specified suffixes. `directory`: Apply to specified paths. `path`: Apply to specified absolute paths. `index`: home page Note: This field may return `null`, indicating that no valid value can be obtained.
FullUrlCache	String	Yes	Whether to enable full-path cache `on`: Enable full-path cache (i.e., disable Ignore Query String). `off`: Disable full-path cache (i.e., enable 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 can be obtained.
QueryString	RuleQueryString	Yes	Request parameter contained in `CacheKey` Note: This field may return `null`, indicating that no valid value can be obtained.
RuleTag	String	Yes	Path cache key tag, the value "user" is passed. Note: This field may return `null`, indicating that no valid value can be 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 time
Region	String	Region
Deleted	String	Whether the logset has been removed from CLS Note: This field may return `null`, indicating that no valid value can be obtained.
RegionEn	String	Whether English is used in this region Note: This field may return `null`, indicating that no valid value can be obtained.

MainlandConfig

Specific configuration for domain names in the Chinese mainland. Specific configuration by region. The 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 rule configuration. Note: This field may return `null`, indicating that no valid value can be obtained.
CacheKey	CacheKey	No	Cache configurations. Note: This field may return `null`, indicating that no valid value can be obtained.
Compression	Compression	No	Smart compression configuration. Note: This field may return `null`, indicating that no valid value can be obtained.
DownstreamCapping	DownstreamCapping	No	Download speed limit configuration. Note: This field may return `null`, indicating that no valid value can be obtained.
ErrorPage	ErrorPage	No	Error code redirect configuration. Note: This field may return `null`, indicating that no valid value 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 value can be obtained.
ForceRedirect	ForceRedirect	No	Force redirect by access protocol. Note: This field may return `null`, indicating that no valid value can be obtained.
Https	Https	No	HTTPS configuration. Note: This field may return `null`, indicating that no valid value can be obtained.
IpFilter	IpFilter	No	IP blocklist/allowlist configuration. Note: This field may return `null`, indicating that no valid value can be obtained.
IpFreqLimit	IpFreqLimit	No	IP access limiting configuration. Note: This field may return `null`, indicating that no valid value can be obtained.
MaxAge	MaxAge	No	Browser cache rules configuration. Note: This field may return `null`, indicating that no valid value can be obtained.
Origin	Origin	No	Origin server configuration. Note: This field may return `null`, indicating that no valid value can be obtained.
OriginPullOptimization	OriginPullOptimization	No	Cross-border optimization configuration. Note: This field may return `null`, indicating that no valid value can be obtained.
RangeOriginPull	RangeOriginPull	No	Range GETs configuration. Note: This field may return `null`, indicating that no valid value can be obtained.
Referer	Referer	No	Hotlink protection configuration. Note: This field may return `null`, indicating that no valid value can be obtained.
RequestHeader	RequestHeader	No	Origin-pull request header configuration. Note: This field may return `null`, indicating that no valid value can be obtained.
ResponseHeader	ResponseHeader	No	Origin server response header configuration. Note: This field may return `null`, indicating that no valid value can be obtained.
ResponseHeaderCache	ResponseHeaderCache	No	Follows origin server cache header configuration. Note: This field may return `null`, indicating that no valid value can be obtained.
Seo	Seo	No	SEO configuration. Note: This field may return `null`, indicating that no valid value can be obtained.
ServiceType	String	No	Domain name service type. Values: `web` (static acceleration); `download` (download acceleration); `media` (streaming media acceleration). Note: This field may return `null`, indicating that no valid value can be obtained.
StatusCodeCache	StatusCodeCache	No	Status code cache configuration. Note: This field may return `null`, indicating that no valid value can be obtained.
VideoSeek	VideoSeek	No	Video dragging configuration. Note: This field may return `null`, indicating that no valid value can be obtained.
AwsPrivateAccess	AwsPrivateAccess	No	Access authentication for S3 origin Note: This field may return `null`, indicating that no valid value can be obtained.
OssPrivateAccess	OssPrivateAccess	No	Access authentication for OSS origin Note: This field may return `null`, indicating that no valid value can be obtained.
HwPrivateAccess	HwPrivateAccess	No	Access authentication for Huawei Cloud OBS origin Note: This field may return `null`, indicating that no valid value can be obtained.
QnPrivateAccess	QnPrivateAccess	No	Access authentication for QiNiu Cloud Kodo origin Note: This field may return `null`, indicating that no valid value 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	Whether to enable browser caching. Values: `on`: Enable `off`: Disable 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 value can be obtained.
MaxAgeCodeRule	MaxAgeCodeRule	No	MaxAge status code Note: This field may return `null`, indicating that no valid value can be obtained.

MaxAgeCodeRule

MaxAge status code

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Action	String	Yes	Action to execute. `clear`: Clear the cache-control header.
StatusCodes	Array of String	Yes	Specifies the HTTP status code in the range 400-599.

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 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: 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 value can be obtained.

OfflineCache

Offline cache feature status switch.

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Switch	String	Yes	Whether to enable offline caching. Values: `on`: Enable `off`: Disable

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. 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	List of primary origin servers When modifying the origins, you need to specify `OriginType`. Note: This field may return `null`, indicating that no valid values can be obtained.
OriginType	String	No	Primary origin server type This field is used together with `Origins`. Input: `domain`: Domain name `domainv6`: IPv6 domain name `cos`: COS bucket address `third_party`: Third-party object storage origin `igtm`: IGTM origin `ip`: IP address `ipv6`: One 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 specify `OriginType`. The IPv6 feature is now only available to beta users. Submit a ticket if you need it. Note: This field may return `null`, indicating that no valid values can be obtained.
ServerName	String	No	Origin-pull host header. This field is required when `OriginType=cos/third-party`. If not specified, this field defaults to the acceleration domain name. For a wildcard domain name, the sub-domain name during the access is 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. Values: `on` and `off`. Note: This field may return `null`, indicating that no valid value 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 value can be obtained.
BackupOrigins	Array of String	No	List of secondary origin servers This field is used together with `BackupOriginType`. Note: This field may return `null`, indicating that no valid values can be obtained.
BackupOriginType	String	No	Secondary origin type This field is used together with `BackupOrigins`. Values: `domain`: Domain name `ip`: IP address The following secondary origin types are only available to beta users. Submit a ticket to use it. `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 it is left empty, the `ServerName` of primary origin server will be used by default. Note: This field may return `null`, indicating that no valid value can be obtained.
BasePath	String	No	Origin-pull path Note: This field may return `null`, indicating that no valid value can be obtained.
PathRules	Array of PathRule	No	Origin-pull path rewriting configuration Note: This field may return `null`, indicating that no valid value can be obtained.
PathBasedOrigin	Array of PathBasedOriginRule	No	Path-based origin-pull configuration Note: This field may return `null`, indicating that no valid value can be obtained.
Sni	OriginSni	No	HTTPS origin-pull SNI Note: This field may return `null`, indicating that no valid values can be obtained.
AdvanceHttps	AdvanceHttps	No	HTTPS advanced origin-pull configuration Note: This field may return `null`, indicating that no valid value can be obtained.
OriginCompany	String	No	Third-party object storage service vendor This field is required when `OriginType=third-party`. Values: `aws_s3`: AWS S3 `ali_oss`: Alibaba Cloud OSS `hw_obs`: Huawei Cloud OBS `Qiniu_kodo`: Qiniu Kodo `Others`: Other object storage service vendors. Only AWS signature-compatible object storage services are supported, such as Tencent Cloud COS for Finance Zone. Note: This field may return `null`, indicating that no valid values can be obtained.

OriginAuthentication

Origin-pull authentication advanced configuration

Used by actions: DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Switch	String	Yes	Whether to enable advanced origin-pull authentication. Values: `on`: Enable `off`: Disable 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 configuration item

Used by actions: DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Switch	String	Yes	Whether to enable origin-pull merge. Values: `on`: Enable `off`: Disable

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

(Disused) Cross-border origin-pull optimization

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Switch	String	Yes	Whether to enable cross-MLC-border origin-pull optimization. Values: `on`: Enable `off`: Disable
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 value 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 value can be obtained.
ReceiveTimeout	Integer	Yes	The origin-pull receipt timeout (in seconds). Valid range: 10-300. Note: This field may return `null`, indicating that no valid value can be obtained.

OriginSni

HTTPS origin-pull SNI

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

Name	Type	Required	Description
Switch	String	Yes	Whether to enable HTTPS origin-pull SNI. Values: `on`: Enable `off`: Disable
ServerName	String	Yes	Origin-pull domain name. 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 OSS origin-pull authentication. Values: `on`: Enable `off`: Disable
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.
Region	String	No	Region Note: This field may return `null`, indicating that no valid value can be obtained.
Bucket	String	No	BucketName Note: This field may return `null`, indicating that no valid value can be obtained.

OthersPrivateAccess

Origin-pull authentication for other origins

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Switch	String	Yes	Whether to enable origin-pull authentication for other object storage origins. Values: `on`: Enable `off`: Disable
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.
Region	String	No	Region. Note: This field may return `null`, indicating that no valid values can be obtained.
Bucket	String	No	Bucket name Note: This field may return `null`, indicating that no valid values can be obtained.

OverseaConfig

Specific configuration for domain names outside the Chinese mainland. The 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 rule configuration. Note: This field may return `null`, indicating that no valid value can be obtained.
CacheKey	CacheKey	No	Cache configuration. Note: This field may return `null`, indicating that no valid value can be obtained.
Compression	Compression	No	Smart compression configuration. Note: This field may return `null`, indicating that no valid value can be obtained.
DownstreamCapping	DownstreamCapping	No	Download speed limit configuration. Note: This field may return `null`, indicating that no valid value can be obtained.
ErrorPage	ErrorPage	No	Error code redirect configuration. Note: This field may return `null`, indicating that no valid value 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 value can be obtained.
ForceRedirect	ForceRedirect	No	Protocol redirect configuration. Note: This field may return `null`, indicating that no valid value can be obtained.
Https	Https	No	HTTPS configuration. Note: This field may return `null`, indicating that no valid value can be obtained.
IpFilter	IpFilter	No	IP blocklist/allowlist configuration. Note: This field may return `null`, indicating that no valid value can be obtained.
IpFreqLimit	IpFreqLimit	No	IP access limit configuration. Note: This field may return `null`, indicating that no valid value can be obtained.
MaxAge	MaxAge	No	Browser cache rules configuration. Note: This field may return `null`, indicating that no valid value can be obtained.
Origin	Origin	No	Origin server configuration. Note: This field may return `null`, indicating that no valid value can be obtained.
OriginPullOptimization	OriginPullOptimization	No	Cross-border optimization configuration. Note: This field may return `null`, indicating that no valid value can be obtained.
RangeOriginPull	RangeOriginPull	No	Range GETs configuration. Note: This field may return `null`, indicating that no valid value can be obtained.
Referer	Referer	No	Hotlink protection configuration. Note: This field may return `null`, indicating that no valid value can be obtained.
RequestHeader	RequestHeader	No	Origin-pull request header configuration. Note: This field may return `null`, indicating that no valid value can be obtained.
ResponseHeader	ResponseHeader	No	Origin server response header configuration. Note: This field may return `null`, indicating that no valid value can be obtained.
ResponseHeaderCache	ResponseHeaderCache	No	Follows origin server cache header configuration. Note: This field may return `null`, indicating that no valid value can be obtained.
Seo	Seo	No	SEO configuration. Note: This field may return `null`, indicating that no valid value can be obtained.
ServiceType	String	No	Domain name service type. Values: `web` (static acceleration); `download` (download acceleration); `media` (streaming media acceleration). Note: This field may return `null`, indicating that no valid value can be obtained.
StatusCodeCache	StatusCodeCache	No	Status code cache configuration. Note: This field may return `null`, indicating that no valid value can be obtained.
VideoSeek	VideoSeek	No	Video dragging configuration. Note: This field may return `null`, indicating that no valid value can be obtained.
AwsPrivateAccess	AwsPrivateAccess	No	Access authentication for S3 origin Note: This field may return `null`, indicating that no valid value can be obtained.
OssPrivateAccess	OssPrivateAccess	No	Access authentication for OSS origin Note: This field may return `null`, indicating that no valid value can be obtained.
HwPrivateAccess	HwPrivateAccess	No	Access authentication for Huawei Cloud OBS origin Note: This field may return `null`, indicating that no valid value can be obtained.
QnPrivateAccess	QnPrivateAccess	No	Access authentication for QiNiu Cloud Kodo origin Note: This field may return `null`, indicating that no valid value can be obtained.

PathBasedOriginRule

Path-based origin-pull rule

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

Name	Type	Required	Description
RuleType	String	Yes	Rule types: `file`: Apply to files with the specified suffixes. `directory`: Apply to specified paths. `path`: Apply to specified absolute paths. `index`: Apply to 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 name 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`: disabled `true`: enabled Note: this field may return `null`, indicating that no valid value 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	Region of the origin server. Valid values: `CN` and `OV`. `CN`: Within 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 value 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 can be 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, UpdateDomainConfig.

Name	Type	Required	Description
Switch	String	Yes	Maximum size of the file uploaded for streaming via a POST request. Values: `on`: Enable. When enabled, it is set to 32 MB by default. `off`: Disable
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`: Purge 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 the Chinese mainland `overseas`: Outside the Chinese mainland `global`: Globe
UpdateTime	Timestamp	Prefetch task update time Note: This field may return `null`, indicating that no valid value can be obtained.

QnPrivateAccess

Access authentication for QiNiu Cloud Kodo origin

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Switch	String	Yes	Whether to enable origin-pull authentication for QiNiu Cloud Kodo. Values: `on`: Enable `off`: Disable
AccessKey	String	No	Access ID Note: This field may return `null`, indicating that no valid value can be obtained.
SecretKey	String	No	Key

QueryStringKey

A part of CacheKey

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Switch	String	Yes	Whether to include `QueryString` as part of `CacheKey`. Values: `on`: Enable `off`: Disable 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 value can be obtained.
Action	String	No	Whether to include URL parameters. Values: `includeAll`: Include all parameters. `excludeAll`: Exclude all parameters. `includeCustom`: Include custom parameters. `excludeCustom`: Exclude custom parameters. Note: This field may return `null`, indicating that no valid values can be obtained.
Value	String	No	Array of included/excluded query strings (separated by ';') Note: This field may return `null`, indicating that no valid value can be obtained.

Quic

QUIC configuration item

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Switch	String	Yes	Whether to enable QUIC. Values: `on`: Enable `off`: Disable

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	Whether to enable Range GETs. Values: `on`: Enable `off`: Disable
RangeRules	Array of RangeOriginPullRule	No	Range GETs configuration Note: This field may return `null`, indicating that no valid value can be obtained.

RangeOriginPullRule

Range GETs configuration

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Switch	String	Yes	Whether to enable Range GETs. Values: `on`: Enable `off`: Disable
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.

RedirectConfig

Host header for 302 redirects

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Switch	String	Yes	Whether to enable the custom origin-pull request to follow the host when a 302 code is returned. Values: `on`: Enable `off`: Disable
FollowRedirectHost	String	Yes	The custom host header that is sent when the primary origin server follows 302 redirects
FollowRedirectBackupHost	String	No	The custom host header that is sent when the secondary origin server follows 302 redirects

Referer

Referer blacklist/whitelist configuration. This is disabled by default.

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Switch	String	Yes	Whether to enable referer blocklist/allowlist. Values: `on`: Enable `off`: Disable
RefererRules	Array of RefererRule	No	Referer blacklist/whitelist configuration rule Note: This field may return `null`, indicating that no valid value can be obtained.

RefererRule

Referer blacklist/whitelist configuration rules, which is effective for specific resources.

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
RuleType	String	Yes	Rule types: `all`: Apply to all files. `file`: Apply to files with the specified suffixes. `directory`: Apply to specified paths. `path`: Apply to specified absolute paths.
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`.
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 when `RefererType = whitelist`. `false`: Reject empty refer when `RefererType = blacklist`.

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	Whether to enable remote authentication. Values: `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	Whether to enable custom request headers. Values: `on`: Enable `off`: Disable
HeaderRules	Array of HttpHeaderPathRule	No	Custom request header configuration rules Note: This field may return `null`, indicating that no valid value can be obtained.

ResourceBillingData

Billing data details

Used by actions: DescribeBillingData.

Name	Type	Description
Resource	String	Resource name, which is classified as follows based on different query filters: When a domain name is specified: Details of the domain name `multiDomains`: Aggregated details of multiple domain names A specific project ID: ID of the specifically queried project `all`: 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. 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`. 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 filters: A specific domain name: Details of the domain name `multiDomains`: Aggregated details of multiple domain names Project ID: ID of the specifically queried project `all`: 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	Whether to enable custom response headers. Values: `on`: Enable `off`: Disable
HeaderRules	Array of HttpHeaderPathRule	No	Custom response header rules Note: This field may return `null`, indicating that no valid value 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	Whether to enable response header caching. Values: `on`: Enable `off`: Disable

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 enable origin-pull authentication. Values: `on`: Enable `off`: Disable 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 value 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 can be 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 can be obtained.
NoCache	CacheConfigNoCache	Yes	No cache configuration Note: This field may return `null`, indicating that no valid value can be obtained.
FollowOrigin	CacheConfigFollowOrigin	Yes	Follows the origin server configuration Note: This field may return `null`, indicating that no valid value can be obtained.

RuleEngine

Rule engine configuration

Used by actions: DescribeDomainsConfig.

Name	Type	Required	Description
Switch	String	Yes	Whether to enable rule engine. Values: `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 include query string parameters. Values: `on`: Include `QueryString` as part of `CacheKey`. `off`: Do not include `QueryString` as part of `CacheKey`. Note: This field may return `null`, indicating that no valid values can be obtained.
Action	String	Yes	`includeCustom` will retain partial query strings Note: This field may return `null`, indicating that no valid value can be obtained.
Value	String	Yes	Array of included/excluded query strings (separated by ';') Note: This field may return `null`, indicating that no valid value can be obtained.

ScdnAclConfig

SCDN access control

Used by actions: UpdateScdnDomain.

Name	Type	Required	Description
Switch	String	Yes	Whether to enable SCDN access. Values: `on`: Enable `off`: Disable
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 value 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 activated. Valid values: `active` and `inactive`.
ErrorPage	ScdnErrorPage	No	Error page configuration Note: This field may return `null`, indicating that no valid value 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	Whether to enable SCDN bot configuration. Values: `on`: Enable `off`: Disable
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`: Apply to files with the specified suffixes. `directory`: Apply to specified paths. `path`: Apply to 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 enable IP blocking. Values: `on`: Enable `off`: Disable 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	Whether to enable SCDN CC configuration. Values: `on`: Enable `off`: Disable
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 value can be obtained.
GlobalAdvancedRules	Array of AdvancedCCRules	No	Global advanced CC protection rules 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 SCDN DDoS configuration. Values: `on`: Enable `off`: Disable

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	URL to be redirected

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 SCDN WAF configuration. Values: `on`: Enable `off`: Disable
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 webshell blocking. Values: `on`: Enable `off`: Disable 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 value can be obtained.
SubRuleSwitch	Array of WafSubRuleStatus	No	Whether to enable WAF sub-rules. Values: `on`: Enable `off`: Disable 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 enable scheme as part of the cache key. Values: `on`: Enable `off`: Disable 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	Whether to enable SCDN. Values: `on`: Enable `off`: Disable

Seo

SEO configuration. This is disabled by default.

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Switch	String	Yes	Whether to enable SEO. Values: `on`: Enable `off`: Disable 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

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 being managed by the SSL Certificate Service 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 value 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 value 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 value can be obtained.
ExpireTime	Timestamp	No	Time when the certificate expires Can be left blank when used as an input parameter Note: This field may return `null`, indicating that no valid value 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 value can be obtained.
Message	String	No	Certificate remarks Note: This field may return `null`, indicating that no valid value can be obtained.
From	String	No	Certificate source Note: This field may return `null`, indicating that no valid value can be obtained.

ShareCname

Shared CNAME configuration
ShareCname is only available to beta users. Submit a ticket if you need it.

Used by actions: DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Switch	String	Yes	Whether to enable Shared CNAME. Values: `on`: Enable. When enabled, it uses a shared CNAME. `off`: Disable. When disabled, it uses a default CNAME.
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 value can be obtained.
FollowOrigin	String	Yes	Follows origin server Cache-Control: max-age configurations `on`: Enable `off`: Disable 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 value 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 value can be obtained.
IgnoreSetCookie	String	Yes	Ignores the Set-Cookie header of the origin server `on`: Enable `off`: Disable It is disabled by default. Note: This field may return `null`, indicating that no valid value 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`: Enable `off`: Disable It is disabled by default. Note: This field may return `null`, indicating that no valid value can be obtained.
Revalidate	Revalidate	No	Always forwards to the origin server for verification Note: This field may return `null`, indicating that no valid value can be obtained.

SimpleCacheRule

Cache expiration rules configuration

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
CacheType	String	Yes	Rule types: `all`: Apply to all files. `file`: Apply to files with the specified suffixes. `directory`: Apply to specified paths. `path`: Apply to specified absolute paths. index: home page
CacheContents	Array of String	Yes	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 `index`, enter a forward slash `/`.
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/desc. Default value: 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 value can be obtained.
Overseas	OverseaConfig	No	Specific configuration for domain name outside mainland China. Note: This field may return `null`, indicating that no valid value can be obtained.

StatisticItem

Usage limit configuration

Used by actions: AddCdnDomain, DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Type	String	No	Type of usage limit. `total`: Cumulative usage; `moment`: Instantaneous usage. Note: This field may return `null`, indicating that no valid value can be obtained.
UnBlockTime	Integer	No	Unblocking time Note: This field may return `null`, indicating that no valid value can be obtained.
BpsThreshold	Integer	No	Bandwidth/Traffic threshold Note: This field may return `null`, indicating that no valid value can be obtained.
CounterMeasure	String	No	Specifies how to disable CDN service when the threshold is exceeded. `RETURN_404`: Return 404; `RESOLVE_DNS_TO_ORIGIN`: Forward to origin server. Note: This field may return `null`, indicating that no valid value can be obtained.
AlertPercentage	Integer	No	Threshold (in percentage) that triggers alarms Note: This field may return `null`, indicating that no valid value can be obtained.
AlertSwitch	String	No	Whether to enable alerts for cumulative usage limit. Values: `on`: Enable `off`: Disable Note: This field may return `null`, indicating that no valid values can be obtained.
Metric	String	No	Metric type. `flux`: Traffic; `bandwidth`: Bandwidth. Note: This field may return `null`, indicating that no valid value can be obtained.
Cycle	Integer	No
Switch	String	No	Whether to enable cumulative usage limit. Values: `on`: Enable `off`: Disable 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	Whether to enable status code caching. Values: `on`: Enable `off`: Disable 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 value 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

Aggregated value, which is aggregated from all data of each metric. Aggregation methods are used depending on the metric attributes.

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 data aggregated in 5 minutes. `avg`: Average value
Value	Float	Aggregated 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 can be obtained.
TagValue	String	Yes	Tag value Note: This field may return `null`, indicating that no valid value can be obtained.

TimestampData

Timestamp and its corresponding value

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

Name	Type	Description
Time	Timestamp	The start point of the sampling period. For example, if the time is set to 13:35:00, and `interval` is `5min`, the data returned is collected 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 value can be obtained.
Channel	String	Either `cdn` or `ecdn`. Note: This field may return `null`, indicating that no valid value can be obtained.
Deleted	String	Whether the logset has been removed from CLS Note: This field may return `null`, indicating that no valid value can be obtained.

TpgAdapter

Image optimization - TpgAdapter configuration

Used by actions: DescribeDomainsConfig.

Name	Type	Required	Description
Switch	String	No	Whether to enable TpgAdapter for image optimization. Values: `on`: Enable `off`: Disable 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 value can be obtained.
RealUrl	String	Corresponding URL Note: This field may return `null`, indicating that no valid value can be obtained.
CreateTime	String	Creation time Note: This field may return `null`, indicating that no valid value can be obtained.
UpdateTime	String	Update time. Note: This field may return `null`, indicating that no valid value can be obtained.

UrlRedirect

Configuration of URL rewriting

Used by actions: DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Switch	String	Yes	Whether to enable URL rewriting. Values: `on`: Enable `off`: Disable
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 value 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 value can be obtained.

UserAgentFilter

UserAgent blacklist/whitelist configuration

Used by actions: DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Switch	String	Yes	Whether to enable User-Agent blocklist/allowlist. Values: `on`: Enable `off`: Disable Note: This field may return `null`, indicating that no valid values can be obtained.
FilterRules	Array of UserAgentFilterRule	No	UA blacklist/whitelist effect rule list Note: This field may return `null`, indicating that no valid value can be obtained.

UserAgentFilterRule

UserAgent blacklist/whitelist 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 value can be obtained.
RulePaths	Array of String	Yes	Effective access paths Note: This field may return `null`, indicating that no valid value can be obtained.
UserAgents	Array of String	Yes	`UserAgent` list Note: This field may return `null`, indicating that no valid value can be obtained.
FilterType	String	Yes	Blocklist or allowlist. Valid values: `blacklist`, `whitelist` Note: This field may return `null`, indicating that no valid value 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	Whether to enable video dragging. Values: `on`: Enable `off`: Disable

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 non-compliant resource `forbid`: Blocked `release`: Unblocked `delay`: Processing delayed `reject`: Appeal dismissed. It is still in `forbid` status. `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	Whether to enable WAF sub-rules. Values: `on`: Enable `off`: Disable
SubIds	Array of Integer	Yes	List of rule IDs

WebSocket

WebSocket configuration.
WebSocket is an ECDN feature. You can enable it in the ECDN domain name configuration.

Used by actions: DescribeDomainsConfig, UpdateDomainConfig.

Name	Type	Required	Description
Switch	String	Yes	Whether to enable WebSocket connection timeout. Values: `on`: When it's enabled, the connection timeout can be configured. `off`: When it's disabled, the connection timeout is set to 15 seconds by default.
Timeout	Integer	No	Sets timeout period in seconds. Maximum value: 300 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	Whether to enable WebpAdapter for image optimization. Values: `on`: Enable `off`: Disable Note: This field may return·`null`, indicating that no valid values can be obtained.

tencent cloud

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

AvifAdapter

AwsPrivateAccess

BandwidthAlert

BotCookie

BotJavaScript

BriefDomain

Cache

CacheConfig

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

HTTPHeader

HeaderKey

HeuristicCache

Hsts

HttpHeaderPathRule

HttpHeaderRule

Https

HttpsBilling

HwPrivateAccess

ImageOptimization

IpFilter

IpFilterPathRule

IpFreqLimit

IpStatus

Ipv6

Ipv6Access

KeyRule

LogSetInfo