Applies for a physical connection port.

After a physical connection port is approved, the physical connection changes to the Initial state. You can contact the service provider to start the construction.

When you call this operation, take note of the following items:

  • If more than five physical connections are not in the Enabled state, you cannot apply for another physical connection port.
  • If your account has a physical connection with overdue payments, you cannot create physical connections.

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 CreatePhysicalConnection

The operation that you want to perform.

Set the value to CreatePhysicalConnection.

AccessPointId String Yes AccessPointId=ap-cn-beijing-ft-A

The access point that is associated with the physical connection. You can call the DescribeAccessPoints operation to query the ID of the region where the access point resides.

ClientToken String Yes 5A2CFF0E-*********5718-45B5-9D4D-70B3FF3898

The client token that is used to ensure the idempotence of the request. You can use the client to generate the value, but you must make sure that it is unique among different requests. The token can contain only ASCII characters and cannot exceed 64 characters in length.

LineOperator String Yes CT

The service provider of the leased line. Valid values:

  • CT: China Telecom
  • CU: China Unicom
  • CM: China Mobile
  • CO: other service providers in mainland China
  • Equinix: Equinix
  • Other: other service providers outside mainland China
PeerLocation String Yes Zhejiang province --- vfjdbg_21e

The geographical location of the data center.

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.

Type String Yes VPC

The type of the physical connection. Default value: VPC.

bandwidth Integer No 10

The bandwidth of the bandwidth plan. Unit: Mbit/s. Valid values: 5 to 5,000.

PortType String Yes 1000Base-T

The type of the physical connection port. Valid values:

  • 100Base-T: a copper port that forwards traffic at 100 Mbit/s.
  • 1000Base-T (default): a copper port that forwards traffic at 1,000 Mbit/s.
  • 10GBase-T: a copper port that forwards traffic at 10 Gbit/s.
  • 1000Base-LX: a single-mode fiber port that forwards traffic at 1,000 Mbit/s. 10 km of communication distance is supported.
  • 10GBase-LR: a single-mode fiber port that forwards traffic at 10 Gbit/s. 10 km of communication distance is supported.
RedundantPhysicalConnectionId String Yes pc-119mfjz*******m7

The ID of the standby physical connection. The standby physical connection must be in the Allocated, Confirmed, or Enabled state.

Description String Yes physical connection description

The description of the physical connection. The description must be 2 to 256 characters in length. It must start with a letter or Chinese character and cannot start with http:// or https://.

Name String Yes test

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 or Chinese character and cannot start with http:// or https://.

CircuitCode String Yes longtel001

The circuit code provided by the service provider for the physical connection.

Response parameters

Parameter Type Example Description
PhysicalConnectionId String vpc-bp12mw******1f8k3jgygk9bmlj

The ID of the physical connection.

RequestId String 8A6A5EC5-6F6C-4906-9689-56ACE58A13E0

The ID of the request.

Examples

Sample requests

http(s)://[Endpoint]/? Action=CreatePhysicalConnection
&AccessPointId=AccessPointId=ap-cn-beijing-ft-A
&ClientToken=5A2CFF0E-*********5718-45B5-9D4D-70B3FF3898
&LineOperator=CT
&PeerLocation=Zhejiang province---vfjdbg_21e
&RegionId=cn-shanghai
&<Common request parameters>

Sample success responses

XML format

<CreatePhysicalConnectionResponse>
  <RequestId>8A6A5EC5-6F6C-4906-9689-56ACE58A13E0</RequestId>
  <PhysicalConnectionId>vpc-bp12mw******1f8k3jgygk9bmlj</PhysicalConnectionId>
</CreatePhysicalConnectionResponse>

JSON format

{"RequestId":"8A6A5EC5-6F6C-4906-9689-56ACE58A13E0",
"PhysicalConnectionId":"vpc-bp12mw******1f8k3jgygk9bmlj"}

Error codes

HttpCode Error code Error message Description
400 InvalidAccessPointId.NotEnabled Invalid access point status. The error message returned because the access point is unavailable.
400 InvalidType.Malformd The Type provided was invalid. The error message returned because the value of the Type parameter is invalid.
400 InvalidPeerLocation.Malformd The PeerLocation provided was invalid. The error message returned because the value of the PeerLocation parameter is invalid.
400 InvalidLineOperator.Malformd The LineOperator provided was invalid. The error message returned because the value of the LineOperator parameter is invalid.
400 InvalidPortType.Malformd The PortType provided was invalid. The error message returned because the type of the port is invalid.
400 InvalidDescription.Malformed The specifid ? Description? is not valid. The error message returned because the format of the resource description is invalid. The value must be 2 to 256 characters in length and cannot start with http:// or https://.
400 InvalidRedundantPhysicalConnectionId.NotFound The RedundantPhysicalConnectionId does not found. The error message returned because the specified standby physical connection does not exist.
400 InvalidName.Malformed The specified ? Name? is not valid. The error message returned because the format of the name is invalid.
400 QuotaExceeded.pConnPerAP Physical connection count per ap quota exceed. The error message returned because the number of physical connections that are associated with the specified access point exceeds the limit.
400 InvalidBandwidth invalid physical connection banwidth. The error message returned because the maximum bandwidth 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 account.
400 InvalidRedundantPhysicalConnectionStatus invalid redundant physical connection status. The error message returned because you cannot perform the operation when the standby physical connection is in the current state.
400 InvalidCircuitCode.Malformed circuitCode is illegal. The error message returned because the value of the CircuitCode parameter is invalid.
400 QuotaExceeded.freePconnPerAP free physical connections count excceeded. The error message returned because the physical connection quota is reached.

For a list of error codes, visit the API Error Center.