# 查询DNAT规则列表
#### 功能介绍
查询DNAT规则列表。
#### URI
GET /v2.0/dnat_rules
![](https://support.huaweicloud.com/api-natgateway/public_sys-resources/note_3.0-zh-cn.png)
可以在URI后面用'?'和'\&'添加不同的查询条件组合。支持参数说明中所有非必选参数过滤，请参考请求样例。
表1参数说明 
| 参数                    | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                                                                   |
|:---|:---|:---|
| id                    | String  | DNAT规则的id。                                                                                                                                                                                                                                                                                                                                                                           |
| limit                 | Integer | 每页返回的个数。                                                                                                                                                                                                                                                                                                                                                                             |
| tenant_id             | String  | 项目的ID。                                                                                                                                                                                                                                                                                                                                                                               |
| nat_gateway_id        | String  | 所属公网NAT网关的id。                                                                                                                                                                                                                                                                                                                                                                        |
| port_id               | String  | 虚拟机或者裸机的Port ID。                                                                                                                                                                                                                                                                                                                                                                     |
| private_ip            | String  | 用户私有IP地址，例如专线连接的私有云地址。                                                                                                                                                                                                                                                                                                                                                               |
| internal_service_port | Integer | 虚拟机或者裸机对外提供服务的协议端口号。                                                                                                                                                                                                                                                                                                                                                                 |
| floating_ip_id        | String  | 弹性公网IP的id。                                                                                                                                                                                                                                                                                                                                                                           |
| floating_ip_address   | String  | 弹性公网的IP地址。                                                                                                                                                                                                                                                                                                                                                                           |
| external_service_port | Integer | Floatingip对外提供服务的端口号。                                                                                                                                                                                                                                                                                                                                                                |
| protocol              | String  | 协议类型，目前支持TCP/UDP/ANY 对应协议号6/17/0                                                                                                                                                                                                                                                                                                                      |
| status                | String  | - 功能说明：DNAT规则的状态。  - 取值范围：++++[资源状态说明](https://support.huaweicloud.com/api-natgateway/nat_api_0042.html)++++。                                                                                                            |
| admin_state_up        | Boolean | - 解冻/冻结状态。  - 取值范围： - "true"：解冻  - "false"：冻结     |
| created_at            | String  | DNAT规则的创建时间戳，遵循UTC时间，保留小数点后6位，格式是yyyy-mm-dd hh:mm:ss                                                                                                                                                                                                                                                                                                                                 |
   
#### 请求消息
无
#### 响应消息
响应参数如[表2]所示。
 表2响应参数 
| 参数         | 参数类型          | 描述                                                        |
|:---|:---|:---|
| dnat_rules | Array(Object) | dnat_rule对象列表。详见[表3]。 |
   
 表3dnat_rule字段说明 
| 参数                    | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                                                                      |
|:---|:---|:---|
| id                    | String  | DNAT规则的id。                                                                                                                                                                                                                                                                                                                                                                              |
| tenant_id             | String  | 项目的ID。                                                                                                                                                                                                                                                                                                                                                                                  |
| nat_gateway_id        | String  | 所属公网NAT网关的id。                                                                                                                                                                                                                                                                                                                                                                           |
| port_id               | String  | 虚拟机或者裸机的Port ID。                                                                                                                                                                                                                                                                                                                                                                        |
| private_ip            | String  | 用户私有IP地址，例如专线连接的私有云地址。                                                                                                                                                                                                                                                                                                                                                                  |
| internal_service_port | Integer | 虚拟机或者裸机对外提供服务的协议端口号。                                                                                                                                                                                                                                                                                                                                                                    |
| floating_ip_id        | String  | 弹性公网IP的id。                                                                                                                                                                                                                                                                                                                                                                              |
| floating_ip_address   | String  | 弹性公网的IP地址。                                                                                                                                                                                                                                                                                                                                                                              |
| external_service_port | Integer | Floatingip对外提供服务的端口号。                                                                                                                                                                                                                                                                                                                                                                   |
| protocol              | String  | 协议类型，目前支持TCP/UDP/ANY 对应协议号6/17/0                                                                                                                                                                                                                                                                                                                            |
| status                | String  | - 功能说明：DNAT规则的状态。  - 取值范围：[资源状态说明](https://support.huaweicloud.com/api-natgateway/nat_api_0042.html#nat_api_0042__table1390614366107)。                                                                                                      |
| admin_state_up        | Boolean | - 解冻/冻结状态。  - 取值范围： - "true"：解冻  - "false"：冻结     |
| created_at            | String  | DNAT规则的创建时间戳，遵循UTC时间，保留小数点后6位，格式是yyyy-mm-dd hh:mm:ss                                                                                                                                                                                                                                                                                                                                    |
   
#### 示例
- 请求样例
  ```
  GET https://{Endpoint}/v2.0/dnat_rules
  ```
  
 
- 响应样例
  ```
  {
      "dnat_rules": [
          {
              "floating_ip_id": "bf99c679-9f41-4dac-8513-9c9228e713e1",
              "status": "ACTIVE",
              "nat_gateway_id": "cda3a125-2406-456c-a11f-598e10578541",
              "admin_state_up": true,
              "port_id": "9a469561-daac-4c94-88f5-39366e5ea193",
              "internal_service_port": 993,
              "protocol": "tcp",
              "tenant_id": "abc",
              "created_at": "2017-11-15 15:44:42.595173",
              "id": "79195d50-0271-41f1-bded-4c089b2502ff",
              "floating_ip_address": "5.21.11.226",
              "external_service_port": 242,
              "private_ip": ""  
          },
          {
              "floating_ip_id": "cf99c679-9f41-4dac-8513-9c9228e713e1",
              "status": "ACTIVE",
              "nat_gateway_id": "dda3a125-2406-456c-a11f-598e10578541",
              "admin_state_up": true,
              "port_id": "",
              "private_ip": "192.168.1.100",
              "internal_service_port": 0,
              "protocol": "any",
              "tenant_id": "abc",
              "created_at": "2017-11-16 15:44:42.595173",
              "id": "89195d50-0271-41f1-bded-4c089b2502ff",
              "floating_ip_address": "5.21.11.227",
              "external_service_port": 0
          }
      ]
  }
  ```
  
#### 状态码
请参考[状态码](https://support.huaweicloud.com/api-natgateway/nat_api_0038.html)。