修改指定VPC的配置信息。
接口说明
ModifyVpcAttribute 接口不支持并发修改同一个 VPC 的配置信息。
ModifyVpcAttribute 接口可以为 VPC 开启 IPv6，但是不能给已开启 IPv6 的 VPC 修改 IPv6 网段或 IPv6 地址段类型。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
vpc:ModifyVpcAttribute |
update |
*VPC
|
|
无 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| 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 网段内放大或缩小网段，网段掩码推荐使用 16~28 位。当您缩小 VPC 的 IPv4 网段时，如果有已经使用的 IP 地址在目标网段外，则会修改失败。 说明
修改 VPC 的 IPv4 网段，不会影响用户的存量业务。 |
192.168.0.0/24 |
| RegionId |
string |
否 |
VPC 所属的地域 ID。 您可以通过调用 DescribeRegions 接口获取地域 ID。 |
cn-hangzhou |
| EnableIPv6 |
boolean |
否 |
是否开启 IPv6。取值：
|
false |
| Ipv6CidrBlock |
string |
否 |
VPC 的 IPv6 网段。 为 VPC 开启 IPv6 时，系统将分配 IPv6 网段。如需指定 IPv6 网段，您需要先调用 AllocateVpcIpv6Cidr 接口预留指定的 IPv6 地址段，并将其传入。 说明
对于已开启 IPv6 的 VPC，无法通过传入本参数来修改 IPv6 网段。 |
2408:XXXX:0:6a::/56 |
| Ipv6Isp |
string |
否 |
VPC 的 IPv6 地址段类型，取值：
说明
如果是开通了单线带宽白名单的用户，该字段可以设置为 ChinaTelecom（中国电信）、ChinaUnicom（中国联通）和 ChinaMobile（中国移动）。 |
BGP |
| EnableDnsHostname |
boolean |
否 |
是否启用 DNS 主机名功能。取值：
|
false |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
请求 ID。 |
||
| RequestId |
string |
请求 ID。 |
43B72D30-25E1-4FA3-96A8-89374A521D1A |
示例
正常返回示例
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. | |
| 400 | InvalidVpcDiscription.Malformed | Specified VPC description is not valid. | |
| 400 | InvalidParameter | Specified UserCidr invalid format. | |
| 400 | InvalidUserCidr.Quota | Specified UserCidr number is greater than 3. | |
| 400 | InvalidUserCidr.Malformed | Specified UserCidr overlapping in of 100.64.0.0/10. | 该UserCidr和100.64.0.0/10重叠。 |
| 400 | InvalidVpcId.NotFound | Specified VPC name is not valid. | |
| 400 | IncorrectVpcStatus | Current VPC status does not support this operation. | |
| 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. | |
| 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 | 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互斥。 |
| 400 | UnsupportedFeature.VpcDnsHostname | The feature of vpc dns hostname is unsupported. | VPC私网域名功能在当前地域不生效 |
| 400 | OperationFailed.Ipv6RouteEntryUsing | VPC exist IPv6 Route Entry, cannot disable IPv6. | VPC存在IPv6路由,禁止关闭IPv6。 |
| 400 | OperationFailed.ModifyVpcDnsHostname | Operation failed because DnsHostName resource is in transient state, please try again later. | dns域名资源处于非稳态，请稍后重试。 |
| 400 | IncorrectStatus.VpcDnsHostnameStatus | The DnsHostname status of vpc does not support this operation. | 当前VPC的私网域名状态不支持该操作。 |
| 400 | OperationFailed.ConflictWithSecondaryCidr | The modified cidr is conflict with the secondary cidr. | |
| 400 | IllegalParam.CidrBlock | The param of CidrBlock [%s] is illegal. | CidrBlock非法 |
| 404 | InvalidVpcId.NotFound | Specified VPC does not exist. |
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。