1. Interface Description
Interface request domain name: dc.api3.convergecloud.com.
Apply for physical DC access.
Default interface request rate limit: 20 times per second.
Interface update time: 2025-08-22 00:55:12.
The interface is both signature verification and authentication.
2. Input Parameters
The following list of request parameters only lists interface request parameters and some public parameters, For a complete list of public parameters see public request parameters.
| Parameter name | Required | Allow NULL | Type | Description |
|---|---|---|---|---|
| Action | Yes | No | String | Public parameter, The value of this interface: CreateDirectConnect |
| Version | Yes | No | String | Public parameter, The value of this interface: 2018-04-10 |
| Region | No | No | String | Public parameter,Regional information A list of supported geographies is available through the DescribeRegions interface |
| DirectConnectName | Yes | No | String | Physical DC Name Example: Local Hangxin Connection 1 |
| AccessPointId | Yes | No | String | Access point for physical DC. You can access the region ID by calling the DescribeAccessPoints interface. The selected access point must exist and be in an accessible state. Example: ap-cn-place-hx |
| LineOperator | Yes | No | String | ISPs providing access connection. Telecom: CTCC; Mobile: CMCC; Unicom: CUCC; In-houseWiring: in-house wiring; Other: others; InternationalOperator: others mainland. Example: Mobile |
| Location | Yes | No | String | Geographical location of the local data center. Example: 14th Floor, Sigma A Building, Haidian District, Local City |
| CloudPortType | Yes | No | String | Physical DC port type, values: 100 Base-T: Fast Ethernet port, 1000 Base-T (default value): Gigabit Ethernet port, 1000 Base-LX: Gigabit single-mode fiber port (10 km), 10 GBase-T: 10 Gigabit Ethernet port, 10 GBase-LR: 10 Gigabit single-mode fiber port (10 km), default value, Gigabit single-mode fiber port (10 km). Example: 100Base-T |
| Bandwidth | Yes | No | Int64 | Physical DC interface bandwidth, in a unit of Mbps, with a default value of 1000, and a value range of [2, 10240]. Example: 1000 |
| RedundantDirectConnectId | No | No | String | Redundant physical DC ID. Example: dc-12345678 |
| CustomerName | Yes | No | String | Name of physical DC applicant, obtained from account system by default. Example: John Doe |
| CustomerContactMail | Yes | No | String | E-mail address of physical DC applicant, obtained from account system by default. Example: 12345@mail.com |
| CustomerContactNumber | Yes | No | String | Contact number of physical DC applicant, obtained from account system by default. Example: 110 |
| IdcPortType | Yes | No | String | Physical DC IDC side port type, values: 100 Base-T: Fast Ethernet port, 1000 Base-T (default value): Gigabit Ethernet port, 1000 Base-LX: Gigabit single-mode fiber port (10 km), 10 GBase-T: 10 Gigabit Ethernet port, 10 GBase-LR: 10 Gigabit single-mode fiber port (10 km), default value, Gigabit single-mode fiber port (10 km). Example: 100Base-T |
| IdcCity | Yes | No | String | City Where Data Center Locates Example: place |
3. Output Parameters
| Parameter name | Type | Description |
|---|---|---|
| DirectConnectIdSet | Array of String | Physical DC ID Example: ["dc-abcdefgh"] |
| RequestId | String | Unique request id, Each request will return. The RequestId of the request needs to be provided when locating the problem. |
4. Error Code
The following lists only the error codes related to the interface business logic, For other error codes, see public ErrorCode.
| Error Code | Description |
|---|---|
| InternalError | Internal error |
| LimitExceeded | Exceeded quota limit |
| UnsupportedOperation | Operation unsupported. |
| ResourceNotFound | The resource does not exist. |
| LimitExceeded.DirectConnectLimitExceeded | Number of physical DCs has reached a limit. |
| UnauthorizedOperation | Unauthorized operation |
| InvalidParameter.PortBandwidthMismatch | Port bandwidths of the cloud side and the IDC side mismatch. |
| InvalidParameter.DcBandwidthOutOfRange | Physical DC bandwidth is out of range. Physical DC bandwidth is required to be greater than 1, not less than the maximum bandwidth of the private channel, not greater than the port bandwidth, and not less than a sum of private channel bandwidths in a non-overselling mode. |