参数 说明 基本信息 工单名称 输入您待提交工单的名称。 基本信息 工单类型 选择需要授权的工单类型，根据业务需求选择如下四种类型： 资产访问授权 字符命令授权 文件传输授权 数据库命令授权 资产 选择模式 取值范围： 全部资产 选择资产（组） 资产 资产 选择您需要访问的资产或者命令，可多选。 资产 资产组 选择您需要访问的资产组，可多选。 账号 资产账号 选择您需要授权的资产账号。 注意 若选择授权的资产账号为二次登录账号（例如root），需同时授权二次登录的源账号（例如添加root资产账号时配置的二次登录源账号testuser），否则将无法完成二次登录。 协议 服务 （仅工单类型选择“资产访问授权”时需要配置）默认全部服务，也支持选择单个服务。 敏感命令 工单类型：字符命令授权 敏感命令 提示符正则 输入待授权命令的提示符正则式。 敏感命令 命令正则式 输入待授权命令的正则式。 敏感命令 工单类型：文件传输授权 敏感命令 文件传输 选择需要授权的文件传输操作，包括上传、下载、删除等。 敏感命令 文件或目录 配置策略生效的文件或目录的正则表达式，可配置多个，多个以回车进行分隔。 敏感命令 工单类型：数据库命令授权 敏感命令 待执行命令 输入待执行的sql命令，多条命令按英文分号“;”隔开，不超过1000个字符。 敏感命令 sql库名 填写命令生效的SQL库名。 授权时间 生/失效日期 配置权限生效的起始和截止日期。 支持选择1天、3天、7天、15天、长期有效，或者自定义选择日期。 授权时间 生/失效时间 配置权限生效的具体时间点。 支持选择全天、闲时（0点~6点），或者自定义时间。 其他 描述 填写申请工单的相关描述。

操作步骤 步骤 1 登录管理控制台。 步骤 2 单击管理控制台左上角的 ，选择区域。 步骤 3 选择“数据库 > 关系型数据库”。进入关系型数据库信息页面。 步骤 4 在左侧导航栏单击“备份管理”，选择需要恢复的备份，单击操作列的“恢复”。 您也可在“实例管理”页面，单击指定的实例名称，在左侧导航栏单击“备份恢复”，在“全量备份”页签下单击目标备份对应的操作列中的“恢复”。 步骤 5 选择需要的恢复方式，单击“确定”。 新实例：将备份恢复到新创建的实例上。 选择恢复到“新实例”，单击“确定”，跳转到“恢复到新实例”的服务选型页面： − 新实例的数据库引擎和数据库版本，自动与原实例相同。 − 存储空间大小默认和原实例相同，且必须大于或等于原实例存储空间大小。 − 其他参数默认，用户如需设置，请参见购买RDS for MySQL实例。 步骤 6 查看恢复结果。 恢复到新实例 为用户重新创建一个和该备份数据相同的实例。可看到实例由“创建中”变为“正常”，说明恢复成功。 恢复成功的新实例是一个独立的实例，与原有实例没有关联。如需使用只读实例，请重新在该实例上进行创建。 新实例创建成功后，系统会自动执行一次全量备份。 恢复到当前实例 在“实例管理”页面，可查看目标实例状态为“恢复中”，恢复完成后，实例状态由“恢复中”变为“正常”。如果目标实例下存在只读实例，只读实例的状态与目标实例一致。 恢复成功后，会执行一次全量备份。 恢复到已有实例 在“实例管理”页面，可查看目标实例状态为“恢复中”，恢复完成后，实例状态由“恢复中”变为“正常”。如果目标实例下存在只读实例，只读实例的状态与目标实例一致。 恢复成功后，会执行一次全量备份。 您可以通过“任务中心”查看详细进度和结果。 结束

配置稀疏备份策略 步骤 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 单击“确定”，确认修改。 结束

此小节介绍云堡垒机安全设置。 云堡垒机安全设置模块支持您自定义密码强度、账户保护规则。 密码组成：配置用户密码策略，包括配置密码安全强度，密码字符组成。 密码事件：可设置安全登录事件、强制改密时间和首次登录改密。 账号策略：可设置账号空闲事件。 设置密码组成 1. 使用“管理角色”账号登录云堡垒机。 2. 在左侧导航栏选择“系统设置 > 安全管理”，进入“安全管理”模块。 3. 选择密码组成模块，配置密码规则。 设置密码事件 密码事件包含恶意登录事件、密码过期事件、强制改密，用户可根据使用需求对事件进行设置开启或关闭，单击“保存”后生效。 恶意登录事件：根据设置的时间和密码错误次数生效，触发后账号锁定，状态变更为“锁定F”，可联系管理员操作解锁。 密码过期事件：根据设置的有效时间生效，有效时间到期后，触发账号锁定，状态变更为“锁定P”，可联系管理员操作解锁。 强制改密：默认开启，开启强制改密后，用户首次登录堡垒机跳转强制改密界面，强制用户改密后登录。 设置账号事件 账号事件包含账号空闲事件、账号登录事件，您可根据使用需求对事件进行设置开启或关闭，单击“保存”后生效。 账号空闲事件：根据设置的空闲时间生效，距离上一次登录时间达到设置时间后，触发账号锁定，状态变更为“锁定L”，可联系管理员操作解锁。 账号登录事件：根据配置的唯N性值，限制同一账号同时登录数。

本章节指导如何审批工单。 1. 登录云堡垒机系统。 2. 在左侧导航栏单击“工单管理 > 工单审批”，进入工单审批页面。 3. 查找需要待审批的工单，单击“操作”列的“审批”按钮。 4. 在弹出的“工单审批”对话框中，查看待审批的工单内容，选择是否批准。 其他操作 批准：审批人批准后，流转到达下一节点；admin批准后，跳过其他节点（如有），直接最终变为“已批准”。 驳回：“待审批”和“审批中”的工单可以驳回；流程中的任一审批人驳回，则流程驳回到申请人，支持重新编辑和提交。 取消授权：任一审批人单击“取消授权”，则授权取消；admin可以对所有工单取消授权。

名称 描述 是否必须 CacheControl 可以用来指定请求或响应中的缓存操作。 类型：字符串。 否 ContentDisposition 指定文件的描述性信息。 类型：字符串。 否 ContentEncoding 指定文件的描述性信息采用何种编码方式以及在获取被ContentType头字段引用的mediatype时采用何种解码方式。 类型：字符串。 否 ContentType 用来描述文件数据格式的标准MIME类型。 类型：字符串。 取值：MIME类型，默认值为application/octetstream。 否 Expires 文件不再被缓存的时间。GMT时间格式。 类型：字符串。 否 xamzmeta 任何以xamzmeta为前缀的头都被当作用户元数据，它和文件一起存储，当用户获取该文件的时候作为响应的一部分被返回。 类型：字符串。 否 xamzstorageclass 文件的存储类型，针对那些在成功完成分片上传后被创建的文件。 类型：字符串。 取值： STANDARD：标准存储。 STANDARDIA：低频访问存储。 默认值为STANDARD。 否 xctyundatalocation 文件的数据位置。 注意 香港节点不支持此参数。 类型：keyvalue形式 取值： 格式为：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自动调度数据存储位置。

请求示例3 修改数据位置为就近 。 plaintext PUT / HTTP/1.1 Host: docs.ooscn.ctyunapi.cn Date: Sun, 29 Sep 2019 07:16:11 GMT ContentType: application/xml;charsetutf8 ContentLength: 170 Authorization: SignatureValue Local 响应示例3 plaintext HTTP/1.1 200 OK Location: /docs Date: Sun, 29 Sep 2019 07:16:32 GMT xamzrequestid: c08665066c4e4b4186f9ecfbf0fdff05c4c6cdbabcbec0c2c4 ContentLength: 0 Server: CTYUN

本节主要介绍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。 scheduleStrategy：调度策略，取值为： Allowed：允许OOS自动调度数据存储位置。 NotAllowed：不允许OOS自动调度数据存储位置。 否 xamzmetaparamater 用户自定义的元数据，用户可以根据需要，自定义一些元数据的参数。 类型：字符串。 否

请求示例 按天（byDay）查询所有存储桶、所有地域20201117所有存储类型的收费容量。 plaintext GET/?ActionGetBilledStorageUsage&BeginDate20201117&EndDate20201117&FreqbyDay HTTP/1.1 Date: Wed, 18 Nov 2020 06:38:27 GMT Authorization: SignatureValue Host: ooscnmg.ctyunapi.cn 响应示例 plaintext HTTP/1.1 200 OK xamzrequestid: 236A8905248E5A01 Date: Wed, 18Nov 2020 06:39:27 GMT ContentLength:120 Server: CTYUN test@ctyun.cn root ALL UTC +0800 byDay 20201117 40048 30046 20029 10017 10002 0 0 0

名称 描述 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 父节点为LocationList，表示数据位置，有效值为：ChengDu、GuiYang、LanZhou、QingDao、SH2、ShenYang、ShenZhen、SuZhou、WuHan、WuHu、WuLuMuQi、ZhengZhou 父节点：MetadataLocationConstraint或LocationList。 ScheduleStrategy 指定数据时的调度策略 类型：枚举 取值： Allowed：允许OOS自动调度。 NotAllowed：不允许OOS自动调度。 父节点：DataLocationConstraint

地区 OOS API Endpoint 内蒙古1 oosnm1.ctyunapi.cn 杭州1 ooshz1.ctyunapi.cn

响应结果 名称 描述 Account 发出请求的账户名。 UserName 发出请求的用户名。如果根用户发送的该请求，则UserName为root。 TimeZone 返回数据的时区，统一为UTC +0800。 InternetType 并发连接数网络类型互联网/非互联网: all：互联网并发连接数和非互联网并发连接数。 internet：互联网的并发连接数。 noninternet：非互联网的并发连接数。 Freq 返回数据的频率，by5min：每5分钟统计一次。 BucketName Bucket名字。如果用户在请求中没有携带Bucket参数，BucketName为空。 RegionName 数据位置，如果用户在请求中没有携带Region参数，RegionName为空。 Statistics.Date 返回结果对应的时间。 Statistics.Data.InternetConnection 互联网的并发连接数。 Statistics.Data.NonInternetConnection 非互联网的并发连接数。 请求示例 按5分钟（by5min）查询Bucket为examplebucket、数据位置为 ZhengZhou、20191015至20191016的并发量。 plaintext GET /?ActionGetConcurrentConnection&BeginDate20191016&EndDate20191016&Bucketexamplebucket&Freqby5min&RegionZhengZhou HTTP/1.1 Date: Wed, 16 Oct 2019 07:11:39 GMT Authorization: SignatureValue Host: ooscnmg.ctyunapi.cn 响应示例 plaintext HTTP/1.1 200 OK Date: Wed, 16 Oct 2019 07:11:39 GMT xamzrequestid: 43f5cbc9bef047d3 ContentLength: 24493 Server: CTYUN test@ctyun.cn usertest1 UTC +0800 all by5min examplebucket ZhengZhou 20191016 00:00 0 0 ...

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

请求示例 按天（byDay）查询Bucket为examplebucket、数据位置为 ZhengZhou 、20191015至20191016标准存储数据的返回码次数。 plaintext GET /?ActionGetReturnCode&BeginDate20191015&EndDate20191016&StorageClassSTANDARD&Bucketexamplebucket&FreqbyDay&RegionZhengZhou&RequestsTypeget%2Bput&ResponseTypeResponse200 HTTP/1.1 Date: Wed, 16 Oct 2019 07:03:54 GMT Authorization: SignatureValue Host: ooscnmg.ctyunapi.cn 响应示例 plaintext HTTP/1.1 200 OK Date: Wed, 16 Oct 2019 07:03:54 GMT xamzrequestid: a79028c963e4d3a ContentLength: 1114 ContentType: application/xml; charsetutf8 Server: CTYUN test@ctyun.cn usertest1 STANDARD UTC +0800 all get+put Response200 byDay examplebucket ZhengZhou 20191015 1 11 61 71 ...

响应结果 名称 描述 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.DeleteCapacity 删除标准存储数据的容量。 Statistics.Standardia.DeleteCapacity 删除低频访问存储数据的容量。 请求示例 按天（byDay）查询Bucket名为examplebucket、数据位置为ZhengZhou、20191015至20191016标准存储数据的删除容量。 plaintext GET /?ActionGetDeleteCapacity&BeginDate20191015&EndDate20191016&Bucketexamplebucket&FreqbyDay&RegionZhengZhou HTTP/1.1 Date: Wed, 16 Oct 2019 06:38:27 GMT Authorization: SignatureValue Host: ooscnmg.ctyunapi.cn 响应示例 plaintext HTTP/1.1 200 OK Date: Wed, 16 Oct 2019 06:38:28 GMT xamzrequestid: da66aa927f744dc1 ContentLength: 440 ContentType: application/xml; charsetutf8 Server: CTYUN test@ctyun usertest1 STANDARD UTC +0800 byDay examplebucket ZhengZhou 20191015 1641600 20191016 1641600

名称 描述 是否必须 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。 否

本节主要介绍GetTraffics。 此操作用来查询用户的流量。 请求参数 名称 描述 是否必须 Action GetTraffics。 是 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。 否 InOutType 指定返回的流量类型上行/下行。 类型：字符串 取值： all：指定返回上行流量和下行流量。 inbound：指定返回上行流量。 outbound：指定返回所下行流量。 默认值为all。 否 InternetType 指定返回的流量类型互联网/非互联网。 类型：字符串 取值： all：指定返回互联网流量和非互联网流量。 internet：指定返回互联网流量。 noninternet：指定返回非互联网流量。 默认值为all。 否 TrafficsType 指定返回的流量类型直接/漫游。 类型：字符串 取值： all：指定返回直接流量和漫游流量。 direct：指定返回直接流量。 roam：指定返回漫游流量。 默认值为all。 否 NetType 指定返回的网络类型精品网（CN2）/普通网（163）。仅香港节点支持本参数。 类型：字符串 取值： all：指定返回精品网和普通网的流量。 highqualitynet：指定返回精品网的流量。 normalqualitynet：指定返回普通网的流量。 默认值为all。 否 Freq 指定返回统计数据的采样粒度。 类型：Enum 取值： by5min：统计数据的采样粒度为5分钟。 byHour：统计数据的采样粒度为1小时。 byDay：统计数据的采样粒度为1天。 默认值为byHour。 否

响应结果 名称 描述 Account 发出请求的账户名。 UserName 发出请求的用户名。如果根用户发送的该请求，则UserName为root。 StorageClass 存储类型： ALL：所有存储类型。 STANDARADIA：低频访问类型。 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.Standardia.RestoreCapacity 低频访问存储取回量，单位是Byte。 请求示例 按天（byDay）查询所有存储桶、所有地域20201117所有存储类型的数据取回量。 plaintext GET/?Action GetRestoreCapacity&BeginDate20201117&EndDate20201117&StorageClassALL&FreqbyDay HTTP/1.1 Date: Wed, 18 Nov 2020 07:38:27 GMT Authorization: SignatureValue Host: ooscnmg.ctyunapi.cn 响应示例 plaintext HTTP/1.1 200 OK xamzrequestid: 236A8905248E5A01 Date: Wed, 18Nov 2020 07:39:02 GMT ContentLength:120 Server: CTYUN example@ctyun.cn user1 ALL utc+8:00 byDay 20201117 731920486

名称 描述 是否必须 Action GetCapacity。 是 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天。 是 Bucket 指定查询容量的Bucket名称，如果不指定Bucket名称，则表示查询账户下所有Bucket的容量之和。 类型：字符串 取值：3~63个字符，只能由小写字母、数字、短横线（）和点（.）组成。 否 StorageClass 指定查询的存储类型。 类型：Enum 取值： ALL：所有存储类型。 STANDARD：标准存储。 STANDARDIA：低频访问存储。 默认值为STANDARD。 否 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。 否

变量 描述 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。 xctyundatalocation 文件的数据位置。 注意 香港节点不会返回此项。 类型：枚举。 取值： 对于对象存储网络，取值为：ChengDu、GuiYang、LanZhou、QingDao、SH2、ShenYang、ShenZhen、SuZhou、WuHan、WuHu、WuLuMuQi、ZhengZhou。 对于对象存储网络2，取值为：NeiMeng1、HangZhou1。 xamzmeta 以该前缀开头的用户定义的元数据响应头。每一个都作为一组键值对存储和返回。OOS不验证或解释用户定义的元数据。 类型：字符串。 xctyunlastaccesstime Object的最后一次访问时间。 如果为Object开启了匹配最后一次访问时间的生命周期规则，会返回该响应头，否则不返回该响应头。 注意 对于一天内多次访问同一个Object（GET操作），仅记录该Object的该天最早一次访问时间。

新旧域名的变更 原独立资源池域名会保留，用户可以继续使用。 改造后建议您切换到对象存储网络2的域名进行使用，详情参考域名（Endpoint）列表。 其他 说明 建议您及时关注天翼云官网客户公告，在部分独立池改造升级的相关时间点做好业务调整，如更换最新的SDK和域名、构造更安全的V4签名、适配新增的功能。 改造资源池名称 改造后资源池名称 改造完成时间点 旧域名信息 杭州资源池 对象存储网络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：

名称示例 说明 demodevkey 演示环境使用 projectatestkey 项目 A 测试环境使用 financebatchprodkey 财务批处理生产任务使用

接口 说明 createdirectory 创建目录 readfile 读取文本文件内容，支持按偏移量和长度读取 writefile 写入文本文件内容，支持覆盖、追加和新建 movefile 移动或重命名文件、目录 searchfiles 搜索文件

本文介绍AIuse云电脑的产品特点 AIuse云电脑致力为AI构建任务执行平台，它依托天翼AI云电脑的强大算例，通过意图识别，模拟用户操作，自动完成任务的规划、决策与实施，助力AI的商业化落地。 多场景覆盖 搭建可定制云端桌面环境，依托标准化接口实现传统桌面软件自动化调用与批量操作，适配政企办公，研发测试等多场景使用。 灵活接入 提供标准化工具链与弹性运行环境、支持WebSdk、MCP等主流接入方式，无缝对接各种AI agent，兼容轻量调用与专业部署方式。 高效运行 依托天翼云强大算力底座，实现算力弹性伸缩与并发场景高效运行，保障桌面操作、软件运行及数据处理的流畅性与可靠性。 安全防护 采用企业级沙箱防护方案，构建多层次安全体系，用过严格权限隔离防范各类安全风险，保障企业核心业务数据安全合规。

52060 指定桌面不属于当前用户如何处理？ 请确认 AccessKey 是否关联了目标云电脑，并检查当前租户下是否拥有该云电脑资源。

浏览器场景说明 当前版本可通过 Computer Use 操作云电脑中的浏览器，例如点击页面、输入文本、滚动页面和截屏观察。 需要注意的是，当前文档不将其描述为独立的 Browser Use 能力。若后续提供浏览器专用 API、标签页管理、网络请求观测、DOM 级操作等能力，可再独立建设 Browser Use 文档。 调用方式 Computer Use 能力可通过以下方式接入： SDK：适合业务系统主动编排任务流程。 MCP：适合 MCP Client、Agent 宿主或 IDE 插件以工具方式调用。 操作坐标说明 鼠标相关接口通常使用桌面屏幕坐标。坐标原点一般位于屏幕左上角，X 轴向右递增，Y 轴向下递增。 在实际自动化流程中，建议先截图确认窗口位置和分辨率，再执行坐标点击或拖拽操作。对于分辨率、窗口布局可能变化的任务，应尽量通过截图识别、固定窗口布局或前置校验降低误操作风险。 使用建议 在执行点击前，建议先通过截图确认目标界面处于预期状态。 对页面加载、软件启动、弹窗出现等耗时操作，应加入等待和状态检查。 对重要操作，如提交、删除、付款等，应增加二次确认逻辑。 对需要批量执行的任务，应记录每一步操作结果，便于后续审计和问题排查。 能力边界 Computer Use 主要面向 GUI 自动化，不等同于业务系统 API。对于可通过接口直接完成的任务，优先使用业务接口通常更稳定、更可审计。对于界面变化频繁、坐标不稳定或存在复杂验证码的场景，需要结合业务策略评估可行性。

工具名 说明 createdirectory 创建目录 readfile 读取文本文件 writefile 写入文本文件 movefile 移动或重命名文件、目录 searchfiles 搜索文件

本文汇总 AIuse 云电脑 MCP Server 当前版本开放的工具、参数风格和返回结构。 协议能力 当前 MCP Server 基于 MCP STDIO 通信，主要面向以下 MCP 能力： initialize notifications/initialized ping tools/list tools/call 通用参数 所有 AIuse 云电脑 MCP 工具都需要明确目标桌面编码。当前版本通过工具参数传入 desktopCode： plaintext { "desktopCode": "xxx" } 在 Qoder 等支持自然语言工具调用的客户端中，也可以在指令中说明： plaintext 在 desktopCodexxx 桌面，截取当前屏幕。 Computer Use 工具 工具名 用途 movemouse 移动鼠标到指定坐标 clickmouse 在指定坐标点击鼠标 dragmouse 从起点拖拽到终点 scroll 在指定位置滚动 presskey 按下键盘按键或组合键 typetext 输入文本 screenshot 截取当前桌面屏幕 getcursorposition 获取当前鼠标位置 FileSystem 工具 工具名 用途 createdirectory 创建目录 readfile 读取文本文件内容 writefile 写入文本文件内容 movefile 移动或重命名文件、目录 searchfiles 搜索文件 返回结构 当前 MCP Server 将工具调用结果以文本内容返回，结构如下： plaintext { "content": [ { "type": "text", "text": "The operation(movemouse) was successfully executed on the desktop code xxx,the result is ..." } ] } 如果业务调用失败，返回文本中会包含失败信息： plaintext { "content": [ { "type": "text", "text": "The operation(clickmouse) failed on the desktop code xxx,the error message is desktop is offline" } ] } 当前版本未承诺返回 structuredContent 或 isError 字段。调用方应以 MCP Client 展示的工具调用结果为准。

能力 说明 读取文件 支持按路径读取文件内容，可按偏移量和长度读取片段 写入文件 支持覆盖写入、追加写入和新建写入模式 创建目录 支持创建目录，并可自动补齐父目录 移动文件 支持文件或目录移动，也可用于重命名 搜索文件 支持按通配符、正则或精确文件名搜索 获取文件信息 支持获取文件大小、类型、路径等元数据 下载文件 大文件或二进制文件可通过临时地址传输，具体能力以发布版本为准

参数 示例 AccessKey ID youraccesskeyid AccessKey Secret youraccesskeysecret desktopCode xxx 服务地址

项目 要求 Node.js 建议 Node.js 18 或以上 LTS 版本 npx 本地可执行 npx v MCP Client 支持本地 STDIO MCP Server AccessKey 已获取 AccessKey ID 和 AccessKey Secret 云电脑 已获取目标云电脑的 desktopCode ，且云电脑在线

getcursorposition 获取当前鼠标位置。 plaintext { "name": "getcursorposition", "arguments": { "desktopCode": "xxx" } } 使用建议 坐标操作依赖当前屏幕分辨率和窗口位置，建议先使用 screenshot 观察界面。 对关键操作建议截图确认后再继续下一步。 不建议在未确认界面状态的情况下连续执行大量固定坐标点击。 调用时必须明确目标 desktopCode。