：restore-object

注意事項

• 阿里雲帳號預設擁有解凍檔案的許可權。如果您需要通過RAM使用者或者STS的方式進行解凍，您必須擁有oss:RestoreObject許可權。具體操作，請參見為RAM使用者授權自訂的權限原則。

• restore-object只針對歸檔或冷歸檔類型的Object，不適用於標準類型和低頻訪問類型的Object。

• 對于歸檔類型或者冷歸檔類型的Object，如果需要讀取Object，請提前解凍。歸檔類型的Object解凍有分鐘級延遲，冷歸檔類型的Object解凍有數小時延遲。

計費說明

解凍檔案會產生儲存費用、資料取回容量費用、請求費用，如果您解凍的是冷歸檔和深度冷歸檔類型的資料，還會產生臨時儲存費用。

• 儲存費用：歸檔、冷歸檔、深度冷歸檔類型的Object在解凍過程中和完成後，均按照相應的儲存類型計算儲存費用。更多資訊，請參見儲存費用。

• 資料取回容量費用：解凍歸檔、冷歸檔、深度冷歸檔類型的Object會產生資料取回容量費用。更多資訊，請參見資料處理費用。

• 請求費用：

  • 解凍歸檔類型的Object會產生Put類型請求次數費用。更多資訊，請參見請求費用。

  • 解凍冷歸檔、深度冷歸檔類型的Object會產生取回請求次數費用。更多資訊，請參見請求費用。

• 臨時儲存費用：冷歸檔、深度冷歸檔類型的Object在解凍時，會產生一份標準儲存類型的檔案副本用於訪問，該檔案在解凍時間結束前會以標準儲存的儲存費率計算臨時儲存費用。更多資訊，請參見臨時儲存費用。

解凍過程

不同儲存類型的Object的解凍過程相同。Object的解凍過程如下。

1. 初始時，Object處於冷凍狀態。

2. 提交一次解凍請求後，Object處於解凍中狀態。

3. 服務端完成解凍任務後，Object進入解凍狀態。此時您可以讀取Object。

4. 如果Object處於解凍狀態時，再次提交一次解凍請求，Object的解凍狀態期間在原基礎上累加。延長後的總時間長度不能超過每種儲存類型的解凍狀態期間的最大值。

5. 解凍狀態結束後，Object再次返回到冷凍狀態，且不改變Object原有的儲存類型。

解凍消耗時間

解凍不同儲存類型的Object所消耗的時間可參考下表。解凍時間請以實際為準。

解凍配額

• 單個阿里雲帳號在單個地區的冷歸檔類型的Object的解凍配額參考值：平均每秒500個Object，三種解凍優先順序總解凍配額為每天100 TB~120 TB。如您的業務有更高的解凍配額需求，請聯絡支援人員。

• 單個阿里雲帳號在單個地區的深度冷歸檔類型的Object解凍配額參考值：平均每秒100個Object，兩種解凍優先順序總解凍配額為每天10 TB~15 TB。如您的業務有更高的解凍配額需求，請聯絡支援人員。

解凍狀態期間

不同儲存類型的Object處於解凍狀態的期間如下。

命令格式

ossutil api restore-object --bucket value --key value [flags]

--restore-request

--restore-request配置選項既支援XML文法也支援JSON文法，當選項值包含file://首碼時，表示從檔案中讀取配置。

• XML文法：

  <RestoreRequest>
    <Days>integer</Days>
    <JobParameters>
      <Tier>string</Tier>
    </JobParameters>
  </RestoreRequest>

• JSON文法：

  {
    "Days": integer,
    "JobParameters": {
      "Tier": "string"
    }
  }

使用樣本

相關API

restore-object命令對應API介面RestoreObject。關於API中的具體資訊，請參見RestoreObject。