调用ModifyDirectConnectVirtualInterfaceAttributes修改指定虚拟接口的名称、描述及配置等相关信息。
当前NQA检测功能为邀测状态,如需试用您可联系客户经理申请试用。未开通NQA检测功能,请避免传入EnableNqa
、NqaDetectInterval
、NqaDetectMultiplier
。
您可调用ModifyDirectConnectVirtualInterfaceAttributes为虚拟接口添加本端互联IP、对端互联IP的IPv6类型的IP地址,但需遵循以下限制:
仅支持添加新的IPv6地址,不支持修改已有IPv6地址或删除已有IPv6地址。
仅支持同时添加本端、对端互联IP的IPv6地址,不支持单独添加本端或对端互联IP的IPv6地址。
不支持同时开启NQA检测功能和BFD检测功能。
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | ModifyDirectConnectVirtualInterfaceAttributes | 要执行的操作,取值为ModifyDirectConnectVirtualInterfaceAttributes。 |
Version | String | 是 | 2020-04-01 | API版本信息。 |
VirtualInterfaceId | String | 是 | dcv-7qthudw0ll6jmc**** | 待修改信息的虚拟接口的ID。您可调用DescribeDirectConnectVirtualInterfaces查询虚拟接口的ID。 |
VirtualInterfaceName | String | 否 | test | 虚拟接口的名称。
|
Description | String | 否 | This is a sample description | 虚拟接口的描述信息。
|
EnableBfd BfdDetectInterval | Boolean Integer | 否 否 | false 1000 | 是否开启BFD检测。您可调用DescribeDirectConnectVirtualInterfaces查询
|
BfdDetectMultiplier | Integer | 否 | 3 | BFD检测次数。取值范围:3~10,默认3。未开启BFD检测功能,请避免传入此参数。 |
Bandwidth | Integer | 否 | 100 | 虚拟接口的带宽,单位:Mbps。
|
EnableNqa | Boolean | 否 | true | 是否开启NQA检测功能。您可调用DescribeDirectConnectVirtualInterfaces查询
说明 仅 |
NqaDetectInterval | Integer | 否 | 3000 | NQA检测发送连续探测报文的时间间隔。单位:ms,取值:1000~5000,默认2000。未开启NQA检测功能,请避免传入此参数。 |
NqaDetectMultiplier | Integer | 否 | 8 | NQA检测的时间次数,若NQA检测连续失败次数达到设定的检测次数,则判定此线路故障。取值:3~8 ,默认5。未开启NQA检测功能,请避免传入此参数。 说明 开启NQA功能后,若线路流量几乎可达带宽上限,建议把检测次数设为 |
LocalIpv6Ip | String | 否 | fe80:XX::1/120 | 虚拟接口本端网关互联IP的IPv6地址。 |
PeerIpv6Ip | String | 否 | fe80:XX::2/120 | 虚拟接口对端网关互联IP的IPv6地址。 |
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | 202111161611080102121461940900**** | 请求ID。 |
GET /?Action=ModifyDirectConnectVirtualInterfaceAttributes&Version=2020-04-01&VirtualInterfaceId=dcv-7qthudw0ll6jmc****&VirtualInterfaceName=test&Description=test HTTP/1.1 Host: open.volcengineapi.com ServiceName: directconnect Region: cn-beijing
{ "ResponseMetadata": { "RequestId": "202111161611080102121461940900****", "Action": "ModifyDirectConnectVirtualInterfaceAttributes", "Version": "2020-04-01", "Service": "directconnect", "Region": "cn-beijing" }, "Result": { "RequestId": "202111161611080102121461940900****" } }
此处仅展示当前API的错误码,更多错误码请参见公共错误码。
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
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.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.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.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地址所在子网与另一个虚拟接口所在子网重叠。 |