Modifies the specifications of a router interface.

After you call this operation, the state of the router interface changes to Activating. After the router interface is activated, its state changes to Active.

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

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 ModifyRouterInterfaceSpec

The operation that you want to perform.

Set the value to ModifyRouterInterfaceSpec.

RegionId String Yes cn-hangzhou

The ID of the region to which the router interface belongs. You can call the DescribeRegions operation to query region IDs.

RouterInterfaceId String Yes ri-2zeo3xzyf38r4urzd****

The ID of the router interface.

Spec String Yes Small.1

The specifications 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 (the receiver is connected), Spec is set to Negative.
ClientToken String No 02fb3da4-130e-11e9-8e44-0016e04115b

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

You can use the client to generate the value, but you must ensure that it is unique among different requests. The token can contain only ASCII characters and cannot exceed 64 characters in length.

Response parameters

Parameter Type Example Description
RequestId String 4EC47282-1B74-4534-BD0E-403F3EE64CAF

The ID of the request.
Spec String Small.1

The specifications of the router interface.

Examples

Sample requests

http(s)://[Endpoint]/? Action=ModifyRouterInterfaceSpec
&RegionId=cn-hangzhou
&RouterInterfaceId=ri-2zeo3xzyf38r4urzd****
&Spec=Small.1
&<Common request parameters>

Sample success responses

XML format 

<ModifyRouterInterfaceSpecResponse>
   <RequestId>0ED8D006-F706-4D23-88ED-E11ED28DCAC0</RequestId>
   <Spec>Middle.2</Spec>
</ModifyRouterInterfaceSpecResponse>

JSON format 

{ 
    "RequestId": "0ED8D006-F706-4D23-88ED-E11ED28DCAC0",
    "Spec":"Middle.2" 
}

Error codes

HttpCode Error code Error message Description
400 InvalidSpec.ValudNotSupported The specified Spec is not supported. The error message returned because the specifications do not support the operation. Change the modifications and try again.
404 InvalidRouterInterfaceId.NotFound The specified RouterInterfaceId does not exist in our record. The error message returned because the specified router interface does not exist. Check whether the specified router interface is valid.
400 InvalidInstanceOwner.Error The router instance owener error. The error message returned because the vRouter does not belong to your Alibaba Cloud account.
400 InvalidInstance.StatusError The router instance owener error. The error message returned because the state of the instance is invalid.
400 InvalidOpposite.NotFound The opposite not exit. The error message returned because the peer does not exist.

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