全部產品
Search
文件中心

Object Storage Service:restore(解凍檔案)

更新時間:Nov 02, 2024

如果未開啟歸檔直讀,歸檔類型的Object需要解凍後才能讀取。冷歸檔、深度冷歸檔不支援開啟直讀,冷歸檔、深度冷歸檔類型的Object需要解凍後才能讀取。歸檔類型Object完成解凍通常需要數分鐘。冷歸檔類型Object完成解凍通常需要數小時。深度冷歸檔類型Object完成解凍通常需要12~48小時。解凍時間請以實際為準。本文為您介紹如何通過restore命令解凍檔案。

注意事項

  • 要解凍單個檔案,您必須具有oss:RestoreObject許可權;要按目錄解凍檔案,您必須具有oss:RestoreObjectoss: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分鐘。

  • 冷歸檔類型:

    • Expedited(高優先順序):1小時內完成解凍。

    • Standard(標準):2~5小時內完成解凍。

    • Bulk(批量):5~12小時內完成解凍。

  • 深度冷歸檔類型:

    • Expedited(高優先順序):12小時內完成解凍。

    • Standard(標準):48小時內完成解凍。

當大量操作時,如果對象的儲存類型存在混合情況,且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又回到冷凍狀態,再次執行解凍操作會收取資料取回費用。