如果未開啟歸檔直讀,歸檔類型的Object需要解凍後才能讀取。冷歸檔、深度冷歸檔不支援開啟直讀,冷歸檔、深度冷歸檔類型的Object需要解凍後才能讀取。歸檔類型Object完成解凍通常需要數分鐘。冷歸檔類型Object完成解凍通常需要數小時。深度冷歸檔類型Object完成解凍通常需要12~48小時。解凍時間請以實際為準。本文為您介紹如何通過restore命令解凍檔案。
注意事項
要解凍單個檔案,您必須具有
oss:RestoreObject
許可權;要按目錄解凍檔案,您必須具有oss:RestoreObject
和oss:ListObjects
許可權。具體操作,請參見為RAM使用者授權自訂的權限原則。關于歸檔儲存、冷Archive Storage或者深度冷Archive Storage類型檔案的解凍狀態以及費用說明,請參見解凍檔案。
命令格式
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介面列舉對象。 |
--max-age | Duration | 不傳輸任何比此更早的檔案,預設是秒,或單位尾碼形式 ms|s|m|h|d|w|M|y(預設值off)。 |
--max-mtime | Time | 不傳輸任何比此更新的檔案,UTC時間格式(預設值off)。 |
--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-age | Duration | 不傳輸任何比此更新的檔案,預設是秒,或單位尾碼形式 ms|s|m|h|d|w|M|y(預設值off)。 |
--min-mtime | Time | 不傳輸任何比此更早的檔案,UTC時間格式(預設值off)。 |
--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/key2
ossutil 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
解凍深度冷歸檔類型Object
以下樣本用於解凍目標儲存空間examplebucket下深度冷歸檔類型檔案exampleobject.txt,並將解凍天數設定為10天。
ossutil restore oss://examplebucket/exampleobject.txt --tier Standard --days 10
計費說明
解凍歸檔、冷歸檔、深度冷歸檔類型的Object會產生資料取回容量費用。更多資訊,請參見資料處理費用。
解凍歸檔類型的Object會產生Put類型請求次數費用。更多資訊,請參見請求費用。
解凍冷歸檔、深度冷歸檔類型的Object會產生取回請求次數費用。更多資訊,請參見請求費用。
歸檔類型、冷歸檔、深度冷歸檔類型的Object在解凍過程中以及解凍完成後,均按照相應的儲存類型計算儲存費用。更多資訊,請參見儲存費用。
冷歸檔、深度冷歸檔類型的Object在解凍時,會產生一份標準儲存類型的檔案副本用於訪問,該檔案在解凍時間結束前會以標準儲存的儲存費率計算臨時儲存費用。更多資訊,請參見臨時儲存費用。
歸檔類型的Object可達到最長7天的解凍期間,冷歸檔、深度冷歸檔類型的Object可達到最長365天的解凍期間,在此期間不再重複收取資料取回費用。
解凍狀態結束後,Object又回到冷凍狀態,再次執行解凍操作會收取資料取回費用。