列出分段上傳 (GET 分段 - 上傳) - Amazon S3 Glacier
描述請求回應範例相關章節

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

如果您要尋找封存儲存解決方案，建議您在 Amazon S3、S3 Glacier Instant Retrieval、S3 Glacier Flexible Retrieval 和 S3 Glacier Deep Archive 中使用 S3 Glacier 儲存類別。若要進一步了解這些儲存選項，請參閱《Amazon S3 使用者指南》中的 S3 Glacier 儲存類別和使用 S3 Glacier 儲存類別的長期資料儲存。 Amazon S3 這些儲存類別使用 Amazon S3 API，適用於所有區域，並且可以在 Amazon S3 主控台中管理。它們提供儲存成本分析、Storage Lens、進階選用加密功能等功能。

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

列出分段上傳 (GET 分段 - 上傳)

描述

這個分段上傳操作列出了用於指定的文件庫的進行中分段上傳。進行中的分段上傳是已由 啟動分段上傳 (POST 分段 - 上傳) 請求啟動，但尚未完成或停止的分段上傳。「列出分段上傳」回應中傳回的清單中，並沒有保證順序。

「列出分段上傳」操作支援分頁。在預設情況下，在回應中這項操作會傳回最多 50 個分段上傳。您應該經常檢查回應內文 marker 欄位中註明可繼續列表的標記，如果沒有其他項目，marker 欄位為 null。

如果 marker 不是 Null，若要擷取下一組分段上傳，可將另一個「列出分段上傳」請求與 marker 請求參數，設定為 Amazon S3 Glacier (S3 Glacier) 為回應您之前「列出分段上傳」請求所傳回的標記值。

請注意這個操作和 清單部分 (GET uploadID) 操作之間的不同。「列出分段上傳」操作列出了文件庫的所有分段上傳。「列出分段」操作會傳回上傳 ID 識別之特定分段上傳部分。

如需有關分段上傳的資訊，請參閱上傳分段中的大型封存 (分段上傳)。

請求

語法

若要列出段上傳，可將 GET 請求傳送到文件庫的 multipart-uploads 子資源的 URI。您可以選擇指定 marker 和 limit 參數。

GET /AccountId/vaults/VaultName/multipart-uploads 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 S3 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

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

回應標頭

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

回應內文

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

ArchiveDescription

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

類型：字串

CreationDate

啟動分段上傳的 UTC 時間。

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

Marker

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

類型：字串

PartSizeInBytes

啟動分段上傳 (POST 分段 - 上傳) 請求中指定的分段大小。這是在上傳的所有部分的大小，除了最後一個分段外，其可能小於此大小。

類型：數字

MultipartUploadId

分段上傳的 ID。

類型：字串

UploadsList

關於分段上傳物件的中繼資料清單。清單中的每一個項目包含一組用於對應上傳的名稱值的配對，包括 ArchiveDescription CreationDate、MultipartUploadId、PartSizeInBytes 和 VaultARN。

類型：陣列

VaultARN

文件庫的 Amazon Resource Name (ARN)，其中包含存檔。

類型：字串

錯誤

如需 Amazon S3 Glacier 例外和錯誤訊息的詳細資訊，請參閱錯誤回應。

範例

範例：列出所有分段上傳

以下範例列出文件庫所有進行中的分段上傳。範例對指定之文件庫的 GET 子資源的 URI 顯示 HTTP multipart-uploads 請求。由於在請求中未指定 marker 和 limit 參數，因此傳回最多 1,000 個進行中分段上傳。

範例請求

GET /-/vaults/examplevault/multipart-uploads 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

回應範例

在回應中，S3 Glacier 針對指定的保存庫傳回所有進行中分段上傳的清單。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: 1054
      
{
  "Marker": null, 
  "UploadsList": [ 
    {
      "ArchiveDescription": "archive 1",
      "CreationDate": "2012-03-19T23:20:59.130Z",
      "MultipartUploadId": "xsQdFIRsfJr20CW2AbZBKpRZAFTZSJIMtL2hYf8mvp8dM0m4RUzlaqoEye6g3h3ecqB_zqwB7zLDMeSWhwo65re4C4Ev",
      "PartSizeInBytes": 4194304,
      "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault"
    }, 
    {
      "ArchiveDescription": "archive 2",
      "CreationDate": "2012-04-01T15:00:00.000Z",
      "MultipartUploadId": "nPyGOnyFcx67qqX7E-0tSGiRi88hHMOwOxR-_jNyM6RjVMFfV29lFqZ3rNsSaWBugg6OP92pRtufeHdQH7ClIpSF6uJc",
      "PartSizeInBytes": 4194304,
      "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault"
    },
    {
      "ArchiveDescription": "archive 3",
      "CreationDate": "2012-03-20T17:03:43.221Z",
      "MultipartUploadId": "qt-RBst_7yO8gVIonIBsAxr2t-db0pE4s8MNeGjKjGdNpuU-cdSAcqG62guwV9r5jh5mLyFPzFEitTpNE7iQfHiu1XoV",
      "PartSizeInBytes": 4194304,
      "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault"
    } 
  ]
}

範例：部分列出分段上傳

以下範例示範如何使用分頁來取得有限數量的結果。範例對指定之文件庫的 GET 子資源的 URI 顯示 HTTP multipart-uploads 請求。在這個範例中，limit 參數設為 1，其表示只傳回清單中一個上傳，而 marker 參數指出傳回清單開始進行的分段上傳 ID。

範例請求

GET /-/vaults/examplevault/multipart-uploads?limit=1&marker=xsQdFIRsfJr20CW2AbZBKpRZAFTZSJIMtL2hYf8mvp8dM0m4RUzlaqoEye6g3h3ecqB_zqwB7zLDMeSWhwo65re4C4Ev 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 S3 Glacier (S3 Glacier) 會針對指定的保存庫傳回一個不超過兩個進行中分段上傳的清單，從指定的標記開始，並傳回兩個結果。

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: 470

{
  "Marker": "qt-RBst_7yO8gVIonIBsAxr2t-db0pE4s8MNeGjKjGdNpuU-cdSAcqG62guwV9r5jh5mLyFPzFEitTpNE7iQfHiu1XoV",
  "UploadsList" : [ 
    {
      "ArchiveDescription": "archive 2",
      "CreationDate": "2012-04-01T15:00:00.000Z",
      "MultipartUploadId": "nPyGOnyFcx67qqX7E-0tSGiRi88hHMOwOxR-_jNyM6RjVMFfV29lFqZ3rNsSaWBugg6OP92pRtufeHdQH7ClIpSF6uJc",
      "PartSizeInBytes": 4194304,
      "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault"
    }
  ]
}