华为云计算 云知识 查询DNAT规则列表ListNatGatewayDnatRules
查询DNAT规则列表ListNatGatewayDnatRules

 

接口说明

查询DNAT规则列表。

约束说明

可以在URI后面用'?'和'&'添加不同的查询条件组合,支持参数说明中所有非必选参数过滤,请参考请求样例。

URL
GET  https://nat.cn-north-4.myhuaweicloud.com/v2/{project_id}/dnat_rules 
请求参数
名称 类型 IN 必选 描述
X-Auth-Token
 
string header

用户Token。 用户Token也就是调用获取用户Token获取请求认证接口的响应值,该接口是唯一不需要认证的接口。 请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。

project_id
 
string path

项目的ID。

admin_state_up
 
boolean query

解冻/冻结状态。 取值范围: "true":解冻 "false":冻结

external_service_port
 
integer query

Floatingip对外提供服务的端口号。 取值范围:0~65535。

floating_ip_address
 
string query

弹性公网的IP地址。

status
 
Array of strings query

Dnat规则的状态。

floating_ip_id
 
string query

弹性公网IP 的id。

internal_service_port
 
integer query

虚拟机或者裸机对外提供服务的协议端口号。 取值范围:0~65535。

limit
 
integer query

功能说明:每页返回的个数。 取值范围:0~2000。 默认值:2000。

id
 
string query

DNAT规则的ID。

description
 
string query

DNAT规则的描述,长度限制为255。

created_at
 
string query

DNAT规则的创建时间,格式是yyyy-mm-dd hh:mm:ss.SSSSSS。

nat_gateway_id
 
Array of strings query

公网 NAT网关 实例的ID。

port_id
 
string query

虚拟机或者裸机的Port ID,对应 虚拟私有云 场景,与private_ip参数二选一。

private_ip
 
string query

用户私有IP地址,对应专线、 云连接 场景,与port_id参数二选一。

protocol
 
Array of strings query

协议类型,目前支持TCP/tcp、UDP/udp、ANY/any。 对应协议号6、17、0。

返回参数
返回码: 200

查询DNAT规则列表成功。

名称 类型 必选 描述
dnat_rules
 
Array of NatGatewayDnatRuleResponseBody objects

查询DNAT规则列表的响应体。

200 dnat_rules
名称 类型 必选 描述
id
 
string

DNAT规则的ID。

tenant_id
 
string

项目的ID。

description
 
string

DNAT规则的描述。长度限制为255。

port_id
 
string

虚拟机或者裸机的Port ID,对应虚拟 私有云 场景,与private_ip参数二选一。

private_ip
 
string

用户私有IP地址,对应专线、云连接场景,与port_id参数二选一。

internal_service_port
 
integer

虚拟机或者裸机对外提供服务的协议端口号。 取值范围:0~65535。

nat_gateway_id
 
string

公网NAT网关实例的ID。

floating_ip_id
 
string

弹性 公网IP 的id。

floating_ip_address
 
string

弹性公网IP的IP地址。

external_service_port
 
integer

Floatingip对外提供服务的端口号。 取值范围:0~65535。

status
 
string

功能说明:DNAT规则的状态。

admin_state_up
 
boolean

解冻/冻结状态。 取值范围: − “true”: 解冻 − “false”: 冻结

internal_service_port_range
 
string

虚拟机或者裸机对外提供服务的协议端口号范围。 功能说明:该端口范围与external _service_port_range按顺序实现1:1映射。 取值范围:1~65535。 约束:只能以’-’字符连接端口范围。

external_service_port_range
 
string

Floatingip对外提供服务的端口号范围。 功能说明:该端口范围与internal _service_port_range按顺序实现1:1映射。 取值范围:1~65535。 约束:只能以’-’字符连接端口范围

protocol
 
string

协议类型,目前支持TCP/tcp、UDP/udp、ANY/any。 对应协议号6、17、0。

created_at
 
string

DNAT规则的创建时间,格式是yyyy-mm-dd hh:mm:ss.SSSSSS。

请求示例
示例 1
 
"GET https://{Endpoint}/v2/d199ba7e0ba64899b2e81518104b1526d/dnat_rules?limit=2"
返回示例
返回码:200

查询DNAT规则列表成功。

示例 1
 
{
"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",
"private_ip": "",
"internal_service_port": 993,
"protocol": "tcp",
"tenant_id": "d199ba7e0ba64899b2e81518104b1526d",
"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,
"description": "my dnat rule 01"
},
{
"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": "d199ba7e0ba64899b2e81518104b1526d",
"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,
"description": "my dnat rule 01"
}
]
}
SDK
点击 NAT网关 (NAT) SDK, 下载SDK或查看SDK文档。SDK的安装、认证方式等在SDK文档中对应语言类型的【使用】目录下。
错误码
请参考 错误码说明

 

上一篇:查询IP地址组详情ShowIpGroup 下一篇:云市场商品接入类型

NAT网关 NAT 

 

华为云NAT网关(NAT Gateway)提供公网NAT网关(Public NAT Gateway)和私网NAT网关(Private NAT Gateway)两个功能。 公网NAT网关能够为VPC内的弹性云服务器提供SNAT和DNAT功能,通过灵活简易的配置,即可轻松构建VPC的公网出入口。 私网NAT网关能够为虚拟私有云内的云主机提供网络地址转换服务,使多个云主机可以共享私网IP访问用户本地数据中心(IDC)或其他虚拟私有云,同时,也支持云主机面向私网提供服务。