本节介绍天翼量子AI云电脑客户端的使用操作。 拖动工具栏 进入AI云电脑后，可在桌面顶部看到工具栏，点击“拖动”图标，支持工具栏任意位置移动，支持隐藏在桌面顶部和左右两侧屏幕边。 锁定/解锁工具栏 进入AI云电脑后，可在桌面顶部看到工具栏，支持锁定和解锁工具栏 自动隐藏工具栏 工具栏拖动至屏幕边缘时，自动吸附隐藏，隐藏后可按Alt+T快速唤起。 窗口切换 如AI云电脑账号下有多个AI云电脑，工具栏点击“窗口切换”功能，支持多个AI云电脑同时运行。 （1）安卓瘦终端仅支持快速切换，不支持多台AI云电脑同时在线运行 （2）外设重定向：如果当前AI云电脑在使用某一USB外设，其他AI云电脑该USB设备显示置灰，避免冲突，不能同时并行使用，提醒“该USB设备已连接到其他AI云电脑，如需使用请先在其他AI云电脑取消该设备的连接。

问题描述 当主机使用Windows2012浏览器时，部分场景下需要将Windows2012自带的.net framework 4.5版本卸载，卸载之后可能会遇到黑屏、无法进入系统桌面的问题。 可能原因 如遇这种情况，可能是因为系统由完整模式Full变为了核心模式Core。 处理方法 1. 登录弹性云主机，点击Win键，在开始菜单中选择任务管理器。 2. 选择“文件 > 运行新任务”。打开“新建任务”窗口。 3. 输入“cmd”，然后按回车键。 4. 在弹出的命令行窗口执行以下命令，将系统由核心模式切换到完整模式。 Dism /online /enablefeature /all /featurename:ServerGuiMgmt /featurename:ServerGuiShell /featurename:ServerCoreFullServer 5. 根据提示重启云主机，再次登录系统后就可以正常显示桌面。

接口功能介绍 创建池化桌面池 接口约束 无 URI POST /v3/commonDesktopPool/create 路径参数 无 Query参数 参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 d8bbd132b53a11e9b0e40242ac110002 请求参数 请求头header参数 无 请求体body参数 参数 是否必填 参数类型 说明 示例 下级对象 name 是 String 桌面池名称，只能包含汉字、数字、英文字母、中划线和下划线，长度限制116个字符 maxm0926 orgOid 是 String 归属部门ID org3fzj92gzwkf9g730m4shf resourcePackOid 是 String 资源包ID rspa94bn3qnadp0pgiv4mhxo templateOid 是 String 规格ID，当前仅支持Windows系统的政企版规格（暂不支持GPU规格） dftvfi8ld7okixldvv4xer4p imageOid 是 String 镜像ID，当前仅支持Windows系统、非GPU镜像 mip4ij5apxcvse44qid3kec sysDiskType 是 String 系统盘类型（hio高IO） hio sysDiskSize 是 Integer 系统盘大小（单位：GB），需为10的倍数，范围：[max{镜像系统盘大小,80},200] 80 subnetOid 是 String 子网ID snw3b8o6cb7afw4l3vd3bgb desktopCount 是 Integer 云电脑数量，云电脑与用户数量比例为1:3，至少为1 1 pubUserOidList 是 Array of Strings 用户ID列表，池化桌面与用户数量比例为1:3，可设置一个或多个，单次数量上限30 upgm611u6q1vm9hekeo5dckl keepDuration 否 Integer 用户断开连接后，云电脑的保留时长（单位：分钟），至少是3，默认值为3 3 afterReleaseAction 否 String 云电脑释放后操作（rebuild还原;stop关机），默认值为rebuild rebuild rebuildAfterStopOrReboot 否 String 关机/重启后还原系统（on开启;off关闭），默认值为off off

使用指引 1.Windows桌面，开机会自启动“OpenClaw后台启动服务”，等待服务启动，直至以下画面出现； 点击“OpenClaw进入应用”，会自动打开浏览器，即可开始体验； 2.妙逸/Ubuntu桌面，点击桌面“OpenClaw” 应用图标，即可开始聊天。 说明 为方便用户零门槛快速体验，天翼云默认提供少量 Tokens试用，数量有限；如需获得更优使用体验与效果，请自行购买原生匹配的大模型和Tokens，参照“进阶用户使用”步骤配置。 典型场景演示 场景一、在桌面创建openclaw.txt文件 在 OpenClaw交互页面输入框中，输入指令：请在桌面创建OpenClaw.txt文件，同时写入 “提醒我 10 点开会” 的内容，帮助用户快速记录待办事项。 场景二：统计桌面有多少个txt文件 在 OpenClaw交互页面输入框中，输入指令：统计桌面有多少个txt文件。 说明 为方便用户零门槛快速体验，天翼云默认提供少量 Tokens试用，数量有限；如需获得更优使用体验与效果，请自行购买原生匹配的大模型和Tokens，参照“[进阶用户使用](

其他设置 Mac键盘： 开启后，键盘功能按Ma端方式响应 （仅限Mac端） 。 工具栏 ：开启后工具栏超过3秒未操作，自动收起工具栏。 加速球 ：开启后加速球将展示在桌面内。 臻控©弱网优化： 网络环境较差时，在桌面内工具栏偏好设置其他设置中打开“臻控©弱网优化”开关，退出桌面再重新进入生效，可以提升AI云电脑使用流畅度。 （仅Windows系统客户端、Mac客户端、Ubuntu瘦终端支持） 救援模式 当AI云电脑故障无法登录AI云电脑时，使用救援模式提供临时访问通道，尝试登录及修复AI云电脑，或备份关键用户数据并重装系统。 注意 由于云电脑故障可能涉及底层虚拟化错误、存储损坏、网络基础设施故障等复杂原因，救援模式无法保证对所有故障都能成功救援。在极少数情况下，可能出现无法进入救援模式或无法恢复数据的情况。 报障 使用AI云电脑过程中，如遇到问题，可点击“报障”，填写故障信息或者拨打服务热线：4008109889。

接口功能介绍 适用于此操作的云电脑需要满足全部条件：1. 计费方式为单实例、资源包。2. 不属于池化桌面池或并发桌面池的云电脑。 此操作将先进行云电脑关机操作。 接口约束 无 URI POST /v3/desktop/resizeSystemDisk 路径参数 无 Query参数 参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 请求参数 请求头header参数 无 请求体body参数 参数 是否必填 参数类型 说明 示例 下级对象 desktopOid 是 String 云电脑ID diskSize 是 Integer 扩容后系统盘大小（单位：GB）。需为10的倍数，取值范围：(当前系统盘大小,200] autoPay 否 Boolean 是否自动支付（仅创建单独付费云电脑有效），默认false。取值范围： true:是。（仅订购类型为包周期类型有效，需账号有足够金额） false:否。（仅订购类型为包周期类型有效） 响应参数 参数 参数类型 说明 示例 下级对象 statusCode Integer 状态码。可能值： 800：请求成功。 900：请求失败。 800 error String 错误码。 ECPC1000 message String 提示信息。 OK. returnObj Object 返回数据对象 returnObj 表 returnObj 参数 参数类型 说明 示例 下级对象 newOrderNo String 订单号（仅创建单独付费云电脑有效）。 newOrderId String 订单id（仅创建单独付费云电脑有效）。 totalPrice String 总价格（仅创建单独付费云电脑有效）。 operation Object 扩容云电脑系统盘操作。可用于查询操作状态（相关接口：查询操作列表）。 operation 表 operation 参数 参数类型 说明 示例 下级对象 operationId String 操作ID。 type String 操作类型。枚举值范围：Common通用型;Task任务型。

接口功能介绍 并发桌面池功能请联系客户经理开通。 接口约束 无 URI POST /v3/concurrentDesktopPool/editPolicy 路径参数 无 Query参数 参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 d8bbd132b53a11e9b0e40242ac110002 请求参数 请求头header参数 无 请求体body参数 参数 是否必填 参数类型 说明 示例 下级对象 desktopPoolOid 是 String 并发桌面池ID dpurmb31l1two2so9us14ro keepDuration 否 Integer 用户断开连接后，云电脑所占并发额度的保留时长（单位：分钟），至少是3 33 响应参数 参数 参数类型 说明 示例 下级对象 statusCode Integer 状态码。可能值： 800：请求成功。 900：请求失败。 800 error String 错误码。 ECPC1000 message String 提示信息。 OK returnObj Object 返回数据结构体。 returnObj 枚举参数 无 请求示例 请求url 无 请求头header 无 请求体body {"desktopPoolOid":"dpxx","keepDuration":33} 响应示例 {"statusCode":800,"message":"OK.","returnObj":{ }} 状态码 请参考 状态码

接口功能介绍 并发桌面池功能请联系客户经理开通。 当前仅支持操作Windows系统的政企版规格的并发桌面池 接口约束 无 URI POST /v3/concurrentDesktopPool/changeImage 路径参数 无 Query参数 参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 d8bbd132b53a11e9b0e40242ac110002 请求参数 请求头header参数 无 请求体body参数 参数 是否必填 参数类型 说明 示例 下级对象 desktopPoolOid 是 String 并发桌面池ID dpw8djg4dwv35w4c19o932g imageOid 是 String 镜像ID，当前仅支持Windows系统、非GPU镜像 miyr404205jf6br4f1dyb03 includeDataDisk 否 Boolean 切换整机镜像时，是否包括数据盘，默认为否 includeDataDisk 响应参数 参数 参数类型 说明 示例 下级对象 statusCode Integer 状态码。可能值： 800：请求成功。 900：请求失败。 800 error String 错误码。 message String 提示信息。 OK. returnObj Object 返回数据结构体。 { } returnObj 枚举参数 无 请求示例 请求url 无 请求头header 无 请求体body {"desktopPoolOid":"dpxxx","imageOid":"mixxx","includeDataDisk":null}

接口功能介绍 当前仅支持操作Windows系统的政企版规格的池化桌面池 接口约束 无 URI POST /v3/commonDesktopPool/addDesktops 路径参数 无 Query参数 参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 d8bbd132b53a11e9b0e40242ac110002 请求参数 请求头header参数 无 请求体body参数 参数 是否必填 参数类型 说明 示例 下级对象 desktopPoolOid 是 String 池化桌面池ID dpucod37vk0gca50kur44j4 resourcePackOid 是 String 资源包ID rspa94bn3qnadp0pgiv4mhxo templateOid 是 String 规格ID，当前仅支持Windows系统的政企版规格（暂不支持GPU规格） dft3h78mxfanrnf7l3004q7q sysDiskType 是 String 系统盘类型（hio高IO） hio sysDiskSize 是 Integer 系统盘大小（单位：GB），需为10的倍数，范围：[镜像系统盘大小,200] 120 desktopCount 是 Integer 云电脑数量，云电脑与用户数量比例为1:3，单次至少为1 1 响应参数 参数 参数类型 说明 示例 下级对象 statusCode Integer 状态码。可能值： 800：请求成功。 900：请求失败。 800 error String 错误码。 ECPC1000 message String 提示信息。 OK returnObj Object 返回数据结构体。 returnObj

显示设置 如需设置云电脑分辨率，进入偏好设置选择显示设置： 窗口化模式： 自适应分辨率即根据终端的分辨率自适应显示，或者根据窗口化大小自适应显示桌面内容；固定分辨率即窗口大小变化，桌面分辨率不变，桌面内容保持不变，窗口右侧和底部出现滚动条显示。 （窗口化模式仅支持Windows系统客户端、Mac客户端、国产化客户端） 分辨率，缩放设置 ：分辨率和缩放设置默认与终端本地保持一致。 Direct 3D特性 ：关闭Direct 3D特性，可能导致某些涉及到Direct 3D功能的软件不正常，如果播放视频卡顿（使用爱奇艺、腾讯视频等）建议临时关闭此功能。 画面设置 如需设置云电脑画面，可选择“默认设置”，“清晰优先”，“流畅优先”，“自定义设置”。 系统重装 如需系统重装，偏好设置点击系统重装，选择“系统盘重装至初始状态”，进行系统重装，系统重装会将系统还原至初始状态，系统盘的程序或数据会被清除，如非特殊情况，否则不建议使用。

接口功能介绍 并发桌面池功能请联系客户经理开通。 接口约束 无 URI POST /v3/concurrentDesktopPool/rename 路径参数 无 Query参数 参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 d8bbd132b53a11e9b0e40242ac110002 请求参数 请求头header参数 无 请求体body参数 参数 是否必填 参数类型 说明 示例 下级对象 desktopPoolOid 是 String 并发桌面池ID dpurmb31l1two2so9us14ro name 是 String 并发桌面池名称（只能包含汉字、数字、英文字母、中下划线；长度限制116个字符） 改名 响应参数 参数 参数类型 说明 示例 下级对象 statusCode Integer 状态码。可能值： 800：请求成功。 900：请求失败。 800 error String 错误码。 ECPC1000 message String 提示信息。 OK returnObj Object 返回数据结构体。 returnObj 枚举参数 无 请求示例 请求url 无 请求头header 无 请求体body {"desktopPoolOid":"dpxxx","name":"改名"} 响应示例 {"statusCode":800,"message":"OK.","returnObj":{ }} 状态码 请参考 状态码

本节提供了天翼云电脑(公众版)相关使用指南文档下载 天翼AI云电脑（公众版）终端用户使用指南.pdf 天翼AI云电脑Windows桌面设置系统语言指导手册.pdf 天翼AI云电脑外设使用指南.pdf

快速入门 新用户首次使用，可参见++使用说明++ AIuse云电脑功能配置具体步骤，参见++桌面管理指南++ AIuse云电脑专用SDK使用步骤，参见++SDK接入指南++ 更多AIuse服务支撑问题查阅，可参见++常见问题++

参数 参数类型 说明 示例 下级对象 desktopOid String 云电脑ID XXXXXXXXXXXXX6925 desktopName String 云电脑名称 nickname String 云电脑别名 osType String 操作系统类型（Windows;Linux） status String 运行状态（Creating创建中;Stopped已关机;Starting启动中;Running运行中;Rebooting重启中;Rebuilding重装中;Stopping关闭中;Deleting删除中;Deleted已删除;Unhealthy异常;RollingBack回滚中;Resizing变更中;Evacuating迁移中;Rescuing救援中;BackingUp备份中;DeletingBackup删除备份中;Regaining恢复中;Hibernating休眠中;Hibernated已休眠;WakingUp唤醒中） flavorType String 规格类型。可能值：[Common通用型, GpuGPU型, XcXC型]。 flavorSubtype String 规格子类型。仅对Linux通用型规格云电脑有意义。取值范围：[Desktop桌面版, Server服务器版]。 cpuArch String CPU架构。仅对XC型规格有意义。可能值：[arm, x86]。 processorType String 处理器类型。仅对XC型规格有意义。可能值： kp：鲲鹏。 hg：海光。 ft：飞腾。 zx：兆芯。 Intel：Intel。 kp cpu Integer CPU个数 memory Integer 内存大小（单位：GB） gpuMemory Integer 显存大小（单位：GB）。仅对GPU规格云电脑有意义。 sysDisk Object 系统盘 sysDisk dataDisks Array of Objects 数据盘 dataDisks imageOid String 镜像ID osName String 操作系统名称 org Object 归属部门 org vpcOid String VPC ID vpcName String VPC名称 subnets Array of Objects 所在子网集合 subnets eipAddress Object 弹性IP eipAddress pubUserOid String 分配用户ID（当且仅当用户与云电脑绑定成功时返回） userName String 分配用户名称（当且仅当用户与云电脑绑定成功时返回） desktopPool Object 归属桌面池。为空时代表不是桌面池的云电脑。 desktopPool chargeType String 计费方式。枚举值范围：[PrePaid包年包月, ResourcePack资源包] createTime String 创建时间。以ISO 8601为标准，并使用UTC+0时间，格式为yyyyMMddTHH:mm:ssZ。 expireTime String 到期时间。以ISO 8601为标准，并使用UTC+0时间，格式为yyyyMMddTHH:mm:ssZ。 表 sysDisk

接口功能介绍 并发桌面池功能请联系客户经理开通。 接口约束 无 URI POST /v3/concurrentDesktopPool/create 路径参数 无 Query参数 参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 d8bbd132b53a11e9b0e40242ac110002 请求参数 请求头header参数 无 请求体body参数 参数 是否必填 参数类型 说明 示例 下级对象 name 是 String 桌面池名称，只能包含汉字、数字、英文字母、中划线和下划线，长度限制116个字符 fooName orgOid 是 String 归属部门ID org3fzj92gzwkf9g730m4shf resourcePackOid 是 String 资源包ID rspa94bn3qnadp0pgiv4mhxo templateOid 是 String 规格ID，当前仅支持Windows系统的政企版规格（暂不支持GPU规格） dftvfi8ld7okixldvv4xer4p imageOid 是 String 镜像ID，当前仅支持Windows系统、非GPU镜像 mip4ij5apxcvse44qid3kec sysDiskType 是 String 系统盘类型（hio高IO） hio sysDiskSize 是 Integer 系统盘大小（单位：GB），当前只支持80GB 80 dataDiskList 否 Array of Objects 数据盘列表，可设置最多5个 dataDiskList subnetOid 是 String 子网ID snw3b8o6cb7afw4l3vd3bgb pubUserOidList 是 Array of Strings 用户ID列表 upgm611u6q1vm9hekeo5dckl concurrentMode 是 String 并发模式（Ratio比例；Quantity数量） Ratio keepDuration 否 Integer 用户断开连接后，云电脑所占并发额度的保留时长（单位：分钟），至少是3，默认值为3 3 maxConcurrentDesktopCount 否 Integer 最大同时在线云电脑数量（并发方式为Quantity时填），至少是1，默认值为1 1 表 dataDiskList 参数 是否必填 参数类型 说明 示例 下级对象 diskType 是 String 数据盘类型（hio高IO（high IO）；uhio超高IO（ultrahigh IO）；不同的资源池支持的盘类型可能不同，相关接口：查询可用的磁盘类型列表） uhio size 是 Integer 数据盘大小（单位：GB），必须是10的倍数，范围：[10,32000] 20

类型 功能 网络共享盘 NAS型共享盘 使用方式 AI云电脑挂载访问 支持 支持 使用方式 第三方平台系统（企业OA，SAP系统等）集成访问 支持 不支持 使用方式 天翼AI云电脑、网盘网页版、支持桌面端和移动端访问 支持 不支持 共享范围 跨资源池共享 支持 支持 共享范围 文件对外分享 不支持（规划中） 不支持 共享范围 跨企业（租户）共享 不支持（规划中） 不支持 数据安全 文件落盘自动加密 支持 支持 数据安全 多数据中心备份，数据异地容灾高可用 支持 部分资源池支持 翼起来生态融合 支持虚拟应用保存文件至翼共享盘 支持 支持 翼起来生态融合 支持翼连访问打开翼共享盘的文件，以及保存文件至翼共享盘 支持 不支持 翼起来生态融合 支持翼飞表单、问卷采集文件或图片保存至翼共享盘 不支持（规划中） 不支持 翼起来生态融合 云智助手设置共享盘为知识库 支持 不支持 权限管控 企业/个人空间容量分配，动态扩容 支持 支持 权限管控 挂载盘设置 支持用户挂载 支持桌面颗粒度挂载 权限管控 支持读写、分享等权限设置 支持 仅支持读写权限设置 权限管控 支持下载/分享/删除等操作审批 支持 不支持 权限管控 日志审计 不支持 仅支持新建、修改、删除操作

接口功能介绍 并发桌面池功能请联系客户经理开通。 接口约束 无 URI POST /v3/concurrentDesktopPool/addDesktops 路径参数 无 Query参数 参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 d8bbd132b53a11e9b0e40242ac110002 请求参数 请求头header参数 无 请求体body参数 参数 是否必填 参数类型 说明 示例 下级对象 desktopPoolOid 是 String 并发桌面池ID dpybiqd3vedlt5u4cspy6vd resourcePackOid 是 String 资源包ID rsp8qvf6t33j2yh97s3t8drc pubUserOidList 是 Array of Strings 用户ID列表，可设置一个或多个，最多30个 upg68xjc1c655mmccohrq1m6 响应参数 参数 参数类型 说明 示例 下级对象 statusCode Integer 状态码。可能值： 800：请求成功。 900：请求失败。 800 error String 错误码。 ECPC1000 message String 提示信息。 OK returnObj Object 返回数据结构体。 returnObj 枚举参数 无 请求示例 请求url 无 请求头header 无 请求体body {"desktopPoolOid":"dpxxx","resourcePackOid":"resxxx","pubUserOidList":["puoxxx"]}

接口功能介绍 并发桌面池功能请联系客户经理开通。 接口约束 无 URI GET /v3/concurrentDesktopPool/describeUsers 路径参数 无 Query参数 参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 d8bbd132b53a11e9b0e40242ac110002 desktopPoolOid 是 String 并发桌面池ID dpw8djg4dwv35w4c19o932g orgOid 否 String 用户归属部门ID，默认为根部门 null querySubOrg 否 Boolean 是否包含下级部门，默认为是 true pageNum 否 Integer 页码，默认1 1 pageSize 否 Integer 每页数量，默认10，最大100 10 请求参数 请求头header参数 无 请求体body参数 无 响应参数 参数 参数类型 说明 示例 下级对象 statusCode Integer 状态码。可能值： 800：请求成功。 900：请求失败。 800 error String 错误码。 ECPC1000 message String 提示信息。 OK. returnObj Object 返回数据对象 returnObj 表 returnObj 参数 参数类型 说明 示例 下级对象 total Long 总记录数 1 list Array of Objects 数据列表 list 表 list 参数 参数类型 说明 示例 下级对象 pubUserOid String 用户ID upgao6ve5mlakw01xk1c2no5 userName String 用户名 xindyh loginAccount String 登录账户 xindyh

接口功能介绍 当前仅支持操作Windows系统的政企版规格的池化桌面池 接口约束 无 URI POST /v3/commonDesktopPool/changeImage 路径参数 无 Query参数 参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 d8bbd132b53a11e9b0e40242ac110002 请求参数 请求头header参数 无 请求体body参数 参数 是否必填 参数类型 说明 示例 下级对象 desktopPoolOid 是 String 池化桌面池ID dpucod37vk0gca50kur44j4 imageOid 是 String 镜像ID，当前仅支持Windows系统、非GPU镜像 miyr404205jf6br4f1dyb03 includeDataDisk 否 Boolean 切换整机镜像时，是否包括数据盘，默认为否 includeDataDisk 响应参数 参数 参数类型 说明 示例 下级对象 statusCode Integer 状态码。可能值： 800：请求成功。 900：请求失败。 800 error String 错误码。 ECPC1000 message String 提示信息。 OK returnObj Object 返回数据结构体。 returnObj 枚举参数 无 请求示例 请求url 无 请求头header 无 请求体body {"desktopPoolOid":"dpxxx","imageOid":"mixxx","includeDataDisk":null}

本节介绍天翼云电脑Web客户端的使用操作。 快捷键操作 进入云电脑后，您可以通过云电脑上方的工具栏，点击“快捷键”模块，可以看到： Win+D：用作把所有打开的窗口最小化，显示桌面。 Ctrl+Alt+Del：用作调出安全窗口，或打开任务管理器用的。 Printscreen：用作截取全屏幕画面。 工具栏自动隐藏 进入云电脑后，在桌面顶部看到工具栏，鼠标移入点击可左右移动。在其他设置设置工具栏自动隐藏。 显示设置 如需设置云电脑分辨率，选择“工具”，进入偏好设置选择显示设置：分辨率和缩放设置默认与终端本地保持一致。 画面设置 如需设置云电脑画面，选择“工具”，可选择“默认设置”，“清晰优先”，“流畅优先”，“自定义设置”。 系统重装 如需系统重装，选择“工具”，进入偏好设置，点击“系统重装“，选择“系统盘重装至初始状态”，进行系统重装，系统重装会将系统还原至初始状态，系统盘的程序或数据会被清除，如非特殊情况，否则不建议使用。

虚拟私有云功能支持管理员自主配置和管理云电脑的虚拟网络环境。 操作场景 虚拟私有云可以为您的桌面构建隔离的，管理员可自主配置和管理的虚拟网络环境。AI云电脑如果需要上网，需配置虚拟私有云（VPC）、业务子网及上网带宽。VPC可在开通电脑服务时同步创建，也可单独管理。 创建虚拟私有云 1.进入“AI云电脑（政企版）”管理控制台； 2.单击“网络管理”，选择“虚拟私有云”，进入虚拟私有云管理页面； 3.点击“创建虚拟私有云”按钮； 4.配置虚拟私有云的“网段”、“名称”、“子网名称”、“子网网络地址”等信息； 5.确认配置信息后，点击“立即创建”，即完成电脑虚拟私有云及子网的创建。 创建IPv6桌面 当虚拟私有云开启了IPv6的功能后，创建桌面在网络模块配置时，选择开启IPv6功能的子网后，桌面则同样可以选择是否开启IPv6，具体操作如下。 1.在创建虚拟私有云时，子网 IPv6网段选择“开启IPv6”； 2.创建桌面时，网络模块选择绑定开启IPv6的业务子网，然后选择“开启IPv6”； 3.桌面其他信息完成配置后，点击“开通桌面”，即完成IPv6的桌面创建。

本节介绍天翼云电脑Web客户端的使用操作。 1.快捷键操作 进入AI云电脑后，您可以通过AI云电脑上方的工具栏，点击“快捷键”模块，可以看到： Win+D：用作把所有打开的窗口最小化，显示桌面。 Ctrl+Alt+Del：用作调出安全窗口，或打开任务管理器用的。 Printscreen：用作截取全屏幕画面。 2.工具栏自动隐藏 进入AI云电脑后，在桌面顶部看到工具栏，鼠标移入点击可左右移动。在其他设置设置工具栏自动隐藏。 3.显示设置 如需设置AI云电脑分辨率，选择“工具”，进入偏好设置选择显示设置：分辨率和缩放设置默认与终端本地保持一致。 4.画面设置 如需设置AI云电脑画面，选择“工具”，可选择“默认设置”，“清晰优先”，“流畅优先”，“自定义设置”。 5.系统重装 如需系统重装，选择“工具”，进入偏好设置，点击“系统重装“，选择“系统盘重装至初始状态”，进行系统重装，系统重装会将系统还原至初始状态，系统盘的程序或数据会被清除，如非特殊情况，否则不建议使用。

本节介绍了开启远程桌面连接功能的操作场景、前提条件、操作步骤。 操作场景 对于需要使用Windows远程桌面连接方式进行访问的云主机，需要在制作私有镜像时开启远程桌面连接功能。GPU优化型云主机必须开启该功能。 说明 使用外部镜像文件制作私有镜像时，开启远程桌面连接操作需要在虚拟机内部完成，建议您在原平台的虚拟机实施修改后，再导出镜像。 前提条件 已登录创建Windows私有镜像所使用的云主机。 登录云主机的详细操作请参见《弹性云主机用户指南》。 操作步骤 1. 开启远程桌面连接功能之前，建议先将云主机的分辨率设置为1920×1080。 设置方法：在云主机操作系统单击“开始 > 控制面板”，在“外观和个性化”区域单击“调整屏幕分辨率”，然后在“分辨率”下拉框中选择合适的值即可。 2. 单击“开始”，右键单击“计算机”，选择“属性”，进入“计算机属性”区域框。 3. 在左侧界面中，单击“远程设置”，进入“远程桌面”区域框。 4. 选择“允许运行任意版本远程桌面的计算机连接”。 5. 单击“确定”，返回“计算机属性”界面。 6. 选择“开始 > 控制面板”，打开“Windows防火墙”。 7. 在左侧选择“允许程序或功能通过Windows防火墙”。 8. 根据用户网络的需要，配置“远程桌面”可以在哪种网络环境中通过Windows防火墙如下图所示，然后单击下方的“确定”完成配置。 配置“远程桌面”网络环境

接口功能介绍 适用于不属于池化桌面池的云电脑。 每次切换，云电脑的系统类型、规格类型必须相同。 新旧镜像适用的系统类型与规格类型必须相同。 接口约束 无 URI POST /v3/desktop/batch/changeImage 路径参数 无 Query参数 参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 请求参数 请求头header参数 无 请求体body参数 参数 是否必填 参数类型 说明 示例 下级对象 desktopOidList 是 Array of Strings 云电脑ID列表，可设置一个或多个，最多10个 D0023092101180485 imageOid 是 String 镜像ID miyr404205jf6br4f1dyb03 includeDataDisk 否 Boolean 切换整机镜像时，是否包括数据盘，默认为否。 includeDataDisk 响应参数 参数 参数类型 说明 示例 下级对象 statusCode Integer 状态码。可能值： 800：请求成功。 900：请求失败。 800 error String 错误码。 message String 提示信息。 OK. returnObj Object 返回数据结构体。 { } returnObj 枚举参数 无 请求示例 请求url 无 请求头header 无 请求体body {"desktopOidList":["D0023092101180485"],"imageOid":"miyr404205jf6br4f1dyb03","includeDataDisk":null}

接口功能介绍 并发桌面池功能请联系客户经理开通。 接口约束 无 URI GET /v3/concurrentDesktopPool/describeIncludedDesktops 路径参数 无 Query参数 参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 d8bbd132b53a11e9b0e40242ac110002 desktopPoolOid 是 String 并发桌面池ID dpybiqd3vedlt5u4cspy6vd pageNum 否 Integer 页码，至少1，默认1 1 pageSize 否 Integer 每页数量，最大100，默认10 10 请求参数 请求头header参数 无 请求体body参数 无 响应参数 参数 参数类型 说明 示例 下级对象 statusCode Integer 状态码。可能值： 800：请求成功。 900：请求失败。 800 error String 错误码。 ECPC1000 message String 提示信息。 OK returnObj Object 返回数据对象 returnObj 表 returnObj 参数 参数类型 说明 示例 下级对象 total Long 总记录数 list Array of Objects 数据列表 list 表 list 参数 参数类型 说明 示例 下级对象 desktopOid String 云电脑ID D0023092701181644 desktopName String 云电脑名称 0000ecaeBxvPeMkJUH nickname String 云电脑别名 null osType String 操作系统类型（Windows;Linux） Windows status String 运行状态（Creating创建中;Stopped已关机;Starting启动中;Running运行中;Rebooting重启中;Rebuilding重装中;Stopping关闭中;Deleting删除中;Deleted已删除;Unhealthy异常;RollingBack回滚中;Resizing变更中;Evacuating迁移中;Rescuing救援中;BackingUp备份中;DeletingBackup删除备份中;Regaining恢复中;Hibernating休眠中;Hibernated已休眠;WakingUp唤醒中） Running flavorType String 规格类型。枚举值范围：[Common通用型, GpuGPU型]。 Common cpu Integer CPU个数 4 memory Integer 内存大小（单位：GB） 8 gpuMemory Integer 显存大小（单位：GB）。仅对GPU规格云电脑有意义。 2 sysDisk Object 系统盘 sysDisk dataDisks Array of Objects 数据盘 dataDisks imageOid String 镜像ID mixxljp5pe22329w9pp5834 osName String 操作系统名称 Windows 2016 Standard 64位 中文版（生产） org Object 归属部门 org vpcOid String VPC ID vpcxxdwpyq2jgc62h8fjd2e4 vpcName String VPC名称 vpcu9ck subnets Array of Objects 所在子网集合 subnets eipAddress Object 弹性IP eipAddress pubUserOid String 分配用户ID（当且仅当用户与云电脑绑定成功时返回） upg68xjc1c655mmccohrq1m6 userName String 分配用户名称（当且仅当用户与云电脑绑定成功时返回） 陆小果 chargeType String 计费方式。枚举值范围：[PrePaid包年包月, ResourcePack资源包] ResourcePack createTime String 创建时间。以ISO 8601为标准，并使用UTC+0时间，格式为yyyyMMddTHH:mm:ssZ。 20230927T03:29:10Z expireTime String 到期时间。以ISO 8601为标准，并使用UTC+0时间，格式为yyyyMMddTHH:mm:ssZ。 20231113T02:34:07Z 表 sysDisk 参数 参数类型 说明 示例 下级对象 diskOid String 磁盘ID vol38qs2td6q94sge38657ek diskType String 磁盘类型（hio高IO（high IO）；uhio超高IO（ultrahigh IO） hio diskSize Integer 磁盘大小。单位：GB 80 diskUuid String 磁盘UUID 6b646e82552f4be7aa9327be0bdf96f3 表 dataDisks 参数 参数类型 说明 示例 下级对象 diskOid String 磁盘ID vol38qs2td6q94sge38657ek diskType String 磁盘类型（hio高IO（high IO）；uhio超高IO（ultrahigh IO） hio diskSize Integer 磁盘大小。单位：GB 80 diskUuid String 磁盘UUID 6b646e82552f4be7aa9327be0bdf96f3 表 org 参数 参数类型 说明 示例 下级对象 orgOid String 部门ID org18qnu7l41v8fr2xif6jdq completeOrgName String 完整部门名称。由从根部门到当前部门的名称，以半角斜线号（/）为分隔符拼接而成。 1026199440@qq.com

接口功能介绍 查询池化桌面池的云电脑列表 接口约束 无 URI GET /v3/commonDesktopPool/describeIncludedDesktops 路径参数 无 Query参数 参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 d8bbd132b53a11e9b0e40242ac110002 desktopPoolOid 是 String 池化桌面池ID dp6lecg4r64s2ibv4efzcq3 pageNum 否 Integer 页码，至少1，默认1 1 pageSize 否 Integer 每页数量，最大100，默认10 10 请求参数 请求头header参数 无 请求体body参数 无 响应参数 参数 参数类型 说明 示例 下级对象 statusCode Integer 状态码。可能值： 800：请求成功。 900：请求失败。 800 error String 错误码。 ECPC1000 message String 提示信息。 OK returnObj Object 返回数据对象 returnObj 表 returnObj 参数 参数类型 说明 示例 下级对象 total Long 总记录数 list Array of Objects 数据列表 list 表 list 参数 参数类型 说明 示例 下级对象 desktopOid String 云电脑ID D0023092701181751 desktopName String 云电脑名称 0000ecaeCWeE3UawpN nickname String 云电脑别名 NULL osType String 操作系统类型（Windows;Linux） Windows status String 运行状态（Creating创建中;Stopped已关机;Starting启动中;Running运行中;Rebooting重启中;Rebuilding重装中;Stopping关闭中;Deleting删除中;Deleted已删除;Unhealthy异常;RollingBack回滚中;Resizing变更中;Evacuating迁移中;Rescuing救援中;BackingUp备份中;DeletingBackup删除备份中;Regaining恢复中;Hibernating休眠中;Hibernated已休眠;WakingUp唤醒中） Creating flavorType String 规格类型。枚举值范围：[Common通用型, GpuGPU型]。 Common cpu Integer CPU个数 4 memory Integer 内存大小（单位：GB） 8 gpuMemory Integer 显存大小（单位：GB）。仅对GPU规格云电脑有意义。 2 sysDisk Object 系统盘 sysDisk dataDisks Array of Objects 数据盘 dataDisks imageOid String 镜像ID mip4ij5apxcvse44qid3kec osName String 操作系统名称 Windows 2016 Standard 64位 中文版（生产） org Object 归属部门 org vpcOid String VPC ID NULL vpcName String VPC名称 NULL subnets Array of Objects 所在子网集合 subnets eipAddress Object 弹性IP eipAddress chargeType String 计费方式。枚举值范围：[PrePaid包年包月, ResourcePack资源包] ResourcePack createTime String 创建时间。以ISO 8601为标准，并使用UTC+0时间，格式为yyyyMMddTHH:mm:ssZ。 20230927T09:38:47Z expireTime String 到期时间。以ISO 8601为标准，并使用UTC+0时间，格式为yyyyMMddTHH:mm:ssZ。 20231113T02:34:07Z 表 sysDisk 参数 参数类型 说明 示例 下级对象 diskOid String 磁盘ID vol38qs2td6q94sge38657ek diskType String 磁盘类型（hio高IO（high IO）；uhio超高IO（ultrahigh IO） hio diskSize Integer 磁盘大小。单位：GB 80 diskUuid String 磁盘UUID 6b646e82552f4be7aa9327be0bdf96f3 表 dataDisks 参数 参数类型 说明 示例 下级对象 diskOid String 磁盘ID vol38qs2td6q94sge38657ek diskType String 磁盘类型（hio高IO（high IO）；uhio超高IO（ultrahigh IO） hio diskSize Integer 磁盘大小。单位：GB 80 diskUuid String 磁盘UUID 6b646e82552f4be7aa9327be0bdf96f3 表 org 参数 参数类型 说明 示例 下级对象 orgOid String 部门ID completeOrgName String 完整部门名称。由从根部门到当前部门的名称，以半角斜线号（/）为分隔符拼接而成。 表 subnets 参数 参数类型 说明 示例 下级对象 subnetOid String 子网ID privateIpAddresses Array of Objects 私有IP地址集合 privateIpAddresses 表 privateIpAddresses 参数 参数类型 说明 示例 下级对象 address String IP地址 表 eipAddress 参数 参数类型 说明 示例 下级对象 eipId String 弹性IP ID ipAddress String IP地址

本节介绍创建Linux云电脑的操作说明。 天翼AI云电脑（政企版）可以通过资源包或单实例方式开通Linux系统的普通AI云电脑。 如需通过资源包方式开通AI云电脑，请先订购资源包，详见订购资源包。 操作步骤 1.进入“AI云电脑（政企版）”管理控制台； 2.展开“AI云电脑管理”菜单栏，选择“桌面管理”，点击“创建桌面”，进入“创建桌面”页面； 3.创建方式来源选择“资源包”或“单实例”； 资源包方式开通：管理员可通过已订购资源包，通过资源包的资源分配方式开通AI云电脑，无需单独付费。 单实例方式开通：管理员可以选择AI云电脑配置，直接通过付费完成AI云电脑的开通。 4.选择“Linux”系统类型； 5.选择规格类型“桌面版”或“服务器版”，再根据需求选择AI云电脑规格； 6.选择AI云电脑的“镜像类型”； 7.选择AI云电脑的“磁盘选择”； 系统盘：普通AI云电脑默认已包含80GB高IO系统盘，GPUAI云电脑默认已包含120GB超高IO系统盘。 数据盘：根据实际情况选择桌面数据盘配置，每台桌面实例最多可添加5块数据盘，每块数据盘最大存储容量为2000GB。 注意 资源包开通的桌面系统盘最高可扩容至200GB，单实例开通的桌面系统盘最高可扩容至500GB。 8.选择AI云电脑的“vpc”和“业务子网”； 注：AI云电脑所选的业务子网需要绑定带宽，桌面才能连接网络。 通过将上网带宽与业务子网建立绑定关系，来控制业务子网下AI云电脑的最终可用带宽。详情可参考管理上网带宽 9.选择账号类型，并填写分配电脑的账号信息； 邮件通知激活：需要发送激活邮件，用户激活后，账号即可使用。 选择已有用户：选择已经存在的用户进行电脑分配。 注意：系统将自动生成root密码并在开通邮件中提醒。 10.其它电脑实例配置信息，根据需要自行配置； 11.确认相关的配置信息，点击“创建桌面”，即完成电脑开通。

Q：SDK 中输入的 desktopCode 是指什么？ A：desktopCode 是指桌面编码，用于唯一标识您的云电脑桌面实例。请注意，desktopCode 与桌面 ID 是两个不同的概念，请勿混淆，务必确认填写的是正确的桌面编码。 Q：如果我的云电脑桌面处于离线状态，是否仍然可以正常使用？ A：很抱歉，桌面处于离线状态时将无法正常接收和执行指令。请您先通过云电脑客户端或官网控制台将桌面开机并确认其处于在线运行状态后，再进行相关操作。 Q：通过 SDK 发送指令后，桌面没有任何响应，应如何排查？ A：建议您按以下步骤逐一排查： 1. 确认 SDK 指令格式是否正确，参数是否完整； 2. 检查接口返回的消息体中，是否包含成功标志（successtrue）； 3. 若上述检查均无异常，请进入目标桌面，打开「应用市场」，找到并重新安装以下两个插件：clinkagent 和 AiClientTool，安装完成后再重新发送指令。 如问题仍未解决，请联系我们的技术支持团队，并提供相关日志信息以便进一步协助排查。

Q：SDK 中输入的 desktopCode 是指什么？ A：desktopCode 是指桌面编码，用于唯一标识您的云电脑桌面实例。请注意，desktopCode 与桌面 ID 是两个不同的概念，请勿混淆，务必确认填写的是正确的桌面编码。 Q：如果我的云电脑桌面处于离线状态，是否仍然可以正常使用？ A：很抱歉，桌面处于离线状态时将无法正常接收和执行指令。请您先通过云电脑客户端或官网控制台将桌面开机并确认其处于在线运行状态后，再进行相关操作。 Q：通过 SDK 发送指令后，桌面没有任何响应，应如何排查？ A：建议您按以下步骤逐一排查： 1. 确认 SDK 指令格式是否正确，参数是否完整； 2. 检查接口返回的消息体中，是否包含成功标志（successtrue）； 3. 若上述检查均无异常，请进入目标桌面，打开「应用市场」，找到并重新安装以下两个插件：clinkagent 和 AiClientTool，安装完成后再重新发送指令。 如问题仍未解决，请联系我们的技术支持团队，并提供相关日志信息以便进一步协助排查。

Q：SDK 中输入的 desktopCode 是指什么？ A：desktopCode 是指桌面编码，用于唯一标识您的云电脑桌面实例。请注意，desktopCode 与桌面 ID 是两个不同的概念，请勿混淆，务必确认填写的是正确的桌面编码。 Q：如果我的云电脑桌面处于离线状态，是否仍然可以正常使用？ A：很抱歉，桌面处于离线状态时将无法正常接收和执行指令。请您先通过云电脑客户端或官网控制台将桌面开机并确认其处于在线运行状态后，再进行相关操作。 Q：通过 SDK 发送指令后，桌面没有任何响应，应如何排查？ A：建议您按以下步骤逐一排查： 1. 确认 SDK 指令格式是否正确，参数是否完整； 2. 检查接口返回的消息体中，是否包含成功标志（successtrue）； 3. 若上述检查均无异常，请进入目标桌面，打开「应用市场」，找到并重新安装以下两个插件：clinkagent 和 AiClientTool，安装完成后再重新发送指令。 如问题仍未解决，请联系我们的技术支持团队，并提供相关日志信息以便进一步协助排查。

本节介绍天翼云电脑（公众版）产品支持多终端适配、支持投屏、数据安全等功能的内容介绍。 多终端适配 与传统PC一致的使用体验，多种外设无缝衔接，实现多终端适配。 多终端适配： 适配PC、Mac、 iOS、安卓等多终端。 多外设支持： 打印机、扫描仪等外设无缝衔接（备注：手机、pad等移动终端不支持USB外设）。 支持投屏 支持手机有线/无线投屏模式，大屏电视秒变电脑使用，娱乐、办公两不误。 无线投屏： 在手机投屏模式下，支持把手机设置为触控版模式，操控更便捷。 有线投屏： 支持搭配扩展坞、蓝牙键鼠使用，操控更流畅。 数据安全 系统数据云端集中存储，不但能释放本地空间，还能避免宕机与数据丢失，使用多重安全传输协议保障数据安全。 数据不落地： 所有桌面、应用和数据统一管理，集中存储在云端。 数据多副本： 采用三副本技术分布式存储，灵活应对各种突发情况。 数据加密： 使用多重加密算法，对数据传输、数据存储进行加密，保障用户信息安全。

关闭数据执行保护 数据执行保护是系统为应用留出一部分云主机内存用于暂存数据，同时留出另一部分内存用于暂存应用使用的指令。数据执行保护可以防止云主机遭受病毒和其他安全威胁的侵害。 以下操作以Windows Server 2008 R2 Standard 64bit操作系统弹性云主机为例，介绍关闭云主机数据执行保护的操作方法。 1. 选择“计算机 > 属性 > 高级系统设置”打开系统属性对话框。 2. 在系统属性对话框中，选择“高级”选项卡。 3. 单击“性能”区域的“设置”。 4. 在“性能选项”窗口中选择“数据执行保护”选项卡，选择“仅为基本的Windows程序和服务启用DEP (T)”，单击“应用”保存修改。 删除多余的程序文件 “C:Windowsprefetch”文件夹中的文件是程序启动后留下的索引文件，用途是利用预读取功能来提高系统性能、加快系统启动和文件读取的速度。但其中文件会随着使用时间的增加而日益增多，删除多余的文件可以有效的清理Windows系统的磁盘空间。 将“C:Windowsprefetch”文件夹中的文件全部删除，即可删除多余的程序文件。 磁盘清理 使用云主机的“磁盘清理”可以删除临时文件，清空回收站，同时删除不再需要的各种系统文件和其他项目。 在云主机中打开“开始”，在搜索对话框中输入“磁盘清理”，单击“磁盘清理”后开始扫描并计算可能释放的空间，扫描结束后，在弹出框中确认要清理的文件后，单击“确定”开始清理磁盘。 如果没有磁盘清理选项需安装“桌面体验”，以下操作以Windows Server 2008 R2 Standard 64bit操作系统弹性云主机为例，介绍安装桌面体验的操作步骤。 1. 打开“开始 > 所有程序 > 管理工具 > 服务器管理器”，单击左侧导航中的“功能”。 2. 单击“添加功能”。 3. 在“选择功能”页面，勾选“桌面体验”，然后单击“下一步”。 添加桌面体验 4. 在“确认安装选项”页面，验证是否将安装桌面体验功能，然后单击“安装”。 5. 在“安装结果”页面，系统将提示您重新启动服务器以完成安装过程。单击“关闭”，然后单击“是”重新启动服务器。 6. 启动服务器管理器，在“功能摘要”下，确认已安装桌面体验。 已安装桌面体验 7. 打开“开始 > 所有程序 > 附件 > 系统工具 > 磁盘清理”，打开磁盘清理工具。