Changes the VLAN ID of a hosted connection.


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 UpdateVirtualPhysicalConnection

The operation that you want to perform. Set the value to UpdateVirtualPhysicalConnection.

VlanId Long Yes 1

The VLAN ID of the hosted connection. Valid values: 0 to 2999.

  • If the VLAN ID is set to 0, it indicates that the switch port of the virtual border router (VBR) is a Layer 3 router interface instead of a VLAN interface. When a Layer 3 router interface is used, each Express Connect circuit corresponds to a VBR.
  • If the VLAN ID is set to a value from 1 to 2999, the switch port of the VBR is a Layer 3 VLAN subinterface. When a Layer 3 subinterface (VLAN) is used, each VLAN ID corresponds to a VBR. In this case, the Express Connect circuit with which the VBR is associated can be used to connect to virtual private clouds (VPCs) that belong to different Alibaba Cloud accounts. VBRs in different VLANs are isolated from each other at Layer 2.
InstanceId String Yes pc-bp1mrgfbtmc9brre7****

The ID of the shared Express Connect circuit.

Token String No CBCE910E-D396-4944-8****

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 make sure that it is unique among different requests. The token can contain only ASCII characters and cannot exceed 64 characters in length.

DryRun Boolean No false

Specifies whether to only precheck the request. Valid values:

  • true: only prechecks the request but does not change the VLAN ID of the hosted connection. Check items include the request format, instance status, and whether the required parameters are specified. If the request fails to pass the check, an error message is returned. If the request passes the check, the system returns the ID of the request.
  • false (default): sends the request. If the request passes the precheck, the VLAN ID of the hosted connection is changed.
ExpectSpec String No 50M

The estimated bandwidth value of the hosted connection. The estimated bandwidth value takes effect after the payment is completed.

Valid values: 50M, 100M, 200M, 300M, 400M, 500M, 1G, 2G, 5G, 8G, and 10G.

Note However, if you want to set the value to 2G, 5G, 8G, or 10G, you must first submit a ticket.

M indicates Mbit/s and G indicates Gbit/s.

RegionId String Yes cn-hangzhou

The region ID of the hosted connection.

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

Response parameters

Parameter Type Example Description
RequestId String 7035627E-1C1D-5BC7-A830-F897A35912D1

The ID of the request.

Success String true

Indicates whether the VLAN ID of the hosted connection is changed. Valid values:

  • true: yes
  • false: no


Sample requests

&Common request parameters

Sample success responses

XML format

HTTP/1.1 200 OK


JSON format

HTTP/1.1 200 OK

  "RequestId" : "7035627E-1C1D-5BC7-A830-F897A35912D1",
  "Success" : "true"

Error codes

HttpCode Error code Error message Description
400 ResourceNotFound.PhysicalConnectionId The specified PhysicalConnectionId [%s] is not found. The error message returned because PhysicalConnectionId is set to an invalid value.

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