虚拟接口-华为云

云专线 DC-更新虚拟接口:响应示例

响应示例状态码： 200 OK { "virtual_interface" : { "id" : "0d0fdf63-f2c4-491c-8866-d504796189be", "name" : "vif-0819", "description" : "mytest", "tenant_id" : "0605768a3300d5762f82c01180692873", "direct_connect_id" : "4673e339-8412-4ee1-b73e-2ba9cdfa54c1", "vgw_id" : "8a47064a-f34c-4f94-b7fe-cac456c9b37b", "type" : "private", "service_type" : "VGW", "vlan" : 332, "bandwidth" : 2, "status" : "ACTIVE", "create_time" : "2022-08-19T11:28:06.000Z", "admin_state_up" : true, "enable_bfd" : false, "route_limit" : 50, "enable_nqa" : false, "vif_peers" : [ { "id" : "c768eb52-12a8-4859-9b43-81194643040c", "tenant_id" : "0605768a3300d5762f82c01180692873", "name" : "vif-0819", "description" : "", "address_family" : "ipv4", "local_gateway_ip" : "1.1.1.1/30", "remote_gateway_ip" : "1.1.1.2/30", "route_mode" : "static", "bgp_asn" : null, "bgp_md5" : null, "device_id" : "18.9.215.131", "bgp_route_limit" : 100, "bgp_status" : null, "status" : "ACTIVE", "vif_id" : "0d0fdf63-f2c4-491c-8866-d504796189be", "receive_route_num" : -1, "remote_ep_group" : [ "1.1.2.0/30" ], "service_ep_group" : null } ], "enterprise_project_id" : "0" }, "request_id" : "5633df7af874576d819a481c76673236" }

云专线 DC 虚拟接口

云专线 DC-更新虚拟接口:请求示例

请求示例更新虚拟接口的名称和描述，将带宽修改为2。 PUT https://{dc_endpoint}/v3/0605768a3300d5762f82c01180692873/dcaas/virtual-interfaces/0d0fdf63-f2c4-491c-8866-d504796189be { "virtual_interface" : { "name" : "vif-0819", "description" : "mytest", "bandwidth" : 2 } }

云专线 DC 虚拟接口

云专线 DC-更新虚拟接口:响应参数

响应参数状态码： 200 表5 响应Body参数参数参数类型描述 request_id String 操作请求ID virtual_interface VirtualInterface object 虚拟接口对象表6 VirtualInterface 参数参数类型描述 id String 虚拟接口的ID 最大长度：36 name String 虚拟接口的名称最大长度：64 admin_state_up Boolean 管理状态：true或false bandwidth Integer 虚拟接口接入带宽最小值：2 最大值：2147483647 create_time String 虚拟接口创建时间最大长度：255 update_time String 虚拟接口更新时间 description String 虚拟接口的描述最大长度：128 direct_connect_id String 物理专线的ID 最大长度：36 service_type String 接入网关的类型：包括VGW、GDGW、GEIP等 status String 操作状态，合法值是：ACTIVE，DOWN，BUILD，ERROR，PENDING_CREATE，PENDING_UPDATE，PENDING_DELETE，DELETED，AUTHORIZATION，REJECTED tenant_id String 租户ID 最小长度：32 最大长度：32 type String 表示接口类型：private 缺省值：private 最大长度：255 枚举值： private public vgw_id String 虚拟网关的ID 最小长度：36 最大长度：36 vlan Integer 同用户网关对接的vlan，配置范围0-3999 最小值：0 最大值：3999 route_limit Integer 虚拟接口远端子网路由配置规格最小值：1 最大值：200 缺省值：50 enable_nqa Boolean 是否使能nqa功能：true或false enable_bfd Boolean 是否使能nqa功能：true或false lag_id String 虚拟接口关联的链路聚合组ID 最小长度：36 最大长度：36 device_id String 归属的设备ID enterprise_project_id String 实例所属企业项目ID 最小长度：36 最大长度：36 tags Array of Tag objects 标签信息数组长度：0 - 10 vif_peers Array of VifPeer objects 虚拟接口的Peer的相关信息 extend_attribute VifExtendAttribute object 接口BFD/NQA等可靠性检测信息，只有配置BFD和NQA的扩展参数才会显示扩展参数信息表7 Tag 参数参数类型描述 key String 标签键，最大长度36个unicode字符，格式为大小写字母，数字，中划线“-”，下划线“_”，中文。最小长度：0 最大长度：36 value String 标签值，最大长度43个unicode字符，格式为大小写字母，数字，中划线“-”，下划线“_”，点“.”，中文。最小长度：0 最大长度：43 表8 VifPeer 参数参数类型描述 id String 资源ID 最小长度：36 最大长度：36 tenant_id String 归属租户ID 最小长度：36 最大长度：36 name String 虚拟接口对等体名称最小长度：0 最大长度：64 description String 虚拟接口对等体名称描述信息最小长度：0 最大长度：128 address_family String 接口的地址簇类型，ipv4，ipv6 local_gateway_ip String 虚拟接口对等体云侧接口地址 remote_gateway_ip String 虚拟接口对等体客户侧接口地址 route_mode String 路由模式：static/bgp 最大长度：255 枚举值： bgp static bgp_asn Integer BGP邻居的AS号最小值：1 最大值：4294967295 bgp_md5 String BGP邻居的MD5密码 remote_ep_group Array of strings 远端子网列表，记录租户侧的cidrs service_ep_group Array of strings 该字段用于公网专线接口，表示租户可以访问云上公网服务地址列表 device_id String 归属的设备ID bgp_route_limit Integer BGP的路由配置规格 bgp_status String 接口BGP协议状态，如果是静态路由接口则状态为 null 最大长度：10 status String 虚拟接口对等体状态 vif_id String 虚拟接口对等体对应的虚拟接口ID 最小长度：36 最大长度：36 receive_route_num Integer 路由模式为bgp：receive_route_num值为接收搭配BGP的路由数目；路由模式为static：该字段无意义，值为-1；注：若早期接入华为云的部分用户无法获取该字段信息，如需要请联系客服迁移专线端口。表9 VifExtendAttribute 参数参数类型描述 ha_type String 虚拟接口的可用性检测类型枚举值： nqa bfd ha_mode String 检测的具体的配置模式枚举值： auto_single auto_multi static_single static_multi enhance_nqa detect_multiplier Integer 检测的重试次数缺省值：5 min_rx_interval Integer 检测的接收时长间隔缺省值：1000 min_tx_interval Integer 检测的发送时长间隔缺省值：1000 remote_disclaim Integer 检测的远端的标识，用于静态BFD local_disclaim Integer 检测的本端的标识，用于静态BFD

云专线 DC 虚拟接口

云专线 DC-更新虚拟接口:请求参数

请求参数表2 请求Header参数参数是否必选参数类型描述 X-Auth-Token 是 String 用户Token。获取Token，请参考《统一身份认证服务API参考》的“获取用户Token”章节。请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。最小长度：0 最大长度：10240 表3 请求Body参数参数是否必选参数类型描述 virtual_interface 是 UpdateVirtualInterface object 虚拟接口更新对象表4 UpdateVirtualInterface 参数是否必选参数类型描述 name 否 String 虚拟接口名称最小长度：0 最大长度：64 description 否 String 虚拟接口描述信息最小长度：0 最大长度：128 bandwidth 否 Integer 虚拟接口带宽配置最小值：2 最大值：2147483647 remote_ep_group 否 Array of strings 远端子网列表，记录租户侧的cidrs service_ep_group 否 Array of strings 用于公网专线，用户访问公网服务地址列表 enable_bfd 否 Boolean 是否使能bfd功能：true或false enable_nqa 否 Boolean 是否使能nqa功能：true或false status 否 String 对其他租户创建的虚拟接口进行确认，可以是ACCEPTED和REJECTED 枚举值： ACCEPTED REJECTED

云专线 DC 虚拟接口

云专线 DC-查询虚拟接口倒换测试记录列表:响应参数

响应参数状态码： 200 表4 响应Body参数参数参数类型描述 request_id String 操作请求ID switchover_test_records Array of SwitchoverTestRecord objects 倒换测试记录信息列表 page_info PageInfo object 分页查询页的信息表5 SwitchoverTestRecord 参数参数类型描述 id String 倒换测试记录的唯一标识 tenant_id String 租户ID 最小长度：32 最大长度：32 resource_id String 倒换测试的资源对象ID resource_type String 倒换测试的资源对象类型缺省值：virtual_interface 最小长度：0 最大长度：128 枚举值： virtual_interface operation String shutdown、undo_shutdown表示倒换测试操作类型最小长度：0 最大长度：128 枚举值： shutdown undo_shutdown start_time String 倒换测试操作的开始时间 end_time String 倒换测试操作的结束时间 operate_status String 倒换测试状态记录 STARTING：初始状态 INPROGRESS：配置下发中 COMPLETE：配置下发完成 ERROR：配置下发失败枚举值： STARTING INPROGRESS COMPLETE ERROR 表6 PageInfo 参数参数类型描述 previous_marker String 上一页的marker，值为资源的uuid 最小长度：0 最大长度：36 current_count Integer 当前列表中资源数量最小值：0 最大值：2000 next_marker String 下一页的marker，值为资源的uuid，为空时表示最后一页最小长度：0 最大长度：36

云专线 DC 虚拟接口

云专线 DC-查询虚拟接口倒换测试记录列表:响应示例

响应示例状态码： 200 OK { "request_id" : "bb154519fb167f99cdb01b7b9995ad14", "switchover_test_records" : [ { "id" : "862d61f1-d9ea-4093-ba0e-2b8d415e3ab3", "tenant_id" : "de58f033eb664102ba85e4a5db473ca5", "resource_type" : "virtual_interface", "resource_id" : "d0b3329c-0063-470c-b1dc-657656b2e540", "operation" : "shutdown", "start_time" : "2023-10-10T10:41:23.000Z", "end_time" : "2023-10-10T10:41:23.000Z", "operate_status" : "COMPLETE" } ] }

云专线 DC 虚拟接口

云专线 DC-查询虚拟接口倒换测试记录列表:URI

URI GET /v3/{project_id}/dcaas/switchover-test 表1 路径参数参数是否必选参数类型描述 project_id 是 String 租户项目ID 表2 Query参数参数是否必选参数类型描述 limit 否 Integer 每页返回的个数。取值范围：1~2000。最小值：1 最大值：2000 缺省值：2000 marker 否 String 上一页最后一条资源记录的ID，为空时为查询第一页。使用说明：必须与limit一起使用。最小长度：0 最大长度：36 fields 否 Array 显示字段列表数组长度：1 - 5 sort_dir 否 Array 返回结果按照升序(asc)或降序(desc)排列，默认为asc sort_key 否 String 排序字段缺省值：id 最小长度：0 最大长度：36 resource_id 否 Array 通过RESOURCE-ID过虑倒换测试记录信息

云专线 DC 虚拟接口

云服务器内容精选

虚拟接口

7*24

备案

专业服务

退订

建议反馈

售前咨询热线