调用ModifyDirectConnectVirtualInterfaceAttributes修改指定虚拟接口的名称、描述及配置等相关信息。

使用说明

当前NQA检测功能为邀测状态，如需试用您可联系客户经理申请试用。未开通NQA检测功能，请避免传入EnableNqa、NqaDetectInterval、NqaDetectMultiplier。

您可调用ModifyDirectConnectVirtualInterfaceAttributes为虚拟接口添加本端互联IP、对端互联IP的IPv6类型的IP地址，但需遵循以下限制：

仅支持添加新的IPv6地址，不支持修改已有IPv6地址或删除已有IPv6地址。

仅支持同时添加本端、对端互联IP的IPv6地址，不支持单独添加本端或对端互联IP的IPv6地址。

不支持同时开启NQA检测功能和BFD检测功能。

调试

API Explorer

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

去调试

请求参数

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

Action String 必选示例值：ModifyDirectConnectVirtualInterfaceAttributes

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

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

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

VirtualInterfaceId String 必选示例值：dcv-7qthudw0ll6jmc****

待修改信息的虚拟接口的ID。

您可调用DescribeDirectConnectVirtualInterfaces接口，查询虚拟接口的ID。

VirtualInterfaceName String 可选示例值：test

虚拟接口的名称。

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

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

不更改该参数时，保持原有配置，表示不修改虚拟接口实例的名称。

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

虚拟接口的描述信息。

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

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

不更改该参数时，保持原有配置，表示不修改虚拟接口实例的描述。

EnableBfd Boolean 可选示例值：false

是否开启BFD检测控制报文模式，取值如下：

true：开启

false：不开启

您可调用DescribeDirectConnectVirtualInterfaces接口，查询RouteType类型。

EnableBfdEcho Boolean 可选示例值：false

是否开启BFD检测echo报文模式，取值如下：

true：开启

false：不开启

您可调用DescribeDirectConnectVirtualInterfaces接口，查询EnableBfdEcho类型。

BfdDetectInterval Integer 可选示例值：1000

BFD检测时间间隔。单位：ms，取值范围：200～1000，默认1000。未开启BFD检测功能，请避免传入此参数。

BfdDetectMultiplier Integer 可选示例值：3

BFD检测次数。取值范围：3～10，默认3。未开启BFD检测功能，请避免传入此参数。

Bandwidth Integer 可选示例值：100

虚拟接口的带宽，单位：Mbps。

-1：不限速。

1～100000：虚拟接口出、入云方向的带宽上限，不可超过虚拟接口关联物理专线的带宽。您可调用DescribeDirectConnectConnections查询物理专线的信息。

若虚拟接口关联的是共享专线，虚拟接口将继承共享专线的带宽，您无需传入此参数。如需传入，请确保传入的值与虚拟接口关联的共享专线带宽值一致，您可调用DescribeSharedDirectConnectConnections查询共享专线信息（共享专线功能当前正在邀测中，仅开通此功能的账号可使用此功能、可见配套文档，如有需要请联系客户经理申请试用）。

不填保持原有配置。

EnableNqa Boolean 可选示例值：true

是否开启NQA检测功能，取值如下：

true：开启

false（默认）：不开启

说明

仅RouteType为Static类型时，支持开启NQA检测功能。

您可调用DescribeDirectConnectVirtualInterfaces接口，查询RouteType类型。

NqaDetectInterval Integer 可选示例值：3000

NQA检测发送连续探测报文的时间间隔。单位：ms，取值：1000～5000，默认2000。未开启NQA检测功能，请避免传入此参数。

NqaDetectMultiplier Integer 可选示例值：8

NQA检测的时间次数，若NQA检测连续失败次数达到设定的检测次数，则判定此线路故障。取值：3～8 ，默认5。未开启NQA检测功能，请避免传入此参数。

说明

开启NQA功能后，若线路流量几乎可达带宽上限，建议把检测次数设为8。

LocalIpv6Ip String 可选示例值：fe80:XX::1/120

虚拟接口本端网关互联IP的IPv6地址。

PeerIpv6Ip String 可选示例值：fe80:XX::2/120

虚拟接口对端网关互联IP的IPv6地址。

返回参数

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

请求示例

返回示例

错误码

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

状态码	错误码	错误信息	说明
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. Ensure the maximum length of description is 255.	指定的描述格式不合法。描述长度不能超过255个字符。
400	InvalidDescription.Malformed	The specified description is malformed.	指定的描述格式不合法。请修复描述格式后重试。
400	InvalidDirectConnectGateway.InvalidStatus	The specified direct connect gateway is not in the correct status for the request.	指定的专线网关所处的状态无法响应该请求。
400	InvalidDirectConnectVirtualInterface.BandwidthMismatch	The specified bandwidth of virtual interface is inconsistent with the bandwidth of the shared connection.	指定的虚拟接口带宽与共享专线的带宽不一致。
400	InvalidDirectConnectVirtualInterface.BfdBfdEchoBothEnabled	The specified virtual interface does not support enabling bfd and bfd echo at the same time.	指定的虚拟接口不支持同时启动BFD控制报文模式和ECHO模式检测。
400	InvalidDirectConnectVirtualInterface.BandwidthMalformed	The specified bandwidth is malformed.	指定的带宽不合法。
400	InvalidDirectConnectVirtualInterface.BandwidthExceeded	The specified bandwidth of virtual interface exceeds the bandwidth of physical connection.	指定的虚拟接口带宽超过了物理专线带宽。
400	InvalidDirectConnectVirtualInterface.EnableBfdMismatch	The specified virtual interface route type does not support enable bfd.	指定的虚拟接口路由类型不支持启用BFD检测。
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.EnableNqaMismatch	The specified virtual interface route type does not support enable nqa.	指定的虚拟接口路由类型不支持启用NQA检测。
400	InvalidDirectConnectVirtualInterface.NqaBfdEchoBothEnabled	The specified virtual interface does not support enabling bfd echo and nqa at the same time.	指定的虚拟接口不支持同时启动BFD ECHO模式和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	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	InvalidDirectConnectGateway.InvalidBusinessStatus	The specified direct connect gateway is not in the correct status for the request. The specified direct connect gateway is in freeze.	指定的专线网关所处的状态无法响应该请求。当前专线网关被冻结。
400	InvalidDirectConnectConnection.InvalidStatus	The specified direct connect connection is not in the correct status for the request.	指定的物理专线所处的状态无法响应该请求。
400	InvalidDirectConnectVirtualInterface.Ipv6IpChange	It is unsupported changing local IPv6 IP or peer IPv6 IP.	不支持修改虚拟接口的本端IPv6地址或对端IPv6地址。
400	InvalidDirectConnectVirtualInterface.GatewayIpv6NotEnable	The specified direct connect gateway does not enable IPv6.	指定的专线网关未启用IPv6。
400	InvalidDirectConnectVirtualInterface.Ipv6IpMissing	The specified virtual interface local IPv6 IP or peer IPv6 IP is missing, they must either both be configured or not configured at all.	指定的虚拟接口必须同时指定本端IPv6地址和对端IPv6地址。
400	InvalidDirectConnectVirtualInterface.LocalIpv6IpMalformed	The specified virtual interface local IPv6 address is malformed.	指定的虚拟接口本端IPv6地址不合法。
400	InvalidDirectConnectVirtualInterface.PeerIpv6IpMalformed	The specified virtual interface peer IPv6 address is malformed.	指定的虚拟接口对端IPv6地址不合法。
400	InvalidDirectConnectVirtualInterface.PeerIpv6IPMismatch	The specified virtual interface Peer IPv6 IP and Local IPv6 IP are not in the same subnet.	指定的虚拟接口对端IPv6地址与本端IPv6地址不在同一个子网。
400	InvalidDirectConnectVirtualInterface.NqaBfdBothEnabled	The specified virtual interface does not support enabling bfd and nqa at the same time.	指定的虚拟接口不支持同时启动BFD和NQA检测。
400	InvalidDirectConnectVirtualInterface.InvalidStatus	The specified direct connect virtual interface is not in the correct status for the request.	指定的虚拟接口所处的状态无法响应该请求。
400	LimitExceeded.PhysicalLineBandwidth	You’ve reached the bandwidth limit on the number of physical line.	已达到物理线路可分配带宽上限。
403	Forbidden.IPv6	You are not authorized to operate IPv6 functions.	无权限操作IPv6功能。
403	Forbidden	You are not authorized to perform nqa operations on the specified virtual interface.	无权限对指定的虚拟接口进行NQA操作。
403	InvalidDirectConnectVirtualInterface.BfdEchoForbidden	You are not authorized to perform bfd echo operations on the specified virtual interface.	无权限对指定的虚拟接口进行BFD echo操作。
403	InvalidDirectConnectVirtualInterface.IPv6Forbidden	You are not authorized to perform IPv6 operations on the specified virtual interface.	无权限对指定的虚拟接口进行IPv6操作。
403	InvalidDirectConnectVirtualInterface.OperationForbidden	You are not authorized to perform operations on the specified virtual interface.	无权限对指定的虚拟接口进行操作。
404	InvalidDirectConnectVirtualInterface.NotFound	The specified direct connect virtual interface does not exist.	指定的虚拟接口不存在。
409	InvalidDirectConnectVirtualInterface.PeerIpv6IpConflict	The specified virtual interface peer IPv6 IP conflicts with its local IPv6 IP.	指定的虚拟接口对端IPv6地址与本端IPv6地址重复。
409	InvalidDirectConnectVirtualInterface.LocalIpv6IpConflict	The subnet of the specified virtual interface local IPv6 IP overlaps with another virtual interface.	指定的虚拟接口本端IPv6地址所在子网与另一个虚拟接口所在子网重叠。

专线连接