CreateDirectConnect
最近更新时间: 2025-10-20 17:05:52
1. 接口描述
接口请求域名： dc.api3.fincloud.tencent.cn。
申请物理专线接入。
默认接口请求频率限制：20次/秒。
接口更新时间：2022-11-29 15:52:08。
接口既验签名又鉴权。
2. 输入参数
以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见公共请求参数。
| 参数名称 | 必选 | 允许NULL | 类型 | 描述 |
|---|---|---|---|---|
| Action | 是 | 否 | String | 公共参数，本接口取值：CreateDirectConnect |
| Version | 是 | 否 | String | 公共参数，本接口取值：2018-04-10 |
| Region | 是 | 否 | String | 公共参数，地域信息可通过DescribeRegions接口查看产品支持的地域列表 |
| DirectConnectName | 是 | 否 | String | 物理专线的名称。 |
| AccessPointId | 是 | 否 | String | 物理专线所在的接入点。<br>您可以通过调用 DescribeAccessPoints接口获取地域ID。所选择的接入点必须存在且处于可接入的状态。 |
| LineOperator | 是 | 否 | String | 提供接入物理专线的运营商。ChinaTelecom：中国电信， ChinaMobile：中国移动，ChinaUnicom：中国联通， In-houseWiring：楼内线，ChinaOther：中国其他， InternationalOperator：境外其他。 |
| Location | 是 | 否 | String | 本地数据中心的地理位置。 |
| CloudPortType | 是 | 否 | String | 物理专线接入端口类型,取值：100Base-T：百兆电口,1000Base-T（默认值）：千兆电口,1000Base-LX：千兆单模光口（10千米）,10GBase-T：万兆电口10GBase-LR：万兆单模光口（10千米），默认值，千兆单模光口（10千米）。 |
| Bandwidth | 是 | 否 | Int64 | 物理专线接入接口带宽，单位为Mbps，默认值为1000，取值范围为 [2, 10240]。 |
| RedundantDirectConnectId | 否 | 否 | String | 冗余物理专线的ID。 |
| CustomerName | 是 | 否 | String | 物理专线申请者姓名。默认从账户体系获取。 |
| CustomerContactMail | 是 | 否 | String | 物理专线申请者联系邮箱。默认从账户体系获取。 |
| CustomerContactNumber | 是 | 否 | String | 物理专线申请者联系号码。默认从账户体系获取。 |
| IdcPortType | 是 | 否 | String | 物理专线接入IDC侧端口类型,取值：100Base-T：百兆电口,1000Base-T（默认值）：千兆电口,1000Base-LX：千兆单模光口（10千米）,10GBase-T：万兆电口10GBase-LR：万兆单模光口（10千米），默认值，千兆单模光口（10千米）。 |
| IdcCity | 是 | 否 | String | 本地数据中心所在城市 |
3. 输出参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| DirectConnectIdSet | String | 物理专线的ID。 |
| RequestId | String | 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。 |
4. 错误码
以下仅列出了接口业务逻辑相关的错误码，其他错误码详见公共错误码。
| 错误码 | 描述 |
|---|---|
| InternalError | 内部错误 |
| LimitExceeded | 超过配额限制 |
| UnsupportedOperation | 操作不支持。 |
| ResourceNotFound | 资源不存在 |
| LimitExceeded.DirectConnectLimitExceeded | 物理专线数已达上限。 |
| UnauthorizedOperation | 未授权操作 |
| InvalidParameter.PortBandwidthMismatch | 云侧、IDC侧端口带宽不匹配。 |
| InvalidParameter.DcBandwidthOutOfRange | 物理专线带宽超出范围。物理专线带宽需大于1，不小于专线通道最大带宽，不大于端口带宽，非超卖模式下不小于专线通道带宽和。 |