华为云计算 云知识 查询私网NAT网关列表ListPrivateNats
查询私网NAT网关列表ListPrivateNats

 

接口说明

查询 私网NAT网关 实例列表。

约束说明

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

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

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

project_id
 
string path

项目的ID。

limit
 
integer query

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

marker
 
string query

功能说明:分页查询起始的资源ID,为空时查询第一页。 值从上一次查询的PageInfo中的next_marker或者previous_marker中获取。

page_reverse
 
boolean query

是否查询前一页。

id
 
Array of strings query

私网 NAT网关 实例的ID。

name
 
Array of strings query

私网NAT网关实例的名字。

description
 
Array of strings query

私网NAT网关实例的描述。

spec
 
Array of strings query

私网NAT网关实例的规格。 取值为: "Small":小型 "Medium":中型 "Large":大型 "Extra-large":超大型

project_id
 
Array of strings query

项目的ID。

status
 
Array of strings query

私网NAT网关实例的状态。 取值为: "ACTIVE":正常运行 "FROZEN":冻结

vpc_id
 
Array of strings query

私网NAT网关实例所属VPC的ID。

virsubnet_id
 
Array of strings query

私网NAT网关实例所属子网的ID。

ent erp rise_project_id
 
Array of strings query

企业项目ID。创建私网NAT网关实例时,关联的企业项目ID。

返回参数
返回码: 200

查询私网NAT网关实例列表成功

名称 类型 必选 描述
gateways
 
Array of PrivateNat objects

查询私网NAT网关实例列表的响应体。 详见PrivateNat字段说明。

request_id
 
string

请求ID。

page_info
 
PageInfo object

分页信息。

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

私网NAT网关实例的ID。

project_id
 
string

项目的ID。

name
 
string

私网NAT网关实例的名字。

description
 
string

私网NAT网关实例的描述。

spec
 
string

私网NAT网关实例的规格。 取值为: "Small":小型 "Medium":中型 "Large":大型 "Extra-large":超大型

status
 
string

私网NAT网关实例的状态。 取值为: "ACTIVE":正常运行 "FROZEN":冻结

created_at
 
string

私网NAT网关实例的创建时间,遵循UTC时间,格式是yyyy-mm-ddThh:mm:ssZ。

updated_at
 
string

私网NAT网关实例的更新时间,遵循UTC时间,格式是yyyy-mm-ddThh:mm:ssZ。

downlink_vpcs
 
Array of DownlinkVpc objects

私网NAT网关实例所属的VPC实例。

tags
 
Array of PrivateTag objects

标签列表。

enterprise_project_id
 
string

企业项目ID。 创建私网NAT网关实例时,关联的企业项目ID。

200 gateways.tags
名称 类型 必选 描述
key
 
string

标签key值。

value
 
string

标签value。

200 page_info
名称 类型 必选 描述
next_marker
 
string

分页查询结果中最后一条记录的ID。通常用于查询下一页。

previous_marker
 
string

分页查询结果中第一条记录的ID。通常用于配合page_reverse=true查询上一页。

current_count
 
integer

分页查询资源时,本页的实例的个数。

返回示例
返回码:200

查询私网NAT网关实例列表成功

示例 1
 
{
"gateways": [
{
"id": "14338426-6afe-4019-996b-3a9525296e11",
"name": "private-nat-gateway-name1",
"description": "private-nat-gateway-description1",
"spec": "Small",
"project_id": "70505c941b9b4dfd82fd351932328a2f",
"enterprise_project_id": "2759da7b-8015-404c-ae0a-a389007b0e2a",
"status": "ACTIVE",
"created_at": "2019-04-22T08:47:13",
"updated_at": "2019-04-22T08:47:13",
"tags": [
{
"key": "key1",
"value": "value1"
}
],
"downlink_vpcs": [
{
"vpc_id": "3cb66d44-9f75-4237-bfff-e37b14d23ad2",
"virsubnet_id": "373979ee-f4f0-46c5-80e3-0fbf72646b70"
}
]
},
{
"id": "65995b8e-dcb7-4ab4-9931-bc3c95beec0a",
"name": "private-nat-gateway-name2",
"description": "private-nat-gateway-description2",
"spec": "Small",
"project_id": "70505c941b9b4dfd82fd351932328a2f",
"enterprise_project_id": "2759da7b-8015-404c-ae0a-a389007b0e2a",
"status": "ACTIVE",
"created_at": "2019-04-22T09:06:54",
"updated_at": "2019-04-22T09:06:54",
"tags": [
{
"key": "key1",
"value": "value1"
}
],
"downlink_vpcs": [
{
"vpc_id": "3cb66d44-9f75-4237-bfff-e37b14d23ad2",
"virsubnet_id": "373979ee-f4f0-46c5-80e3-0fbf72646b70"
}
]
}
],
"request_id": "a7b00469-5a31-4274-bb10-59167243383e",
"page_info": {
"previous_marker": "14338426-6afe-4019-996b-3a9525296e11",
"current_count": 2
}
}
SDK
点击 NAT网关 (NAT) SDK, 下载SDK或查看SDK文档。SDK的安装、认证方式等在SDK文档中对应语言类型的【使用】目录下。
错误码
请参考 错误码说明

 

上一篇:弹性云服务器收费方式介绍 下一篇:弹性公网IP常用功能介绍

NAT网关 NAT 

 

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