创建中转子网
功能介绍
创建中转子网。
调用方法
请参见如何调用API。
URI
POST /v3/{project_id}/private-nat/transit-subnets
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
项目ID |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
用户Token。 用户Token也就是调用获取用户Token获取请求认证接口的响应值，该接口是唯一不需要认证的接口。 请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
transit_subnet |
是 |
CreateTransitSubnetOption object |
创建中转子网请求体 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
name |
是 |
String |
中转子网的名字。仅支持数字、字母、_（下划线）、-（中划线）、中文。 |
|
description |
否 |
String |
中转子网的描述。长度范围小于等于255个字符，不能包含“<”和“>”。 |
|
virsubnet_id |
是 |
String |
中转子网的子网ID。 |
|
virsubnet_project_id |
是 |
String |
中转子网的子网所属的项目ID。仅支持数字和小写字母。 |
|
tags |
否 |
Array of Tag objects |
tag标签。 |
响应参数
状态码：201
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
transit_subnet |
TransitSubnet object |
中转子网的响应体 |
|
request_id |
String |
请求id |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
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 |
String |
中转子网创建时间，遵循UTC时间，格式是yyyy-mm-ddThh:mm:ssZ。 |
|
updated_at |
String |
中转子网更新时间，遵循UTC时间，格式是yyyy-mm-ddThh:mm:ssZ。 |
|
tags |
Array of Tag objects |
标签列表 |
请求示例
创建中转子网
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 |
错误码
请参见错误码。
