AllocateDirectConnectVirtualInterface--专线连接-火山引擎

文档中心

立即注册

导航

AllocateDirectConnectVirtualInterface

最近更新时间：2024.11.15 10:51:33首次发布时间：2024.05.17 08:42:19

调用AllocateDirectConnectVirtualInterface为其他账号创建共享虚拟接口。

调用说明

已获取待使用共享虚拟接口账号的火山引擎账号ID信息。
不支持同时开启NQA检测功能和BFD检测功能。
当前NQA检测功能为邀测状态，如有需要您可联系客户经理。未开通NQA检测功能，调用时请避免传入EnableNqa、NqaDetectInterval、NqaDetectMultiplier。

说明

当前共享虚拟接口功能正在邀测中，如需试用，请联系客户经理申请。

调试

API Explorer

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

去调试

请求参数

名称	类型	是否必选	示例值	描述
Action	String	是	AllocateDirectConnectVirtualInterface	要执行的操作，取值为AllocateDirectConnectVirtualInterface。
Version	String	是	2020-04-01	API版本信息。
DirectConnectConnectionId	String	是	dcc-2fe3zsmkshs59g****	共享虚拟接口关联的物理专线的ID。您可调用DescribeDirectConnectConnections查询物理专线的ID。
LocalIp	String	是	192.XX.XX.10/24	共享虚拟接口的本端网关互联IP地址。
OwnerAccountId	String	是	2100052****	共享虚拟接口使用方的火山引擎账号ID。
PeerIp	String	是	192.XX.XX.20/24	共享虚拟接口的对端网关互联IP地址。
VlanId	Integer	是	2000	用于连接本地IDC的VLAN ID，请确保此VLAN ID未被占用，取值范围：0 ～ 2999。 0：表示该物理专线交换机端口上不配置VLAN，使用三层路由接口模式，该模式下一条物理专线上只可创建一个无VLAN标签的共享虚拟接口。 1～2999：表示该物理专线的交换机端口采用三层子接口模式，每个子接口配置不同的VLAN ID对应到一个虚拟接口，该模式下一条物理专线上可以创建出多个共享虚拟接口。
VirtualInterfaceName	String	否	Share-dcv	共享虚拟接口的名称。以中文、字母、数字开头，只能包含中文、字母、必须以字母或中文开头，可包含数字、点号（.）、下划线（_）和短横线（-）。长度限制为1 ~ 128个字符。不传入该参数或该参数不传入数值时，默认为共享虚拟接口实例的ID。
Description	String	否	This is a sample description	共享虚拟接口的描述信息。以中文、字母、数字开头，只能包含中文、字母、数字、点号（.）、空格（）、下划线（_）、中划线（-）、等号（=）、英文逗号（,）、中文逗号（，）、中文句号（。）。长度限制为0 ~ 255个字符。不传入该参数或该参数不传入数值时，默认为空字符串。
Bandwidth	Integer	否	100	共享虚拟接口的限速带宽，单位：Mbps。 -1（默认）：不限速不可超过所关联物理专线的带宽。若关联的是共享专线，则继承共享专线带宽，不可修改。
RouteType	String	否	Static	共享虚拟接口的路由类型，取值如下： BGP：BGP动态路由 Static：静态路由
EnableBfd	Boolean	否	false	是否开启BFD检测。 true：开启 false（默认）：不开启
BfdDetectInterval	Integer	否	1000	BFD检测时间间隔。单位：ms，取值范围：200～1000，默认1000。未开启BFD检测功能，请避免传入此参数。
BfdDetectMultiplier	Integer	否	3	BFD检测次数。取值范围：3～10，默认3。未开启BFD检测功能，请避免传入此参数。
EnableNqa	Boolean	否	true	是否开启NQA检测功能。 true：开启 false（默认）：不开启说明仅`RouteType`为`Static`时，支持开启NQA检测功能。
NqaDetectInterval	Integer	否	3000	NQA检测发送连续探测报文的时间间隔。单位：ms，取值：1000～5000，默认2000。未开启NQA检测功能，请避免传入此参数。
NqaDetectMultiplier	Integer	否	8	NQA检测的时间次数，若NQA检测连续失败次数达到设定的检测次数，则判定此线路故障。取值：3～8 ，默认5。未开启NQA检测功能，请避免传入此参数。说明开启NQA功能后，若线路流量几乎可达带宽上限，建议把检测次数设为`8`。
Tags.N.Key	String	否	Tags.1.Key=key1&Tags.2.Key=key2&Tags.3.Key=key3	共享虚拟接口标签的标签键（Key）。参数 - N - 参数：表示标签键（Key）的序号，取值范围：1～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～50，且N应按照连续的从小到大的顺序。多个标签值（Value）之间用&分隔。长度取值范围为0～256字符，不填默认为空。允许输入各国语言文字、数字、空格（）、下划线（_）、点号（.）、半角冒号（:）、斜杠（/）、等号（=）、加号（+）、中划线（-）和@（@）。大小写敏感，不能以空格开头或结尾。说明传入`Tags.N.Value`则必须传入`Tags.N.Key`。

返回数据

名称	类型	示例值	描述
RequestId	String	0ED8D006-F706-4D23-88ED-E11ED28D****	请求ID。
VirtualInterfaceId	String	dcv-7qthudw0ll6jmc****	新创建共享虚拟接口的ID。

请求示例

GET /?Action=AllocateDirectConnectVirtualInterface&Version=2020-04-01&DirectConnectConnectionId=dcc-bfej9gl****&Description=&VirtualInterfaceName=test&VlanId=1101****&LocalIp=192.XX.XX.5/30&PeerIp=192.XX.XX.6/30&RouteType=Static&EnableBfd=true&BfdDetectInterval=null&BfdDetectMultiplier=null&OwnerAccountId=2100001****' 
Host: open.volcengineapi.com
ServiceName: directconnect
Region: cn-beijing

返回示例

{
    "ResponseMetadata": {
        "RequestId": "202405101632430CEFC9A53DA1A20FD8B9",
        "Action": "AllocateDirectConnectVirtualInterface",
        "Version": "2020-04-01",
        "Service": "directconnect",
        "Region": "cn-beijing"
    },
    "Result": {
        "RequestId": "202405101632430CEFC9A53DA1A20F****",
        "VirtualInterfaceId": "dcv-12al2nocyjcw017q7y2g0****"
    }

错误码

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

HttpCode	错误码	错误信息	描述
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个字符。
400	InvalidDirectConnectConnection.InvalidBusinessStatus	The specified direct connect connection is not in the correct status for the request. The specified direct connect connection is in freeze.	指定的物理专线所处的状态无法响应该请求。当前物理专线被冻结。
400	InvalidDirectConnectConnection.InvalidStatus	The specified direct connect connection is not in the correct status for the request.	指定的物理专线所处的状态无法响应该请求。
400	InvalidDirectConnectVirtualInterface.BandwidthExceeded	The specified bandwidth of virtual interface exceeds the bandwidth of physical connection.	指定的虚拟接口带宽超过了物理专线带宽。
400	InvalidDirectConnectVirtualInterface.BandwidthMalformed	The specified bandwidth is malformed.	指定的带宽不合法。
400	InvalidDirectConnectVirtualInterface.BandwidthMismatch	The specified bandwidth of virtual interface is inconsistent with the bandwidth of the shared connection.	指定的虚拟接口带宽与共享专线的带宽不一致。
400	InvalidDirectConnectVirtualInterface.BfdDetectIntervalMalformed	The specified bfd detect interval is malformed. It can only be set when bfd is enabled, and the value should be between 200 and 1000.	指定的BFD检测间隔数值不合法。只有在启用BFD时才可设置该值，且该值应在200和1000之间。
400	InvalidDirectConnectVirtualInterface.BfdDetectMultiplierMalformed	The specified bfd detect multiplier is malformed. It can only be set when bfd is enabled, and the value should be between 3 and 10.	指定的BFD检测次数数值不合法。只有在启用BFD时才可设置该值，且该值应在3和10之间。
400	InvalidDirectConnectVirtualInterface.ConnectionIsExclusive	The specified virtual interface connection is exclusive. You can not create another virtual interface.	指定的虚拟接口所在的专线已独占。无法创建新的虚拟接口。
400	InvalidDirectConnectVirtualInterface.ConnectionIsShared	The specified virtual interface connection is shared. You can not create a new virtual interface which Vlan ID is 0.	指定的虚拟接口所在的专线已共享。无法创建VLAN ID为0的新虚拟接口。
400	InvalidDirectConnectVirtualInterface.EnableBfdMismatch	The specified virtual interface route type does not support enable bfd.	指定的虚拟接口路由类型不支持启用BFD检测。
400	InvalidDirectConnectVirtualInterface.EnableNqaMismatch	The specified virtual interface route type does not support enable nqa.	指定的虚拟接口路由类型不支持启用NQA检测。
400	InvalidDirectConnectVirtualInterface.LocalIpMalformed	The specified virtual interface local IP is malformed.	指定的虚拟接口本端互联IP地址不合法。
400	InvalidDirectConnectVirtualInterface.NqaBfdBothEnabled	The specified virtual interface does not support enabling bfd and nqa at the same time.	指定的虚拟接口不支持同时启动BFD和NQA检测。
400	InvalidDirectConnectVirtualInterface.NqaDetectIntervalMalformed	The specified nqa detect interval is malformed. It can only be set when nqa is enabled, and the value should be between 1000 and 5000.	指定的NQA检测间隔数值不合法。只有在启用NQA时才可设置该值，且该值应在1000和5000之间。
400	InvalidDirectConnectVirtualInterface.NqaDetectMultiplierMalformed	The specified nqa detect multiplier is malformed. It can only be set when nqa is enabled, and the value should be between 3 and 8.	指定的NQA检测次数数值不合法。只有在启用NQA时才可设置该值，且该值应在3和8之间。
400	InvalidDirectConnectVirtualInterface.OwnerAccountIdMalformed	The specified virtual interface owner account ID is malformed.	指定虚拟接口的资源归属账号ID不合法。
400	InvalidDirectConnectVirtualInterface.PeerIpMalformed	The specified virtual interface peer IP is malformed.	指定的虚拟接口对端互联IP地址不合法。
400	InvalidDirectConnectVirtualInterface.PeerIpMismatch	The specified virtual interface Peer IP and Local IP are not in the same subnet.	指定的虚拟接口对端互联IP地址与本端互联IP地址不在同一个子网。
400	InvalidDirectConnectVirtualInterface.RouteTypeMalformed	The specified virtual interface route type is malformed.	指定的虚拟接口路由类型不合法。
400	InvalidDirectConnectVirtualInterface.VlanIdMalformed	The specified virtual interface Vlan ID is malformed.	指定的虚拟接口VLAN ID不合法。
400	InvalidDirectConnectVirtualInterface.VlanIdMismatch	The specified Vlan ID of virtual interface is inconsistent with the Vlan ID of the shared connection.	指定的虚拟接口VLAN ID与共享专线的VLAN ID不一致。
400	InvalidName.Malformed	The specified name is malformed.	指定的名称格式不合法。请修复名称格式后重试。
400	InvalidName.Malformed	The specified name is malformed. Ensure the maximum length of name is 128.	指定的名称格式不合法。名称长度不能超过128个字符。
400	InvalidTag.Disorder	The specified index order of tag is malformed.	指定标签的索引顺序参数格式不合法。
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	QuotaExceeded.VirtualInterfacePerConnection	You've reached the limit on the number of virtual interfaces per direct connect connection that you can create.	已达到每条物理专线可创建的虚拟接口的数量上限。
400	LimitExceeded.PhysicalLineBandwidth	You’ve reached the bandwidth limit on the number of physical line.	已达到物理线路可分配带宽上限。
400	InvalidDirectConnectTrafficQosPolicy.DirectConnectConnectionWithSharedVif	It is not supported to associate the qos policy for direct connect connection associated with shared direct connect virtual interfaces.	关联了共享虚拟接口的物理专线不支持绑定QoS策略。
403	Forbidden	You are not authorized to perform nqa operations on the specified virtual interface.	无权限对指定的虚拟接口进行NQA操作。
403	InvalidDirectConnectVirtualInterface.CrossAccountForbidden	You are not authorized to allocate the specified virtual interface to other account.	无权限将指定的虚拟接口共享给其他账号。
404	InvalidDirectConnectConnection.NotFound	The specified direct connect connection does not exist.	指定的物理专线不存在。
409	InvalidDirectConnectVirtualInterface.LocalIpConflict	The specified virtual interface local IP already exists.	指定的虚拟接口本端互联IP地址已存在。
409	InvalidDirectConnectVirtualInterface.OwnerAccountIdConflict	The specified owner account ID is equal to current user.	指定的资源归属账号ID与当前账号ID相同。
409	InvalidDirectConnectVirtualInterface.PeerIpConflict	The specified virtual interface peer IP conflicts with its local IP.	指定的虚拟接口对端互联IP地址与本端互联IP地址重复。
409	InvalidDirectConnectVirtualInterface.VlanIdConflict	The specified virtual interface Vlan ID already exists.	指定的虚拟接口VLAN ID已存在。