Help Center/ Content Delivery Network/ API Reference/ API/ Domain Name Operations/ Querying Special Configurations of a Domain Name
Updated on 2025-11-27 GMT+08:00

Querying Special Configurations of a Domain Name

Function

This API is used to query special configurations of a domain name. Currently, memo information can be queried.

  • A single tenant can call this API 15 times per second.

Calling Method

For details, see Calling APIs.

URI

GET /v1.0/cdn/configuration/special-configurations

Table 1 Query Parameters

Parameter

Mandatory

Type

Description

domain_name

Yes

String

Definition

Domain name.

Constraints

You can query only domain names that have been added to CDN.

Range

N/A

Default Value

N/A

page_size

No

Integer

Definition

Number of domain names on each page.

Constraints

N/A

Range

1 to 10,000

Default Value

30

page_number

No

Integer

Definition

Page number to be queried.

Constraints

N/A

Range

1 to 65,535

Default Value

1

Request Parameters

Table 2 Request header parameters

Parameter

Mandatory

Type

Description

X-Auth-Token

Yes

String

Definition

User token, which can be obtained by calling the IAM API (value of X-Subject-Token in the response header).

Constraints

N/A

Range

N/A

Default Value

N/A

Response Parameters

Status code: 200

Table 3 Response body parameters

Parameter

Type

Description

total

Integer

Total number of records.

specialConfigurations

Array of SpeicialConfiguration objects

Special configuration information of the domain name.

Table 4 SpeicialConfiguration

Parameter

Type

Description

create_time

Long

Creation time.

note

String

Memo.

Status code: 400

Table 5 Response body parameters

Parameter

Type

Description

error

ErrMsg object

Error code and error message.

Table 6 ErrMsg

Parameter

Type

Description

error_code

String

Error code.

error_msg

String

Error message.

Example Requests

GET https://cdn.myhuaweicloud.com/v1.0/cdn/configuration/special-configurations?domain_name==www.example.com

Example Responses

Status code: 200

Successful response.

{
  "total" : 1,
  "specialConfigurations" : [ {
    "create_time" : 1735660800000,
    "note" : "Memo."
  } ]
}

Status Codes

Status Code

Description

200

Successful response.

400

Error response.

Error Codes

See Error Codes.