ossutil 2.0 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
```
Global installation is not required. After the steps above, ossutil is already usable: you can run it with a relative path from the current directory or with an absolute path from any directory. You can verify it from the current directory with:
```
./ossutil
```
Optional: If you want a regular user to run ossutil from any directory, move it to a user-local directory and add that directory to PATH. This only makes the command more convenient and does not affect using ./ossutil in the current directory.
```
mkdir -p "$HOME/.local/bin" && mv ossutil "$HOME/.local/bin/ossutil"
export PATH="$HOME/.local/bin:$PATH"
```
Optional: After step 6, run the following command to verify that PATH was configured correctly. This step only confirms shell environment setup and is not required for installation. If you do not want to modify PATH, you can keep using ./ossutil in the current directory, or use the absolute path to the ossutil binary from any directory:
```
ossutil
```
Optional: If you need a system-wide installation, you can still place it in /usr/local/bin with sudo. This is typically only needed for multi-user environments or when you specifically want a system-level command.

Open Terminal, 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
```
Global installation is not required. After the steps above, ossutil is already usable: you can run it with a relative path from the current directory or with an absolute path from any directory. You can verify it from the current directory with:
```
./ossutil
```
Optional: If you want a regular user to run ossutil from any directory, move it to a user-local directory and add that directory to PATH. This only makes the command more convenient and does not affect using ./ossutil in the current directory.
```
mkdir -p "$HOME/.local/bin" && mv ossutil "$HOME/.local/bin/ossutil"
export PATH="$HOME/.local/bin:$PATH"
```
Optional: After step 6, run the following command to verify that PATH was configured correctly. This step only confirms shell environment setup and is not required for installation. If you do not want to modify PATH, you can keep using ./ossutil in the current directory, or use the absolute path to the ossutil binary from any directory:
```
ossutil
```
Optional: If you need a system-wide installation, you can still place it in /usr/local/bin with sudo. This is typically only needed for multi-user environments or when you specifically want a system-level command.

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>

Example

ossutil cp -rfu oss://bucket/dest/ D:/localpath/ -i LTA***** -k MYW58****** --region cn-hangzhou

Parameter Notes

AccessKeyID: See the delivery email.

AccessKeySecret: See the delivery email.

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).

Wait for the download to complete.

From: https://www.alibabacloud.com/help/en/oss/developer-reference/oss-tools

#ossutil 2.0 User Guide

#Download and Install

#Download Data

ossutil 2.0 User Guide

Download and Install

Download Data