**このページは、ボールトと 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 multipart-uploads)
## 説明
このマルチパートアップロードオペレーションでは、指定されたボールトの進行中のマルチパートアップロードのリストを表示します。進行中のマルチパートアップロードとは、[マルチパートアップロードの開始 (POST multipart-uploads)](api-multipart-initiate-upload.md) リクエストによって開始されているものの、まだ完了または中止されていないマルチパートアップロードです。マルチパートアップロードのリストのレスポンスで返されるリストの順序は保証されていません。
マルチパートアップロードのリストオペレーションでは、ページ分割をサポートしています。このオペレーションによってレスポンスに返されるマルチパートアップロードは、デフォルトで最大 50 個です。レスポンス本文の `marker` フィールドに、リストの続きを表示するためのマーカーが含まれているかどうかを常に確認する必要があります。項目がそれ以上存在しない場合、 `marker` フィールドは `null` です。
`marker` が null でない場合に、マルチパートアップロードの次のセットを取得するには、前のマルチパートアップロードのリストのリクエストの結果として Amazon Glacier が返したマーカー値を `marker` リクエストパラメータに設定して、別のマルチパートアップロードのリストのリクエストを送信します。
このオペレーションと [パートのリスト (GET uploadID)](api-multipart-list-parts.md) オペレーションの違いに注意してください。マルチパートアップロードのリストオペレーションでは、ボールトのすべてのマルチパートアップロードのリストを表示します。パートのリストオペレーションでは、アップロード ID によって識別される特定のマルチパートアップロードのパートが返されます。
マルチパートアップロードの詳細については、「[パート単位での大きなアーカイブのアップロード (マルチパートアップロード)](uploading-archive-mpu.md)」を参照してください。
## リクエスト
### 構文
マルチパートアップロードのリストを表示するには、ボールトの `GET` サブリソースの URI に `multipart-uploads` リクエストを送信します。オプションで `marker` パラメータと `limit` パラメータを指定できます。
```
1. GET /{{AccountId}}/vaults/{{VaultName}}/multipart-uploads 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. "Marker": String,
9. "UploadsList" : [
10. {
11. "ArchiveDescription": String,
12. "CreationDate": String,
13. "MultipartUploadId": String,
14. "PartSizeInBytes": Number,
15. "VaultARN": String
16. },
17. ...
18. ]
19. }
```
### レスポンスヘッダー
この操作はほとんどのレスポンスに共通のレスポンスヘッダーのみを使用します。共通のレスポンスヘッダーの詳細については、「[共通のレスポンスヘッダー](api-common-response-headers.md)」を参照してください。
### レスポンス本文
レスポンス本文には次の JSON フィールドが含まれています。
**ArchiveDescription**
マルチパートアップロードの開始リクエストに指定されたアーカイブの説明。マルチパートアップロードの開始オペレーションでアーカイブの説明が指定されていなければ、このフィールドは `null` です。
*タイプ*: 文字列
**CreationDate**
マルチパートアップロードが開始された UTC 時間。
*型*: 文字列 たとえば、ISO 8601 の日付形式の文字列表現。`2013-03-20T17:03:43.221Z`。
**Marker**
結果のページ分割をどこから継続するかを表す不透明な文字列。リストに含まれるアップロードをさらに取得するには、マルチパートアップロードのリストの新規リクエストで `marker` を使用します。アップロードがそれ以上存在しない場合、この値は `null` です。
*タイプ*: 文字列
**PartSizeInBytes**
[マルチパートアップロードの開始 (POST multipart-uploads)](api-multipart-initiate-upload.md) リクエストで指定されたパートサイズ。これは、アップロードのすべてのパートのサイズです。ただし、最後のパートは、このサイズより小さくなる場合があります。
*タイプ:* 数値
**MultipartUploadId**
マルチパートアップロードの ID。
*タイプ*: 文字列
**UploadsList**
マルチパートアップロードのオブジェクトに関するメタデータのリスト。`ArchiveDescription`、`CreationDate`、`MultipartUploadId`、`PartSizeInBytes`、`VaultARN` など、対応するアップロードの名前と値のペアのセットを含むリスト内の各項目。
*型*: 配列
**VaultARN**
アーカイブを含むボールトの Amazon リソースネーム（ARN）。
*タイプ*: 文字列
### エラー
Amazon Glacier の例外とエラーメッセージについては、「[エラーレスポンス](api-error-responses.md)」を参照してください。
## 例
### 例: すべてのマルチパートアップロードのリスト
次の例では、ボールトの進行中のすべてのマルチパートアップロードのリストを表示します。この例では、指定されたボールトの `GET` サブリソースの URI に対する HTTP `multipart-uploads` リクエストを示しています。リクエストでは、`marker` および `limit` パラメータが指定されていないため、最大 1,000 個の進行中のマルチパートアップロードが返されます。
#### リクエストの例
```
1. GET /-/vaults/examplevault/multipart-uploads 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 により、指定されたボールトの進行中のすべてのマルチパートアップロードのリストが返されます。`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: 1054
6.
7. {
8. "Marker": null,
9. "UploadsList": [
10. {
11. "ArchiveDescription": "archive 1",
12. "CreationDate": "2012-03-19T23:20:59.130Z",
13. "MultipartUploadId": "xsQdFIRsfJr20CW2AbZBKpRZAFTZSJIMtL2hYf8mvp8dM0m4RUzlaqoEye6g3h3ecqB_zqwB7zLDMeSWhwo65re4C4Ev",
14. "PartSizeInBytes": 4194304,
15. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault"
16. },
17. {
18. "ArchiveDescription": "archive 2",
19. "CreationDate": "2012-04-01T15:00:00.000Z",
20. "MultipartUploadId": "nPyGOnyFcx67qqX7E-0tSGiRi88hHMOwOxR-_jNyM6RjVMFfV29lFqZ3rNsSaWBugg6OP92pRtufeHdQH7ClIpSF6uJc",
21. "PartSizeInBytes": 4194304,
22. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault"
23. },
24. {
25. "ArchiveDescription": "archive 3",
26. "CreationDate": "2012-03-20T17:03:43.221Z",
27. "MultipartUploadId": "qt-RBst_7yO8gVIonIBsAxr2t-db0pE4s8MNeGjKjGdNpuU-cdSAcqG62guwV9r5jh5mLyFPzFEitTpNE7iQfHiu1XoV",
28. "PartSizeInBytes": 4194304,
29. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault"
30. }
31. ]
32. }
```
### 例: マルチパートアップロードの部分的なリスト
以下の例は、ページ分割を使用して結果の取得数を制限する方法を示しています。この例では、指定されたボールトの `GET` サブリソースの URI に対する HTTP `multipart-uploads` リクエストを示しています。この例では、`limit` パラメータが 1 に設定されています。そのため、リストに返されるアップロードは 1 つのみで、`marker` パラメータには返されたリストが開始するマルチパートアップロード ID が示されます。
#### リクエストの例
```
1. GET /-/vaults/examplevault/multipart-uploads?limit=1&marker=xsQdFIRsfJr20CW2AbZBKpRZAFTZSJIMtL2hYf8mvp8dM0m4RUzlaqoEye6g3h3ecqB_zqwB7zLDMeSWhwo65re4C4Ev 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 により、指定されたボールトの進行中のマルチパートアップロードのリストが 2 つまで返されます。指定されたマーカーから開始し、2 つの結果が返されます。
```
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: 470
6.
7. {
8. "Marker": "qt-RBst_7yO8gVIonIBsAxr2t-db0pE4s8MNeGjKjGdNpuU-cdSAcqG62guwV9r5jh5mLyFPzFEitTpNE7iQfHiu1XoV",
9. "UploadsList" : [
10. {
11. "ArchiveDescription": "archive 2",
12. "CreationDate": "2012-04-01T15:00:00.000Z",
13. "MultipartUploadId": "nPyGOnyFcx67qqX7E-0tSGiRi88hHMOwOxR-_jNyM6RjVMFfV29lFqZ3rNsSaWBugg6OP92pRtufeHdQH7ClIpSF6uJc",
14. "PartSizeInBytes": 4194304,
15. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault"
16. }
17. ]
18. }
```
## 関連するセクション
+ [マルチパートアップロードの開始 (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 uploadID)](api-multipart-list-parts.md)
+ [パート単位での大きなアーカイブのアップロード (マルチパートアップロード)](uploading-archive-mpu.md)
+ [Amazon Glacier の ID とアクセス管理](security-iam.md)