Configures, modifies, or removes the maximum bandwidth value of an inter-region connection.

Prerequisites

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

Usage notes

You can call the SetCenInterRegionBandwidthLimit operation to configure, modify, or remove the maximum bandwidth value of an inter-region connection.

  • If you set BandwidthLimit to a value other than 0, the maximum bandwidth value of the inter-region connection is set or changed to the specified value.
  • If you set BandwidthLimit to 0, no bandwidth resource is allocated to the inter-region connection.

Limits

  • The maximum bandwidth value of an inter-region connection cannot exceed that of the associated bandwidth plan.
  • The sum of the maximum bandwidth values of all inter-region connections cannot exceed the maximum bandwidth value of the associated bandwidth plan.
  • If bandwidth multiplexing is enabled for an inter-region connection, you cannot change the maximum bandwidth value of the inter-region connection.

  • You can call SetCenInterRegionBandwidthLimit to configure, modify, and remove the maximum bandwidth values of inter-region connections only on Basic Edition transit routers.

    For more information about how to configure, modify, and remove the maximum bandwidth values of inter-region connections on Enterprise Edition transit routers, see CreateTransitRouterPeerAttachment, UpdateTransitRouterPeerAttachmentAttribute, and DeleteTransitRouterPeerAttachment.

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 SetCenInterRegionBandwidthLimit

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

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.

BandwidthLimit Long Yes 8

The maximum bandwidth value of the inter-region connection. Unit: Mbit/s.

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
&CenId=cen-7qthudw0ll6jmx****
&LocalRegionId=cn-hangzhou
&OppositeRegionId=us-west-1
&BandwidthLimit=8
&<Common request parameters>

Sample success responses

XML format 

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

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

JSON format 

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

{
  "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 inter-region connection.

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