调用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
  } ]
}

错误码

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