volcengine-storage-tos

Category: provider

# Volcengine TOS 对象存储

## Validation

```bash
mkdir -p output/volcengine-storage-tos
python -m py_compile skills/storage/tos/volcengine-storage-tos/scripts/tos_manage.py && echo "py_compile_ok" > output/volcengine-storage-tos/validate.txt
```

Pass criteria: command exits 0 and `output/volcengine-storage-tos/validate.txt` is generated.

## Output And Evidence

- Save operation results, manifests, and logs to `output/volcengine-storage-tos/`.
- Keep one validation log per execution.

## Prerequisites

- Python 3.8+
- Install TOS SDK: `pip install tos`
- Set environment variables:
  - `VOLCENGINE_ACCESS_KEY` — AK（AccessKey ID）
  - `VOLCENGINE_SECRET_KEY` — SK（SecretKey）
  - `VOLCENGINE_TOS_ENDPOINT` — TOS 服务端点，如 `tos-cn-beijing.volces.com`
  - `VOLCENGINE_TOS_REGION` — 地域，如 `cn-beijing`

Optional: use `.env` in repo root; script will auto-load.

## Normalized interface

### Subcommands

| Subcommand | Description |
|------------|-------------|
| `list-buckets` | 列举所有桶 |
| `create-bucket` | 创建桶 |
| `delete-bucket` | 删除桶（需为空桶） |
| `list-objects` | 列举桶内对象（支持 prefix/max-keys） |
| `upload` | 上传本地文件到桶 |
| `download` | 下载对象到本地文件 |
| `delete` | 删除对象 |
| `head` | 获取对象元数据（大小、类型、ETag） |
| `presign` | 生成预签名 URL |
| `copy` | 复制对象 |

### Common flags
- `--bucket` — 桶名
- `--key` — 对象键
- `--file` — 本地文件路径（上传/下载用）
- `--prefix` — 列举前缀
- `--max-keys` — 列举数量上限，默认 100
- `--expires` — 预签名有效期（秒），默认 3600
- `--print-json` — 输出 JSON 格式

## Quick start

```bash
# 列举所有桶
python skills/storage/tos/volcengine-storage-tos/scripts/tos_manage.py list-buckets

# 列举桶内对象
python skills/storage/tos/volcengine-storage-tos/scripts/tos_manage.py list-objects \
  --bucket my-bucket --prefix images/ --max-keys 50

# 上传文件
python skills/storage/tos/volcengine-storage-tos/scripts/tos_manage.py upload \
  --bucket my-bucket --key data/report.pdf...