Queries the subdomains for which weighted round-robin is enabled.

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 DescribeDNSSLBSubDomains

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

DomainName String Yes example.com

The domain name whose subdomains you want to query.

Lang String No en

The language of the domain name.

UserClientIp String No 192.0.2.0

The IP address of the client that you use to query subdomains.

PageNumber Long No 1

The number of the page to return. Pages start from page 1. Default value: 1.

PageSize Long No 20

The number of entries to return on each page. Maximum value: 100. Default value: 20.

Response parameters

Parameter Type Example Description
RequestId String 536E9CAD-DB30-4647-AC87-AA5CC38C5382

The ID of the request.

TotalCount Long 1

The number of domain name groups.

PageNumber Long 1

The page number of the returned page.

PageSize Long 1

The total number of subdomains returned.

SlbSubDomains Array

The details of the subdomains.

SubDomain String www.example.com

The subdomain.

RecordCount Long 3

The number of DNS records added for the subdomain.

Open Boolean true

Indicates whether weighted round-robin is enabled for the subdomain.

Type String A

The type of the DNS record that supports weighted round-robin. Valid values: A, AAAA, and CNAME.

Examples

Sample requests

http(s)://alidns.aliyuncs.com/?Action=DescribeDNSSLBSubDomains
&DomainName=example.com
&<Common request parameters>

Sample successful responses

XML format

<DescribeDNSSLBSubDomainsResponse>
      <RequestId>536E9CAD-DB30-4647-AC87-AA5CC38C5382</RequestId>
      <TotalCount>1</TotalCount>
      <PageNumber>1</PageNumber>
      <PageSize>1</PageSize>
      <SlbSubDomains>
            <SlbSubDomain>
                  <SubDomain>www.example.com</SubDomain>
                  <RecordCount>3</RecordCount>
                  <Open>true</Open>
            </SlbSubDomain>
      </SlbSubDomains>
</DescribeDNSSLBSubDomainsResponse>

JSON format

{
    "RequestId": "536E9CAD-DB30-4647-AC87-AA5CC38C5382",
    "TotalCount": 1,
    "PageNumber": 1,
    "PageSize": 1,
    "SlbSubDomains": {
        "SlbSubDomain": [
            {
                "SubDomain": "www.example.com",
                "RecordCount": 3,
                "Open": true
            }
        ]
    }
}

Error codes

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