修改指定VPC的名称和描述信息。
接口说明
- ModifyVpcAttribute 接口不支持并发修改同一个 VPC 的名称和描述信息。
- ModifyVpcAttribute 接口可以为 VPC 开通 IPv6，但是不能给已开通 IPv6 的 VPC 修改 IPv6 网段或 IPv6 地址段类型。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：
- 操作：是指具体的权限点。
- 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
- 资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用背景高亮的方式表示。
- 对于不支持资源级授权的操作，用
全部资源表示。
- 条件关键字：是指云产品自身定义的条件关键字。
- 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。
| 操作 | 访问级别 | 资源类型 | 条件关键字 | 关联操作 |
|---|---|---|---|---|
| vpc:ModifyVpcAttribute | update | *VPC acs:vpc:{#regionId}:{#accountId}:vpc/{#VpcId} |
| 无 |
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| VpcId | string | 是 | 要修改信息的 VPC 的 ID。 | vpc-bp1qtbach57ywecf**** |
| Description | string | 否 | 要修改的 VPC 描述信息。 描述长度为 1～256 个字符，不能以 | This is my VPC. |
| VpcName | string | 否 | 要修改的 VPC 名称。 名称长度为 1～128 个字符，不能以 | Vpc-1 |
| CidrBlock | string | 否 | 要修改的 VPC 的 IPv4 网段。 您可以在 VPC 原 IPv4 网段内放大或缩小网段，且网段支持的掩码为 8～28 位。当您缩小 VPC 的 IPv4 网段时，如果有已经使用的 IP 地址在目标网段外，则会修改失败。 说明
修改 VPC 的网段，不会影响用户的存量业务。
| 192.168.0.0/24 |
| RegionId | string | 否 | VPC 所属的地域 ID。 您可以通过调用 DescribeRegions 接口获取地域 ID。 | cn-hangzhou |
| EnableIPv6 | boolean | 否 | 是否开启了 IPv6 网段。取值：
| false |
| Ipv6CidrBlock | string | 否 | VPC 的 IPv6 网段。 | 2408:XXXX:0:6a::/56 |
| Ipv6Isp | string | 否 | VPC 的 IPv6 地址段类型，取值：
说明
如果是开通了单线带宽白名单的用户，该字段可以设置为 ChinaTelecom（中国电信）、ChinaUnicom（中国联通）和 ChinaMobile（中国移动）。
| BGP |
返回参数
示例
正常返回示例
JSON格式
{
"RequestId": "43B72D30-25E1-4FA3-96A8-89374A521D1A"
}错误码
| HTTP status code | 错误码 | 错误信息 | 描述 |
|---|---|---|---|
| 400 | Forbidden.VpcNotFound | Specified VPC does not exist. | - |
| 400 | InvalidDescription.Malformed | description not valid.. | - |
| 400 | InvalidVpcName.Malformed | Specified VPC name is not valid. | 专有网络VPC名称格式不正确，请您修复VPC的格式后再重试。 |
| 400 | InvalidVpcDiscription.Malformed | Specified VPC description is not valid. | 该VPC描述的格式不符合要求。 |
| 400 | InvalidParameter | Specified UserCidr invalid format. | 该用户侧网段格式不正确。 |
| 400 | InvalidParameter | Specified UserCidr Subnet mask is not valid . | 该用户侧网段的子网掩码不合法。 |
| 400 | InvalidUserCidr.Quota | Specified UserCidr number is greater than 3. | Usercidr达到配额限制。 |
| 400 | InvalidUserCidr.Malformed | Specified UserCidr overlapping in of 100.64.0.0/10. | 该UserCidr和100.64.0.0/10重叠。 |
| 400 | InvalidUserCidr.Malformed | Specified UserCidr status is wrong, do not allow operation | - |
| 400 | InvalidVpcId.NotFound | Specified VPC name is not valid. | - |
| 400 | IncorrectVpcStatus | Current VPC status does not support this operation. | 当前VPC的状态无法支持这个操作。 |
| 400 | IllegalCidrBlock | Some subnet cidrBlock is not in the cidrBlock. | - |
| 400 | InvalidRegion.Malformed | Specified RegionId is not vaild. | - |
| 400 | InvalidCidrBlock.Malformed | Specified CIDR block is not valid. | 该CIDR格式不正确。 |
| 400 | OperationUnsupported.DisableIpv6 | %s | - |
| 400 | OperationUnsupported.Ipv6Feature | %s | - |
| 400 | ParamExclusive.EnableIpv6AndCidrBlock | EnableIpv6 and CidrBlock is mutually exclusive. | - |
| 400 | OperationFailed.ClassicLinkEnabled | Operation failed because classicLink is enabled. | - |
| 400 | OperationFailed.IpV6VSwitchInuse | %s | - |
| 400 | OperationFailed.Ipv6GatewayInUse | The IPv6 gateway is in use. | 无法修改VPC属性，因为IPv6网关仍在使用中。 |
| 400 | OperationFailed.QueryCenIpv6Status | Failed to query the IPv6 status of the specified VPC in CEN. | 查询CEN中该VPC的IPv6状态失败。 |
| 400 | OperationUnsupported.CenIpv6Enabled | The IPv6 feature is enabled in CEN. | IPv6功能在CEN中已被打开。 |
| 400 | UnsupportedFeature.Ipv6Isp | The Ipv6Isp feature is not supported. | 指定的Ipv6Isp特性不支持。 |
| 400 | ResourceNotEnough.Ipv6Cidr | The specified resource ipv6 cidr is not enough. | 指定的IPv6网段资源不足。 |
| 400 | OperationFailed.IPv6CidrNotReserved | The IPv6 CIDR block is not reserved. | 操作失败，未预留该IPv6地址段。 |
| 400 | OperationUnsupported.Ipv6Feature | The IPv6 feature is not supported in the region. | 当前地域不支持Ipv6特性。 |
| 400 | IllegalParam.Ipv6Cidr | The specified Ipv6CidrBlock is invalid. | 指定的Ipv6CidrBlock非法。 |
| 400 | InvalidIpv6Instance.NotFound | The specified resource of InvalidIpv6Instance is not found. | 未找到指定的Ipv6Instance资源。 |
| 400 | ExclusiveParam.EnableIpv6AndCidrBlock | The param of EnableIpv6 and CidrBlock are mutually exclusive. | 参数EnableIpv6和CidrBlock互斥。 |
| 404 | InvalidVpcId.NotFound | Specified VPC does not exist. | 该VPC不存在。 |
访问错误中心查看更多错误码。
变更历史
| 变更时间 | 变更内容概要 | 操作 |
|---|---|---|
| 2024-10-10 | OpenAPI 错误码发生变更、OpenAPI 入参发生变更 | 查看变更详情 |
| 2024-08-27 | OpenAPI 错误码发生变更、OpenAPI 入参发生变更 | 查看变更详情 |
| 2024-08-06 | OpenAPI 错误码发生变更 | 查看变更详情 |
| 2024-02-01 | OpenAPI 错误码发生变更 | 查看变更详情 |
| 2023-12-14 | OpenAPI 错误码发生变更 | 查看变更详情 |
| 2023-09-21 | OpenAPI 描述信息更新、OpenAPI 错误码发生变更 | 查看变更详情 |
| 2023-07-05 | OpenAPI 错误码发生变更 | 查看变更详情 |