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

LineOperator String No CT

Optional. The service provider that provides the leased line. Valid values:

  • CT: China Telecom
  • CU: China Unicom
  • CM: China Mobile
  • CO: Other Chinese service providers
  • Equinix: Equinix
  • Other: Other service providers outside Mainland China
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 http:// or https://.

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:

  • 100Base-T: 100M electrical ports
  • 1000Base-T (default): 1 Gigabit electrical ports
  • 1000Base-LX: 1 Gigabit single-mode optical ports (10 km)
  • 10GBase-T: 10G electrical ports
  • 10GBase-LR: 10G single-mode optical ports (10 km)
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.

See common error codes.