申请物理专线

最近更新时间:2019-05-09 22:06:42

1. 接口描述

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

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

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

2. 输入参数

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

参数名称 必选 类型 描述
Action String 公共参数,本接口取值:CreateDirectConnect
Version String 公共参数,本接口取值:2018-04-10
Region String 公共参数,本接口不需要传递此参数。
DirectConnectName String 物理专线的名称。
AccessPointId String 物理专线所在的接入点。
您可以通过调用 DescribeAccessPoints接口获取地域ID。所选择的接入点必须存在且处于可接入的状态。
LineOperator String 提供接入物理专线的运营商。ChinaTelecom:中国电信, ChinaMobile:中国移动,ChinaUnicom:中国联通, In-houseWiring:楼内线,ChinaOther:中国其他, InternationalOperator:境外其他。
Location String 本地数据中心的地理位置。
PortType String 物理专线接入端口类型,取值:100Base-T:百兆电口,1000Base-T(默认值):千兆电口,1000Base-LX:千兆单模光口(10千米),10GBase-T:万兆电口10GBase-LR:万兆单模光口(10千米),默认值,千兆单模光口(10千米)。
CircuitCode String 运营商或者服务商为物理专线提供的电路编码。
Bandwidth Integer 物理专线接入接口带宽,单位为Mbps,默认值为1000,取值范围为 [2, 10240]。
RedundantDirectConnectId String 冗余物理专线的ID。
Vlan Integer 物理专线调试VLAN。默认开启VLAN,自动分配VLAN。
TencentAddress String 物理专线调试腾讯侧互联 IP。默认自动分配。
CustomerAddress String 物理专线调试用户侧互联 IP。默认自动分配。
CustomerName String 物理专线申请者姓名。默认从账户体系获取。
CustomerContactMail String 物理专线申请者联系邮箱。默认从账户体系获取。
CustomerContactNumber String 物理专线申请者联系号码。默认从账户体系获取。
FaultReportContactPerson String 报障联系人。
FaultReportContactNumber String 报障联系电话。

3. 输出参数

参数名称 类型 描述
DirectConnectIdSet Array of String 物理专线的ID。
RequestId String 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

4. 示例

示例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 创建物理专线

申请物理专线,接入点为南山,中国移动线路,云端端口为千兆单模光口(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 Explorer

该工具提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力,能显著降低使用云 API 的难度,推荐使用。

SDK

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

命令行工具

6. 错误码

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

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