对象存储
对象存储
对象存储
文档指南
请输入
产品动态
产品公告
产品计费
快速入门
用户指南
存储桶管理
基础设置
容错与容灾
ObjectSet
文件管理
监控与告警
权限配置
IAM 策略管理
典型配置场景
IAM 子用户授权
使用工具及 SDK 的授权说明
接入点
单区域接入点（SRAP）
内容感知与处理（SenseFlow）
TOS Agent
数据处理
分层命名空间（HNS）
TOS Vectors
API 参考
向量桶
SDK 参考
Python-Vectors
向量桶
向量索引
Java-Vectors
向量桶
向量索引
Node.js-Vectors
向量桶
向量索引
工具指南
tosutil
常用命令
辅助命令
TOS Browser
FSX
TOS PyTorch Connector
tosfsspec
API 参考
签名机制
存储桶
桶基础操作
自定义域名
数据处理
媒体处理
视频转码
音频转码
ObjectSet
生命周期
对象
基础操作
分片上传
SDK 参考
Java
存储桶接口
管理桶配置
ObjectSet
对象接口
下载对象
数据处理
视频处理
日志配置
分层命名空间
Python
数据处理
存储桶接口
对象接口
上传对象
C++
存储桶接口
对象接口
Go
对象接口
存储桶接口
管理桶配置
ObjectSet
数据处理
日志配置
Node.js
存储桶接口
对象接口
上传对象
数据处理
Browser.js
上传对象
.NET
对象接口
PHP
对象接口
异常处理
Android
对象接口
iOS
对象接口
Harmony
存储桶接口
对象接口
上传对象
Rust
存储桶接口
桶基础操作
桶清单
自定义域名
对象接口
基础操作
错误码
01-SERVICE_ERROR
02-AUTH
03-ACCESS_CONTROL
04-QOS
05-REQUEST
06-BUCKET
07-LIFECYCLE
08-ACL
09-CORS
10-POLICY
11-MIRROR
12-REPLICATION
13-WEBSITE
14-NOTIFICATION
15-ENCRYPT
16-CUSTOMDOMAIN
17-OBJECT
18-TAG
19-MULTIPART
20-STORAGE_CLASS
21-CALLBACK
22-DATA_PROCESS
23-BATCH
24-STORAGE_LENS
25-INVENTORY
26-DIRECTORY_BUCKET
32-WORM
常见问题
最佳实践
AIGC-豆包大模型最佳实践
校验数据一致性
- 文档首页
对象存储工具指南TOS 命令行工具高阶命令（High-Level API）
复制全文
下载 pdf高阶命令（High-Level API）
文档反馈
问问助手高阶命令用于文件传输、对象与桶的日常管理，语义贴近人类操作习惯，可直接用于脚本化自动化。本章节介绍如何使用高阶命令组。
命令概览
命令类别 | 作用 | 示例链接 |
命令类别 | 作用 | 示例链接 |
cp | 复制本地文件 / TOS 对象 / 前缀 | |
mv | 移动（复制 + 删源） | |
sync | 增量同步 | |
mb | 创建桶 | |
rb | 删除桶 | |
rm | 删除对象 / 前缀 | |
ls | 列举桶或对象 | |
stat | 桶 / 对象元数据 | |
du | 前缀大小统计 | |
find | 按名称 / 大小 / 时间 / 存储类型查找 | |
cat | 流式读取 | |
put | stdin 上传 | |
presign | 预签名 URL | |
restore | 归档对象恢复 |
高阶命令
cp（复制/上传/下载）
常用参数如下所示：
参数 | 说明 |
参数 | 说明 |
--storage-class <STANDARD|IA|ARCHIVE_FR|INTELLIGENT_TIERING|COLD_ARCHIVE|ARCHIVE|DEEP_COLD_ARCHIVE> | 指定上传或复制时的存储类型。 |
--acl <private|public-read|...> | 设置目标对象的访问控制权限（ACL）。 |
--recursive / --include-parent / --include / --exclude | 控制递归范围及文件筛选规则。 |
--checkpoint / --checkpoint-dir / --checkpoint-threshold <20MB> | 启用断点续传并配置检查点目录与触发阈值。 |
--batch-concurrency（默认 16）/ --list-concurrency（默认 4）/ --multipart-concurrency | 分别控制批量操作、列举及分片上传的并发数。 |
--recursive-list-mode <auto|flat|hierarchical> | 设置递归列举模式。默认值为 auto。 即 FNS 桶使用扁平列举，HNS 桶使用层级列举；如需对 FNS 桶启用前缀级并发，可显式指定 hierarchical。 |
--bandwidth-limit <100MB> | 限制传输带宽上限。 |
--overwrite-strategy <force|no-clobber|newer> / --no-clobber | 设置文件覆盖策略。 |
--content-type / --meta key=v#key2=v2 | 设置对象的 Content-Type 及自定义元数据。 |
--report-path / --report-failures-only / --manifest-path / --no-manifest | 配置操作日志的输出路径、过滤规则及清单文件。 |
--progress / --no-progress --progress-granularity <part|byte> | 启用或禁用传输进度显示，设置进度统计粒度。 可按分片（part）或按字节（byte）计算。 |
远端路径以 / 结尾。 | 将被识别为目录标记。 |
代码示例如下所示：
ve-tos-cli cp ./file.txt tos://mybucket/path/file.txt
ve-tos-cli cp tos://mybucket/path/ ./local_dir/ --recursive
ve-tos-cli cp ./dir/ tos://mybucket/prefix/ --recursive --include "*.log"
ve-tos-cli cp large.bin tos://mybucket/large.bin --checkpoint
ve-tos-cli cp ./a.txt tos://mybucket/a.txt --storage-class IA --acl public-read
mb（创建桶）
常用参数如下所示：
--region、--storage-class（默认 STANDARD）、--acl、--az-redundancy <single-az|multi-az>、--bucket-type <fns|hns>、--bucket-object-lock-enabled。
代码示例如下所示：
ve-tos-cli mb tos://new-bucket
ve-tos-cli mb tos://new-bucket --storage-class IA
ve-tos-cli mb tos://new-bucket --bucket-type hns
ve-tos-cli mb tos://new-bucket --region cn-beijing --acl private --az-redundancy multi-az --bucket-object-lock-enabled
mv（移动）
代码示例如下所示：
ve-tos-cli mv tos://b/old.txt tos://b/new.txt --force --confirm tos://b/old.txt
sync（增量同步）
代码示例如下所示：
ve-tos-cli sync ./local-dir/ tos://b/backup/ --delete --force --confirm tos://b/backup/
rb（删除桶）
代码示例如下所示：
ve-tos-cli rb tos://mybucket --force --confirm tos://mybucket
rm（删除对象 ）
代码示例如下所示：
ve-tos-cli rm tos://b/prefix/ --recursive --all-versions --force --confirm tos://b/prefix/
ls （列举桶）
代码示例如下所示：
ve-tos-cli ls tos://b/prefix/ --max-keys 100 --human-readable --sort size --columns key,size,last_modified
stat （桶元数据）
代码示例如下所示：
ve-tos-cli stat tos://b/file.txt --version-id v1 --output json
du （前缀大小统计）
代码示例如下所示：
ve-tos-cli du tos://b/prefix/ --human-readable --max-depth 2 --cost --storage-price STANDARD=0.12
find（ 存储类型查找）
代码示例如下所示：
ve-tos-cli find tos://b/ --name "*.log" --size +100MB --mtime -7d --storage-class STANDARD
cat（流式读取）
代码示例如下所示：
ve-tos-cli cat tos://b/file.txt --range bytes=0-1023
put（上传）
代码示例如下所示：
ve-tos-cli put tos://b/path/file.gz --content-type application/gzip --storage-class IA --no-clobber
presign（预签名 UR）
代码示例如下所示：
ve-tos-cli presign tos://b/file.txt --expires 7200 --method PUT
restore （归档恢复）
代码示例如下所示：
ve-tos-cli restore tos://b/archived.txt --days 7 --force
ve-tos-cli restore tos://b/prefix/ --recursive --tier Standard --force
ve-tos-cli restore tos://b/prefix/ --manifest list.txt --force
最近更新时间：2026.07.06 18:58:05
这个页面对您有帮助吗？
有用
有用
无用
无用