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

创建中转子网

功能介绍

创建中转子网。

调用方法

请参见如何调用API

URI

POST /v3/{project_id}/private-nat/transit-subnets

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

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

表3 请求Body参数

参数

是否必选

参数类型

描述

transit_subnet

CreateTransitSubnetOption object

创建中转子网请求体

表4 CreateTransitSubnetOption

参数

是否必选

参数类型

描述

name

String

中转子网的名字。仅支持数字、字母、_(下划线)、-(中划线)、中文。

description

String

中转子网的描述。长度范围小于等于255个字符,不能包含“<”和“>”。

virsubnet_id

String

中转子网的子网ID。

virsubnet_project_id

String

中转子网的子网所属的项目ID。仅支持数字和小写字母。

tags

Array of Tag objects

tag标签。

表5 Tag

参数

是否必选

参数类型

描述

key

String

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

value

String

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

响应参数

状态码:201

表6 响应Body参数

参数

参数类型

描述

transit_subnet

TransitSubnet object

中转子网的响应体

request_id

String

请求id

表7 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

标签列表

表8 Tag

参数

参数类型

描述

key

String

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

value

String

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

请求示例

创建中转子网

POST https://{Endpoint}/v3/70505c941b9b4dfd82fd351932328a2f/private-nat/transit-subnets

{
  "transit_subnet" : {
    "name" : "transit-subnet_t1",
    "description" : "transit-subnet-description",
    "virsubnet_id" : "2759da7b-8015-404c-ae0a-a389007b0e2a",
    "virsubnet_project_id" : "aea5011c0bc2454d8645a560345da810",
    "tags" : [ {
      "key" : "key1",
      "value" : "value1"
    } ]
  }
}

响应示例

状态码:201

创建中转子网成功

{
  "request_id" : "9882046a9b96f1405472e36d797e33dc",
  "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"
    } ]
  }
}

状态码

状态码

描述

201

创建中转子网成功

400

Bad Request

409

Conflict

错误码

请参见错误码

相关文档