Applies for an Express Connect circuit.

Usage notes

After your application is approved, the Express Connect circuit changes to the Initial state. You can contact the Internet service provider (ISP) to start construction.

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

  • If your Alibaba Cloud account has more than five Express Connect circuits that are not in the Enabled state, you cannot apply for another Express Connect circuit.
  • If your account has an Express Connect circuit with overdue payments, you cannot apply for another Express Connect circuit.

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 ap-cn-beijing-ft-A

The ID of the access point to which the Express Connect circuit belongs.

ClientToken String Yes 123e4567-e89b-12d3-a456-426655440000

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 ISP of the Express Connect circuit. Valid values:

  • CT: China Telecom
  • CU: China Unicom
  • CM: China Mobile
  • CO: other ISPs in mainland China
  • Equinix :Equinix
  • Other: other ISPs outside mainland China
PeerLocation String Yes XX street

The geographical location of the data center.

RegionId String Yes cn-shanghai

The region ID of the Express Connect circuit.

You can call the DescribeRegions operation to query the most recent region list.

Type String No VPC

The type of the Express Connect circuit. The default value is VPC.

bandwidth Integer No 10

The bandwidth value of the bandwidth plan. Unit: Mbit/s. Valid values: 5 to 5000.

PortType String No 1000Base-T

The port type of the Express Connect circuit. Valid values:

  • 100Base-T: a copper port that supports 100 Mbit/s of bandwidth
  • 1000Base-T: a copper port that supports 1,000 Mbit/s of bandwidth
  • 1000Base-LX: a single-mode fiber port that supports 1,000 Mbit/s of bandwidth (10 kilometers)
  • 10GBase-T: a copper port that supports 10,000 Mbit/s of bandwidth
  • 10GBase-LR: a single-mode fiber port that supports 10,000 Mbit/s of bandwidth (10 kilometers)
RedundantPhysicalConnectionId String No pc-119mfjz******

The ID of the standby Express Connect circuit. The standby Express Connect circuit must be in the Allocated, Confirmed, or Enabled state.

Description String No description

The description of the Express Connect circuit.

The description must be 2 to 256 characters in length. It must start with a letter, but cannot start with http:// or https://.

Name String No test

The name of the Express Connect circuit.

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

CircuitCode String No longtel001

The circuit code provided by the ISP of the Express Connect circuit.

Response parameters

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

The ID of the Express Connect circuit.

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

The ID of the request.

Examples

Sample requests

http(s)://[Endpoint]/?Action=CreatePhysicalConnection
&AccessPointId=ap-cn-beijing-ft-A
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&LineOperator=CT
&PeerLocation=XX street
&RegionId=cn-shanghai
&<Common request parameters>

Sample success responses

XML format

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

JSON format

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

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 Type is set to an invalid value.
400 InvalidPeerLocation.Malformd The PeerLocation provided was invalid. The error message returned because PeerLocation is set to an invalid value.
400 InvalidLineOperator.Malformd The LineOperator provided was invalid. The error message returned because LineOperator is set to an invalid value.
400 InvalidPortType.Malformd The PortType provided was invalid. The error message returned because the specified port type 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 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 error message returned because the specified standby Express Connect circuit 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 Express Connect circuits that are associated with the specified access point has reached the upper limit.
400 InvalidBandwidth invalid physical connection banwidth. The error message returned because the specified bandwidth value of the Express Connect circuit is invalid.
400 InvalidRedundantPhysicalConnection redundant physical connection doesn't belong to current user. The error message returned because the specified standby Express Connect circuit does not belong to your Alibaba Cloud account.
400 InvalidRedundantPhysicalConnectionStatus invalid redundant physical connection status. The error message returned because the standby Express Connect circuit is in an invalid state.
400 InvalidCircuitCode.Malformed circuitCode is illegal. The error message returned because CircuitCode is set to an invalid value.
400 QuotaExceeded.freePconnPerAP free physical connections count excceeded. The error message returned because the quota on Express Connect circuits is reached.

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