检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
构造请求 操作场景 本节介绍REST API请求的组成，并以调用IAM服务的管理员创建IAM用户说明如何调用API。 您还可以通过这个视频教程了解如何构造请求调用API：https://bbs.huaweicloud.com/videos/102987。 请求URI 请求URI由如下部分组成：
开通互联网 操作场景 管理员可以根据需要每个子网配置一个NAT网关和一个弹性公网IP，开通后，子网内所有云应用可访问互联网。 前提条件 已成功购买云应用。 操作步骤 使用管理员帐号登录云应用的管理控制台。 在左侧导航栏中单击“应用上网管理”，进入应用上网管理页面。 单击“开通互联网”，进入互联网配置页面，如图1所示。
通过软终端方式登录桌面 单击此处前往下载客户端 支持使用操作系统为Windows10的PC和操作系统为macOS10.14-12.4的Mac PC登录。 安全软件弹出提示框时，允许执行安装操作。 获取系统发送的桌面登录信息邮件。 对接AD与不对接AD的通知邮件稍有不同，请以实际接收的通知邮件为准。
t/upgrade-flag 更新HDA升级通知标识 √ x workspace:accessAgent:listUpgradeRecords GET /v1/{project_id}/app-servers/access-agent/upgrade-record 查询服务器的HDA升级跟踪记录
获取桌面名称策略 功能介绍 获取桌面名称策略，用于自动生成桌面名称。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI GET /v2/{project_id}/desktop-name-policies
管理桌面 操作场景 管理员可以对已创建的桌面进行开机、关机、重启和删除、修改桌面名称等操作。当用户离职或岗位调动不再使用当前分配的桌面时，管理员可以重新将该桌面分配给新用户使用，可节省资源。 前提条件 已购买桌面。 操作步骤 登录管理控制台。 在左侧导航栏中依次选择“桌面管理 >
修改服务器组 操作场景 管理员可根据业务需要，修改服务器组名称以及更新服务器组的镜像。 操作步骤 使用管理员帐号登录云应用的管理控制台。 在左侧导航栏中单击“服务器组”，进入服务器组列表页面。 根据所需，可执行如表1所示操作。 表1 服务器组操作列表 操作名称 操作步骤 场景说明
创建应用组 功能介绍 该API用于创建应用组。 应用服务器中安装了不同的应用，这些应用可以组成不同的应用组，进行集中的管理和维护，向用户(组)发布。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
修改应用组 功能介绍 修改应用组。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI PATCH /v1/{project_id}/app-groups/{app_group_id}
修改服务器组 功能介绍 修改服务器组。 修改服务器组的镜像，系统盘大小，OU信息后，已创建的服务器配置不变，新添加的服务器会使用新的配置创建。修改最大会话数后，用户接入服务器组时，会按照最新的配置进行路由计算。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API
配置AD域 操作场景 该章节指导管理员在管理控制台配置AD域和域用户的网络，如果创建的桌面需对接Windows AD域，管理员在首次购买桌面时需参考本章节进行配置。 首次购买桌面后，您的选择将不支持变更（对接AD域或取消对接AD域），请慎重选择。 同区域下的多个子项目，可对接同一个Windows
第三方单点认证 操作场景 云桌面支持配置多种第三方认证源，包括个人社交认证、企业社交认证、企业认证源，为企业用户登录云桌面带来更简易便捷的登录方式和更好的用户体验。管理员可以根据企业需要添加、修改和删除认证源。 暂不支持OAuth2.0、LDAP、双因素认证之间的互相切换，也不支持同时开启。
配置云服务器 操作场景 该任务指导用户在云服务器中根据实际需求，安装应用软件、配置补丁更新、安装系统补丁等。 前提条件 已获取登录云服务器的帐号和密码。 已创建云服务器。 已获取准备软件中的文件，并解压“Workspace_HDP_WindowsDesktop_Installer_x
创建备服务器组 操作场景 管理员通过在主服务器组下创建备服务器组，用于在应急状态下或者主服务器组资源不足的场景下切换到备服务器组。 前提条件 已参考创建服务器组创建主服务器组。 操作步骤 使用管理员帐号登录云应用的管理控制台。 在左侧导航栏中单击“服务器组”，进入“服务器组”列表页面。
查询用户详情信息 功能介绍 该接口用于查询指定的桌面用户详情。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI GET /v2/{project_id}/users/{user_id}
查询用户列表 功能介绍 该接口用于查询桌面用户列表。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 URI GET /v2/{project_id}/users 表1 路径参数
配置使用SFS网络文件系统 配置使用SFS网络文件系统 操作场景 涉及多人维护的文件，管理员可在对应区域中购买文件系统并指导对应区域桌面用户将文件系统挂载至桌面中，实现同一区域中的多个桌面用户共同访问和分享文件。具体可用场景，请参见弹性文件服务SFS产品文档的应用场景。 使用限制
登录桌面（软终端方式） 操作场景 该任务介绍终端用户在软终端通过云客户端方式登录用户计算机。 本章节中介绍的初始配置操作只需在每台终端设备上配置一次。 准备事项 需准备的文件如表1所示。 表1 软件包 软件包名称 说明 获取方式 Workspace_mac.dmg 用于安装Mac
开通云办公服务 功能介绍 该接口用于开通云办公服务。 作为异步接口，调用成功说明云办公服务后台收到了开通请求，但服务是否开通成功需要通过任务查询接口(GET /v2/{project_id}/workspace-sub-jobs)查询该任务的执行状态。 调试 您可以在API Ex
修订记录 发布日期 修订记录 2024-09-05 第六十次正式发布。 新增： Workspace支持的CES基础监控指标 2024-08-26 第五十九次正式发布。 新增： 开启/关闭终端与桌面绑定功能章节中新增接入时自动绑定。 2024-08-13 第五十八次正式发布。 修改：
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
