**このページは、ボールトと 2012 年リリース当時の REST API を使用する、Amazon Glacier サービスの既存のお客様のみを対象としています。** アーカイブストレージソリューションをお探しの場合は、Amazon S3 の Amazon Glacier ストレージクラス (S3 Glacier Instant Retrieval、S3 Glacier Flexible Retrieval、S3 Glacier Deep Archive) を使用することをお勧めします。これらのストレージオプションの詳細については、「[Amazon Glacier ストレージクラス](https://aws.amazon.com/s3/storage-classes/glacier/)」を参照してください。 Amazon Glacier (元のスタンドアロンボールトベースのサービス) は、新規顧客を受け入れなくなりました。Amazon Glacier は、ボールトにデータを保存する独自の API を備えたスタンドアロンサービスであり、Amazon S3 および Amazon S3 Glacier ストレージクラスとは異なります。既存のデータは Amazon Glacier で無期限に安全性が確保され、引き続きアクセス可能です。移行は必要ありません。低コストの長期アーカイブストレージの場合、 は [Amazon S3 Glacier ストレージクラス](https://aws.amazon.com/s3/storage-classes/glacier/) AWS を推奨します。これにより、S3 バケットベースの APIs、低コスト、 AWS サービス統合で優れたカスタマーエクスペリエンスを実現できます。 AWS リージョン 拡張機能が必要な場合は、[Amazon Glacier ボールトから Amazon S3 Glacier ストレージクラスにデータを転送するためのAWS ソリューションガイダンス](https://aws.amazon.com/solutions/guidance/data-transfer-from-amazon-s3-glacier-vaults-to-amazon-s3/)を使用して、Amazon S3 Glacier ストレージクラスへの移行を検討してください。 翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # パートのリスト (GET uploadID) ## 説明 このマルチパートアップロードオペレーションは、アップロード ID によって識別される特定のマルチパートアップロードでアップロードしたアーカイブのパートをリスト表示します。マルチパートアップロードの詳細については、「[パート単位での大きなアーカイブのアップロード (マルチパートアップロード)](uploading-archive-mpu.md)」を参照してください。 このリクエストは、マルチパートアップロードの完了前であれば、マルチパートアップロードの進行中にいつでも実行できます。Amazon Glacier は、各パートのアップロードで指定した範囲でソートされたパート表を返します。マルチパートアップロードの完了後にパートのリストのリクエストを送信すると、Amazon Glacier はエラーを返します。 パートのリストオペレーションはページ分割をサポートしています。レスポンス本文の `Marker` フィールドに、リストの続きを表示するためのマーカーが含まれているかどうかを常に確認する必要があります。項目がそれ以上存在しない場合、`marker` フィールドは `null` です。`marker` が null でない場合にパートの次のセットを取得するには、前のパートのリストのリクエストの結果として Amazon Glacier が返したマーカー値を `marker` リクエストパラメータに設定して、新たにパートのリストのリクエストを送信します。 リクエストで `limit` パラメータを指定して、レスポンスで返されるパート数を制限することもできます。 ## リクエスト ### 構文 マルチパートアップロード進行中のパートをリストするには、マルチパートアップロード ID リソースの URI に `GET` リクエストを送信します。マルチパートアップロードを開始すると、マルチパートアップロード ID が返されます ([マルチパートアップロードの開始 (POST multipart-uploads)](api-multipart-initiate-upload.md))。オプションで `marker` パラメータと `limit` パラメータを指定できます。 ``` 1. GET /AccountId/vaults/VaultName/multipart-uploads/uploadID HTTP/1.1 2. Host: glacier.Region.amazonaws.com 3. Date: Date 4. Authorization: SignatureValue 5. 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` を指定する必要があります。 タイプ: 文字列 制約: なし | いいえ | ### リクエストヘッダー この操作はほとんどのレスポンスに共通のレスポンスヘッダーのみを使用します。共通のレスポンスヘッダーの詳細については、「[共通のレスポンスヘッダー](api-common-response-headers.md)」を参照してください。 ### リクエスト本文 この操作にリクエストボディはありません。 ## レスポンス ### 構文 ``` 1. HTTP/1.1 200 OK 2. x-amzn-RequestId: x-amzn-RequestId 3. Date: Date 4. Content-Type: application/json 5. Content-Length: Length 6. 7. { 8. "ArchiveDescription" : String, 9. "CreationDate" : String, 10. "Marker": String, 11. "MultipartUploadId" : String, 12. "PartSizeInBytes" : Number, 13. "Parts" : 14. [ { 15. "RangeInBytes" : String, 16. "SHA256TreeHash" : String 17. }, 18. ... 19. ], 20. "VaultARN" : String 21. } ``` ### レスポンスヘッダー この操作はほとんどのレスポンスに共通のレスポンスヘッダーのみを使用します。共通のレスポンスヘッダーの詳細については、「[共通のレスポンスヘッダー](api-common-response-headers.md)」を参照してください。 ### レスポンス本文 レスポンス本文には次の JSON フィールドが含まれています。 **ArchiveDescription** マルチパートアップロードの開始リクエストに指定されたアーカイブの説明。マルチパートアップロードの開始オペレーションでアーカイブの説明が指定されていなければ、このフィールドは `null` です。 *タイプ*: 文字列 **CreationDate** マルチパートアップロードが開始された UTC 時間。 *型*: 文字列 たとえば、ISO 8601 の日付形式の文字列表現。`2013-03-20T17:03:43.221Z`。 **Marker** 結果のページ分割をどこから継続するかを表す不透明な文字列。リストに含まれるジョブをさらに取得するには、パートのリストの新規リクエストで `marker` を使用します。これ以上のパートが存在しない場合は、この値は `null` です。 *タイプ*: 文字列 **MultipartUploadId** パートに関連しているアップロードの ID。 *タイプ*: 文字列 **PartSizeInBytes** パートのサイズ (バイト単位)。これはマルチパートアップロードの開始リクエストで指定したものと同じ値です。 *タイプ:* 数値 **Parts** マルチパートアップロードのパートサイズのリスト。配列内の各オブジェクトは、`RangeBytes` と `sha256-tree-hash` の名前と値のペアを含みます。 *型*: 配列 **RangeInBytes** 範囲の上限を含む、パートのバイト範囲。 *タイプ*: 文字列 **SHA256TreeHash** 対象のパートについて Amazon Glacier が計算した SHA256 木構造ハッシュ値。このフィールドが `null` になることはありません。 *タイプ*: 文字列 **VaultARN** マルチパートアップロードが開始されたボールトの Amazon リソースネーム（ARN）。 *タイプ*: 文字列 ### エラー Amazon Glacier の例外とエラーメッセージについては、「[エラーレスポンス](api-error-responses.md)」を参照してください。 ## 例 ### 例: マルチパートアップロードのパートのリスト 以下の例は、アップロードのすべてのパートをリストします。この例では、進行中のマルチパートアップロードに対する特定のマルチパートアップロード ID の URI に HTTP `GET` リクエストを送信し、その結果、最大 1,000 パートが返されます。 #### リクエストの例 ``` 1. GET /-/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE HTTP/1.1 2. Host: glacier.us-west-2.amazonaws.com 3. x-amz-Date: 20170210T120000Z 4. x-amz-glacier-version: 2012-06-01 5. 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 に関連するアップロード済みパートのリストを返します。この例では、パートは 2 つのみです。返される `Marker` フィールドは `null` であり、マルチパートアップロードにはこれ以上のパートがないことを示します。 ``` 1. HTTP/1.1 200 OK 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q 3. Date: Wed, 10 Feb 2017 12:00:00 GMT 4. Content-Type: application/json 5. Content-Length: 412 6. 7. { 8. "ArchiveDescription" : "archive description", 9. "CreationDate" : "2012-03-20T17:03:43.221Z", 10. "Marker": null, 11. "MultipartUploadId" : "OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE", 12. "PartSizeInBytes" : 4194304, 13. "Parts" : 14. [ { 15. "RangeInBytes" : "0-4194303", 16. "SHA256TreeHash" : "01d34dabf7be316472c93b1ef80721f5d4" 17. }, 18. { 19. "RangeInBytes" : "4194304-8388607", 20. "SHA256TreeHash" : "0195875365afda349fc21c84c099987164" 21. }], 22. "VaultARN" : "arn:aws:glacier:us-west-2:012345678901:vaults/demo1-vault" 23. } ``` ### 例: マルチパートアップロードのパートのリスト (マーカーとリクエスト制限のパラメータを指定) 以下の例は、ページ分割を使用して結果の取得数を制限する方法を示しています。この例では、進行中のマルチパートアップロードに対する特定のマルチパートアップロード ID の URI に HTTP `GET` リクエストを送信し、その結果、1 パートが返されます。開始 `marker` パラメータは、パートリストを開始するパーツを指定します。パートリストに対する以前のリクエストで得られたレスポンスから、`marker` 値を取得できます。さらにこの例では、`limit` パラメータが 1 に設定されるため、1 つのパートが返されます。`Marker` フィールドが `null` ではないことに注目してください。取得できるパートが少なくともあと 1 つはあることを示しています。 #### リクエストの例 ``` 1. GET /-/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE?marker=1001&limit=1 HTTP/1.1 2. Host: glacier.us-west-2.amazonaws.com 3. x-amz-Date: 20170210T120000Z 4. x-amz-glacier-version: 2012-06-01 5. 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 に関連するアップロード済みパートのリストを返します。 ``` 1. HTTP/1.1 200 OK 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q 3. Date: Wed, 10 Feb 2017 12:00:00 GMT 4. Content-Type: text/json 5. Content-Length: 412 6. 7. { 8. "ArchiveDescription" : "archive description 1", 9. "CreationDate" : "2012-03-20T17:03:43.221Z", 10. "Marker": "MfgsKHVjbQ6EldVl72bn3_n5h2TaGZQUO-Qb3B9j3TITf7WajQ", 11. "MultipartUploadId" : "OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE", 12. "PartSizeInBytes" : 4194304, 13. "Parts" : 14. [ { 15. "RangeInBytes" : "4194304-8388607", 16. "SHA256TreeHash" : "01d34dabf7be316472c93b1ef80721f5d4" 17. }], 18. "VaultARN" : "arn:aws:glacier:us-west-2:012345678901:vaults/demo1-vault" 19. } ``` ## 関連するセクション + [マルチパートアップロードの開始 (POST multipart-uploads)](api-multipart-initiate-upload.md) + [パートのアップロード (PUT uploadID)](api-upload-part.md) + [マルチパートアップロードの完了 (POST uploadID)](api-multipart-complete-upload.md) + [マルチパートアップロードの中止 (DELETE uploadID)](api-multipart-abort-upload.md) + [マルチパートアップロードのリスト (GET multipart-uploads)](api-multipart-list-uploads.md) + [パート単位での大きなアーカイブのアップロード (マルチパートアップロード)](uploading-archive-mpu.md) + [Amazon Glacier の ID とアクセス管理](security-iam.md)