调用ModifyVpcAttribute接口修改指定VPC的名称和描述信息。

使用说明

ModifyVpcAttribute接口不支持并发修改同一个VPC的名称和描述信息。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String ModifyVpcAttribute

系统规定参数。取值:ModifyVpcAttribute

VpcId String vpc-bp1qtbach57ywecf****

要修改信息的VPC的ID。

Description String This is my VPC.

要修改的VPC描述信息。

描述长度为1~256个字符,不能以http://https://开头。

VpcName String Vpc-1

要修改的VPC名称。

名称长度为1~128个字符,不能以http://https://开头。

CidrBlock String 192.168.0.0/24

要修改的VPC的IPv4网段。

您可以在VPC原IPv4网段内放大或缩小网段,且网段支持的掩码为8~28位。当您缩小VPC的IPv4网段时,如果有已经使用的IP地址在目标网段外,则会修改失败。

说明 修改VPC的网段,不会影响用户的存量业务。
RegionId String cn-hangzhou

VPC所属的地域ID。

您可以通过调用DescribeRegions接口获取地域ID。

EnableIPv6 Boolean false

是否开启了IPv6网段。取值:

  • true:开启。
  • false(默认值):关闭。
Ipv6CidrBlock String 2408:XXXX:0:6a::/56

VPC的IPv6网段。

Ipv6Isp String BGP

VPC的IPv6地址段类型,取值:

  • BGP(默认值):阿里云BGP IPv6。
  • ChinaMobile:中国移动(单线)。
  • ChinaUnicom:中国联通(单线)。
  • ChinaTelecom:中国电信(单线)。
说明 如果是开通了单线带宽白名单的用户,该字段可以设置为ChinaTelecom(中国电信)、ChinaUnicom(中国联通)和ChinaMobile(中国移动)。

返回数据

名称 类型 示例值 描述
RequestId String 43B72D30-25E1-4FA3-96A8-89374A521D1A

请求ID。

示例

请求示例

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
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<ModifyVpcAttributeResponse>
    <RequestId>43B72D30-25E1-4FA3-96A8-89374A521D1A</RequestId>
</ModifyVpcAttributeResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

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

错误码

HttpCode 错误码 错误信息 描述
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 IncorrectVpcStatus Current VPC status does not support this operation. 当前VPC的状态无法支持这个操作。
400 InvalidCidrBlock.Malformed Specified CIDR block is not valid. 该CIDR格式不正确。
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中已被打开。
404 InvalidVpcId.NotFound Specified VPC does not exist. 该VPC不存在。

访问错误中心查看更多错误码。