调用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安全。取值:
|
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
} ]
}
错误码
访问错误中心查看更多错误码。