高阶命令用于文件传输、对象与桶的日常管理，语义贴近人类操作习惯，可直接用于脚本化自动化。本章节介绍如何使用高阶命令组。

命令概览

命令类别	作用
cp	上传、复制或下载本地文件、ADrive 文件或文件夹。
mv	移动文件或文件夹，本质为复制后删除源对象。
sync	执行增量同步。
crt	创建实例或空间。
del	删除实例或空间。
rm	删除文件或文件夹。
ls	列举实例、空间、文件或文件夹。
stat	查看实例、空间、文件或文件夹元数据。
du	统计文件夹大小。
find	按名称、大小或时间查找对象。
cat	流式读取文件内容。
put	将 stdin 内容上传为文件。
mkdir	创建文件夹。

高阶命令

cp （复制/上传/下载）

常用参数如下所示：

参数	说明
--by-name	当 instance/space 使用名称时，按名称解析为 ID。
--recursive	递归复制目录内容。
--include-parent	在目标路径下保留源目录名。
--include / --exclude	按匹配规则筛选传输对象。
--checkpoint / --checkpoint-dir / --checkpoint-threshold <20MB>	启用断点续传并指定检查点行为。
--batch-concurrency / --list-concurrency / --multipart-concurrency	控制批量处理、列表枚举和分片传输并发度。
--bandwidth-limit <100MB>	限制传输带宽。
--overwrite-strategy <force\|no-clobber\|newer> / --no-clobber	控制目标已存在时的覆盖策略。
--report-path / --report-failures-only	输出传输报告，或仅记录失败项。
--manifest-path / --no-manifest	控制 manifest 文件输出。
--progress / --no-progress / --progress-granularity <part\|byte>	控制进度显示方式。

代码示例如下所示：

crt （创建实例 / 空间）

常用参数如下所示：

参数	说明
--instance	指定实例。
--space	指定空间。
--display-name	设置显示名称。
--description	设置描述信息。
--index-enabled	创建空间时启用搜索索引。
--by-name	按名称解析实例或空间。

代码示例如下所示：

del （删除实例 / 空间）

代码示例如下所示：

sync（增量同步）

常用参数如下所示：

参数	说明
--force	执行需要确认的操作。
--confirm	显式确认目标路径。
--delete	同步时删除目标端中不存在于源端的对象。
--include	仅同步匹配的对象。
--size-only	仅按 size 比较对象差异。
--exact-timestamps	按精确时间戳比较对象差异。

sync 默认使用 size + mtime 比较策略，比较文件大小与最后修改时间。

代码示例如下所示：

mv（移动对象）

代码示例如下所示：

rm （删除对象）

该命令为危险操作，建议先核对目标路径、筛选条件和删除模式。

当前高阶实现未提供服务端 ListMultipartUploads 包装，因此 --include-uploads 仅扫描本 CLI checkpoint 流创建的上传任务，包括默认 checkpoint 目录、profile checkpoint 目录和 --checkpoint-dir 指定目录；其他方式创建的上传不会被扫描。

常用参数如下所示：

参数	说明
--recursive	递归删除目录内容。
--recursive-delete-mode <bottom-up\|direct>	指定递归删除模式，默认值为 bottom-up。取值如下： direct：直接删除模式。 bottom-up：从下至上删除模式。
--include-uploads	中止本地 ADrive checkpoint 流中与目标匹配的未完成分片上传。
--checkpoint-dir	指定扫描 checkpoint 的目录。
--include / --exclude	在 bottom-up 递归删除模式下筛选对象。
--force / --confirm	用于危险操作确认。

代码示例如下所示：

ls （列举）

常用参数如下所示：

参数	说明
--marker	分页。
--columns	选列。

代码示例如下所示：

stat （元数据）

代码示例如下所示：

du （前缀大小统计）

常用参数如下所示：

参数	说明
--top-k	返回结果，默认值为 10。
--cost	显示费用估算。
--storage-price CLASS=PRICE	指定存储类型对应的单价。

代码示例如下所示：

find （内容读取）

代码示例如下所示：

cat（流式读取）

代码示例如下所示：

put （输入上传）

常用参数如下所示：

参数	说明
--multipart-threshold <20MB>	用于控制分片阈值。
stdin EOF	结束输入时，Unix 使用 Ctrl+D，Windows 使用 Ctrl+Z 后回车。

代码示例如下所示：

mkdir（创建目录）

代码示例如下所示：

智能网盘服务