调用CreateDirectConnectConnection创建独享物理专线。

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Action String 必选示例值：CreateDirectConnectConnection

接口名称。当前 API 的名称为 CreateDirectConnectConnection。

Version String 必选示例值：2020-04-01

接口版本。当前 API 的版本为 2020-04-01。

DirectConnectConnectionName String 可选示例值：DAS-246-3_port1**0-conn

物理专线的名称。

以中文、字母、数字开头，只能包含中文、字母、数字、点号（.）、下划线（_）和短横线（-）。

长度限制为1 ~ 128个字符。

不传入该参数或该参数不传入数值时，默认为物理专线的ID。

Description String 可选示例值：This is a DirectConnect description.

物理专线的描述信息。

以中文、字母、数字开头，只能包含中文、字母、数字、点号（.）、空格（）、下划线（_）、中划线（-）、等号（=）、英文逗号（,）、中文逗号（，）、中文句号（。）。

长度限制为0 ~ 255个字符。

不传入该参数或该参数不传入数值时，默认为空字符串。

DirectConnectAccessPointId String 必选示例值：ap-cn-shanghai-***-A

物理专线接入点的ID。可调用DescribeDirectConnectAccessPoints查询专线接入点的信息。

LineOperator String 必选示例值：ChinaTelecom

物理专线的运营商，取值如下：

ChinaTelecom：中国电信

ChinaMobile：中国移动

ChinaUnicom：中国联通

ChinaOther：中国其他具有相应电信业务经营资质的运营商。

PortType String 必选示例值：1000Base

物理专线的端口类型，取值如下：

1000Base：表示1G光口。

10GBase：表示10G光口。

40GBase：表示40G光口。

100GBase：表示100G光口。

说明

40GBase、100GBase默认不开放，您可联系客户经理申请试用。未开通此功能应请避免传入40GBase、100GBase。

相关注意事项，请参见接入物理专线。

PortSpec String 必选示例值：1G

物理专线的端口规格。

独享专线支持的规格：1G、10G、40G、100G。

说明

40G、100G默认不开放，您可联系客户经理申请试用。未开通此功能应避免传入40G、100G。

Bandwidth Integer 可选示例值：1000

线路带宽，单位：Mbps，不传默认端口的规格带宽。

1000Base规格取值范围：1 ~ 1000

10GBase规格取值范围：1 ~ 10000

40GBase规格取值范围：1 ~ 40000

100GBase规格取值范围：1 ~ 100000

PeerLocation String 可选示例值：中国上海市静安区XX路XX号XX楼XX机房

本地IDC地址，请输入详细的地址。

CustomerName String 可选示例值：张*三

专线联系人的姓名。

CustomerContactPhone String 可选示例值：133****2233

专线联系人的电话。

CustomerContactEmail String 可选示例值：12345test@example.com

专线联系人的邮箱。

ClientToken String 可选示例值：123e4567-e89b-12d3-a456-42665544****

客户端Token，用于保证请求幂等性。

由客户端自动生成一个参数值，确保不同请求间该参数值唯一，避免当调用API超时或服务器内部错误时，客户端多次重试导致重复性操作。

仅支持ASCII字符，且不能超过64个字符。

若不传入ClientToken，则此次API调用不进行幂等校验。

Tags.N.Key String 可选示例值：key1

物理专线标签的标签键（Key）。

参数 - N - 参数：表示标签键（Key）的序号，取值范围：1、2、3、……、49、50，且N应按照连续的从小到大的顺序。

多个标签键（Key）之间用&分隔。

不能以 volc:和sys:开头，包括任意大小写形式。volc:和sys:开头为系统预留标签，禁止创建。

长度取值范围为1~128字符，允许输入各国语言文字、数字、空格（）、下划线（_）、点号（.）、半角冒号（:）、斜杠（/）、等号（=）、加号（+）、中划线（-）和@（@）。

Tags.N.Value String 可选示例值：value1

物理专线标签的标签值（Value）。

参数 - N - 参数：表示标签值（Value）的序号，取值范围：1、2、3、……、49、50，且N应按照连续的从小到大的顺序。

多个标签值（Value）之间用&分隔。

长度取值范围为0～256字符，不填默认为空。

允许输入各国语言文字、数字、空格（）、下划线（_）、点号（.）、半角冒号（:）、斜杠（/）、等号（=）、加号（+）、中划线（-）和@（@）。

大小写敏感，不能以空格开头或结尾。

说明

传入Tags.N.Value则必须传入Tags.N.Key。

ProjectName String 可选示例值：Project_1

物理专线所属的项目。不填默认为default，即创建的资源属于default项目。

AdvanceFeatures.N.MacSec Boolean 可选示例值：false

物理专线是否支持MacSec安全加密功能，取值如下：

ture：支持。

false（默认）：不支持。

说明

参数 - N - 参数：表示物理专线的序号，取值范围1～10。

仅接入点设备兼容MACsec功能时传入ture生效。

返回参数

下方仅列出本接口特有的返回参数。更多信息请参见返回结构。

DirectConnectConnectionId String 示例值：dcc-2743430pi718g7fap8t1t****

物理专线的ID。

请求示例

返回示例

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码	错误码	错误信息	说明
400	QuotaExceeded.DirectConnectConnection	You've reached the limit on the number of direct connect connections that you can create.	已达到可创建的物理专线的数量上限。
400	InvalidDirectConnectAccessPoint.InvalidStatus	The specified direct connect access point is not in the correct status for the request.	指定的接入点所处的状态无法响应该请求。
400	InvalidDirectConnectConnection.CustomerContactPhoneMalformed	The specified customer contact phone is malformed.	指定的联系人手机格式不合法。
400	InvalidDirectConnectConnection.CustomerContactEmailMalformed	The specified customer contact email is malformed.	指定的联系人邮箱格式不合法。
400	InvalidDirectConnectConnection.CustomerNameMalformed	The specified customer name is malformed.	指定的联系人姓名格式不合法。
400	InvalidDirectConnectConnection.BandwidthMalformed	The specified bandwidth is malformed.	指定的带宽不合法。
400	InvalidDirectConnectConnection.PeerLocationMalformed	The specified peer location is malformed.	指定的IDC地址格式不合法。
400	InvalidDirectConnectConnection.LineOperatorMalformed	The specified line operator is malformed.	指定的专线运营商不合法。
400	InvalidDirectConnectConnection.PortTypeMalformed	The specified port type is malformed.	指定的端口类型不合法。
400	IdempotentParameterMismatch	Arguments on this idempotent request are inconsistent with arguments used in previous request(s).	此幂等请求的参数与前一个请求中使用的参数不一致。
400	InvalidParameter.ClientTokenMalformed	The specified parameter ClientToken is malformed.	指定的参数ClientToken格式不合法，长度不能超过64个ASCII字符。
400	InvalidTagKey.Malformed	The specified parameter tag key is invalid.	标签键不合法。
400	InvalidTagValue.Malformed	The specified parameter tag value is invalid.	标签值不合法。
400	LimitExceeded.Tags	You've reached the limit on the number of tags that you can operate at one time.	已达到单次可操作标签数量的上限。
400	InvalidTag.Disorder	The specified index order of tag is malformed.	指定标签的索引顺序参数格式不合法。
400	InvalidDirectConnectConnection.PortSpecMalformed	The specified port spec is malformed.	指定的端口规格不合法。
400	InvalidDirectConnectConnection.PortSpecMismatch	The specified port spec does not match the port type.	指定的端口规格与端口类型不匹配。
400	InvalidName.Malformed	The specified name is malformed. Ensure the maximum length of name is 128.	指定的名称格式不合法。名称长度不能超过128个字符。
400	InvalidName.Malformed	The specified name is malformed.	指定的名称格式不合法。请修复名称格式后重试。
400	InvalidDescription.Malformed	The specified description is malformed.	指定的描述格式不合法。请修复描述格式后重试。
400	InvalidDescription.Malformed	The specified description is malformed. Ensure the maximum length of description is 255.	指定的描述格式不合法。描述长度不能超过255个字符。
403	Forbidden	You are not authorized to create a direct connect connection on the specified port type.	无权限在指定的端口类型上创建物理专线。
404	InvalidDirectConnectAccessPoint.NotFound	The specified direct connect access point does not exist.	指定的接入点不存在。
404	InvalidProject.NotFound	The specified Project does not exist.	指定的项目不存在。
412	IdempotentProcessing	The request uses the same client token as a previous one that is still in process.	幂等请求处理中。

专线连接