产品服务协议请查看： 产品服务协议 产品服务等级协议请查看： 产品服务等级协议

关联云电脑 AccessKey需要关联指定的云电脑范围才可使用。 1. 进入服务管理页面； 2. 在操作列点击关联云电脑； 3. 在弹窗中搜索和选择需要关联的云电脑； 4. 点击确认操作，完成绑定。 注意 目前仅支持Windows操作系统云电脑。 查看AccessKey 1. 进入服务管理页面，在列表中即可查看名称、ID、Secret和关联云电脑数量等信息； 2. 在AccessKey Secret信息列，可点击对应的按钮显示完整信息和复制信息。 禁用或启用 AccessKey 1. 进入服务管理页面； 2. 在操作列，点击禁用或启用按钮即可完成生效。 删除 AccessKey 仅在您不需要使用某个AccessKey时，才进行Key删除操作。删除操作前，请先完成禁用操作，否则删除操作按钮不可点击。 1. 进入服务管理页面； 2. 在操作列，点击删除按钮，在弹窗中二次确认完成删除操作。 注意 删除操作生效后，原AccessKey将无法恢复，请谨慎操作！ 常见问题 如果我的企业希望体验Aiuse云电脑功能，应该如何申请试用？ 当前可以向xxxx@xxx.com邮箱发发送申请，稍后将有专门的客服人员进行联系和开通试用 开通试用后，如何获取调用云电脑工具包和开发指引？

独立安全算力空间,多智能高效协同,任务一键交付 本次更新包含AIuse云电脑与Cospace，共同构成了天翼云AI云电脑的核心能力矩阵，为用户带来全新的智能办公体验。 Cospace智协空间：面向普通用户，通过自然语言交互实现跨终端远程智控。让你通过一句话命令即可跨终端远程智控云电脑，无论使用手机、平板还是电脑，都能随时随地完成文件查找、软件操作、任务执行等复杂办公需求。 AIuse云电脑：面向开发者，为开发者提供标准化SDK，支持程序化远程控制，助力AI自动化任务的高效落地。 两大功能依托天翼云强大的独立安全算力空间，构建企业级安全防护体系，让智能与安全兼得。现在就体验，开启云端智能办公新纪元! Cospace智协空间功能介绍 云电脑的桌面级智能体 CoSpace是云智助手新增的AI云电脑桌面智能体功能，作为办公场景下的全天候AI工作伙伴，主打"一句话命令、跨终端远程智控云电脑"核心能力。 对话式交互，实现系统级的桌面控制 用户无需额外下载，通过简单对话即可完成文件查找、办公软件操作、任务执行等复杂办公需求。

方式二：已有云电脑用户切换镜像 1. 登录云电脑客户端，进入云电脑桌面； 2. 进入云电脑顶部工具栏控制中心设置系统重装更换系统界面； 3. 点击“基础镜像”或“分享镜像”中，找到“CoSpace智协空间“关键词的专属镜像进行切换； 4. 完成镜像重装后即可使用。 注意 系统重装将清除安装在系统盘(C盘)的程序、数据及专线网络配置信息，请注意提前备份重要数据。 使用指引 桌面端使用 功能入口 1. 在专属镜像桌面中代开云智助手客户端，在侧边栏找到「CoSpace智协空间」入口； 2. 点击该入口后，将在当前页面内直接跳转至CoSpace功能主页面。 对话交互 1. 点击功能页面内的对话区域，可直接输入问题或指令进行问答交互； 2. 对话输入框下方默认显示三条高频预设任务，点击任意一条即可快速执行； 3. 支持手动输入自定义对话内容和智控指令。

参数 是否必填 参数类型 说明 示例 下级对象 bandwidthOid 是 String 带宽ID bwsya8ts02mjfxfxf2i000t subnetOidList 是 Array of Strings 子网ID列表，长度至少为1 snddlkbe3d868wblg7r4wx7

枚举参数 无 请求示例 请求url 无 请求头header 无 请求体body 无 响应示例 {"statusCode":800,"message":"OK.","returnObj":{"total":1,"list":[{"subnetOid":"fooId","subnetName":"fooName"}]}} 状态码 请参考 状态码 错误码 请参考 错误码

接口功能介绍 查询带宽列表 接口约束 无 URI GET /v3/bandwidth/describe 路径参数 无 Query参数 参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 d8bbd132b53a11e9b0e40242ac110002 name 否 String 带宽名称 APITest 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 参数 参数类型 说明 示例 下级对象 bandwidthOid String 带宽ID bws9561sofpjk7kh52i0038 name String 带宽名称 bandwidthaukc8xb status String 状态状态（Creating创建中;Normal正常;Deleted已删除;Changing变更中;Unhealthy异常;Frozen冻结;Deleting删除中） Creating size Integer 带宽大小（单位：Mbps） 1 vpcOid String VPC ID vpcxxdwpyq2jgc62h8fjd2e4 vpcName String VPC名称 vpcu9ck elasticIpAddress String 弹性IP地址 createTime String 创建时间。以ISO 8601为标准，并使用UTC+0时间，格式为yyyyMMddTHH:mm:ssZ。 20231020T07:23:52Z expireTime String 到期时间。以ISO 8601为标准，并使用UTC+0时间，格式为yyyyMMddTHH:mm:ssZ。 20231119T09:31:38Z

参数 是否必填 参数类型 说明 示例 下级对象 bandwidthOid 是 String 带宽ID bwlkh1f0xbikbe0tufj2tl2

参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 d8bbd132b53a11e9b0e40242ac110002

参数 参数类型 说明 示例 下级对象 statusCode Integer 状态码。可能值： 800：请求成功。 900：请求失败。 800 error String 错误码。 ECPC1000 message String 提示信息。 OK returnObj Object 返回数据结构体。 returnObj

接口功能介绍 幂等接口，重复添加会忽略并视为添加成功。 接口约束 无 URI POST /v3/commonDesktopPool/addUsers 路径参数 无 Query参数 参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 d8bbd132b53a11e9b0e40242ac110002 请求参数 请求头header参数 无 请求体body参数 参数 是否必填 参数类型 说明 示例 下级对象 desktopPoolOid 是 String 池化桌面池ID dpucod37vk0gca50kur44j4 pubUserOidList 是 Array of Strings 用户ID列表，长度限制[1,30] upglm1215fkk6v0hf8eo4il1 响应参数 参数 参数类型 说明 示例 下级对象 statusCode Integer 状态码。可能值： 800：请求成功。 900：请求失败。 800 error String 错误码。 ECPC1000 message String 提示信息。 OK returnObj Object 返回数据结构体。 returnObj 枚举参数 无 请求示例 请求url 无 请求头header 无 请求体body {"desktopPoolOid":"dpxxx","pubUserOidList":["puoxxx","puoyyy"]} 响应示例 {"statusCode":800,"message":"OK.","returnObj":{ }}

参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

接口功能介绍 查询策略列表 接口约束 无 URI GET /v3/strategy/pageDesktopStrategy 路径参数 无 Query参数 参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx orgOid 是 String 部门Oid strategyName 否 String 策略名称 isQuerySubOrg 否 Boolean 是否查询子部门策略 qosName 否 String qos名称 securityGroupName 否 String 安全组名称 pageNum 否 Integer 页码，至少1，默认1 pageSize 否 Integer 每页数量，最大100，默认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 参数 参数类型 说明 示例 下级对象 strategyOid String 策略Oid strategyName String 策略名称 qosOid String qos Oid securityGroupOid String 安全组Oid orgOid String 部门Oid

参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

枚举参数 无 请求示例 请求url 请求头header 无 请求体body 无 响应示例 { "statusCode":800, "message":"OK.", "returnObj":{ "total":1, "list":[{ "qosOid":"sqsxxx", "qosName":"xxxx", "upBandwidth":10, "downBandwidth":50, "maxburst":100, "remark":"xxxxx" }] } } 状态码 请参考 状态码 错误码 请参考 错误码

参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 d8bbd132b53a11e9b0e40242ac110002

枚举参数 无 请求示例 请求url 无 请求头header 无 请求体body {"desktopOid":"XXXXXXXXXXXXX6925","diskOid":"fooId","diskSize":20} 响应示例 {"statusCode":800,"message":"OK.","returnObj":{"operation":{"operationId":"32f7211cb74fbb283e42809d2c9a274b","type":"Common"}}} 状态码 请参考 状态码 错误码 请参考 错误码

参数 参数类型 说明 示例 下级对象 statusCode Integer 状态码。可能值： 800：请求成功。 900：请求失败。 800 error String 错误码。 ECPC1000 message String 提示信息。 OK returnObj Object 返回数据结构体。 returnObj

接口功能介绍 删除用户 接口约束 无 URI POST /v3/user/batchRemove 路径参数 无 Query参数 参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 d8bbd132b53a11e9b0e40242ac110002 请求参数 请求头header参数 无 请求体body参数 参数 是否必填 参数类型 说明 示例 下级对象 pubUserOidList 是 Array of Strings 用户ID列表，最大数量50 upg8to5zvs52v2g01h6h8fy2 响应参数 参数 参数类型 说明 示例 下级对象 statusCode Integer 状态码。可能值： 800：请求成功。 900：请求失败。 800 error String 错误码。 message String 提示信息。 OK. returnObj Object 返回数据结构体。 { } returnObj 枚举参数 无 请求示例 请求url 无 请求头header 无 请求体body {"pubUserOidList":["upgfoo","upgbar"]} 响应示例 {"statusCode":800,"message":"OK.","returnObj":{ }} 状态码 请参考 状态码 错误码 请参考 错误码

参数 参数类型 说明 示例 下级对象 statusCode Integer 状态码。可能值： 800：请求成功。 900：请求失败。 800 error String 错误码。 ECPC1000 message String 提示信息。 OK returnObj Object 返回数据结构体。 returnObj

接口功能介绍 查询弹性IP列表v3 接口约束 无 URI GET /v3/fip/describe 路径参数 无 Query参数 参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx floatingIpAddress 否 String 弹性IP地址 desktopOid 否 String 已绑定的桌面ID ipAddr 否 String 已绑定的桌面的IP地址 bandName 否 String 带宽名称 resourcePackName 否 String 资源包名称 pageNum 否 Integer 页码，至少1，默认1 pageSize 否 Integer 每页数量，最大100，默认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 参数 参数类型 说明 示例 下级对象 fipOid String 弹性IP ID fipUuid String 弹性IP UUID floatingIpAddress String 弹性IP地址 bindObjType String 绑定状态和已绑定实例的对象类型，[0：未绑定，1：虚机，2：仅SNAT规则，3：仅DNAT规则，4：VIP，5：SNAT规则和DNAT规则，5：PORT，12：ELB，98：绑定中，99：解绑中] bandName String 带宽名称 bandWidth Integer 带宽，单位：MBps desktopName String 绑定弹性IP的对象名称 desktopOid String 绑定弹性IP的对象编码 ipAddr String 已绑定对象的IP地址 resourcePackOid String 资源包ID resourcePackName String 资源包名称 status Integer 弹性IP状态，[0：创建中，1：正常，2：已删除，3：DOWN，4：错误，5：删除中，6：冻结]

参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 d8bbd132b53a11e9b0e40242ac110002 imageName 否 String 镜像名称 DYF status 否 String 状态。枚举值范围：[Starting启用中, Available可用, Stopped停用, StartFailed启用失败, Uploading上传中, UploadFailed上传失败, WaitVerify待验证, Expired已过期, Deleting删除中, DeleteFailed删除失败]。 Available pageNum 否 Integer 页码，至少1，默认1 1 pageSize 否 Integer 每页数量，最大100，默认10 10

参数 参数类型 说明 示例 下级对象 statusCode Integer 状态码。可能值： 800：请求成功。 900：请求失败。 800 error String 错误码。 ECPC1000 message String 提示信息。 OK returnObj Object 返回数据结构体。 returnObj

参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx sysRoleName 否 String 角色名称 test555 status 否 Integer 角色状态 1 orgOid 否 String 部门Oid orgtest isQuerySubOrg 否 Boolean 是否包含下级部门 false pageNum 否 Integer 页码，至少1，默认1 1 pageSize 否 Integer 每页数量，最大100，默认10 10

参数 参数类型 说明 示例 下级对象 statusCode Integer 状态码。可能值： 800：请求成功。 900：请求失败。 800 error String 错误码。 ECPC1000 message String 提示信息。 ok returnObj Object 返回数据结构体。 returnObj

参数 参数类型 说明 示例 下级对象 pubUserOid String 用户ID upgm611u6q1vm9hekeo5dckl userName String 用户名 zizhanghao loginAccount String 登录账户 zizhanghao3851 userAccount String 用户账户 zizhanghao email String 通知邮箱 maxm756913@163.com status Byte 状态（1有效，3待确认） 1

接口功能介绍 并发桌面池功能请联系客户经理开通。 接口约束 无 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":{ }} 状态码 请参考 状态码

参数 参数类型 说明 示例 下级对象 statusCode Integer 状态码。可能值： 800：请求成功。 900：请求失败。 800 error String 错误码。 message String 提示信息。 OK. returnObj Object 返回数据结构体。 { } returnObj

枚举参数 无 请求示例 请求url 无 请求头header 无 请求体body {"snapshotPolicyOid":"sspxxx","desktopOidList":["XXXXXXXXXXXXX6925"]} 响应示例 {"statusCode":800,"message":"OK.","returnObj":{ }} 状态码 请参考 状态码 错误码 请参考 错误码

错误码 请参考 错误码

参数 参数类型 说明 示例 下级对象 snapshotPolicyOid String 快照策略ID。 sspgg7576hc59fkph1b3xe4y snapshotPolicyName String 快照策略名称。 测oName1005 snapshotType String 快照类型。枚举值范围：sys系统盘;data数据盘;all系统盘和数据盘。 sys snapshotTimePoints Array of Objects 快照时间点集合。使用UTC+8时间。时间点格式：HH:mm。 '00:00','01:00' snapshotTimePoints cycleType String 快照的周期类型。枚举值范围：Week按周;Day按天。 Day daysOfWeek Array of Objects 一个星期中需要快照的天。取值范围[1,7]。只有cycleType取值为Week时有实际意义。 '1', '7' daysOfWeek cycleDayCnt Integer 快照周期天数。只有cycleType取值为Day时有实际意义。 1 retentionRule String 保留规则。枚举值范围：Month按月;Day按天;Quantity按数量;Forever永久保留。 Quantity retentionMonthCnt Integer 保留月数。只有retentionRule取值为Month时有实际意义。 1 retentionDayCnt Integer 保留天数。只有retentionRule取值为Day时有实际意义。 1 retentionCnt Integer 保留数量。只有retentionRule取值为Quantity时有实际意义。 4 autoDelete Boolean 是否自动删除。只有retentionRule取值为Quantity时有实际意义。 false description String 描述。 createTime String 创建时间。以ISO 8601为标准，并使用UTC+0时间，格式为yyyyMMddTHH:mm:ssZ。 20230927T10:08:11Z

参数 是否必填 参数类型 说明 示例 下级对象 snapshotPolicyOid 是 String 快照策略ID。 sspgg7576hc59fkph1b3xe4y desktopOidList 是 Array of Strings 云电脑ID列表。长度限制[1,10]。 D0023092201180710