All Products
Search
Document Center

Express Connect:TerminatePhysicalConnection

Last Updated:Aug 28, 2026

Disables an enabled Express Connect circuit.

Operation description

After you call this operation, the Express Connect circuit enters the Terminating state and then changes to the Terminated state when the process is complete. Take note of the following limits:

  • You can only disable an Express Connect circuit that is in the Enabled state.

  • Before you disable an Express Connect circuit, you must delete the virtual border routers (VBRs) associated with it.

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 Express Connect circuit.

You can call the DescribeRegions operation to query the most recent region list.

cn-hangzhou

PhysicalConnectionId

string

Yes

The ID of the Express Connect circuit.

pc-119mfjzm****

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 among different requests. The 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.

02fb3da4-130e-11e9-8e44-0016e04115b

Response elements

Element

Type

Description

Example

object

The request ID.

RequestId

string

The request ID.

4EC47282-1B74-4534-BD0E-403F3EE64CAF

Examples

Success response

JSON format

{
  "RequestId": "4EC47282-1B74-4534-BD0E-403F3EE64CAF"
}

Error codes

HTTP status code

Error code

Error message

Description

400 Forbidden.NotAllowedInState The request does not allow in this state.
400 Forbidden.VbrAttached Cannot terminate physical connection when virtual border routers are still attached.
400 OperationFailed.VpconnAttached Cannot terminate physical connection when vpconn are still attached. The shared port still exists and the physical port cannot be disabled.
400 OperationDenied.MacsecAttached The operation is not allowed because of MacsecAttached. The current operation is rejected because there is still a MACSec key binding on the physical connection.
400 OperationFailed.ResourceLockedBySystem The specified resource is locked by system. The operating resource is locked by the system and cannot be operated temporarily.
404 InvalidRegionId.NotFound The RegionId provided does not exist in our records.
404 InvalidPhysicalConnectionId.NotFound The PhysicalConnectionId provided does not exist in our records.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.