其他地域 除对象存储网络、对象存储网络2和香港节点外，其他地域的Endpoint列表如下。 地区 OOS API Endpoint 江苏 oosjs.ctyunapi.cn

变量 描述 xamzexpiration 如果文件被配置了到期时间，那么OOS返回此响应头。这个响应头包含键值对expirydate和ruleid。ruleid的值是URL编码的。 xamzstorageclass 文件的存储类型。如果存储类型为STANDARD，不返回此项。 类型：字符串。 取值：STANDARDIA：低频访问存储。 xctyunmetadatalocation 文件的索引位置。 注意 香港节点不会返回此项。 类型：枚举。 取值： 对于对象存储网络，取值为：ChengDu、FuZhou、GuiYang、HangZhou、LaSa、LanZhou、QingDao、ShenYang、ShenZhen、WuHan、WuHu、WuLuMuQi、ZhengZhou、SH2、SuZhou。 对于对象存储网络2，取值为：NeiMeng1、HangZhou1、ShangHai7、TianJin6。 xctyundatalocation 文件的数据位置。 注意 香港节点不会返回此项。 类型：枚举。 取值： 对于对象存储网络，取值为：ChengDu、GuiYang、LanZhou、QingDao、SH2、ShenYang、ShenZhen、SuZhou、WuHan、WuHu、WuLuMuQi、ZhengZhou。 对于对象存储网络2，取值为：NeiMeng1、HangZhou1、ShangHai7、TianJin6。 xamzmeta 以该前缀开头的用户定义的元数据响应头。每一个都作为一组键值对存储和返回。OOS不验证或解释用户定义的元数据。 类型：字符串。 xctyunlastaccesstime Object的最后一次访问时间。 如果为Object开启了匹配最后一次访问时间的生命周期规则，会返回该响应头，否则不返回该响应头。 注意 对于一天内多次访问同一个Object（GET操作），仅记录该Object的该天最早一次访问时间。

名称 描述 BucketConfiguration 设置Bucket索引位置和数据位置的容器。 类型：容器。 子节点：MetadataLocationConstraint、DataLocationConstraint。 MetadataLocationConstraint 设置Bucket的索引位置。 类型：容器。 父节点：CreateBucketConfiguration。 子节点：Location。 DataLocationConstraint 设置Bucket的数据位置。 类型：容器。 父节点：CreateBucketConfiguration。 子节点：Type、LocationList、ScheduleStrategy。 Type 数据位置的类型。 类型：枚举。 取值： Local：本地。 Specified：指定位置。 默认Local。 父节点：DataLocationConstraint。 LocationList 指定的数据位置。 类型：容器。 父节点：DataLocationConstraint。 子节点：Location。 Location 索引位置或数据位置。 类型：字符串。 取值： 父节点为MetadataLocationConstraint，表示索引位置。对于对象存储网络，取值为：ChengDu、FuZhou、GuiYang、HangZhou、LaSa、LanZhou、QingDao、ShenYang、ShenZhen、WuHan、WuHu、WuLuMuQi、ZhengZhou、SH2、SuZhou；对于对象存储网络2，取值为：NeiMeng1、HangZhou1、ShangHai7、TianJin6。 父节点为LocationList，表示数据位置。对于对象存储网络，取值为：ChengDu、GuiYang、LanZhou、QingDao、SH2、ShenYang、ShenZhen、SuZhou、WuHan、WuHu、WuLuMuQi、ZhengZhou；对于对象存储网络2，取值为：NeiMeng1、HangZhou1、ShangHai7、TianJin6。 父节点：MetadataLocationConstraint或LocationList。 ScheduleStrategy 指定数据时的调度策略 类型：枚举 取值： Allowed：允许OOS自动调度。 NotAllowed：不允许OOS自动调度。 父节点：DataLocationConstraint

名称 描述 是否必须 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，字母不区分大小写。 否

本节主要介绍PUT ObjectCopy。 此操作用来创建一个存储在OOS里的文件拷贝。类似于执行一个GET，然后再执行一次PUT。要执行拷贝请求，用户需要对源文件有读权限，对目标Bucket有写权限。 注意 当OOS接收到请求或者正在执行拷贝操作时，拷贝操作可能会返回失败。如果在拷贝操作开始之前出现异常，OOS返回标准的错误信息。如果在拷贝操作过程中出现异常，由于200 OK状态码是先返回的，这意味着200 OK响应体可能包含成功或错误。请在客户端应用程序中解析响应体的内容并进行适当处理。 说明 目标文件名称不能包含ASCII码为0的字符（NUL）。 请求语法 plaintext PUT /destinationObject HTTP/1.1 Host: destinationBucket.ooscn.ctyunapi.cn xamzcopysource: /sourcebucket/sourceObject xamzmetadatadirective: metadatadirective xamzcopysourceifmatch: etag xamzcopysourceifnonematch: etag xamzcopysourceifunmodifiedsince: timestamp xamzcopysourceifmodifiedsince: timestamp xamzmetaparamater: value Authorization: SignatureValue Date: date 请求头 名称 描述 是否必须 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,scheduleStrategyscheduleStrategy 或者typeSpecified,locationlocation ,scheduleStrategyscheduleStrategy type：指定数据存储位置的类型，取值为Local或者Specified。Local表示就近写入，Specified表示指定位置。如果type取值为Specified，则需要指定具体的数据位置location，location可以填写多个，以逗号分隔： 对于对象存储网络，可取值为：ChengDu、GuiYang、LanZhou、QingDao、SH2、ShenYang、ShenZhen、SuZhou、WuHan、WuHu、WuLuMuQi、ZhengZhou。 对于对象存储网络2，可取值为：NeiMeng1、HangZhou1、ShangHai7、TianJin6。 scheduleStrategy：调度策略，取值为： Allowed：允许OOS自动调度数据存储位置。 NotAllowed：不允许OOS自动调度数据存储位置。 否 xamzmetaparamater 用户自定义的元数据，用户可以根据需要，自定义一些元数据的参数。 类型：字符串。 否

名称 描述 是否必须 xamzacl 设置Bucket的ACL（Access Control List）。 类型：字符串。 有效值： private：私有。只有根用户和具有相应权限的子用户可以对该存储桶内的文件进行读/写/删除操作（包括Get、Put和Delete Object），其他人（包括匿名访问）只有通过Bucket Policy授权或分享链接才可访问该存储桶内的文件。 publicread：公共读。只有根用户和具有相应权限的子用户可以对该存储桶内的文件进行写/删除操作（包括Put和Delete Object）。任何人（包括匿名访问）都可以对该存储桶内的文件进行读操作，这有可能造成您数据的外泄以及费用激增，请慎用该权限。 publicreadwrite：公共读写。任何人（包括匿名访问）都可以对该存储桶内的文件进行读/写/删除操作（包括Get、Put和Delete Object）。这有可能造成您数据的外泄以及费用激增，若被人恶意写入违法信息还可能会侵害您的合法权益，除特殊场景外，不建议您配置公共读写权限。 注意 如果想使用访问权限为公共读写的存储桶，请联系天翼云客服评估审核后开通此功能。 默认值为private。 否

地域（Region） RegionID 西南1 200000002368 南宁23 200000001704 长沙42 200000002401 华北2 200000001852 南昌5 200000002527 青岛20 200000001703 上海36 200000001790 华南2 200000002530 华东1 bb9fdb42056f11eda1610242ac110002 太原4 200000002689 武汉41 200000001781 郑州5 200000002586 西安7 200000001851 西南2贵州 200000002927 杭州7 200000003329 芜湖4 200000003327 呼和浩特3 200000003573 庆阳2 200000003664 北京行业云20 200000002529 乌鲁木齐7 200000004098 上海15 200000003330 佛山7 200000004421 沈阳8 200000003335 长春3 200000004705 宁波2 200000004885

本页介绍各II类型资源池的RegionID 资源池RegionID可见下表： 地域（Region） RegionID 西南1 200000002368 南宁23 200000001704 长沙42 200000002401 华北2 200000001852 南昌5 200000002527 青岛20 200000001703 上海36 200000001790 华南2 200000002530 华东1 bb9fdb42056f11eda1610242ac110002 太原4 200000002689 武汉41 200000001781 郑州5 200000002586 西安7 200000001851 西南2贵州 200000002927 杭州7 200000003329 芜湖4 200000003327 呼和浩特3 200000003573 庆阳2 200000003664 北京行业云20 200000002529 乌鲁木齐7 200000004098 上海15 200000003330 佛山7 200000004421 沈阳8 200000003335 长春3 200000004705 宁波2 200000004885

接口功能介绍 虚机弹性IP绑定或者解绑v3 接口约束 无 URI POST /v3/fip/action 路径参数 无 Query参数 参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 请求参数 请求头header参数 无 请求体body参数 参数 是否必填 参数类型 说明 示例 下级对象 desktopOid 是 String 虚机ID fipOid 是 String 弹性IP ID portOid 否 String 虚机网卡ID，操作类型为绑定时必填 action 是 String 操作类型，绑定：bind，解绑：unbind 响应参数 参数 参数类型 说明 示例 下级对象 statusCode Integer 状态码。可能值： 800：请求成功。 900：请求失败。 800 error String 错误码。 ECPC1000 message String 提示信息。 OK. returnObj Object 返回数据结构体。 returnObj 枚举参数 无 请求示例 请求url 请求头header 无 请求体body { "desktopOid":"D0025042501321534", "fipOid":"fipuwk3p534tu2kti3uxt0cz", "portOid":"portjvwzy8cyp3ji5vqaei7t3", "action":"bind" }

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

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

响应示例 { "statusCode":800, "message":"OK.", "returnObj":"" } 状态码 请参考 状态码 错误码 请参考 错误码

枚举参数 无 请求示例 请求url 请求头header 无 请求体body { "desktopOid":["XXXXXX"], "cycleType":"Month", "cycleCnt":1, "autoPay":true } 响应示例 { "statusCode":800, "message":"OK.", "returnObj":{ "newOrderNo":"20250904114057904770", "submitted":true, "totalPrice":332.0, "newOrderId":"0b5abefafb17480eb8290d7044df5905", "errorMessage":"" } } 状态码 请参考 状态码 错误码 请参考 错误码

接口功能介绍 扩容存储包v3 接口约束 无 URI POST /v3/resourcePack/expandStorageResource 路径参数 无 Query参数 参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 请求参数 请求头header参数 无 请求体body参数 参数 是否必填 参数类型 说明 示例 下级对象 resourcePackOid 是 String 资源包ID autoPay 是 Boolean 是否自动支付。取值范围： true：自动支付。自动支付时，请确保支付方式余额充足。余额不足时，将会被拦截，不会生成订单。 false：只产生订单，不扣费。您可以登录门户，根据返回的订单号进行支付。 diskSize 是 Integer 扩容后存储包空间大小（单位：GB），需为100的非负整数倍，范围限制：(当前值, 10 000 000]；diskSize和disType必须同时指定 diskType 是 String 磁盘类型，枚举值范围：[hio]（hio高IO（high IO））；diskSize和disType必须同时指定 响应参数 参数 参数类型 说明 示例 下级对象 statusCode Integer 状态码。可能值： 800：请求成功。 900：请求失败。 800 error String 错误码。 ECPC1000 message String 提示信息。 OK. returnObj Object 返回数据对象 returnObj 表 returnObj 参数 参数类型 说明 示例 下级对象 orderNo String 订单号

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

参数 描述 n SERVERID 或 server SERVERID 要移除服务器的ID。 d 或 deldata 移除服务器时，删除服务器上HBlock数据目录中的数据。 f 或 force 强制移除服务器。 注意 强制移除服务器，可能造成数据丢失。

参数 描述 n LUNNAME 或 name LUNNAME 指定卷名称。可以指定一个或者多个卷，以英文逗号分开。 说明 如果不指定卷名称，表示设置所有卷。

3D投影仪+快门眼镜 连接指引 使用要求： 1.投影仪需要支持SBS 3D视频播放（SidebySide 3D，左右分屏3D）。 2.需要搭配DLP Link快门眼镜使用。 注意 1.多投影仪干扰：如果同一个房间内有多个投影仪同时播放3D视频，快门眼镜可能会闪烁。这是因为多个投影仪的信号会互相干扰。建议同一空间内只使用一台投影仪播放3D内容。 2.最佳观影距离：以120英寸的3D画面为例，最佳观影距离为3.5～4.5米，超过这个距离3D效果会明显减弱。 3.最大观影距离：以极米的DLP眼镜为例，超过15米眼镜将无法接收到同步信号（DLP白色光脉冲）。 1.开启3D模式; 开启3D模式（自动开启） 1. 目前自动识别开启仅部分3D投影仪支持，详见设备 设备适配清单 2. 识别到3D投影仪设备会出现提示； 3. 选择开启后会以3D模式进入，自动开启3D。 开启3D模式（手动开启） 如果用户希望在未适配过的投影仪上尝试使用3D功能，可通过如下方法： 1. 进入云电脑，启动云电脑的3D投影仪模式； 2. 点击投影仪遥控的菜单键，唤出系统设置菜单并打开3D开关，选择“左右3D模式”。 2.佩戴快门眼镜。 佩戴快门眼镜轻按顶部按钮，镜片变黑后观看屏幕即可体验3D效果。 说明 匹配成功后镜片将会变黑，如遇到画面显示异常，可再次点击顶部按钮进行调整。

本节说明云电脑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证书。

本节介绍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

参数 是否必填 说明 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 名称建议包含项目、环境和用途