You can call the DescribeCdnDomainConfigs operation to query one or more configurations of a CDN domain.


Alibaba Cloud provides OpenAPI Explorer to simplify API usage. You can use OpenAPI Explorer to search for APIs, call APIs, and dynamically generate SDK example code.

Request parameters

Parameter Type Required Description
Action String  Yes The operation that you want to perform. Set this parameter to DescribeCdnDomainConfigs.
DomainName String Yes The name of the CDN domain of which the configurations are queried.
FunctionNames String No The list of features. Separate multiple feature names with commas (,).


Feature Description
referer_white_list_set Configures the referer whitelist.
referer_black_list_set Configures the referer blacklist.
filetype_based_ttl_set Sets the expiration rules for files.
path_based_ttl_set Sets the expiration rules for directories.
cc_defense Configures protection against HTTP flood attacks.
oss_auth Controls the access to an OSS bucket.
ip_black_list_set Configures the IP blacklist.
ip_white_list_set Configures the IP whitelist.
error_page Redirects an error page to a specified page.
tesla Configures HTML optimization for access acceleration.
set_req_header Modifies the custom origin header.
set_req_host_header Modifies the origin host.
set_hashkey_args Filters URL parameters.
aliauth Configures Alibaba authentication.
set_resp_header Sets the response header. To verify the setting, you can check the response messages on the client (browser).
video_seek Configures the video seeking feature.
range Configures the object chunking feature.
gzip Configures intelligent compression with GNU zip (gzip).
https_force Forces redirection of HTTP requests to HTTPS.
http_force Forces redirection of HTTPS requests to HTTP.
alilive Configures the ApsaraVideo Live service.
forward_scheme Configures the origin protocol policy.
tmd_signature Sets the Taobao Missile defense (TMD) rules.

Response parameters

Parameter Type Description
RequestId String The ID of the request.
DomainConfigs DomainConfig[] The domain configurations returned.

Parameters in DomainConfig

Parameter Type Description
FunctionName String  The name of the feature.
Status  String The status of the feature: success, testing, failed, or configuring.
ConfigId String The ID of the configuration.
FunctionArgs FunctionArg[] The parameters of each feature.

Parameters in FunctionArg

Parameter Type Description
ArgName String  The name of the parameter.
ArgValue String  The value of the parameter.


Sample request
&<Common request parameters>   

Sample success response

JSON format

    "RequestId": "C80705BF-0F76-41FA-BAD1-5B59296A4E59",
    "DomainConfigs": {
        "DomainConfig": [
                "Status": "success",
                "FunctionArgs": {
                    "FunctionArg": [
                            "ArgName": "auth_type",
                            "ArgValue": "req_auth"
                            "ArgName": "ali_auth_dual",
                            "ArgValue": "on"
                "ConfigId": 6295,
                "FunctionName": "aliauth"

Error codes

Error code Error message HTTP status code Description
InvalidFunctionName.ValueNotSupported FunctionName %s is not supported. 400 The error message returned because the specified feature name (%s) is invalid. The variable %s represents the feature name.