本节说明云电脑3D模式的产品介绍。 云电脑3D模式 云电脑3D模式是通过AI实时算法，将任意2D内容（视频、游戏、网页、PPT等）一键转换为立体3D效果，无需专门片源和昂贵设备，即可获得沉浸式3D体验的功能。核心能力如下： 实时2D转3D：AI算法实时转换，无需预处理 任意内容支持：所有云电脑画面都能3D效果显示 多设备兼容：支持VR/AR眼镜、快门眼镜、3D投影仪等类型显示设备 技术亮点 实时2D转3D算法 采用先进的AI视觉技术（玄空视觉模型），通过海量视频数据训练，能够实时分析2D画面并转换为3D立体效果，转换速度快、延迟低。 云端渲染+终端呈现 基于AIGC云流传输技术4.0，云端实时生成3D画面，网络高效传输，终端保真呈现，形成端到端能力闭环。 支持设备 提供多类产品形态，满足多场景3D 使用需求 VR盒子模式 手机配合VR眼镜盒子和手柄使用，将手机放入VR盒子后即可获得沉浸式3D体验，支持鼠标操控，价格亲民，适合个人影音娱乐和科普教育场景。 AR眼镜模式 手机或笔记本连接AR眼镜，开启3D模式后呈现高清口袋巨屏效果，支持手机触屏操作，2D/3D随时切换，适用于个人办公娱乐、企业会议和培训场景。 快门眼镜+3D投影仪模式 投影仪搭配快门眼镜使用，支持多人共享观看，3D效果突出，可外接键鼠操作，适用于高端家庭影音、企业规模教学和公共服务机构展览展示场景。 红蓝眼镜模式 佩戴红蓝眼镜，在普通显示器上即可观看3D内容，无需特殊设备，适合入门级3D体验和个人尝鲜使用。

参数 说明 基本信息 工单名称 输入您待提交工单的名称。 基本信息 工单类型 选择需要授权的工单类型，根据业务需求选择如下类型： 字符命令授权 数据库命令授权 资产账号 资产账号 选择您需要授权的资产账号。 注意 若选择授权的资产账号为二次登录账号（例如root），需同时授权二次登录的源账号（例如添加root资产账号时配置的二次登录源账号testuser），否则将无法完成二次登录。 敏感命令 待执行命令 单条可执行命令。审批通过后，由堡垒机系统 立即自动执行 ，授权为单次。 其他 描述 填写申请工单的相关描述。

功能类别 常规备份 稀疏备份 功能简介 RDS for PostgreSQL默认使用常规备份，常规备份按照备份时间段和备份周期对实例数据进行全量备份，每次备份完成后都会生成一个备份文件，根据设置的备份保留天数对备份文件进行存储。 对比默认备份策略，稀疏备份策略在相同的保留天数下，通过设置低频次的备份周期来降低备份文件密度。 开通稀疏备份后，默认显示的备份策略就是常规备份，在常规备份的基础上，可以添加稀疏备份策略。 备份策略 1个实例只有1个备份策略，并且不支持删除。 默认策略为按周备份，至少选择一周中的一天，备份文件的保留天数可设置1~732天。 1个实例只有1个基础备份策略，最多再添加9个稀疏备份策略。除基础策略外，手动添加的稀疏备份策略可以删除。 开通稀疏备份后，基础备份策略和稀疏备份策略并存，具体如下： 基础策略不支持删除，为按周备份，至少选择一周中的一天，备份文件的保留天数可设置1~732天。 稀疏备份策略支持以下三种模式，备份文件的保留天数可设置1~3660天。 − 按周备份：至少选择一周中的一天。 − 按月备份：至少选择一月中的一天。 − 按年备份：选择一年中的具体某一天。 备份时间段 默认为24小时中，间隔一小时的随机的一个时间段 ，例如01:00～02:00，12:00～13:00等。 默认为24小时中，间隔一小时的随机的一个时间段 ，例如01:00～02:00，12:00～13:00等。

配置稀疏备份策略 步骤 1 登录管理控制台。 步骤 2 单击管理控制台左上角的 ，选择区域。 步骤 3 选择“数据库 > 关系型数据库”。进入关系型数据库信息页面。 步骤 4 在“实例管理”页面，选择指定的实例，单击实例名称。 步骤 5 在左侧导航栏，单击“备份恢复”。 步骤 6 在页面右上方，选择“修改备份策略 > 同区域备份策略”。您可以查看到已设置的备份策略，如需修改备份策略，请调整以下参数的值。 备份时间段：默认为24小时中，间隔一小时的随机的一个时间段 ，例如01:00～02:00，12:00～13:00等。备份时间段并不是指整个备份任务完成的时间，指的是备份的开始时间，备份时长和实例的数据量有关。 说明 建议根据业务情况，选择业务低峰时段。备份时间段是以本地浏览器所在的UTC时区保存，如果碰到夏令时/冬令时切换，备份时间段会因时区变化而改变。 稀疏备份策略： 基础策略为按周备份，至少选择一周中的1天，备份文件的保留天数可设置1~732天。 支持添加多个稀疏备份策略，新增的策略可以选择按周、按月、或按年备份。1个实例最多支持9个稀疏备份策略。 表 稀疏备份策略 备份周期 时间 保留天数 每周 至少选择一周中的一天。 稀疏备份策略的保留天数为关联该条策略的全量自动备份的保留时长，对非关联该条策略的备份不生效。基础策略可设置1~732天，稀疏策略可设置1~3660天。 增量备份的保留时长根据基础策略的保留时长决定，与稀疏策略无关。 修改保留天数，会对关联该条策略的现有全量自动备份生效。备份策略保留天数不会对手动备份生效。 增加保留天数，可提升数据可靠性，请根据需要设置。 减少保留天数，由于会对已有的备份文件生效，可能会导致过期删除，请谨慎操作。 每月 至少选择一月中的一天。 稀疏备份策略的保留天数为关联该条策略的全量自动备份的保留时长，对非关联该条策略的备份不生效。基础策略可设置1~732天，稀疏策略可设置1~3660天。 增量备份的保留时长根据基础策略的保留时长决定，与稀疏策略无关。 修改保留天数，会对关联该条策略的现有全量自动备份生效。备份策略保留天数不会对手动备份生效。 增加保留天数，可提升数据可靠性，请根据需要设置。 减少保留天数，由于会对已有的备份文件生效，可能会导致过期删除，请谨慎操作。 每年 选择一年中的具体某一天。 稀疏备份策略的保留天数为关联该条策略的全量自动备份的保留时长，对非关联该条策略的备份不生效。基础策略可设置1~732天，稀疏策略可设置1~3660天。 增量备份的保留时长根据基础策略的保留时长决定，与稀疏策略无关。 修改保留天数，会对关联该条策略的现有全量自动备份生效。备份策略保留天数不会对手动备份生效。 增加保留天数，可提升数据可靠性，请根据需要设置。 减少保留天数，由于会对已有的备份文件生效，可能会导致过期删除，请谨慎操作。 如果多条备份策略涉及在同一天备份，那么在这一天系统仅会产生一个备份，该备份将与这些策略中保留时长最长的策略关联，保留时长由该条策略的保留时长决定。 配置稀疏备份策略后，如果某天的备份窗口内没有成功生成备份（由于和其他操作冲突导致的无法下发备份操作，或者备份执行失败），则该天的备份将被跳过，并不会额外保留备份。 删除稀疏备份策略时，由于备份策略可能关联了已产生的备份集，可以选择是否保留此策略关联的备份数据。如果选择不保留，所有关联此策略的备份数据会被立刻删除；如果选择保留，所有关联此策略的备份数据仍会按原保留时长保留。 步骤 7 单击“确定”，确认修改。 结束

登录超时配置 您可在“登录超时配置”模块，配置用户登录超时时间和资产访问超时。 用户登录超时：可选择101440分钟，当用户超过设定时长无操作时，再次操作需要重新登录，默认值为30分钟。 资产访问超时：可选择101440分钟，当用户访问资产超过设定时长无操作时，再次操作需要重新登录，默认值为30分钟。 运维水印配置 您可在“运维水印配置”模块开启运维水印，开启运维水印后，默认显示“姓名”、“用户名”，您可选择是否显示“手机号”和“源IP”。 国密配置 国密配置默认关闭，若您需要开启国密配置，请在工单页面提交工单申请开通。 国密配置开启后，系统将开启USBKey认证，用户可以通过USBKey认证的方式登录堡垒机。 注意 开启国密配置后，堡垒机中保存的账户密码、个人信息和配置信息等将会使用国密算法加密。 若您需要为用户开启USBKey认证登录，需要先为用户开启USBKey证书认证。 开启国密配置后无法关闭，请您酌情选择。 获取USBKey认证证书 说明 此操作步骤仅以三未信安产品为例。 1. 登录USBKey产品官网下载对应USBKey产品驱动。 2. 将USBKey设备与电脑连接，并且打开UKEY.html页面，将右侧的按钮从上至下生成数据后，单击“导出证书”。 3. 妥善保管好USBKey证书。

名称 描述 InitiateMultipartUploadResult 包含所有返回元素的容器。 类型：容器。 子节点：Bucket，Key，UploadId。 Bucket 分片上传对应的Bucket的名称。 类型：字符串。 父节点：InitiateMultipartUploadResult。 Key 分片上传对应的文件名称。 类型：字符串。 父节点：InitiateMultipartUploadResult。 UploadId 分片上传ID。 类型：字符串。 父节点：InitiateMultipartUploadResult。

请求示例1 请求创建一个名叫docs的Bucket，索引位置设置为WuHu，数据位置设置为优先本地，Bucket权限设置为私有。 plaintext PUT / HTTP/1.1 Host: docs.ooscn.ctyunapi.cn ContentLength:200 ContentType: application/xml;charsetutf8 Date: Mon, 03 Sep 2012 12:00:00 GMT xamzacl: private Authorization: SignatureValue WuHu Local 响应示例1 plaintext HTTP/1.1 200 OK xamzrequestid: c962c64b9f294f7b14877a897e8b8d9352545d484a4c4e5052 Date: Mon, 03 Sep 2012 12:00:00 GMT Location: /docs ContentLength: 0 Server: CTYUN 请求示例2 请求创建一个名叫docs的Bucket，索引位置设置为WuHu，数据位置设置为芜湖、成都，调度策略是允许OOS自动调度。 plaintext PUT / HTTP/1.1 Host: docs.ooscn.ctyunapi.cn ContentLength:200 ContentType: application/xml; charsetutf8 Date: Mon, 03 Sep 2012 12:00:00 GMT Authorization: SignatureValue WuHu Specified WuHu ChengDu Allowed 响应示例2 plaintext HTTP/1.1 200 OK xamzrequestid: c962c64b9f294f7b14877a897e7b8d9352545d484a4c4e6879 Date: Mon, 03 Sep 2012 12:00:00 GMT Location: /docs ContentLength: 0 Server: CTYUN

名称 描述 是否必须 xamzcopysource 源Bucket和文件的名称，用斜杠(/)分割。 类型：字符串。 是 xamzmetadatadirective 指明元数据是源文件的拷贝或者元数据被请求头提供的元数据覆盖。 类型：字符串。 取值： COPY：除存储类型（xamzstorageclass）、数据位置（xctyundatalocation）外的其他元数据保持不变，拷贝源文件的元数据。 REPLACE：所有原始元数据都被指定的元数据覆盖。 默认值为COPY。 注意 如果取值为COPY，源文件和目的文件相同，则必须携带xamzstorageclass，否则不能拷贝，返回400错误码。 否 xamzcopysourceifmatch 只有当源文件的Etag与给定Etag匹配时，才能执行文件拷贝操作，否则返回412 HTTP状态码错误。 类型：字符串。 否 xamzcopysourceifnonematch 只有当源文件的Etag与给定Etag不匹配时，才能执行文件拷贝操作，否则返回412 HTTP状态码错误。 类型：字符串。 否 xamzcopysourceifunmodifiedsince 只有源文件在指定时间点之后没有修改，才执行文件拷贝操作，否则返回412错误。 类型：字符串。 取值：格式为EEE, d MMM yyyy HH:mm:ss 'GMT'。 否 xamzcopysourceifmodifiedsince 只有源文件在指定时间点之后修改过，才执行文件拷贝操作，否则返回412错误。 类型：字符串。 取值：格式为EEE, d MMM yyyy HH:mm:ss 'GMT'。 否 xamzstorageclass 目标文件的存储类型。 类型：字符串。 取值: STANDARD：标准存储。 STANDARDIA：低频访问存储 默认值为STANDARD。 否 xctyundatalocation 目标文件的数据位置。 注意 香港节点不支持此参数。 类型：字符串。 取值： 格式为：typeLocal,scheduleStrategy scheduleStrategy 或者typeSpecified,location location ,scheduleStrategy scheduleStrategy type：指定数据存储位置的类型，取值为Local或者Specified。Local表示就近写入，Specified表示指定位置。如果type取值为Specified，则需要指定具体的数据位置location，location可以填写多个，以逗号分隔： 对于对象存储网络，可取值为：ChengDu、GuiYang、LanZhou、QingDao、SH2、ShenYang、ShenZhen、SuZhou、WuHan、WuHu、WuLuMuQi、ZhengZhou。 对于对象存储网络2，可取值为：NeiMeng1、HangZhou1。 scheduleStrategy：调度策略，取值为： Allowed：允许OOS自动调度数据存储位置。 NotAllowed：不允许OOS自动调度数据存储位置。 否 xamzmetaparamater 用户自定义的元数据，用户可以根据需要，自定义一些元数据的参数。 类型：字符串。 否

响应结果 名称 描述 Account 发出请求的账户名。 UserName 发出请求的用户名。如果根用户发送的该请求，则UserName为root。 StorageClass 存储类型： ALL：所有存储类型。 STANDARAD：标准类型。 STANDARADIA：低频访问类型。 TimeZone 返回数据的时区，统一为UTC +0800。 Freq 返回统计数据的采样粒度： byHour：统计数据的采样粒度为1小时。 byDay：统计数据的采样粒度为1天。 BucketName Bucket名字。如果用户在请求中没有携带Bucket参数，BucketName为空。 RegionName 数据位置，如果用户在请求中没有携带Region参数，RegionName为空。 Statistics.Date 返回结果对应的时间： 当请求参数Freq为byHour时，返回格式为yyyyMMdd HH:mm。 当请求参数Freq为byDay时，返回格式为yyyyMMdd。 Statistics.Standard.BilledStorage.BilledStorageUsage 标准存储数据收费容量，单位是Byte。 Statistics.Standard.BilledStorage.RemainderChargeStorageUsage 标准存储数据补齐容量（时长补齐和大小补齐容量的和值），值为0。 Statistics.Standard.BilledStorage.RemainderChargeOfDuration 标准存储数据存储时长补齐容量，值为0。 Statistics.Standard.BilledStorage.RemainderChargeOfSize 标准存储数据大小补齐容量，值为0。 Statistics.Standardia.BilledStorage.BilledStorageUsage 低频访问存储数据收费容量，单位是Byte。 Statistics.Standardia.BilledStorage.RemainderChargeStorageUsage 低频访问存储数据补齐容量（时长补齐和大小补齐容量的和值），单位是Byte。 Statistics.Standardia.BilledStorage.RemainderChargeOfDuration 低频访问存储数据时长补齐容量，单位是Byte。 Statistics.Standardia.BilledStorage.RemainderChargeOfSize 低频访问存储数据大小补齐容量，单位是Byte。

请求示例 获取一个名叫docs的Bucket的数据位置和索引位置： plaintext GET /?location HTTP/1.1 Host: docs.ooscn.ctyunapi.cn ContentType: application/xml;charsetutf8 Date: Mon, 03 Sep 2012 12:00:00 GMT Authorization: SignatureValue 响应示例 plaintext HTTP/1.1 200 OK xamzrequestid: b9e8da1354774e89d14437463b484a500f111b0507090b0d0f Date: Mon, 03 Sep 2012 12:00:00 GMT ContentType: application/xml;charsetutf8 ContentLength: 200 Server: CTYUN WuHu Local

对象存储网络2 对象存储网络2中的各个地区，使用统一的OOS API、统计、操作跟踪和IAM API的Endpoint。对象存储网络2 Endpoint列表如下： OOS API Endpoint: ooscn2.ctyunapi.cn，支持HTTP和HTTPS。 统计API Endpoint: ooscn2mg.ctyunapi.cn，支持HTTPS。 操作跟踪API Endpoint：ooscn2cloudtrail.ctyunapi.cn，支持HTTPS。 IAM Endpoint: ooscn2iam.ctyunapi.cn，支持HTTPS。 说明 对于对象存储网络2中的OOS API，如果您的数据存储在某个资源池，建议您直接使用该资源池的Endpoint。Endpoint列表如下（Endpoint列表仅为资源池Endpoint访问信息描述，与资源状态无关联）。 地区 OOS API Endpoint 内蒙古1 oosnm1.ctyunapi.cn 杭州1 ooshz1.ctyunapi.cn 香港节点（仅支持API） 香港节点分为香港精品网络 和香港普通网络两种方式，精品网和普通网OOS API的Endpoint不同，统计、操作跟踪和IAM API的Endpoint相同： 香港精品网OOS API Endpoint: ooscnhkhqnet.ctyunapi.cn，香港普通网OOS API Endpoint：ooscnhknqnet.ctyunapi.cn。支持HTTP和HTTPS。 统计API Endpoint: ooscnhkmg.ctyunapi.cn，支持HTTP和HTTPS。 操作跟踪API Endpoint：ooscnhkcloudtrail.ctyunapi.cn，支持HTTPS。 IAM Endpoint：ooscnhkiam.ctyunapi.cn，支持HTTPS。 其他地域 除对象存储网络、对象存储网络2和香港节点外，其他地域的Endpoint列表如下。 地区 OOS API Endpoint 北京2 oosbj2.ctyunapi.cn 江苏 oosjs.ctyunapi.cn 北京 ooshqbj.ctyunapi.cn 上海 ooshqsh.ctyunapi.cn

名称 描述 是否必须 Action GetConcurrentConnection。 是 BeginDate 指定查询并发连接数的起始时间，统计数据的起始时间为开始日期（时区为：UTC+8）的00:00。 类型：Time 取值：格式为yyyyMMdd。 是 EndDate 指定查询并发连接数的结束时间，返回数据的时间为当天日期（时区为：UTC+8）的最后一个数据。 类型：Time 取值：格式为yyyyMMdd。EndDate不能早于BeginDate。 说明 EndDate与BeginDate的间隔小于1天。 是 Bucket 指定查询并发连接数Bucket的名称。如果不指定Bucket名称，则表示查询账户下所有Bucket的并发连接数之和。 类型：字符串 取值：3~63个字符，只能由小写字母、数字、短横线（）和点（.）组成。 否 Region 指定查询并发连接数的数据位置。如果不指定数据位置名称，则查询账户名下所有数据位置的并发连接数之和。 类型：字符串 取值： 对象存储网络：ZhengZhou、ShenYang、ChengDu、WuLuMuQi、LanZhou、QingDao、GuiYang、WuHu、WuHan、ShenZhen、SH2、SuZhou。 对象存储网络2：NeiMeng1、HangZhou1。 香港节点：HongKong。 否 InternetType 指定返回并发连接数的网络类型互联网/非互联网。 类型：字符串 取值： all：指定返回互联网并发连接数和非互联网并发连接数。 internet：指定返回互联网的并发连接数。 noninternet：指定返回非互联网的并发连接数。 默认值为all。 否 Freq 指定返回统计数据的采样粒度。 类型：Enum 取值：by5min：统计数据的采样粒度为5分钟。 默认值为by5min。 否

本节介绍OpenViking接入指引。 OpenViking 是专为 AI 智能体设计开发的开源上下文管理工具。它通过定义极简的上下文交互范式，将 Agent 的记忆、资源和技能统一组织为层级化结构，支持 L0/L1/L2 分层上下文加载，有效降低 Token 消耗并提升长期记忆能力。该工具能够解决传统上下文碎片化、检索效果不佳等问题，使 Agent 开发更加简洁、可扩展且具备自进化能力。通常作为 OpenClaw 等框架的插件或扩展使用，适用于构建企业知识库、智能问答系统等场景。 启用 OpenViking 1. 修改 OpenViking 配置； 配置文件路径： Windows：C:UsersAdministrator.openvikingov.conf Linux：/home/ctyun/.openviking/ov.conf 请配置 Embedding 模型和 VLM 模型。使用天翼云 OpenClaw 云电脑默认模型时，配置示例如下（请替换为您的实际 APIKEY）： plaintext "embedding": { "dense": { "provider": "openai", "apikey": "YOURAPIKEY", "model": "openclawctyunsmartoc", "apibase": " "dimension": 1024 } }, "vlm": { "provider": "openai", "apikey": "YOURAPIKEY", "model": "openclawctyunsmartoc", "apibase": " } YOURAPIKEY 可通过云智助手或 OpenClaw 配置文件获取，配置完成后请保存文件。 说明 自定义模型配置属于进阶操作，详细说明请参考官方文档：< 2. 修改 OpenClaw 配置； 将 plugins.slots.contextEngine 字段设置为 openviking： plaintext "slots": { "contextEngine": "openviking" } 同时配置 plugins.entries.openviking 字段： Windows 配置： plaintext "openviking": { "enabled": true, "config": { "mode": "local", "configPath": "C:UsersAdministrator.openvikingov.conf", "port": 1933 } } Linux 配置： plaintext "openviking": { "enabled": true, "config": { "mode": "local", "configPath": "/home/ctyun/.openviking/ov.conf", "port": 1933 } } 3. 重启 OpenClaw。 在终端执行以下命令： plaintext openclaw gateway restart

名称 描述 是否必须 BucketName 存储桶名称。 类型：字符串。 是 delimiter 分隔符，一个用来对关键字们进行分组的字符。所有的关键字都包含delimiter和prefix间的相同子串，prefix之后第一个遇到delimiter的字符串都会加到一个叫CommonPrefix的组中。如果没有特别定义prefix，所有的关键字都会被返回，但不会有CommonPrefix。delimiter 只支持”/”，不支持其他分隔符。 类型：字符串。 否 marker 分页标识。还有需要返回的用户时，上条响应结果中会返回该参数。查看未显示项时，请求参数中需要携带此参数。 类型：字符串。 取值：与上条响应中返回的结果值相同。 否 maxkeys 设置响应中最多返回的条数。如果存在超出您指定的返回项，则IsTruncated响应元素为true，表示需要再次发送请求查看未显示的项。查看未显示的项时，需要携带响应参数Marker的值。 类型：整型。 取值：1~1000，默认值为1000。 否 prefix 前缀用来限制返回的结果必须以这个前缀开始，可以通过前缀将bucket分为若干个组。 否 encodingtype 指定响应中Delimiter、Marker、Prefix、NextMarker、Key、CommonPrefixes.Prefix的编码类型。如果Delimiter、Marker、Prefix、NextMarker、Key、CommonPrefixes.Prefix包含xml 1.0标准不支持的控制字符，可通过设置该参数对响应中的Delimiter、Marker、Prefix、NextMarker、Key、CommonPrefixes.Prefix进行编码。 类型：字符串。 取值：url，字母不区分大小写。 否

名称 描述 Account 发出请求的账户名。 UserName 发出请求的用户名。如果根用户发送的该请求，则UserName为root。 StorageClass 指定查询的存储类型： ALL：所有存储类型。 STANDARD：标准存储。 STANDARDIA：低频访问存储。 TimeZone 返回数据的时区，统一为UTC +0800。 InternetType 返回的返回码类型互联网/非互联网: all:互联网返回码和非互联网返回码。 internet：互联网返回码。 noninternet：非互联网返回码。 RequestsType 返回码次数的请求类型，当返回多个时，用分隔符“+”连接： all：所有请求类型的返回码次数。 get：get类型的返回码次数。 head：head类型的返回码次数。 put：put类型的返回码次数。 post：post类型的返回码次数。 delete：delete类型的返回码次数。 others：除上述外的其他类型的返回码次数。 ResponseType 返回的返回码类型，当返回多个时，用分隔符“+”连接： all：所有类型的返回码。 Response200。 Response204。 Response206。 Response403。 Response404。 Response4xx。 Response500。 Response503。 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.Internet.Get 标准存储数据互联网Get类型请求码的次数。可以具体到下列请求类的次数： Response200。 Response206。 Response403。 Response404。 Response4xx。 Response500。 Response503。 Statistics.Data.Internet.Head 标准存储数据互联网Head类型请求码的次数。可以具体到下列请求类的次数： Response200。 Response206。 Response403。 Response404。 Response4xx。 Response500。 Response503。 Statistics.Data.Internet.Put 标准存储数据互联网Put类型请求码的次数。可以具体到下列请求类的次数： Response200。 Response403。 Response404。 Response4xx。 Response500。 Response503。 Statistics.Data.Internet.Post 标准存储数据互联网Post类型请求码的次数。可以具体到下列请求类的次数： Response200。 Response403。 Response404。 Response4xx。 Response500。 Response503。 Statistics.Data.Internet.Delete 标准存储数据互联网Delete类型请求码的次数。可以具体到下列请求类的次数： Response200。 Response204。 Response403。 Response404。 Response4xx。 Response500。 Response503。 Statistics.Data.Internet.Others 标准存储数据互联网Others类型请求码的次数。可以具体到下列请求类的次数： Response200。 Response403。 Response404。 Response4xx。 Response500。 Response503。 Statistics.Data.NonInternet.Get 标准存储数据非互联网Get类型请求码的次数。可以具体到下列请求类的次数： Response200。 Response206。 Response403。 Response404。 Response4xx。 Response500。 Response503。 Statistics.Data.NonInternet.Head 标准存储数据非互联网Head类型请求码的次数。可以具体到下列请求类的次数： Response200。 Response206。 Response403。 Response404。 Response4xx。 Response500。 Response503。 Statistics.Data.NonInternet.Put 标准存储数据非互联网Put类型请求码的次数。可以具体到下列请求类的次数： Response200。 Response403。 Response404。 Response4xx。 Response500。 Response503。 Statistics.Data.NonInternet.Post 标准存储数据非互联网Post类型请求码的次数。可以具体到下列请求类的次数： Response200。 Response403。 Response404。 Response4xx。 Response500。 Response503。 Statistics.Data.NonInternet.Delete 标准存储数据非互联网Delete类型请求码的次数。可以具体到下列请求类的次数： Response200。 Response204。 Response403。 Response404。 Response4xx。 Response500。 Response503。 Statistics.Data.NonInternet.Others 标准存储数据非互联网Others类型请求码的次数。可以具体到下列请求类的次数： Response200。 Response403。 Response404。 Response4xx。 Response500。 Response503。 Statistics.Standardia.Internet.Get 低频访问存储数据互联网Get类型请求码的次数。可以具体到下列请求类的次数： Response200。 Response206。 Response403。 Response404。 Response4xx。 Response500。 Response503。 Statistics.Standardia.Internet.Head 低频访问存储数据互联网Head类型请求码的次数。可以具体到下列请求类的次数： Response200。 Response206。 Response403。 Response404。 Response4xx。 Response500。 Response503。 Statistics.Standardia.Internet.Put 低频访问存储数据互联网Put类型请求码的次数。可以具体到下列请求类的次数： Response200。 Response403。 Response404。 Response4xx。 Response500。 Response503。 Statistics.Standardia.Internet.Post 低频访问存储数据互联网Post类型请求码的次数。可以具体到下列请求类的次数： Response200。 Response403。 Response404。 Response4xx。 Response500。 Res ponse503。 Statistics.Standardia.Internet.Delete 低频访问存储数据互联网Delete类型请求码的次数。可以具体到下列请求类的次数： Response200。 Response204。 Response403。 Response404。 Response4xx。 Response500。 Response503。 Statistics.Standardia.Internet.Others 低频访问存储数据互联网Others类型请求码的次数。可以具体到下列请求类的次数： Response200。 Response403。 Response404。 Response4xx。 Response500。 Response503。 Statistics.Standardia.NonInternet.Get 低频访问存储数据非互联网Get类型请求码的次数。可以具体到下列请求类的次数： Response200。 Response206。 Response403。 Response404。 Response4xx。 Response500。 Response503。 Statistics.Standardia.NonInternet.Head 低频访问存储数据非互联网Head类型请求码的次数。可以具体到下列请求类的次数： Response200。 Response206。 Response403。 Response404。 Response4xx。 Response500。 Response503。 Statistics.Standardia.NonInternet.Put 低频访问存储数据非互联网Put类型请求码的次数。可以具体到下列请求类的次数： Response200。 Response403。 Response404。 Response4xx。 Response500。 Response503。 Statistics.Standardia.NonInternet.Post 低频访问存储数据非互联网Post类型请求码的次数。可以具体到下列请求类的次数： Response200。 Response403。 Response404。 Response4xx。 Response500。 Response503。 Statistics.Standardia.NonInternet.Delete 低频访问存储数据非互联网Delete类型请求码的次数。可以具体到下列请求类的次数： Response200。 Response204。 Response403。 Response404。 Response4xx。 Response500。 Response503。 Statistics.Standardia.NonInternet.Others 低频访问存储数据非互联网Others类型请求码的次数。可以具体到下列请求类的次数： Response200。 Response403。 Response404。 Response4xx。 Response500。 Response503。

本节主要介绍GetDeleteCapacity。 此操作用来查询用户删除的容量。 请求参数 名称 描述 是否必须 Action GetDeleteCapacity。 是 BeginDate 指定查询容量的起始时间，统计数据的起始时间为开始日期（时区为：UTC+8）的00:00。 类型：Time 取值：格式为yyyyMMdd。 是 EndDate 指定查询容量的结束时间，返回数据的时间为当天日期（时区为：UTC+8）的最后一个数据。 类型：Time 取值：格式为yyyyMMdd。EndDate不能早于BeginDate。 说明 Freqby5min，EndDate与BeginDate的间隔小于1天。 FreqbyHour，EndDate与BeginDate的间隔小于7天。 FreqbyDay，EndDate与BeginDate的间隔小于30天。 是 StorageClass 指定查询的存储类型。 类型：Enum 取值: ALL：所有存储类型。 STANDARD：标准存储。 STANDARDIA：低频访问存储。 默认值为STANDARD。 否 Bucket 指定查询删除容量的Bucket名称。如果不指定Bucket名称，则表示查询账户下所有Bucket的删除容量之和。 类型：字符串 取值：3~63个字符串，只能由小写字母、数字、短横线（）和点（.）组成。 否 Region 指定查询删除容量的数据位置。如果不指定数据位置名称，则表示查询账户下所有数据位置的删除容量之和。 类型：字符串 取值： 对象存储网络：ZhengZhou、ShenYang、ChengDu、WuLuMuQi、LanZhou、QingDao、GuiYang、WuHu、WuHan、ShenZhen、SH2、SuZhou。 对象存储网络2：NeiMeng1、HangZhou1。 香港节点：HongKong。 否 Freq 指定返回统计数据的采样粒度。 类型：Enum 取值： by5min：统计数据的采样粒度为5分钟。 byHour：统计数据的采样粒度为1小时。 byDay：统计数据的采样粒度为1天。 默认值为byHour。 否

本节主要介绍GetRequests。 此操作用来查询用户的请求次数。 请求参数 名称 描述 是否必须 Action GetRequests。 是 BeginDate 指定查询请求次数的起始时间，统计数据的起始时间（时区为：UTC+8）为开始日期的00:00。 类型：Time 取值：格式为yyyyMMdd。 是 EndDate EndDate 指定查询请求的结束时间，返回数据的时间为当天日期（时区为：UTC+8）的最后一个数据。 类型：Time 取值：格式为yyyyMMdd。EndDate不能早于BeginDate。 说明 Freqby5min，EndDate与BeginDate的间隔小于1天。 FreqbyHour，EndDate与BeginDate的间隔小于7天。 FreqbyDay，EndDate与BeginDate的间隔小于30天。 是 StorageClass 指定查询的存储类型。 类型：Enum 取值: ALL：所有存储类型。 STANDARD：标准存储。 STANDARDIA：低频访问存储。 默认值为STANDARD。 否 Bucket 指定查询请求次数的Bucket名称。如果不指定Bucket名称，则表示查询账户下所有的Bucket的请求次数之和。 类型：字符串 取值：3~63个字符，只能由小写字母、数字、短横线（）和点（.）组成。 否 Region 指定查询请求次数的数据位置。如果不指定数据位置，则查询账户名下所有数据位置的请求次数之和。 类型：字符串 取值： 对象存储网络：ZhengZhou、ShenYang、ChengDu、WuLuMuQi、LanZhou、QingDao、GuiYang、WuHu、WuHan、ShenZhen、SH2、SuZhou。 对象存储网络2：NeiMeng1、HangZhou1。 香港节点：HongKong。 否 InternetType 指定返回的请求次数网络类型互联网/非互联网。 类型：字符串 取值： all：指定返回互联网请求次数和非互联网请求次数。 internet：指定返回互联网的请求次数。 noninternet：指定返回非互联网的请求次数。 默认值为all。 否 RequestsType 指定返回的请求类型。 类型：字符串 取值： all：指定返回所有类型的请求次数。 get：指定返回get类型的请求次数。 head：指定返回head类型的请求次数。 put：指定返回put类型的请求次数。 post：指定返回post类型的请求次数。 delete：指定返回delete类型的请求次数。 others：指定返回除上述外的其他类型的请求次数。 默认值为all。 否 Freq 指定返回统计数据的采样粒度。 类型：Enum 取值： by5min：统计数据的采样粒度为5分钟。 byHour：统计数据的采样粒度为1小时。 byDay：统计数据的采样粒度为1天。 默认值为byHour。 否

请求示例 按天（byDay）查询Bucket为examplebucket、数据位置为ZhengZhou、20191015至20191016标准存储数据的流量。 plaintext GET /?ActionGetTraffics&BeginDate20191015&EndDate20191016& StorageClassSTANDARD&Bucketexamplebucket&FreqbyDay&RegionZhengZhou HTTP/1.1 Date: Wed, 16 Oct 2019 06:41:57 GMT Authorization: SignatureValue Host: ooscnmg.ctyunapi.cn 响应示例 plaintext HTTP/1.1 200 OK Date: Wed, 16 Oct 2019 06:41:57 GMT xamzrequestid: c1bd7162b01e4a45 ContentLength: 1316 ContentType: application/xml; charsetutf8 Server: CTYUN test@ctyun.cn usertest1 STANDARD UTC +0800 all all all byDay examplebucket ZhengZhou 20191015 86400 259200 432000 604800 172800 345600 518400 691200 ...

本节主要介绍GetRestoreCapacity。 此操作用来查询数据取回量。用户可以根据需求，查询指定存储桶、指定存储类型的数据取回量。 请求参数 名称 描述 是否必须 Action GetRestoreCapacity。 是 BeginDate 指定查询数据取回量的起始时间，统计数据的起始时间为开始日期（时区为：UTC+8）的00:00。 类型：Time 取值：格式为yyyyMMdd。 是 EndDate 指定查询数据取回量的结束时间，返回数据的时间为当天日期（时区为：UTC+8）的最后一个数据。 类型：Time 取值：格式为yyyyMMdd。EndDate不能早于BeginDate。 说明 Freqby5min，EndDate与BeginDate的间隔小于1天。 FreqbyHour，EndDate与BeginDate的间隔小于7天。 FreqbyDay，EndDate与BeginDate的间隔小于30天。 是 StorageClass 指定查询的存储类型。 类型：Enum 取值： ALL：所有存储类型。 STANDARADIA：低频访问类型。 默认值为ALL。 否 Bucket 指定查询数据取回量的Bucket名称。如果不指定Bucket名称，则表示查询账户下所有Bucket的数据取回量之和。 类型：字符串 取值：3~63个字符，只能由小写字母、数字、短横线（）和点（.）组成。 否 Region 指定查询数据取回量的数据位置。如果不指定数据位置名称，则表示查询账户下所有数据位置的数据取回量之和。 类型：字符串 取值： 对象存储网络：ZhengZhou、ShenYang、ChengDu、WuLuMuQi、LanZhou、QingDao、GuiYang、WuHu、WuHan、ShenZhen、SH2、SuZhou。 对象存储网络2：NeiMeng1、HangZhou1。 香港节点：HongKong。 否 Freq 指定返回统计数据的采样粒度。 类型：Enum 取值： by5min：统计数据的采样粒度为5分钟。 byHour：统计数据的采样粒度为1小时。 byDay：统计数据的采样粒度为1天。 默认值为byHour。 否

请求示例 plaintext HEAD /ObjectName HTTP/1.1 Host: examplebucket.ooscn.ctyunapi.cn Date: Mon, 15 Nov 2021 06:39:41 GMT ContentType: application/octetstream Connection: KeepAlive Authorization: SignatureValue 响应示例 plaintext HTTP/1.1 200 OK ContentLength: 1467326 ETag: "5db44ee68a1e577907c2699c8f582107" LastModified: Mon, 15 Nov 2021 06:39:39 GMT ContentType: application/xjavaarchive ContentMD5: XbRO5ooeV3kHwmmcj1ghBw xctyunmetadatalocation: ChengDu xctyundatalocation: ZhengZhou Date: Mon, 15 Nov 2021 06:39:41 GMT xamzrequestid: 4ae1a5d637614e3d137f838a928a8c9251535747494b4d4f51 Server: CTYUN

改造资源池名称 改造后资源池名称 改造完成时间点 旧域名信息 杭州资源池 对象存储网络2杭州1资源池 2025年09月11日 以下域名继续保留： OOS API： 统计 API： IAM API： 自服务控制台域名： 静态网站托管的CNAME Record Value： 内蒙2资源池 对象存储网络2内蒙古1资源池 2026年4月24日 以下域名继续保留。 OOS API： 统计 API： IAM API： 自服务控制台域名： 静态网站托管的CNAME Record Value：

参数 是否必填 说明 path 是 文件路径 offset 否 起始字节偏移，默认 0 length 否 最多读取字节数，默认 0 表示读取剩余内容

参数 是否必填 说明 desktopCode 是 目标云电脑桌面编码 path 是 写入目标路径 content 是 写入文本内容 mode 否 overwrite 覆盖写入、 append 追加写入、 createnew 仅新建写入

工具名 用途 movemouse 移动鼠标到指定坐标 clickmouse 在指定坐标点击鼠标 dragmouse 从起点拖拽到终点 scroll 在指定位置滚动 presskey 按下键盘按键或组合键 typetext 输入文本 screenshot 截取当前桌面屏幕 getcursorposition 获取当前鼠标位置

本节介绍FileSystem功能操作能力。 FileSystem 是 AIuse 云电脑面向 Agent 和自动化系统提供的文件操作能力，用于在云电脑环境中读取、写入、搜索、移动和管理文件。 能力概述 FileSystem 当前规划和技术方案覆盖以下能力： 能力 说明 读取文件 支持按路径读取文件内容，可按偏移量和长度读取片段 写入文件 支持覆盖写入、追加写入和新建写入模式 创建目录 支持创建目录，并可自动补齐父目录 移动文件 支持文件或目录移动，也可用于重命名 搜索文件 支持按通配符、正则或精确文件名搜索 获取文件信息 支持获取文件大小、类型、路径等元数据 下载文件 大文件或二进制文件可通过临时地址传输，具体能力以发布版本为准 设计目标 FileSystem 能力的目标是为 Agent 提供统一、可控的文件系统语义。 典型场景 读取应用生成的日志、报表或结果文件。 将 Agent 生成的内容写入云电脑工作目录。 查找指定目录下的文件。 将文件移动到指定目录，完成任务归档。 配合 Computer Use 完成“操作软件生成文件，再读取文件内容”的闭环任务。 示例流程 1. 通过 Computer Use 操作桌面软件生成文件。 2. 使用 FileSystem 搜索输出目录。 3. 读取目标文件内容。 4. 将结果返回业务系统或 Agent。

创建测试目录 在 Qoder 中输入： plaintext 在 desktopCodexxx 桌面，创建一下 C:/aiusertest 文件夹。 结构化工具调用等价于： plaintext { "name": "createdirectory", "arguments": { "desktopCode": "xxx", "path": "C:/aiusertest" } } 写入文件 plaintext { "name": "writefile", "arguments": { "desktopCode": "xxx", "path": "C:/aiusertest/hello.txt", "mode": "overwrite", "content": "Hello from AIuse MCP" } } 读取文件 plaintext { "name": "readfile", "arguments": { "desktopCode": "xxx", "path": "C:/aiusertest/hello.txt", "offset": 0, "length": 0 } } length 为 0 时表示读取从 offset 开始的剩余内容。 执行 GUI 操作 移动鼠标： plaintext { "name": "movemouse", "arguments": { "desktopCode": "xxx", "x": 500, "y": 300 } } 输入文本： plaintext { "name": "typetext", "arguments": { "desktopCode": "xxx", "text": "Hello from AIuse MCP" } } 排查建议 如果没有看到工具列表，请检查： npx 是否可用。 MCP Server 包名是否正确。 CTGAPIKEY 和 CTGAPISECRET 是否填写正确。 AccessKey 是否已关联目标云电脑。 云电脑是否在线。 如果工具调用失败，请检查： 指令或工具参数中是否包含 desktopCode。 文件路径是否存在或可写。 鼠标键盘操作前是否已通过截图确认界面状态。

字段 是否必填 说明 command 是 启动命令，当前示例使用 npx args 是 启动参数，包含 MCP Server 包名 CTGAPIKEY 是 AccessKey ID CTGAPISECRET 是 AccessKey Secret CTGSERVICEURL 否 服务地址，未配置时使用默认服务地址

本文介绍通过 MCP 调用 AIuse 云电脑 Computer Use 工具的方法。 本文介绍通过 MCP 调用 AIuse 云电脑 Computer Use 工具的方法。以下示例以 desktopCodexxx 为例，实际调用时请替换为目标云电脑的桌面编码。 工具列表 工具名 说明 movemouse 移动鼠标 clickmouse 点击鼠标 dragmouse 拖拽鼠标 scroll 滚动 presskey 按下键盘按键 typetext 输入文本 screenshot 截图 getcursorposition 获取鼠标位置 movemouse 移动鼠标到指定坐标。 plaintext { "name": "movemouse", "arguments": { "desktopCode": "xxx", "x": 500, "y": 300 } } 参数说明： 参数 是否必填 说明 desktopCode 是 目标云电脑桌面编码 x 是 目标 X 坐标 y 是 目标 Y 坐标 clickmouse 在指定坐标点击鼠标。 plaintext { "name": "clickmouse", "arguments": { "desktopCode": "xxx", "x": 500, "y": 300, "clickMode": "left" } } 参数说明： 参数 是否必填 说明 desktopCode 是 目标云电脑桌面编码 x 是 X 坐标 y 是 Y 坐标 clickMode 否 left、right、middle、doubleleft，默认 left pressMode 否 是否仅按下鼠标 releaseMode 否 是否仅释放鼠标

维度 建议 项目隔离 不同业务项目使用不同 AccessKey 环境隔离 开发、测试、生产环境使用不同 AccessKey 权限最小化 AccessKey 只关联必要的云电脑 生命周期管理 临时任务结束后及时禁用或删除 AccessKey 审计追踪 AccessKey 名称建议包含项目、环境和用途

处理失败任务 失败任务建议记录： 当前步骤。 最近一次截图。 关键输入参数。 错误码和错误信息。 文件输出情况。 对于可重试任务，应在重试前确认当前桌面状态，避免重复提交或重复写入。 上线检查 上线前建议确认： AccessKey 权限范围最小化。 云电脑资源数量满足并发需求。 会话关闭逻辑可靠。 关键操作有截图或状态校验。 错误码已映射到业务告警或人工处理流程。 任务日志已脱敏。

执行业务操作 执行业务操作时，建议将任务拆分为多个小步骤，每个步骤都具备明确的输入、动作和结果判断。 示例： 1. 打开目标页面。 2. 输入查询条件。 3. 点击查询按钮。 4. 等待结果区域刷新。 5. 导出结果文件。 6. 使用 FileSystem 读取导出文件。 结果确认 结果确认可以结合以下方式： 使用 screenshot 留存界面状态。 使用 readfile 读取导出的文本文件。 使用 searchfiles 检查输出目录是否生成目标文件。 使用业务系统自身的状态接口或任务记录进行交叉验证。 异常处理 桌面应用可能出现弹窗、卡顿、登录过期、网络异常等情况。建议为以下异常设计处理策略： 应用启动失败。 窗口未出现在预期位置。 输入后无响应。 点击后出现错误弹窗。 导出文件未生成。 文件读取失败。 对无法自动恢复的异常，应保留截图、会话 ID 和任务日志，便于人工排查。 收尾建议 关闭当前任务打开的窗口。 将输出文件移动到约定目录。 清理任务执行过程中产生的临时内容。 关闭 SDK 会话。 记录任务结果和关键日志。

审计建议 建议记录以下审计信息： 调用时间。 调用方系统或任务 ID。 脱敏后的 AccessKey ID。 桌面编码。 会话 ID。 调用工具名称。 结果状态和错误码。 审计日志中不应包含完整 Secret、敏感文件正文或未脱敏截图。 合规说明 如需对外提供合规材料，建议由产品、安全和法务共同确认以下内容： 数据存储位置。 日志保存周期。 临时文件清理周期。 权限模型和审计能力。 适用的企业安全认证或合规声明。