Sets, changes, or removes the bandwidth limit of a cross-region connection.

Prerequisites

The Cloud Enterprise Network (CEN) instance is associated with a bandwidth plan. For more information, see the CreateCenBandwidthPackage and AssociateCenBandwidthPackage topics.

Description

You can call the SetCenInterRegionBandwidthLimit operation to set, change, or remove the bandwidth limit of a cross-region connection.

  • If you set BandwidthLimit to a value other than 0, the bandwidth limit of the cross-region connection is set or changed to the specified value.
  • If you set BandwidthLimit to 0, the bandwidth limit of the cross-region connection is removed.

Limits

  • The bandwidth limit of a cross-region connection cannot exceed the bandwidth limit of the associated bandwidth plan.
  • The sum of bandwidth limits of all cross-region connections cannot exceed the bandwidth limit of the associated bandwidth plan.
  • If bandwidth multiplexing is enabled for a cross-region connection, you cannot change the bandwidth limit of the cross-region connection.

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 No SetCenInterRegionBandwidthLimit

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

BandwidthLimit Long Yes 8

The bandwidth limit of the cross-region connection. Unit: Mbit/s.

CenId String Yes cen-7qthudw0ll6jmx****

The ID of the CEN instance.

LocalRegionId String Yes cn-hangzhou

The ID of the local region.

You can call the DescribeChildInstanceRegions operation to query regions where you can attach network instances to a CEN instance.

OppositeRegionId String Yes us-west-1

The ID of the peer region.

Response parameters

Parameter Type Example Description
RequestId String 530BC816-F575-412A-AAB2-435125D26328

The ID of the request.

Examples

Sample requests

http(s)://[Endpoint]/?Action=SetCenInterRegionBandwidthLimit
&BandwidthLimit=8
&CenId=cen-7qthudw0ll6jmx****
&LocalRegionId=cn-hangzhou
&OppositeRegionId=us-west-1
&<Common request parameters>

Sample success responses

XML format

<SetCenInterRegionBandwidthLimitResponse>
     <RequestId>530BC816-F575-412A-AAB2-435125D26328</RequestId>
</SetCenInterRegionBandwidthLimitResponse>

JSON format

{ "RequestId": "530BC816-F575-412A-AAB2-435125D26328" }

Error codes

HttpCode Error code Error message Description
400 OperationUnsupported.Attachment The cross region connection contains an existing bandwidth. The operation is not supported. The error message returned because bandwidth multiplexing is enabled for the cross-region connection.

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