Queries domain names based on origin servers.

Note The maximum number of times that each user can call this operation per second is 30.

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 software development kits (SDKs).

Request parameters

Parameter Type Required Example Description
Action String Yes DescribeDomainsBySource

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

Sources String Yes aaa.source.com

The origin servers. Separate origin servers with commas (,). Fuzzy match is not supported.

Response parameters

Parameter Type Example Description
RequestId String B0F074E5-A1AC-4B32-8EA2-6F450410D1E0

The ID of the request.

Sources String aaa.xxx.com,b.xxx.com

The origin servers.

DomainsList Array of DomainsData

The domain names corresponding to each origin server. The data is indicated by the DomainsData parameter. Data type: array.

DomainsData
Source String b.xxx.com

A requested origin server.

Domains List b1.com

The domain names corresponding to each origin server. The domain name is indicated by the domainNames parameter. Data type: array.

DomainInfos Array of domainInfo

The detailed information about the domain name. The data is indicated by the domainInfo parameter. Data type: array.

domainInfo
DomainName String xxx.com

The domain name.

Status String online

The status of the domain name.

CreateTime String 2016-07-12T11:53:19+08:00

The time when the domain name was added to Alibaba Cloud CDN.

UpdateTime String 2017-03-31T04:49:00+08:00

The last time when the information about the domain name was updated.

DomainCname String xxx.w.alikunlun.com

The CNAME assigned to the domain name.

Examples

Sample requests

http(s)://cdn.aliyuncs.com/?Action=DescribeDomainsBySource
&Sources=aaa.source.com  
&<Common request parameters>

Sample success responses

XML format

<DescribeDomainsBySourceResponse>
  <DomainsList>
        <DomainsData>
              <Source>aaa.example.com</Source>
              <Domains>
                    <domainNames>a1.com</domainNames>
              </Domains>
              <DomainInfos>
                    <domainInfo>
                          <DomainCname>xxx.kunlunar.com</DomainCname>
                          <Status>online</Status>
                          <CreateTime>2016-07-12T11:53:19+08:00</CreateTime>
                          <UpdateTime>2017-03-31T04:49:00+08:00</UpdateTime>
                          <DomainName>a1.com</DomainName>
                    </domainInfo>
              </DomainInfos>
        </DomainsData>
        <DomainsData>
              <Source>b.example.com</Source>
              <Domains>
                    <domainNames>b1.com</domainNames>
              </Domains>
              <DomainInfos>
                    <domainInfo>
                          <DomainCname>xxx.alikunlun.com</DomainCname>
                          <Status>online</Status>
                          <CreateTime>2017-01-13T18:01:00+08:00</CreateTime>
                          <UpdateTime>2017-01-17T21:16:16+08:00</UpdateTime>
                          <DomainName>example.com</DomainName>
                    </domainInfo>
              </DomainInfos>
        </DomainsData>
  </DomainsList>
  <RequestId>B0F074E5-A1AC-4B32-8EA2-6F450410D1E0</RequestId>
  <Sources>aaa.example.com,b.example.com</Sources>
</DescribeDomainsBySourceResponse>

JSON format

{
    "DomainsList": {
        "DomainsData": [
            {
                "Source": "aaa.example.com",
                "Domains": {
                    "domainNames": [
                        "a1.com" ] 
                },
                "DomainInfos": {
                    "domainInfo": [
                        {
                            "DomainCname": "xxx.kunlunar.com",
                            "Status": "online",
                            "CreateTime": "2016-07-12T11:53:19+08:00",
                            "UpdateTime": "2017-03-31T04:49:00+08:00",
                            "DomainName": "a1.com" 
                        } ] 
                } 
            },
            {
                "Source": "b.example.com",
                "Domains": {
                    "domainNames": [
                        "b1.com" ] 
                },
                "DomainInfos": {
                    "domainInfo": [
                        {
                            "DomainCname": "xxx.alikunlun.com",
                            "Status": "online",
                            "CreateTime": "2017-01-13T18:01:00+08:00",
                            "UpdateTime": "2017-01-17T21:16:16+08:00",
                            "DomainName": "example.com" 
                        } ] 
                } 
            } ] 
    },
    "RequestId": "B0F074E5-A1AC-4B32-8EA2-6F450410D1E0",
    "Sources": "aaa.example.com,b.example.com" 
}

Error codes

HttpCode Error code Error message Description
400 MissingParameter The parameter Sources miss. The error message returned because the Sources parameter is not set.
400 InvalidSources.Malformed Specified Sources is malformed. The error message returned because the origin address is specified in an invalid format.

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