点击鼠标 plaintext // 在指定坐标点击鼠标（默认左键、按下并释放） await session.computer.clickmouse(500, 300); // 点击一下左键 await session.computer.clickmouse(500, 300, 'left'); // 点击一下右键 await session.computer.clickmouse(500, 300, 'right'); // 双击一下鼠标 await session.computer.clickmouse(500, 300, 'doubleleft'); // 仅按下鼠标左键（不释放） await session.computer.clickmouse(500, 300, 'left', true,false); // 仅释放鼠标 await session.computer.clickmouse(500, 300, 'left', false,true); 拖拽鼠标 plaintext // 从起始坐标拖拽到目标坐标 await session.computer.dragmouse(500, 300, 800, 500); 滚动 plaintext // 在指定位置滚动（Direction: 'up' 或 'down'） await session.computer.scroll(500, 300, 'down', 3); 按下键盘按键 plaintext // 按下键盘按键（如 Enter） await session.computer.presskey('Enter'); 输入文本 plaintext // 输入文本 await session.computer.typetext('Hello World'); 屏幕截图 plaintext // 截取屏幕 await session.computer.screenshot(); 获取鼠标位置 plaintext // 获取当前鼠标位置 await session.computer.getcursorposition(); 4、 关闭会话 使用完成后，应该关闭会话以释放资源。 plaintext await session.close(); console.log('会话已关闭');

参数名 类型 说明 code number 状态码，为 0 代表成功，其他表示失败 data number 结果，code为 0 时不为空 msg number code不为 0 时记录错误信息

本小节介绍如何配置安全组策略。 若云堡垒机绑定了EIP，在用户通过EIP访问堡垒机之前需要配置安全组策略，编辑入方向策略，才可通过EIP直接访问云堡垒机。 说明 安全组是一个逻辑上的分组，为同一个虚拟私有云内具有相同安全保护需求，并相互信任的弹性云服务器和堡垒机实例提供访问策略。 为了保障堡垒机的安全性和稳定性，在使用堡垒机实例之前，您需要设置安全组，添加规则允许需访问堡垒机的IP地址和端口。 堡垒机端口开放说明 注意 为确保系统安全，请合理配置堡垒机安全组策略，避免将高危端口（如SSH、RDP等）直接暴露在公网，建议通过白名单限制访问源IP或结合VPN专线访问。 推荐开放18443，18000，8765端口的入方向规则，其他端口根据运维场景需要按需进行配置。 云堡垒机使用端口用途详见下表： 端口 用途 说明 18443 门户端口，及H5运维端口 访问堡垒机门户页面时需开放该端口的入方向规则（并可支持H5方式运维资产） 18000 字符资产访问端口 需通过堡垒机维护字符类协议资产时，需开放该端口的入方向规则 19000 图形资产访问端口 需通过堡垒机使用MSTSC客户端维护图形类协议资产时，需开放该端口的入方向规则 20000 图形资产访问端口 需通过堡垒机使用VNCview客户端维护图形类协议资产时，需开放该端口的入方向规则 6003 数据库资产访问端口 需通过堡垒机维护数据库协议资产时，需开放该端口的入方向规则 8765 本地初始化获取配置端口 需通过客户端工具运维时，需开放该端口的入方向规则 5662 获取授权信息以及升级端口 堡垒机升级以及或者获取资源池信息，需开放该端口的出方向规则 说明 仅“二类节点”区域的实例涉及该端口。

本小节介绍数据库安全运维实名操作控制及审计最佳实践。 背景 数据库资产作为企业各类经营业务数据的承载体，其重要性不言而喻。企业的核心业务数据往往是私密且敏感的，如何有效防护数据库资产安全，防止越权访问、违规操作以及进一步导致数据泄露等事件发生，成为企业在数据安全防护工程建设中重点关注的一项内容。传统数据库审计或数据库防火墙产品可审计及控制操作，但很难实名到自然人操作。 天翼云堡垒机支持数据库资产的运维管控，支持多种类型数据库运维，如MySQL、PostgreSQL、Oracle等协议类型数据库，支持自然人、数据库资源的操作关联，以满足不同用户使用需求。 数据库运维流程 管理员先将数据库纳入堡垒机进行管理，将资产访问权限分配给相关运维人员，运维人员登录系统，在资产访问页面触发“本地访问初始化”，系统会将运维访问策略下发到本地，初始化成功后，运维人员打开本地客户端连接资产进行访问运维。整个运维流程，从建立连接到资产中的操作详情，都将在堡垒机中实现管控审计。 前提条件 已在本地安装数据库访问客户端，如Navicat、DBeaver等。 已将数据库资产纳入堡垒机进行管理。 已获取相关资产访问权限。 操作步骤 管理员将数据库资产纳入堡垒机进行管理 1. 管理员登录堡垒机。 2. 左侧菜单选择“资产管理>资产”。 3. 在资产管理界面点击“新增”，弹出资产信息输入窗口，按界面各项属性引导输入相关信息后提交即可。

此小节介绍登录云堡垒机。 说明 内网地址登录需要确保网络环境互通。 外网地址登录需要绑定弹性IP。 前提条件 管理员已添加该用户。 操作步骤 1. 启动浏览器，在浏览器Web地址栏中输入系统登录地址，进入到系统登录页面。 云堡垒机实例登录地址为 2. 选择认证方式为“本地认证 ”或“AD认证”。 3. 输入系统用户账号和密码，输入图形验证码。 4. 在弹出的对话框中选择绑定的双因子认证方式，若未开启双因子认证则跳过该步骤。 说明 使用短信认证登录，请确保该云堡垒机已开启短信认证方式，具体开启操作请参考：认证设置章节。 使用手机令牌登录前，请先确保您已经为该账号绑定手机令牌，绑定手机令牌才做请参见：手机令牌章节。 5. 单击“确定”，成功登录到堡垒机系统。 注意 动态口令的获取需要使用天翼云APP虚拟MFA管理功能，若未安装天翼云APP，请进入手机应用商店搜索“天翼云”，下载安装天翼云手机APP。

本文介绍Aiuse云电脑功能的常见问题 Q：如果我的企业希望体验 Aiuse 云电脑功能，应该如何开通使用？ A：感谢您对 Aiuse 云电脑的关注！目前，您可以通过发送申请邮件至 zhangyh65@chinatelecom.cn 进行开通申请，我们的专属客服人员将在收到邮件后尽快与您联系，协助完成使用资格开通。后续也将提供自助开通渠道方便使用。 开通使用后，如何获取云电脑调用工具包及开发接入指引？ 开通使用后，您可参阅++SDK 接入指南++，其中涵盖工具包下载、环境配置及完整的开发接入说明，帮助您快速完成集成。如在接入过程中遇到问题，欢迎随时联系我们的技术支持团队。 Q：目前 AccessKey 最多可以创建多少个？绑定的云电脑数量是否有上限？ A：当前每个租户最多可创建 10 个 AccessKey，每个 AccessKey 所绑定的云电脑数量不设上限。为便于统一管理及实现数据隔离，建议为不同业务场景或团队分配独立的 AccessKey，并分别绑定对应的云电脑资源。 Q：如何将 Accesskey 绑定到桌面？ A：Accesskey 的绑定操作请前往++桌面管理++页面进行配置，页面中提供了详细的操作步骤说明。如需进一步帮助，请参阅相关操作文档或联系客服人员。 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，安装完成后再重新发送指令。 如问题仍未解决，请联系我们的技术支持团队，并提供相关日志信息以便进一步协助排查。

用于操作天翼云电脑的一套SDK,支持鼠标控制、键盘输入、屏幕截图等操作。 Desktop Agent SDK 用于操作天翼云电脑的一套SDK，支持鼠标控制、键盘输入、屏幕截图等操作。 安装方法 npm 安装 plaintext npm install @ctyun/desktopagentsdk yarn 安装 plaintext yarn add @ctyun/desktopagentsdk pnpm 安装 plaintext pnpm add @ctyun/desktopagentsdk 基本使用方法 1、 创建 Client 实例 首先导入并创建 Client 实例。创建实例时需要提供以下参数： apiKey (必需): 控制台上的AccessKey ID apiSecret (必需): 控制台上的AccessKey Secret desktopCode (必需): 桌面编码 serviceURL (可选): 服务地址，默认为 plaintext import Client from '@ctyun/desktopagentsdk'; const client new Client({ apiKey: 'yourapikey', apiSecret: 'yourapisecret', desktopCode: 'yourdesktopcode', serviceURL: ' // 可选，使用默认值 }); 2、 创建会话 使用 createSession() 方法创建会话，会话创建成功后将返回会话对象，包含 sessionId 和操作方法。 plaintext const session await client.createSession(); console.log('会话创建成功，sessionId:', session.sessionId); 3、 使用 computer 方法 创建会话后，可以通过 session.computer 对象调用各种计算机控制方法。 移动鼠标 plaintext // 将鼠标移动到指定坐标 await session.computer.movemouse(500, 300); 点击鼠标 plaintext // 在指定坐标点击鼠标（默认左键、按下并释放） await session.computer.clickmouse(500, 300); // 点击一下左键 await session.computer.clickmouse(500, 300, 'left'); // 点击一下右键 await session.computer.clickmouse(500, 300, 'right'); // 双击一下鼠标 await session.computer.clickmouse(500, 300, 'doubleleft'); // 仅按下鼠标左键（不释放） await session.computer.clickmouse(500, 300, 'left', true,false); // 仅释放鼠标 await session.computer.clickmouse(500, 300, 'left', false,true);

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

关联云电脑 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工作伙伴，主打"一句话命令、跨终端远程智控云电脑"核心能力。 对话式交互，实现系统级的桌面控制 用户无需额外下载，通过简单对话即可完成文件查找、办公软件操作、任务执行等复杂办公需求。

日志字段 说明 alarmname 告警名称 alarmlevel 告警等级 1：轻微 2：低级 3：中级 4：高级 5：严重 alertsource 告警来源 mergeway 归并方式 alerttype 告警类型 alerttypesub 告警小类 attackstage 攻击链阶段 protocol 协议 alertcount 告警次数 ruleid 告警规则ID reliability 可信度。取值范围0100，数字越大，代表可信度越高。 successtag 攻击是否成功 1：是 0：否 2：未知 srcip 源IP srcport 源端口 dstip 目的IP dstport 目的端口 signature 特征码 cveid CVEID filename 文件名 filepath 文件路径 filemd5 文件MD5 url URL cookie Cookie username 登录用户名 processname 进程名称 mailfrom 发件人地址 mailto 收件人地址 srczone 源域 dstzone 目的域 statustag 告警的状态 0：待处理 1：已指派 2：已确认 3：已处理 4：已清除 5：已忽略 rectification 整改建议 indexname 索引名称 occurtime 发生时间 updatetime 更新时间 description 规则描述 eventtypecount 事件类型数量 eventcount 事件次数 vulid 漏洞ID componentId 组件ID usergroup 用户组 domain 域名 classdga dga域名 attackresult 攻击结果 iswhite 是否白名单 attacktype 攻击类型 payload payload attackmaintype 攻击主类型

本章节为您解答日志审计等保需求相关的常见问题。 密码安全相关 密码复杂度策略：密码必须含有“小写字母”、“大写字母”、“数字”、“特殊符号”中的任意三种(长度至少为8位，最大16位，特殊字符支持：~!@$^&(){}:;,.<>?)。 密码定期更换策略：密码若90天未修改，登录后系统会强制要求修改密码。 登录安全相关 登录超时自动退出时间：若用户30分钟未进行任何操作，则该用户会自动登出。 登录失败处理策略： 同一个IP使用不存在的用户名连续登录 5 次，限制该IP登录10分钟。 密码若连续三次输入错误，该用户会被锁定。 存储内容相关 鉴别数据、审计数据、配置数加密存储方式：审计鉴别数据存ES，配置的数据存放mysql数据库，涉及到敏感信息如密码会进行加密存储。 日志存储时限：默认填写存储180天，可根据业务需求进行修改。

名称 描述 Account 发出请求的账户名。 UserName 发出请求的用户名。如果根用户发送的该请求，则UserName为root。 StorageClass 存储类型： ALL：所有存储。 STANDARD：标准存储。 STANDARDIA：低频访问存储。 TimeZone 返回数据的时区，统一为UTC +0800。 Freq 统计数据的采样粒度： by5min：统计数据的采样粒度为5分钟。 byHour：统计数据的采样粒度为1小时。 byDay：统计数据的采样粒度为1天。 BucketName Bucket名字。如果用户在请求中没有携带Bucket参数，BucketName为空。 RegionName 数据位置，如果用户在请求中没有携带Region参数，RegionName为空。 Statistics.Date 返回结果对应的时间： 当请求参数Freq为by5min或byHour时，返回格式为yyyyMMdd HH:mm。 当请求参数Freq为byDay时，返回格式为yyyyMMdd。 Statistics.Data.MaxCapacity 标准存储数据的容量峰值，单位是Byte。 如果Freq值为by5min，该字段值显示为空 Statistics.Data.AverageCapacity 标准存储数据的容量平均值，单位是Byte。 如果Freq值为by5min，该字段值显示为空。 Statistics.Data.SampleCapacity 标准存储数据的实时容量值，单位是Byte。 Statistics.Standardia.MaxCapacity 低频访问存储数据的容量峰值，单位是Byte。 如果Freq值为by5min，该字段值显示为空。 Statistics.Standardia.AverageCapacity 低频访问存储数据的容量平均值，单位是Byte。 如果Freq值为by5min，该字段值显示为空。 Statistics.Standardia.SampleCapacity 低频访问存储数据的实时容量值，单位是Byte。

本节介绍该产品服务等级协议。 产品服务等级协议，详情参见《天翼云云容器引擎服务等级协议》。

本节介绍该产品服务协议。 产品服务协议，详情参见《天翼云云容器引擎服务协议》。

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

枚举参数 无 请求示例 请求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

参数 参数类型 说明 示例 下级对象 operation Object 扩容云电脑数据盘操作。可用于查询操作状态（相关接口：查询操作列表）。 operation

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