文档首页/ 云解析服务 DNS/ API参考/ API/ 批量操作/ 批量查询DNS解析量统计相关的资源 - ListInstances
更新时间：2026-01-15 GMT+08:00
在线调试
CLI示例
查看PDF
分享

批量查询DNS解析量统计相关的资源 - ListInstances

功能介绍

批量查询DNS解析量统计相关的资源。

调用方法

请参见如何调用API。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
  • 如果使用身份策略授权，当前API调用无需身份策略权限。

URI

POST /v2.1/batch-query-instances

请求参数

表1 请求Body参数

参数

是否必选

参数类型

描述

dim_name

是

Array of strings

参数解释：

DNS批量查询接口支持查询的维度。

约束限制：

不涉及。

取值范围：

  • dns_public_zone_id：公网域名ID

  • dns_public_recordset_id：公网记录集ID，需与dns_public_zone_id组合使用

  • dns_private_zone_id：内网域名ID

  • vpc_id：VPC ID，需与dns_private_zone_id组合使用

默认取值：

不涉及。

ids

是

Array<Array<String>>

DNS上报的资源ID列表。

响应参数

状态码：200

表2 响应Body参数

参数

参数类型

描述

instances

Array of ResolutionInstances objects

返回查询到的解析量资源实例。
表3 ResolutionInstances

参数

参数类型

描述

dns_public_zone_id

ZoneResolutionInstances object

公网域名的资源详情。

dns_public_recordset_id

RsetResolutionInstances object

公网记录集的资源详情，需与dns_public_zone_id组合使用。

dns_private_zone_id

ZoneResolutionInstances object

内网域名的资源详情。

vpc_id

VpcResolutionInstances object

VPC的资源详情，需与dns_private_zone_id组合使用。
表4 RsetResolutionInstances

参数

参数类型

描述

id

String

参数解释：

记录集ID。

取值范围：

不涉及。

name

String

参数解释：

记录集域名。

取值范围：

不涉及。

status

String

参数解释：

记录集状态。

取值范围：

  • ACTIVE：正常

  • PENDING_CREATE：创建中

  • PENDING_UPDATE：更新中

  • PENDING_DELETE：删除中

  • PENDING_FREEZE：冻结中

  • FREEZE：冻结

  • ILLEGAL：违规冻结

  • POLICE：公安冻结

  • PENDING_DISABLE：暂停中

  • DISABLE：暂停

  • ERROR：失败

type

String

参数解释：

记录集类型。

取值范围：

  • A：将域名解析到指定的IPv4地址。

  • AAAA：将域名解析到指定的IPv6地址。

  • MX：指定域名对应的邮件服务器。

  • CNAME：将域名解析到另一域名，或者多个域名映射到同一域名上。

  • TXT：用于对域名进行标识和说明。

  • SRV：用于记录某台服务器对外提供了哪些服务。

  • NS：指定域名的权威DNS服务器。

  • SOA：提供域名的基本信息和权威服务器的详细信息。

  • CAA：指定为域名颁发HTTPS证书的授权CA机构，仅支持公网域名解析。

  • PTR：指定IP地址反向解析记录，仅支持内网域名解析。
表5 ZoneResolutionInstances

参数

参数类型

描述

id

String

参数解释：

域名ID。

取值范围：

不涉及。

name

String

参数解释：

域名。

取值范围：

不涉及。

status

String

参数解释：

域名状态。

取值范围：

  • ACTIVE：正常

  • PENDING_CREATE：创建中

  • PENDING_UPDATE：更新中

  • PENDING_DELETE：删除中

  • PENDING_FREEZE：冻结中

  • FREEZE：冻结

  • ILLEGAL：违规冻结

  • POLICE：公安冻结

  • PENDING_DISABLE：暂停中

  • DISABLE：暂停

  • ERROR：失败

region

String

参数解释：

域名所属的区域。

取值范围：

不涉及。

enterprise_project_id

String

参数解释：

企业项目ID。

取值范围：

不涉及。
表6 VpcResolutionInstances

参数

参数类型

描述

id

String

参数解释：

VPC ID。

取值范围：

不涉及。

name

String

参数解释：

VPC名称。

取值范围：

不涉及。

请求示例

批量查询DNS解析量统计相关的资源。

POST https://{endpoint}/v2.1/batch-query-instances

{
  "dim_name" : [ "dns_public_zone_id", "dns_public_recordset_id" ],
  "ids" : [ [ "9a175b9787bcc2710187c5ae33ad2670", "9a186e6689ce017c0189cfff487966cb" ], [ "9a175b9785770684018577afafe900dc", "9a175b9784c34a960184c35e4243000b" ] ]
}

响应示例

状态码：200

查询DNS资源响应。

{
  "instances" : [ {
    "dns_public_zone_id" : [ {
      "name" : "example.com.",
      "id" : "9a175b9787bcc2710187c5ae33ad2670",
      "region" : "global",
      "enterprise_project_id" : "0"
    } ],
    "dns_public_recordset_id" : [ {
      "id" : "9a186e6689ce017c0189cfff487966cb",
      "name" : "www.example.com."
    } ]
  }, {
    "dns_public_zone_id" : [ {
      "name" : "example.cn.",
      "id" : "9a175b9785770684018577afafe900dc",
      "region" : "global",
      "enterprise_project_id" : "50b6a13d-4b22-4122-a100-e9915b9c1cff"
    } ],
    "dns_public_recordset_id" : [ {
      "id" : "9a175b9784c34a960184c35e4243000b",
      "name" : "www.example.cn."
    } ]
  } ]
}

状态码

状态码

描述

200

查询DNS资源响应。

错误码

请参见错误码。

父主题： 批量操作

相关文档