检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
PATCH /v1/{project_id}/app-servers/actions/batch-update-tsvi 批量更新服务器虚拟会话IP配置 √ √ workspace:server:create POST /v1/{project_id}/app-servers/actions/create
配置桌面数据跟随 操作场景 通过AD的组策略，配置文件夹重定向策略，可以将用户的文件目录和配置保存到远程的存储系统中。用户登录时，可直接从远程文件系统读取个人文件，实现用户的数据和配置在服务器间漫游。 使用限制 文件夹重定向，使用的SMB协议，需要文件系统支持SMB(CIFS）协议。
批量删除服务器 功能介绍 批量删除服务器。 仅支持删除按需订购的服务器，包周期订购的服务器需要到Console界面进行退订，订单退订成功后服务器将会自动删除。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
重装服务器 功能介绍 重装服务器。 使用服务器原有的镜像进行重装，当服务器异常无法恢复时或者服务器运行时间久了，性能下降时，可选择重建服务器。注意：重装时系统盘的数据将会被清理掉。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以
分发软件信息至镜像实例 功能介绍 分发应用软件信息至镜像实例，管理员可以按需下载并安装应用软件。 目前只支持来自云应用仓库的软件信息。 只允许对状态为 实例正常运行、镜像任务结束 的实例分发软件信息。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API
批量删除镜像实例 功能介绍 批量删除镜像实例。 忽略不存在的镜像实例，响应正常。 不允许操作状态为 创建中、镜像创建中的实例，响应异常。 不支持资源关联发生变化后，请求删除镜像实例关联资源，任务响应异常。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API
新增通知规则 功能介绍 新增对应指标的通知规则;对应指标满足相应的规则条件时发送通知 同一指标的规则不允许重复; 统计指标名称，目前仅支持固定值：desktop_idle_duration desktop_idle_duration - 桌面空闲时长, 仅允许设置 '>=' 阈值
批量重装服务器 功能介绍 批量重装服务器。 使用服务器原有的镜像进行重装，当服务器异常无法恢复时或者服务器运行时间久了，性能下降时，可选择重建服务器。注意：重装时系统盘的数据将会被清理掉。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explor
操作用户 功能介绍 该接口用于操作用户，包含三种操作：锁定、解锁和重置密码（重置密码建议使用/v2/{project_id}/users/{user_id}/random-password接口，在没有通知方式的情况下必须使用/v2/{project_id}/users/{user
修改服务器的镜像 功能介绍 修改服务器的镜像。 服务器的镜像和服务器组的镜像不一样时，支持服务器的镜像切换为服务器组的镜像，并且仅允许同等镜像进行切换，例如：同操作系统，免费镜像切换，同源同价的付费镜像切换。如果服务器组的镜像和服务器的镜像为非同等镜像，建议您直接购买新的服务器，删除或者退订老的服务器。
查询桌面使用情况统计数据 功能介绍 查询桌面使用统计信息; 云服务每天凌晨02:00进行聚合运算前一天00:00:00~23:59:59的使用时长,并将周期范围内的数据聚合到周期边界上 跨天的记录会按照统计周期进行计算 假设一天内桌面登录多次，09:00~12:00,13:00~21:00
修改服务器组 功能介绍 修改服务器组。 修改服务器组的镜像，系统盘大小，OU信息后，已创建的服务器配置不变，新添加的服务器会使用新的配置创建。修改最大会话数后，用户接入服务器组时，会按照最新的配置进行路由计算。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API
批量修改服务器的镜像 功能介绍 批量修改服务器的镜像。 服务器的镜像和服务器组的镜像不一样时，支持服务器的镜像切换为服务器组的镜像，并且仅允许同等镜像进行切换，例如：同操作系统，免费镜像切换，同源同价的付费镜像切换。如果服务器组的镜像和服务器的镜像为非同等镜像，建议您直接购买新的服务器，删除或者退订老的服务器。
通过CBR备份恢复云桌面 操作场景 当发生病毒入侵、人为误删除、软硬件故障等事件时，可通过CBR的备份服务将云桌面的数据恢复至任意备份点。备份恢复过程中，CBR会保障用户数据的安全性和正确性，确保业务安全。 前提条件 已购买云桌面。 管理员帐号已具备云备份服务操作权限。 自主注册
修订记录 发布日期 修订记录 2025-01-09 第二十七次正式发布。 新增： 应用组管理目录下新增应用组删除、查询应用组详情。 应用管理目录下新增查询应用详细信息、删除自定义应用图标、批量禁用应用、批量启用应用。 应用组管理目录下新增解除服务组关联的所有应用组、查询应用组授权
云桌面错误码 当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。 状态码 错误码 错误信息 描述 处理措施 400 WKS.0001 接口输入的请求消息为空。 接口输入的请求消息为空。 请参考返回的error message信息检查请求体。 200
权限和授权项 策略包含系统策略和自定义策略，如果系统策略不满足授权要求，租户管理员可以创建自定义策略，并通过给用户组授予自定义策略来进行精细的访问控制。策略支持的操作与API相对应，授权项列表说明如下： 权限：允许或拒绝某项操作。 对应API接口：自定义策略实际调用的API接口。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
