Volcengine TOS 对象存储

---

name: volcengine-storage-tos

description: Object storage operations for Volcengine TOS (Tinder Object Storage). Use when users need bucket management, object upload/download, listing, deletion, presigned URLs, or storage troubleshooting.

---

Category: provider

# Volcengine TOS 对象存储

Validation

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

Prerequisites

- `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

Quick start

# 列举所有桶
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 --file ./report.pdf

# 下载文件
python skills/storage/tos/volcengine-storage-tos/scripts/tos_manage.py download \
  --bucket my-bucket --key data/report.pdf --file ./downloaded.pdf

# 获取元数据
python skills/storage/tos/volcengine-storage-tos/scripts/tos_manage.py head \
  --bucket my-bucket --key data/report.pdf

# 生成预签名 URL（1 小时有效）
python skills/storage/tos/volcengine-storage-tos/scripts/tos_manage.py presign \
  --bucket my-bucket --key data/report.pdf --expires 3600

# 删除对象（需显式确认 --confirm）
python skills/storage/tos/volcengine-storage-tos/scripts/tos_manage.py delete \
  --bucket my-bucket --key data/report.pdf --confirm

Safety Rules

Operational guidance

Output location

Workflow

1) Confirm user intent, bucket, region, and whether the operation is read-only or mutating.

2) Run one minimal read-only query (list-buckets / head) to verify connectivity and permissions.

3) Execute the target operation with explicit parameters and bounded scope.

4) Verify results and save output/evidence files.

References