检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
调用说明 云桌面（Workspace）服务提供了REST（Representational State Transfer）风格API，支持您通过HTTPS请求调用，调用方法请参见如何调用API。 父主题： 使用前必读
如何调用API 构造请求 认证鉴权 返回结果
编辑绑定关系 操作场景 终端与桌面的绑定关系错误或者需要调整时，管理员可对已有的绑定关系信息进行编辑。 前提条件 已获取待调整的终端MAC地址或者桌面名称。 操作步骤 登录管理控制台。 选择“策略管理 > 终端与桌面绑定”。 进入终端与桌面绑定列表页面。 找到待修改的绑定关系。 可
时，可以先缓存起来，避免频繁调用。 使用Token前请确保Token离过期有足够的时间，防止调用API的过程中Token过期导致调用API失败。 Token在计算机系统中代表令牌（临时）的意思，拥有Token就代表拥有某种权限。Token认证就是在调用API的时候将Token加到
系统会对此次导入的数据进行正确性校验，并与已存在于系统中的绑定关系对进行比对。 如果提示“上传成功”，则表示文件中的绑定关系对已正常上传至系统中。可单击“关闭”后，在“终端与桌面绑定”页面查看已上传的绑定关系对。 如果提示“上传失败”，则表示文件中的绑定关系对未上传至系统中。可单击“查看详情”查看异
构造请求 操作场景 本节介绍REST API请求的组成，并以调用IAM服务的管理员创建IAM用户说明如何调用API。 您还可以通过这个视频教程了解如何构造请求调用API：https://bbs.huaweicloud.com/videos/102987。 请求URI 请求URI由如下部分组成：
状态码 状态码是一组从1xx到5xx的数字代码，状态码表示了请求响应的状态，完整的状态码列表请参见状态码。 对于管理员创建IAM用户接口，如果调用后返回状态码为“201”，则表示请求成功。 响应消息头 对应请求消息头，响应同样也有消息头，如“Content-type”。 对于管理员创
云桌面与其他服务的关系 云桌面与周边服务的依赖关系如图1所示。 图1 云桌面与其他服务的关系 弹性云服务器 弹性云服务器（Elastic Cloud Server，ECS）由CPU、内存、镜像、云硬盘组成，是一种可随时获取、弹性可扩展的计算服务器。为云桌面服务提供桌面运行的云服务器。
终端与桌面绑定关系管理 开启/关闭终端与桌面绑定功能 创建绑定关系 编辑绑定关系 删除绑定关系 导出绑定关系列表 父主题： 策略管理
invoke WKSManager interface. 调用WKSManager失败 请重试或联系管理员 500 WKS.00010003 Failed to invoke WKSDesktopsController interface. 调用WKSDesktopsController失败
出待删除的绑定关系对列表。 可直接在绑定关系列表中找到待删除的绑定关系对。 根据待删除关系对数量选择删除类型。 单个删除 单个桌面绑定关系需要删除时，可选择单个删除。 单击待删除的关系对所在行的“删除”，进入删除确认页面。 单击“确定”。 批量删除 大量桌面绑定关系需要删除时，可选择批量删除。
管理员可根据实际需要开启或关闭当前项目下的终端与桌面绑定和接入时自动绑定功能。开启终端与桌面绑定和接入时自动绑定功能后，可根据绑定关系限制桌面可使用哪些终端设备登录。关闭终端与桌面绑定功能后，系统中已录入的绑定关系将失效，即桌面可使用任意支持的终端设备登录。 使用限制 不支持Android移动终端以及Android
项目ID。 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 Content-Type 否 String 发送的实体的MIME类型。
导出绑定关系列表 操作场景 管理员可将系统中已录入的绑定关系导出至本地查看。 前提条件 已在系统中录入绑定关系。 操作步骤 登录管理控制台。 选择“策略管理 > 终端与桌面绑定”。 进入终端与桌面绑定列表页面。 单击“导出”可以导出系统中已存在的绑定关系列表。 父主题： 终端与桌面绑定关系管理
云应用错误码 当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。 状态码 错误码 错误信息 描述 处理措施 400 WKS.00211102 The number of application exceeds the limit, limit:''{1}''
面等上报至CTS服务，从而提升云桌面接入速度及运营的准确性。 基于事件通知的机制，有可能存在消息队列阻塞、调用CTS失败等情况出现，用户不可完全依赖事件机制，需要结合定时调用API同步的方式更新数据，参考云桌面API帮助手册，查看桌面详情。如有疑问，请参考提交工单，填写工单信息，获取技术支持。
删除/退订包年/包月云应用服务器 场景描述 包年/包月云应用服务器无法直接调用云应用接口删除，需要调用退订包年/包月资源接口进行退订。 示例如下： POST https://bss.myhuaweicloud.com/v2/orders/subscriptions/resources/unsubscribe
获取项目ID 调用API获取项目ID 项目ID还可通过调用查询指定条件下的项目信息API获取。 获取项目ID的接口为“GET https://{Endpoint}/v3/projects”，其中{Endpoint}为IAM的终端节点，可以从地区和终端节点获取。接口的认证鉴权请参见认证鉴权。
项目id。 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 Content-Type 是 String 发送
删除WKS存储 功能介绍 删除共享存储，只会解除NAS与文件系统之间的关联关系，不会删除文件系统和文件系统中的数据。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI DELETE
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
