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

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

调试

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

请求参数

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

系统规定参数。取值:DescribeDnsProductInstances

Lang String en

语言。

UserClientIp String 1.1.1.1

用户端IP。

PageNumber Long 1

当前页数,起始值为1,默认为1

PageSize Long 20

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

VersionCode String version1

云解析产品code。

返回数据

名称 类型 示例值 描述
RequestId String 536E9CAD-DB30-4647-AC87-AA5CC38C5382

请求ID。

TotalCount Long 2

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

PageNumber Long 1

当前页码。

PageSize Long 2

本次查询获取的域名数量。

DnsProducts Array

本次获取的付费版DNS产品实例列表。

InstanceId String i-8fj

云解析产品ID

VersionCode String version1

云解析产品code

VersionName String 企业旗舰版

云解析产品名称

StartTime String 2015-12-12T09:23Z

购买时间

EndTime String 2015-12-12T09:23Z

到期时间

StartTimestamp Long 1474335170000

购买时间戳

EndTimestamp Long 1474335170000

到期时间戳

Domain String abc.com

绑定域名

BindCount Long 3

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

BindUsedCount Long 1

适用于定制版用户调用,指付费版DNS实例已使用的更换域名次数。

TTLMinValue Long 10

最小TTL值(秒)

SubDomainLevel Long 6

子域名级别(个)

DnsSLBCount Long 15

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

URLForwardCount Long 20

URL转发数量(个)

DDosDefendFlow Long 50

DNS防护流量(G)

DDosDefendQuery Long 50

适用于定制版用户调用,DNS防护QPS(万qps)。

OverseaDDosDefendFlow Long 1

海外DNS防护(G)

SearchEngineLines String 搜索引擎、谷歌、百度、必应

搜索引擎线路列表

ISPLines String 电信、移动、联通、教育网

运营商线路列表

ISPRegionLines String 电信(省份)、移动(省份)、联通(省份)、教育网(省份)

运营商线路细分列表

OverseaLine String 海外大洲

海外线路

MonitorNodeCount Long 5

监控节点个数(个)

MonitorFrequency Long 50

监控频率(单位:分钟)

MonitorTaskCount Long 2

监控任务数(个)

RegionLines Boolean true

是否允许地域线路

Gslb Boolean true

是否允许GSLB

InClean Boolean false

域名是否处于清洗状态

InBlackHole Boolean false

域名是否处于黑洞状态

BindDomainCount Long 5

适用于个人版、企业标准版、企业旗舰版用户调用,指付费版DNS实例可以绑定的域名个数。

BindDomainUsedCount Long 3

适用于个人版、企业标准版、企业旗舰版用户调用,指付费版DNS实例已绑定使用的域名个数。

DnsSecurity String no

DNS安全。取值:

  • no:不需要
  • basic:dns攻击基础防御
  • advanced:dns攻击全力防御

示例

请求示例

http(s)://alidns.aliyuncs.com/?Action=DescribeDnsProductInstances
&<公共请求参数>

正常返回示例

XML 格式

<DescribeDnsProductInstancesResponse>
      <RequestId>536E9CAD-DB30-4647-AC87-AA5CC38C5382</RequestId>
      <TotalCount>1</TotalCount>
      <PageNumber>1</PageNumber>
      <PageSize>2</PageSize>
      <DnsProducts>
            <DnsProduct>
                  <InstanceId>i-8fj</InstanceId>
                  <StartTime>2015-12-12T09:23Z</StartTime>
                  <EndTime>2016-12-12T09:23Z</EndTime>
                  <Domain>abc.com</Domain>
                  <BindCount>3</BindCount>
                  <BindUsedCount>1</BindUsedCount>
                  <TTLMinValue>10</TTLMinValue>
                  <SubDomainLevel>6</SubDomainLevel>
                  <DnsSLBCount>15</DnsSLBCount>
                  <URLForwardCount>20</URLForwardCount>
                  <DDosDefendFlow>50</DDosDefendFlow>
                  <DDosDefendQuery>50</DDosDefendQuery>
                  <OverseaDDosDefendFlow>1</OverseaDDosDefendFlow>
                  <SearchEngineLines>搜索引擎、谷歌、百度、必应</SearchEngineLines>
                  <ISPLines>电信、移动、联通、教育网</ISPLines>
                  <ISPRegionLines>电信(省份)、移动(省份)、联通(省份)、教育网(省份)</ISPRegionLines>
                  <OverseaLine>海外大洲</OverseaLine>
            </DnsProduct>
      </DnsProducts>
</DescribeDnsProductInstancesResponse>

JSON 格式

{
        "DescribeDnsProductInstancesResponse": {
        "RequestId": "536E9CAD-DB30-4647-AC87-AA5CC38C5382", 
        "TotalCount": "1", 
        "PageNumber": "1", 
        "PageSize": "2", 
        "DnsProducts": {
            "DnsProduct": {
                "InstanceId": "i-8fj", 
                "StartTime": "2015-12-12T09:23Z", 
                "EndTime": "2016-12-12T09:23Z", 
                "Domain": "abc.com", 
                "BindCount": "3", 
                "BindUsedCount": "1", 
                "TTLMinValue": "10", 
                "SubDomainLevel": "6", 
                "DnsSLBCount": "15", 
                "URLForwardCount": "20", 
                "DDosDefendFlow": "50", 
                "DDosDefendQuery": "50", 
                "OverseaDDosDefendFlow": "1", 
                "SearchEngineLines": "搜索引擎、谷歌、百度、必应", 
                "ISPLines": "电信、移动、联通、教育网", 
                "ISPRegionLines": "电信(省份)、移动(省份)、联通(省份)、教育网(省份)", 
                "OverseaLine": "海外大洲"
            }
        }
    }
}

错误码

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