文档首页/ 云解析服务 DNS/ API参考 (联盟区域) / API/ 解析器管理/ 查询解析器转发规则列表
更新时间：2026-09-15 GMT+08:00
在线调试
CLI示例
查看PDF
分享

查询解析器转发规则列表

功能介绍

查询解析器转发规则列表。

URI

GET /v2.1/resolverrules

表1 Query参数

参数

是否必选

参数类型

描述

domain_name

否

String

待查询的转发规则的域名。

name

否

String

待查询的转发规则的名称。

endpoint_id

否

String

终端节点ID。

id

否

String

转发规则ID。

limit

否

Integer

每页返回的资源个数。

取值范围：0~500

取值一般为10，20，50。默认值为500。

offset

否

Integer

分页查询起始偏移量，表示从偏移量的下一个资源开始查询。

取值范围：0~2147483647

默认值为0。

当前设置marker不为空时，以marker为分页起始标识。

marker

否

String

分页查询起始的资源ID，为空时为查询第一页。

默认值为空。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户Token。

通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。

响应参数

状态码：200

表3 响应Body参数

参数

参数类型

描述

resolver_rules

Array of ListResolverRuleParam objects

解析器转发规则列表。

links

pageLink object

指向当前资源或者其他资源的链接。当查询需要分页时，需要包含一个next链接指向下一页。

metadata

metadata object

返回满足过滤条件的资源总数。

page_info

PageInfo object

分页信息。
表4 ListResolverRuleParam

参数

参数类型

描述

id

String

转发规则的ID。

name

String

规则名称。

domain_name

String

域名。

endpoint_id

String

当前规则所属的终端节点ID。

status

String

资源状态。

取值范围：PENDING_CREATE, ACTIVE, PENDING_DELETE, ERROR。

rule_type

String

规则类型。

预留字段，当前默认为FORWARD。

ipaddress_count

Integer

当前规则下的IP地址数量。

routers

Array of Router objects

关联的VPC信息。

create_time

String

创建时间。

格式：yyyy-MM-dd'T'HH:mm:ss.SSS。

update_time

String

更新时间。

格式：yyyy-MM-dd'T'HH:mm:ss.SSS。
表5 Router

参数

参数类型

描述

router_id

String

关联VPC的ID。

router_region

String

关联VPC所在的region。

status

String

资源状态。
表6 pageLink

参数

参数类型

描述

self

String

当前资源的链接。

next

String

下一页资源的链接。
表7 metadata

参数

参数类型

描述

total_count

Integer

满足查询条件的资源总数，不受分页（即limit、offset参数）影响。
表8 PageInfo

参数

参数类型

描述

next_marker

String

下一页的页面标识。

previous_marker

String

上一页的页面标识。

current_count

Integer

页面数量。

请求示例

无

响应示例

状态码：200

查询解析器转发规则列表响应。

{
  "resolver_rules" : [ {
    "id" : "8a36f60a753badb401753bade3400002",
    "name" : "rule-xxx",
    "domain_name" : "www.example.com",
    "endpoint_id" : "8a36f60a753badb401753bade3400001",
    "status" : "ACTIVE",
    "rule_type" : "FORWARD",
    "ipaddress_count" : 0,
    "routers" : [ {
      "router_id" : "ff7bd47f-3f12-4f24-a078-e6064abaa670",
      "router_region" : "xx",
      "status" : "ACTIVE"
    }, {
      "router_id" : "ff7bd47f-3f12-4f24-a078-e6064abaa671",
      "router_region" : "xx",
      "status" : "ACTIVE"
    } ],
    "create_time" : "2020-10-18T12:27:31.448",
    "update_time" : "2020-10-18T12:27:31.448"
  } ],
  "metadata" : {
    "total_count" : 1
  }
}

状态码

状态码

描述

200

查询解析器转发规则列表响应。

错误码

请参见错误码。

父主题： 解析器管理