edit-icon download-icon


Last Updated: Apr 09, 2018


Modify the attributes of a physical connection.

Note the following before modifying the attributes of a physical connection:

  • If you want to modify the specification or the redundant physical connection, the physical connection must be in the Initial or Rejected status.

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

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

Request parameters

Name Type Required Description
Action String Yes

The action to perform.

Valid value: CreatePhysicalConnection

RegionId String Yes

The region where the physical connection is located.

You can obtain the region ID by calling the DescribeRegions API.

PhysicalConnectionId String Yes The ID of the physical connection.
LineOperator String No

The network operator of the physical connection. Valid value:

  • CT: China Telecom

  • CU: China Unicom

  • CM: China Mobile

  • CO: Other (China)

  • Equinix: Equinix

  • Other: Other (outside China)

Bandwidth String No The bandwidth in Mbps of the physical connection. The default value is 100 and the valid value is [2, 10240].
PeerLocation String No The geographic location of the local data center.
PortType String No The port type of the physical connection. Valid value:
  • 100Base-T: 100-MB electrical port

  • 1000Base-T: 1-GB electrical port

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

  • 10GBase-T: 10-GB electrical port

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

RedundantPhysicalConnectionId String No

The ID of the physical connection used as the redundant physical connection.

The redundant physical connection must be in the allocated, confirmed, or enabled status.

CircuitCode String No The circuit code provided by the network operator for the physical connection.
Name String No

The name of the physical connection.

The name must start with an English letter, but cannot start withhttp:// or https://.

The name can contain from 2 to 128 characters including a-z, A-Z, 0-9, underlines, and hyphens.

Description String No

The description of the physical connection.

The description must start with English letters, but cannot start with http:// or https://.

The description can contain from 2 to 256 characters.

ClientToken String No

A client token used to guarantee the idempotence of requests. This parameter value is generated by the client and must be unique. It cannot exceed 64 ASCII characters.

For more information, see How to ensure idempotence.

Response parameters

Name Type Description
RequestId String The ID of the request.

Error codes

See VPC API Error Center.


Request example

  1. http://vpc.aliyuncs.com/?Action=ModifyPhysicalConnectionAttribute
  2. &PhysicalConnectionId=pc-2zeoaxkq3xxxxx
  3. &RegionId=cn-beijing
  4. &Name=test3
  5. &<CommonParameters>

Response example

JSON format

  1. {
  2. "RequestId": "8591E598-8519-48A9-9E08-72551537C199"
  3. }
Thank you! We've received your feedback.