华为云计算 云知识 查询中转IP列表ListTransitIps
查询中转IP列表ListTransitIps

 

接口说明

查询中转IP列表。

约束说明

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

URL
GET  https://nat.cn-north-4.myhuaweicloud.com/v3/{project_id}/private-nat/transit-ips 
请求参数
名称 类型 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

中转IP的ID。

project_id
 
Array of strings query

项目的ID。

network_interface_id
 
Array of strings query

中转IP的网络接口ID。

ip_address
 
Array of strings query

中转IP地址。

gateway_id
 
Array of strings query

中转IP绑定的 私网NAT网关 实例的ID。

enterprise_project_id
 
Array of strings query

企业项目ID。创建中转IP时,关联的企业项目ID。

virsubnet_id
 
Array of strings query

当前租户子网的ID。

返回参数
返回码: 200

查询中转IP列表成功。

名称 类型 必选 描述
transit_ips
 
Array of TransitIp objects

查询中转IP列表的响应体。

page_info
 
PageInfo object

分页信息。

request_id
 
string

请求ID。

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

中转IP的ID。

project_id
 
string

项目的ID。

network_interface_id
 
string

中转IP的网络接口ID。

ip_address
 
string

中转IP的地址。

created_at
 
string

中转IP的创建时间,遵循UTC时间,格式是yyyy-mm-ddThh:mm:ssZ

updated_at
 
string

中转IP的更新时间,遵循UTC时间,格式是yyyy-mm-ddThh:mm:ssZ

virsubnet_id
 
string

当前租户子网的ID。

tags
 
Array of PrivateTag objects

标签列表。

gateway_id
 
string

中转IP绑定的私网 NAT网关 实例的ID。

enterprise_project_id
 
string

企业项目ID。创建中转IP时,关联的企业项目ID。

200 transit_ips.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

查询中转IP列表成功。

示例 1
 
{
"transit_ips": [
{
"id": "3faa719d-6d18-4ccb-a5c7-33e65a09663e",
"project_id": "da261828016849188f4dcc2ef94d9da9",
"network_interface_id": "c91c43fb-8d66-48df-bfa9-b89053ac3737",
"enterprise_project_id": "2759da7b-8015-404c-ae0a-a389007b0e2a",
"gateway_id": "521bb3d9-8bed-4c6c-9ee8-669bd0620f76",
"ip_address": "192.168.1.68",
"created_at": "2019-04-29T03:41:59",
"updated_at": "2019-04-29T03:41:59",
"virsubnet_id": "49ee5fb5-75bf-4320-946e-b21ef4c9c9c1",
"tags": [
{
"key": "key1",
"value": "value1"
}
]
},
{
"id": "a2845109-3b2f-4627-b08f-09a726c0a6e7",
"project_id": "da261828016849188f4dcc2ef94d9da9",
"network_interface_id": "adebbdca-8c26-4c14-b34f-3f53cd2c42f2",
"enterprise_project_id": "2759da7b-8015-404c-ae0a-a389007b0e2a",
"gateway_id": "521bb3d9-8bed-4c6c-9ee8-669bd0620f76",
"ip_address": "192.168.1.58",
"created_at": "2019-04-29T02:16:09",
"updated_at": "2019-04-29T02:16:09",
"virsubnet_id": "333e5fb5-75bf-4320-946e-b21ef4c9c2g5",
"tags": [
{
"key": "key1",
"value": "value1"
}
]
}
],
"request_id": "747a911c17067a39692f75ac146fb47e"
}
SDK
点击 NAT网关 (NAT) SDK, 下载SDK或查看SDK文档。SDK的安装、认证方式等在SDK文档中对应语言类型的【使用】目录下。
错误码
请参考 错误码说明

 

上一篇:创建弹性云服务器(按需)CreatePostPaidServers 下一篇:通用计算型s6型弹性云服务器规格介绍

弹性公网IP EIP 

弹性公网IP(Elastic IP)提供独立的公网IP资源,包括公网IP地址与公网出口带宽服务。可以与弹性云服务器、裸金属服务器、虚拟IP、弹性负载均衡、NAT网关等资源灵活地绑定及解绑。拥有多种灵活的计费方式,可以满足各种业务场景的需要。