SuperAPI AI 工具集

alicloud-storage-oss-ossutil-test

测试与质量

查看项目

更新于 10-15 14:25

技能介绍

用途

该技能是一套 OSSUTIL 2.0 的最小可用冒烟测试(Minimal Viable Test),用于在正式使用 OSSUTIL 前快速验证阿里云 OSS 的基础可用性。其目标包括:验证 AK/Region 配置正确,以及验证 OSS 访问能力(列桶、上传、下载)。

前置条件

  • 已配置 AK(推荐使用环境变量或 ~/.alibabacloud/credentials)。
  • 已准备一个可读写的 OSS Bucket。

主要能力与测试步骤

测试步骤为最小集合,依次执行以下操作:

  1. 查看配置:
ossutil config get region
  1. 列出 Bucket:
ossutil ls
  1. 选择一个 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
  1. 上传小文件:
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
  1. 下载并校验:
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 配置检查等。

限制

该技能为最小冒烟测试,仅覆盖配置查看、列桶、列对象、上传与下载校验;其他功能、收费、价格、平台支持范围等资料暂未提供。