Modifies the attributes of a physical connection.

Note the following before you call this action:
  • If you want to modify the specification or the redundant physical connection ID, the corresponding physical connection must be in the Initial or Rejected status.

  • You cannot modify the attributes of a physical connection that is in the Canceled, Allocating, AllocationFailed, or Terminated status.

  • After modification, a physical connection in the Rejected status will change to the Initial status.

Debug

By using API Explorer, you can easily debug APIs, automatically generate SDK code examples, and quickly search for APIs.

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 where the physical connection is located.

To query the region ID, call DescribeRegions.

CircuitCode String No longtel001

The circuit code provided by the carrier for the physical connection.

ClientToken String No efefe566754h

A client token used to guarantee the idempotence of requests.

This parameter value is generated by the client and must be unique. It must be 1 to 64 ASCII characters in length.

Description String No The description of the physical connection

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

LineOperator String No CT
The carrier that provides the physical connection. Valid values:
  • CT: China Telecom

  • CU: China Unicom

  • CM: China Mobile

  • CO: Others in China

  • Equinix: Equinix

  • Other: Others outside China

Name String No The name of the physical connection

The name of the physical connection.

The name must be 2 to 128 characters in length and can contain letters, numbers, periods (.), underscores (_), and hyphens (-). The name must start with a letter. It cannot start with http:// or https://.

PeerLocation String No Zhejiang Province---vfjdbg_21e

The geographic location of the on-premises data center.

PortType String No E1 - 2M
The port type of the physical connection. Valid values:
  • 100Base-T: 100 Mbps electrical port

  • 1000Base-T(default): 1 Gbps electrical port

  • 1000Base-LX: 1 Gbps single-mode optical port (10 km)

  • 10GBase-T: 10 Gbps electrical port

  • 10GBase-LR: 10 Gbps single-mode optical port (10 km)

RedundantPhysicalConnectionId String No pc-119mfjzm7 The ID of the redundant physical connection. The redundant physical connection must be in the Allocated, Confirmed, or Enabled status.
Bandwidth String No 5 The bandwidth in Mbps of the physical connection. Value range: 2 to 10240.

Response parameters

Parameter Type Example value Description
RequestId String 013EE132-A109-4247-91B0-099A8FF49AD7 The ID of the request.

Examples

Request example


https://vpc.aliyuncs.com/?Action=ModifyPhysicalConnectionAttribute
&PhysicalConnectionId=pc-119mfjzm7
&RegionId=cn-shanghai
&<CommonParameters>
Response example
  • 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 InvalidPeerLocation.Malformd The PeerLocation provided was invalid. The value of the PeerLocation parameter is invalid.
400 InvalidPortType.Malformd The PortType provided was invalid. The specified port type is invalid.
400 InvalidDescription.Malformed The specifid ?Description? is not valid. The format of the description is invalid. The source description can be 2 to 256 characters in length. It cannot start with http:// and https://.
400 InvalidName.Malformed The specified ?Name? is not valid. The name format is invalid.
400 InvalidStatus invalid physical connection status. The specified physical connection status is invalid.
400 InvalidBandwidth invalid physical connection banwidth. The specified physical connection bandwidth is invalid.
400 InvalidRedundantPhysicalConnection redundant physical connection doesn't belong to current user. The specified 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 circuit code is invalid.

See common error codes