Modifies the specification of a router interface to change its bandwidth.
Operation description
After you call this operation, the router interface enters the Activating state. After activation is complete, it enters the Active state.
You cannot modify the specification of a router interface that has overdue payments.
Try it now
Test
RAM authorization
Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| RegionId |
string |
Yes |
The region ID of the router interface. You can call the DescribeRegions operation to query the most recent region list. |
cn-hangzhou |
| RouterInterfaceId |
string |
Yes |
The router interface ID. |
ri-2zeo3xzyf38r4urzd**** |
| Spec |
string |
Yes |
The specification of the router interface. Valid values:
Note
When Role is set to AcceptingSide, set Spec to Negative. |
Small.1 |
| ClientToken |
string |
No |
The client token that ensures the idempotence of the request. You can use the client to generate the token, but you must ensure that the token is unique across requests. The client token can contain only ASCII characters. Note
If you do not specify this parameter, the system uses the request ID as the client token. The request ID may be different for each request. |
02fb3da4-130e-11e9-8e44-0016e04115b |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
The specification of the router interface. |
||
| Spec |
string |
The specification of the router interface. Valid values:
|
Small.1 |
| RequestId |
string |
The request ID. |
4EC47282-1B74-4534-BD0E-403F3EE64CAF |
Examples
Success response
JSON format
{
"Spec": "Small.1",
"RequestId": "4EC47282-1B74-4534-BD0E-403F3EE64CAF"
}
Error codes
|
HTTP status code |
Error code |
Error message |
Description |
|---|---|---|---|
| 400 | Forbidden.FinancialLocked | RouterInterface can not be operated by this action when it?s FinancialLocked. | |
| 400 | InvalidParam.NotFound | Parameter must not be null,uid, bid,regionNo, remoteRegionNo or routerId | |
| 400 | InvalidOppositeRegionId.NotFound | The OppositeRegionId provided does not exist in our records. | |
| 400 | InvalidInstanceOwner.Error | The router instance owner error. | The instance owner information is invalid. |
| 400 | InvalidRouterInterfaceSpec.Malformed | Specified RouterInterface spec is not valid. | The RouterInterface Spec parameter is set to an invalid value. |
| 400 | IllegalParam.chargeType | RouterInterface chargeType different. | |
| 400 | ResourceQueryError | The specified resource is queried error. | An error occurred while querying the specified resource. |
| 400 | InvalidSpec.ValueNotSupported | The specified Spec is not supported. | |
| 400 | InvalidSpec.ValueNotSupported | The specified Spec is not supported. | |
| 400 | InvalidInstance.StatusError | The router instance status error. | The status of the instance is invalid. |
| 400 | InvalidOpposite.NotFound | The opposite does not exist. | The peer does not exist. |
| 404 | InvalidRouterInterfaceId.NotFound | The specified RouterInterfaceId does not exist in our record. |
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.