最近更新时间：2024.02.29 20:16:16
首次发布时间：2022.11.03 10:30:29
本文以 macOS 系统为例，介绍使用 tosutil 工具下载对象的常见示例命令。
示例存储桶名为 bucketname，桶内包含如下对象：
tos://bucketname/file1.txt tos://bucketname/file2.txt tos://bucketname/pic1.png tos://bucketname/pic2.png tos://bucketname/pic3.jpg tos://bucketname/pic4.jpg tos://bucketname/folder1/ tos://bucketname/folder1/file7.txt tos://bucketname/folder2/ tos://bucketname/folder2/file8.txt tos://bucketname/folder2/folder3/ tos://bucketname/folder2/folder3/file9.txt
基于示例存储桶内的对象说明，不同下载场景的示例命令如下。
下载 bucketname 桶中的 file1.txt 文件至本地 folder1 文件夹：
./tosutil cp tos://bucketname/file1.txt /folder1
下载完成后，本地生成的文件为：
└── folder1 └── file1.txt
下载 bucketname 桶中的 file1.txt 文件至本地 folder1 文件夹中：
说明
如果本地 folder1 文件夹中不存在 file1_renamed.txt 文件，则直接下载且下载后命名为 file1_renamed.txt；如果本地 folder1 文件夹中已存在 file1_renamed.txt 文件，则以 file1.txt 内容覆盖 file1_renamed.txt 进行下载。
./tosutil cp tos://bucketname/file1.txt /folder1/file1_renamed.txt
下载完成后，本地文件为：
└── folder1 └── file1_renamed.txt
下载 bucketname 桶中的 folder2 文件夹中的所有文件和文件夹（包括 folder2 文件夹本身）至本地 folder1 文件夹：
./tosutil cp tos://bucketname/folder2 /folder1 -r
下载完成后，本地生成的文件为：
└── folder1 └── folder2 ├── file8.txt └── folder3 └── file9.txt
下载 bucketname 桶中的 folder2 文件夹中的所有文件和文件夹（不包括 folder2 文件夹本身）至本地 folder2_renamed 文件夹：
./tosutil cp tos://bucketname/folder2 /folder2_renamed -r -flat
下载完成后，本地生成的文件为：
└── folder2_renamed ├── file8.txt └── folder3 └── file9.txt
下载 bucketname 桶中的所有文件至 folder0 文件夹：
./tosutil cp tos://bucketname /folder0 -r
下载完成后，本地生成的文件为：
└── folder0 ├── file1.txt ├── file2.txt ├── pic1.png ├── pic2.png ├── pic3.jpg ├── pic4.jpg ├── folder1 └── file7.txt └── folder2 ├── file8.txt └── folder3 └── file9.txt
下载 bucketname 桶中的所有 .txt 和 pi?1.png 文件至 folder0 文件夹：
./tosutil cp tos://bucketname /folder0 -r -include=*.txt#*pi?1.png
下载完成后，本地生成的文件为：
└── folder0 ├── file1.txt ├── file2.txt ├── pic1.png ├── folder1 └── file7.txt └── folder2 ├── file8.txt └── folder3 └── file9.txt