DescribeDnsProductInstances - 获取付费版DNS产品实例列表

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

接口说明

说明

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

调试

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

调试

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。

  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。

  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:

    • 对于必选的资源类型,用前面加 * 表示。

    • 对于不支持资源级授权的操作,用全部资源表示。

  • 条件关键字:是指云产品自身定义的条件关键字。

  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

alidns:DescribeDnsProductInstances

get

*Instance

acs:alidns:*:{#accountId}:instance/*

请求参数

名称

类型

必填

描述

示例值

Lang

string

返回值语言,取值:

  • zh:中文

  • en:英文

默认:en

en

UserClientIp

string

用户端 IP。

192.0.2.0

PageNumber

integer

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

1

PageSize

integer

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

20

VersionCode

string

云解析产品 code。

version1

DomainType

string

域名类型,大小写不敏感。取值:

  • PUBLIC:权威托管域名(默认值)

  • CACHE:权威代理域名

PUBLIC

OrderBy

string

排序参数。取值:

  • createDate:按创建时间排序(为空时默认按创建时间排序)

  • expireDate:按过期时间排序

createDate

Direction

string

排序方向。取值:

  • DESC:递减(为空时默认递减排序)

  • ASC: 递增

DESC

返回参数

名称

类型

描述

示例值

object

TotalCount

integer

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

2

DomainType

string

域名类型,取值:

  • PUBLIC:权威托管域名(默认值)

  • CACHE:权威代理域名

PUBLIC

PageSize

integer

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

2

RequestId

string

唯一请求识别码。

536E9CAD-DB30-4647-AC87-AA5CC38xxxxx

PageNumber

integer

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

1

DnsProducts

object

DnsProduct

array<object>

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

object

OverseaLine

string

海外解析请求来源线路。

海外大洲

PaymentType

string

付费类型。

Subscription

MonitorNodeCount

integer

监控节点个数(个)。

5

InBlackHole

boolean

域名是否处于黑洞状态。

  • true:处于黑洞状态

  • false:非黑洞状态

false

BindDomainUsedCount

integer

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

3

ISPRegionLines

string

运营商解析请求来源线路列表。

  • 电信(省份)

  • 移动(省份)

  • 联通(省份)

  • 教育网(省份)

电信_浙江

TTLMinValue

integer

最小 TTL 值(秒)。

10

ISPLines

string

运营商解析请求来源线路列表。

  • 中国电信

  • 中国移动

  • 中国联通

  • 中国教育网

  • 中国广电网

  • 中国鹏博士

中国电信

SearchEngineLines

string

搜索引擎解析请求来源线路列表。

  • 谷歌

  • 百度

  • 必应

  • 有道

谷歌

EndTimestamp

integer

实例到期时间(时间戳)。

1474335170000

VersionName

string

云解析产品版本名称。

企业旗舰版

VersionCode

string

云解析产品 code。

version1

MonitorTaskCount

integer

监控任务数(个)。

2

BindUsedCount

integer

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

1

Domain

string

绑定域名。

example.com

MonitorFrequency

integer

监控频率(单位:分钟)。

50

InClean

boolean

域名是否处于清洗状态。

false

URLForwardCount

integer

URL 转发数量(个)。

20

StartTimestamp

integer

实例购买时间(时间戳)。

1474335170000

DDosDefendQuery

integer

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

50

InstanceId

string

云解析产品 ID。

i-8fj

DDosDefendFlow

integer

DNS 防护流量(G)。

50

BindCount

integer

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

3

SubDomainLevel

integer

子域名级别(个)。

6

BindDomainCount

integer

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

5

EndTime

string

实例到期时间。

2015-12-12T00:00Z

StartTime

string

实例购买时间。

2015-11-12T09:23Z

OverseaDDosDefendFlow

integer

海外 DNS 防护(G)。

1

RegionLines

boolean

是否是地域线路。

  • true:地域线路

  • false:非地域线路

true

Gslb

boolean

是否允许 GSLB。

  • true:允许

  • false:不允许

true

DnsSecurity

string

DNS 安全。取值:

  • no:不需要

  • basic:dns 攻击基础防御

  • advanced:dns 攻击全力防御

no

DnsSLBCount

integer

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

15

AutoRenewal

boolean

续费状态。

  • true:自动续费类型。

  • false:非自动续费类型。

true

示例

正常返回示例

JSON格式

{
  "TotalCount": 2,
  "DomainType": "PUBLIC",
  "PageSize": 2,
  "RequestId": "536E9CAD-DB30-4647-AC87-AA5CC38xxxxx",
  "PageNumber": 1,
  "DnsProducts": {
    "DnsProduct": [
      {
        "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-12T00:00Z",
        "StartTime": "2015-11-12T09:23Z",
        "OverseaDDosDefendFlow": 1,
        "RegionLines": true,
        "Gslb": true,
        "DnsSecurity": "no",
        "DnsSLBCount": 15,
        "AutoRenewal": true
      }
    ]
  }
}

错误码

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

变更历史

更多信息,参考变更详情