### Install unzip on Ubuntu

Source: https://help.aliyun.com/zh/oss/command-line-options

Installs the unzip utility on Ubuntu using apt.

```bash
sudo apt install -y unzip
```

--------------------------------

### Ossutil Command Examples

Source: https://help.aliyun.com/zh/oss/command-line-options

Provides examples of ossutil commands, including basic object access, multi-level API commands, and help topics.

```bash
ossutil cat oss://bucket/object
ossutil api get-bucket-cors --bucket bucketexample
ossutil filter
```

--------------------------------

### Install unzip on Alibaba Cloud Linux

Source: https://help.aliyun.com/zh/oss/command-line-options

Installs the unzip utility on Alibaba Cloud Linux using yum.

```bash
sudo yum install -y unzip
```

--------------------------------

### Output file content to screen

Source: https://help.aliyun.com/zh/oss/developer-reference/cat-output-file-contents

This example shows how to display the content of 'example.txt' from 'examplebucket' to the console. This requires `oss:GetObject` permission.

```bash
ossutil cat oss://examplebucket/example.txt
```

--------------------------------

### Sync with Start After

Source: https://help.aliyun.com/zh/oss/developer-reference/sync-synchronize-local-files-to-oss?spm=a2c4g.11186623.help-menu-31815.d_19_3_1_2_0_16_0.3f704c8c0UvPzV&scm=20140722.H_2788837._.OR_help-T_cn~zh-V_1

Begin synchronization after a specified object (lexicographically) using `--start-after`. The specified object itself is not included.

```bash
ossutil sync --start-after "object_name" file_url cloud_url
```

--------------------------------

### Range Download with get()

Source: https://help.aliyun.com/zh/oss/developer-reference/browser-js

Demonstrates downloading a specific range of an object using the get() method. This is useful for partial downloads or streaming.

```javascript
get(name[, file, options])
```

--------------------------------

### Verify ossutil installation on Linux

Source: https://help.aliyun.com/zh/oss/command-line-options

Executes the ossutil command to verify successful installation by displaying its help information.

```bash
ossutil
```

--------------------------------

### List Files with listV2()

Source: https://help.aliyun.com/zh/oss/developer-reference/browser-js

Provides an example of listing files within a bucket or a specific directory using the listV2() method. Supports querying and options for pagination.

```javascript
listV2(query[, options])
```

--------------------------------

### OSS Configuration File Example (INI format)

Source: https://help.aliyun.com/zh/oss/command-line-options

This snippet shows the basic structure of an ossutil configuration file using INI format. It includes a '[default]' section with access key credentials.

```ini
[default]
accessKeyID = "your-access-key-id"
accessKeySecret = "your-access-key-secret"
```

--------------------------------

### Hadoop Core-site.xml Configuration for OSS Accelerator

Source: https://help.aliyun.com/zh/oss/developer-reference/best-practice-of-coordination-and-optimization-based-on-hadoop-oss-connector-client-and-oss-accelerator

Configure the OSS Accelerator endpoint and acceleration rules in core-site.xml. This example enables acceleration for specific prefixes and small I/O requests.

```xml
<!-- 加速器 Endpoint（内网专用） -->
<property>
    <name>fs.oss.acc.endpoint</name>
    <value>https://cn-hangzhou-j-internal.oss-data-acc.aliyuncs.com</value>
</property>
<!-- 加速规则：对小文件、热点数据启用加速 -->
<property>
    <name>fs.oss.acc.rules</name>
    <value><![CDATA[
        <rules>
            <rule>
                <keyPrefixes>
                    <keyPrefix>tpcds/q9/</keyPrefix>
                </keyPrefixes>
                 <ioSizeRanges>
                      <!-- 缓存前 2MB：适用于文件头元信息 -->
                      <ioSizeRange>
                          <ioType>HEAD</ioType>
                          <ioSize>2097152</ioSize>
                      </ioSizeRange>
                      <!-- 缓存末尾 2MB：适用于 Parquet/ORC Footer -->
                      <ioSizeRange>
                          <ioType>TAIL</ioType>
                          <ioSize>2097152</ioSize>
                      </ioSizeRange>
                      <!-- 缓存小 I/O 请求（0~50MB） -->
                      <ioSizeRange>
                          <ioType>SIZE</ioType>
                          <minIOSize>0</minIOSize>
                          <maxIOSize>52428800</maxIOSize>
                      </ioSizeRange>
                  </ioSizeRanges>
                <operations><operation>getObject</operation></operations>
            </rule>
        </rules>
    ]]></value>
</property>
```

--------------------------------

### Integer Option Example

Source: https://help.aliyun.com/zh/oss/command-line-options

Integer options accept unsigned integer values.

```bash
--read-timeout 10
```

--------------------------------

### Manage Symlinks with putSymlink()

Source: https://help.aliyun.com/zh/oss/developer-reference/browser-js

Provides an example of creating or managing symbolic links (symlinks) to other objects using the putSymlink() method.

```javascript
putSymlink(name, targetName[, options])
```

--------------------------------

### Long-term Credentials from External Process

Source: https://help.aliyun.com/zh/oss/command-line-options

Example format for long-term credentials returned by an external process.

```json
{
  "AccessKeyId" : "ak",
  "AccessKeySecret" : "sk"
}
```

--------------------------------

### Append Upload with ACL and Tagging

Source: https://help.aliyun.com/zh/oss/developer-reference/append-append-upload

Example of uploading a local file and setting its ACL to private and adding a tag. This is useful for initial uploads with specific permissions and metadata.

```bash
ossutil append 1.txt oss://dst-bucket/append.txt --acl private --tagging tag=value
```

--------------------------------

### Multipart Upload with multipartUpload()

Source: https://help.aliyun.com/zh/oss/developer-reference/browser-js

Provides an example of using multipartUpload() for uploading large files. This method breaks the file into parts for more robust uploads.

```javascript
multipartUpload(name, file[, options])
```

--------------------------------

### Include filter file example

Source: https://help.aliyun.com/zh/oss/developer-reference/advanced-commands

Specifies patterns for inclusion in a filter file. Each line in the file represents a Glob pattern.

```text
*.txt
*.js
```

--------------------------------

### Duration Option Example

Source: https://help.aliyun.com/zh/oss/command-line-options

Duration options accept time units including milliseconds (ms), seconds (s), minutes (m), hours (h), days (d), weeks (w), months (M), and years (y). Fractional values are supported.

```bash
--min-age 1.5d
```

--------------------------------

### String List Option Examples

Source: https://help.aliyun.com/zh/oss/command-line-options

String list options support single or multiple values for the same option, and values can be comma-separated. Multiple single values for the same option are also supported.

```bash
--metadata user=jack,email=ja**@test.com
```

```bash
--metadata address=china
```

--------------------------------

### Configure Hadoop core-site.xml for OSS S3A Compatibility

Source: https://help.aliyun.com/zh/oss/developer-reference/best-practice-of-coordination-and-optimization-based-on-hadoop-oss-connector-client-and-oss-accelerator

Add these configurations to $HADOOP_HOME/etc/hadoop/core-site.xml to enable S3A mapping to OSS. Ensure to replace YourAccessKeyId and YourAccessKeySecret with your actual Alibaba Cloud credentials.

```xml
<configuration>
    <!-- Enable OSS implementation in S3A compatible mode -->
    <property>
        <name>fs.AbstractFileSystem.s3a.impl</name>
        <value>org.apache.hadoop.fs.aliyun.oss.v2.OSSWithS3A</value>
    </property>
    <!-- Specify s3a file system implementation class -->
    <property>
        <name>fs.s3a.impl</name>
        <value>org.apache.hadoop.fs.aliyun.oss.v2.AliyunOSSPerformanceFileSystem</value>
    </property>
    <!-- S3A Access Key (use Alibaba Cloud AccessKey) -->
    <property>
        <name>fs.s3a.access.key</name>
        <value>YourAccessKeyId</value>
    </property>
    <property>
        <name>fs.s3a.secret.key</name>
        <value>YourAccessKeySecret</value>
    </property>
    <!-- OSS Endpoint (internal address recommended for better performance) -->
    <property>
        <name>fs.s3a.endpoint</name>
        <value>oss-cn-hangzhou-internal.aliyuncs.com</value>
    </property>
    <!-- Optional: Disable SSL to avoid certificate issues -->
    <property>
        <name>fs.s3a.connection.ssl.enabled</name>
        <value>false</value>
    </property>
</configuration>
```

--------------------------------

### List Objects with Default Configuration

Source: https://help.aliyun.com/zh/oss/command-line-options

Use this command to list objects in a bucket when using the default configuration file.

```bash
ossutil ls oss://examplebucket -c ~/.ossutilconfig
```

--------------------------------

### Boolean Option Example

Source: https://help.aliyun.com/zh/oss/command-line-options

Boolean options are used to enable or disable a specific feature.

```bash
--dry-run
```

--------------------------------

### Get Return Code on Windows

Source: https://help.aliyun.com/zh/oss/command-line-options

Retrieve the exit status of the last executed command on Windows systems.

```batch
echo %errorlevel%
```

--------------------------------

### Create Local File for Upload

Source: https://help.aliyun.com/zh/oss/command-line-options

This command creates a sample local text file named 'uploadFile.txt' with the content 'Hello, OSS!' to be used for uploading.

```bash
echo 'Hello, OSS!' > uploadFile.txt
```

--------------------------------

### Get Bucket CORS Raw Output

Source: https://help.aliyun.com/zh/oss/command-line-options

Retrieve bucket CORS configuration in its raw, server-returned format.

```bash
ossutil api get-bucket-cors --bucket bucketexample
```

```xml
<?xml version="1.0" encoding="UTF-8"?>
<CORSConfiguration>
  <CORSRule>
    <AllowedOrigin>www.aliyun.com</AllowedOrigin>
    <AllowedMethod>PUT</AllowedMethod>
    <AllowedMethod>GET</AllowedMethod>
    <MaxAgeSeconds>10000</MaxAgeSeconds>
  </CORSRule>
  <ResponseVary>false</ResponseVary>
</CORSConfiguration>
```

--------------------------------

### Use Command-Line Options for OSS Access

Source: https://help.aliyun.com/zh/oss/command-line-options

Demonstrates using ossutil with command-line options to specify access key ID, secret, and region for accessing an OSS bucket. This method has the highest priority and can override other configurations.

```bash
ossutil ls oss://examplebucket -i "your-access-key-id" -k "your-access-key-secret" --region cn-hangzhou
```

--------------------------------

### Timestamp Option Example

Source: https://help.aliyun.com/zh/oss/command-line-options

Timestamp options require values in ISO 8601 format (DateTime or Date).

```bash
--max-mtime 2006-01-02T15:04:05
```

--------------------------------

### Copy File with copy()

Source: https://help.aliyun.com/zh/oss/developer-reference/browser-js

Demonstrates how to copy a file from one location to another within OSS using the copy() method. Can also copy between buckets.

```javascript
copy(name, sourceName[, sourceBucket, options])
```

--------------------------------

### Get Return Code on Linux/macOS

Source: https://help.aliyun.com/zh/oss/command-line-options

Retrieve the exit status of the last executed command on Linux or macOS systems.

```bash
echo $?
```

--------------------------------

### Configuring Specific Bucket Mappings

Source: https://help.aliyun.com/zh/oss/command-line-options

Illustrates how to define configurations for individual buckets within a `[buckets name]` section. This includes setting region, endpoint, and addressing style for each bucket.

```ini
[buckets dev-bucket]
bucket-hz-01 = 
  region=cn-hangzhou
bucket-hz-02 = 
  region=cn-hangzhou
  endpoint=test.com
  addressing-style=cname
bucket-bj-01 = 
  region=cn-beijing
```

--------------------------------

### Configure OSS Access with AK using a Configuration File

Source: https://help.aliyun.com/zh/oss/command-line-options

Creates a configuration file (~/.ossutilconfig) to store AK credentials and region for ossutil. This file is then used to access an OSS bucket.

```ini
[default]
accessKeyID = yourAccessKeyID
accessKeySecret = yourAccessKeySecret
region=cn-hangzhou
```

```bash
ossutil ls oss://examplebucket -c ~/.ossutilconfig
```

--------------------------------

### String Array Option Examples

Source: https://help.aliyun.com/zh/oss/command-line-options

String array options support single or multiple occurrences of the same option, each with a single value.

```bash
--include *.jpg
```

```bash
--include *.txt
```

--------------------------------

### Temporary Credentials from External Process

Source: https://help.aliyun.com/zh/oss/command-line-options

Example format for temporary credentials (including STS token) returned by an external process.

```json
{
  "AccessKeyId" : "ak",
  "AccessKeySecret" : "sk",
  "Expiration" : "2023-12-29T07:45:02Z",
  "SecurityToken" : "token"
}
```

--------------------------------

### Exclude filter file example

Source: https://help.aliyun.com/zh/oss/developer-reference/advanced-commands

Specifies patterns for exclusion in a filter file. Each line in the file represents a Glob pattern.

```text
*.jpg
```

--------------------------------

### Load Compact CORS Configuration from File

Source: https://help.aliyun.com/zh/oss/command-line-options

Load compact JSON parameters from a file using the 'file://' prefix.

```json
{"CORSRule":{"AllowedOrigin":["www.aliyun.com"],"AllowedMethod":["PUT","GET"],"MaxAgeSeconds":10000}}
```

```bash
ossutil api put-bucket-cors --bucket examplebucket --cors-configuration  "{\"CORSRule\":{\"AllowedOrigin\":[\"www.aliyun.com\"],\"AllowedMethod\":[\"PUT\",\"GET\"],\"MaxAgeSeconds\":10000}}"
```

--------------------------------

### List Objects with Ali-EcsRamRole Mode

Source: https://help.aliyun.com/zh/oss/command-line-options

List objects in a bucket using the Ali-EcsRamRole mode, typically configured via a settings file.

```bash
ossutil ls oss://examplebucket --mode Ali-EcsRamRole
```

--------------------------------

### List Files in OSS Bucket

Source: https://help.aliyun.com/zh/oss/command-line-options

Lists all files within a specified Aliyun OSS bucket ('examplebucket').

```bash
ossutil ls oss://examplebucket
```

--------------------------------

### Create OSS Bucket

Source: https://help.aliyun.com/zh/oss/command-line-options

Use this command to create a new bucket in Aliyun OSS. Ensure the bucket name is unique.

```bash
ossutil mb oss://examplebucket
```

--------------------------------

### String Option Example

Source: https://help.aliyun.com/zh/oss/command-line-options

String arguments can include alphanumeric characters, symbols, and spaces. If spaces are present, the string must be enclosed in quotes.

```bash
--acl private
```

--------------------------------

### Simple Upload with put()

Source: https://help.aliyun.com/zh/oss/developer-reference/browser-js

Demonstrates how to perform a simple file upload using the put() method. This is suitable for smaller files.

```javascript
put(name, file[, options])
```

--------------------------------

### Download File from OSS Bucket

Source: https://help.aliyun.com/zh/oss/command-line-options

Downloads a file ('uploadFile.txt') from an Aliyun OSS bucket ('examplebucket') to a local directory ('localfolder').

```bash
ossutil cp oss://examplebucket/uploadFile.txt localfolder/
```

--------------------------------

### Configure ossutil for global access on Linux

Source: https://help.aliyun.com/zh/oss/command-line-options

Moves the ossutil binary to a system-wide location and creates a symbolic link for global access on Linux.

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

--------------------------------

### Display characters from an offset to the end of the file

Source: https://help.aliyun.com/zh/oss/developer-reference/cat-output-file-contents

When only `--offset` is specified, the command prints characters starting from the given position until the end of the file.

```bash
ossutil cat oss://examplebucket/example.txt --offset 10
```

--------------------------------

### Configure OSS Access with RAMRoleArn using a Configuration File

Source: https://help.aliyun.com/zh/oss/command-line-options

Creates a configuration file (~/.ossutilconfig) to specify RAMRoleArn credentials, including role ARN and session name, along with the region for ossutil. This method is not supported via environment variables or command-line options.

```ini
[default]
accessKeyID = yourAccessKeyID
accessKeySecret = yourAccessKeySecret
mode = RamRoleArn
roleArn = acs:ram::137918634953****:role/Alice
roleSessionName = session_name_example
region=cn-hangzhou
```

```bash
ossutil ls oss://examplebucket -c ~/.ossutilconfig
```

--------------------------------

### Get Bucket CORS JSON Output

Source: https://help.aliyun.com/zh/oss/command-line-options

Retrieve bucket CORS configuration formatted as a JSON string using the --output-format json option.

```bash
ossutil api get-bucket-cors --bucket bucketexample --output-format json
```

```json
{
  "CORSRule": {
    "AllowedMethod": [
      "PUT",
      "GET"
    ],
    "AllowedOrigin": "www.aliyun.com",
    "MaxAgeSeconds": "10000"
  },
  "ResponseVary": "false"
}
```

--------------------------------

### Configure OSS Access with AK using Environment Variables

Source: https://help.aliyun.com/zh/oss/command-line-options

Sets OSS access key ID and secret as environment variables and then uses ossutil to list objects in a bucket. This method is suitable when a configuration file is not preferred.

```bash
export OSS_ACCESS_KEY_ID=yourAccessKeyID
export OSS_ACCESS_KEY_SECRET=yourAccessKeySecret
ossutil ls oss://examplebucket
```

--------------------------------

### Filter Objects by Metadata

Source: https://help.aliyun.com/zh/oss/developer-reference/advanced-commands

Use the --metadata-include option to filter objects based on their metadata key-value pairs. This example queries for objects with an archive storage class.

```bash
ossutil ls oss://bucket/ --metadata-include "x-oss-storage-class=*Archive"
```

--------------------------------

### Delete File with delete()

Source: https://help.aliyun.com/zh/oss/developer-reference/browser-js

Demonstrates how to delete a file from OSS using the delete() method. This action is irreversible.

```javascript
delete(name[, options])
```

--------------------------------

### Upload File to OSS Bucket

Source: https://help.aliyun.com/zh/oss/command-line-options

Uploads a local file ('uploadFile.txt') to a specified Aliyun OSS bucket ('examplebucket').

```bash
ossutil cp uploadFile.txt oss://examplebucket
```

--------------------------------

### Basic Hadoop File Operations with OSS

Source: https://help.aliyun.com/zh/oss/developer-reference/best-practice-of-coordination-and-optimization-based-on-hadoop-oss-connector-client-and-oss-accelerator

Verify basic read/write functionality using standard Hadoop fs commands. Ensure the OSS bucket and path exist and are accessible.

```bash
# 列出 OSS 目录内容
hadoop fs -ls oss://my-data-lake-bucket/test/
# 上传小文件
hadoop fs -copyFromLocal /tmp/test.txt oss://my-data-lake-bucket/test/
# 删除文件
hadoop fs -rm oss://my-data-lake-bucket/test/test.txt
```

--------------------------------

### Sync with Checkpoint Directory

Source: https://help.aliyun.com/zh/oss/developer-reference/sync-synchronize-local-files-to-oss?spm=a2c4g.11186623.help-menu-31815.d_19_3_1_2_0_16_0.3f704c8c0UvPzV&scm=20140722.H_2788837._.OR_help-T_cn~zh-V_1

Enable断点续传 (resumable uploads) by specifying a directory for checkpoint information using `--checkpoint-dir`. This allows synchronization to resume from where it left off if interrupted.

```bash
ossutil sync --checkpoint-dir .ossutil_checkpoint/ file_url cloud_url
```

--------------------------------

### Display characters from an offset

Source: https://help.aliyun.com/zh/oss/developer-reference/cat-output-file-contents

Use `--offset` to specify the starting position and `--count` to limit the number of characters to display. This allows for precise extraction of content segments.

```bash
ossutil cat oss://examplebucket/example.txt --offset 10 --count 20
```

--------------------------------

### Referencing Source Profile Configuration

Source: https://help.aliyun.com/zh/oss/command-line-options

Demonstrates how to reference parameters from another profile using the `source-profile` option. This is useful for centralizing common credentials or settings.

```ini
[profile cred]
access-key-id=ak
access-key-secret=sk

[profile dev]
region=cn-hangzhou
source-profile=cred
```

--------------------------------

### Size Suffix Option Examples

Source: https://help.aliyun.com/zh/oss/command-line-options

Size options support unit suffixes like K (KiB), M (MiB), G (GiB), T (TiB), P (PiB), E (EiB). The default unit is bytes (B).

```bash
--min-size 1024
```

```bash
--min-size 1K
```

--------------------------------

### Configure OSS Access with STS using a Configuration File

Source: https://help.aliyun.com/zh/oss/command-line-options

Generates a configuration file (~/.ossutilconfig) with STS credentials (Access Key ID, Secret, and Security Token) and region for ossutil. This file is then used to access an OSS bucket.

```ini
[default]
accessKeyID = yourSTSAccessKeyID
accessKeySecret = yourSTSAccessKeySecret
stsToken = yourSecurityToken
region=cn-hangzhou
```

```bash
ossutil ls oss://examplebucket -c ~/.ossutilconfig
```

--------------------------------

### Basic Sync Command

Source: https://help.aliyun.com/zh/oss/developer-reference/sync-synchronize-local-files-to-oss?spm=a2c4g.11186623.help-menu-31815.d_19_3_1_2_0_16_0.3f704c8c0UvPzV&scm=20140722.H_2788837._.OR_help-T_cn~zh-V_1

This is the fundamental command to synchronize local files to OSS. Replace `file_url` with the local directory path and `cloud_url` with the OSS bucket path.

```bash
ossutil sync file_url cloud_url
```

--------------------------------

### Download ossutil for Linux x86_64

Source: https://help.aliyun.com/zh/oss/command-line-options

Downloads the ossutil binary for Linux x86_64 using curl.

```bash
curl -o ossutil-2.3.0-linux-amd64.zip https://gosspublic.alicdn.com/ossutil/v2/2.3.0/ossutil-2.3.0-linux-amd64.zip
```

--------------------------------

### Basic ossutil cat command

Source: https://help.aliyun.com/zh/oss/developer-reference/cat-output-file-contents

Use this command to output the entire content of a specified file to the screen. Ensure you have the `oss:GetObject` permission.

```bash
ossutil cat oss://bucket/object [flags]
```

--------------------------------

### Run ossutil with Custom Configuration File

Source: https://help.aliyun.com/zh/oss/command-line-options

Executes an ossutil command using a custom configuration file specified by the '-c' option. Replace '/path/yourconfig' with the actual path to your configuration file.

```bash
ossutil -c /path/yourconfig ls oss://examplebucket
```

--------------------------------

### Restore File with restore()

Source: https://help.aliyun.com/zh/oss/developer-reference/browser-js

Demonstrates how to restore an archived object to an accessible state using the restore() method. This is necessary before accessing archived data.

```javascript
restore(name[, options])
```

--------------------------------

### Configure OSS Access with STS using Environment Variables

Source: https://help.aliyun.com/zh/oss/command-line-options

Sets OSS STS credentials (Access Key ID, Secret, and Session Token) as environment variables and uses ossutil to list objects in a bucket. This method is convenient for temporary access.

```bash
export OSS_ACCESS_KEY_ID=yourSTSAccessKeyID
export OSS_ACCESS_KEY_SECRET=yourSTSAccessKeySecret
export OSS_SESSION_TOKEN=yourSecurityToken
ossutil ls oss://examplebucket
```

--------------------------------

### Referencing Bucket Configurations

Source: https://help.aliyun.com/zh/oss/command-line-options

Shows how to link bucket-specific configurations to a profile using the `buckets` parameter. This allows for granular control over endpoint and region settings for different buckets.

```ini
[profile dev]
region=cn-hangzhou
access-key-id=ak
access-key-secret=sk
buckets=dev-bucket

[buckets dev-bucket]
bucket-name-hz = 
 endpoint=oss-cn-hangzhou-internal.aliyuncs.com
bucket-name-bj = 
 region=cn-beijing
```

--------------------------------

### Load CORS Configuration from File

Source: https://help.aliyun.com/zh/oss/command-line-options

Load complex parameters, such as CORS configuration, from a JSON file using the 'file://' prefix.

```json
{
  "CORSRule": {
    "AllowedOrigin": ["www.aliyun.com"],
    "AllowedMethod": ["PUT","GET"],
    "MaxAgeSeconds": 10000
  }
}
```

```bash
ossutil api put-bucket-cors --bucket examplebucket --cors-configuration file://cors-configuration.json
```

--------------------------------

### Sync with Include From File

Source: https://help.aliyun.com/zh/oss/developer-reference/sync-synchronize-local-files-to-oss?spm=a2c4g.11186623.help-menu-31815.d_19_3_1_2_0_16_0.3f704c8c0UvPzV&scm=20140722.H_2788837._.OR_help-T_cn~zh-V_1

Read inclusion rules from a file using `--include-from`. This allows for managing a large set of inclusion patterns.

```bash
ossutil sync --include-from include-rules.txt file_url cloud_url
```

--------------------------------

### Configure Proxy Server via Environment Variables

Source: https://help.aliyun.com/zh/oss/command-line-options

Use the 'env' value for the --proxy option to leverage environment variables HTTP_PROXY and HTTPS_PROXY for proxy settings. Ensure these variables are configured in your operating system.

```bash
--proxy env
```

--------------------------------

### Sync with Part Size

Source: https://help.aliyun.com/zh/oss/developer-reference/sync-synchronize-local-files-to-oss?spm=a2c4g.11186623.help-menu-31815.d_19_3_1_2_0_16_0.3f704c8c0UvPzV&scm=20140722.H_2788837._.OR_help-T_cn~zh-V_1

Specify the size of each part for multipart uploads using `--part-size`. The value ranges from 100 KiB to 5 GiB.

```bash
ossutil sync --part-size 10M file_url cloud_url
```

--------------------------------

### Sync with Min Size

Source: https://help.aliyun.com/zh/oss/developer-reference/sync-synchronize-local-files-to-oss?spm=a2c4g.11186623.help-menu-31815.d_19_3_1_2_0_16_0.3f704c8c0UvPzV&scm=20140722.H_2788837._.OR_help-T_cn~zh-V_1

Limit the minimum file size for synchronization using `--min-size`. Files smaller than this size will be skipped.

```bash
ossutil sync --min-size 1K file_url cloud_url
```

--------------------------------

### Sync with Backup Directory

Source: https://help.aliyun.com/zh/oss/developer-reference/sync-synchronize-local-files-to-oss?spm=a2c4g.11186623.help-menu-31815.d_19_3_1_2_0_16_0.3f704c8c0UvPzV&scm=20140722.H_2788837._.OR_help-T_cn~zh-V_1

Specify a directory to store backup files using the `--backup-dir` option. This is useful for retaining previous versions of files.

```bash
ossutil sync --backup-dir backup/ file_url cloud_url
```

--------------------------------

### Configure OSS Access with EcsRamRole using a Configuration File

Source: https://help.aliyun.com/zh/oss/command-line-options

Generates a configuration file (~/.ossutilconfig) to set the mode to EcsRamRole for ossutil. This method is recommended for applications running on ECS or similar instances and does not support environment variables.

```ini
[default]
mode = EcsRamRole
```

--------------------------------

### Configure OSS Access with AK using Command-Line Options

Source: https://help.aliyun.com/zh/oss/command-line-options

Specifies AK credentials directly via command-line options for ossutil to access an OSS bucket. This is useful for temporary or specific access needs.

```bash
ossutil ls oss://examplebucket -i yourAccessKeyID -k yourAccessKeySecret
```

--------------------------------

### OSS Accelerator: File Size Range Acceleration Configuration

Source: https://help.aliyun.com/zh/oss/developer-reference/best-practice-of-coordination-and-optimization-based-on-hadoop-oss-connector-client-and-oss-accelerator

Accelerate access for small files within a specified size range (0-50MB). Ideal for metadata and small partition files.

```xml
<IOSizeRanges>
                        <!-- 缓存小 I/O 请求（0~50MB）：覆盖常见扫描操作 -->
                        <ioSizeRange>
                            <ioType>SIZE</ioType>
                            <minIOSize>0</minIOSize>
                            <maxIOSize>52428800</maxIOSize>
                        </ioSizeRange>
                    </IOSizeRanges>
```