创建子网预留网段 - CreateVirsubnetCidrReservation

project_id

是

String

参数解释：

项目ID。获取方式请参见获取项目ID。

取值范围：

不涉及。

dry_run

否

Boolean

参数解释：

是否只预检此次请求。

约束限制：

不涉及。

取值范围：

• true：发送检查请求，不会创建子网预留网段。检查项包括是否填写了必需参数、请求格式、业务限制。如果检查不通过，则返回对应错误。如果检查通过，则返回响应码202。

• false：发送正常请求，并直接创建子网预留网段。

默认取值：

false

virsubnet_cidr_reservation

是

CreateVirsubnetCidrReservationOption object

参数解释：

创建子网预留网段的请求体。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

virsubnet_id

是

String

参数解释：

子网预留网段所属的子网ID。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

ip_version

是

Integer

参数解释：

子网预留网段的IP版本，支持IPv4和IPv6。

约束限制：

不涉及。

取值范围：

• 4：表示IPv4。

• 6：表示IPv6。

默认取值：

不涉及。

cidr

否

String

参数解释：

子网预留网段的IP网段。

约束限制：

• CIDR格式，掩码长度最小值为“所属子网的网段掩码 + 2”，最大值为32（IPv4）或128（IPv6）。

• cidr和mask参数必须输入一个，两者同时输入时不能冲突。

• 子网预留网段不能包含所属子网的已使用的地址和系统预留地址（子网的第1个和最后2个地址）。

取值范围：

不涉及。

默认取值：

不涉及。

mask

否

Integer

参数解释：

子网预留网段的IP网段掩码长度。

约束限制：

• 整数，预留网段的掩码长度最小值为“所属子网的网段掩码 + 2”，最大值为32（IPv4）或128（IPv6）。

• cidr和mask参数必须输入一个，两者同时输入时不能冲突。

• 子网预留网段不能包含所属子网的已使用的地址和系统预留地址（子网的第1个和最后2个地址）。

• 指定掩码长度创建预留网段，最后mask与子网掩码的差值长度的bit位由系统自动分配，例如子网cidr为192.168.21.0/24，子网掩码长度24，指定预留网段长度为27，差值长度27 - 24 = 3，即第25,26,27这3个bit位由系统自动分配。例如：

  • 第25-27的bit位分配为011，最终创建出的子网预留网段cidr是192.168.21.96/27，其中96转为二进制是0110 0000；

  • 第25-27的bit位分配为110，最终创建出的子网预留网段cidr是192.168.21.192/27，其中192转为二进制是1100 0000。

取值范围：

不涉及。

默认取值：

不涉及。

name

否

String

参数解释：

子网预留网段的名称。

约束限制：

1-64个字符，支持数字、字母、中文、_(下划线)、-（中划线）、.（点）。

取值范围：

不涉及。

默认取值：

不涉及。

description

否

String

参数解释：

子网预留网段的描述信息。

约束限制：

0-255个字符，不能包含“<”和“>”。

取值范围：

不涉及。

默认取值：

不涉及。

request_id

String

参数解释：

请求ID。

取值范围：

不涉及。

virsubnet_cidr_reservation

VirsubnetCidrReservation object

参数解释：

创建子网预留网段的响应体。

取值范围：

不涉及。

id

String

参数解释：

子网预留网段的资源ID。子网预留网段创建成功后，会生成一个子网预留网段 ID，是子网预留网段对应的唯一标识。

取值范围：

带“-”的标准UUID格式。

virsubnet_id

String

参数解释：

子网预留网段所在子网的ID。

取值范围：

带“-”的标准UUID格式。

vpc_id

String

参数解释：

子网预留网段所在VPC的ID。

取值范围：

带“-”的标准UUID格式。

ip_version

Integer

参数解释：

子网预留网段的IP版本。

取值范围：

• 4：IPv4

• 6：IPv6

cidr

String

参数解释：

子网预留网段的IP网段。

取值范围：

CIDR格式，掩码长度最小值为“所属子网的网段掩码 + 2”，最大值为32（IPv4）或128（IPv6）。

name

String

参数解释：

子网预留网段的名称。

取值范围：

1-64个字符，支持数字、字母、中文、_(下划线)、-（中划线）、.（点）。

description

String

参数解释：

子网预留网段的描述信息。

取值范围：

0-255个字符，不能包含“<”和“>”。

project_id

String

参数解释：

子网预留网段所属的项目ID。

取值范围：

不涉及。

created_at

String

参数解释：

子网预留网段的创建时间。

取值范围：

UTC时间格式，yyyy-MM-ddTHH:mm:ssZ。

updated_at

String

参数解释：

子网预留网段最近一次更新的时间。

取值范围：

UTC时间格式，yyyy-MM-ddTHH:mm:ssZ。

201

POST操作正常返回，更多状态码请参见状态码。