高阶命令用于文件传输、对象与桶的日常管理，语义贴近人类操作习惯，可直接用于脚本化自动化。本章节介绍如何使用高阶命令组。 ## 命令概览 |命令类别 |作用 |示例链接 | |---|---|---| |`cp` |复制本地文件 / TOS 对象 / 前缀 |[cp（复制/上传/下载）](https://www.volcengine.com/docs/6349/2563183#ce6fb06d) | |`mv` |移动（复制 + 删源） |[mv（移动）](https://www.volcengine.com/docs/6349/2563183#8fed96d0) | |`sync` |增量同步 |[sync（增量同步）](https://www.volcengine.com/docs/6349/2563183#922c68ec) | |`mb` |创建桶 |[mb （创建桶）](https://www.volcengine.com/docs/6349/2563183#567b815f) | |`rb` |删除桶 |[rb（删除桶）](https://www.volcengine.com/docs/6349/2563183#0d4376be) | |`rm` |删除对象 / 前缀 |[rm（删除对象）](https://www.volcengine.com/docs/6349/2563183#3ab8bcfd) | |`ls` |列举桶或对象 |[ls （列举桶）](https://www.volcengine.com/docs/6349/2563183#70bea5f2) | |`stat` |桶 / 对象元数据 |[stat （桶元数据）](https://www.volcengine.com/docs/6349/2563183#421be46e) | |`du` |前缀大小统计 |[du （前缀大小统计）](https://www.volcengine.com/docs/6349/2563183#b37cac32) | |`find` |按名称 / 大小 / 时间 / 存储类型查找 |[ find（存储类型查找）](https://www.volcengine.com/docs/6349/2563183#6b37e2a2) | |`cat` |流式读取 |[cat（流式读取）](https://www.volcengine.com/docs/6349/2563183#5699a836) | |`put` |stdin 上传 |[put（上传）](https://www.volcengine.com/docs/6349/2563183#2974caf0) | |`presign` |预签名 URL |[presign（预签名 UR）](https://www.volcengine.com/docs/6349/2563183#4a79c9a7) | |`restore` |归档对象恢复 |[restore （归档恢复）](https://www.volcengine.com/docs/6349/2563183#53daa377) | ## 高阶命令 ### cp（复制/上传/下载）常用参数如下所示： |参数 |说明 | |---|---| |\-\-storage\-class |指定上传或复制时的存储类型。 | |\-\-acl |设置目标对象的访问控制权限（ACL）。 | |\-\-recursive / \-\-include\-parent / \-\-include / \-\-exclude |控制递归范围及文件筛选规则。 | |\-\-checkpoint / \-\-checkpoint\-dir / \-\-checkpoint\-threshold <20MB\> |启用断点续传并配置检查点目录与触发阈值。 | |\-\-batch\-concurrency（默认 16）/ \-\-list\-concurrency（默认 4）/ \-\-multipart\-concurrency |分别控制批量操作、列举及分片上传的并发数。 | |\-\-recursive\-list\-mode |设置递归列举模式。默认值为 `auto`。

即 FNS 桶使用扁平列举，HNS 桶使用层级列举；如需对 FNS 桶启用前缀级并发，可显式指定 `hierarchical`。 | |\-\-bandwidth\-limit <100MB\> |限制传输带宽上限。 | |\-\-overwrite\-strategy / \-\-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`）计算。 | |远端路径以 / 结尾。 |将被识别为目录标记。 | 代码示例如下所示： ```JSON 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 `、`--bucket-type `、`--bucket-object-lock-enabled`。代码示例如下所示： ```Bash 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（移动）代码示例如下所示： ```JSON ve-tos-cli mv tos://b/old.txt tos://b/new.txt --force --confirm tos://b/old.txt ``` ### sync（增量同步）代码示例如下所示： ```JSON ve-tos-cli sync ./local-dir/ tos://b/backup/ --delete --force --confirm tos://b/backup/ ``` ### rb（删除桶）代码示例如下所示： ```JSON ve-tos-cli rb tos://mybucket --force --confirm tos://mybucket ``` ### rm（删除对象）代码示例如下所示： ```Bash ve-tos-cli rm tos://b/prefix/ --recursive --all-versions --force --confirm tos://b/prefix/ ``` ### ls （列举桶）代码示例如下所示： ```Shell ve-tos-cli ls tos://b/prefix/ --max-keys 100 --human-readable --sort size --columns key,size,last_modified ``` ### stat （桶元数据）代码示例如下所示： ```Shell ve-tos-cli stat tos://b/file.txt --version-id v1 --output json ``` ### du （前缀大小统计）代码示例如下所示： ```Shell ve-tos-cli du tos://b/prefix/ --human-readable --max-depth 2 --cost --storage-price STANDARD=0.12 ``` ### find（存储类型查找）代码示例如下所示： ```Shell ve-tos-cli find tos://b/ --name "*.log" --size +100MB --mtime -7d --storage-class STANDARD ``` ### cat（流式读取）代码示例如下所示： ```Shell ve-tos-cli cat tos://b/file.txt --range bytes=0-1023 ``` ### put（上传）代码示例如下所示： ```Shell ve-tos-cli put tos://b/path/file.gz --content-type application/gzip --storage-class IA --no-clobber ``` ### presign（预签名 UR）代码示例如下所示： ```Shell ve-tos-cli presign tos://b/file.txt --expires 7200 --method PUT ``` ### restore （归档恢复）代码示例如下所示： ```Shell 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 ```

对象存储