Object Storage Service：進階命令

命令範圍

支援的選項

所有進階命令

• --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：對象的版本標識。

局部選項

說明

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

指定對象的標籤，使用key=value格式。

--tagging-directive string

指定如何設定目標對象的標籤。取值：COPY、REPLACE。

--metadata strings

指定對象的使用者中繼資料，使用key=value格式。

--metadata-directive string

指定如何設定目標對象的中繼資料。取值：COPY、REPLACE。

專案

說明

篩選規則文法

• 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位元組。