云桌面 WORKSPACE-查询桌面连接状态列表:URI

时间:2025-11-11 20:03:01

URI

GET /v2/{project_id}/connect-desktops

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID。

表2 Query参数

参数

是否必选

参数类型

描述

user_names

Array of strings

桌面所属用户,批量筛选,最多不超过100个用户。

connect_status

String

桌面的连接状态。

  • UNREGISTER:表示桌面未注册时的状态(桌面启动后,会自动注册)。关机后也会出现未注册的状态。

  • REGISTERED:表示桌面注册以后,等待用户连接的状态。

  • CONNECTED:表示用户已经成功连接,正在使用桌面。

  • DISCONNECTED:表示桌面与客户端断开会话后显示的状态,可能为关闭客户端窗口,或客户端与桌面网络断开引起。

offset

Integer

从查询结果中的第几条数据开始返回,用于分页查询,取值范围0-2000,默认从0开始。

limit

Integer

查询结果中想要返回的信息条目数量,用于分页查询,取值范围0-2000,默认值100。

support.huaweicloud.com/api-workspace/ListDesktopsConnectStatus.html