All Products
Search
Document Center

CDN:DescribeDomainCname

Last Updated:Mar 28, 2024

Detects the CNAME for an accelerated domain name. You can check the resolution result to determine whether the CNAME is configured.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
DomainNamestringYes

The accelerated domain name that you want to query. Separate multiple domain names with commas (,). This parameter cannot be left empty.

pay.slci6c.mbolsos.com,mch.b7r2v7.mbolsos.com,p.h99e.mbolsos.com,p.xmko.mbolsos.com,p.f2kd.mbolsos.com

Response parameters

ParameterTypeDescriptionExample
object

The detection results.

RequestIdstring

The ID of the request.

06D29681-B7CD-4034-A8CC-28AFFA213539
CnameDatasobject []

Details about the CNAME detection results.

Statusinteger

The CNAME detection result. Valid values:

  • 0: The DNS can detect the CNAME assigned to the domain name.
  • Value other than 0: The DNS cannot detect the CNAME assigned to the domain name.
0
Domainstring

The accelerated domain name.

a.com
Cnamestring

The CNAME assigned to the domain name by Alibaba Cloud CDN.

a.com.w.alikunlun.net

Examples

Sample success responses

JSONformat

{
  "RequestId": "06D29681-B7CD-4034-A8CC-28AFFA213539",
  "CnameDatas": {
    "Data": [
      {
        "Status": 0,
        "Domain": "a.com",
        "Cname": "a.com.w.alikunlun.net"
      }
    ]
  }
}

Error codes

HTTP status codeError codeError messageDescription
400DomainNameOverLimitA maximum of 30 domains are supported for each request.-
403InvaildParameterThe parameter you provided is invalid.The format of the domain name is invalid. Correct the format and try again.

For a list of error codes, visit the Service error codes.

Change history

Change timeSummary of changesOperation
2023-07-20The Error code has changedsee changesets
Change itemChange content
Error CodesThe Error code has changed.
    delete Error Codes: 400
    delete Error Codes: 403