专线接入
有奖捉虫：办公协同&微信生态&物联网文档专题 HOT
文档中心 > 专线接入 > API 文档 > 专线接入相关接口 > 申请物理专线

申请物理专线

最近更新时间：2024-03-12 01:25:00

我的收藏

本页目录：

1. 接口描述

接口请求域名： dc.tencentcloudapi.com 。

申请物理专线接入。
调用该接口时，请注意：
账号要进行实名认证，否则不允许申请物理专线；
若账户下存在欠费状态的物理专线，则不能申请更多的物理专线。

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

推荐使用 API Explorer
点击调试
API Explorer 提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力。您可查看每次调用的请求内容和返回结果以及自动生成 SDK 调用示例。

2. 输入参数

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

参数名称 必选 类型 描述
Action 是 String 公共参数，本接口取值：CreateDirectConnect。
Version 是 String 公共参数，本接口取值：2018-04-10。
Region 否 String 公共参数，此参数为可选参数。
DirectConnectName 是 String 物理专线的名称。
示例值：北京航信物理专线1
AccessPointId 是 String 物理专线所在的接入点。
您可以通过调用 DescribeAccessPoints接口获取地域ID。所选择的接入点必须存在且处于可接入的状态。
示例值：ap-cn-beijing-hx
LineOperator 是 String 提供接入物理专线的运营商。
ChinaTelecom：中国电信；
ChinaMobile：中国移动；
ChinaUnicom：中国联通；
In-houseWiring：楼内线；
ChinaOther：中国其他；
InternationalOperator：境外其他。
示例值：ChinaMobile
PortType 是 String 物理专线接入端口类型，取值：
100Base-T：百兆电口；
1000Base-T（默认值）：千兆电口；
1000Base-LX：千兆单模光口（10千米）；
10GBase-T：万兆电口；
10GBase-LR（默认值）：万兆单模光口（10千米）。
示例值：1000Base-LX
CircuitCode 否 String 运营商或者服务商为物理专线提供的电路编码。
示例值：北京航信ANE0348NP
Location 否 String 本地数据中心的地理位置。
示例值：北京市海淀区西格玛A大厦14楼
Bandwidth 否 Integer 物理专线接入接口带宽，单位为Mbps，默认值为1000，取值范围为 [2, 10240]。
示例值：1000
RedundantDirectConnectId 否 String 冗余物理专线的ID。
示例值：dc-12345678
Vlan 否 Integer 物理专线调试VLAN。默认开启VLAN，自动分配VLAN。
示例值：100
TencentAddress 否 String 物理专线调试腾讯侧互联 IP。默认自动分配。
示例值：IP地址
CustomerAddress 否 String 物理专线调试用户侧互联 IP。默认自动分配。
示例值：客户端IP地址
CustomerName 否 String 物理专线申请者姓名。默认从账户体系获取。
示例值：张三
CustomerContactMail 否 String 物理专线申请者联系邮箱。默认从账户体系获取。
示例值：12345@qq.com
CustomerContactNumber 否 String 物理专线申请者联系号码。默认从账户体系获取。
示例值：180XXXXXXXX
FaultReportContactPerson 否 String 报障联系人。
示例值：李四
FaultReportContactNumber 否 String 报障联系电话。
示例值：181XXXXXXXX
SignLaw 否 Boolean 物理专线申请者是否签署了用户使用协议。默认已签署。
示例值：是

3. 输出参数

参数名称 类型 描述
DirectConnectIdSet Array of String 物理专线的ID。
示例值：["dc-abcdefgh"]
RequestId String 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。

4. 示例

示例1 申请物理专线1

申请物理专线，接入点为北京航信，中国移动线路，云端端口为千兆单模光口（1000Base-LX）。

输入示例

https://dc.tencentcloudapi.com/?Action=CreateDirectConnect
&DirectConnectName=北京航信物理专线1
&AccessPointId=ap-cn-beijing-hx
&LineOperator=ChinaMobile
&CircuitCode=北京航信ANE0348NP
&Location=北京市海淀区西格玛A大厦14楼
&PortType=1000Base-LX
&Bandwidth=1000
&CustomerName=张三
&CustomerContactMail=12345@qq.com
&CustomerContactNumber=18812345678
&<公共请求参数>

输出示例

{
    "Response": {
        "DirectConnectIdSet": [
            "dc-abcdefgh"
        ],
        "RequestId": "24a0d7e5-4c13-49be-aa16-94f698fbef3e"
    }
}

示例2 申请物理专线2

申请物理专线，接入点为南山，中国移动线路，云端端口为千兆单模光口（1000Base-LX），有冗余专线。

输入示例

https://dc.tencentcloudapi.com/?Action=CreateDirectConnect
&DirectConnectName=物理专线1
&AccessPointId=ap-cn-shenzhen-ns-A
&LineOperator=ChinaMobile
&CircuitCode=深圳南山ANE0348NP
&Location=广东省深圳市南山区科技园A大厦14楼
&PortType=1000Base-LX
&Bandwidth=1000
&RedundantDirectConnectId=dc-abcdedf
&Vlan=100
&TencentAddress=172.168.1.1/30
&CustomerAddress=172.168.1.2/30
&CustomerName=张三
&CustomerContactMail=12345@qq.com
&CustomerContactNumber=18812345678
&<公共请求参数>

输出示例

{
    "Response": {
        "DirectConnectIdSet": [
            "dc-abcdefgh"
        ],
        "RequestId": "24a0d7e5-4c13-49be-aa16-94f698fbef3e"
    }
}

5. 开发者资源

腾讯云 API 平台

腾讯云 API 平台 是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台，方便您从同一入口查询及使用腾讯云提供的所有 API 服务。

API Inspector

用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况，并自动生成各语言版本的 API 代码，也可前往 API Explorer 进行在线调试。

SDK

云 API 3.0 提供了配套的开发工具集（SDK），支持多种编程语言，能更方便的调用 API。

命令行工具

6. 错误码

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

错误码 描述
InternalError 内部错误。
LimitExceeded 超过配额限制。
LimitExceeded.DirectConnectLimitExceeded 物理专线数已达上限。
ResourceNotFound 资源不存在。
UnauthorizedOperation 未授权操作。
UnsupportedOperation 操作不支持。
中国站