# 查询在指定时间段未使用的桌面 - ListUnusedDesktops
#### 功能介绍
查询在指定时间段未使用的桌面。已废弃，不推荐使用。统计数据推荐使用[查询桌面使用情况统计数据接口](https://support.huaweicloud.com/api-workspace/ListDesktopUsageMetric.html)和[查询用户使用统计数据接口](https://support.huaweicloud.com/api-workspace/ListUserUsageMetric.html)。
#### 调试
您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/Workspace/doc?api=ListUnusedDesktops)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-workspace/workspace_09_0128.html)。
- 如果使用身份策略授权，需具备如下身份策略权限。
  
  | 授权项                            | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 |
  |:---|:---|:---|:---|:---|:---|
  | workspace:statistics:getUnused | Read | -           | -   | -  | -      |
     
  
 
#### URI
GET /v2/{project_id}/desktops/statistics/unused
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述    |
|:---|:---|:---|:---|
| project_id | 是    | String | 项目ID。 |
   
表2Query参数 
| 参数         | 是否必选 | 参数类型    | 描述                                                                     |
|:---|:---|:---|:---|
| offset     | 否    | Integer | 从查询结果中的第几条数据开始返回,用于分页查询，取值范围0-2000，默认从0开始。                             |
| limit      | 否    | Integer | 查询结果中想要返回的信息条目数量,用于分页查询，取值范围0-2000，默认值1000。                            |
| start_time | 否    | String  | 开始时间：由日期加时间组成，UTC格式，格式：yyyy-MM-ddTHH:mm:ss.SSSZ，若未输入，则查询现在到前一天的未使用的桌面。 |
| end_time   | 否    | String  | 结束时间：由日期加时间组成，UTC格式，格式：yyyy-MM-ddTHH:mm:ss.SSSZ，若未输入，则查询现在到前一天的未使用的桌面。 |
   
#### 请求参数
无
#### 响应参数
**状态码：200**
表3响应Body参数 
| 参数              | 参数类型                                                                                  | 描述             |
|:---|:---|:---|
| unused_desktops | Array of [UnusedDesktopInfo] objects | 指定时间段内未使用桌面列表。 |
| total_count     | Integer                                                                               | 总数。            |
   
 表4UnusedDesktopInfo 
| 参数              | 参数类型   | 描述        |
|:---|:---|:---|
| desktop_id      | String | 桌面id。     |
| compute_name    | String | 桌面名称。     |
| create_time     | String | 桌面创建时间。   |
| disconnect_time | String | 最近一次断连时间。 |
   
**状态码：default**
表5响应Body参数 
| 参数                            | 参数类型   | 描述                                                           |
|:---|:---|:---|
| error_code                    | String | 错误码，失败时返回。                                                   |
| error_msg                     | String | 错误描述。                                                        |
| error_detail                  | String | 错误详情。                                                        |
| encoded_authorization_message | String | 加密后的详细拒绝原因，用户可以自行调用STS服务的decode-authorization-message接口进行解密。 |
   
#### 请求示例
```
GET /v2/13d4944fcfc7448893f50d81a6a2edd3/desktops/statistics/unused
```
#### 响应示例
**状态码：200**
```
{
  "unused_desktops" : [ {
    "desktop_id" : "e0367f84-1d64-498e-9b92-093002ac3ce8",
    "compute_name" : "ZYZ08",
    "create_time" : "2022-08-08T02:34:05.202Z",
    "disconnect_time" : "2022-08-08T02:39:00.000Z"
  }, {
    "desktop_id" : "b8eb2ac0-4540-4409-857f-df5e2de07546",
    "compute_name" : "wangyan8301",
    "create_time" : "2022-08-08T02:34:05.202Z",
    "disconnect_time" : "2022-08-08T02:39:00.000Z"
  } ],
  "total_count" : 2
}
```
#### 状态码
| 状态码     | 描述                |
|:---|:---|
| 200     | 查询在指定时间段未使用的桌面响应。 |
| default | 错误响应。             |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-workspace/ErrorCode.html)。