Applies for a physical connection.

After the physical connection application is approved, the status of the physical connection changes to Initial. At this stage, you need to instruct your service provider to start data center cable installation.

Note the following before you call this API:

  • The number of physical connections that are not in the Enabled state must be no more than five.
  • If a physical connection under your account has an overdue payment, you cannot apply for more physical connections.

Debug

Use OpenAPI Explorer to perform debug operations and generate SDK code examples.

Request parameters

Parameter Type Required? Example value Description
Action String  Yes CreatePhysicalConnection

The name of this action.

Value: CreatePhysicalConnection

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

The ID of the access point used by the physical connection. To query the region ID, call DescribeRegions.

ClientToken String Yes dgfdg12344ff

The client token. It is 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.

LineOperator String Yes CT

The service provider that provides 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---vfjdbg_21e

The geographic location of the on-premises data center.

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.

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

Name String No test

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

PortType String No 1000Base-T

Optional. The port type of the physical connection. Valid values:

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

Type String No VPC

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

bandwidth Integer No 10

Optional. The peak bandwidth of the bandwidth package. Value range: 5 to 5000. Unit: Mbit/s

Response parameters

Parameter Type Example value Description
PhysicalConnectionId String vpc-bp12mw1f8k3jgygk9bmlj

The ID of the physical connection.

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

The request ID.

Examples

Request example


http(s)://[Endpoint]/? Action=CreatePhysicalConnection
&AccessPointId=AccessPointId=ap-cn-beijing-ft-A
&ClientToken=dgfdg12344ff
&LineOperator=CT
&PeerLocation=Zhejiang---vfjdbg_21e
&RegionId=cn-shanghai
&<CommonParameters>

Response examples

XML format

<CreatePhysicalConnectionResponse>
  <RequestId>8A6A5EC5-6F6C-4906-9689-56ACE58A13E0"</RequestId>
  <PhysicalConnectionId>pc-*************</PhysicalConnectionId>
</CreatePhysicalConnectionResponse>

JSON format

{
	"RequestId":"8A6A5EC5-6F6C-4906-9689-56ACE58A13E0",
	"PhysicalConnectionId":"pc-**************"
}

Error codes

HTTP status code Error code Error message  Description
400 InvalidAccessPointId.NotEnabled Invalid access point status. The access point is invalid.
400 InvalidType.Malformd The Type provided was invalid. The value of the Type parameter is invalid.
400 InvalidPeerLocation.Malformd The PeerLocation provided was invalid. The value of the PeerLocation parameter is invalid.
400 InvalidLineOperator.Malformd The LineOperator provided was invalid. The specified value of the LineOperator 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 description is invalid. The description must be 2 to 256 characters in length and cannot start with http:// or https://.
400 InvalidRedundantPhysicalConnectionId.NotFound The RedundantPhysicalConnectionId does not found. The specified redundant physical connection does not exist.
400 InvalidName.Malformed The specified ? Name? is not valid. The name is invalid.
400 QuotaExceeded.pConnPerAP Physical connection count per ap quota exceed. The physical connection quota of the access point is exceeded.
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. The redundant physical connection does not belong to your account.
400 InvalidRedundantPhysicalConnectionStatus invalid redundant physical connection status. The status of the specified redundant physical connection is invalid.
400 InvalidCircuitCode.Malformed circuitCode is illegal. The specified value of the CircuitCode parameter is invalid.
400 QuotaExceeded.freePconnPerAP free physical connections count excceeded. The physical connection quota is exceeded.

See common error codes.