清單部分 (GET uploadID) - Amazon Glacier
說明請求回應範例相關章節

此頁面僅適用於使用 Vaults 和 2012 年原始 REST API 的 Amazon Glacier 服務的現有客戶。

如果您要尋找封存儲存解決方案，建議您在 Amazon Glacier Instant Retrieval、S3 Glacier Flexible Retrieval 和 S3 Glacier Deep Archive 中使用 Amazon Glacier 儲存類別。 Amazon S3 若要進一步了解這些儲存選項，請參閱 Amazon Glacier 儲存類別。

自 2025 年 12 月 15 日起，Amazon Glacier （原始獨立保存庫型服務） 將不再接受新客戶，不會影響現有客戶。Amazon Glacier 是一項獨立服務，具有自己的 APIs，可將資料存放在保存庫中，並與 Amazon S3 和 Amazon S3 Glacier 儲存類別不同。您現有的資料將在 Amazon Glacier 中無限期保持安全且可存取。不需要遷移。對於低成本、長期的封存儲存， AWS 建議採用 Amazon S3 Glacier 儲存類別，透過 S3 儲存貯體型 APIs、完整 AWS 區域 可用性、降低成本 AWS 和服務整合，提供卓越的客戶體驗。如果您想要增強功能，請考慮使用我們的解決方案指南，將資料從 Amazon S3 Glacier 保存庫傳輸至 Amazon S3 Glacier 儲存類別，以遷移至 Amazon S3 Glacier 儲存類別。 AWS Amazon Glacier Amazon S3

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

清單部分 (GET uploadID)

說明

此分段上傳操作列出已上傳到由上傳 ID 識別的特定分段上傳中的封存部分。如需有關分段上傳的資訊，請參閱上傳分段中的大型封存 (分段上傳)。

在完成分段上傳之前，您可以在正在進行的分段上傳期間隨時提出此請求。Amazon Glacier 會傳回按您在每個部分上傳中指定的範圍排序的部分清單。如果您在完成分段上傳後傳送列出組件請求，Amazon Glacier (Amazon Glacier) 會傳回錯誤。

此清單部分操作支援分頁。您應該經常檢查回應內文 Marker 欄位中註明可繼續列表的標記，如果沒有其他項目，marker 欄位為 null。如果 marker 不是 null，若要擷取您傳送的另一組列出組件請求，並將marker請求參數設定為 Amazon Glacier 傳回的標記值，以回應先前的列出組件請求。

您可以透過在請求中指定 limit 參數來限制回應中傳回的部分數量。

請求

語法

要列出正在進行的分段上傳的部分，請將 GET 請求傳送到分段上傳 ID 資源的 URI。當您啟動分段上傳時，將傳回分段上傳 ID (啟動分段上傳 (POST 分段 - 上傳))。您可以選擇指定 marker 和 limit 參數。

GET /AccountId/vaults/VaultName/multipart-uploads/uploadID HTTP/1.1
Host: glacier.Region.amazonaws.com
Date: Date
Authorization: SignatureValue
x-amz-glacier-version: 2012-06-01

注意

AccountId 值是擁有保存庫的帳戶 AWS 帳戶 ID。您可以指定 AWS 帳戶 ID 或選擇性指定單一 '-' （連字號），在這種情況下，Amazon Glacier 會使用與用來簽署請求之登入資料相關聯的 AWS 帳戶 ID。如果您使用帳號 ID，請勿在 ID 中包含任何連字號 ('-')。

請求參數

名稱 描述 必要
limit

所要傳回的部分數量上限。預設限制為 50。傳回的部分數量可能少於指定的限制，但傳回的部分數量永遠不會超過限制。

類型：字串

限制：最小整數值為 1。最大整數值為 50。

 否
marker

用於分頁的不透明字串。marker 指定部分清單應開始的部分。從之前的清單部分回應的回應中獲取 marker 值。如果您要繼續對之前的清單部分請求中開始的結果進行分頁，則只需包含 marker。

類型：字串

限制條件：無

 否

請求標頭

此操作僅使用大部分回應常見的回應標頭。如需常見回應標頭的資訊，請參閱 常見回應標頭。

請求主體

此操作沒有請求內文。

回應

語法

HTTP/1.1 200 OK
x-amzn-RequestId: x-amzn-RequestId
Date: Date
Content-Type: application/json
Content-Length: Length

{
    "ArchiveDescription" : String,
    "CreationDate" : String,
    "Marker": String,
    "MultipartUploadId" : String,
    "PartSizeInBytes" : Number,
    "Parts" : 
    [ {
      "RangeInBytes" : String,
      "SHA256TreeHash" : String
      },
      ...
     ],
    "VaultARN" : String
}

回應標頭

此操作僅使用大部分回應常見的回應標頭。如需常見回應標頭的資訊，請參閱 常見回應標頭。

回應內文

回應內文包含以下 JSON 欄位。

ArchiveDescription

在啟動分段上傳請求中指定的封存說明。如果在啟動分段上傳操作中未指定封存說明，則此欄位為 null。

類型：字串

CreationDate

啟動分段上傳的 UTC 時間。

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

Marker

一個不透明字串，表示繼續結果分頁之處。您可以在新的清單部分請求中使用 marker 來取得清單中的更多任務。如果沒有更多的部分列出，則此值為 null。

類型：字串

MultipartUploadId

與部分關聯的上傳的 ID。

類型：字串

PartSizeInBytes

部分大小 (以位元組為單位)。這與您在啟動分段上傳請求中指定的值相同。

類型：數字

部分

分段上傳的部分大小清單。陣列中的每個物件都包含 RangeBytes 和 sha256-tree-hash 名稱/值對。

類型：陣列

RangeInBytes

部分的位元組範圍，包含範圍的上限值。

類型：字串

SHA256TreeHash

Amazon Glacier 為組件計算的 SHA256 樹雜湊值。此欄位永遠不為 null。

類型：字串

VaultARN

啟動分段上傳的文件庫的 Amazon Resource Name (ARN)。

類型：字串

錯誤

如需 Amazon Glacier 例外狀況和錯誤訊息的相關資訊，請參閱 錯誤回應。

範例

範例：列出分段上傳的部分

以下範例列出了上傳的所有部分。此範例將 HTTP GET 請求傳送到正在進行的分段上傳的特定分段上傳 ID 的 URI，最多可傳回 1,000 個部分。

範例請求

GET /-/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE HTTP/1.1
Host: glacier.us-west-2.amazonaws.com
x-amz-Date: 20170210T120000Z
x-amz-glacier-version: 2012-06-01
Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2

回應範例

在回應中，Amazon Glacier 會傳回與指定分段上傳 ID 相關聯的上傳組件清單。在這個範例中，只有兩個部分。傳回的 Marker 欄位是 null，表示沒有更多部分的分段上傳。

HTTP/1.1 200 OK
x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
Date: Wed, 10 Feb 2017 12:00:00 GMT
Content-Type: application/json
Content-Length: 412
      
{
    "ArchiveDescription" : "archive description",
    "CreationDate" : "2012-03-20T17:03:43.221Z",
    "Marker": null,
    "MultipartUploadId" : "OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE",
    "PartSizeInBytes" : 4194304,
    "Parts" : 
    [ {
      "RangeInBytes" : "0-4194303",
      "SHA256TreeHash" : "01d34dabf7be316472c93b1ef80721f5d4"
      },
      {
      "RangeInBytes" : "4194304-8388607",
      "SHA256TreeHash" : "0195875365afda349fc21c84c099987164"
      }],
    "VaultARN" : "arn:aws:glacier:us-west-2:012345678901:vaults/demo1-vault"
}

範例：列出分段上傳的部分 (指定標記和限制請求參數)

以下範例示範如何使用分頁來取得有限數量的結果。此範例將 HTTP GET 請求傳送到正在進行的分段上傳的特定分段上傳 ID 的 URI，以傳回一部分。起始 marker 參數指定在哪些部分上啟動部分清單。您可以從對部分清單的上一個請求的回應中獲取 marker 值。此外，在這個範例中，limit 參數設為 1 和傳回一個部分。請注意，Marker 欄位不是 null，表示至少還有一個要獲取的部分。

範例請求

GET /-/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE?marker=1001&limit=1 HTTP/1.1
Host: glacier.us-west-2.amazonaws.com
x-amz-Date: 20170210T120000Z
x-amz-glacier-version: 2012-06-01
Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2

回應範例

在回應中，Amazon Glacier 會傳回與指定進行中分段上傳 ID 相關聯的上傳組件清單。

HTTP/1.1 200 OK
x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
Date: Wed, 10 Feb 2017 12:00:00 GMT
Content-Type: text/json
Content-Length: 412
      
{
    "ArchiveDescription" : "archive description 1",
    "CreationDate" : "2012-03-20T17:03:43.221Z",
    "Marker": "MfgsKHVjbQ6EldVl72bn3_n5h2TaGZQUO-Qb3B9j3TITf7WajQ",
    "MultipartUploadId" : "OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE",
    "PartSizeInBytes" : 4194304,
    "Parts" : 
    [ {
      "RangeInBytes" : "4194304-8388607",
      "SHA256TreeHash" : "01d34dabf7be316472c93b1ef80721f5d4"
      }],
    "VaultARN" : "arn:aws:glacier:us-west-2:012345678901:vaults/demo1-vault"
}