| name | aliyun-oss-ossutil-test |
| description | Minimal OSSUTIL 2.0 smoke tests. Validate config, list bucket, and upload/download with OSS. |
| version | 1.0.0 |
Category: test
OSSUTIL 2.0 Minimal Viable Test
Goals
- 验证 AK/Region 配置正确。
- 验证 OSS 访问(列桶、上传、下载)。
Prerequisites
- 已配置 AK(推荐环境变量或
~/.alibabacloud/credentials)。
- 已准备一个可读写的 OSS Bucket。
Test Steps (Minimal)
- 查看配置
ossutil config get region
- 列出 Bucket
ossutil ls
- 选择一个 bucket,按该 bucket 地域列对象(显式 region + endpoint)
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
Expected Results
ossutil ls 能返回至少一个 bucket 或无权限说明。
- 指定
--region + -e 后,列对象可正常返回。
- 上传/下载成功,文件内容一致。
常见失败
- Region 不匹配:确认
ALIBABACLOUD_REGION_ID 或配置文件中的 region。
- AK 无权限:确认 RAM 策略允许
oss:* 或最小读写权限。