对象存储 OSS：高级命令

命令范围

支持的选项

所有高级命令

• --encoding-type string：输入的对象名或文件名的编码方式，取值：url。

• --request-payer string：请求的支付方式。如果为请求者付费模式，请设置该值，取值：requester。

支持批量操作的命令

• --start-after/--end-with (, ] ：前开后闭 ，用于设置key的查询范围。

• filter选项：对象/文件名、对象/文件目录、对象/文件大小、对象/文件时间、对象元数据等信息可设置过滤条件，具体的过滤规则，请参见过滤选项。

• --limited-num：设置查询接口的返回数据。

• --recursive/-r：用于递归操作，递归访问根目录下的所有文件或对象，包括子目录。

• --dirs/-d：只访问根目录下的文件或对象，不包括子目录。

  说明

  对于对象，采用Delimiter方式来模拟，需要扫描该前缀下的所有对象，对象数量越多，则越耗时。

• --force/-f：强制操作，不进行询问提示。

• --list-objects：使用ListObjects接口列举对象。

支持目的过滤规则的命令

• --update：跳过目标端已存在且修改时间比源文件更新的所有文件。如果目标端已存在的文件的修改时间与源文件的修改时间相同，则将更新该文件。

• --size-only：只对比文件大小，只同步文件大小不一样的数据。

• --checksum：对比crc64，优先对比文件大小，当文件大小一样时，再对比crc64。如果某一端crc64不存在，则判定为不一致，仅当对象间拷贝有效。

• --ignore-existing：跳过已存在的文件。

支持单个对象的命令

--version-id string：对象的版本标识。

支持列表模式的命令

--list-format：列表文件的格式，取值：plain、inventory。

--list-manifest-from：从文件中读取列表文件格式的描述信息，当列表文件格式为inventory时，需要设置该参数。

局部选项

选项类型

说明

--encoding-type

string

输入的对象名或文件名的编码方式。取值：url。

--request-payer

string

请求的支付方式。如果为请求者付费模式，请设置该值。取值：requester。

--start-after

string

按字母排序，返回设定值之后的对象，不包含该对象。

--end-with

string

按字母排序，返回设定值之前的对象，包含该对象。

--page-size

int

批量处理时分页列举对象的最大值（默认值1000），取值范围1~1000。

--include

stringArray

路径或文件名的包含规则。

--include-from

stringArray

从规则文件里读取包含规则。

--exclude

stringArray

路径或文件名的排除规则。

--exclude-from

stringArray

从规则文件里读取排除规则。

--filter

stringArray

路径或文件名过滤规则。

--files-from

stringArray

从文件中读取源文件名列表，忽略空行或注释行，仅适用于文件过滤操作。

--files-from-raw

stringArray

从文件中读取源文件名列表，仅适用于文件过滤操作。

--max-age

Duration

不传输任何比此更早的文件，默认是秒，或单位后缀形式 ms|s|m|h|d|w|M|y。默认值：off。

--min-age

Duration

不传输任何比此更新的文件，默认是秒，或单位后缀形式 ms|s|m|h|d|w|M|y。默认值：off。

--max-mtime

Time

不传输任何比此更新的文件，UTC时间格式。默认值：off。

--min-mtime

Time

不传输任何比此更早的文件，UTC时间格式。默认值：off。

--max-size

SizeSuffix

限制传输的最大文件大小，默认是字节，或单位后缀形式B|K|M|G|T|P，1K(KiB)=1024B，

--min-size

SizeSuffix

限制传输的最小文件大小，默认是字节，或单位后缀形式B|K|M|G|T|P，1K(KiB)=1024B，

--metadata-exclude

stringArray

对象元数据的排除规则。

--metadata-include

stringArray

对象元数据的包含规则。

--metadata-filter

stringArray

对象元数据过滤规则。

--metadata-filter-from

stringArray

从规则文件读取对象元数据过滤规则。

--checksum

/

仅拷贝文件大小和校验和（如果存在）不一致的源文件。

--size-only

/

仅拷贝文件大小不一致的源文件。

-u, --update

/

跳过目标端已存在且修改时间比源文件更新的文件。

-r, --recursive

/

递归进行操作。当指定该选项时，命令会对存储空间下所有符合条件的对象进行操作，否则只对路径指定的对象进行操作。

-d, --dirs

/

返回当前目录下的文件和子目录，而非递归显示所有子目录下的所有文件。

-f, --force

/

强制操作，不进行询问提示。

--list-objects

/

使用ListObjects接口列举对象。

--no-progress

/

不现显示度条。

-j, --job

int

多文件操作时的并发任务数。默认值：3。

--checkers

int

并行运行的检查器数量。默认值：16。

--parallel

int

单文件内部操作的并发任务数。

--part-size

SizeSuffix

分片大小，默认情况下根据文件大小自行计算合适的分片大小值。取值范围：100KiB~5GiB。

--bigfile-threshold

int

开启大文件分片上传、下载或拷贝的阈值。默认值：104857600。

--version-id

string

对象的版本标识。

--storage-class

string

对象的存储类型。取值：Standard、IA、Archive、ColdArchive、DeepColdArchive。

--acl

string

对象的访问权限。取值：private、public-read、public-read-write、default。

--cache-control

string

指定该对象被下载时网页的缓存行为。

--content-disposition

string

指定对象的展示形式。

--content-encoding

string

声明对象的编码方式。

--content-type

string

对象的内容类型。

--expires

string

指定缓存内容的绝对过期时间。

--copy-props

string

确定从源对象复制哪些属性。取值：none、metadata、default。

--tagging

string

指定对象的标签，使用key=value格式。

--tagging-directive

string

指定如何设置目标对象的标签。取值：COPY、REPLACE。

--metadata

string

指定对象的用户元数据，使用key=value格式。

--metadata-directive

string

指定如何设置目标对象的元数据。取值：COPY、REPLACE。

--list-format

string

列表文件的格式，取值：plain、inventory。

--list-manifest-from

string

从文件中读取列表文件格式的描述信息，当列表文件格式为inventory时，需要设置该参数

项目

说明

筛选规则语法

• rule pattern规则选项参数：Glob匹配模式。

• rule filename规则选项参数：Glob匹配模式规则文件路径。

• rule modifiers pattern规则选项参数：指令Glob匹配模式，指令为+表示包含规则，即符合该规则的对象会被包含在结果中。-表示排除规则，即符合该规则的对象会被排除在结果之外。

筛选规则选项参数

• --include

• --include-from

• --exclude

• --exclude-from

• --filter

• --filter-from

选项

说明

--include

--exclude

参数后面直接跟匹配模式，每个选项只表示一条规则，如果要使用多条规则，您可以重复使用这些选项。

如--include "*.txt" --include "*.js" --exclude "*.jpg"表示包含所有 .txt 和 .js 文件，但排除所有 .jpg 文件。

以下示例命令递归地从阿里云OSS的oss://examplebucket/exampledir/目录下载符合过滤规则的文件至本地localdir/，具体规则为包含所有.txt和.js文件，但排除所有.jpg文件。

ossutil cp -r oss://examplebucket/exampledir/ localdir/ --include "*.txt" --include "*.js" --exclude "*.jpg"

--filter

参数后面跟指令匹配模式，每个选项值表示一条规则。如果要使用多条规则，您可以重复使用这些选项。

如--filter "+ *.txt" --filter "+ *.js" --filter "- *.jpg"表示包含所有 .txt 和 .js 文件，但排除所有 .jpg 文件。

• + 符号表示包含规则，即符合该规则的对象会被包含在结果中。

• - 符号表示排除规则，即符合该规则的对象会被排除在结果之外。

以下示例命令递归地从阿里云OSS的oss://examplebucket/exampledir/目录下载符合过滤规则的文件至本地localdir/，具体规则为仅包含.png文件，排除其他所有文件。

ossutil cp -r oss://examplebucket/exampledir/ localdir/ --filter "+ *.png" --filter "- **"

--include-from

--exclude-from

参数后面跟着规则文件路径，规则文件里的一行表示一个Glob匹配模式。如果要引入多个规则文件，您可以重复使用这些选项。

通过--include-from引入的都为包含规则，通过--exclude-from引入的都为排除规则。

如--include-from include-file.txt --exclude-from exclude-file.txt表示包含所有 .txt 和 .js 文件，但排除所有 .jpg 文件。

规则文件include-file.txt的内容如下：

 *.txt
 *.js

规则文件include-file.txt的内容如下：

 *.jpg

--filter-from

参数后面跟着规则文件路径，通过规则文件里的一行表示一个指令 Glob 匹配模式。

如果要引入多个规则文件，您可以重复使用这些选项。

如--filter-from filter-file.txt中规则文件filter-file.txt内容如下：

 # a filter rule file
 + *.txt
 + *.js
 - **

选项

说明

--files-from

从文件里读入路径/文件名列表，如果要使用多个列表文件，您可以重复使用这些选项。

在处理列表文件中的每行时，会去除前导或尾随空格，以及忽略#或;开头的注释行。

--files-from-raw

从文件里读入路径/文件名列表，如果要使用多个列表文件，您可以重复使用这些选项。

在处理列表文件中的每行时，不忽略前导或尾随空格，以及#或;开头的注释行。

参数

说明

--min-age

Duration

仅处理修改时间在指定时间间隔前的文件，默认单位是秒，可以使用单位后缀形式。例如 1h，表示1小时。

--max-age

Duration

仅处理修改时间在指定时间间隔内的文件，默认单位是秒，可以使用单位后缀形式。例如 1h，表示1小时。

--min-mtime

Time

仅处理修改时间在指定时间之后的文件。

--max-mtime

Time

仅处理修改时间在指定时间之前的文件。

参数

说明

--min-size

不传输任何比此小的文件，默认单位是字节（B），也可以使用单位后缀形式，例如1K（KiB），表示1024字节。

--max-size

不传输任何比此大的文件，默认单位是字节（B），也可以使用单位后缀形式，例如1K（KiB），表示1024字节。