Modifies the configurations of a physical connection.
Before you call this API, note the following limits:
- You can only modify the configurations or redundant physical connection ID of a physical connection that is in the Initial or Rejected state.
- You cannot modify the configurations of a physical connection that is in the Canceled, Allocating, AllocationFailed or Terminated state.
- After you modify the configurations of a physical connection that is in the Rejected state, the physical connection enters the Initial state.
Debug
Use OpenAPI Explorer to perform debug operations and generate SDK code examples.
Request parameters
Parameter | Type | Required? | Example value | Description |
---|---|---|---|---|
Action | String | Yes | ModifyPhysicalConnectionAttribute |
The name of this action. Value: ModifyPhysicalConnectionAttribute |
PhysicalConnectionId | String | Yes | pc-119mfjzm7 |
The ID of the physical connection. |
RegionId | String | Yes | cn-shanghai |
The region of the physical connection. To query the region ID, call DescribeRegions. |
CircuitCode | String | No | longtel001 |
Optional. The leased line code provided by the service provider for the physical connection. |
ClientToken | String | No | efefe566754h |
Optional. The client token used to guarantee the idempotence of the request. The value of this parameter is generated by the client and is unique among different requests. It can contain up to 64 ASCII characters. |
Description | String | No | The description of the physical connection. |
Optional. The description of the physical connection. The description must be 2 to
256 characters in length. It must start with a letter or a Chinese character, and
cannot start with |
LineOperator | String | No | CT |
Optional. The service provider that provides the leased line. Valid values:
|
Name | String | No | PC1 |
Optional. The name of the physical connection. The name must be 2 and 128 characters
in length and can contain letters, numbers, periods (.), underscores (_), and hyphens
(-). The name must start with a letter or a Chinese character. It cannot start with
|
PeerLocation | String | No | Zhejiang --- vfjdbg_21e |
The geographic location of the on-premises data center. |
PortType | String | No | E1 - 2M |
Optional. The port type of the physical connection. Valid values:
|
RedundantPhysicalConnectionId | String | No | pc-119mfjzm7 |
Optional. The ID of the redundant physical connection. The redundant physical connection must be in the Allocated, Confirmed, or Enabled state. |
bandwidth | Integer | No | 5 |
Optional. The bandwidth of the physical connection. Value range: 2 to 10240. Unit: Mbit/s |
Response parameters
Parameter | Type | Example value | Description |
---|---|---|---|
RequestId | String | 013EE132-A109-4247-91B0-099A8FF49AD7 |
The request ID. |
Examples
Request example
https://vpc.aliyuncs.com/?Action=ModifyPhysicalConnectionAttribute
&PhysicalConnectionId=pc-119mfjzm7
&RegionId=cn-shanghai
&<CommonParameters>
Response examples
XML
format
<ModifyPhysicalConnectionAttributeResponse>
<RequestId>8A6A5EC5-6F6C-4906-9689-56ACE58A13E0"</RequestId>
</ModifyPhysicalConnectionAttributeResponse>
JSON
format
{
"RequestId":"8A6A5EC5-6F6C-4906-9689-56ACE58A13E0"
}
Error codes
HTTP status code | Error code | Error message | Description |
---|---|---|---|
404 | InvalidPhysicalConnectionId.NotFound | The PhysicalConnectionId provided does not exist in our records. | The specified physical connection does not exist. |
400 | InvalidLineOperator.Malformd | The LineOperator provided was invalid. | The specified value of the LineOperator parameter is invalid. |
400 | InvalidPeerLocation.Malformd | The PeerLocation provided was invalid. | The specified value of the PeerLocation parameter is invalid. |
400 | InvalidPortType.Malformd | The PortType provided was invalid. | The port type is invalid. |
400 | InvalidDescription.Malformed | The specifid ? Description? is not valid. | The 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 name is invalid. |
400 | InvalidStatus | invalid physical connection status. | The status of the physical connection is invalid. |
400 | InvalidBandwidth | invalid physical connection banwidth. | The bandwidth of the physical connection is invalid. |
400 | InvalidRedundantPhysicalConnection | redundant physical connection doesn't belong to current user. | This redundant physical connection does not belong to your account. |
400 | InvalidRedundantPhysicalConnectionStatus | invalid redundant physical connection status. | The status of the redundant physical connection is invalid. |
400 | InvalidCircuitCode.Malformed | circuitCode is illegal. | The specified value of the CircuitCode parameter is invalid. |