You can call this operation to query one or more configurations of an accelerated domain.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes DescribeDcdnDomainConfigs

The operation that you want to perform. Set the value to DescribeDcdnDomainConfigs.

DomainName String Yes example.com

The name of the accelerated domain. You can specify only one domain name.

FunctionNames String Yes filetype_based_ttl_set,set_req_host_header

The names of the features to query. You can separate multiple features with commas (,).

Features

Feature

Description

referer_white_list_set

Configures a referer whitelist.

referer_black_list_set

Specifies a referer blacklist.

filetype_based_ttl_set

Sets an expiration rule for files.

path_based_ttl_set

Specifies an expiration rule for directories.

cc_defense

Configures HTTP flood protection.

oss_auth

Configures the authentication of the access to an Object Storage Service (OSS) bucket.

ip_black_list_set

Specifies an IP blacklist.

ip_white_list_set

Configures an IP whitelist.

error_page

Configures the error page redirection to another specific page.

tesla

Configures the page optimization for access acceleration.

set_req_host_header

Modifies the origin host.

set_req_header

Customizes the HTTP header for origin requests.

set_hashkey_args

Configures the parameter filtering.

aliauth

Configures Alibaba Authentication.

set_resp_header

Sets a response header. To verify the setting, you can check the response messages on the client through the browser.

video_seek

Configures the video seeking feature.

range

Configures the object chunking feature.

gzip

Configures the intelligent compression with GNU zip (gzip).

https_force

Configures the forcible redirect of HTTP requests to HTTPS.

http_force

Configures the forcible redirect of HTTPS requests to HTTP.

alilive

Configures the ApsaraVideo Live service.

Response parameters

Parameter Type Example Description
DomainConfigs Array

The domain configurations returned.

DomainConfig

The domain configuration returned.

ConfigId String 5068995

The ID of the configuration.

FunctionArgs Array

The feature configurations returned.

FunctionArg

The feature configuration returned.

ArgName String ttl

The name of the parameter.

ArgValue String 13

The value of the parameter.

FunctionName String set_req_host_header

The name of the feature.

Status String success

The status of the feature. Valid values:

  • success: The configuration is successful.
  • testing: The configuration is under testing.
  • failed: The configuration has failed.
  • configuring: The feature is being configured.
RequestId String F8AA0364-0FDB-4AD5-AC74-D69FAB8924ED

The ID of the request.

Examples

Sample requests

http://dcdn.aliyuncs.com/?Action=DescribeDcdnDomainConfigs
&DomainName=example.com
&FunctionNames=filetype_based_ttl_set,set_req_host_header
&<Common request parameters>

Sample success responses

XML format

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

JSON format

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

Error codes

HTTP status code Error code Error message Description
400 Invalid%s.ValueNotSupported FunctionName [%s] is not supported. The error message returned because the specified feature is not supported.

For a list of error codes, visit the API Error Center.