Changes the virtual local area network (VLAN) ID of a hosted connection over Express Connect circuit.
Debugging
Authorization information
Request parameters
Parameter | Type | Required | Description | Example |
---|---|---|---|---|
VlanId | long | Yes | The VLAN ID of the hosted connection over Express Connect circuit. Valid values: 0 to 2999.
| 1 |
InstanceId | string | Yes | The ID of the hosted connection over Express Connect circuit. | pc-bp1mrgfbtmc9brre7**** |
Token | string | No | The client token that is used to ensure the idempotence of the request. You can use the client to generate the token, but you must make sure that the token is unique among different 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.
| CBCE910E-D396-4944-8**** |
DryRun | boolean | No | Specifies whether to perform only a dry run, without performing the actual request. Valid values: Valid values:
| false |
ExpectSpec | string | No | The estimated bandwidth value of the hosted connection. The estimated bandwidth value takes effect only after the payment is completed. Valid values: 50M, 100M, 200M, 300M, 400M, 500M, 1G, 2G, 5G, 8G, and 10G. Note
2G, 5G, 8G, and 10G are unavailable by default. If you want to use these bandwidth values, contact your account manager.
M indicates Mbit/s and G indicates Gbit/s. | 50M |
RegionId | string | Yes | The region ID of the hosted connection. You can call the DescribeRegions operation to obtain the region ID. | cn-hangzhou |
Response parameters
Examples
Sample success responses
JSON
format
{
"RequestId": "7035627E-1C1D-5BC7-A830-F897A35912D1",
"Success": "true"
}
Error codes
HTTP status code | Error code | Error message | Description |
---|---|---|---|
400 | IllegalParam.VlanId | The param of VlanId is illegal. | The VlanId parameter is set to an invalid value. |
400 | ResourceNotFound.PhysicalConnectionId | The specified PhysicalConnectionId [%s] is not found. | PhysicalConnectionId is set to an invalid value. |
400 | ResourceNotEnough.Bandwidth | The specified resource of Bandwidth is not enough. | The specified resource of Bandwidth is insufficient. |
400 | IllegalParam.Bandwidth | The param of bandwidth is illegal. | The Bandwidth parameter is set to an invalid value. |
400 | Forbidden.PhysicalConnection | Only parent physical connection account is allowed to modify the virtual physical connection. | You can modify only the physical port to which the shared port belongs. |
400 | OperationFailed.PhysicalConnectionFinancialLocked | Update failed, the physical connection is financial locked. | The shared port is locked due to overdue payments and you cannot modify the VLAN. |
400 | OperationFailed.PhysicalConnectionTerminated | Update failed, the physical connection is terminated. | The shared port is disabled and you cannot modify the VLAN. |
400 | OperationDenied.CreateVpconn | You are not allowed to create virtual physical connection. Please contact your CBM. | If you do not have permission to create a shared line, please contact the business manager. |
For a list of error codes, visit the Service error codes.
Change history
Change time | Summary of changes | Operation |
---|---|---|
2024-06-13 | The Error code has changed | View Change Details |
2023-12-21 | The Error code has changed | View Change Details |
2021-11-16 | The Error code has changed. The request parameters of the API has changed | View Change Details |
2021-09-27 | Add Operation | View Change Details |