ossutil User Guide

This tool is intended for advanced users who are familiar with command-line operations. ossutil runs on Windows, Linux, and macOS. Download and install the appropriate version based on your environment.

Download and Install

Linux

macOS

Windows

Use curl to download the package:

curl -o ossutil-2.2.1-linux-amd64.zip https://gosspublic.alicdn.com/ossutil/v2/2.2.1/ossutil-2.2.1-linux-amd64.zip

Run the following command in the directory where the package was downloaded:
```
unzip ossutil-2.2.1-linux-amd64.zip
```
Enter the ossutil-2.2.1-linux-amd64 directory:
```
cd ossutil-2.2.1-linux-amd64
```
Grant execute permission:
```
chmod 755 ossutil
```

Run the following command to enable global access to ossutil:

sudo mv ossutil /usr/local/bin/ && sudo ln -s /usr/local/bin/ossutil /usr/bin/ossutil

Verify the installation. If running ossutil returns help information, the installation is successful:
```
ossutil
```

Use curl to download the package (mac-arm64 as an example):

curl -o ossutil-2.2.1-mac-arm64.zip  https://gosspublic.alicdn.com/ossutil/v2/2.2.1/ossutil-2.2.1-mac-arm64.zip

Run the following command in the directory where the package was downloaded:
```
unzip ossutil-2.2.1-mac-arm64.zip
```
Enter the ossutil directory:
```
cd ossutil-2.2.1-mac-arm64
```
Grant execute permission:
```
chmod 755 ossutil
```

Run the following command to enable global access to ossutil:

sudo mv ossutil /usr/local/bin/ && sudo ln -s /usr/local/bin/ossutil /usr/bin/ossutil

Verify the installation. If running ossutil returns help information, the installation is successful:
```
ossutil
```

Download ossutil x86 64bit.
Extract the downloaded .zip package to a target folder, then open the extracted directory.
Copy the extracted ossutil folder path and add it to your system environment variables.

a. Click the path bar in the current directory and copy the displayed folder path.

b. Open the Environment Variables dialog, find and double-click the Path variable under System variables, click New, and paste the copied ossutil folder path into the new entry field.
Verify the installation. If running ossutil returns help information, the installation is successful:
```
ossutil
```

Download Data

To download data from the command line, first create a local destination directory.

ossutil cp -rfu <OSS_PATH> <LOCAL_DESTINATION_PATH> -i <AccessKeyId> -k <AccessKeySecret> --region <region>

Parameter Notes

OSS path: The preset OSS path provided in the delivery email.

Region: If the delivery email shows oss-cn-hangzhou, set this parameter to cn-hangzhou (remove the oss- prefix).

AccessKeyID: See the delivery email.

AccessKeySecret: See the delivery email.

Example

ossutil cp -rfu oss://examplebucket/destfolder/ D:/localpath/ -i LTAI5tF4***** -k MYW58ZFUR3qQ****** --region cn-hangzhou

Wait for the download to complete.

#ossutil User Guide

#Download and Install

#Download Data

ossutil User Guide

Download and Install

Download Data