Docs

Torch Object Storage

TOS command-line tool

Low-level APIs

Low-level APIs or commands map one-to-one with TOS server-side APIs. Designed for fine-grained control and advanced feature invocation, they cover atomic operations such as bucket management, object operations, multipart uploads, and transfer acceleration. This topic explains how to use the low-level APIs.

Overview

Command	Description	Example link
Core commands	Basic commands for creating and managing buckets and objects.	Core commands
Bucket configuration commands	Commands for bucket configuration. Each command group typically supports the sub-actions of get, put, and delete.	Bucket configuration commands
Advanced feature commands	Commands for TOS's extended features such as image styles and content moderation.	Advanced feature commands

Core commands

Command group	Sub-command
bucket	create/head/delete/list/stat/info/location
object	upload/download/form-upload/copy/delete/batch-delete/list/list-versions/head/stat/set-meta/set-time/set-expires/append/seal-append/modify/rename/restore/status/get-acl/set-acl/get-tagging/set-tagging/delete-tagging/link/get-symlink/create-symlink/get-fetch-task/create-fetch-task/fetch/set-retention/get-retention
multipart	create/upload/complete/abort/copy/list-parts/list
turbo	open/append/list/close

Bucket configuration commands

Bucket configuration command groups manage various TOS bucket settings. Each command group typically supports the sub-actions of get, put, and delete. Use the --describe option to view the available sub-actions.

Supported command groups:

quota, policy, lifecycle, storageclass (formerly storgeclass), cors, versioning, replication, encryption, custom-domain, notification, website, mirror, inventory, tagging, acl, rename, real-time-log, access-monitor, worm, trash, payment, logging, intelligent-tiering, transfer-acceleration, cdn-notification, https-config, pay-by-traffic, max-age, and redundancy-transition.

To view available sub‑actions for a specific command group:

ve-tos-cli lifecycle --describe --output json
ve-tos-cli versioning --describe --output json
ve-tos-cli cors --describe --output json

Advanced feature commands

The advanced feature commands manage the extended features of TOS. Supported command groups:

data-process (image styles, workflows, and content moderation), object-set, accelerator, mrap (multi-region access points), ap (access points), cap (converged access points), dataset (intelligent retrieval and datasets), and control (control plane operations).

tip

Recommended usage:

Run ve-tos-cli <group> --describe --output json to view the command contract.

Preview the operation with <group> <action> --dry-run. After confirming, execute the actual command.

Last updated: 2026.07.17 14:33:20