You need to enable JavaScript to run this app.
导航
专线连接
  • 文档首页
    • /专线连接/API参考/物理专线/CreateDirectConnectConnection
CreateDirectConnectConnection
最近更新时间：2024.04.18 19:01:52首次发布时间：2022.07.01 08:31:43
我的收藏

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

调试

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

请求参数

名称类型是否必选示例值描述
ActionString是CreateDirectConnectConnection要执行的操作，取值：CreateDirectConnectConnection。
VersionString是2020-04-01API版本信息。

DirectConnectConnectionName

String

否

DAS-246-3_port1**0-conn

物理专线的名称。

  • 以中文、字母、数字开头，只能包含中文、字母、数字、点号（.）、下划线（_）和短横线（-）。
  • 长度限制为1 ~ 128个字符。
  • 不传入该参数或该参数不传入数值时，默认为物理专线的ID。

Description

String

否

This is a DirectConnect description.

物理专线的描述信息。

  • 以中文、字母、数字开头，只能包含中文、字母、数字、点号（.）、空格（ ）、下划线（_）、中划线（-）、等号（=）、英文逗号（,）、中文逗号（，）、中文句号（。）。
  • 长度限制为0 ~ 255个字符。
  • 不传入该参数或该参数不传入数值时，默认为空字符串。
DirectConnectAccessPointIdString是ap-cn-shanghai-***-A物理专线接入点的ID。可调用DescribeDirectConnectAccessPoints查询专线接入点的信息。

LineOperator

String

是

ChinaTelecom

物理专线的运营商。

  • ChinaTelecom：中国电信
  • ChinaMobile：中国移动
  • ChinaUnicom：中国联通
  • ChinaOther：中国其他具有相应电信业务经营资质的运营商。

PortType

String

是

1000Base

物理专线的端口类型：

  • 1000Base-T：表示1G电口。
  • 10GBase-T：表示10G电口。
  • 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-T规格取值范围：1 ~ 1000
  • 10GBase-T规格取值范围：1 ~ 10000
  • 1000Base规格取值范围：1 ~ 1000
  • 10GBase规格取值范围：1 ~ 10000
  • 40GBase规格取值范围：1 ~ 40000
  • 100GBase规格取值范围：1 ~ 100000
PeerLocationString是中国上海市静安区XX路XX号XX楼XX机房本地IDC地址，请输入详细的地址。
CustomerNameString是张*三专线联系人的姓名。
CustomerContactPhoneString是133****2233专线联系人的电话。
CustomerContactEmailString是12345test@example.com专线联系人的邮箱。

ClientToken

String

否

123e4567-e89b-12d3-a456-42665544****

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

  • 由客户端自动生成一个参数值，确保不同请求间该参数值唯一，避免当调用API超时或服务器内部错误时，客户端多次重试导致重复性操作。
  • 仅支持ASCII字符，且不能超过64个字符。
  • 若不传入ClientToken，则此次API调用不进行幂等校验。

Tags.N.Key

String

否

Tags.1.Key=key1&Tags.2.Key=key2&Tags.3.Key=key3

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

  • 参数 - N - 参数：表示标签键（Key）的序号，取值范围：1、2、3、……、49、50，且N应按照连续的从小到大的顺序。
  • 多个标签键（Key）之间用&分隔。
  • 不能以 volc:和sys:开头，包括任意大小写形式。volc:和sys:开头为系统预留标签，禁止创建。
  • 长度取值范围为1~128字符，允许输入各国语言文字、数字、空格（）、下划线（_）、点号（.）、半角冒号（:）、斜杠（/）、等号（=）、加号（+）、中划线（-）和@（@）。

Tags.N.Value

String

否

Tags.1.Value=value1&Tags.2.Value=value2&Tags.3.Value=value3

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

  • 参数 - N - 参数：表示标签值（Value）的序号，取值范围：1、2、3、……、49、50，且N应按照连续的从小到大的顺序。
  • 多个标签值（Value）之间用&分隔。
  • 长度取值范围为0～256字符，不填默认为空。
  • 允许输入各国语言文字、数字、空格（）、下划线（_）、点号（.）、半角冒号（:）、斜杠（/）、等号（=）、加号（+）、中划线（-）和@（@）。
  • 大小写敏感，不能以空格开头或结尾。

说明

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

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

返回数据

名称类型示例值描述
RequestIdString20220627103212010225145152058*****请求ID。
DirectConnectConnectionIdStringdcc-2743430pi718g7fap8t1t****物理专线的ID。

请求示例

GET /?Action=CreateDirectConnectConnection&Version=2020-04-01&DirectConnectConnectionName=test&Description=test&DirectConnectAccessPointId=ap-cn-shanghai-***&LineOperator=ChinaMobile&PortType=1000Base&Bandwidth=1000&PeerLocation=中国上海市静安区XX路XX号XX楼XX机房&CustomerName=张*三&CustomerContactPhone=133****2233&CustomerContactEmail=12345test@example.com&ClientToken=123e4567-e89b-12d3-a456-42665544**** HTTP/1.1
Host: open.volcengineapi.com
ServiceName: directconnect
Region: cn-beijing

返回示例

{
 "ResponseMetadata": {
     "RequestId": "20220627103212010225145152058*****",
     "Action": "CreateDirectConnectConnection",
     "Version": "2020-04-01",
     "Service": "directconnect",
     "Region": "cn-beijing"
 },
 "Result": {
     "RequestId": "20220627103212010225145152058*****",
     "DirectConnectConnectionId": "dcc-imp0xyy35p1c8gbssxo*****"
 }
}

错误码

此处仅展示当前API的错误码，更多错误码请参见公共错误码。

HttpCode
错误码
错误信息
描述
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字符。
400InvalidTagKey.MalformedThe specified parameter tag key is invalid.标签键不合法。
400InvalidTagValue.MalformedThe specified parameter tag value is invalid.标签值不合法。
400LimitExceeded.TagsYou've reached the limit on the number of tags that you can operate at one time.已达到单次可操作标签数量的上限。
400InvalidTag.DisorderThe specified index order of tag is malformed.指定标签的索引顺序参数格式不合法。
400InvalidDirectConnectConnection.PortSpecMalformedThe specified port spec is malformed.指定的端口规格不合法。
400InvalidDirectConnectConnection.PortSpecMismatchThe specified port spec does not match the port type.指定的端口规格与端口类型不匹配。
400InvalidName.MalformedThe specified name is malformed. Ensure the maximum length of name is 128.指定的名称格式不合法。名称长度不能超过128个字符。
400InvalidName.MalformedThe specified name is malformed.指定的名称格式不合法。请修复名称格式后重试。
400InvalidDescription.MalformedThe specified description is malformed.指定的描述格式不合法。请修复描述格式后重试。
400InvalidDescription.MalformedThe specified description is malformed. Ensure the maximum length of description is 255.指定的描述格式不合法。描述长度不能超过255个字符。
403ForbiddenYou 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.指定的接入点不存在。
404InvalidProject.NotFoundThe specified Project does not exist.指定的项目不存在。
412IdempotentProcessingThe request uses the same client token as a previous one that is still in process.幂等请求处理中。