更新子网预留网段
功能介绍
当您的子网预留网段创建成功后,您可以通过调用该接口更新子网预留网段的基本信息,包括子网预留网段的名称、描述信息。
调用方法
请参见如何调用API。
URI
PUT /v3/{project_id}/vpc/virsubnet-cidr-reservations/{virsubnet_cidr_reservation_id}
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
参数解释: 项目ID。获取方式请参见获取项目ID。 取值范围: 不涉及。 |
virsubnet_cidr_reservation_id |
是 |
String |
参数解释: 子网预留网段的资源ID。 取值范围: 不涉及。 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
dry_run |
否 |
Boolean |
参数解释: 是否只预检此次请求。 约束限制: 不涉及。 取值范围:
默认取值: false |
virsubnet_cidr_reservation |
是 |
参数解释: 更新子网预留网段的请求体。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
响应参数
状态码:200
参数 |
参数类型 |
描述 |
---|---|---|
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版本。 取值范围:
|
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操作正常返回,更多状态码请参见状态码。 |
错误码
请参见错误码。