用途:将本地文件夹随时间发生的变化,按周期定时增量上传至阿里云 OSS。整体架构为本地文件夹 + aliyun CLI(集成 ossutil)+ cron 或 Windows 任务计划 + OSS Bucket。
主要能力:通过 aliyun CLI 完成安装与版本检查、凭证 profile 校验、命令发现、OSS 侧校验,并用集成的 aliyun ossutil 执行上传与列举;由操作系统本地的 cron 或 Windows 任务计划负责定时触发;RAM 策略挂载与可选的 OSS 控制台可视化校验需手动完成。
必要前置:Aliyun CLI 版本需 >= 3.3.3,可运行 aliyun version 验证,并执行 aliyun configure set --auto-plugin-install true。核心流程前须启用 AI 模式:aliyun configure ai-mode enable,并设置 user-agent;所有退出路径前须执行 aliyun configure ai-mode disable。每条 aliyun 命令都需带 --user-agent AlibabaCloud-Agent-Skills/alibabacloud-oss-manage-cron-upload。需已配置阿里云凭证 profile,仅可用 aliyun configure list 检查状态,禁止读取、回显或硬编码 AK/SK。
关键参数:RegionId、BucketName、TargetOssPrefix、LocalSourcePath、Schedule、MaxAge、OperatingSystem、BucketAlreadyExists 等,均需在代入 shell 前按规则校验,不合法值直接拒绝。增量上传命令形如 aliyun ossutil cp "${LocalSourcePath}" "oss://${BucketName}/${TargetOssPrefix}" -r -u --max-age "${MaxAge}" --region "${RegionId}",其中 -u 为增量依据,-f 仅用于无人值守运行。
适用场景:本地目录到 OSS 的周期备份与同步。限制:默认权限围绕 ListBuckets、GetBucketInfo、PutObject、GetObject、ListObjects,分片清理权限仅在用户明确要求时处理;跨区域时须用 --region 而非 --endpoint。