如果未開啟歸檔直讀,歸檔類型的Object需要解凍後才能讀取。冷歸檔、深度冷歸檔不支援開啟直讀,冷歸檔、深度冷歸檔類型的Object需要解凍後才能讀取。歸檔類型Object完成解凍通常需要數分鐘。冷歸檔類型Object完成解凍通常需要數小時。深度冷歸檔類型Object完成解凍通常需要12~48小時。解凍時間請以實際為準。本文為您介紹如何通過restore命令解凍檔案。
注意事項
-
要解凍單個檔案,您必須具有
oss:RestoreObject許可權;要按目錄解凍檔案,您必須具有oss:RestoreObject和oss:ListObjects許可權。具體操作,請參見為RAM使用者授予自訂的權限原則。 -
關于歸檔儲存、冷Archive Storage或者深度冷Archive Storage類型檔案的解凍狀態以及費用說明,請參見Restore objects。
命令格式
ossutil restore oss://bucket/object [flags]
|
參數 |
類型 |
說明 |
|
--days |
int |
解凍天數。取值範圍1~365。 當大量操作時,如果對象的儲存類型存在混合情況,且days值超過該類型支援的最大值,則自動調整為該類型支援的最大值。例如:Archive Storage類型支援的最大天數為7天,深度冷Archive Storage類型支援365天,當--days設定為100時,對于歸檔儲存類型的對象,自動調整為7;對於深度冷Archive Storage類型的對象,使用100。 |
|
--tier |
string |
解凍優先順序。歸檔類型對象無需指定此參數,解凍時間為1分鐘。
當大量操作時,如果對象的儲存類型存在混合情況,且tier值超過該類型支援的優先順序,則自動調整為該類型支援的最低優先順序。例如ColdArchive支援Bulk,DeepColdArchive僅支援Standard,當--tier設定為Bulk時,對於DeepColdArchive類型的對象,自動調整為Standard。 |
|
--dirs |
/ |
返回目前的目錄下的檔案和子目錄,而非遞迴顯示所有子目錄下的所有檔案。 |
|
--encoding-type |
string |
輸入的對象名或檔案名稱的編碼方式。取值:url。 |
|
--end-with |
string |
按字母排序,返回設定值之前的對象,包含設定值。 |
|
--exclude |
stringArray |
路徑或檔案名稱的排除規則。 |
|
--exclude-from |
stringArray |
從規則檔案裡讀取排除規則。 |
|
--files-from |
stringArray |
從檔案中讀取源檔案名稱列表,忽略空行或注釋行。 |
|
--files-from-raw |
stringArray |
從檔案中讀取源檔案名稱列表。 |
|
--filter |
stringArray |
路徑或檔案名稱過濾規則。 |
|
--filter-from |
stringArray |
從規則檔案讀取過濾規則。 |
|
-f, --force |
/ |
強制操作,不進行詢問提示。 |
|
--include |
stringArray |
路徑或檔案名稱的包含規則。 |
|
--include-from |
stringArray |
從規則檔案裡讀取包含規則。 |
|
--limited-num |
int |
返回結果的最大個數。 |
|
--list-objects |
/ |
使用ListObjects介面列舉對象。 |
|
--min-age |
Duration |
不傳輸任何比此更新的檔案,預設單位是秒,也可以使用單位尾碼形式。例如 1h,表示1小時。 說明
|
|
--max-age |
Duration |
不傳輸任何比此更早的檔案,預設單位是秒,也可以使用單位尾碼形式。例如 1h,表示1小時。 |
|
--min-mtime |
Time |
不傳輸任何比此更早的檔案,時間格式:UTC時間。例如2006-01-02T15:04:05。 說明
|
|
--max-mtime |
Time |
不傳輸任何比此更新的檔案,時間格式:UTC時間,例如 2006-01-02T15:04:05。 |
|
--max-size |
SizeSuffix |
限制傳輸的最大檔案大小,預設是位元組,或單位尾碼形式B|K|M|G|T|P,1K(KiB)=1024B。 |
|
--metadata-exclude |
stringArray |
對象中繼資料的排除規則。 |
|
--metadata-filter |
stringArray |
對象中繼資料過濾規則。 |
|
--metadata-filter-from |
stringArray |
從規則檔案讀取對象中繼資料過濾規則。 |
|
--metadata-include |
stringArray |
對象中繼資料的包含規則。 |
|
--min-size |
SizeSuffix |
限制傳輸的最小檔案大小,預設是位元組,或單位尾碼形式B|K|M|G|T|P,1K(KiB)=1024B。 |
|
--page-size |
int |
批量處理時分頁列舉對象的最大值(預設值1000),取值範圍1~1000。 |
|
-r, --recursive |
/ |
遞迴進行操作。當指定該選項時,命令會對儲存空間下所有合格對象進行操作,否則只對路徑指定的對象進行操作。 |
|
--request-payer |
string |
請求的支付方式,如果為要求者付費模式,請設定該值。取值:requester。 |
|
--start-after |
string |
按字母排序,返回設定值之後的對象,不包含設定值。 |
|
--version-id |
string |
對象的版本標識。 |
|
--list-format |
string |
列表檔案的格式,取值:plain、inventory。 |
|
--list-manifest-from |
string |
從檔案中讀取列表檔案格式的描述資訊,當列表檔案格式為inventory時,需要設定該參數。 |
關於支援的全域命令列選項,請參見支援的全域命令列選項。
使用樣本
解凍歸檔類型Object
-
以下樣本用於解凍目標儲存空間examplebucket下歸檔類型檔案exampleobject.txt。
ossutil restore oss://examplebucket/exampleobject.txt -
以下樣本用於解凍目標儲存空間examplebucket下歸檔類型檔案exampleobject.txt,並將解凍天數設定為3天。
ossutil restore oss://examplebucket/exampleobject.txt --days 3 -
以下樣本用於從列表裡解凍對象。
說明list列表檔案裡的一行表示一個對象,且採用OSS路徑格式,即oss://{bucket}/{key},如list.txt檔案:
oss://examplebucket/key1 oss://examplebucket/key2ossutil restore list://list.txt -
以下樣本用於從列表裡直接解凍對象,不會檢查 object 的狀態。
ossutil restore list://list.txt --no-check-status -
以下樣本用於從資訊清單檔裡解凍對象。
說明執行清單任務後,會在清單結果中產生一個 csv.gz 和 manifest.json 檔案。從資訊清單檔裡解凍對象需要用到這兩個檔案。
ossutil restore list://ca8007fc-4123-493e-9a01-dd1511fbac54.csv.gz --list-format inventory --list-manifest-from manifest.json -
以下樣本用於從資訊清單檔裡直接解凍對象,不會檢查 object 的狀態。
ossutil restore list://ca8007fc-4123-493e-9a01-dd1511fbac54.csv.gz --list-format inventory --list-manifest-from manifest.json --no-check-status
解凍冷歸檔類型Object
以下樣本用於解凍目標儲存空間examplebucket下冷歸檔類型檔案exampleobject.txt,並將解凍天數設定為5天。
ossutil restore oss://examplebucket/exampleobject.txt --tier Bulk --days 5
以下樣本用於遞迴解凍目標儲存空間examplebucket下dir目錄中所有冷歸檔類型的.csv檔案,並將解凍天數設定為5天。
ossutil restore oss://examplebucket/dir/ -r --include "*.csv" --tier Bulk --days 5
解凍深度冷歸檔類型Object
以下樣本用於解凍目標儲存空間examplebucket下深度冷歸檔類型檔案exampleobject.txt,並將解凍天數設定為10天。
ossutil restore oss://examplebucket/exampleobject.txt --tier Standard --days 10
以下樣本用於遞迴解凍目標儲存空間examplebucket下dir目錄中所有深度冷歸檔類型的.csv檔案,並將解凍天數設定為10天。
ossutil restore oss://examplebucket/dir/ -r --include "*.csv" --tier Standard --days 10