文档首页/ 虚拟私有云 VPC/ API参考/ API V3/ VPC/ 添加VPC扩展网段
更新时间：2025-02-07 GMT+08:00
查看PDF
分享

添加VPC扩展网段

功能介绍

添加VPC的扩展网段。

URI

PUT /v3/{project_id}/vpc/vpcs/{vpc_id}/add-extend-cidr

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID。

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

vpc_id

是

String

VPC资源ID。

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

dry_run

否

Boolean

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

  • 取值范围：

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

    • false（默认值）：发送正常请求，并直接添加VPC扩展网段。

vpc

是

AddExtendCidrOption object

添加VPC扩展网段请求体。
表3 AddExtendCidrOption

参数

是否必选

参数类型

描述

extend_cidrs

是

Array of strings

  • 功能说明：扩展cidr列表。

  • 取值范围：不能包含以下网段

    • 100.64.0.0/10

    • 214.0.0.0/7

    • 198.18.0.0/15

    • 169.254.0.0/16

    • 0.0.0.0/8

    • 127.0.0.0/8

    • 240.0.0.0/4

    • 172.31.0.0/16

    • 192.168.0.0/16

    • 255.255.255.255/32

响应参数

状态码：200

表4 响应Body参数

参数

参数类型

描述

request_id

String

请求ID。

vpc

Vpc object

添加VPC扩展网段响应体。
表5 Vpc

参数

参数类型

描述

id

String

  • 功能描述：VPC对应的唯一标识。

  • 取值范围：带“-”的UUID格式。

name

String

  • 功能说明：VPC对应的名称。

  • 取值范围：0-64个字符，支持数字、字母、中文、_(下划线)、-（中划线）、.（点）。

description

String

  • 功能说明：VPC的描述信息。

  • 取值范围：0-255个字符，不能包含“<”和“>”。

cidr

String

  • 功能说明：VPC下可用子网的范围。

  • 取值范围：

    • 10.0.0.0/8~10.255.255.240/28

    • 172.16.0.0/12 ~ 172.31.255.240/28

    • 192.168.0.0/16 ~ 192.168.255.240/28

    • 不指定cidr时，默认值为“”。

  • 约束：必须是ipv4 cidr格式，例如:192.168.0.0/16。

extend_cidrs

Array of strings

  • 功能描述：VPC的扩展网段。

  • 约束：目前只支持ipv4。

status

String

  • 功能说明：VPC对应的状态。

  • 取值范围：

    • PENDING：创建中。

    • ACTIVE：创建成功。

project_id

String

  • 功能说明：VPC所属的项目ID。

enterprise_project_id

String

  • 功能说明：VPC所属的企业项目ID。

  • 取值范围：最大长度36字节，带“-”连字符的UUID格式，或者是字符串“0”。“0”表示默认企业项目。

created_at

String

  • 功能说明：VPC创建时间。

  • 取值范围：UTC时间格式，yyyy-MM-ddTHH:mm:ssZ。

updated_at

String

  • 功能说明：VPC更新时间。

  • 取值范围：UTC时间格式，yyyy-MM-ddTHH:mm:ssZ。

cloud_resources

Array of CloudResource objects

  • 功能说明：VPC关联资源类型和数量。

  • 取值范围：目前只返回VPC关联的routetable和virsubnet。virsubnet数量为ipv4和ipv6子网总数。

tags

Array of Tag objects

  • 功能说明：VPC的标签信息，详情参见Tag对象。

  • 取值范围：0-20个标签键值对。
表6 CloudResource

参数

参数类型

描述

resource_type

String

  • 功能描述：资源类型。

resource_count

Integer

  • 功能说明：资源数量。

缺省值：0
表7 Tag

参数

参数类型

描述

key

String

  • 功能说明：标签键。

  • 取值范围：

    • 最大长度36个unicode字符。 key不能为空。

    • 同一资源的key不能重复。

    • 可以包含的字符范围：

      • 英文字母

      • 数字

      • 特殊字符：下划线（_）、中划线（-）

      • 中文字符

value

String

  • 功能描述：标签值。

  • 取值范围：

    • 每个值最大长度43个unicode字符，value可以为空。

    • 可以包含的字符范围：

      • 英文字母

      • 数字

      • 特殊字符：下划线（_）、中划线（-）、点（.）

      • 中文字符

状态码：202

表8 响应Body参数

参数

参数类型

描述

request_id

String

请求ID。

error_msg

String

错误消息。

error_code

String

错误码。

请求示例

添加扩展网段，vpc id为99d9d709-8478-4b46-9f3f-2206b1023fd3，添加的扩展网段为23.8.0.0/16。

PUT https://{Endpoint}/v3/{project_id}/vpc/vpcs/99d9d709-8478-4b46-9f3f-2206b1023fd3/add-extend-cidr

{
  "vpc" : {
    "extend_cidrs" : [ "23.8.0.0/16" ]
  }
}

响应示例

状态码：200

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

{
  "request_id" : "84eb4f775d66dd916db121768ec55626",
  "vpc" : {
    "id" : "0552091e-b83a-49dd-88a7-4a5c86fd9ec3",
    "name" : "vpc1",
    "description" : "test1",
    "cidr" : "192.168.0.0/16",
    "extend_cidrs" : [ "23.8.0.0/16" ],
    "enterprise_project_id" : "0",
    "tags" : [ {
      "key" : "key",
      "value" : "value"
    } ],
    "cloud_resources" : [ {
      "resource_type" : "routetable",
      "resource_count" : 1
    } ],
    "status" : "ACTIVE",
    "project_id" : "060576782980d5762f9ec014dd2f1148",
    "created_at" : "2018-03-23T09:26:08",
    "updated_at" : "2018-08-24T08:49:53"
  }
}

状态码：202

API V3的指定预检请求正常返回，更多状态码请参见状态码。

{
  "error_msg" : "Request validation has been passed with dry run...",
  "error_code" : "SYS.0202",
  "request_id" : "cfd81aea3f59eac7128dba4b36d516c8"
}

状态码

状态码

描述

200

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

202

API V3的指定预检请求正常返回，更多状态码请参见状态码。

错误码

请参见错误码。

父主题： VPC