Configures the capacity reservation properties of an Enterprise Edition transit router.
Try it now
Test
RAM authorization
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.
|
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.