用途
该技能是一套 OSSUTIL 2.0 的最小可用冒烟测试(Minimal Viable Test),用于在正式使用 OSSUTIL 前快速验证阿里云 OSS 的基础可用性。其目标包括:验证 AK/Region 配置正确,以及验证 OSS 访问能力(列桶、上传、下载)。
前置条件
- 已配置 AK(推荐使用环境变量或 ~/.alibabacloud/credentials)。
- 已准备一个可读写的 OSS Bucket。
主要能力与测试步骤
测试步骤为最小集合,依次执行以下操作:
- 查看配置:
ossutil config get region
- 列出 Bucket:
ossutil ls
- 选择一个 bucket,按该 bucket 地域列对象(显式指定 region + endpoint):
# 示例(按实际 bucket 地域替换)
ossutil ls oss://<bucket> -r --short-format --region cn-shanghai -e https://oss-cn-shanghai.aliyuncs.com --limited-num 20
- 上传小文件:
echo "ossutil-test" > /tmp/ossutil-test.txt
ossutil cp /tmp/ossutil-test.txt oss://<bucket>/tests/ossutil-test.txt --region cn-shanghai -e https://oss-cn-shanghai.aliyuncs.com
- 下载并校验:
ossutil cp oss://<bucket>/tests/ossutil-test.txt /tmp/ossutil-test-down.txt --region cn-shanghai -e https://oss-cn-shanghai.aliyuncs.com
cat /tmp/ossutil-test-down.txt
预期结果
- ossutil ls 能返回至少一个 bucket,或无权限说明。
- 指定 --region + -e 后,列对象可正常返回。
- 上传/下载成功,文件内容一致。
常见失败与排查
- Region 不匹配:确认 ALIBABACLOUD_REGION_ID 或配置文件中的 region。
- AK 无权限:确认 RAM 策略允许 oss:* 或最小读写权限。
适用场景
适用于需要快速确认 OSSUTIL 2.0 配置与 OSS 读写连通性的场景,例如新环境初始化、凭证更换后验证、地域与 endpoint 配置检查等。
限制
该技能为最小冒烟测试,仅覆盖配置查看、列桶、列对象、上传与下载校验;其他功能、收费、价格、平台支持范围等资料暂未提供。