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ō)明見(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)限類型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ō)明：

自定義配置文件格式，填寫說(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)查看常見(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

```