命令范圍

支持的選項

所有高級命令

• --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"

--filter

后面跟指令匹配模式，每個選項只表示一條規則。如果要使用多條規則，您可以重復使用這些選項。

如--filter "+ *.txt" --filter "+ *.js" --filter "- *.txt"

--include-from

--exclude-from

后面跟著規則文件路徑，規則文件里的一行表示一個Glob匹配模式。如果要引入多個規則文件，您可以重復使用這些選項。

通過--include-from引入的都為包含規則，通過--exclude-from引入的都為排除規則。

如 --include-from include-file.txt --exclude-from exclude-file.txt

include-file.txt，內容為

 *.txt
 *.js

exclude-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

不傳輸任何比此更新的文件，默認單位是秒，也可以使用單位后綴形式。例如 1h，表示1小時。

--max-age

不傳輸任何比此更早的文件，默認單位是秒，也可以使用單位后綴形式。例如 1h，表示1小時。

--min-mtime

不傳輸任何比此更早的文件，時間格式，UTC時間。例如 2006-01-02T15:04:05。

--max-mtime

不傳輸任何比此更新的文件，時間格式，UTC時間，例如 2006-01-02T15:04:05。

參數

說明

--min-size

不傳輸任何比此小的文件，默認單位是字節（B），也可以使用單位后綴形式，例如1K（KiB），表示1024字節。

--max-size

不傳輸任何比此大的文件，默認單位是字節（B），也可以使用單位后綴形式，例如1K（KiB），表示1024字節。