All Products
Search
Document Center

Cloud Enterprise Network:ModifyTransitRouterCapacityReservations

Last Updated:Oct 27, 2026

Configures the capacity reservation properties of an Enterprise Edition transit router.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request syntax

GET  HTTP/1.1

Request parameters

Parameter

Type

Required

Description

Example

TransitRouterId

string

Yes

The ID of the transit router instance for forward routing.

tr-bp1su1ytdxtataupl****

MinimumTransitRouterCapacities

array<object>

No

The reserved capacity for each zone in the capacity reservation.

array<object>

No

DataProcessGbps

object

No

The reserved capacity for the specified zone.

Target

integer

No

The target reserved capacity for the specified zone.

100

ZoneId

string

No

The ID of the zone.

cn-shanghai-l

ResetCapacityReservations

array<object>

No

Cancels capacity reservations.

object

No

ZoneId

string

No

The ID of the zone for which to cancel the capacity reservation.

cn-beijing-i

DeploymentSets

array<object>

No

The deployment set information for the capacity reservation.

object

No

DeploymentSetID

string

No

The ID of the deployment set instance used.

ds-badxcs*****

ZoneID

string

No

The zone for which to modify the deployment set of the capacity reservation.

  • To cancel the deployment set, specify the zone and leave the deployment set ID empty.

cn-shanghai-b

ClientToken

string

No

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

You can generate the token on your client to ensure that the token is unique across different requests. The client token only supports ASCII characters.

Note

If you do not specify this parameter, the system automatically uses the request ID of the API request as the client token. The request ID may be different for each API request.

02fb3da4-130e-11e9-8e44-001****

Response elements

Element

Type

Description

Example

object

Schema of Response

RequestId

string

The request ID.

004E99FB-E996-5777-888E-BA1D8F215407

Examples

Success response

JSON format

{
  "RequestId": "004E99FB-E996-5777-888E-BA1D8F215407"
}

Error codes

HTTP status code

Error code

Error message

Description

400 InvalidParameter.TransitRouterId The specified parameter TransitRouterId is invalid. The parameter TransitRouterId entered is illegal.
400 InvalidParameter.DeploymentSetId.Strategy The operation is invalid, because the deployment set strategy is not supported. The operation is invalid, because the deployment set strategy is not supported.
400 InvalidParameter.DeploymentSetId.NotExist The operation is invalid, because the deployment set is not exist. The operation is invalid, because the deployment set is not exist.
400 InvalidCapacityReservation.NotFound The CapacityReservation is not found. The CapacityReservation is not found.
400 OperationUnsupported.CapacityReservationStatus The status of CapacityReservation not support this operation. The status of CapacityReservation not support this operation.
400 OperationUnsupported.ModifyCapacityReservations Operation is unsupported due to the transit router not support this feature. Operation is unsupported due to the transit router not support this feature.
400 InvalidTransitRouterId.NotFound The specified TransitRouterId is not found. The error message returned because the specified transit router does not exist.
400 MissingParameter.DeploymentSets.ZoneId The parameter DeploymentSets.ZoneId is mandatory. The parameter DeploymentSets.ZoneId is mandatory.
400 FilterKeyDuplicated.ResetCapacityReservations.ZoneId The parameter ResetCapacityReservations.ZoneId in filter are duplicated. The parameter ResetCapacityReservations.ZoneId in filter are duplicated.
400 FilterKeyDuplicated.DeploymentSets.ZoneId The parameter DeploymentSets.ZoneId in filter are duplicated. The parameter DeploymentSets.ZoneId in filter are duplicated.
400 FilterKeyDuplicated.MinimumTransitRouterCapacities.ZoneId The Parameter MinimumTransitRouterCapacities.ZoneId in filter are duplicated. The Parameter MinimumTransitRouterCapacities.ZoneId in filter are duplicated.
400 IllegalParam.MinimumTransitRouterCapacities.DataProcessGbps MinimumTransitRouterCapacities.DataProcessGbps is illegal. MinimumTransitRouterCapacities.DataProcessGbps is illegal.
400 MissingParameter.MinimumTransitRouterCapacities.DataProcessGbps The parameter MinimumTransitRouterCapacities.DataProcessGbps.Target is mandatory. The parameter MinimumTransitRouterCapacities.DataProcessGbps.Target is mandatory.
400 MissingParameter.MinimumTransitRouterCapacities.ZoneId The parameter MinimumTransitRouterCapacities.ZoneId is mandatory. The parameter MinimumTransitRouterCapacities.ZoneId is mandatory.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.