aliyun-oss-ossutil-test

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)

1. 查看配置

ossutil config get region

2. 列出 Bucket

ossutil ls

3. 选择一个 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

4. 上传小文件

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

5. 下载并校验

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:* 或最小读写权限。