Modifies the Internet bandwidth value of an IPv6 CIDR block.

Usage notes

You cannot repeatedly call the ModifyIpv6InternetBandwidth operation to modify the Internet bandwidth value of an IPv6 CIDR block within the specified period of time.

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
RegionId String Yes cn-huhehaote

The region ID of the IPv6 gateway. You can call the DescribeRegions operation to query the most recent region list.

Ipv6AddressId String No ipv6-2zen5j4axcp5l5qyy****

The ID of the IPv6 address.

Note You must set one of Ipv6AddressId and Ipv6InternetBandwidthId.
Ipv6InternetBandwidthId String No ipv6bw-uf6hcyzu65v98v3du****

The ID of the Internet bandwidth that you purchased for the IPv6 CIDR block.

Note You must set one of Ipv6AddressId and Ipv6InternetBandwidthId.
Bandwidth Long Yes 4

The Internet bandwidth for the IPv6 CIDR block. Unit: Mbit/s. Valid values: 1 to 5000.

ClientToken String No 123e4567-e89b-12d3-a456-426655440000

The client token that is used to ensure the idempotence of the request.

You can use the client to generate the token, but you must make sure that the token is unique among different requests. The token can contain only ASCII characters.

Note If you do not specify this parameter, the system automatically uses the request ID as the client token. The request ID may be different for each request.
Action String Yes ModifyIpv6InternetBandwidth

The operation that you want to perform. Set the value to ModifyIpv6InternetBandwidth.

Response parameters

Parameter Type Example Description
RequestId String D560AF68-4CE8-4A5C-B3FE-469F558094D0

The request ID.

Examples

Sample requests

http(s)://[Endpoint]/?RegionId=cn-huhehaote
&Ipv6AddressId=ipv6-2zen5j4axcp5l5qyy****
&Ipv6InternetBandwidthId=ipv6bw-uf6hcyzu65v98v3du****
&Bandwidth=4
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&Action=ModifyIpv6InternetBandwidth
&Common request parameters

Sample success responses

XML format

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

<ModifyIpv6InternetBandwidthResponse>
    <RequestId>D560AF68-4CE8-4A5C-B3FE-469F558094D0</RequestId>
</ModifyIpv6InternetBandwidthResponse>

JSON format

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

{
  "RequestId" : "D560AF68-4CE8-4A5C-B3FE-469F558094D0"
}

Error codes

HttpCode Error code Error message Description
400 MissingParam.Ipv6InstanceId The param of Ipv6InstanceId is missing. Ipv6InstanceId is not set.
400 InvalidIpv6Instance.NotFound The specified Ipv6AddressId or Ipv6InternetBandwidthId is not found. Ipv6AddressId or Ipv6InternetBandwidthId is not set.
400 IllegalParam.Bandwidth The param of bandwidth is illegal. Bandwidth is set to an invalid value.
400 OperationUnsupported.FinancialLocked The operation is forbidden because of financialLocked. The resource is locked due to overdue payments and the operation is denied.
400 OperationFailed.InternetBandwidthNonExist The operation is forbidden because of InternetBandwidthNonExist. The specified bandwidth is invalid and the operation is denied.
400 OperationFailed.InternetBandwidthUnstable The operation is forbidden because of InternetBandwidthUnstable. The specified bandwidth is unstable and the operation is denied.
400 OperationFailed.BandwidthExceedLimit The operation is forbidden because of BandwidthExceedLimit. The specified bandwidth exceeds the upper limit and the operation is denied.
400 ParamExclusive.Ipv6AddressIdAndIpv6InternetBandwidthId Ipv6AddressId and Ipv6InternetBandwidthId is mutually exclusive. Ipv6AddressId and Ipv6InternetBandwidthId are not set for the same instance.
404 InvalidRegionId.NotFound The specified RegionId does not exist in our records. The specified region ID does not exist.

For a list of error codes, see Service error codes.