All Products
Search
Document Center

Virtual Private Cloud:ModifyRouterInterfaceSpec

Last Updated:Aug 27, 2026

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.

Note

You cannot modify the specification of a router interface that has overdue payments.

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 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:

  • Mini.2: 2 Mbit/s

  • Mini.5: 5 Mbit/s

  • Small.1: 10 Mbit/s

  • Small.2: 20 Mbit/s

  • Small.5: 50 Mbit/s

  • Middle.1: 100 Mbit/s

  • Middle.2: 200 Mbit/s

  • Middle.5: 500 Mbit/s

  • Large.1: 1,000 Mbit/s

  • Large.2: 2,000 Mbit/s

  • Large.5: 5,000 Mbit/s

  • Xlarge.1: 10,000 Mbit/s

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:

  • Mini.2: 2 Mbit/s

  • Mini.5: 5 Mbit/s

  • Small.1: 10 Mbit/s

  • Small.2: 20 Mbit/s

  • Small.5: 50 Mbit/s

  • Middle.1: 100 Mbit/s

  • Middle.2: 200 Mbit/s

  • Middle.5: 500 Mbit/s

  • Large.1: 1,000 Mbit/s

  • Large.2: 2,000 Mbit/s

  • Large.5: 5,000 Mbit/s

  • Xlarge.1: 10,000 Mbit/s

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.