申请物理专线

最近更新时间: 2026-09-17 00:06:03

1. 接口描述

接口请求域名： dc.api3.fincloud.tencent.cn。

申请物理专线接入。

默认接口请求频率限制：20次/秒。

接口更新时间：2025-09-10 20:49:43。

接口既验签名又鉴权。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见公共请求参数。

参数名称 必选 允许NULL 类型 描述
Action 是 否 String 公共参数，本接口取值：CreateDirectConnect
Version 是 否 String 公共参数，本接口取值：2018-04-10
Region 是 否 String 公共参数，地域信息可通过DescribeRegions接口查看产品支持的地域列表
DirectConnectName 是 否 String 物理专线的名称。
示例值： 地方航信物理专线1
AccessPointId 是 否 String 物理专线所在的接入点。
您可以通过调用 DescribeAccessPoints接口获取地域ID。所选择的接入点必须存在且处于可接入的状态。
示例值： ap-cn-place-hx
LineOperator 是 否 String 提供接入物理专线的运营商。Telecom：电信， Mobile：移动，Unicom：联通，In-houseWiring：楼内线，Other：其他， InternationalOperator：国际其他。
示例值： Mobile
Location 是 否 String 本地数据中心的地理位置。
示例值： 地方市海淀区西格玛A大厦14楼
CloudPortType 是 否 String 物理专线接入端口类型,取值：100Base-T：百兆电口,1000Base-T（默认值）：千兆电口,1000Base-LX：千兆单模光口（10千米）,10GBase-T：万兆电口10GBase-LR：万兆单模光口（10千米），默认值，千兆单模光口（10千米）。
示例值： 100Base-T
Bandwidth 是 否 Int64 物理专线接入接口带宽，单位为Mbps，默认值为1000，取值范围为 [2, 10240]。
示例值： 1000
RedundantDirectConnectId 否 否 String 冗余物理专线的ID。
示例值： dc-12345678
CustomerName 是 否 String 物理专线申请者姓名。默认从账户体系获取。
示例值： 张三
CustomerContactMail 是 否 String 物理专线申请者联系邮箱。默认从账户体系获取。
示例值： 12345@mail.com
CustomerContactNumber 是 否 String 物理专线申请者联系号码。默认从账户体系获取。
示例值： 110
IdcPortType 是 否 String 物理专线接入IDC侧端口类型,取值：100Base-T：百兆电口,1000Base-T（默认值）：千兆电口,1000Base-LX：千兆单模光口（10千米）,10GBase-T：万兆电口10GBase-LR：万兆单模光口（10千米），默认值，千兆单模光口（10千米）。
示例值： 100Base-T
IdcCity 是 否 String 本地数据中心所在城市
示例值： place

3. 输出参数

参数名称 类型 描述
DirectConnectIdSet Array of String 物理专线的ID。
示例值： ["dc-abcdefgh"]
RequestId String 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

4. 错误码

以下仅列出了接口业务逻辑相关的错误码，其他错误码详见公共错误码。

错误码 描述
InternalError 内部错误
LimitExceeded 超过配额限制
UnsupportedOperation 操作不支持。
ResourceNotFound 资源不存在
LimitExceeded.DirectConnectLimitExceeded 物理专线数已达上限。
UnauthorizedOperation 未授权操作
InvalidParameter.PortBandwidthMismatch 云侧、IDC侧端口带宽不匹配。
InvalidParameter.DcBandwidthOutOfRange 物理专线带宽超出范围。物理专线带宽需大于1，不小于专线通道最大带宽，不大于端口带宽，非超卖模式下不小于专线通道带宽和。

5. 示例

示例1 申请物理专线接入

输入示例

{
  "DirectConnectName": "glinn-dc-test2",
  "AccessPointId": 26,
  "LineOperator": "zgdx",
  "Location": "binghaidadao",
  "CloudPortType": "100Base-T",
  "Bandwidth": 100,
  "CustomerName": "glinnwang",
  "CustomerContactMail": "1471321076@123.com",
  "CustomerContactNumber": "86-13819280788",
  "IdcPortType": "100Base-T",
  "IdcCity": "sz"
}

输出示例

{
  "Response": {
    "DirectConnectIdSet": [
      "dc-izv0jajv"
    ],
    "RequestId": "79d8b563-c51a-34f1-4187-7263f897dd83"
  }
}