
# 查询指定的DNAT规则详情 - ShowPrivateDnat
#### 功能介绍
查询指定的DNAT规则详情。
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-natgateway/nat_api_0053.html)。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-natgateway/nat_api_0063.html)。
- 如果使用身份策略授权，需具备如下身份策略权限。
  
  | 授权项                         | 访问级别 | 资源类型（\*为必须）        | 条件键                                                                                                                                                                                                                                                                                                                                             | 别名 | 依赖的授权项 |
  |:---|:---|:---|:---|:---|:---|
  | nat:privateNatDnatRules:get | Read | privateGateway \*  | - g:EnterpriseProjectId   - g:ResourceTag/\<tag-key\>    | -  | -      |
  | nat:privateNatDnatRules:get | Read | privateDnatRule \* | g:EnterpriseProjectId                                                                                                                                                                                                                                                                                                                           | -  | -      |
     
  
 
#### URI
GET /v3/{project_id}/private-nat/dnat-rules/{dnat_rule_id}
表1路径参数 
| 参数           | 是否必选 | 参数类型   | 描述         |
|:---|:---|:---|:---|
| project_id   | 是    | String | 项目的ID。     |
| dnat_rule_id | 是    | String | DNAT规则的ID。 |
   
#### 请求参数
表2请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                                                                                                             |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | 用户Token。 用户Token也就是调用获取用户Token获取请求认证接口的响应值，该接口是唯一不需要认证的接口。 请求响应成功后在响应消息头中包含的"X-Subject-Token"的值即为Token值。 |
   
#### 响应参数
**状态码：200**
表3响应Body参数 
| 参数         | 参数类型                                                         | 描述          |
|:---|:---|:---|
| dnat_rule  | [PrivateDnat] object | DNAT规则的响应体。 |
| request_id | String                                                       | 请求ID。       |
   
 表4PrivateDnat 
| 参数                    | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
|:---|:---|:---|
| id                    | String | DNAT规则的ID。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| project_id            | String | 项目的ID。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| description           | String | DNAT规则的描述。长度范围小于等于255个字符，不能包含"\<"和"\>"。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| transit_ip_id         | String | 中转IP的ID。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| gateway_id            | String | 私网NAT网关实例的ID。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| network_interface_id  | String | 网络接口ID，支持计算、ELBV2、ELBV3、VIP等实例的端口。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| type                  | String | DNAT规则后端的类型。 取值： - COMPUTE：后端为计算实例。   - VIP：后端为VIP的实例。   - ELB：后端为ELBv2的实例。   - ELBv3：后端为ELBv3的实例。   - CUSTOMIZE：后端为自定义IP。    |
| protocol              | String | 协议类型。 目前支持TCP/tcp、UDP/udp、ANY/any。 对应协议号6、17、0。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| private_ip_address    | String | 后端资源（计算实例、ELBV2、ELBV3、VIP等）的私网IP地址。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| internal_service_port | String | 后端实例的端口号（计算实例、ELBV2、ELBV3、VIP等)。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| transit_service_port  | String | 中转IP的端口号。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| enterprise_project_id | String | 企业项目ID。创建DNAT规则时，关联的企业项目ID。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| created_at            | String | DNAT规则的创建时间，遵循UTC时间，格式是yyyy-mm-ddThh:mm:ssZ。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| updated_at            | String | DNAT规则的更新时间，遵循UTC时间，格式是yyyy-mm-ddThh:mm:ssZ。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| status                | String | 私网NAT的DNAT规则状态。 取值为： - ACTIVE：正常运行   - FROZEN：冻结   - INACTIVE：不可用                                                                                                                                                                                                                                                                                                                   |
   
#### 请求示例
```
GET https://{Endpoint}/v3/da261828016849188f4dcc2ef94d9da9/private-nat/dnat-rules/24dd6bf5-48f2-4915-ad0b-5bb111d39c83
```
#### 响应示例
**状态码：200**
查询DNAT规则成功。
-
  ```
  {
    "dnat_rule" : {
      "id" : "24dd6bf5-48f2-4915-ad0b-5bb111d39c83",
      "project_id" : "da261828016849188f4dcc2ef94d9da9",
      "description" : "aa",
      "gateway_id" : "0adefb29-a6c2-48a5-8637-2be67fa03fec",
      "transit_ip_id" : "3faa719d-6d18-4ccb-a5c7-33e65a09663e",
      "enterprise_project_id" : "2759da7b-8015-404c-ae0a-a389007b0e2a",
      "network_interface_id" : "dae9393a-b536-491c-a5a2-72edc1104707",
      "type" : "COMPUTE",
      "protocol" : "any",
      "internal_service_port" : "0",
      "transit_service_port" : "0",
      "private_ip_address" : "192.168.1.72",
      "created_at" : "2019-04-29T07:10:01Z",
      "updated_at" : "2019-04-29T07:10:01Z",
      "status" : "ACTIVE"
    },
    "request_id" : "747a911c17067a39692f75ac146fb47e"
  }
  ```
  
 
#### 状态码
| 状态码 | 描述          |
|:---|:---|
| 200 | 查询DNAT规则成功。 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-natgateway/ErrorCode.html)。
