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、開(kāi)始創(chuàng)建配置。

./us3cli-linux64 configCopyErrorSuccess

Windows環(huán)境準(zhǔn)備：

1、下載工具至本地。

2、以管理員身份打開(kāi)cmd面板，切換到us3cli-windows.exe文件所在路徑。

3、執(zhí)行config命令創(chuàng)建配置。

us3cli-windows.exe configCopyErrorSuccess

注意事項(xiàng)：

1、請(qǐng)使用管理員身份打開(kāi)cmd命令行。

2、下載后請(qǐng)不要直接點(diǎn)擊執(zhí)行us3cli-windows.exe文件，該工具需要使用命令行工具打開(kāi)執(zhí)行。

3、如果點(diǎn)擊下載無(wú)反應(yīng)，請(qǐng)右鍵單擊復(fù)制鏈接地址，輸入到瀏覽器地址輸入框打開(kāi)。

Mac環(huán)境準(zhǔn)備：

1.下載工具至本地。

2.添加可執(zhí)行權(quán)限。

chmod +x us3cli-macCopyErrorSuccess

3.開(kāi)始創(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)名稱(chēng): config1開(kāi)始創(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 孟買(mǎi) 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)輸入回車(chē)確認(rèn)或自定義endponit：當(dāng)前最終配置：ConfigName: config1AccessKey: xxxxxxxxxxxxxxxxxxxxxxSecretKey: xxxxxxxxxxxxxxxxxxxxxxEndpoint: cn-bj.ufileos.com請(qǐng)檢查后輸入回車(chē)確認(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)名稱(chē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密鑰類(lèi)型還是API密鑰類(lèi)型(只判斷類(lèi)型，不進(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)容如下,具體填寫(xiě)說(shuō)明見(jiàn)常用命令頁(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)限類(lèi)型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 孟買(mǎi) 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ǔ)類(lèi)型為IA上傳 (不區(qū)分大小寫(xiě))./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)詢(xú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ǔ)類(lèi)型為低頻類(lèi)型./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ū)分大小寫(xiě)，并且默認(rèn)大小為4M，最小值為4M)./us3cli cp us3://buckettest/test.txt ./test.txt --partsize 4M#流式文件下載(文件會(huì)寫(xiě)入到標(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、查詢(xún)文件基本信息

#命令格式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ù)取回：指歸檔類(lèi)型的數(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ǔ)類(lèi)型為ARCHIVE(歸檔類(lèi)型)./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ù)下載并寫(xiě)入到標(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ǔ)類(lèi)型、MIMETYPE、MetaData
歸檔數(shù)據(jù)取回	restore	將歸檔類(lèi)型的文件激活為可下載狀態(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ě)說(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)名稱(chēng): config1開(kāi)始創(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 孟買(mǎi) 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)輸入回車(chē)確認(rèn)或自定義endponit：當(dāng)前最終配置：ConfigName: config1AccessKey: xxxxxxxxxxxxxxxxxxxxxxSecretKey: xxxxxxxxxxxxxxxxxxxxxxEndpoint: cn-bj.ufileos.com請(qǐng)檢查后輸入回車(chē)確認(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.填寫(xiě)代理地址時(shí)只需要填寫(xiě)“ ip:port”,客戶(hù)端會(huì)根據(jù)填寫(xiě)的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)限分類(lèi)，只用于快速區(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ū)分大小寫(xiě)，輸入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)限類(lèi)型>][--region <桶所在地區(qū)>][--projectid <項(xiàng)目ID>]CopyErrorSuccess

參數(shù)說(shuō)明

--accesskey <string> :用于訪問(wèn)us3的API公鑰或Token公鑰 -a, --acl <string> :權(quán)限類(lèi)型，可以設(shè)置為private、public，默認(rèn)為private私有(不區(qū)分大小寫(xiě)) --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)限類(lèi)型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 孟買(mǎi) 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ǔ)類(lèi)型的存儲(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ǔ)類(lèi)型的存儲(chǔ)量以及總存儲(chǔ)量

StorageClass Size STANDARD: 1.05 GBIA: 0 GB ARCHIVE: 0 GB Total storage: 1.05 GBCopyErrorSuccess

查看bucket1下的testfolder目錄下各類(lèi)型存儲(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ǔ)類(lèi)型>][--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ǔ)類(lèi)型,對(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ū)分大小寫(xiě)的情況，要下載的文件已存在時(shí)，會(huì)在文件名及文件后綴名之間默認(rèn)添加(1),(2)...等作為文件名后綴，如：

文件test.txt存在，則下載的文件保存為test(1).txt，若此時(shí)test(1).txt也存在，也保存為test(2).txt，依次類(lèi)推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ǔ)類(lèi)型上傳

上傳單個(gè)文件并指定存儲(chǔ)類(lèi)型為IA（低頻訪問(wèn)）類(lèi)型

./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開(kāi)頭b結(jié)尾的文件(正則表達(dá)式)

./us3cli cp -r ~/go/src/test us3://bucket/test --rinclude "a*b"CopyErrorSuccess

上傳所有不包括a開(kāi)頭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ǔ)類(lèi)型>][--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ǔ)類(lèi)型,對(duì)應(yīng)有效值：STANDARD, IA, ARCHIVE，默認(rèn)值：STANDARDCopyErrorSuccess

增量模式說(shuō)明：

1.cache模式使用本地緩存，從本地上傳到bucket成功的文件，都會(huì)被記錄為上傳成功文件，如果需要重新上傳，可以選擇刪除當(dāng)前用戶(hù)目錄下的.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ǔ)類(lèi)型上傳

./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除的緩存類(lèi)型 : 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://<桶名稱(chēng)>] [--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)（展開(kāi)所有目錄）顯示,默認(rèn)層級(jí)顯示 -h, --help :當(dāng)前命令使用說(shuō)明 -l, --limit <int> :需要同時(shí)列出的最大文件條數(shù)，默認(rèn)值為100 --mimetype :是否展示mimetype信息 --project :列出當(dāng)前賬戶(hù)下所有項(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)用專(zhuān)有云的列表服務(wù)接口CopyErrorSuccess

注意：

ls列取文件列表默認(rèn)情況修改為只顯示文件key，文件大小，存儲(chǔ)類(lèi)型，創(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)前目錄列出非目錄形式的文件列表（展開(kāi)所有目錄）

./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ǔ)類(lèi)型>][--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ǔ)類(lèi)型,對(duì)應(yīng)有效值：STANDARD, IA, ARCHIVECopyErrorSuccess

使用示例

存儲(chǔ)類(lèi)型改變

修改test.txt的存儲(chǔ)類(lèi)型為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用戶(hù)更新后會(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)查看常見(jiàn)問(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

```