调用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个字符,不能以 |
VpcName | String | 否 | Vpc-1 | 要修改的VPC名称。 名称长度为1~128个字符,不能以 |
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网段。取值:
|
Ipv6CidrBlock | String | 否 | 2408:XXXX:0:6a::/56 | VPC的IPv6网段。 |
Ipv6Isp | String | 否 | BGP | VPC的IPv6地址段类型,取值:
说明 如果是开通了单线带宽白名单的用户,该字段可以设置为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不存在。 |
访问错误中心查看更多错误码。