讓您全面了解并上手億速云產品
常見入門級使用教程
對外 API 開發文檔中心
您歷史提交的工單
您的每一條意見,我們都嚴謹處理
您的每一條建議,我們都認真對待
您可以通過-h選項來查看ossutil支持的所有options。
./ossutil -h
若要查看某個命令支持哪些選項,請使用ossutil help [command]命令來查看,例如ossutil help cp。
下面介紹一些ossutil的通用選項,這些選項可以在大部分命令中使用:
./ossutil [command] --loglevel=info
./ossutil [command] --loglevel=debug
./ossutil ls oss://bucket1 --proxy-host http://47.88.**.**:3128 --proxy-user test --proxy-pwd test
ossutil所有選項列表如下:
選項名稱 | 描述 |
---|---|
-s, —short-format | 顯示精簡格式,如果未指定該選項,默認顯示長格式。 |
—bigfile-threshold | 開啟大文件斷點續傳的文件大小閾值,單位為Byte,默認值:100MByte,取值范圍:0~9223372036854775807。 |
—acl | 配置ACL信息。 |
—range | 下載文件時,可以指定文件內容的字節范圍進行下載,字節從0開始編號。1. 可以指定一個區間,例如3-9表示從第3個字節到第9個字節(包含第3和第9字節)。2. 可以指定從什么字段開始,例如3-表示從第3個字節開始到文件結尾(包含第3個字節)。3. 可以指定從什么字段結束,例如-9表示從0字節到第9個字節(包含第9個字節)。 |
—all-versions | 表示對象(Object)所有版本。 |
—type | 計算的類型, 默認值:crc64, 可選值: crc64、md5。 |
-v, —version | 顯示ossutil的版本并退出。 |
-u, —update | 更新操作。 |
—origin | 表示http請求頭origin字段的值。 |
—upmode | 表示上傳模式,缺省值為normal,取值為:normal、append、multipart,分別表示正常上傳、追加上傳、分塊上傳,主要在probe命令中使用。 |
—sse-algorithm | 表示服務端加密算法,可選值:KMS、AES256。 |
—include | 包含對象匹配模式,例如*.jpg。 |
—exclude | 不包含對象匹配模式,例如*.txt。 |
-r, —recursive | 遞歸進行操作。對于支持該選項的命令,當指定該選項時,命令會對Bucket下所有符合條件的Object進行操作,否則只對url中指定的單個Object進行操作。 |
—addr | 表示一個網絡地址,通常為域名,主要在probe命令中使用。 |
—kms-masterkey-id | 表示KMS密鑰托管服務中的主密鑰ID。 |
—version-id | 表示Object的版本ID。 |
—version-id-marker | 表示列舉Object所有版本的version id marker。 |
-m, —multipart | 指定操作的對象為Bucket中未完成的Multipart事件,而非默認情況下的Object。 |
-d, —directory | 返回當前目錄下的文件和子目錄,而非遞歸顯示所有子目錄下的所有Object。 |
—payer | 請求的支付方式,如果為請求者付費模式,可以將該值設置成requester。 |
—maxupspeed | 最大上傳速度,單位:KB/s,缺省值為0(不受限制)。 |
—retry-times | 當錯誤發生時的重試次數,默認值:10,取值范圍:1~500。 |
-c, —config-file | ossutil工具的配置文件路徑,ossutil啟動時從配置文件讀取配置,在config命令中,ossutil將配置寫入該文件。 |
—download | 表示從OSS下載,主要在probe命令中使用。 |
-j, —jobs | 多文件操作時的并發任務數,默認值:3,取值范圍:1~10000。 |
-a, —all-type | 指定操作的對象為Bucket中的Object和未完成的Multipart事件。 |
—disable-empty-referer | 表示不允許referer字段為空,主要在referer命令中使用。 |
—method | 表示http的請求類型,取值為PUT、GET、DELETE等。 |
—output-dir | 指定輸出文件所在的目錄,輸出文件目前包含:cp命令批量拷貝文件出錯時所產生的report文件(關于report文件更多信息,請參考cp命令幫助)。默認值為:當前目錄下的ossutil_output目錄。 |
—meta | 設置Object的meta為[header:value#header:value…],如:Cache-Control:no-cache#Content-Encoding:gzip。 |
—object | 表示OSS中對象的名稱,主要在命令probe中使用。 |
-e, —endpoint | ossutil工具的基本endpoint配置,該選項值會覆蓋配置文件中的相應設置。各地域Endpoint詳情請參見訪問域名和數據中心。 |
—end-time | 值為Linux或Unix系統下面的時間戳,如果輸入這個選項,最后更新時間晚于該時間的Object會被忽略。 |
—limited-num | 返回結果的最大個數。 |
-L, —language | 設置ossutil工具的語言,默認值:CH,可選值:CH、EN,若設置成“CH”,請確保您的系統編碼為UTF-8。 |
—delete | 刪除操作。 |
-b, —bucket | 對Bucket進行操作,該選項用于確認操作作用于Bucket。 |
—disable-crc64 | 該選項關閉crc64,默認情況下,ossutil進行數據傳輸都打開crc64校驗。 |
—upload | 表示上傳到OSS,主要在probe命令中使用。 |
—part-size | 分片大小,單位為Byte,默認情況下ossutil根據文件大小自行計算合適的分片大小值。如果有特殊需求或者需要性能調優,可以設置該值,取值范圍:1~9223372036854775807。 |
—timeout | 簽名url的超時時間,單位為秒,默認值為:60,取值范圍:0~9223372036854775807。 |
—checkpoint-dir | checkpoint目錄的路徑,默認值為:.ossutil_checkpoint,斷點續傳時,操作失敗ossutil會自動創建該目錄,并在該目錄下記錄checkpoint信息,操作成功會刪除該目錄。如果指定了該選項,請確保所指定的目錄可以被刪除。 |
—url | 表示一個url地址,主要在probe命令中使用。 |
—marker | 列舉Bucket或Bucket清單時的marker;列舉Object或Multipart Upload時的key marker。 |
-f, —force | 強制操作,不進行詢問提示。 |
—snapshot-path | 批量上傳/下載時,若指定—snapshot-path選項,ossutil在指定的目錄下生成文件上傳/下載的快照信息,在下一次指定該選項上傳/下載時,ossutil會讀取指定路徑下的快照信息進行增量上傳/下載。注意 1. —snapshot-path選項用于在某些場景下加速增量上傳/下載批量文件(拷貝不支持該選項)。例如文件數較多且兩次上傳期間沒有其他用戶更改OSS上對應的Object。2. —snapshot-path命令通過在本地記錄成功上傳/下載的文件的本地lastModifiedTime,從而在下次上傳/下載時通過比較lastModifiedTime來決定是否跳過相同文件,所以在使用該選項時,請確保兩次上傳/下載期間沒有其他用戶更改了OSS上的對應Object。當不滿足該場景時,如果想要增量上傳/下載批量文件,請使用—update選項。3. ossutil不會主動刪除snapshot-path下的快照信息,為了避免快照信息過多,當您確定快照信息無用時,請自行清理snapshot-path。4. 由于讀寫snapshot信息需要額外開銷,當要批量上傳/下載的文件數比較少或網絡狀況比較好或有其他用戶操作相同Object時,并不建議使用該選項。可以使用—update選項來增量上傳/下載。5. —update選項和—snapshot-path選項可以同時使用,ossutil 會優先根據snapshot-path信息判斷是否跳過此文件,如果不滿足跳過條件,再根據—update判斷是否跳過此文件。 |
—start-time | 值為Linux或Unix系統下面的時間戳,如果輸入這個選項,最后更新時間早于該時間的Object會被忽略。 |
—loglevel | 設置日志級別,默認為空,表示不輸出日志文件,可選值為:info、debug。1. info:輸出提示信息日志。2. debug:輸出詳細信息日志(包括http請求和響應信息)。 |
—storage-class | 設置對象的存儲方式,默認值:Standard,可選值為:Standard、IA、Archive。 |
—parallel | 單文件內部操作的并發任務數,取值范圍:1~10000, 默認將由ossutil根據操作類型和文件大小自行決定。 |
—partition-download | 分區下載使用,一個ossutil命令下載一個分區,其值格式為“分區編號:總分區數“,例如1:5,表示當前ossutil下載分區1,總共有5個分區。分區號從1開始編號,Object的分區規則由工具內部算法決定。利用該選項,待下載的Object分成多個區,可以由多個ossutil命令一起下載完成,每個ossutil命令下載各自的分區。多個ossutil命令可以并行在不同機器上執行。 |
—bucketname | 表示Bucket的名稱,主要在probe命令中使用。 |
—encoding-type | 輸入或者輸出的Object名或文件名的編碼方式,目前只支持url encode,即指定該選項時,取值為url,如果不指定該選項,則表示Object名或文件名未經過編碼。Bucket名不支持url encode。注意 如果指定了該選項,則形如oss://bucket/object的cloud_url,輸入形式為oss://bucket/url_encode(object),其中oss://bucket/字符串不需要編碼。 |
—origin | http請求頭Origin字段的值,表示請求來源域,用來標識跨域請求。 |
—acr-method | http請求頭Access-Control-Request-Method的值,可選值為:GET、PUT、POST、DELETE、HEAD。 |
—acr-headers | http請求頭Access-Control-Request-Headers的值,表示在實際請求中會用到的除簡單頭部之外的頭。如果有多個取值,各個header用英文的逗號(,)分隔,再加上雙引號。例如—acr-headers “header1,header2,header3”。 |
—upload-id-marker | 列舉Multipart Uploads時的uploadID marker。 |
-h, —help | 顯示幫助信息。 |
—proxy-host | 網絡代理服務器的url地址,支持http、https、socks5。 |
—proxy-user | 網絡代理服務器的用戶名,默認為空。 |
—proxy-pwd | 網絡代理服務器的密碼,默認為空。 |
—trafic-limit | 指定http的訪問速度。單位:bit/s,缺省值為0(不受限制),取值范圍為819200~838860800,即100KB/s~100MB/s。用于sign命令。 |
—local-host | 填寫工具的本地IP地址。當您的電腦有多個IP地址的時候,您可以指定此項,ossutil將通過指定IP訪問OSS。用于cp命令。 |
—enable-symlink-dir | 表示上傳鏈接子目錄,默認不上傳。probe命令可以探測是否存在死循環鏈接文件或者目錄。 |
—only-current-dir | 表示只上傳、下載、拷貝當前目錄下的文件,忽略掉當前目錄下的子目錄。 |
—disable-dir-object | 表示上傳文件時不為目錄生成OSS對象。 |
—probe-item | 表示probe命令的探測項目,可選值為:1. upload-speed:探測上傳帶寬。2. download-speed:探測下載帶寬。3. cycle-symlink:探測本地文件目錄中是否存在死循環鏈接文件或者目錄。 |
—redundancy-type | 設置Bucket的數據冗余類型,可選值為LRS(本地冗余存儲)和ZRS(同城冗余存儲),默認為LRS。 |
—disable-encode-slash | 表示不對url path中的正斜線(/)進行編碼。 |
—disable-all-symlink | 上傳時忽略所有的符號鏈接子文件以及符號鏈接子目錄。 |
—tagging | 上傳或復制文件時設置文件的對象標簽,格式為”abc=1&bcd=2&……”。 |
—disable-ignore-error | 批量操作時不忽略錯誤。 |