文档首页/ 虚拟私有云 VPC/ API参考/ API V3/ 子网预留网段/ 更新子网预留网段 - UpdateVirsubnetCidrReservation
更新时间：2025-11-07 GMT+08:00
在线调试
CLI示例
查看PDF
分享

更新子网预留网段 - UpdateVirsubnetCidrReservation

功能介绍

当您的子网预留网段创建成功后，您可以通过调用该接口更新子网预留网段的基本信息，包括子网预留网段的名称、描述信息。

调用方法

请参见如何调用API。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
  • 如果使用身份策略授权，需具备如下身份策略权限。

    授权项

    访问级别

    资源类型（*为必须）

    条件键

    别名

    依赖的授权项

    vpc:subnets:updateReservation

    Write

    subnet *

    • g:ResourceTag/<tag-key>

    • vpc:VirsubnetCidrReservationId

    • g:EnterpriseProjectId

    -

    -

URI

PUT /v3/{project_id}/vpc/virsubnet-cidr-reservations/{virsubnet_cidr_reservation_id}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释：

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

取值范围：

不涉及。

virsubnet_cidr_reservation_id

是

String

参数解释：

子网预留网段的资源ID。

取值范围：

不涉及。

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

dry_run

否

Boolean

参数解释：

是否只预检此次请求。

约束限制：

不涉及。

取值范围：

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

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

默认取值：

false

virsubnet_cidr_reservation

是

UpdateVirsubnetCidrReservationOption object

参数解释：

更新子网预留网段的请求体。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。
表3 UpdateVirsubnetCidrReservationOption

参数

是否必选

参数类型

描述

name

否

String

参数解释：

子网预留网段的名称。

约束限制：

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

取值范围：

不涉及。

默认取值：

不涉及。

description

否

String

参数解释：

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

约束限制：

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

取值范围：

不涉及。

默认取值：

不涉及。

响应参数

状态码：200

表4 响应Body参数

参数

参数类型

描述

request_id

String

参数解释：

请求ID。

取值范围：

不涉及。

virsubnet_cidr_reservation

VirsubnetCidrReservation object

参数解释：

更新子网预留网段的响应体。

取值范围：

不涉及。
表5 VirsubnetCidrReservation

参数

参数类型

描述

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。

请求示例

更新id为ed4edb94-754c-7848-bb77-2d381906c535的子网预留网段，名称更新为name-test-updated，描述更新为description-test-updated。

PUT https://{Endpoint}/v3/{project_id}/vpc/virsubnet-cidr-reservations/ed4edb94-754c-7848-bb77-2d381906c535

{
  "virsubnet_cidr_reservation" : {
    "name" : "name-test-updated",
    "description" : "description-test-updated"
  }
}

响应示例

状态码：200

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

{
  "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" : "name-test-updated",
    "description" : "description-test-updated",
    "project_id" : "11e8dd119c77479db890e266e68c1ecf",
    "created_at" : "2024-09-09T11:56:27Z",
    "updated_at" : "2024-09-09T12:00:06Z"
  },
  "request_id" : "5e8c57bcfa0bd4798915cb5d7a37c1d9"
}

状态码

状态码

描述

200

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

错误码

请参见错误码。

父主题： 子网预留网段

相关文档