专线接入 申请物理专线

一、1. 接口描述

默认接口请求频率限制：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
FaultReportContactEmail	否	String	报障联系邮箱。示例值：lisi@tencent.com
SignLaw	否	Boolean	物理专线申请者是否签署了用户使用协议。默认已签署。示例值：true
Tags.N	否	Array of Tag	标签键值对
IsMacSec	否	Boolean	是否MACsec需求示例值：true

三、3. 输出参数

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

四、示例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"
}
}

十、腾讯云 API 平台

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

十一、API Inspector

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

十二、SDK

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

·Tencent Cloud SDK 3.0 for Python: CNB, GitHub, Gitee

·Tencent Cloud SDK 3.0 for Java: CNB, GitHub, Gitee

·Tencent Cloud SDK 3.0 for PHP: CNB, GitHub, Gitee

·Tencent Cloud SDK 3.0 for Go: CNB, GitHub, Gitee

·Tencent Cloud SDK 3.0 for Node.js: CNB, GitHub, Gitee

·Tencent Cloud SDK 3.0 for .NET: CNB, GitHub, Gitee

·Tencent Cloud SDK 3.0 for C++: CNB, GitHub, Gitee

·Tencent Cloud SDK 3.0 for Ruby: CNB, GitHub, Gitee

十三、命令行工具

·Tencent Cloud CLI 3.0

十四、6. 错误码

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

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