Modifies the configuration of an Express Connect circuit.
Limits
When you call this operation, take note of the following limits:
- If an Express Connect circuit is in the Initial, Enabled, or Rejected state, you can modify the specifications of the Express Connect circuit and the ID of the redundant circuit.
- If an Express Connect circuit is in the Canceled, Allocating, AllocationFailed, or Terminated state, you cannot modify the specifications of the Express Connect circuit.
- After you modify the specifications of an Express Connect circuit that is in the Rejected state, the Express Connect circuit enters the Initial state.
Debugging
Request parameters
Parameter | Type | Required | Example | Description |
---|---|---|---|---|
RegionId | String | Yes | cn-shanghai |
The region ID of the Express Connect circuit. You can call the DescribeRegions operation to query the most recent region list. |
PhysicalConnectionId | String | Yes | pc-119mfjzm****** |
The ID of the Express Connect circuit. |
LineOperator | String | No | CT |
The connectivity provider of the Express Connect circuit. Valid values:
|
bandwidth | Integer | No | 5 |
The bandwidth value for the connection over the Express Connect circuit. Unit: Mbit/s. Valid values: 2 to 10240. |
PeerLocation | String | No | Building XX, XX Avenue, XX District, Hangzhou, Zhejiang |
The geographical location of the data center. |
PortType | String | No | 1000Base-LX |
The port type of the Express Connect circuit. Valid values:
Note If you want to use the 40GBase-LR or 100GBase-LR port for an Express Connect circuit,
you must first contact your account manager to obtain information about resource supplies.
|
RedundantPhysicalConnectionId | String | No | pc-119mfjzm7 |
The ID of the redundant Express Connect circuit. The redundant Express Connect circuit must be in the Allocated, Confirmed, or Enabled state. |
Description | String | No | Description |
The description of the Express Connect circuit. The description must be 2 to 256 characters in length. It must start with a letter
but cannot start with |
Name | String | No | Name |
The name of the Express Connect circuit. The name must be 2 to 128 characters in length and can contain letters, digits, periods
(.), underscores (_), and hyphens (-). The name must start with a letter but cannot
start with |
ClientToken | String | No | efefe566754h | The client token that is used to ensure the idempotence of the request. You can use the client to generate a token, but you must make sure that the token is unique among different requests. The token can contain only ASCII characters and cannot exceed 64 characters in length. |
Action | String | Yes | ModifyPhysicalConnectionAttribute |
The operation that you want to perform. Set the value to ModifyPhysicalConnectionAttribute. |
CircuitCode | String | No | longtel001 |
The circuit code of the Express Connect circuit. The circuit code is provided by the connectivity provider. |
Response parameters
Parameter | Type | Example | Description |
---|---|---|---|
RequestId | String | 013EE132-A109-4247-91B0-099A8FF49AD7 |
The ID of the request. |
Examples
Sample requests
http(s)://[Endpoint]/?RegionId=cn-shanghai
&PhysicalConnectionId=pc-119mfjzm******
&LineOperator=CT
&bandwidth=5
&PeerLocation=Building XX, XX Avenue, XX District, Hangzhou, Zhejiang
&PortType=1000Base-LX
&RedundantPhysicalConnectionId=pc-119mfjzm7
&Description=Description
&Name=Name
&ClientToken=efefe566754h
&Action=ModifyPhysicalConnectionAttribute
&CircuitCode=longtel001
&Common request parameters
Sample success responses
XML
format
HTTP/1.1 200 OK
Content-Type:application/xml
<ModifyPhysicalConnectionAttributeResponse>
<RequestId>013EE132-A109-4247-91B0-099A8FF49AD7</RequestId>
</ModifyPhysicalConnectionAttributeResponse>
JSON
format
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "013EE132-A109-4247-91B0-099A8FF49AD7"
}
Error codes
HTTP status code | Error code | Error message | Description |
---|---|---|---|
400 | InvalidLineOperator.Malformd | The LineOperator provided was invalid. | The error message returned because LineOperator is set to an invalid value. |
400 | InvalidPeerLocation.Malformd | The PeerLocation provided was invalid. | The error message returned because PeerLocation is set to an invalid value. |
400 | InvalidPortType.Malformd | The PortType provided was invalid. | The error message returned because the specified port type is invalid. |
400 | InvalidDescription.Malformed | The specifid ?Description? is not valid. | The error message returned because the specified description is invalid. The description must be 2 to 256 characters in length and cannot start with http:// or https://. |
400 | InvalidName.Malformed | The specified ?Name? is not valid. | The error message returned because the format of the name is invalid. |
400 | InvalidStatus | invalid physical connection status. | The error message returned because the Express Connect circuit is in an invalid state. |
400 | InvalidBandwidth | invalid physical connection banwidth. | The error message returned because the specified bandwidth value of the Express Connect circuit is invalid. |
400 | InvalidRedundantPhysicalConnection | redundant physical connection doesn't belong to current user. | The error message returned because the specified redundant Express Connect circuit does not belong to your Apsara Stack account. |
400 | InvalidRedundantPhysicalConnectionStatus | invalid redundant physical connection status. | The error message returned because the redundant Express Connect circuit is in an invalid state. |
400 | InvalidCircuitCode.Malformed | circuitCode is illegal. | The error message returned because CircuitCode is set to an invalid value. |
404 | InvalidPhysicalConnectionId.NotFound | The PhysicalConnectionId provided does not exist in our records. | The error message returned because the Express Connect circuit does not exist. |
For a list of error codes, visit the API Error Center.