Modifies the configuration of a physical connection.
When you call this operation, take note of the following limits:
- You can only modify the specifications and standby physical connection ID of a physical connection that is in the Initial, Enabled, or Rejected state.
- You cannot modify the configuration of a physical connection that is in the Canceled, Allocating, AllocationFailed, or Terminated state.
- After you modify the configuration of a physical connection that is in the Rejected state, its state becomes Initial.
Debugging
Request parameters
Parameter | Type | Required | Example | Description |
---|---|---|---|---|
Action | String | Yes | ModifyPhysicalConnectionAttribute |
The operation that you want to perform. Set the value to ModifyPhysicalConnectionAttribute. |
PhysicalConnectionId | String | Yes | pc-119mfjzm****** |
The ID of the physical connection. |
RegionId | String | Yes | cn-shanghai |
The ID of the region where the physical connection is created. You can call the DescribeRegions operation to query region IDs. |
LineOperator | String | No | CT |
The Internet service provider (ISP). Valid values:
|
bandwidth | Integer | No | 5 |
The bandwidth of the physical connection. 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 type of the physical connection port. Valid values:
|
RedundantPhysicalConnectionId | String | No | pc-119mfjzm7 |
The ID of the standby physical connection. The standby physical connection must be in the Allocated, Confirmed, or Enabled state. |
Description | String | No | Description |
The description of the physical connection. 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 physical connection. The name must be 2 to 128 characters in length, and can contain digits, periods (.),
underscores (_), and hyphens (-). It must start with a letter, and cannot start with
|
ClientToken | String | No | efefe566754h |
The client token that is used to ensure the idempotency of the request. You can use the client to generate the value, but you must ensure that it is unique among different requests. The token can contain only ASCII characters and cannot exceed 64 characters in length. |
CircuitCode | String | No | longtel001 |
The circuit code provided by the ISP for the physical connection. |
Response parameters
Parameter | Type | Example | Description |
---|---|---|---|
RequestId | String | 013EE132-A109-4247-91B0-099A8FF49AD7 |
The ID of the request. |
Examples
Sample requests
http(s)://[Endpoint]/? Action=ModifyPhysicalConnectionAttribute
&PhysicalConnectionId=pc-119mfjzm******
&RegionId=cn-shanghai
&<Common request parameters>
Sample success responses
XML
format
<ModifyPhysicalConnectionAttributeResponse>
<RequestId>8A6A5EC5-6F6C-4906-9689-56ACE58A13E0</RequestId>
</ModifyPhysicalConnectionAttributeResponse>
JSON
format
{
"RequestId": "8A6A5EC5-6F6C-4906-9689-56ACE58A13E0"
}
Error codes
HttpCode | Error code | Error message | Description |
---|---|---|---|
404 | InvalidPhysicalConnectionId.NotFound | The PhysicalConnectionId provided does not exist in our records. | The error message returned because the physical connection does not exist. |
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 type of the port is invalid. |
400 | InvalidDescription.Malformed | The specifid ? Description? is not valid. | The error message returned because the format of the specified resource 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 specified name is invalid. |
400 | InvalidStatus | invalid physical connection status. | The error message returned because the specified state of the physical connection is invalid. |
400 | InvalidBandwidth | invalid physical connection banwidth. | The error message returned because the specified bandwidth value of the physical connection is invalid. |
400 | InvalidRedundantPhysicalConnection | redundant physical connection doesn't belong to current user. | The error message returned because the specified physical connection does not belong to your Alibaba Cloud account. |
400 | InvalidRedundantPhysicalConnectionStatus | invalid redundant physical connection status. | The error message returned because the specified state of the standby physical connection is invalid. |
400 | InvalidCircuitCode.Malformed | circuitCode is illegal. | The error message returned because CircuitCode is set to an invalid value. |
For a list of error codes, visit the API Error Center.