文档中心

专线连接

物理专线

ApplyDirectConnectConnectionLoa - 提交专线LOA申请

调用ApplyDirectConnectConnectionLoa提交专线LOA申请。

说明

LOA（Letter of Authorization）是一种授权函。专线连接的LOA用于授权第三方运营商进入火山引擎机房施工，搭建专线连接。

使用说明

a.N.b类型参数中（如Engineers.N.CertificateNo），N表示相关参数的序号，最多可同时传入16个，多个参数之间使用&分隔。

调试

API Explorer

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

去调试

请求参数

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

Action String 必选示例值：ApplyDirectConnectConnectionLoa

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

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

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

DirectConnectConnectionId String 必选示例值：dcc-3tehy13n2l4c6c0v****

物理专线的ID。您可调用DescribeDirectConnectConnections查询物理专线的ID。

Bandwidth Integer 可选示例值：1000

专线带宽，单位：Mbps，不传此参数则默认是端口的规格带宽。

取值不能大于物理专线的带宽。

PeerLocation String 可选示例值：浙江省杭州市余杭区XXXX

专线对端地址。

LineType String 必选示例值：MSTP

专线类型，取值如下：

MSTP：MSTP专线

MPLSVPN：MPLSVPN专线

FIBRE：光纤直连

Other：其他类型专线

CompanyName String 必选示例值：字节跳动

物理专线接入的客户公司名称。

SystemIntegrator String 必选示例值：火山引擎

施工方单位。

ConstructionTime String 必选示例值：2023-04-09

施工单位入场时间。

Engineers.N.Name String 必选示例值：张三*

施工工程师的姓名。

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

长度限制为60个字符。

Engineers.N.ContactPhone String 必选示例值：1512876****

施工工程师的联系方式。

Engineers.N.CertificateType String 必选示例值：IDCard

施工工程师的证件类型，取值如下：

IDCard：身份证

Passport：国际护照

Engineers.N.CertificateNo String 必选示例值：22222219990101****

施工工程师的证件号码，根据证件类型填入身份证号码或国际护照号码。

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

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

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

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

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

返回参数

本接口无特有的返回参数。更多信息请见返回结构。

请求示例

返回示例

错误码

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

状态码	错误码	错误信息	说明
400	IdempotentParameterMismatch	Arguments on this idempotent request are inconsistent with arguments used in previous request(s).	此幂等请求的参数与前一个请求中使用的参数不一致。
400	InvalidDirectConnectConnection.InvalidStatus	The specified direct connect connection is not in the correct status for the request.	指定的物理专线所处的状态无法响应该请求。
400	InvalidDirectConnectConnectionLoa.BandwidthMalformed	The specified bandwidth is malformed.	指定的带宽不合法。
400	InvalidDirectConnectConnectionLoa.BandwidthTooLarge	The specified bandwidth is larger than the port spec of direct connect connection.	指定的带宽不能大于物理专线的端口规格。
400	InvalidDirectConnectConnectionLoa.CertificateNoMalformed	The specified engineer ID number is malformed.	指定的施工工程师证件号码不合法。
400	InvalidDirectConnectConnectionLoa.CompanyNameMalformed	The specified company name is malformed.	指定的公司名称不合法。
400	InvalidDirectConnectConnectionLoa.ConstructionTimeMalformed	The specified construction time is malformed.	指定的施工时间不合法。
400	InvalidDirectConnectConnectionLoa.EngineerCertificateTypeMalformed	The specified engineer ID type is malformed. Only support given values: IDCard and Passport.	指定的施工工程师证件类型不合法，仅支持中国大陆身份证和护照。
400	InvalidDirectConnectConnectionLoa.EngineerContactPhoneMalformed	The specified engineer contact phone is malformed.	指定的施工工程师联系方式不合法。
400	InvalidDirectConnectConnectionLoa.EngineerNameMalformed	The specified engineer name is malformed.	指定的施工工程师姓名不合法。
400	InvalidDirectConnectConnectionLoa.InvalidDirectConnectConnectionStatus	The specified direct connect connection does not support current operation.	指定的物理专线状态不支持该操作。
400	InvalidDirectConnectConnectionLoa.LineTypeMalformed	The specified line type is malformed. Only support given values: FIBRE, MSTP, MPLSVPN and Other.	指定的线路类型不合法，仅支持光纤直连, MSTP, MPLSVPN, 其他。
400	InvalidDirectConnectConnectionLoa.PeerLocationMalformed	The specified peer location is malformed.	指定的物理专线对端位置格式不合法。
400	InvalidDirectConnectConnectionLoa.SystemIntegratorMalformed	The specified system integrator is malformed.	指定的施工单位格式不合法。
400	InvalidDirectConnectConnectionLoa.TooManyEngineers	You've reached the limit on the number of engineers per direct connect connection LOA. The upper limit is 16.	最多指定16名专线施工工程师。
400	InvalidParameter.ClientTokenMalformed	The specified parameter ClientToken is malformed.	指定的参数ClientToken格式不合法，长度不能超过64个ASCII字符。
404	InvalidDirectConnectConnection.NotFound	The specified direct connect connection does not exist.	指定的物理专线不存在。
409	InvalidDirectConnectConnectionLoa.Existed	The specified direct connect connection LOA already exists.	指定的物理专线LOA已经申请。
412	IdempotentProcessing	The request uses the same client token as a previous one that is still in process.	幂等请求处理中。

最近更新时间：2026.01.23 17:00:41

这个页面对您有帮助吗？

有用

无用