Retrieving List of Paid Alibaba Cloud DNS Product Versions

Last Updated: May 27, 2016

Description

Retrieves a list of paid Alibaba Cloud DNS product versions based on input parameters. The query results can be filtered by versions. If the return parameters do not contain domain names, this indicates that this Alibaba Cloud DNS product has not been bound to any domain names.

Request Parameters

Name Type Required? Description
Action String Yes Operation interface name, required parameter. Value: DescribeDnsProductInstances
PageNumber Long No Number of the current page, starting from 1 by default
PageSize Long No This sets the number of lines per page for query by pages, up to 100 and 20 by default
VersionCode String No The Alibaba Cloud DNS product version, "All" by default

Return Parameters

Public return parameters. For details, see Public Return Parameters

Name Type Description
RequestId String The unique request identifier
TotalCount Long Total number of domain name lists
PageNumber Long Number of the current page
PageSize Long The number of domain names retrieved by this query
DnsProducts DnsProductType The list of Alibaba Cloud DNS products returned by this query

Error Codes

For errors common to all interfaces, please refer to the Error Code Table .

Error Code Description HTTP Status Code Meaning
InvalidVersion The version of DNS product is not exist. 400 This Alibaba Cloud DNS version does not exist
FreeVersion The version of DNS product free version. 400 Paid Alibaba Cloud DNS products do not include free versions

Example

Request Example

http://dns.aliyuncs.com/?Action=DescribeDnsProductInstances
&PageNumber=1
&PageSize=20
&VersionCode=version1
&<Public Request Parameters>

Return Example

XML Format

<DescribeDnsProductInstancesResponse>
    <RequestId>536E9CAD-DB30-4647-AC87-AA5CC38C5382</RequestId>
    <TotalCount>2</TotalCount>
    <PageNumber>1</PageNumber>
    <PageSize>2</PageSize>
    <DnsProducts>
        <DnsProduct>
            <InstanceId>i-8fj</InstanceId>
            <VersionCode>version1</VersionCode>
            <VersionName>Alibaba Cloud DNS Standard Version</VersionName>
            <StartTime>2015-11-11 09:22:32</StartTime>
            <EndTime>2016-11-10 09:22:32</EndTime>
            <Domain>abc.com</Domain>
        </DnsProduct>
        <DnsProduct>
            <InstanceId>i-7sb</InstanceId>
            <VersionCode>version1</VersionCode>
            <VersionName>Alibaba Cloud DNS Standard Version</VersionName>
            <StartTime>2015-11-11 09:22:32</StartTime>
            <EndTime>2016-11-10 09:22:32</EndTime>
            <Domain>example.com</Domain>
        </DnsProduct>
    </DnsProducts>
</DescribeDnsProductInstancesResponse>

JSON Example

{
    "RequestId": "536E9CAD-DB30-4647-AC87-AA5CC38C5382",
    "TotalCount": "2",
    "PageNumber": "1",
    "PageSize": "2",
    "DnsProducts": {
      "DnsProduct": [
        {
          "InstanceId": "i-8fj",
          "VersionCode": "version1",
          "VersionName": "Alibaba Cloud DNS Standard Version",
          "StartTime": "2015-11-11 09:22:32",
          "EndTime": "2016-11-10 09:22:32",
          "Domain": "abc.com"
        },
        {
          "InstanceId": "i-7sb",
          "VersionCode": "version1",
          "VersionName": "Alibaba Cloud DNS Standard Version",
          "StartTime": "2015-11-11 09:22:32",
          "EndTime": "2016-11-10 09:22:32",
          "Domain": "example.com"
        }
      ]
    }
}
Thank you! We've received your feedback.