本文以 macOS 系统为例，介绍使用 tosutil 工具下载对象的常见示例命令。 ## 示例存储桶说明示例存储桶名为 **bucketname**，桶内包含如下对象： ```Plain 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** 文件夹： ```Plain ./tosutil cp tos://bucketname/file1.txt /folder1 ``` 下载完成后，本地生成的文件为： ```Plain └── folder1 └── file1.txt ``` ### 下载桶内指定对象至本地文件夹并重命名下载 **bucketname** 桶中的 **file1.txt** 文件至本地 **folder1** 文件夹中： :::tip 如果本地 **folder1** 文件夹中不存在 **file1_renamed.txt** 文件，则直接下载且下载后命名为 **file1_renamed.txt**；如果本地 **folder1** 文件夹中已存在 **file1_renamed.txt** 文件，则以 **file1.txt** 内容覆盖 **file1_renamed.txt** 进行下载。 ::: ```Plain ./tosutil cp tos://bucketname/file1.txt /folder1/file1_renamed.txt ``` 下载完成后，本地文件为： ```Plain └── folder1 └── file1_renamed.txt ``` ### 下载存储桶内指定文件夹（包括文件夹本身）下载 **bucketname** 桶中的 **folder2** 文件夹中的所有文件和文件夹（**包括 folder2 文件夹本身**）至本地 **folder1** 文件夹： ```Plain ./tosutil cp tos://bucketname/folder2/ /folder1/ -r ``` 下载完成后，本地生成的文件为： ```Plain └── folder1 └── folder2 ├── file8.txt └── folder3 └── file9.txt ``` ### 下载存储桶内指定文件夹（不包括文件夹本身）下载 **bucketname** 桶中的 **folder2** 文件夹中的所有文件和文件夹（**不包括 folder2 文件夹本身**）至本地 **folder2_renamed** 文件夹： ```Plain ./tosutil cp tos://bucketname/folder2 /folder2_renamed -r -flat ``` 下载完成后，本地生成的文件为： ```Plain └── folder2_renamed ├── file8.txt └── folder3 └── file9.txt ``` ### 下载存储桶所有文件下载 **bucketname** 桶中的所有文件至 **folder0** 文件夹： ```Plain ./tosutil cp tos://bucketname /folder0 -r ``` 下载完成后，本地生成的文件为： ```Plain └── 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** 文件夹： ```Plain ./tosutil cp tos://bucketname /folder0 -r -include=*.txt#*pi?1.png ``` 下载完成后，本地生成的文件为： ```Plain └── folder0 ├── file1.txt ├── file2.txt ├── pic1.png ├── folder1 └── file7.txt └── folder2 ├── file8.txt └── folder3 └── file9.txt ```

对象存储