华为云计算 云知识 查询SNAT规则列表ListNatGatewaySnatRules
查询SNAT规则列表ListNatGatewaySnatRules

 

接口说明

查询SNAT规则列表。

约束说明

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

URL
GET  https://nat.cn-north-4.myhuaweicloud.com/v2/{project_id}/snat_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":冻结

cidr
 
string query

可以是网段或者主机格式,与network_id参数二选一。 Source_type=0时,cidr必须是vpc子网网段的子集(不能相等); Source_type=1时,cidr必须指定专线侧网段。

limit
 
integer query

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

floating_ip_address
 
string query

功能说明: 弹性公网IP ,多个弹性 公网IP 使用逗号分隔。 取值范围:最大长度1024字节。

floating_ip_id
 
string query

功能说明:弹性公网IP的id,多个弹性公网IP使用逗号分隔。 取值范围:最大长度4096字节。

id
 
string query

SNAT规则的ID。

description
 
string query

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

created_at
 
string query

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

nat_gateway_id
 
Array of strings query

公网 NAT网关 实例的ID。

network_id
 
string query

规则使用的网络id。与cidr参数二选一。

source_type
 
integer query

0:VPC侧,可以指定network_id 或者cidr 1:专线侧,只能指定cidr 不输入默认为0(VPC)

status
 
string query

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

返回参数
返回码: 200

查询SNAT规则列表成功。

名称 类型 必选 描述
snat_rules
 
Array of NatGatewaySnatRuleResponseBody objects

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

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

SNAT规则的ID。

tenant_id
 
string

项目的ID。

nat_gateway_id
 
string

公网NAT网关实例的ID。

cidr
 
string

cidr,可以是网段或者主机格式,与network_id参数二选一。 Source_type=0时,cidr必须是vpc 子网网段的子集(不能相等); Source_type=1时,cidr必须指定专线侧网段。

source_type
 
integer

0:VPC侧,可以指定network_id 或者cidr 1:专线侧,只能指定cidr 不输入默认为0(VPC)

floating_ip_id
 
string

功能说明:弹性公网IP的id,多个弹性公网IP使用逗号分隔。 取值范围:最大长度4096字节。

description
 
string

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

status
 
string

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

created_at
 
string

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

network_id
 
string

规则使用的网络id。与cidr参数二选一。

admin_state_up
 
boolean

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

  • "true":解冻
  • "false":冻结
floating_ip_address
 
string

功能说明:弹性公网IP,多个弹性公网IP使用逗号分隔。 取值范围:最大长度1024字节。

freezed_ip_address
 
string

功能说明:冻结的弹性公网IP,多个冻结的弹性公网IP使用逗号分隔。 取值范围:最大长度1024字节。

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

查询SNAT规则列表成功。

示例 1
 
{
"snat_rules": [
{
"floating_ip_id": "bf99c679-9f41-4dac-8513-9c9228e713e1",
"status": "ACTIVE",
"nat_gateway_id": "cda3a125-2406-456c-a11f-598e10578541",
"admin_state_up": true,
"network_id": "9a469561-daac-4c94-88f5-39366e5ea193",
"source_type": 0,
"tenant_id": "d199ba7e0ba64899b2e81518104b1526",
"created_at": "2017-11-15 15:44:42.595173",
"id": "79195d50-0271-41f1-bded-4c089b2502ff",
"floating_ip_address": "5.21.11.242",
"freezed_ip_address": "",
"description": "my snat rule 01"
},
{
"floating_ip_id": "6e496fba-abe9-4f5e-9406-2ad8c809ac8c",
"status": "ACTIVE",
"nat_gateway_id": "e824f1b4-4290-4ebc-8322-cfff370dbd1e",
"admin_state_up": true,
"network_id": "97e89905-f9c8-4ae3-9856-392b0b2fbe7f",
"source_type": 0,
"tenant_id": "d199ba7e0ba64899b2e81518104b1526",
"created_at": "2017-11-17 07:43:44.830845",
"id": "4a1a10d7-0d9f-4846-8cda-24cffeffef5c",
"floating_ip_address": "5.21.11.142,5.21.11.143",
"freezed_ip_address": "5.21.11.142",
"description": "my snat rule 01"
}
]
}
SDK
点击 NAT网关 (NAT) SDK, 下载SDK或查看SDK文档。SDK的安装、认证方式等在SDK文档中对应语言类型的【使用】目录下。
错误码
请参考 错误码说明

 

上一篇:拓课云直播互动小班课教师端操作说明(七) 下一篇:查询单个云硬盘过户记录详情CinderShowVolumeTransfer

NAT网关 NAT 

 

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