ossutil(oss命令行工具)v1.0免費(fèi)版

ossutil是以命令行方式管理OSS數(shù)據(jù)的工具，提供方便、簡潔、豐富的存儲(chǔ)空間(Bucket)和文件(Object)管理命令，支持Windows、Linux、 Mac平臺(tái)。

功能介紹

通過ossutil，您可以進(jìn)行如下操作：

管理Bucket，如：創(chuàng)建、列舉或刪除Bucket等。

管理Object，如：上傳、下載、列舉、拷貝和刪除Object等。

管理碎片(part)，如：列舉和刪除part等。

安裝方法

Windows系統(tǒng)(以64位系統(tǒng)為例)

下載工具。

將工具解壓到指定的文件夾，并雙擊運(yùn)行ossutil.bat文件。

生成配置文件，配置參數(shù)參考Linux系統(tǒng)的配置參數(shù)。

D:\ossutil>ossutil64.exe config

常見問題

本文介紹在使用ossutil時(shí)可能出現(xiàn)的問題及處理方法。

使用-u參數(shù)上傳文件時(shí)出現(xiàn)skip提示

問題分析：使用-u參數(shù)上傳文件的時(shí)候，ossutil會(huì)將上傳文件和存儲(chǔ)空間(Bucket)內(nèi)已有文件進(jìn)行一次比對(duì)。若發(fā)現(xiàn)上傳的文件與目標(biāo)Bucket內(nèi)已有文件同名，且該文件的最后修改時(shí)間早于或等于Bucket內(nèi)已有文件，上傳時(shí)會(huì)跳過該文件;若該文件的最后修改時(shí)間晚于Bucket內(nèi)已有文件，則重新上傳該文件。所以使用-u參數(shù)上傳文件時(shí)出現(xiàn)skip提示是正?，F(xiàn)象。

解決方案：確認(rèn)Bucket內(nèi)文件上傳無問題后忽略該提示。

文件解凍時(shí)出現(xiàn)403報(bào)錯(cuò)

問題分析：操作解凍文件的過程中出現(xiàn)403，有以下兩種可能性。

若您是使用子賬號(hào)操作文件，可能是子賬號(hào)權(quán)限不足，無目標(biāo)文件的操作權(quán)限。

您文件內(nèi)容違禁OSS被封禁了。

解決方案：

子賬號(hào)權(quán)限不足：增加子賬號(hào)權(quán)限。

文件內(nèi)容違禁：刪除或忽略該文件。

使用ls命令查看Bucket無文件，刪除Bucket時(shí)報(bào)錯(cuò)

問題分析：使用ls命令列舉Bucket內(nèi)的文件且未攜帶任何選項(xiàng)時(shí)，無法列舉碎片、歷史版本文件(僅存在于開啟過版本控制的Bucket)。若Bucket為非空(即Bucket中存在碎片、歷史版本文件)，僅使用rm命令無法刪除該Bucket。

解決方案：

先刪除碎片和歷史版本文件(未開啟過版本控制請忽略)，再刪除Bucket。

刪除碎片和歷史版本文件。

列舉并刪除碎片：

./ossutil ls oss://bucket1 -m

./ossutil rm -m oss://bucket1 -r

列舉并刪除歷史版本文件：

./ossutil ls oss://bucket1 --all-versions

./ossutil rm oss://bucket1 --all-versions -r

刪除Bucket。

./ossutil rm oss://bucket1 -b

強(qiáng)制刪除Bucket。

若存儲(chǔ)空間未開啟版本控制，使用如下命令強(qiáng)制刪除Bucket：

./ossutil rm oss://bucketname -abrf

若存儲(chǔ)空間已開啟版本控制，使用如下命令強(qiáng)制刪除Bucket：

./ossutil rm oss://bucketname -abrf --all-versions

警告 Bucket及文件被刪除后，無法恢復(fù)，請謹(jǐn)慎使用該命令。

文件上傳、下載進(jìn)度超過100%

問題分析：ossutil在上傳、下載文件時(shí)，會(huì)自動(dòng)生成一個(gè)名為.ossutil_checkpoint文件夾。當(dāng)目標(biāo)文件超過100 MB時(shí)，ossutil默認(rèn)使用斷點(diǎn)續(xù)傳上傳或下載目標(biāo)文件，并將過程中生成的斷點(diǎn)信息文件保存在.ossutil_checkpoint文件夾中。上傳、下載任務(wù)完成后，會(huì)自動(dòng)刪除這個(gè)文件夾。若單機(jī)運(yùn)行超過一個(gè)ossutil實(shí)例，且都在進(jìn)行上傳或下載任務(wù)，當(dāng)其中一個(gè)ossutil的任務(wù)完成后，會(huì)自動(dòng)刪除.ossutil_checkpoint文件夾，導(dǎo)致其它需要使用斷點(diǎn)續(xù)傳的ossutil任務(wù)進(jìn)度超過100%且無法完成。

解決方案：

將當(dāng)前任務(wù)結(jié)束，重新開始上傳、下載任務(wù)。

在cp命令中加上--checkpoint-dir參數(shù)，并手動(dòng)指定一個(gè)與默認(rèn)checkpoint文件夾不同名的文件夾。例如：

./ossutil cp oss://bucket1/myphoto.jpg /dir --checkpoint-dir checkpoint