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

查询解析器转发规则

功能介绍

查询解析器转发规则。

URI

GET /v2.1/resolverrules/{resolverrule_id}

表1 路径参数

参数

是否必选

参数类型

描述

resolverrule_id

是

String

转发规则ID。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户Token。

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

响应参数

状态码：200

表3 响应Body参数

参数

参数类型

描述

resolver_rule

ShowResolverRuleRespParam object

解析器转发规则。
表4 ShowResolverRuleRespParam

参数

参数类型

描述

id

String

转发规则的ID，UUID形式的一个资源标识。

name

String

规则名称。

domain_name

String

域名。

endpoint_id

String

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

status

String

资源状态。

取值范围：

  • ACTIVE：正常

  • PENDING_CREATE：创建中

  • PENDING_DELETE：删除中

  • ERROR：失败

rule_type

String

规则类型。

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

ipaddress_count

Integer

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

ipaddresses

Array of IpValue objects

规则的目标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 IpValue

参数

参数类型

描述

ip

String

IP地址信息。
表6 Router

参数

参数类型

描述

router_id

String

关联VPC的ID。

router_region

String

关联VPC所在的region。

status

String

资源状态。

请求示例

无

响应示例

状态码：200

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

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

状态码

状态码

描述

200

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

错误码

请参见错误码。

父主题： 解析器管理