更新时间:2025-07-04 GMT+08:00
分享

查询指定的中转子网详情

功能介绍

查询指定的中转子网详情。

调用方法

请参见如何调用API

URI

GET /v3/{project_id}/private-nat/transit-subnets/{transit_subnet_id}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID。

transit_subnet_id

String

中转子网ID。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

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

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

transit_subnet

TransitSubnet object

中转子网的响应体

request_id

String

请求ID

表4 TransitSubnet

参数

参数类型

描述

id

String

中转子网的ID

name

String

中转子网的名称

description

String

中转子网的描述

virsubnet_project_id

String

中转子网的子网所属的项目ID

project_id

String

项目ID

vpc_id

String

中转子网的子网所属VPC的ID

virsubnet_id

String

中转子网的子网ID

cidr

String

中转子网的子网网段

type

String

中转子网类型。取值范围:VPC

status

String

中转子网状态。取值范围:ACTIVE: 当前资源状态正常。

ip_count

Integer

当前中转子网下已分配的中转子网IP数量。

created_at

DateTime

中转子网创建时间,遵循UTC时间,格式是yyyy-mm-ddThh:mm:ssZ。

updated_at

DateTime

中转子网更新时间,遵循UTC时间,格式是yyyy-mm-ddThh:mm:ssZ。

tags

Array of Tag objects

标签列表

表5 Tag

参数

参数类型

描述

key

String

键。最大长度128个unicode字符。key不能为空。

value

String

值。每个值最大长度255个unicode字符。

请求示例

响应示例

状态码:200

查询指定的中转子网成功

{
  "transit_subnet" : {
    "id" : "48b55781-306c-4a90-9cc0-d376337fae4f",
    "name" : "transit-subnet_t1",
    "description" : "transit-subnet-description",
    "virsubnet_project_id" : "aea5011c0bc2454d8645a560345da810",
    "project_id" : "aea5011c0bc2454d8645a560345da810",
    "vpc_id" : "f9169a4f-5f0a-41ce-b2a3-834c15b038c2",
    "virsubnet_id" : "2759da7b-8015-404c-ae0a-a389007b0e2a",
    "cidr" : "192.168.1.0/24",
    "type" : "VPC",
    "status" : "ACTIVE",
    "ip_count" : 0,
    "created_at" : "2021-07-01T09:15:54Z",
    "updated_at" : "2021-04-01T09:15:54Z",
    "tags" : [ {
      "key" : "key1",
      "value" : "value1"
    } ]
  },
  "request_id" : "747a911c17067a39692f75ac146fb47e"
}

状态码

状态码

描述

200

查询指定的中转子网成功

400

Bad Request

错误码

请参见错误码

相关文档