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