S3CLI 命令行工具：
S3CLI 是一款通過(guò)命令行操作對(duì) S3 進(jìn)行數(shù)據(jù)管理的工具，支持豐富的存儲(chǔ)空間（bucket）以及對(duì)象（object）操作，支持Windows、Linux、Mac平臺(tái)。
通過(guò)本工具，您可以進(jìn)行以下操作： 存儲(chǔ)空間（bucket）：創(chuàng)建、刪除、查看存儲(chǔ)量、查看存儲(chǔ)空間列表等。 對(duì)象（object）：上傳、下載、刪除、移動(dòng)、拉列表、計(jì)算 etag 等。
另外，本工具提供豐富的批量操作：上傳，下載，刪除，拷貝（不同存儲(chǔ)空間之間），移動(dòng)（同一存儲(chǔ)空間內(nèi)），數(shù)據(jù)取回等。
軟件版本：1.7.2
運(yùn)行環(huán)境：Windows（x86 32/64位）；Linux（x86 32/64位，arm 32/64位）；Mac（64位）
下載地址：
1、Windows：us3cli-windows.exe
2、Linux
x86架構(gòu)：us3cli-linux32；us3cli-linux64
arm架構(gòu)：us3cli-arm32；us3cli-arm64
3、Mac：us3cli-mac
Linux環(huán)境（Linux 64位版本）準(zhǔn)備：
1、下載工具至本地。
2、添加可執(zhí)行權(quán)限。
chmod +x us3cli-linux64CopyErrorSuccess
3、開始創(chuàng)建配置。
./us3cli-linux64 configCopyErrorSuccess
Windows環(huán)境準(zhǔn)備：
1、下載工具至本地。
2、以管理員身份打開cmd面板，切換到us3cli-windows.exe文件所在路徑。
3、執(zhí)行config命令創(chuàng)建配置。
us3cli-windows.exe configCopyErrorSuccess
注意事項(xiàng)：
1、請(qǐng)使用管理員身份打開cmd命令行。
2、下載后請(qǐng)不要直接點(diǎn)擊執(zhí)行us3cli-windows.exe文件，該工具需要使用命令行工具打開執(zhí)行。
3、如果點(diǎn)擊下載無(wú)反應(yīng)，請(qǐng)右鍵單擊復(fù)制鏈接地址，輸入到瀏覽器地址輸入框打開。
Mac環(huán)境準(zhǔn)備：
1.下載工具至本地。
2.添加可執(zhí)行權(quán)限。
chmod +x us3cli-macCopyErrorSuccess
3.開始創(chuàng)建配置。
./us3cli-mac config
快速上手：
1、常用配置
命令格式：
us3cli config [--ls][--su <配置名>][--rm <配置名>][--cat <配置名>][--encrypt][--ssl][--proxy [代理地址]] [--accesskey <API/Token公鑰>][--secretkey <API/Token私鑰>][--endpoint <訪問(wèn)域名>] [--language <ZH/EN]CopyErrorSuccess
常用配置創(chuàng)建方式分為兩種：交互式配置和一鍵配置，命令格式相同，使用方式不同
1.1、配置項(xiàng)創(chuàng)建
交互式配置：
使用示例：
#./us3cli config請(qǐng)輸入語(yǔ)言(Please enter the language): ZH/EN, 默認(rèn)為ZH(default is ZH) :ZH請(qǐng)輸入當(dāng)前配置項(xiàng)名稱: config1開始創(chuàng)建新配置項(xiàng)：[ config1 ]是否啟用配置加密(y or n) ? n請(qǐng)輸入API/Token公鑰[當(dāng)前:]: xxxxxxxxxxxxxxxxxxxxxx請(qǐng)輸入API/Token私鑰[當(dāng)前:]: xxxxxxxxxxxxxxxxxxxxxx地區(qū)列表：No. RegionName Region 0 北京 cn-bj 1 上海二 cn-sh2 2 廣州 cn-gd 3 香港 hk 4 洛杉磯 us-ca 5 新加坡 sg 6 雅加達(dá) idn-jakarta 7 臺(tái)北 tw-tp 8 拉各斯 afr-nigeria 9 圣保羅 bra-saopaulo10 迪拜 uae-dubai 11 法蘭克福 ge-fra 12 胡志明市 vn-sng 13 華盛頓 us-ws 14 孟買 ind-mumbai 15 首爾 kr-seoul16 東京 jpn-tky17 曼谷 th-bkk18 華北二 cn-wlcb19 英國(guó) uk-london 請(qǐng)輸入region編號(hào): 0內(nèi)外網(wǎng)列表：No. Network0 外網(wǎng) 1 內(nèi)網(wǎng) 請(qǐng)選擇或輸入內(nèi)外網(wǎng)編號(hào)：0您選擇的endpoint是：[cn-bj.ufileos.com],[當(dāng)前:]，請(qǐng)輸入回車確認(rèn)或自定義endponit：當(dāng)前最終配置：ConfigName: config1AccessKey: xxxxxxxxxxxxxxxxxxxxxxSecretKey: xxxxxxxxxxxxxxxxxxxxxxEndpoint: cn-bj.ufileos.com請(qǐng)檢查后輸入回車確認(rèn)：是否啟用HTTPS (y or n) ? n是否啟用代理(y or n):n配置文件 [ config1 ] 已修改是否使用該配置作為默認(rèn)配置(當(dāng)前默認(rèn)配置為：< config >)(y or n)?CopyErrorSuccess
一鍵配置：
使用示例:
./us3cli config config1 --accesskey TOKEN_13be86********* --secretkey BAtrQO8LYdgve1HS_benbK-MXNTl3********** --endpoint cn-bj.ufileos.com --language ZHCopyErrorSuccess
1.2、配置項(xiàng)管理
#切換默認(rèn)配置./us3cli config --su config1#刪除指定配置（只支持指定配置項(xiàng)名稱刪除，不支持指定路徑）./us3cli config --rm config1#配置項(xiàng)內(nèi)容查看，包含accesskey、secretkey、endpoint./us3cli config --cat config1#查看當(dāng)前所有配置項(xiàng)列表，默認(rèn)配置會(huì)標(biāo)明 "(default)",Authority表示當(dāng)前配置是Token密鑰類型還是API密鑰類型(只判斷類型，不進(jìn)行權(quán)限驗(yàn)證)./us3cli config --lsCopyErrorSuccess
2、臨時(shí)配置
臨時(shí)配置可以通過(guò)配置名、配置文件路徑、配置項(xiàng)內(nèi)容使用，具體示例如下:
#1.通過(guò)配置名指定臨時(shí)配置./us3cli ls us3://bucket1 --config config2#2.通過(guò)配置文件路徑指定臨時(shí)配置./us3cli ls us3://bucket1 --config ~/go/src/userconfig.yaml#3.通過(guò)配置項(xiàng)內(nèi)容直接指定臨時(shí)配置./us3cli ls us3://bucket1 --accesskey "xxxxxx" --secretkey "xxxxxx" --endpoint "xxxxxx"CopyErrorSuccess
注:當(dāng)前版本支持自定義配置文件，但只支持與工具自動(dòng)生成配置文件內(nèi)容相同的配置文件
自定義配置文件內(nèi)容如下,具體填寫說(shuō)明見常用命令頁(yè)config命令介紹
accesskey: "user accesskey"secretkey: "user secretkey"endpoint: "ufile.cn-north-02.ucloud.cn"encrypt: "false"enablessl: "false"proxy: "http://ip:port or https://ip:port"language: "ZH"CopyErrorSuccess
3、創(chuàng)建存儲(chǔ)空間
3.1、交互式創(chuàng)建
命令格式:us3cli mb us3://<bucketname> 使用示例：# ./us3cli mb us3://bucketTest請(qǐng)輸入要?jiǎng)?chuàng)建bucket的權(quán)限類型acl(private/public,默認(rèn)為private):private 地區(qū)列表：No. RegionName Region 0 北京 cn-bj 1 上海二 cn-sh2 2 廣州 cn-gd 3 香港 hk 4 洛杉磯 us-ca 5 新加坡 sg 6 雅加達(dá) idn-jakarta 7 臺(tái)北 tw-tp 8 拉各斯 afr-nigeria 9 圣保羅 bra-saopaulo10 迪拜 uae-dubai 11 法蘭克福 ge-fra 12 胡志明市 vn-sng 13 華盛頓 us-ws 14 孟買 ind-mumbai 15 首爾 kr-seoul16 東京 jpn-tky17 曼谷 th-bkk18 華北二 cn-wlcb19 英國(guó) uk-london 請(qǐng)輸入要?jiǎng)?chuàng)建bucket地區(qū)編號(hào)或地區(qū)代碼(默認(rèn)為北京:cn-bj):0Region: cn-bj當(dāng)前賬號(hào)下項(xiàng)目信息如下：No. ProjectName ProjectId 1 Default org-orcwsj請(qǐng)輸入要?jiǎng)?chuàng)建bucket的項(xiàng)目編號(hào):1Number: 1ProjectID: org-orcwsj2020-11-24 17:52:56.973 INFO Make bucket [ bucketTest ] successCopyErrorSuccess
3.2、一鍵創(chuàng)建
#命令格式：us3cli mb us3://<bucketname> --projectid <projectid> --region <region> --acl <acl> #使用示例：./us3cli mb us3://buckettest --projectid org-test --region cn-bj --acl publicCopyErrorSuccess
4、上傳文件或文件夾
4.1、上傳單個(gè)文件
#命令格式：#普通文件us3cli cp <local filename> us3://<bucketname>/<us3key> #流式文件us3cli rcat us3://<bucketname>/<us3key> #使用示例：#普通上傳文件，不指定任何參數(shù)./us3cli cp ./test.txt us3://buckettest/test.txt#指定存儲(chǔ)類型為IA上傳 (不區(qū)分大小寫)./us3cli cp ./test.txt us3://buckettest/test.txt --storageclass IA#指定并發(fā)數(shù)，設(shè)置并發(fā)數(shù)為10(文件大于64MB時(shí)才會(huì)有效果,因?yàn)?4MB以上大文件才會(huì)使用分片上傳)./us3cli cp ./test.txt us3://buckettest/test.txt --parallel 10#將本地文件test.txt cat到標(biāo)準(zhǔn)輸入，再上傳至us3存儲(chǔ)空間內(nèi)cat test.txt | ./us3cli rcat us3://buckettest/test.txt#流式上傳并指定失敗重試次數(shù)為10，設(shè)置并發(fā)數(shù)為10cat test.txt | ./us3cli rcat us3://buckettest/test.txt --retrycount 10 --parallel 10CopyErrorSuccess
4.2、上傳文件夾
#命令格式：us3cli cp -r <localdir> us3://<bucketname>/<us3key> #使用示例:#普通上傳文件夾./us3cli cp -r ./testdir us3://buckettest/us3dir#上傳后綴名為“.txt"的文件./us3cli cp -r ./testdir us3://buckettest/us3dir --include "*txt"#上傳文件名不包含test的文件./us3cli cp -r ./testdir us3://buckettest/us3dir --exclude "*test*"#上傳文件夾并進(jìn)行完整性校驗(yàn)./us3cli cp -r ./testdir us3://buckettest/us3dir --checkCopyErrorSuccess
4.3、增量上傳文件夾
增量上傳文件夾：對(duì)比本地文件夾和us3對(duì)應(yīng)的文件夾，忽略已上傳的文件，將未上傳過(guò)的文件上傳到us3文件夾內(nèi)
#命令格式:us3cli sync <localdir> us3://<bucketname>/<us3key> #使用示例:#遍歷本地文件夾，以本地緩存為標(biāo)準(zhǔn)進(jìn)行同步，如果文件修改時(shí)間晚于本地緩存保存的時(shí)間，或者未保存過(guò)，則上傳文件，否則跳過(guò)./us3cli sync ./testdir us3://buckettest/us3dir#遍歷本地文件夾，以本地緩存為標(biāo)準(zhǔn)進(jìn)行同步，如果文件etag和本地緩存保存的etag不同，則上傳文件，否則跳過(guò)./us3cli sync ./testdir us3://buckettest/us3dir --ruler etag#遍歷本地文件夾，對(duì)比本地和us3所有文件，如果文件修改時(shí)間晚于us3文件的修改時(shí)間，則上傳文件，否則跳過(guò)#如果存在文件在us3的目錄下存在，但在本地不存在，則刪除us3中的該文件（該刪除操作會(huì)默認(rèn)詢問(wèn)，目前不提供強(qiáng)制刪除功能）./us3cli sync ./testdir us3://buckettest/us3dir --mode local#遍歷本地文件夾，對(duì)比本地和us3所有文件，如果文件etag和us3同一文件的etag不同，則上傳文件，否則跳過(guò)./us3cli sync ./testdir us3://buckettest/us3dir --mode local --ruler etag#增量上傳并指定存儲(chǔ)類型為低頻類型./us3cli sync ./testdir us3://buckettest/us3dir --storageclass ”IA“#增量上傳并指定mimetype./us3cli sync ./testdir us3://buckettest/us3dir --mimetype "mimetype1"CopyErrorSuccess
5、下載文件或文件夾
5.1、下載單個(gè)文件
#命令格式：#普通下載us3cli cp us3://<bucketname>/<us3key> <local filename> #流式下載us3cli cat us3://<bucketname>/<us3key> #使用示例：#普通下載單個(gè)文件./us3cli cp us3://buckettest/test.txt ./test.txt#下載文件，每個(gè)分片大小指定為8M(不區(qū)分大小寫，并且默認(rèn)大小為4M，最小值為4M)./us3cli cp us3://buckettest/test.txt ./test.txt --partsize 4M#流式文件下載(文件會(huì)寫入到標(biāo)準(zhǔn)輸入)./us3cli cat us3://buckettest/test.txt#流式下載并指定并發(fā)數(shù)，重試次數(shù)為10./us3cli cat us3://buckettest/test.txt --parallel 10 --retrycount 10CopyErrorSuccess
5.2、下載文件夾
#命令格式：us3cli cp -r us3://<bucketname>/<us3key> <localdir> #使用示例:#普通下載文件夾./us3cli cp -r us3://buckettest/us3dir ./testdir#下載文件夾并指定并發(fā)數(shù)為20./us3cli cp -r us3://buckettest/us3dir ./testdir --parallel 20#下載文件夾并限速為100MB/s./us3cli cp -r us3://buckettest/us3dir ./testdir --speedlimit 100MBCopyErrorSuccess
6、拷貝文件或文件夾
#命令格式us3cli cp us3://<bucketname>/<us3key> #使用示例#將文件從bucket1拷貝至bucket2中（兩個(gè)bucket必須在同一地域中，如需要不同地域的數(shù)據(jù)復(fù)制，則需要使用跨區(qū)域復(fù)制功能）./us3cli cp us3://bucket1/test.txt us3://bucket2/test.txt#將文件夾從bucket1拷貝到bucket2中./us3cli cp -r us3://bucket1/test us3://bucket2/test#將bucket1中test文件夾中以".txt"結(jié)尾的文件拷貝到bucket2的test文件夾中./us3cli cp -r us3://bucket1/test us3://bucket2/test --include "*.txt"CopyErrorSuccess
7、刪除文件或文件夾
7.1、刪除單個(gè)文件
#命令格式：us3cli rm us3://<bucketname>/<us3key> #使用示例：#刪除文件./us3cli rm us3://buckettest/test.txt#強(qiáng)制刪除./us3cli rm -f us3://buckettest/test.txtCopyErrorSuccess
7.2、刪除文件夾
#命令格式：us3cli rm -r us3://<bucketname>/<us3key> #使用示例：#刪除文件夾./us3cli rm -r us3://buckettest/test#強(qiáng)制刪除整個(gè)test文件夾./us3cli rm -r -f us3://buckettest/test#刪除test文件夾下不含有test的文件./us3cli rm -r -f us3://buckettest/test --exclude "*test*"#設(shè)置并發(fā)數(shù)為10，強(qiáng)制清空當(dāng)前buckettest存儲(chǔ)空間./us3cli rm -r -f us3://buckettest --parallel 10 #刪除文件夾，限制請(qǐng)求數(shù)量為每秒10個(gè)./us3cli rm -r -f us3://buckettest/test --qps 10CopyErrorSuccess
8、查詢文件基本信息
#命令格式us3cli stat us3://<bucketname>/<us3key> #使用示例./us3cli stat us3://buckettest/test.txtCopyErrorSuccess
9、獲取文件列表
#命令格式us3cli ls us3://<bucketname>[/us3key]#使用示例./us3cli ls us3://buckettest#拉取buckettest中的文件，只顯示10個(gè)./us3cli ls us3://buckettest --limit 10#拉取buckettest中的文件，并以非目錄形式展示#非目錄形式：目錄下所有的文件都顯示完整路徑，子目錄下的文件也會(huì)列出./us3cli ls us3://buckettest --flat#列取buckettest中的文件，并展示是否已取回，以及取回時(shí)間#數(shù)據(jù)取回：指歸檔類型的數(shù)據(jù)短暫激活，可以下載./us3cli ls us3://buckettest --restoreCopyErrorSuccess
10、文件基本信息修改
#命令格式us3cli modify us3://<bucketname>/us3key#使用示例#修改文件mimetype為xxx/yyy./us3cli modify us3://buckettest/test.txt --mimetype xxx/yyy#為文件增加metadata key為 "name" value為 "us3cli"./us3cli modify us3://buckettest/test.txt --metadata name=us3cli#清空當(dāng)前文件的metadata./us3cli modify us3://buckettest/test.txt --metadata "" --replace#修改文件的存儲(chǔ)類型為ARCHIVE(歸檔類型)./us3cli modify us3://buckettest/test.txt --storageclass ARCHIVE
常用命令：
| 操作 | 命令 | 描述 |
|---|
| 配置管理 | config | 管理上傳所需的公私鑰及endpoint等信息，包括配置項(xiàng)的創(chuàng)建、修改、刪除、更新、切換 |
| 創(chuàng)建存儲(chǔ)空間 | mb | 創(chuàng)建存儲(chǔ)空間 |
| 刪除存儲(chǔ)空間 | rb | 刪除存儲(chǔ)空間（存儲(chǔ)空間為空） |
| 查看存儲(chǔ)空間信息 | stat | 查看bucket的元數(shù)據(jù)信息 |
| 查看存儲(chǔ)量 | du | 查看bucket的存儲(chǔ)量（標(biāo)準(zhǔn)、低頻、歸檔） |
| 普通上傳 | cp | 將本地文件或目錄上傳到存儲(chǔ)空間中 |
| 增量上傳 | sync | 增量上傳目錄到存儲(chǔ)空間中 |
| 流式上傳 | rcat | 將流式文件上傳到存儲(chǔ)空間中 |
| 創(chuàng)建目錄 | mkdir | 在us3存儲(chǔ)空間中創(chuàng)建一個(gè)空目錄 |
| 普通下載 | cp | 將存儲(chǔ)空間中的文件或目錄下載到本地 |
| 流式下載 | cat | 將存儲(chǔ)空間中的數(shù)據(jù)下載并寫入到標(biāo)準(zhǔn)輸入中 |
| 拷貝 | cp | 將一個(gè)存儲(chǔ)空間中的文件拷貝到另一個(gè)存儲(chǔ)空間中（同一地域） |
| 移動(dòng) | mv | 將文件或目錄移動(dòng)到其他目錄下（同一存儲(chǔ)空間內(nèi)） |
| 刪除 | rm | 刪除存儲(chǔ)空間中的文件或目錄 |
| 列表 | ls | 列出US3存儲(chǔ)空間列表或US3存儲(chǔ)空間中的文件列表 |
| 獲取下載URL | sign | 獲取存儲(chǔ)空間中文件的下載鏈接 |
| 查看元數(shù)據(jù) | stat | 查看存儲(chǔ)空間中文件的元數(shù)據(jù)信息 |
| 修改元數(shù)據(jù) | modify | 修改存儲(chǔ)空間中文件的存儲(chǔ)類型、MIMETYPE、MetaData |
| 歸檔數(shù)據(jù)取回 | restore | 將歸檔類型的文件激活為可下載狀態(tài) |
| 數(shù)據(jù)完整性校驗(yàn) | etag | 查看本地文件、標(biāo)準(zhǔn)輸出、US3存儲(chǔ)空間的文件etag |
| 創(chuàng)建token | create-token | 創(chuàng)建一個(gè)用于操作US3的token |
| 刪除token | delete-token | 刪除一個(gè)用于操作US3的token |
| 更新token | update-token | 更新一個(gè)用于操作US3的token |
| 描述token | describe-token | 列取并描述操作US3的token |
| 版本更新 | update | 更新工具版本 |
| 版本特性 | version | 查看工具版本特性 |
config
config命令用于管理配置文件。
命令格式
us3cli config [--ls][--su <配置名>][--rm <配置名>][--cat <配置名>][--encrypt][--ssl][--proxy [代理地址]] [--accesskey <API/Token公鑰>][--secretkey <API/Token私鑰>][--endpoint <訪問(wèn)域名>] [--language <ZH/EN>]CopyErrorSuccess
參數(shù)說(shuō)明
-a, --accesskey string :用于訪問(wèn)us3的API密鑰或Token公鑰 --cat string :打印指定配置項(xiàng)內(nèi)容 --encrypt :是否配置加密 --language :us3cli的語(yǔ)言配置,ZH/EN,可選,默認(rèn)為ZH中文 -e, --endpoint string :固定域名，可在地域和域名頁(yè)查看 -h, --help :查看當(dāng)前命令幫助 --ls :列出當(dāng)前所有配置項(xiàng) --proxy string :代理地址(ip:port) --rm string :刪除指定配置項(xiàng) -s, --secretkey string :用于訪問(wèn)us3的API私鑰或Token私鑰 --ssl :使用https --su string :切換指定配置為默認(rèn)配置CopyErrorSuccess
配置文件內(nèi)容說(shuō)明：
| 配置項(xiàng) | 說(shuō)明 | 填寫說(shuō)明 |
|---|
| AccessKey | 用于鑒權(quán)的bucket公鑰 | API公鑰 、Token公鑰 |
| SecretKey | 用于鑒權(quán)的bucket私鑰 | API私鑰 、Token私鑰 |
| Endpoint | 外網(wǎng)或內(nèi)網(wǎng)域名 | 地域和域名 |
| encrypt | 是否使用配置加密 | false 或 true |
| enablessl | 是否使用https | false 或 true |
| proxy | 代理地址 | “ip:port” |
| language | 工具顯示語(yǔ)言 | ZH 或 EN |
自定義配置文件格式，填寫說(shuō)明同上：
accesskey: "user accesskey"secretkey: "user secretkey"endpoint: "ufile.cn-north-02.ucloud.cn"encrypt: "false"enablessl: "false"proxy: "http://ip:port or https://ip:port"language: "EN"CopyErrorSuccess
使用示例
1.交互式配置
創(chuàng)建配置項(xiàng)
#./us3cli config請(qǐng)輸入語(yǔ)言(Please enter the language): ZH/EN, 默認(rèn)為ZH(default is ZH) : ZH請(qǐng)輸入當(dāng)前配置項(xiàng)名稱: config1開始創(chuàng)建新配置項(xiàng)：[ config1 ]是否啟用配置加密(y or n) ? n請(qǐng)輸入API/Token公鑰[當(dāng)前:]: xxxxxxxxxxxxxxxxxxxxxx請(qǐng)輸入API/Token私鑰[當(dāng)前:]: xxxxxxxxxxxxxxxxxxxxxx地區(qū)列表：No. RegionName Region 0 華北一 cn-bj 1 上海二 cn-sh2 2 廣州 cn-gd 3 香港 hk 4 洛杉磯 us-ca 5 新加坡 sg 6 雅加達(dá) idn-jakarta 7 臺(tái)北 tw-tp 8 拉各斯 afr-nigeria 9 圣保羅 bra-saopaulo10 迪拜 uae-dubai 11 法蘭克福 ge-fra 12 胡志明市 vn-sng 13 華盛頓 us-ws 14 孟買 ind-mumbai 15 首爾 kr-seoul16 東京 jpn-tky17 曼谷 th-bkk18 華北二 cn-wlcb19 英國(guó) uk-london請(qǐng)輸入region編號(hào): 0內(nèi)外網(wǎng)列表：No. Network0 外網(wǎng) 1 內(nèi)網(wǎng) 請(qǐng)選擇或輸入內(nèi)外網(wǎng)編號(hào)：0您選擇的endpoint是：[cn-bj.ufileos.com],[當(dāng)前:]，請(qǐng)輸入回車確認(rèn)或自定義endponit：當(dāng)前最終配置：ConfigName: config1AccessKey: xxxxxxxxxxxxxxxxxxxxxxSecretKey: xxxxxxxxxxxxxxxxxxxxxxEndpoint: cn-bj.ufileos.com請(qǐng)檢查后輸入回車確認(rèn)：是否啟用HTTPS (y or n) ? n是否啟用代理(y or n):n配置文件 [ config1 ] 已修改是否使用該配置作為默認(rèn)配置(當(dāng)前默認(rèn)配置為：< config >)(y or n)?CopyErrorSuccess
注意：
1.首次創(chuàng)建的配置文件時(shí)會(huì)自動(dòng)將該配置作為默認(rèn)配置
2.配置加密只加密到公私鑰，并且當(dāng)前配置文件只在初次創(chuàng)建時(shí)可選是否加密
3.填寫代理地址時(shí)只需要填寫“ ip:port”,客戶端會(huì)根據(jù)填寫的https啟用狀態(tài)補(bǔ)充需要的"https://"或“http://”頭部信息
列出配置項(xiàng)列表
./us3cli config --lsConfigName ModTime FilePath Authority config1 (Default) 2020-09-21 14:18:50 /root/.us3cliconfig/config1 Token config2 2020-09-21 14:18:50 /root/.us3cliconfig/config2 Token us3cli 2020-09-16 10:36:00 /root/.us3cliconfig/us3cli APIKeyCopyErrorSuccess
說(shuō)明：
1.Default標(biāo)識(shí)表示該配置項(xiàng)是當(dāng)前的默認(rèn)配置
2.Authority表示權(quán)限分類，只用于快速區(qū)分Token和API密鑰格式，不保證內(nèi)容準(zhǔn)確
切換配置項(xiàng)
./us3cli config --su config2CopyErrorSuccess
刪除配置項(xiàng)
./us3cli config --rm config1CopyErrorSuccess
注意：以下所有命令的（y or n）選項(xiàng)規(guī)則均不區(qū)分大小寫，輸入yes或y表示確認(rèn)，其他選項(xiàng)均表示取消
打印配置項(xiàng)
./us3cli config --cat config2ConfigName：config2AccessKey: TOKEN_13be86*********SecretKey: BAtrQO8LYdgve1HS_benbK-MXNTl3**********Endpoint: cn-bj.ufileos.comLanguage: ZHCopyErrorSuccess
2.非交互式配置
./us3cli config config3 --accesskey TOKEN_AAGASGAZVZV**** --secretkey USAsflmTAAF****** --endpoint cn-bj.ufileos.com --language ENConfiguration file [ config3 ] has been updatedCopyErrorSuccess
3.臨時(shí)使用（對(duì)其他命令生效）
上傳文件時(shí)臨時(shí)使用配置項(xiàng)config3
./us3cli cp test.txt us3://bucket1 --config config3CopyErrorSuccess
上傳文件時(shí)臨時(shí)使用配置文件 /home/ubuntu/myconfig1
./us3cli cp test.txt us3://bucket1 --config /home/ubuntu/myconfig1CopyErrorSuccess
上傳文件時(shí)使用自定義配置內(nèi)容
./us3cli cp test.txt us3://bucket1 --accesskey LTAI4G3t3BTza47xxxxxxxxxx --secretkey gznFs9daMtKmUaTq9xpxxxxxxxxxxxxx --endpoint cn-bj.ufileos.comCopyErrorSuccess
mb
該命令用于創(chuàng)建存儲(chǔ)空間
命令格式
us3cli mb us3://<桶名字> [--acl <權(quán)限類型>][--region <桶所在地區(qū)>][--projectid <項(xiàng)目ID>]CopyErrorSuccess
參數(shù)說(shuō)明
--accesskey <string> :用于訪問(wèn)us3的API公鑰或Token公鑰 -a, --acl <string> :權(quán)限類型，可以設(shè)置為private、public，默認(rèn)為private私有(不區(qū)分大小寫) --config <string> :當(dāng)前命令臨時(shí)指定配置名/配置文件路徑 --endpoint <string> :固定域名，可通過(guò)地域和域名頁(yè)查看,如：cn-bj.ufileos.com -h, --help :當(dāng)前命令使用說(shuō)明 --projectid <string> :項(xiàng)目ID，當(dāng)前bucket屬項(xiàng)目ID，默認(rèn)為Default -r, --region <string> :桶所在地區(qū)，可查看地域信息，默認(rèn)地區(qū)為華北一 --secretkey <string> :用于訪問(wèn)us3的API私鑰或Token私鑰CopyErrorSuccess
本命令提供命令輸入和交互式輸入二選一的操作，命令輸入?yún)?shù)，就會(huì)自動(dòng)跳過(guò)交互式輸入。
使用示例
交互式創(chuàng)建bucket
./us3cli mb us3://us3cli-test請(qǐng)輸入要?jiǎng)?chuàng)建bucket的權(quán)限類型acl(private/public,默認(rèn)為private):public地區(qū)列表：No. RegionName Region 0 華北一 cn-bj 1 上海二 cn-sh2 2 廣州 cn-gd 3 香港 hk 4 洛杉磯 us-ca 5 新加坡 sg 6 雅加達(dá) idn-jakarta 7 臺(tái)北 tw-tp 8 拉各斯 afr-nigeria 9 圣保羅 bra-saopaulo10 迪拜 uae-dubai 11 法蘭克福 ge-fra 12 胡志明市 vn-sng 13 華盛頓 us-ws 14 孟買 ind-mumbai 15 首爾 kr-seoul16 東京 jpn-tky17 曼谷 th-bkk18 華北二 cn-wlcb19 英國(guó) uk-london 請(qǐng)輸入要?jiǎng)?chuàng)建bucket地區(qū)編號(hào)或地區(qū)代碼(默認(rèn)為華北一:cn-bj):0Region: cn-bj當(dāng)前賬號(hào)下業(yè)務(wù)組分組信息如下：No. ProjectName ProjectId 1 Default org-orcwsj請(qǐng)輸入要bucket的項(xiàng)目編號(hào):1Number: 1ProjectID: org-orcwsjMake bucket [ us3cli-test ] successCopyErrorSuccess
非交互式創(chuàng)建bucket,輸入acl，region以及projectid信息，acl,region是必填項(xiàng)，projectid可不填
./us3cli mb us3://us3cli-test --acl private --region cn-bj --projectid org-orcwsyCopyErrorSuccess
注意：若您的bucket不在默認(rèn)項(xiàng)目下，bucket操作都需要加上--projectid參數(shù)，請(qǐng)創(chuàng)建bucket時(shí)自行記錄projectid，或通過(guò) ls 命令查看projectid
rb
本命令用于刪除存儲(chǔ)空間
命令格式
us3cli rb us3://<桶名字> [--projectid <項(xiàng)目ID>][--force]CopyErrorSuccess
參數(shù)說(shuō)明
--accesskey <string> :用于訪問(wèn)us3的API公鑰或Token公鑰 --config <string> :當(dāng)前命令臨時(shí)指定配置名/配置文件路徑 --endpoint <string> :固定域名，可通過(guò)地域和域名頁(yè)查看 -f, --force :強(qiáng)制刪除 -h, --help :當(dāng)前命令使用說(shuō)明 --projectid <string> :指定當(dāng)前bucket所在projectid，可以在控制臺(tái)查看，默認(rèn)項(xiàng)目可忽略 --secretkey <string> :用于訪問(wèn)us3的API私鑰或Token私鑰CopyErrorSuccess
使用示例
刪除存儲(chǔ)空間:存儲(chǔ)空間必須為空，否則無(wú)法刪除
./us3cli rb us3://bucket1The bucket [bucket1] is being deleted, continue(y or n)? yDelete bucket [bucket1] successCopyErrorSuccess
stat
本命令用于查看存儲(chǔ)空間或文件信息
命令格式
us3cli stat us3://<桶名字>[/<文件key>][--projectid <項(xiàng)目ID>]CopyErrorSuccess
參數(shù)說(shuō)明
--accesskey <string> :用于訪問(wèn)us3的API公鑰或Token公鑰 --config <string> :當(dāng)前命令臨時(shí)指定配置名/配置文件路徑 --endpoint <string> :固定域名，可通過(guò)地域和域名頁(yè)查看 -h, --help :當(dāng)前命令使用說(shuō)明 --projectid <string> :指定當(dāng)前bucket所在projectid，可以在控制臺(tái)查看，默認(rèn)項(xiàng)目可忽略CopyErrorSuccess
使用示例
查看默認(rèn)項(xiàng)目下存儲(chǔ)空間bucket1的基本信息
./us3cli stat us3://bucket1BucketName: bucket1 Region: cn-bj BucketId: ufile-dpgjzcn Type: public CreateTime: 2020-09-15 18:17:24ModifyTime: 2020-09-15 18:17:24CopyErrorSuccess
查看us3://bucket1/test.txt的文件信息
./us3cli stat us3://bucket1/aaa.txtName: aaa.txt X-Ufile-Create-Time: Fri, 18 Sep 2020 10:09:05 GMT X-Ufile-Storage-Class: STANDARD Server: nginx/1.11.1 Date: Mon, 21 Sep 2020 11:17:56 GMT Content-Type: application/octet-stream Accept-Ranges: bytes Etag: "AQAAAEpjpDD8COEdGg3uOeLfsR_ddQgc"Content-Length: 4298 Last-Modified: Fri, 18 Sep 2020 10:09:05 GMT Vary: OriginCopyErrorSuccess
du
該命令用于獲取指定存儲(chǔ)空間(Bucket)各存儲(chǔ)類型的存儲(chǔ)量大小，以及總存儲(chǔ)量
注意：存儲(chǔ)量結(jié)算時(shí)間為當(dāng)前日期前一天0:00
命令格式
us3cli du us3://<桶名字>[/<key>] [--force][--projectid <項(xiàng)目ID>]CopyErrorSuccess
參數(shù)說(shuō)明
--accesskey <string> :用于訪問(wèn)us3的API公鑰或Token公鑰 --config <string> :當(dāng)前命令臨時(shí)指定配置名/配置文件路徑 --endpoint <string> :固定域名，可通過(guò)地域和域名頁(yè)查看 -f, --force :強(qiáng)制更新存儲(chǔ)量 -h, --help :當(dāng)前命令使用說(shuō)明 --projectid <string> :指定當(dāng)前bucket所在projectid，可以在控制臺(tái)查看，默認(rèn)項(xiàng)目可忽略CopyErrorSuccess
使用示例
查看bucket1所占空間大小，內(nèi)容包含各存儲(chǔ)類型的存儲(chǔ)量以及總存儲(chǔ)量
StorageClass Size STANDARD: 1.05 GBIA: 0 GB ARCHIVE: 0 GB Total storage: 1.05 GBCopyErrorSuccess
查看bucket1下的testfolder目錄下各類型存儲(chǔ)量以及文件數(shù)量
#./us3cli du us3://bucket1/testfolder FileCount FileSizeSum 10000 99.77 MB STANDARD 10000 99.77 MB IA 0 0 B ARCHIVE 0 0 B UpdateTime: 2020-12-24 11:40:27 ThuCopyErrorSuccess
注意:當(dāng)使用命令首次查看某個(gè)目錄或前綴下的存儲(chǔ)量時(shí)，會(huì)將數(shù)據(jù)保存在本地，24內(nèi)使用非強(qiáng)制更新查看存儲(chǔ)量時(shí)，都不會(huì)重新請(qǐng)求，只顯示前24小時(shí)內(nèi)拉取到的最新數(shù)據(jù)。有更新需要的可以添加-f/--force選項(xiàng)再次拉取存儲(chǔ)量。
cp
該命令用于上傳、下載、拷貝文件
命令格式
上傳文件
us3cli cp <本地文件路徑> us3://<桶名字>/<文件Key> [--check][--recursive][--reduce][--parallel <分片上傳并發(fā)數(shù)>][--speedlimit <速度限制>][--storageclass <存儲(chǔ)類型>][--exclude <通配符表達(dá)式>][--rexclude <正則表達(dá)式>][--include <通配符表達(dá)式>][--rinclude <正則表達(dá)式>][--metadata <Key>=<value1>[,<key2>=<value2>]...][--mimetype <多媒體文件格式>]CopyErrorSuccess
下載文件
us3cli cp us3://<桶名字>/<文件Key> <本地文件路徑> [--recursive][--reduce][--speedlimit <速度限制>][--exclude <通配符表達(dá)式>][--rexclude <正則表達(dá)式>][--include <通配符表達(dá)式>][--rinclude <正則表達(dá)式>][--parallel <分片下載并發(fā)數(shù)>][--partsize <下載分片大小>]CopyErrorSuccess
拷貝文件
us3cli cp us3://<桶名字>/<文件Key> us3://<桶名字>/<文件Key> [--recursive][--reduce][--exclude <通配符表達(dá)式>][--rexclude <正則表達(dá)式>][--include <通配符表達(dá)式>][--rinclude <正則表達(dá)式>][--metadata <Key>=<value1>[,<key2>=<value2>]...]CopyErrorSuccess
參數(shù)說(shuō)明
--accesskey <string> :用于訪問(wèn)us3的API公鑰或Token公鑰 -c, --check :用于上傳文件夾結(jié)束后檢查已上傳文件的etag是否一致 --config <string> :當(dāng)前命令臨時(shí)指定配置名/配置文件路徑 --endpoint <string> :固定域名，可通過(guò)地域和域名頁(yè)查看 --exclude <string> :不包含當(dāng)前通配符的文件名 -h, --help :當(dāng)前命令使用說(shuō)明 --include <string> :包含當(dāng)前通配符的文件名 --metadata <string> :指定元數(shù)據(jù)信息(該參數(shù)僅限上傳和拷貝) 多個(gè)元數(shù)據(jù)以","分隔，如 "key1=value,key2=value2",其他分隔符暫不支持 --mimetype <string> :指定mimetype(該參數(shù)僅限上傳) --parallel <int> :分片并發(fā)數(shù)或批量并發(fā)數(shù) --partsize <string> :下載分片大小，默認(rèn)大小為4M，最小值為1M(該參數(shù)僅限下載) -r, --recursive :遞歸文件夾中的所有文件及子目錄下所有文件 --reduce :是否以精簡(jiǎn)模式執(zhí)行（不展示進(jìn)度） --rexclude <string> :不包含當(dāng)前正則表達(dá)式的文件名 --rinclude <string> :包含當(dāng)前正則表達(dá)式的文件名 --secretkey <string> :用于訪問(wèn)us3的API私鑰或Token私鑰 -s, --speedlimit <string> :平均速度限制(單位可以是B,KB,MB，不帶單位默認(rèn)以B/s計(jì)算)，默認(rèn)200MB/s --storageclass <string> :指定存儲(chǔ)類型,對(duì)應(yīng)有效值：STANDARD, IA, ARCHIVE(該參數(shù)僅限上傳)，默認(rèn)值：STANDARDCopyErrorSuccess
注意：
1.通配符表達(dá)式暫時(shí)只支持“*”,"?"兩種字符，并且需要注意的是，四種表達(dá)式篩選均以當(dāng)前目錄下文件路徑為準(zhǔn)
如：us3://us3cli/test 目錄下的test2/test3.txt 會(huì)以test2/test3.txt作為字符串篩選，而不是以test3.txt作為字符串進(jìn)行篩選
2.以下所有speedlimit選項(xiàng)均描述為平均速度
3.單個(gè)文件上傳時(shí)根據(jù)文件大小使用不同的請(qǐng)求，文件大于64MB使用分片上傳，小于64MB時(shí)使用普通的put請(qǐng)求，故上傳中的parallel參數(shù)僅限上傳64MB以上大文件使用
4.由于windows環(huán)境下文件名存在不區(qū)分大小寫的情況，要下載的文件已存在時(shí)，會(huì)在文件名及文件后綴名之間默認(rèn)添加(1),(2)...等作為文件名后綴，如：
文件test.txt存在，則下載的文件保存為test(1).txt，若此時(shí)test(1).txt也存在，也保存為test(2).txt，依次類推CopyErrorSuccess
使用示例
上傳單個(gè)文件
./us3cli cp ~/go/src/test.txt us3://bucket1/testCopyErrorSuccess
上傳單個(gè)大文件(大于64MB)并設(shè)置分片并發(fā)數(shù)為10
./us3cli cp ~/go/src/test.mp4 us3://bucket1/test.mp4 --parallel 10# 文件大小小于64MB時(shí)該參數(shù)無(wú)效CopyErrorSuccess
下載單個(gè)文件
./us3cli cp us3://bucket1/test/test.txt ~/go/src/test.txtCopyErrorSuccess
拷貝單個(gè)文件
./us3cli cp us3://bucket1/test.txt us3://bucket2/test.txtCopyErrorSuccess
拷貝文件夾
./us3cli cp -r us3://bucket1/test us3://bucket2/testCopyErrorSuccess
下載文件夾
./us3cli cp -r us3://bucket/test ~/go/src/testCopyErrorSuccess
指定存儲(chǔ)類型上傳
上傳單個(gè)文件并指定存儲(chǔ)類型為IA（低頻訪問(wèn)）類型
./us3cli cp ~/go/src/test.txt us3://bucket/path/test.txt --storageclass IACopyErrorSuccess
限速上傳
上傳文件test.txt，并設(shè)置速度為1024Kb/s
./us3cli cp ~/go/src/test.txt us3://bucket/test.txt --speedlimit 1024KbCopyErrorSuccess
批量上傳
上傳所有格式為jpg的文件（通配符）
./us3cli cp -r ~/go/src/test us3://bucket/test --include "*.jpg"CopyErrorSuccess
上傳所有a開頭b結(jié)尾的文件(正則表達(dá)式)
./us3cli cp -r ~/go/src/test us3://bucket/test --rinclude "a*b"CopyErrorSuccess
上傳所有不包括a開頭b結(jié)尾的文件(正則表達(dá)式)
./us3cli cp -r ~/go/src/test us3://bucket/test --rexclude "a*b"CopyErrorSuccess
上傳所有文件名不包括001的文件（通配符）
./us3cli cp -r ~/go/src/test us3://bucket/test --exclude "*001*"CopyErrorSuccess
上傳單個(gè)文件并指定元數(shù)據(jù)信息
./us3cli cp ~/go/src/test us3://bucket/test --metadata key1=value1,key2=value2CopyErrorSuccess
指定mimetype為text/plain上傳
./us3cli cp ~/go/src/test us3://bucket/test --mimetype text/plainCopyErrorSuccess
上傳文件夾并檢查etag是否一致
./us3cli cp -r ~/go/src/test us3://bucket/test --checkCopyErrorSuccess
sync
本命令用于目錄的增量上傳
命令格式
us3cli sync <本地目錄> us3://<桶名字>/<文件Key> [--reduce][--mode cache|local][--ruler modtime|etag][--speedlimit <速度限制>][--retrycount <重試次數(shù)>][--exclude <通配符表達(dá)式>][--rexclude <正則表達(dá)式>][--include <通配符表達(dá)式>][--rinclude <正則表達(dá)式>][--parallel <請(qǐng)求并發(fā)數(shù)>][--metadata <Key>=<value1>[,<key2>=<value2>]...][--mimetype <多媒體文件格式>][--storageclass <存儲(chǔ)類型>][--force]CopyErrorSuccess
參數(shù)說(shuō)明
--accesskey <string> :用于訪問(wèn)us3的API公鑰或Token公鑰 --config <string> :當(dāng)前命令臨時(shí)指定配置名/配置文件路徑 --endpoint <string> :固定域名，可通過(guò)地域和域名頁(yè)查看 --exclude <string> :不包含當(dāng)前通配符的文件名 -f, --force :是否強(qiáng)制同步，在加入該選項(xiàng)后，同步刪除時(shí)，不彈出確認(rèn)信息 --no-delete :是否默認(rèn)不刪除源端不存在的對(duì)象, 且不彈出信息, 在與-f同時(shí)使用時(shí)，執(zhí)行--no-delete -h, --help :當(dāng)前命令使用說(shuō)明 --include <string> :包含當(dāng)前通配符的文件名 --metadata <string> :指定元數(shù)據(jù)信息，多個(gè)元數(shù)據(jù)以","分隔，如 "key1=value,key2=value2",其他分隔符暫不支持 --mimetype <string> :指定mimetype上傳 -m, --mode <string> :可選項(xiàng) cache、local 默認(rèn)值為cache cache :以本地緩存為標(biāo)準(zhǔn)，檢查基于緩存的增量文件，同步us3端對(duì)應(yīng)目錄的文件，默認(rèn)為該模式 local :以本地文件系統(tǒng)為標(biāo)準(zhǔn)，檢查本地文件以及us3不同步的文件，補(bǔ)全或刪除us3端對(duì)應(yīng)目錄的文件 --parallel <int> :請(qǐng)求并發(fā)數(shù)，默認(rèn)值為10 --reduce :是否以精簡(jiǎn)模式執(zhí)行（不展示進(jìn)度） -r, --retrycount: <int> :失敗重試次數(shù),默認(rèn)值：10 --rexclude <string> :不包含當(dāng)前正則表達(dá)式的文件名 --rinclude <string> :包含當(dāng)前正則表達(dá)式的文件名 --ruler <string> :可選項(xiàng) modtime、etag 默認(rèn)為modtime modtime :在判斷是否上傳時(shí)采用文件最后修改時(shí)間作為判斷標(biāo)準(zhǔn)，如果本地文件最后修改時(shí)間晚于us3，則進(jìn)行上傳請(qǐng)求，否則不上傳 etag :在判斷是否上傳時(shí)采用文件etag作為判斷標(biāo)準(zhǔn)，如果本地文件etag和us3中的etag不同，則進(jìn)行上傳請(qǐng)求，否則不上傳 --secretkey <string> :用于訪問(wèn)us3的API私鑰或Token私鑰 -s, --speedlimit <string> :平均速度限制(單位可以是B,KB,MB，不帶單位默認(rèn)以B/s計(jì)算)，默認(rèn)200MB/s --storageclass <string> :指定存儲(chǔ)類型,對(duì)應(yīng)有效值：STANDARD, IA, ARCHIVE，默認(rèn)值：STANDARDCopyErrorSuccess
增量模式說(shuō)明：
1.cache模式使用本地緩存，從本地上傳到bucket成功的文件，都會(huì)被記錄為上傳成功文件，如果需要重新上傳，可以選擇刪除當(dāng)前用戶目錄下的.us3cliconfig/leveldb文件夾，使用命令時(shí)會(huì)自動(dòng)創(chuàng)建新的文件夾。
2.local模式下最終以本地文件為標(biāo)準(zhǔn)，保證bucket中的目標(biāo)文件夾和本地同步，以下場(chǎng)景會(huì)進(jìn)行文件刪除，請(qǐng)慎用：
增量上傳文件夾后，將本地文件刪除，再次使用local模式增量，會(huì)將bucket中的文件刪除以保持US3 Bucket和本地同步
使用示例
cache模式，以本地緩存中保存的修改時(shí)間為標(biāo)準(zhǔn)，同步本地文件
./us3cli sync /root/test us3://bucket/pathCopyErrorSuccess
cache模式，以本地緩存中的文件etag信息為標(biāo)準(zhǔn)，同步本地文件
./us3cli sync /root/test us3://bucket/path --ruler etagCopyErrorSuccess
local模式，對(duì)比本地文件夾與指定us3目錄中的所有文件的修改時(shí)間，通過(guò)上傳文件以及刪除us3文件操作，將us3目錄狀態(tài)與本地保持一致(如us3中有相對(duì)于本地多余的文件，則會(huì)刪除us3中對(duì)應(yīng)多余文件，請(qǐng)慎用)
./us3cli sync /root/test us3://bucket/path --mode localCopyErrorSuccess
local模式，對(duì)比本地文件夾與指定us3目錄中的所有文件的etag信息，通過(guò)上傳文件以及刪除us3文件操作，將us3目錄狀態(tài)與本地保持一致(如us3中有相對(duì)于本地多余的文件，則會(huì)刪除us3中對(duì)應(yīng)多余文件，請(qǐng)慎用)
./us3cli sync /root/test us3://bucket/path --mode local --ruler etagCopyErrorSuccess
限速為1024 Kb/s上傳
./us3cli sync /root/test us3://bucket/path --speedlimit 1024KbCopyErrorSuccess
并發(fā)上傳文件夾
./us3cli sync /root/test us3://bucket/path --parallel 5CopyErrorSuccess
指定mimetype上傳
./us3cli sync /root/test us3://bucket/path --mimetype "mimetype"CopyErrorSuccess
指定存儲(chǔ)類型上傳
./us3cli sync /root/test us3://bucket/path --storageclass "ARCHIVE"CopyErrorSuccess
指定元數(shù)據(jù)上傳
./us3cli sync /root/test us3://bucket/path --metadata "key1=value1,key2=value2"CopyErrorSuccess
rcat
本命令用于流式上傳文件
命令格式
us3cli rcat us3://<桶名字>/<文件Key> [--reduce][-retrycount <重試次數(shù)>][--speedlimit <速度限制>][--parallel <并發(fā)數(shù)限制>]CopyErrorSuccess
參數(shù)說(shuō)明
--accesskey <string> :用于訪問(wèn)us3的API公鑰或Token公鑰 --config <string> :當(dāng)前命令臨時(shí)指定配置名/配置文件路徑 --endpoint <string> :固定域名，可通過(guò)地域和域名頁(yè)查看 -h, --help :當(dāng)前命令使用說(shuō)明 --parallel <int> :分片并發(fā)數(shù) --reduce :是否以精簡(jiǎn)模式執(zhí)行（不展示進(jìn)度） --retrycount: <int> :失敗重試次數(shù),默認(rèn)值：10 --secretkey <string> :用于訪問(wèn)us3的API私鑰或Token私鑰 -s, --speedlimit <string> :平均速度限制(單位可以是B,KB,MB，不帶單位默認(rèn)以B/s計(jì)算)，默認(rèn)200MB/sCopyErrorSuccess
使用示例
上傳流式數(shù)據(jù)到us3中
cat test.txt | ./us3cli rcat us3://bucket1/test.txtCopyErrorSuccess
流式上傳文件test.txt并設(shè)置限速為 2MB/s
cat test.txt | ./us3cli rcat us3://bucket1/test.txt --speedlimit 2MBCopyErrorSuccess
流式上傳文件test.txt并設(shè)置重試次數(shù)為5次
cat test.txt | ./us3cli rcat us3://bucket1/test.txt --retrycount 5CopyErrorSuccess
流式上傳文件test.txt并設(shè)置并發(fā)數(shù)為2
cat test.txt | ./us3cli rcat us3://bucket1/test.txt --parallel 2CopyErrorSuccess
mkdir
本命令用于在US3存儲(chǔ)空間內(nèi)創(chuàng)建目錄
命令格式
us3cli mkdir [--parents] us3://<桶名字>/<目錄名>[/<目錄名>]CopyErrorSuccess
參數(shù)說(shuō)明
--accesskey <string> :用于訪問(wèn)us3的API公鑰或Token公鑰 --config <string> :當(dāng)前命令臨時(shí)指定配置名/配置文件路徑 --endpoint <string> :固定域名，可通過(guò)地域和域名頁(yè)查看 -h, --help :當(dāng)前命令使用說(shuō)明 -p, --parents :用于創(chuàng)建多級(jí)目錄 --secretkey <string> :用于訪問(wèn)us3的API私鑰或Token私鑰CopyErrorSuccess
使用示例
創(chuàng)建目錄
./us3cli mkdir us3://bucket/dirCopyErrorSuccess
創(chuàng)建多級(jí)目錄
./us3cli mkdir -p us3://bucket/dir1/dir2CopyErrorSuccess
cat
本命令用于流式下載文件
命令格式
us3cli cat us3://<bucketname>/<keyname> [--reduce][--retrycount <重試次數(shù)>][--speedlimit <速度限制>][--partsize <下載分片大小>]CopyErrorSuccess
參數(shù)說(shuō)明
--accesskey <string> :用于訪問(wèn)us3的API公鑰或Token公鑰 --config <string> :當(dāng)前命令臨時(shí)指定配置名/配置文件路徑 --endpoint <string> :固定域名，可通過(guò)地域和域名頁(yè)查看 -h, --help :當(dāng)前命令使用說(shuō)明 --partsize :下載分片大小，默認(rèn)大小為4M，最小值為1M(該參數(shù)僅限下載) --reduce :是否以精簡(jiǎn)模式執(zhí)行（不展示進(jìn)度） --retrycount: <int> :失敗重試次數(shù),默認(rèn)值：10 --secretkey <string> :用于訪問(wèn)us3的API私鑰或Token私鑰 -s, --speedlimit <string> :平均速度限制(單位可以是B,KB,MB，不帶單位默認(rèn)以B/s計(jì)算)，默認(rèn)200MB/sCopyErrorSuccess
使用示例
查看test.txt文件內(nèi)容
./us3cli cat us3://bucket1/test.txtCopyErrorSuccess
流式下載test.txt到本地
./us3cli cat us3://bucket1/test.txt > test.txtCopyErrorSuccess
流式下載并限速為1MB/s
./us3cli cat us3://bucket1/test.txt --speedlimit 1MB > test.txtCopyErrorSuccess
流式下載并設(shè)置重試次數(shù)為5次
./us3cli cat us3://bucket1/test.txt --retrycount 5 > test.txtCopyErrorSuccess
下載并設(shè)置分片大小為2M
./us3cli cat us3://bucket1/test.txt --partsize 2M > test.txtCopyErrorSuccess
mv
本命令用于移動(dòng)文件
注意：本命令只能用于相同bucket之內(nèi)，同時(shí)-f選項(xiàng)只支持文件
命令格式
us3cli mv us3://<桶名字>/<文件Key> us3://<桶名字>/<文件Key> [--force][--reduce][--exclude <通配符表達(dá)式>][--rexclude <正則表達(dá)式>][--include <通配符表達(dá)式>][--rinclude <正則表達(dá)式>][--parallel <并發(fā)數(shù)>]CopyErrorSuccess
參數(shù)說(shuō)明
--accesskey <string> :用于訪問(wèn)us3的API公鑰或Token公鑰 --config <string> :當(dāng)前命令臨時(shí)指定配置名/配置文件路徑 --endpoint <string> :固定域名，可通過(guò)地域和域名頁(yè)查看 --exclude <string> :不包含當(dāng)前通配符的文件名 -f, --force :存在同名文件時(shí)是否覆蓋 -h, --help :當(dāng)前命令使用說(shuō)明 --include <string> :包含當(dāng)前通配符的文件名 --parallel <int> :并發(fā)數(shù) --reduce :是否以精簡(jiǎn)模式執(zhí)行（不展示進(jìn)度） --rexclude <string> :不包含當(dāng)前正則表達(dá)式的文件名 --rinclude <string> :包含當(dāng)前正則表達(dá)式的文件名 --secretkey <string> :用于訪問(wèn)us3的API私鑰或Token私鑰CopyErrorSuccess
使用示例
移動(dòng)文件
./us3cli mv us3://bucket/test.txt us3://bucket/test/test.txtCopyErrorSuccess
強(qiáng)制移動(dòng)文件
./us3cli mv us3://bucket/test.txt us3://bucket/test/test.txt -fCopyErrorSuccess
移動(dòng)文件夾 注意：目標(biāo)文件夾存在時(shí)，文件夾會(huì)被移動(dòng)到目標(biāo)文件夾子目錄中
./us3cli mv us3://bucket/test us3://bucket/test2CopyErrorSuccess
rm
本命令用于刪除目錄或者對(duì)象
命令格式
us3cli rm us3://<桶名字>/<文件Key> [--recursive][--force][--reduce][--exclude <通配符表達(dá)式>][--rexclude <正則表達(dá)式>][--include <通配符表達(dá)式>][--rinclude <正則表達(dá)式>][--qps <每秒最大請(qǐng)求數(shù)量>]CopyErrorSuccess
參數(shù)說(shuō)明
--accesskey <string> :用于訪問(wèn)us3的API公鑰或Token公鑰 --cache <string> :要?jiǎng)h除的緩存類型 : upload|download|sync|du --config <string> :當(dāng)前命令臨時(shí)指定配置名/配置文件路徑 --endpoint <string> :固定域名，可通過(guò)地域和域名頁(yè)查看 --exclude <string> :不包含當(dāng)前通配符的文件名 -f, --force :強(qiáng)制刪除 -h, --help :當(dāng)前命令使用說(shuō)明 --include <string> :包含當(dāng)前通配符的文件名 --parallel <int> :批量刪除并發(fā)數(shù)，默認(rèn)值為10 -q, --qps <int> :限制每秒請(qǐng)求數(shù)量，默認(rèn)50qps，取值范圍：1~1000 -r, --recursive :遞歸文件夾中的所有文件及子目錄下所有文件 --reduce :是否以精簡(jiǎn)模式執(zhí)行（不展示進(jìn)度） --rexclude <string> :不包含當(dāng)前正則表達(dá)式的文件名 --rinclude <string> :包含當(dāng)前正則表達(dá)式的文件名 --secretkey <string> :用于訪問(wèn)us3的API私鑰或Token私鑰CopyErrorSuccess
使用示例
刪除文件
./us3cli rm us3://bucket/test.txtCopyErrorSuccess
強(qiáng)制刪除文件
./us3cli rm -f us3://bucket/test.txtCopyErrorSuccess
強(qiáng)制刪除文件夾
./us3cli rm -r -f us3://bucket/testCopyErrorSuccess
批量刪除test文件夾中后綴名為.jpg的文件
./us3cli rm -r us3://bucket/test --include "*.jpg"CopyErrorSuccess
限制刪除操作最多每秒10個(gè)請(qǐng)求，最大可以上調(diào)到1000qps，取值范圍在1~1000
./us3cli rm -r us3://bucket/test --include "*.jpg" --qps 10CopyErrorSuccess
批量刪除文件并設(shè)置并發(fā)數(shù)為30
./us3cli rm -r us3://bucket/test --parallel 30CopyErrorSuccess
清空bucket
./us3cli rm -r -f us3://bucket --parallel 10CopyErrorSuccess
刪除sync產(chǎn)生的緩存
./us3cli rm -f --cache syncCopyErrorSuccess
ls
該命令用于列出存儲(chǔ)空間(Bucket)、對(duì)象（Object）或ProjectID
命令格式
us3cli ls [us3://<桶名稱>] [--limit <輸出限制數(shù)>][--restore][--flat][--mimetype][--etag][--project][--projectid <項(xiàng)目ID>]CopyErrorSuccess
參數(shù)說(shuō)明
--accesskey <string> :用于訪問(wèn)us3的API公鑰或Token公鑰 --config <string> :當(dāng)前命令臨時(shí)指定配置名/配置文件路徑 --endpoint <string> :固定域名，可通過(guò)地域和域名頁(yè)查看 --etag :是否展示etag信息 --flat :是否以非層級(jí)結(jié)構(gòu)（展開所有目錄）顯示,默認(rèn)層級(jí)顯示 -h, --help :當(dāng)前命令使用說(shuō)明 -l, --limit <int> :需要同時(shí)列出的最大文件條數(shù)，默認(rèn)值為100 --mimetype :是否展示mimetype信息 --project :列出當(dāng)前賬戶下所有項(xiàng)目及項(xiàng)目ID --projectid <string> :列出bucket時(shí)指定projectid，默認(rèn)項(xiàng)目可忽略 -r, --restore :是否展示數(shù)據(jù)解凍信息 --secretkey <string> :用于訪問(wèn)us3的API私鑰或Token私鑰 --prefix-file-list :調(diào)用專有云的列表服務(wù)接口CopyErrorSuccess
注意：
ls列取文件列表默認(rèn)情況修改為只顯示文件key，文件大小，存儲(chǔ)類型，創(chuàng)建時(shí)間，可以自行通過(guò)參數(shù)添加restore、etag、mimetype等信息
使用示例
列出當(dāng)前權(quán)限下所有bucket
./us3cli lsBucketName Region Acl CreateTime bucket1 cn-bj public 2020-03-27 17:20:56bucket2 cn-bj private 2020-03-27 17:20:43us3cli cn-bj public 2020-09-15 16:17:24CopyErrorSuccess
列出bucket下所有對(duì)象
./us3cli ls us3://bucketKey FileSize StorageClass Etag CreateTime us3://bucket/cf1 DIR IA AQAAANo5o-5ea0sNMlW_75VgGJCv2AcJ 2020-07-16 18:51:04 us3://bucket/aa.txt 4KB STANDARD AQAAAGNlfLt9cIbFawzU5caZm7aDZkho 2020-07-22 11:04:34 us3://bucket/aa.txt 4KB ARCHIVE AQAAAGNlfLt9cIbFawzU5caZm7aDZkho 2020-07-22 11:04:34CopyErrorSuccess
列出當(dāng)前賬號(hào)下所有project
./us3cli ls --project當(dāng)前賬號(hào)下項(xiàng)目信息如下：No. ProjectName ProjectId 1 Default org-ddhm4o2 Test org-nhrc4y3 Test2 org-wr5pejCopyErrorSuccess
列出bucket下對(duì)象并限制顯示文件數(shù)量為2
./us3cli ls us3://bucket --limit 2CopyErrorSuccess
列出bucket下對(duì)象并顯示數(shù)據(jù)解凍狀態(tài)信息
./us3cli ls us3://bucket --restoreCopyErrorSuccess
遞歸當(dāng)前目錄列出非目錄形式的文件列表（展開所有目錄）
./us3cli ls us3://bucket --flatCopyErrorSuccess
sign
本命令用于文件下載url獲取
命令格式
us3cli sign us3://<桶名字>/<文件Key> [--expires <時(shí)間>]CopyErrorSuccess
參數(shù)說(shuō)明
--accesskey <string> :用于訪問(wèn)us3的API公鑰或Token公鑰 --config <string> :當(dāng)前命令臨時(shí)指定配置名/配置文件路徑 --endpoint <string> :固定域名，可通過(guò)地域和域名頁(yè)查看 --expires <int> :url使用的過(guò)期時(shí)間,單位s -h, --help :當(dāng)前命令使用說(shuō)明 --secretkey <string> :用于訪問(wèn)us3的API私鑰或Token私鑰CopyErrorSuccess
使用示例
獲取url簽名
./us3cli sign us3://bucket/test.txtCopyErrorSuccess
獲取限時(shí)100s 的url簽名
./us3cli sign us3://bucket/test.txt --expires 100CopyErrorSuccess
modify
該命令用于修改us3中的文件信息
命令格式
us3cli modify us3://<桶名字>/<文件Key> [--storageclass <存儲(chǔ)類型>][--mimetype <多媒體文件格式>][--metadata <<key1=value1>[,<key2=value2>]...>][--replace]CopyErrorSuccess
參數(shù)說(shuō)明
--accesskey <string> :用于訪問(wèn)us3的API公鑰或Token公鑰 --config <string> :當(dāng)前命令臨時(shí)指定配置名/配置文件路徑 --endpoint <string> :固定域名，可通過(guò)地域和域名頁(yè)查看 -h, --help :當(dāng)前命令使用說(shuō)明 --metadata <string> :指定元數(shù)據(jù)信息 --mimetype <string> :指定多媒體文件格式mimetype --replace :是否清空原有元數(shù)據(jù) --secretkey <string> :用于訪問(wèn)us3的API私鑰或Token私鑰 --storageclass <string> :指定存儲(chǔ)類型,對(duì)應(yīng)有效值：STANDARD, IA, ARCHIVECopyErrorSuccess
使用示例
存儲(chǔ)類型改變
修改test.txt的存儲(chǔ)類型為STANDARD標(biāo)準(zhǔn)型
./us3cli modify us3://bucket/test.txt --storageclass STANDARDCopyErrorSuccess
mimetype改變
修改test.txt文件的mimetype信息
./us3cli modify us3://bucket/test.txt --mimetype image/x-iconCopyErrorSuccess
metadata改變
1.修改test.txt文件的元數(shù)據(jù)信息，以key=value形式作為參數(shù)，可修改多個(gè)元數(shù)據(jù)信息，中間以英文逗號(hào)","分隔
./us3cli modify us3://bucket/test.txt --metadata "key1=value1,key2=value2"CopyErrorSuccess
2.清除原有元數(shù)據(jù)，添加新的內(nèi)容
./us3cli modify us3://bucket/test.txt --metadata "key1=value1" --replaceCopyErrorSuccess
3.刪除所有元數(shù)據(jù)
./us3cli modify us3://bucket/test.txt --metadata "" --replaceCopyErrorSuccess
restore
本命令用于恢復(fù)冷凍狀態(tài)的對(duì)象（object）為可讀狀態(tài)
命令格式
us3cli restore us3://<桶名字>/<文件Key> [--recursive][--reduce][--qps <每秒請(qǐng)求數(shù)上限>][--exclude <通配符表達(dá)式>][--rexclude <正則表達(dá)式>][--include <通配符表達(dá)式>][--rinclude <正則表達(dá)式>][--parallel <批量激活并發(fā)數(shù)>]CopyErrorSuccess
參數(shù)說(shuō)明
--accesskey <string> :用于訪問(wèn)us3的API公鑰或Token公鑰 --config <string> :當(dāng)前命令臨時(shí)指定配置名/配置文件路徑 --endpoint <string> :固定域名，可通過(guò)地域和域名頁(yè)查看 --exclude <string> :不包含當(dāng)前通配符的文件名 -h, --help :當(dāng)前命令使用說(shuō)明 --include <string> :包含當(dāng)前通配符的文件名 --parallel <int> :批量激活并發(fā)數(shù)，默認(rèn)值為10 -q, --qps <int> :限制每秒請(qǐng)求數(shù)量，默認(rèn)50qps，取值范圍：1~1000 -r, --recursive :遞歸文件夾中的所有文件及子目錄下所有文件 --reduce :是否以精簡(jiǎn)模式執(zhí)行（不展示進(jìn)度） --rexclude <string> :不包含當(dāng)前正則表達(dá)式的文件名 --rinclude <string> :包含當(dāng)前正則表達(dá)式的文件名 --secretkey <string> :用于訪問(wèn)us3的API私鑰或Token私鑰CopyErrorSuccess
使用示例
單個(gè)文件數(shù)據(jù)解凍
./us3cli restore us3://bucket/test.txtCopyErrorSuccess
數(shù)據(jù)解凍整個(gè)目錄中所有文件
./us3cli restore -r us3://bucket/testCopyErrorSuccess
批量激活文件并設(shè)置并發(fā)數(shù)為30
./us3cli restore -r us3://bucket/test --parallel 30CopyErrorSuccess
etag
該命令用于計(jì)算文件etag值
命令格式
us3cli etag [<本地文件路徑1>,[<本地文件路徑2>] ...] [us3://<桶名字>/<文件Key>] [-]CopyErrorSuccess
參數(shù)說(shuō)明
固定參數(shù): "-" 表示計(jì)算標(biāo)準(zhǔn)輸入中的數(shù)據(jù)流etag值 --accesskey <string> :用于訪問(wèn)us3的API公鑰或Token公鑰 --config <string> :當(dāng)前命令臨時(shí)指定配置名/配置文件路徑 --endpoint <string> :固定域名，可通過(guò)地域和域名頁(yè)查看 -h, --help :當(dāng)前命令使用說(shuō)明 --secretkey <string> :用于訪問(wèn)us3的API私鑰或Token私鑰CopyErrorSuccess
使用示例
計(jì)算本地文件etag值
./us3cli etag main.goName Etag main.go AQAAAEpmwm87EANJQDpLTEmxsjR7-R0NCopyErrorSuccess
計(jì)算us3文件etag值
./us3cli etag us3://bucket1/test.txtName Etag us3://bucket1/test.txt AQAAAEpmwm87EANJQDpLTEmxsjR7-R0NCopyErrorSuccess
計(jì)算標(biāo)準(zhǔn)輸入etag值
cat test.txt | ./us3cli etag -Name Etag [-] SmbCbzsQA0lAOktMSbGyNHv5HQ0=CopyErrorSuccess
計(jì)算多個(gè)文件etag
cat test4.txt | ./us3cli etag us3://bucket1/test.txt us3://bucket1/test2.txt test3.txt -Name Etag us3://bucket1/test.txt AQAAAEpmwm87EANJQDpLTEmxsjR7-R0Nus3://bucket1/test2.txt AQAAAEpmwm87EANJQDpLTEmxsjR7-R0Ntest3.txt AQAAAHPuBl-6VRpzVHiBFjSOVhLrcsam[-] SmbCbzsQA0lAOktMSbGyNHv5HQ0=CopyErrorSuccess
create-token
本命令用于創(chuàng)建Token
命令格式
us3cli create-token token-name [--flags]CopyErrorSuccess
參數(shù)說(shuō)明
--black-list stringArray 黑名單ip -b, --buckets stringArray token允許操作的桶 -e, --expire int token過(guò)期時(shí)間 -h, --help 幫助 -o, --operations stringArray token允許的操作 --prefixes stringArray token允許操作的對(duì)象前綴 -p, --projectid string token所屬的項(xiàng)目id -r, --region string token所在的區(qū)域 --white-list stringArray 白名單ipCopyErrorSuccess
使用示例
us3cli create-token test-token --projectid org-xxxxxx2021-10-13 15:02:37.248 INFO Token created successfully, token-id: ea8e7799-3241-xxxxxxxxxxCopyErrorSuccess
delete-token
本命令用于刪除Token
命令格式
us3cli delete-token --token-id token-id [--flags]CopyErrorSuccess
參數(shù)說(shuō)明
-h, --help 幫助信息 -p, --projectid string token的項(xiàng)目id -r, --region string token所在的區(qū)域 --token-id string 想要?jiǎng)h除的token的idCopyErrorSuccess
使用示例
us3cli delete-token --token-id ea8e7799-3241-xxxxxx --projectid org-xxxxxx --region cn-bj2021-10-13 15:05:14.449 INFO Token deleted successfullyCopyErrorSuccess
update-token
本命令用于更新Token
命令格式
us3cli update-token token-id [--flags]CopyErrorSuccess
參數(shù)說(shuō)明
--black-list stringArray 黑名單ip -b, --buckets stringArray token允許操作的桶 -e, --expire int token過(guò)期時(shí)間 -h, --help 幫助 -n, --name string token的名字 -o, --operations stringArray token允許的操作 --prefixes stringArray token允許操作的對(duì)象前綴 -p, --projectid string token所屬的項(xiàng)目id -r, --region string token所在的區(qū)域 --white-list stringArray 白名單ipCopyErrorSuccess
使用示例
us3cli update-token c1fd74ad-9c04-4ee2-bb1e-xxxxxxxxx --region cn-bj --projectid org-xxxxxx2021-10-13 15:12:02.403 INFO Token updated successfullyCopyErrorSuccess
describe-token
本命令用于列出和描述Token
命令格式
us3cli describe-token [--flags]CopyErrorSuccess
參數(shù)說(shuō)明
-h, --help 幫助信息 -p, --projectid string token的項(xiàng)目id -r, --region string token所在的區(qū)域 --token-id string 想要?jiǎng)h除的token的idCopyErrorSuccess
使用示例
列出某個(gè)project，某region下的所有tokenus3cli describe-token --region cn-bj --projectid org-jhrz4yToken Id:2853e6eb-951d-4ba4-b2e9-xxxxxxxxxToken Name:sourextokenAllowed buckets:[sourcex]Allowed operations:[TOKEN_ALLOW_READ TOKEN_ALLOW_WRITE TOKEN_ALLOW_DELETE TOKEN_ALLOW_LIST TOKEN_ALLOW_IOP]Allowed prefixes:[*]Exipre time:1569742841Private key:4xxxxxxxxxxxxxxxxxxxxxxxPublic key:TOKEN_xxxxxxxxxxxxxxxxxxxxxCopyErrorSuccess
....
- 描述某個(gè)特定的tokenCopyErrorSuccess
us3cli describe-token --token-id c1fd74ad-9c04-4ee2-bb1e-xxxxxxxxx --region cn-bj --projectid org-xxxxx Token Id: c1fd74ad-9c04-4ee2-bb1e-xxxxxxxx Token Name: test-token Allowed buckets: [] Allowed operations: [TOKEN_ALLOW_NONE] Allowed prefixes: [] Exipre time: 86400 Private key: dxxxxxxxxxxxxxxxxxxxxxx Public key: TOKEN_xxxxxxxxxxxxxxxxxxxx
## update本命令用于版本更新注意：1.windows用戶更新后會(huì)產(chǎn)生一個(gè)名為config.temp的臨時(shí)文件，在下一次運(yùn)行us3cli時(shí)會(huì)自動(dòng)刪除。2.將本工具放入bin目錄下執(zhí)行時(shí)，更新操作會(huì)出現(xiàn)找不到文件的問(wèn)題，具體解決方案請(qǐng)查看常見問(wèn)題頁(yè)面。### 命令格式CopyErrorSuccess
us3cli update [--force]
### 參數(shù)說(shuō)明CopyErrorSuccess
-f, --force :忽略版本，強(qiáng)制更新 -h, --help :當(dāng)前命令使用說(shuō)明
##### 使用示例CopyErrorSuccess
./us3cli update
Your version is not the latest version, do you update it now(y or n):y Downloaded latest version package,saved as: us3cli-linux64
## version本命令用于查看工具版本### 命令格式CopyErrorSuccess
us3cli version
### 使用示例CopyErrorSuccess
./us3cli version
us3cli version 1.2.0
```
商品已成功加入購(gòu)物車