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

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 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:

  • CT: China Telecom
  • CU: China Unicom
  • CM: China Mobile
  • CO: Other ISPs in China
  • Equinix: Equinix
  • Other: other ISPs outside China
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:

  • 100Base-T: a copper port that supports 100 Mbit/s
  • 1000Base-T: a copper port that supports 1,000 Mbit/s
  • 1000Base-LX: a single-mode fiber port that supports 1,000 Mbit/s (10 kilometers)
  • 10GBase-T: a copper port that supports 10,000 Mbit/s
  • 10GBase-LR: a single-mode fiber port that supports 10,000 Mbit/s (10 kilometers)
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 http:// or https://.

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 http:// or https://.

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.