Deletes a router interface.
Operation description
Take note of the following limits:
-
You can delete only a router interface that is in the Idle or Inactive state.
-
Before you delete a router interface, delete all custom route entries destined for it.
Try it now
Test
RAM authorization
Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| RegionId |
string |
Yes |
The ID of the region where the router interface is deployed. You can call the DescribeRegions operation to query the latest region list. |
cn-shanghai |
| RouterInterfaceId |
string |
Yes |
The ID of the router interface. |
ri-2zeo3xzyf38r4urz**** |
| ClientToken |
string |
No |
The client token that ensures the idempotence of the request. You can use the client to generate the token, but make sure 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 automatically uses the request ID as the client token. The request ID may be different for each request. |
123e4567-e89b-12d3-a456-426655440000 |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
The request ID. |
||
| RequestId |
string |
The request ID. |
54B48E3D-DF70-471B-AA93-08E683A1B45 |
Examples
Success response
JSON format
{
"RequestId": "54B48E3D-DF70-471B-AA93-08E683A1B45"
}Error codes
|
HTTP status code |
Error code |
Error message |
Description |
|---|---|---|---|
| 400 | InvalidInstance.StatusError | The router instance status error. | The status of the instance is invalid. |
| 400 | OperationFailed.OperationLocked | Operation failed because OperationLocked. | The operation failed because the instance is locked due to O&M. |
| 400 | RouterInterfaceReferredByRouteEntry | Router interface referred by route entry. | There is a route to the router interface that cannot be deleted |
| 400 | ReferredByRouteEntry.RouterInterface | Router interface referred by route entry. | The router interface is referenced by a route entry. |
| 400 | InvalidRouteTable.NotFound | The specified routetable does not exist. | The route table is not found. |
| 400 | Forbbiden.InvaildOwner | Incorrect RouterInterface owner. | The router does not belong to your account. |
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.