申请物理专线

最近更新时间:2024-09-02 01:33:22

我的收藏

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 物理专线申请者是否签署了用户使用协议。默认已签署。
示例值:是
Tags.N Array of Tag 标签键值对

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 操作不支持。