選項名稱

描述

-s，--short-format

顯示精簡格式，如果未指定該選項，默認顯示長格式。

--bigfile-threshold

開啟大文件斷點續傳的文件大小閾值，單位為Byte，默認值為100 MByte，取值范圍為0~9223372036854775807。

--acl

配置讀寫權限ACL。

--range

下載文件時，可以指定文件內容的字節范圍進行下載，字節從0開始編號。

• 可以指定一個區間，例如3-9表示從第3個字節到第9個字節（包含第3和第9字節）。

• 可以指定從什么字段開始，例如3-表示從第3個字節開始到文件結尾（包含第3個字節）。

• 可以指定從什么字段結束，例如-9表示從0字節到第9個字節（包含第9個字節）。

--all-versions

表示Object所有版本。

--type

數據校驗的方式。取值如下：

• crc64（默認值）：數據CRC64校驗。

• md5：數據MD5校驗。

-v，--version

顯示ossutil的版本并退出。

-u，--update

更新操作。

--origin

HTTP請求頭origin字段的值。

--upmode

probe命令中使用的上傳模式。取值如下：

• normal（默認值）：簡單上傳。

• append：追加上傳。

• multipart：分片上傳。

--sse-algorithm

Bucket的加密方式。取值如下：

• KMS：使用KMS托管密鑰進行加解密，即SSE-KMS。

• AES256：使用OSS完全托管密鑰進行加解密，即SSE-OSS。

--include

列舉符合指定條件的Object。例如*.jpg表示列舉所有格式為JPG的文件。

更多信息，請參見include和exclude選項。

--exclude

列舉不符合指定條件的Object。例如*.txt表示列舉所有格式不為TXT的文件。

更多信息，請參見include和exclude選項。

-r，--recursive

遞歸操作。當指定該選項時，ossutil會對Bucket下所有符合條件的Object進行操作，否則只對URL中指定的單個Object進行操作。

--addr

增加此項并填寫正確的網絡地址，ossutil會通過ping操作驗證本地到目標地址的網絡連通性。

默認值：www.aliyun.com

--kms-masterkey-id

KMS密鑰托管服務中的主密鑰ID。

--version-id

Object的版本ID。

--version-id-marker

列舉Version ID字母排序在marker之后的Object版本。僅當Bucket開啟版本控制后可用。

-m，--multipart

指定操作的對象為Bucket中未完成的Multipart事件。

-d，--directory

僅返回當前目錄下的文件和子目錄。

--payer

請求的支付方式，如果為請求者付費模式，可以將該值設置為requester。

--maxupspeed

最大上傳速度，單位為KB/s，默認值為0（不受限制）。

--maxdownspeed

最大下載速度，單位為KB/s，默認值為0（不受限制）。

--retry-times

發生錯誤后的重試次數。默認值為10，取值范圍為1~500。

--download

通過使用文件URL下載目標文件到本地的方式探測本地和目標Bucket之間的網絡狀態。

-j，--jobs

多文件操作時的并發任務數，默認值為3，取值范圍為1~10000。

-a，--all-type

指定操作的對象為Bucket中的Object和未完成的Multipart事件。

--disable-empty-referer

表示不允許referer字段為空。

--method

表示HTTP的請求類型，取值為PUT、GET、DELETE等。

--output-dir

指定輸出文件所在的目錄，輸出文件目前包含cp命令批量拷貝文件出錯時所產生的report文件。

默認值：當前目錄下的ossutil_output目錄。

--meta

設置Object的meta，格式為[header：value#header：value...]，如：Cache-Control：no-cache#Content-Encoding：gzip。

--object

用于probe命令中指定文件名稱。

--end-time

Linux或Unix系統下的時間戳。如果使用該選項，則最后更新時間晚于通過此選項指定時間的Object會被忽略。

--limited-num

返回結果的最大個數。

-L，--language

設置ossutil工具的語言。取值如下：

• CH（默認值）：中文。設置為CH時，請確保您的系統編碼方式為UTF-8。

• EN：英文。

--delete

刪除Bucket、Object或碎片操作。

-b，--bucket

僅在刪除Bucket時使用此選項。

--disable-crc64

關閉CRC64校驗。默認情況下，ossutil進行數據傳輸會打開CRC64校驗。

--upload

通過將本地文件上傳到目標Bucket的方式來探測本地和目標Bucket之間的網絡狀態。

--part-size

分片大小，單位為字節，默認情況下ossutil根據文件大小自行計算合適的分片大小值。如果需要性能調優時或者其他特殊需求時，可以設置該值，取值范圍為1~9223372036854775807。

--timeout

簽名URL的超時時間，單位為秒，默認值為60，取值范圍為0~9223372036854775807。

--checkpoint-dir

指定斷點續傳記錄信息所在的目錄。斷點續傳操作失敗時，ossutil會自動創建名為.ossutil_checkpoint的目錄，并在該目錄下記錄checkpoint信息，斷點續傳成功后會刪除該目錄。如果通過該選項指定了目錄，請確保指定的目錄可以被刪除。

--url

文件URL。

--marker

列舉名稱字母排序在marker之后的Bucket、Object或者Part。

-f，--force

強制操作，不進行詢問提示。

--snapshot-path

指定保存上傳、下載文件時的快照信息所在的目錄。在下一次上傳或下載文件時，ossutil會讀取指定路徑下的快照信息進行增量上傳或下載。

• --snapshot-path選項用于在某些場景下加速增量上傳、下載多個適用于文件（拷貝操作不支持該選項）。例如文件數量較多且兩次上傳期間沒有其他用戶更改OSS上對應的Object。

• --snapshot-path選項通過在本地記錄成功上傳、下載的文件的本地lastModifiedTime，從而在下次上傳、下載時通過比較lastModifiedTime來決定是否跳過相同文件，所以在使用該選項時，請確保兩次上傳、下載期間沒有其他用戶更改了OSS上的對應Object。當不滿足該場景時，如果想要增量上傳、下載批量文件，請使用--update選項。

• ossutil不會主動刪除snapshot-path下的快照信息，為了避免快照信息過多，當您確定快照信息無用時，請自行清理snapshot-path。

• 由于讀寫snapshot信息需要額外開銷，當要批量上傳、下載的文件數比較少或網絡狀況比較好或有其他用戶操作相同Object時，并不建議使用該選項。可以使用--update選項來增量上傳/下載。

• --update選項和--snapshot-path選項可以同時使用，ossutil會優先根據snapshot-path信息判斷是否跳過此文件，如果不滿足跳過條件，再根據--update判斷是否跳過此文件。

--start-time

值為Linux或Unix系統下面的時間戳，如果輸入這個選項，最后更新時間早于該時間的Object會被忽略。

--storage-class

設置Object的存儲方式。取值如下：

• Standard（默認值）：適用于頻繁的數據訪問。

• IA：適用于較低訪問頻率（平均每月訪問頻率1到2次）的業務場景，有最低存儲時間（30天）和最小計量單位（64 KB）要求。支持數據實時訪問，訪問數據時會產生數據取回費用。

• Archive：適用于數據長期保存的業務場景，有最低存儲時間（60天）和最小計量單位（64 KB）要求。數據需解凍（約1分鐘）后訪問，解凍會產生數據取回費用。

• ColdArchive：適用于需要超長時間存放的極冷數據，有最低存儲時間（180天）和最小計量單位（64 KB）要求。數據需解凍后訪問，解凍時間根據數據大小和選擇的解凍模式決定，解凍會產生數據取回費用。

-t，--sts-token

訪問OSS使用的STSToken，僅在使用STS臨時授權方式訪問OSS時需要配置此項。該選項值會覆蓋配置文件中的相應設置。stsToken生成方式請參見臨時訪問憑證。

--parallel

單文件內部操作的并發任務數，取值范圍為1~10000， 默認由ossutil根據操作類型和文件大小自行決定。

--partition-download

用于分區下載。該選項取值格式為分區編號：總分區數。例如1：5，表示當前ossutil下載分區1，總共有5個分區。分區號從1開始編號，Object的分區規則由工具內部算法決定。通過該選項將待下載的Object分成多個分區，并由多個ossutil命令并行下載，各個ossutil命令下載各自的分區。

--bucketname

Bucket名稱。

--encoding-type

對oss://bucket_name后面的key進行編碼，取值為url。如果不指定該選項，則表示key未經過編碼。

--origin

HTTP請求頭Origin字段的值，表示請求來源域，用來標識跨域請求。

--acr-method

HTTP請求頭Access-Control-Request-Method的值，取值為GET、PUT、POST、DELETE、HEAD。

--acr-headers

HTTP請求頭Access-Control-Request-Headers的值，表示在實際請求中除簡單頭部以外需要用到的Header。如果有多個Header，各個Header之間用英文的逗號（,）分隔，再加上雙引號。例如--acr-headers "header1,header2,header3"。

--upload-id-marker

列舉Upload ID字母排序在Marker之后的Part。

-h，--help

顯示幫助信息。

--trafic-limit

sign命令中用于指定HTTP的訪問速度。單位為bit/s。

默認值：0，表示不限速。

取值范圍：819200~838860800，即100 KB/s~100 MB/s。

--local-host

cp命令中用于指定ossutil工具的本地IP地址。指定該選項后，ossutil將通過指定IP地址訪問OSS。

--enable-symlink-dir

上傳鏈接子目錄。默認不上傳。probe命令可以探測是否存在死循環鏈接文件或者目錄。

--only-current-dir

僅上傳、下載、拷貝當前目錄下的文件，忽略子目錄及子目錄下的文件。

--disable-dir-object

不為上傳的目錄生成Object，但您仍可以在OSS控制臺看到對應的目錄結構。當您刪除目錄內的文件時，該目錄也會消失。

--probe-item

表示probe命令的探測項目，取值如下：

• upload-speed：探測上傳帶寬。

• download-speed：探測下載帶寬。

• cycle-symlink：探測本地文件目錄中是否存在死循環鏈接文件或者目錄。

--redundancy-type

Bucket的數據容災類型。取值如下：

• LRS（默認值）：本地冗余LRS將您的數據冗余存儲在同一個可用區的不同存儲設備上，可支持兩個存儲設備并發損壞時，仍維持數據不丟失，可正常訪問。

• ZRS：同城冗余ZRS采用多可用區（AZ）內的數據冗余存儲機制，將用戶的數據冗余存儲在同一地域（Region）的多個可用區。當某個可用區不可用時，仍然能夠保障數據的正常訪問。

--disable-encode-slash

表示不對URL中的正斜線（/）進行編碼。

--disable-all-symlink

上傳時忽略所有的符號鏈接子文件以及符號鏈接子目錄。

--tagging

上傳或復制文件時設置文件的對象標簽，格式為"abc=1&bcd=2&……"。

--disable-ignore-error

遇到錯誤，拋出異常直接終止。批量操作時不忽略錯誤。

--block-size

定義輸出結果中指定Bucket或目錄下包含的Object大小，取值為KB、MB、GB或TB。不添加此選項時，默認以Byte為單位統計Object的大小。