GlacierJobDescription - Amazon S3 Glacier

此頁面僅適用於使用保管庫和 2012 年起原始 REST API 的 S3 冰川服務的現有客戶。

如果您正在尋找存檔儲存解決方案,我們建議您使用 Amazon S3 中的 S3 Glacier 儲存類別、S3 冰川即時擷取S3 冰川彈性擷取和 S3 Glacier Deep Archive。若要進一步了解這些儲存選項,請參閱 Amazon S3 使用者指南中的 S3 Glacier 儲存類別和使用 S3 Glacier 儲存類別的長期資料儲存。這些儲存類別使用 Amazon S3 API,可在所有區域使用,並且可以在 Amazon S3 主控台中管理。它們提供了諸如存儲成本分析,存儲鏡頭,包括多種加密選項的安全功能等功能。

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

GlacierJobDescription

包含 Amazon S3 Glacier (S3 Glacier) 任務的說明。

目錄

Action

工作類型。它是 ArchiveRetrievalInventoryRetrievalSelect

類型:字串

封存

針對選擇或封存擷取任務請求的封存 ID。否則,此欄位為 null

類型:字串

ArchiveSHA256TreeHash

用於封存擷取的整個封存的 SHA256 樹狀雜湊。對於庫存擷取作業,此欄位為 null

類型:字串

ArchiveSizeInBytes

對於 ArchiveRetrieval 任務,這是請求下載的封存的大小,以位元組為單位。對於 InventoryRetrieval 任務,值為 null

類型:數字

已完成

如果任務完成後,則為 true 否則為 false

類型:布林值

CompletionDate

任務完成的日期。

任務請求完成的國際標準時間 (UTC) 的時間。當任務正在進行時,該值為空。

類型:ISO 8601 日期格式的字串表示法,例如,2013-03-20T17:03:43.221Z

CreationDate

任務開始的國際標準時間 (UTC) 日期。

類型:ISO 8601 日期格式的字串表示法,例如,2013-03-20T17:03:43.221Z

InventoryRetrievalParameters

用於各種庫存擷取的輸入參數。

類型InventoryRetrievalJobInput物件

InventorySizeInBytes

對於 InventoryRetrieval 任務,這是請求下載的庫存的大小,以位元組為單位。對於 ArchiveRetrievalSelect 任務,值為 null

類型:數字

JobDescription

當您啟動的任務所提供的任務說明。

類型:字串

JobId

在 S3 Glacier 中識別任務的 ID。

類型:字串

JobOutputPath

包含任務輸出位置。

類型:字串

OutputLocation

一個物件,其中包含有關儲存選取任務結果和錯誤的位置的資訊。

類型OutputLocation物件

RetrievalByteRange

用於封存擷取任務的擷取位元組範圍,格式為「StartByteValue-EndByteValue。」 如果封存擷取中沒有指定範圍, 則擷取整個封存,StartByteValue 等於 0,而 EndByteValue 等於封存的大小減去 1。對於庫存擷取作業,此欄位為 null

類型:字串

SelectParameters

一個物件,其中包含有關用於選擇的參數的資訊。

類型SelectParameters物件

SHA256TreeHash

所請求的封存範圍的 SHA256 樹狀雜湊值。如果對封存的 啟動任務 (POST 任務) 請求指定了樹狀雜湊值的範圍,則此欄位會傳回一個值。如需關於封存範圍擷取的樹狀雜湊值的詳細資訊,請參閱 下載資料時接收檢查總和

對於擷取整個封存的特定案例,此值與 ArchiveSHA256TreeHash 值相同。

此欄位在以下情況下為 null

  • 封存擷取任務所指定的範圍不符合樹狀雜湊。

  • 指定與整個封存和任務狀態相等的範圍的封存任務是 InProgress

  • 庫存任務

  • 選取任務。

類型:字串

SNSTopic

如果在任務啟動 (啟動任務 (POST 任務)) 中設定了通知,則 Amazon Resource Name (ARN) 代表傳送任務完成或失敗的通知的 Amazon SNS 主題。

類型:字串

StatusCode

表示任務狀態的代碼。

有效值InProgress | Succeeded | Failed

類型:字串

StatusMessage

任務狀態訊息。

類型:字串

用於選擇或封存擷取的資料存方案。

有效值Expedited | Standard | Bulk

類型:字串

VaultARN

該任務是子資源的文件庫 ARN。

類型:字串

詳細資訊