Modifies the maximum bandwidth of an EIP bandwidth plan.

Usage notes

  • The ModifyCommonBandwidthPackageSpec operation is asynchronous. After you send the request, the system returns a request ID. However, the operation is still being performed in the system background. You can call the DescribeCommonBandwidthPackages operation to query the status of an EIP bandwidth plan:
    • If the EIP bandwidth plan is in the Modifying state, the maximum bandwidth of the EIP bandwidth plan is being modified. In this state, you can only query the EIP bandwidth plan and cannot perform other operations.
    • If the EIP bandwidth plan is in the Available state, the maximum bandwidth of the EIP bandwidth plan is modified.
  • You cannot repeatedly call the ModifyCommonBandwidthPackageSpec operation to modify the maximum bandwidth of an EIP bandwidth plan 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
Action String Yes ModifyCommonBandwidthPackageSpec

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

RegionId String Yes cn-hangzhou

The region ID of the EIP bandwidth plan.

You can call the DescribeRegions operation to query the most recent region list.

BandwidthPackageId String Yes cbwp-2ze2ic1xd2qeqk145****

The ID of the EIP bandwidth plan.

Bandwidth String Yes 1000

The maximum bandwidth of the EIP bandwidth plan. Unit: Mbit/s.

Valid values: 1 to 1000.

Response parameters

Parameter Type Example Description
RequestId String 7F129000-F929-4AF5-BE8D-BAE434C795306

The ID of the request.

Examples

Sample requests

http(s)://[Endpoint]/?Action=ModifyCommonBandwidthPackageSpec
&RegionId=cn-hangzhou
&BandwidthPackageId=cbwp-2ze2ic1xd2qeqk145****
&Bandwidth=1000
&Common request parameters

Sample success responses

XML format 

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

<ModifyCommonBandwidthPackageSpecResponse>
    <RequestId>7F129000-F929-4AF5-BE8D-BAE434C795306</RequestId>
</ModifyCommonBandwidthPackageSpecResponse>

JSON format 

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

{
  "RequestId" : "7F129000-F929-4AF5-BE8D-BAE434C795306"
}

Error codes

HttpCode Error code Error message Description
400 ResourceNotEnough.Bandwidth The specified resource of Bandwidth is not enough. The error message returned because bandwidth resources are insufficient.
404 InvalidRegionId.NotFound The specified RegionId does not exist in our records. The error message returned because the specified region ID does not exist.
404 InvalidBandwidth.ValueNotSupported The specified value of Bandwidth not supported. The error message returned because the specified maximum bandwidth value is invalid.

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