Modifies the name and description of a virtual private cloud (VPC).

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

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 2 to 256 characters in length. It must start with a letter but cannot start with http:// or https://.

VpcName String No Vpc-1

The new name of the VPC.

The name must be 2 to 128 characters in length, and can contain digits, periods (.), underscores (_), and hyphens (-). It must start with a letter and cannot start with http:// or https://.

CidrBlock String No 192.168.0.0/24

The IPv4 CIDR block of the VPC. The CIDR block can be 10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16, and their subnets. The subnet mask must be 8 to 24 bits in length.

RegionId String Yes cn-hangzhou

The ID of the region where the VPC is deployed.

EnableIPv6 Boolean No false

Specifies whether to enable IPv6 CIDR blocks. Valid values:

  • true: enables IPv6 CIDR blocks.
  • false(default): disables IPv6 CIDR blocks.
Ipv6CidrBlock String No 2408:XXXX:0:6a::/56

The IPv6 CIDR block of the VPC.

Ipv6Isp String No BGP

The Internet service provider (ISP) for IPv6 addresses of the VPC. Valid values:

  • BGP(default): Alibaba Cloud BGP IPv6
  • ChinaMobile: China Mobile (single line)
  • ChinaUnicom: China Unicom (single line)
  • ChinaTelecom: China Telecom (single line)
Note If your Alibaba Cloud account is allowed to activate single-ISP bandwidth, you can set the parameter to 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

https://vpc.aliyuncs.com/?Action=ModifyVpcAttribute
&RegionId=cn-hangzhou
&VpcId=vpc-bp1qtbach57ywecf****
&<Common request parameters>

Sample success responses

XML format

<ModifyVpcAttributeResponse>
      <RequestId>0ED8D006-F706-4D23-88ED-E11ED28DCAC0</RequestId>
</ModifyVpcAttributeResponse>

JSON format

{
    "RequestId": "43B72D30-25E1-4FA3-96A8-89374A521D1A"
}

Error codes

HttpCode Error code Error message Description
404 InvalidVpcId.NotFound Specified VPC does not exist. The error message returned because the specified VPC does not exist.
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 the state of the VPC does not support this operation.
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 still in use.
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 in Cloud Enterprise Network (CEN).
400 OperationUnsupported.CenIpv6Enabled The IPv6 feature is enabled in CEN. The error message returned because the IPv6 feature is already enabled in CEN.

For a list of error codes, visit the API Error Center.