用途:本技能基于 ossutil 2.0 官方概览,帮助在命令行中安装、配置和操作阿里云 OSS,覆盖上传、下载、同步及资源管理等操作,并提供统一的安装、配置、凭证与地域/接入点处理流程。
主要能力:可用高层命令与 API 级命令操作 OSS,例如 ossutil config、ossutil api put-bucket-acl;常见操作包括列举存储桶与对象、上传、下载、目录同步等。
使用方式:先安装 ossutil 2.0(平台相关步骤见 references/install.md),再配置凭证与默认地域。交互式配置可运行 ossutil config;配置文件在 Linux/macOS 为 ~/.ossutilconfig,Windows 为 C:\Users\issuser.ossutilconfig。配置项包括 AccessKey ID、AccessKey Secret、Region(示例默认 cn-hangzhou)与 Endpoint(省略时由地域推导)。推荐用环境变量提供凭证:export ALICLOUD_ACCESS_KEY_ID="<your-ak>"、export ALICLOUD_ACCESS_KEY_SECRET="<your-sk>"、export ALICLOUD_REGION_ID="cn-beijing";也可使用共享凭证文件 ~/.alibabacloud/credentials。常用命令示例:ossutil ls;ossutil ls oss://your-bucket -r --short-format --region cn-shanghai -e https://oss-cn-shanghai.aliyuncs.com;ossutil cp ./local.txt oss://your-bucket/path/local.txt;ossutil cp oss://your-bucket/path/remote.txt ./remote.txt;ossutil sync ./local-dir oss://your-bucket/path/ --delete。建议先列出存储桶,从输出取得目标存储桶地域并转换为 --region 格式,列举对象时显式设置 --region 与 -e;大存储桶可先用 --limited-num 限制输出。
适用场景:需要在命令行批量管理 OSS 数据、执行上传下载与同步,或从同地域 ECS 访问 OSS 时使用。
限制与注意:凭证应使用最小权限的 RAM 用户或角色,避免在命令行明文传递 AK;配置文件或环境变量更适合生产环境。缺少地域配置会报 region must be set in sign version 4;接入点与存储桶地域不一致会报 endpoint 相关错误;签名地域不匹配会报 Invalid signing region。--region 与 -e 必须与存储桶地域一致。若地域不明确,应先向用户确认再执行写操作。验证方式可运行 python skills/storage/oss/alicloud-storage-oss-ossutil/scripts/check_ossutil.py --output output/alicloud-storage-oss-ossutil/validate.txt,通过标准为退出码 0 且生成该文件,命令行输出、对象列表与同步日志保存在 output/alicloud-storage-oss-ossutil/ 下并保留至少一条上传或列表结果作为证据。官方参考:https://help.aliyun.com/zh/oss/developer-reference/ossutil-overview