Applies for an Express Connect circuit.

Description

You can apply for a dedicated Express Connect circuit or create a hosted connection for a tenant. After your application is approved, the Express Connect circuit changes to the Initial state. You can contact the connectivity provider 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 Alibaba Cloud 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
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.

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

The access point ID of the Express Connect circuit.

Type String No VPC

The type of resource to which the Express Connect circuit is connected. Default value: VPC.

LineOperator String Yes CT

The connectivity provider of the Express Connect circuit. Valid values:

  • CT: China Telecom
  • CU: China Unicom
  • CM: China Mobile
  • CO: other connectivity providers in the Chinese mainland
  • Equinix: Equinix
  • Other: other connectivity providers outside the Chinese mainland
bandwidth Integer No 10

The maximum bandwidth of the hosted connection. Unit: Mbit/s. Valid values: 50, 100, 200, 300, 400, 500, 1000, 2000, 4000, 5000, 8000, and 10000.

PeerLocation String Yes XX street

The geographical location of the data center.

PortType String No 1000Base-T

The port type. Valid values:

  • 100Base-T: 100 Mbit/s copper Ethernet port
  • 1000Base-T: 1,000 Mbit/s copper Ethernet port
  • 1000Base-LX: 1,000 Mbit/s single-mode optical port (10 km)
  • 10GBase-T: 10,000 Mbit/s copper Ethernet port
  • 10GBase-LR: 10,000 Mbit/s single-mode optical port (10 km)
RedundantPhysicalConnectionId String No pc-119mfjzm****

The ID of the redundant Express Connect circuit. The redundant 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 letters, digits, underscores (_), and hyphens (-). The name must start with a letter but cannot start with http:// or https://.

CircuitCode String No longtel001

The circuit code of the Express Connect circuit. The circuit code is provided by the connectivity provider.

ClientToken String Yes 123e4567-e89b-12d3-a456-42665544****

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 the value is unique among different requests. The token can contain only ASCII characters and cannot exceed 64 characters in length.

Note If you do not set this parameter, the system uses RequestId as ClientToken. RequestId may be different for each API request.
Action String Yes CreatePhysicalConnection

The operation that you want to perform. Set the value to CreatePhysicalConnection.

Response parameters

Parameter Type Example Description
PhysicalConnectionId String pc-bp1ciz7ekd2grn1as****

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]/?RegionId=cn-shanghai
&AccessPointId=ap-cn-beijing-ft-A
&Type=VPC
&LineOperator=CT
&bandwidth=10
&PeerLocation=XX street
&PortType=1000Base-T
&RedundantPhysicalConnectionId=pc-119mfjzm****
&Description=description
&Name=test
&CircuitCode=longtel001
&ClientToken=123e4567-e89b-12d3-a456-42665544****
&Action=CreatePhysicalConnection
&ResourceOwnerId=253460731706911258
&Common request parameters

Sample success responses

XML format 

HTTP/1.1 200 OK
Content-Type:application/xml

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

JSON format 

HTTP/1.1 200 OK
Content-Type:application/json

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

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 specified 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 redundant 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 connected to the specified access point has reached the upper limit.
400 InvalidBandwidth invalid physical connection banwidth. The error message returned because the specified maximum bandwidth 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 redundant Express Connect circuit does not belong to your Alibaba Cloud account.
400 InvalidRedundantPhysicalConnectionStatus invalid redundant physical connection status. The error message returned because the redundant 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.
400 OperationFailed.PconnTrafficNotEnable The operation is failed because of PconnTrafficNotEnable. The error message returned because billing for outbound data transfer is disabled.

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