Modifies the name and description of a virtual private cloud (VPC).
Usage notes
You cannot repeatedly call the ModifyVpcAttribute operation to modify the name and description of a VPC within the specified period of time.
Debugging
Request parameters
Parameter | Type | Required | Example | Description |
---|---|---|---|---|
Action | String | Yes | ModifyVpcAttribute | The operation that you want to perform. Set the value to ModifyVpcAttribute. |
VpcId | String | Yes | vpc-bp1qtbach57ywecf**** | The ID of the VPC that you want to modify. |
Description | String | No | This is my VPC. | The new description of the VPC. The description must be 1 to 256 characters in length, and cannot start with |
VpcName | String | No | Vpc-1 | The new name of the VPC. The name must be 1 to 128 characters in length, and cannot start with |
CidrBlock | String | No | 192.168.0.0/24 | The new IPv4 CIDR block of the VPC. You can specify a larger or smaller IPv4 CIDR block than the IPv4 CIDR block of the VPC. The subnet mask must be 8 to 28 bits in length. If you specify a smaller IPv4 CIDR block and existing IP addresses do not fall within the CIDR block, the modification fails. Note Your services are not affected when you modify the VPC CIDR block. |
RegionId | String | No | cn-hangzhou | The region ID of the VPC. You can call the DescribeRegions operation to query the most recent region list. |
EnableIPv6 | Boolean | No | false | Specifies whether to enable IPv6 CIDR blocks. Valid values:
|
Ipv6CidrBlock | String | No | 2408:XXXX:0:6a::/56 | The IPv6 CIDR block of the VPC. |
Ipv6Isp | String | No | BGP | The type of IPv6 CIDR block. Valid values:
Note If your Alibaba Cloud account is allowed to use single-ISP bandwidth, valid values are: ChinaTelecom, ChinaUnicom, and ChinaMobile. |
Response parameters
Parameter | Type | Example | Description |
---|---|---|---|
RequestId | String | 43B72D30-25E1-4FA3-96A8-89374A521D1A | The ID of the request. |
Examples
Sample requests
http(s)://[Endpoint]/?Action=ModifyVpcAttribute
&VpcId=vpc-bp1qtbach57ywecf****
&Description=This is my VPC.
&VpcName=Vpc-1
&CidrBlock=192.168.0.0/24
&RegionId=cn-hangzhou
&EnableIPv6=false
&Ipv6CidrBlock=2408:XXXX:0:6a::/56
&Ipv6Isp=BGP
&Common request parameters
Sample success responses
XML
format
HTTP/1.1 200 OK
Content-Type:application/xml
<ModifyVpcAttributeResponse>
<RequestId>43B72D30-25E1-4FA3-96A8-89374A521D1A</RequestId>
</ModifyVpcAttributeResponse>
JSON
format
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "43B72D30-25E1-4FA3-96A8-89374A521D1A"
}
Error codes
HttpCode | Error code | Error message | Description |
---|---|---|---|
400 | InvalidVpcName.Malformed | Specified VPC name is not valid. | The error message returned because the format of the VPC name is invalid. Enter a valid VPC name and try again. |
400 | InvalidVpcDiscription.Malformed | Specified VPC description is not valid. | The error message returned because the format of the VPC description is invalid. |
400 | InvalidParameter | Specified UserCidr invalid format. | The error message returned because the format of the user CIDR block is invalid. |
400 | InvalidParameter | Specified UserCidr Subnet mask is not valid . | The error message returned because the subnet mask of the user CIDR block is invalid. |
400 | InvalidUserCidr.Quota | Specified UserCidr number is greater than 3. | The error message returned because the UserCidr value has reached the upper limit. |
400 | InvalidUserCidr.Malformed | Specified UserCidr overlapping in of 100.64.0.0/10. | The error message returned because the UserCidr value overlaps with 100.64.0.0/10. |
400 | IncorrectVpcStatus | Current VPC status does not support this operation. | The error message returned because this operation cannot be performed when the VPC is in the current state. |
400 | InvalidCidrBlock.Malformed | Specified CIDR block is not valid. | The error message returned because the format of the specified CIDR block is invalid. |
400 | OperationFailed.Ipv6GatewayInUse | The IPv6 gateway is in use. | The error message returned because the IPv6 gateway is in use and you cannot modify the VPC. |
400 | OperationFailed.QueryCenIpv6Status | Failed to query the IPv6 status of the specified VPC in CEN. | The error message returned because the system failed to query the IPv6 status of the VPC that is attached to the Cloud Enterprise Network (CEN) instance. |
400 | OperationUnsupported.CenIpv6Enabled | The IPv6 feature is enabled in CEN. | The error message returned because the IPv6 feature is already enabled for the CEN instance. |
404 | InvalidVpcId.NotFound | Specified VPC does not exist. | The error message returned because the specified VPC does not exist. |
For a list of error codes, see Service error codes.