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

支援列表模式的命令

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