调用DescribeDnsProductInstances根据传入参数获取付费版DNS产品实例列表。

说明 如果返回参数中未包含域名，则表示该云解析产品尚未绑定任何域名。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 DescribeDnsProductInstances

系统规定参数。取值：DescribeDnsProductInstances。

Lang String 否 en

语言。
UserClientIp String 否 192.0.2.0

用户端IP。
PageNumber Long 否 1

当前页数，起始值为1，默认为1。

PageSize Long 否 20

分页查询时设置的每页行数，最大值100，默认为20。

VersionCode String 否 version1

云解析产品code。
DomainType String 否 PUBLIC

指实例类型。PUBLIC:权威托管域名实例； CACHE:缓存加速实例。

返回数据

名称 类型 示例值 描述
TotalCount Long 2

本次查询获取的付费版DNS产品实例数量。
DomainType String PUBLIC

指实例类型。PUBLIC:权威托管域名实例； CACHE:缓存加速实例。
PageSize Long 2

本次查询获取的域名数量。
RequestId String 536E9CAD-DB30-4647-AC87-AA5CC38C5382

请求ID。
PageNumber Long 1

当前页码。
DnsProducts Array of DnsProduct

本次获取的付费版DNS产品实例列表。
DnsProduct
OverseaLine String 海外大洲

海外线路
PaymentType String Subscription

预付费
MonitorNodeCount Long 5

监控节点个数（个）
InBlackHole Boolean false

域名是否处于黑洞状态
BindDomainUsedCount Long 3

适用于个人版、企业标准版、企业旗舰版用户调用，指付费版DNS实例已绑定使用的域名个数。
ISPRegionLines String 电信（省份）、移动（省份）、联通（省份）、教育网（省份）

运营商线路细分列表
TTLMinValue Long 10

最小TTL值（秒）
ISPLines String 电信、移动、联通、教育网

运营商线路列表
SearchEngineLines String 搜索引擎、谷歌、百度、必应

搜索引擎线路列表
EndTimestamp Long 1474335170000

到期时间戳
VersionName String 企业旗舰版

云解析产品名称
VersionCode String version1

云解析产品code
MonitorTaskCount Long 2

监控任务数（个）
BindUsedCount Long 1

适用于定制版用户调用，指付费版DNS实例已使用的更换域名次数。
Domain String example.com

绑定域名
MonitorFrequency Long 50

监控频率（单位:分钟）
InClean Boolean false

域名是否处于清洗状态
URLForwardCount Long 20

URL转发数量（个）
StartTimestamp Long 1474335170000

购买时间戳
DDosDefendQuery Long 50

适用于定制版用户调用，DNS防护QPS（万qps）。
InstanceId String i-8fj

云解析产品ID
DDosDefendFlow Long 50

DNS防护流量（G）
BindCount Long 3

适用于定制版用户调用，指付费版DNS实例可支持更换域名次数。
SubDomainLevel Long 6

子域名级别（个）
BindDomainCount Long 5

适用于个人版、企业标准版、企业旗舰版用户调用，指付费版DNS实例可以绑定的域名个数。
EndTime String 2015-12-12T09:23Z

到期时间
StartTime String 2015-12-12T09:23Z

购买时间
OverseaDDosDefendFlow Long 1

海外DNS防护（G）
RegionLines Boolean true

是否允许地域线路
Gslb Boolean true

是否允许GSLB
DnsSecurity String no

DNS安全。取值：

  • no：不需要
  • basic：dns攻击基础防御
  • advanced：dns攻击全力防御
DnsSLBCount Long 15

负载均衡（单域名、单线路的IP地址容量）。

示例

请求示例

http(s)://alidns.aliyuncs.com/?Action=DescribeDnsProductInstances
&Lang=en
&UserClientIp=192.0.2.0
&PageNumber=1
&PageSize=20
&VersionCode=version1
&DomainType=PUBLIC
&公共请求参数

正常返回示例

XML格式 

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeDnsProductInstancesResponse>
    <TotalCount>2</TotalCount>
    <DomainType>PUBLIC</DomainType>
    <PageSize>2</PageSize>
    <RequestId>536E9CAD-DB30-4647-AC87-AA5CC38C5382</RequestId>
    <PageNumber>1</PageNumber>
    <DnsProducts>
        <OverseaLine>海外大洲</OverseaLine>
        <PaymentType>Subscription</PaymentType>
        <MonitorNodeCount>5</MonitorNodeCount>
        <InBlackHole>false</InBlackHole>
        <BindDomainUsedCount>3</BindDomainUsedCount>
        <ISPRegionLines>电信（省份）、移动（省份）、联通（省份）、教育网（省份）</ISPRegionLines>
        <TTLMinValue>10</TTLMinValue>
        <ISPLines>电信、移动、联通、教育网</ISPLines>
        <SearchEngineLines>搜索引擎、谷歌、百度、必应</SearchEngineLines>
        <EndTimestamp>1474335170000</EndTimestamp>
        <VersionName>企业旗舰版</VersionName>
        <VersionCode>version1</VersionCode>
        <MonitorTaskCount>2</MonitorTaskCount>
        <BindUsedCount>1</BindUsedCount>
        <Domain>example.com</Domain>
        <MonitorFrequency>50</MonitorFrequency>
        <InClean>false</InClean>
        <URLForwardCount>20</URLForwardCount>
        <StartTimestamp>1474335170000</StartTimestamp>
        <DDosDefendQuery>50</DDosDefendQuery>
        <InstanceId>i-8fj</InstanceId>
        <DDosDefendFlow>50</DDosDefendFlow>
        <BindCount>3</BindCount>
        <SubDomainLevel>6</SubDomainLevel>
        <BindDomainCount>5</BindDomainCount>
        <EndTime>2015-12-12T09:23Z</EndTime>
        <StartTime>2015-12-12T09:23Z</StartTime>
        <OverseaDDosDefendFlow>1</OverseaDDosDefendFlow>
        <RegionLines>true</RegionLines>
        <Gslb>true</Gslb>
        <DnsSecurity>no</DnsSecurity>
        <DnsSLBCount>15</DnsSLBCount>
    </DnsProducts>
</DescribeDnsProductInstancesResponse>

JSON格式 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "TotalCount" : 2,
  "DomainType" : "PUBLIC",
  "PageSize" : 2,
  "RequestId" : "536E9CAD-DB30-4647-AC87-AA5CC38C5382",
  "PageNumber" : 1,
  "DnsProducts" : [ {
    "OverseaLine" : "海外大洲",
    "PaymentType" : "Subscription",
    "MonitorNodeCount" : 5,
    "InBlackHole" : false,
    "BindDomainUsedCount" : 3,
    "ISPRegionLines" : "电信（省份）、移动（省份）、联通（省份）、教育网（省份）",
    "TTLMinValue" : 10,
    "ISPLines" : "电信、移动、联通、教育网",
    "SearchEngineLines" : "搜索引擎、谷歌、百度、必应",
    "EndTimestamp" : 1474335170000,
    "VersionName" : "企业旗舰版",
    "VersionCode" : "version1",
    "MonitorTaskCount" : 2,
    "BindUsedCount" : 1,
    "Domain" : "example.com",
    "MonitorFrequency" : 50,
    "InClean" : false,
    "URLForwardCount" : 20,
    "StartTimestamp" : 1474335170000,
    "DDosDefendQuery" : 50,
    "InstanceId" : "i-8fj",
    "DDosDefendFlow" : 50,
    "BindCount" : 3,
    "SubDomainLevel" : 6,
    "BindDomainCount" : 5,
    "EndTime" : "2015-12-12T09:23Z",
    "StartTime" : "2015-12-12T09:23Z",
    "OverseaDDosDefendFlow" : 1,
    "RegionLines" : true,
    "Gslb" : true,
    "DnsSecurity" : "no",
    "DnsSLBCount" : 15
  } ]
}

错误码

访问错误中心查看更多错误码。