更新时间:2025-08-19 GMT+08:00

创建子网预留网段

功能介绍

创建子网预留网段。

调用方法

请参见如何调用API

URI

POST /v3/{project_id}/vpc/virsubnet-cidr-reservations

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID。

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

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

dry_run

Boolean

  • 功能说明:是否只预检此次请求。

  • 取值范围:

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

    • false(默认值):发送正常请求,并直接创建子网预留网段。

virsubnet_cidr_reservation

CreateVirsubnetCidrReservationOption object

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

表3 CreateVirsubnetCidrReservationOption

参数

是否必选

参数类型

描述

virsubnet_id

String

  • 功能说明:子网预留网段所属虚拟子网ID。

ip_version

Integer

  • 功能说明:子网预留网段的IP版本,支持IPv4和IPv6。

  • 取值范围

    • 4,表示IPv4。

    • 6,表示IPv6。

cidr

String

  • 功能说明:子网预留网段。

  • 取值范围:CIDR格式,掩码长度最小值为“所属子网的网段掩码 + 2”,最大值为32(IPv4)或128(IPv6)。

  • 使用说明:

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

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

mask

Integer

  • 功能说明:子网预留网段的掩码长度。

  • 取值范围:整数,预留网段的掩码长度最小值为“所属子网的网段掩码 + 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个字符,不能包含“<”和“>”。

响应参数

状态码:201

表4 响应Body参数

参数

参数类型

描述

request_id

String

请求ID。

virsubnet_cidr_reservation

VirsubnetCidrReservation object

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

表5 VirsubnetCidrReservation

参数

参数类型

描述

id

String

  • 功能描述:子网预留网段对应的唯一标识。

  • 取值范围:带“-”的标准UUID格式。

virsubnet_id

String

  • 功能描述:子网预留网段所在虚拟子网的ID。

  • 取值范围:带“-”的标准UUID格式。

vpc_id

String

  • 功能描述:子网预留网段所在VPC的ID。

  • 取值范围:带“-”的标准UUID格式。

ip_version

Integer

  • 功能描述:子网预留网段的IP版本。

  • 取值范围:

    • 4,IPv4

    • 6,IPv6

cidr

String

  • 功能说明:子网预留网段。

  • 取值范围: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。

请求示例

创建子网预留网段,所属虚拟子网ID为fb0e2bd6-190f-0d1a-7728-a5f6b1d8dd19,IPv4版本,指定预留网段cidr为192.168.21.96/28,指定名称为test,描述为for test。

POST https://{Endpoint}/v3/{project_id}/vpc/virsubnet-cidr-reservations

{
  "virsubnet_cidr_reservation" : {
    "virsubnet_id" : "fb0e2bd6-190f-0d1a-7728-a5f6b1d8dd19",
    "ip_version" : 4,
    "cidr" : "192.168.21.96/28",
    "name" : "test",
    "description" : "for test"
  }
}

响应示例

状态码:201

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

{
    "virsubnet_cidr_reservation": {
        "id": "ed4edb94-754c-7848-bb77-2d381906c535",
        "virsubnet_id": "fb0e2bd6-190f-0d1a-7728-a5f6b1d8dd19",
        "vpc_id": "cef5d621-6c20-d5df-74e8-746271fba734",
        "ip_version": 4,
        "cidr": "192.168.21.96/28",
        "name": "test",
        "description": "for test",
        "project_id": "11e8dd119c77479db890e266e68c1ecf",
        "created_at": "2024-09-09T11:56:27Z",
        "updated_at": "2024-09-09T11:56:27Z",
    },
    "request_id": "fd48620df5f57b04917f2cc5ebeaf277"
}

状态码

状态码

描述

201

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

错误码

请参见错误码