**このページは、ボールトと 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 ストレージクラスへの移行を検討してください。
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# マルチパートアップロードオペレーション
以下は、Amazon Glacier で使用できるマルチパートアップロードオペレーションです。
**Topics**
+ [マルチパートアップロードの中止 (DELETE uploadID)](api-multipart-abort-upload.md)
+ [マルチパートアップロードの完了 (POST uploadID)](api-multipart-complete-upload.md)
+ [マルチパートアップロードの開始 (POST multipart-uploads)](api-multipart-initiate-upload.md)
+ [パートのリスト (GET uploadID)](api-multipart-list-parts.md)
+ [マルチパートアップロードのリスト (GET multipart-uploads)](api-multipart-list-uploads.md)
+ [パートのアップロード (PUT uploadID)](api-upload-part.md)
# マルチパートアップロードの中止 (DELETE uploadID)
## 説明
このマルチパートアップロードのオペレーションのコマンドは、アップロード ID によって識別されるマルチパートアップロードを中止します。
マルチパートアップロードの中止リクエストが成功すると、そのアップロード ID を使用して、それ以上パートをアップロードすることや、その他のオペレーションを実行することができなくなります。完了済みのマルチパートアップロードを中止した場合は、失敗します。ただし、既に中止したアップロードを中止した場合は、少しの間成功します。
このオペレーションはべき等です。
マルチパートアップロードの詳細については、「[パート単位での大きなアーカイブのアップロード (マルチパートアップロード)](uploading-archive-mpu.md)」を参照してください。
## リクエスト
マルチパートアップロードを中止するには、ボールトの `DELETE` サブリソースの URI に HTTP `multipart-uploads` リクエストを送信し、URI の一部として特定のマルチパートアップロード ID を指定します。
### 構文
```
1. DELETE /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 にハイフン ('-') を含めないでください。
### リクエストパラメーター
このオペレーションはリクエストパラメータを使用しません。
### リクエストヘッダー
このオペレーションは、すべてのオペレーションに共通のリクエストヘッダーのみを使用します。共通のリクエストヘッダーの詳細については、「[一般的なリクエストヘッダー](api-common-request-headers.md)」を参照してください。
### リクエスト本文
この操作にリクエストボディはありません。
## レスポンス
### 構文
```
HTTP/1.1 204 No Content
x-amzn-RequestId: x-amzn-RequestId
Date: Date
```
### レスポンスヘッダー
この操作はほとんどのレスポンスに共通のレスポンスヘッダーのみを使用します。共通のレスポンスヘッダーの詳細については、「[共通のレスポンスヘッダー](api-common-response-headers.md)」を参照してください。
### レスポンス本文
このオペレーションはレスポンス本文を返しません。
### エラー
Amazon Glacier の例外とエラーメッセージについては、「[エラーレスポンス](api-error-responses.md)」を参照してください。
## 例
### リクエストの例
以下に、マルチパートアップロード ID リソースの URI に `DELETE` リクエストを送信する例を示します。
```
1. DELETE /-/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
```
### レスポンスの例
```
1. HTTP/1.1 204 No Content
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. Date: Wed, 10 Feb 2017 12:00:00 GMT
```
## 関連するセクション
+ [マルチパートアップロードの開始 (POST multipart-uploads)](api-multipart-initiate-upload.md)
+ [パートのアップロード (PUT uploadID)](api-upload-part.md)
+ [マルチパートアップロードの完了 (POST uploadID)](api-multipart-complete-upload.md)
+ [マルチパートアップロードのリスト (GET multipart-uploads)](api-multipart-list-uploads.md)
+ [パートのリスト (GET uploadID)](api-multipart-list-parts.md)
+ [パート単位での大きなアーカイブのアップロード (マルチパートアップロード)](uploading-archive-mpu.md)
+ [Amazon Glacier の ID とアクセス管理](security-iam.md)
# マルチパートアップロードの完了 (POST uploadID)
## 説明
アーカイブのすべてのパートがアップロードされ、アップロードされたパートからアーカイブをアセンブルする準備ができたことを Amazon Glacier に通知するには、このマルチパートアップロードオペレーションを呼び出します。
マルチパートアップロードの詳細については、「[パート単位での大きなアーカイブのアップロード (マルチパートアップロード)](uploading-archive-mpu.md)」を参照してください。
Amazon Glacier では、アーカイブをアセンブルして、ボールトに保存した後、新しく作成されたアーカイブリソースのアーカイブ ID を返します。アーカイブをアップロードしたら、後でアーカイブを取得するために、返されたアーカイブ ID を保管しておく必要があります。
アップロードしたアーカイブ全体の SHA256 木構造ハッシュを計算してリクエストに含める必要があります。SHA256 木構造ハッシュの計算の詳細については、「[チェックサムの計算](checksum-calculations.md)」を参照してください。サーバー側でも、Amazon Glacier によりアセンブルされたアーカイブの SHA256 木構造ハッシュが作成されます。値が一致した場合は、Amazon Glacier によってボールトにアーカイブが保存されます。値が一致しない場合は、エラーが返され、オペレーションは失敗します。[パートのリスト (GET uploadID)](api-multipart-list-parts.md) オペレーションでは、特定のマルチパートアップロードでアップロードされたパートのリストが返されます。そのリストには、アップロード済みの各パートのチェックサム情報が含まれおり、チェックサムの誤りをデバッグするために使用することができます。
さらに、Amazon Glacier は不足しているコンテンツ範囲がないかを確認します。パートをアップロードするときに、最終的にアセンブルされたアーカイブ内でのパートの位置を特定できるように範囲の値を指定します。最終的にアーカイブをアセンブルする際、Amazon Glacier は不足しているコンテンツ範囲がないかを確認します。不足しているコンテンツ範囲がある場合、Amazon Glacier はエラーを返し、マルチパートアップロードの完了オペレーションは失敗します。
マルチパートアップロードの完了オペレーションはべき等です。マルチパートアップロードが初めて正常に完了してから短期間内にこのオペレーションを再度呼び出した場合、オペレーションは成功し、同じアーカイブ ID が返されます。これは、ネットワークの問題が発生して、接続が中断されたり、500 サーバーエラーを受け取ったりした場合に役に立ちます。このような問題が起きた場合に、マルチパートアップロードの完了リクエストを再度実行し、アーカイブが重複して作成されることなく、同じアーカイブ ID を取得できます。ただし、マルチパートアップロードの完了後、パートのリストオペレーションを呼び出すことはできません。また、マルチパートアップロードは完了オペレーションがべき等であっても、マルチパートアップロードのリストのレスポンスには表示されません。
## リクエスト
マルチパートアップロードを完了するには、マルチパートアップロードの開始リクエストに対するレスポンスとして Amazon Glacier によって作成されたアップロード ID の URI に、HTTP POST リクエストを送信します。この URI は、パートをアップロードするときに使用した URI と同じです。必須の共通のヘッダーに加えて、アーカイブ全体の SHA256 木構造ハッシュの結果およびアーカイブの合計サイズ（バイト単位）を含める必要があります。
### 構文
```
1. POST /AccountId/vaults/VaultName/multipart-uploads/uploadID
2. Host: glacier.Region.amazonaws.com
3. Date: date
4. Authorization: SignatureValue
5. x-amz-sha256-tree-hash: SHA256 tree hash of the archive
6. x-amz-archive-size: ArchiveSize in bytes
7. x-amz-glacier-version: 2012-06-01
```
**注記**
`AccountId` の値は、ボールトを所有する AWS アカウントの ID です。AWS アカウント ID、または Amazon Glacier がリクエストの署名に使用した認証情報に関連する AWS アカウント ID を使用している場合はオプションで '`-`' (ハイフン) のどちらかを指定できます。アカウント ID を使用する場合は、ID にハイフン ('-') を含めないでください。
### リクエストパラメータ
このオペレーションはリクエストパラメータを使用しません。
### リクエストヘッダー
この操作では、すべての操作で共通のリクエストヘッダーに加えて、次のリクエストヘッダーを使用します。共通のリクエストヘッダーの詳細については、「[一般的なリクエストヘッダー](api-common-request-headers.md)」を参照してください。
| 名前 | 説明 | 必須 |
| --- | --- | --- |
| x-amz-archive-size | アーカイブ全体の合計サイズ (バイト単位)。この値には、アップロードした個々のパートのすべてのサイズの合計値を指定する必要があります。 タイプ: 文字列 デフォルト: なし 制約: なし | あり |
| x-amz-sha256-tree-hash | アーカイブ全体の SHA256 木構造ハッシュ。個々のパートの SHA256 木構造ハッシュの木構造ハッシュです。リクエストに指定した値が、Amazon Glacier によって計算された、最終的にアセンブルされたアーカイブの SHA256 木構造ハッシュと一致しない場合、Amazon Glacier はエラーを返し、リクエストは失敗します。 タイプ: 文字列 デフォルト: なし 制約: なし | あり |
### リクエストの要素
このオペレーションではリクエストの要素を使用しません。
## レスポンス
Amazon Glacier により、アーカイブ全体の SHA256 木構造ハッシュが作成されます。値が、ユーザーがリクエストで指定したアーカイブ全体の SHA256 木構造ハッシュと一致する場合、Amazon Glacier はそのアーカイブをボールトに追加します。レスポンスでは、新しく追加されたアーカイブリソースの URL パスを含む HTTP `Location` ヘッダーが返されます。リクエストで送信したアーカイブのサイズまたは SHA256 木構造ハッシュが一致しない場合、Amazon Glacier によってエラーが返され、アップロードは未完了の状態のままになります。後で正確な値を使用してマルチパートアップロードの完了オペレーションを再試行できます。再試行により、アーカイブを正常に作成することができます。マルチパートアップロードが完了しない場合、最終的に Amazon Glacier はアップロード ID を再利用します。
### 構文
```
HTTP/1.1 201 Created
x-amzn-RequestId: x-amzn-RequestId
Date: Date
Location: Location
x-amz-archive-id: ArchiveId
```
### レスポンスヘッダー
成功したレスポンスには、すべての操作に共通のレスポンスヘッダーに加えて、次のレスポンスヘッダーが含まれます。共通のレスポンスヘッダーの詳細については、「[共通のレスポンスヘッダー](api-common-response-headers.md)」を参照してください。
| 名前 | 説明 |
| --- | --- |
| Location | 新しく作成したアーカイブの相対 URI パス。この URL には、Amazon Glacier によって生成されたアーカイブ ID が含まれます。 タイプ: 文字列 |
| x-amz-archive-id | アーカイブの ID。この値も `Location` ヘッダーの一部として含まれます。 タイプ: 文字列 |
### レスポンスのフィールド
このオペレーションはレスポンス本文を返しません。
## 例
### リクエストの例
この例では、マルチパートアップロードの開始リクエストで返された URI に HTTP POST リクエストを送信します。リクエストでは、アーカイブ全体の SHA256 木構造ハッシュとアーカイブの合計サイズの両方を指定します。
```
1. POST /-/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. z-amz-Date: 20170210T120000Z
4. x-amz-sha256-tree-hash:1ffc0f54dd5fdd66b62da70d25edacd0
5. x-amz-archive-size:8388608
6. x-amz-glacier-version: 2012-06-01
7. 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 201 Created
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. Date: Wed, 10 Feb 2017 12:00:00 GMT
4. Location: /111122223333/vaults/examplevault/archives/NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId
5. x-amz-archive-id: NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId
```
新しく追加されたリソース/アーカイブの URI に HTTP リクエストを送信できます。たとえば、アーカイブを取得するために GET リクエストを送信できます。
## 関連するセクション
+ [マルチパートアップロードの開始 (POST multipart-uploads)](api-multipart-initiate-upload.md)
+ [パートのアップロード (PUT uploadID)](api-upload-part.md)
+ [マルチパートアップロードの中止 (DELETE uploadID)](api-multipart-abort-upload.md)
+ [マルチパートアップロードのリスト (GET multipart-uploads)](api-multipart-list-uploads.md)
+ [パートのリスト (GET uploadID)](api-multipart-list-parts.md)
+ [パート単位での大きなアーカイブのアップロード (マルチパートアップロード)](uploading-archive-mpu.md)
+ [アーカイブの削除 (DELETE archive)](api-archive-delete.md)
+ [Amazon Glacier の ID とアクセス管理](security-iam.md)
# マルチパートアップロードの開始 (POST multipart-uploads)
## 説明
この操作では、マルチパートアップロードを開始します ([パート単位での大きなアーカイブのアップロード (マルチパートアップロード)](uploading-archive-mpu.md)を参照してください。)。Amazon Glacier により、マルチパートアップロードリソースが作成され、レスポンスとしてその ID が返されます。後続のマルチパートアップロードオペレーションでは、このアップロード ID を使用します。
マルチパートアップロードを開始する際に、パートサイズをバイト単位で指定します。パートサイズは、メビバイト (MiB) (1024 キビバイト [KiB]) に 2 の累乗を乗じた値であることが必要です。例えば、1048576 (1 MiB)、2097152 (2 MiB)、4194304 (4 MiB)、8388608 (8 MiB) などです。許容される最小のパートサイズは 1 MiB で、最大は 4 ギビバイト (GiB) です。
このアップロード ID を使用してアップロードするパートは、最後のパートを除き、すべて同じサイズになります。最後のパートは、同じサイズ以下になります。たとえば、16.2 MiB のファイルをアップロードするとします。4 MiB のパートサイズでマルチパートアップロードを開始した場合、各 4 MiB のパートが 4 つと 0.2 MiB のパートが 1 つアップロードされます。
**注記**
Amazon Glacier ではアーカイブ全体のサイズを指定する必要がないため、マルチパートアップロードを開始する際にアーカイブのサイズを把握している必要はありません。
マルチパートアップロードが完了すると、Amazon Glacier は ID によって参照されるマルチパートアップロードリソースを削除します。マルチパートアップロードがキャンセルされた場合も、Amazon Glacier はマルチパートアップロードリソースを削除します。24 時間アクティビティがない場合にも、削除される場合があります。ID は 24 時間後も引き続き使用できる場合がありますが、アプリケーションでこの動作を想定しないでください。
## リクエスト
マルチパートアップロードを開始するには、アーカイブの保存先となるボールトの `POST` サブリソースの URI に HTTP `multipart-uploads` リクエストを送信します。リクエストにはパートサイズを含める必要があります。また、オプションでアーカイブの説明を含めることができます。
### 構文
```
1. POST /AccountId/vaults/VaultName/multipart-uploads
2. Host: glacier.us-west-2.amazonaws.com
3. Date: Date
4. Authorization: SignatureValue
5. x-amz-glacier-version: 2012-06-01
6. x-amz-archive-description: ArchiveDescription
7. x-amz-part-size: PartSize
```
**注記**
`AccountId` 値は、ボールトを所有するアカウントの AWS アカウント ID です。 AWS アカウント ID またはオプションで単一の '`-`' (ハイフン) を指定できます。この場合、Amazon Glacier はリクエストの署名に使用される認証情報に関連付けられた AWS アカウント ID を使用します。アカウント ID を使用する場合は、ID にハイフン ('-') を含めないでください。
### リクエストパラメーター
このオペレーションはリクエストパラメータを使用しません。
### リクエストヘッダー
この操作では、すべての操作で共通のリクエストヘッダーに加えて、次のリクエストヘッダーを使用します。共通のリクエストヘッダーの詳細については、「[一般的なリクエストヘッダー](api-common-request-headers.md)」を参照してください。
| 名前 | 説明 | 必須 |
| --- | --- | --- |
| x-amz-part-size | 最後を除く各パートのサイズ (バイト単位)。最後のパートはこのパートサイズより小さくなる場合があります。 タイプ: 文字列 デフォルト: なし 制約: パートサイズは、メビバイト (1024 KiB) に 2 の累乗を乗じた値であることが必要です。例えば、1048576 (1 MiB)、2097152 (2 MiB)、4194304 (4 MiB)、8388608 (8 MiB) などです。許容される最小のパートサイズは 1 MiB で、最大は 4 GiB (4096 MiB) です。 | はい |
| x-amz-archive-description | パート単位でアップロードするアーカイブの説明。わかりやすい説明や、割り当てる何らかの一意の識別子を自分で選択して指定できます。ボールトインベントリを取得した場合 (「[ジョブの開始 (ジョブの POST)](api-initiate-job-post.md)」を参照)、レスポンスに返されるアーカイブごとにこの説明がインベントリに含まれます。アーカイブの説明の先頭の空白は削除されます。 タイプ: 文字列 デフォルト: なし 制約事項: 説明は 1024 バイト以下である必要があります。使用可能な文字は、制御コードを除く 7 ビット ASCII コードです。具体的には、32～126 (10 進) または 0x20～0x7E (16 進) の ASCII 値です。 | いいえ |
### リクエスト本文
この操作にリクエストボディはありません。
## レスポンス
レスポンスでは、Amazon Glacier は ID によって識別されたマルチパートアップロードリソースを作成し、マルチパートアップロード ID の相対 URI パスを返します。
### 構文
```
1. HTTP/1.1 201 Created
2. x-amzn-RequestId: x-amzn-RequestId
3. Date: Date
4. Location: Location
5. x-amz-multipart-upload-id: multiPartUploadId
```
### レスポンスヘッダー
成功したレスポンスには、すべての操作に共通のレスポンスヘッダーに加えて、次のレスポンスヘッダーが含まれます。共通のレスポンスヘッダーの詳細については、「[共通のレスポンスヘッダー](api-common-response-headers.md)」を参照してください。
| 名前 | 説明 |
| --- | --- |
| Location | Amazon Glacier によって作成されたマルチパートアップロード ID の相対 URI パス。この URI パス を使用して、パートをアップロードするリクエストの範囲を指定し、マルチパートアップロードを完了します。 タイプ: 文字列 |
| x-amz-multipart-upload-id | マルチパートアップロードの ID。この値も `Location` ヘッダーの一部として含まれます。 タイプ: 文字列 |
### レスポンス本文
このオペレーションはレスポンス本文を返しません。
### エラー
Amazon Glacier の例外とエラーメッセージについては、「[エラーレスポンス](api-error-responses.md)」を参照してください。
## 例
### リクエストの例
次の例では、`POST` というボールトの `multipart-uploads` サブリソースの URI に HTTP `examplevault` リクエストを送信して、マルチパートアップロードを開始します。リクエストには、4 MiB（4194304 バイト）のパートサイズとオプションのアーカイブの説明を指定するヘッダーが含まれています。
```
1. POST /-/vaults/examplevault/multipart-uploads
2. Host: glacier.us-west-2.amazonaws.com
3. x-amz-Date: 20170210T120000Z
4. x-amz-archive-description: MyArchive-101
5. x-amz-part-size: 4194304
6. x-amz-glacier-version: 2012-06-01
7. 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 により、マルチパートアップロードリソースが作成され、ボールトの `multipart-uploads` サブリソースに追加されます。`Location` レスポンスヘッダーには、マルチパートアップロード ID の相対 URI パスが含まれています。
```
1. HTTP/1.1 201 Created
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. Date: Wed, 10 Feb 2017 12:00:00 GMT
4. Location: /111122223333/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE
5. x-amz-multipart-upload-id: OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE
```
個々のパートのアップロードについては、「[パートのアップロード (PUT uploadID)](api-upload-part.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)
+ [パートのリスト (GET uploadID)](api-multipart-list-parts.md)
+ [アーカイブの削除 (DELETE archive)](api-archive-delete.md)
+ [パート単位での大きなアーカイブのアップロード (マルチパートアップロード)](uploading-archive-mpu.md)
+ [Amazon Glacier の ID とアクセス管理](security-iam.md)
# パートのリスト (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)
# マルチパートアップロードのリスト (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)
# パートのアップロード (PUT uploadID)
## 説明
このマルチパートアップロードオペレーションでは、アーカイブのパートをアップロードします。パートのアップロードのリクエストでは、アセンブル済みのアーカイブの中からこのパートでアップロードするバイト範囲を指定することになるため、任意の順序でアーカイブのパートをアップロードできます。このほか、複数のパートを並行してアップロードすることもできます。マルチパートアップロードでは、最大 10,000 パートをアップロードできます。
マルチパートアップロードの詳細については、「[パート単位での大きなアーカイブのアップロード (マルチパートアップロード)](uploading-archive-mpu.md)」を参照してください。
Amazon Glacier では、以下の条件のいずれかが true のときは、パートのアップロードのリクエストが拒否されます。
+ **SHA256 木構造ハッシュが一致しない-** 送信中にパートデータが破損していないことを確認するため、パートの SHA256 木構造ハッシュを計算し、リクエストに含める必要があります。パートデータを受け取った時点で、Amazon Glacier でも SHA256 木構造ハッシュを計算します。この 2 つのハッシュ値が一致しない場合、オペレーションは失敗となります。SHA256 木構造ハッシュの計算の詳細については、「[チェックサムの計算](checksum-calculations.md)」を参照してください。
+ **SHA256 の線形ハッシュが一致しない-**認可のため、アップロードされるペイロード全体の SHA256 線形ハッシュを計算し、リクエストに含める必要があります。SHA256 線形ハッシュの計算については、「[チェックサムの計算](checksum-calculations.md)」を参照してください。
+ **パートのサイズが一致しない-**(最後のパートを除く) 各パートのサイズは、対応する [マルチパートアップロードの開始 (POST multipart-uploads)](api-multipart-initiate-upload.md) リクエストで指定されているサイズに一致している必要があります。最後のパートのサイズは、指定されたサイズ以下になっていることが必要です。
**注記**
マルチパートアップロードの開始リクエストで指定したサイズよりも小さなサイズのパートをアップロードし、そのパートが最後のパートでない場合でも、パートのアップロードのリクエストは成功します。ただし、次のマルチパートアップロードの完了リクエストは失敗します。
+ **範囲が一致しない-**リクエストのバイト範囲の値が、対応する開始リクエストで指定されているパートサイズと一致しない場合です。たとえば、パートサイズを 4194304 バイト (4 MB) に指定した場合であれば、0-4194303 バイト (4 MB-1) および 4194304 (4 MB) -8388607 (8 MB-1) が有効なパート範囲になります。これに対して、範囲の値を 2 MB～6 MB に設定した場合には、範囲がパートのサイズに一致しないため、アップロードが失敗します。
このオペレーションはべき等です。同じパートを複数回アップロードすると、最新のリクエストに含まれるデータによって、既にアップロードされたデータが上書きされます。
## リクエスト
`PUT`リクエストは、マルチパートアップロードの開始リクエストによって返されるアップロード ID の URI に送信されます。Amazon Glacier では、アップロード ID を使用してパートアップロードを特定のマルチパートアップロードに関連付けます。リクエストには、パートデータの SHA256 木構造ハッシュ (`x-amz-SHA256-tree-hash` ヘッダー)、ペイロード全体の SHA256 線形ハッシュ (`x-amz-content-sha256` ヘッダー)、バイト範囲 (`Content-Range` ヘッダー)、およびパートの長さのバイト数 (`Content-Length` ヘッダー) を含める必要があります。
### 構文
```
1. PUT /AccountId/vaults/VaultName/multipart-uploads/uploadID HTTP/1.1
2. Host: glacier.Region.amazonaws.com
3. Date: Date
4. Authorization: SignatureValue
5. Content-Range: ContentRange
6. Content-Length: PayloadSize
7. Content-Type: application/octet-stream
8. x-amz-sha256-tree-hash: Checksum of the part
9. x-amz-content-sha256: Checksum of the entire payload
10. x-amz-glacier-version: 2012-06-01
```
**注記**
`AccountId` の値は、ボールトを所有する AWS アカウントの ID です。AWS アカウント ID、または Amazon Glacier がリクエストの署名に使用した認証情報に関連する AWS アカウント ID を使用している場合はオプションで '`-`' (ハイフン) のどちらかを指定できます。アカウント ID を使用する場合は、ID にハイフン ('-') を含めないでください。
### リクエストパラメータ
このオペレーションはリクエストパラメータを使用しません。
### リクエストヘッダー
この操作では、すべての操作で共通のリクエストヘッダーに加えて、次のリクエストヘッダーを使用します。共通のリクエストヘッダーの詳細については、「[一般的なリクエストヘッダー](api-common-request-headers.md)」を参照してください。
| 名前 | 説明 | 必須 |
| --- | --- | --- |
| Content-Length | パートの長さをバイト単位で特定します。 タイプ: 文字列 デフォルト: なし 制約: なし | なし |
| Content-Range | このパートでアップロードされるアセンブル済みアーカイブのバイト範囲を識別します。Amazon Glacier では、この情報を使用してアーカイブを適切な順序でアセンブルします。このヘッダーの形式は、[RFC 2616](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.16) に準拠しています。ヘッダーはたとえば、`Content-Range:bytes 0-4194303/*` のようになります。 タイプ: 文字列 デフォルト: なし 制約事項: この範囲は、マルチパートアップロードを開始するときに指定したパートサイズよりも大きくすることはできません。 | あり |
| x-amz-content-sha256 | アップロードされるペイロードの SHA256 チェックサム (線形ハッシュ)。この値は、`x-amz-sha256-tree-hash` ヘッダーで指定する値とは異なります。 タイプ: 文字列 デフォルト: なし 制約: なし | あり |
| x-amz-sha256-tree-hash | アップロードするデータの SHA256 木構造ハッシュを指定します。SHA256 木構造ハッシュの計算の詳細については、「[チェックサムの計算](checksum-calculations.md)」を参照してください。 タイプ: 文字列 デフォルト: なし 制約: なし | あり |
### リクエスト本文
リクエストボディには、アップロードするデータを含めます。
## レスポンス
Amazon Glacier は、パートのアップロードが正常に終了すると、`204 No Content` レスポンスを返します。
### 構文
```
1. HTTP/1.1 204 No Content
2. x-amzn-RequestId: x-amzn-RequestId
3. Date: Date
4. x-amz-sha256-tree-hash: ChecksumComputedByAmazonGlacier
```
### レスポンスヘッダー
成功したレスポンスには、すべての操作に共通のレスポンスヘッダーに加えて、次のレスポンスヘッダーが含まれます。共通のレスポンスヘッダーの詳細については、「[共通のレスポンスヘッダー](api-common-response-headers.md)」を参照してください。
| 名前 | 説明 |
| --- | --- |
| x-amz-sha256-tree-hash | アップロードされたパートについて Amazon Glacier が計算した SHA256 木構造ハッシュ。 タイプ: 文字列 |
### レスポンス本文
このオペレーションはレスポンス本文を返しません。
## 例
以下に示すリクエストでは、4 MB のパートをアップロードします。このリクエストでは、このパートをアーカイブの最初のパートにするようにバイト範囲を設定しています。
### リクエストの例
この例では、4 MB のパートをアップロードする HTTP `PUT` リクエストを送信します。リクエストは、マルチパートアップロードの開始リクエストによって返されるアップロード ID の URI に送信されます。`Content-Range` ヘッダーでは、このパートがアーカイブの最初の 4 MB のデータに相当するものであることを指定しています。
```
1. PUT /-/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. Date: Wed, 10 Feb 2017 12:00:00 GMT
4. Content-Range:bytes 0-4194303/*
5. x-amz-sha256-tree-hash:c06f7cd4baacb087002a99a5f48bf953
6. x-amz-content-sha256:726e392cb4d09924dbad1cc0ba3b00c3643d03d14cb4b823e2f041cff612a628
7. Content-Length: 4194304
8. Authorization: Authorization=AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-content-sha256;x-amz-date;x-amz-glacier-version,Signature=16b9a9e220a37e32f2e7be196b4ebb87120ca7974038210199ac5982e792cace
```
次のパートをアップロードする手順も、これと同じです。ただし、アップロードするパートの新しい SHA256 木構造ハッシュを計算するとともに、新しいバイト範囲を指定し、そのパートが最後のアセンブリで置かれる場所を示す必要があります。次のリクエストは、同じアップロード ID を使用して別のパートをアップロードするものです。このリクエストでは、アーカイブのうち、前回のリクエスト以降の 4 MB 分の範囲と、4 MB というパートサイズを指定しています。
```
1. PUT /-/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. Date: Wed, 10 Feb 2017 12:00:00 GMT
4. Content-Range:bytes 4194304-8388607/*
5. Content-Length: 4194304
6. x-amz-sha256-tree-hash:f10e02544d651e2c3ce90a4307427493
7. x-amz-content-sha256:726e392cb4d09924dbad1cc0ba3b00c3643d03d14cb4b823e2f041cff612a628
8. x-amz-glacier-version: 2012-06-01
9. Authorization: Authorization=AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20120525/us-west-2/glacier/aws4_request, SignedHeaders=host;x-amz-content-sha256;x-amz-date;x-amz-glacier-version, Signature=16b9a9e220a37e32f2e7be196b4ebb87120ca7974038210199ac5982e792cace
```
パートは、任意の順序でアップロードできます。Amazon Glacier では、各パートの範囲として指定された値を使用して、アセンブルする順序を決定します。
### レスポンスの例
```
1. HTTP/1.1 204 No Content
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. x-amz-sha256-tree-hash: c06f7cd4baacb087002a99a5f48bf953
4. Date: Wed, 10 Feb 2017 12:00:00 GMT
```
## 関連するセクション
+ [マルチパートアップロードの開始 (POST multipart-uploads)](api-multipart-initiate-upload.md)
+ [パートのアップロード (PUT uploadID)](#api-upload-part)
+ [マルチパートアップロードの完了 (POST uploadID)](api-multipart-complete-upload.md)
+ [マルチパートアップロードの中止 (DELETE uploadID)](api-multipart-abort-upload.md)
+ [マルチパートアップロードのリスト (GET multipart-uploads)](api-multipart-list-uploads.md)
+ [パートのリスト (GET uploadID)](api-multipart-list-parts.md)
+ [パート単位での大きなアーカイブのアップロード (マルチパートアップロード)](uploading-archive-mpu.md)
+ [Amazon Glacier の ID とアクセス管理](security-iam.md)