**このページは、ボールトと 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 ストレージクラスへの移行を検討してください。
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# エラーレスポンス
API は、エラーが発生すると以下の例外のいずれか 1 つを返します。
| コード | 説明 | HTTP ステータスコード | タイプ |
| --- | --- | --- | --- |
| AccessDeniedException | AWS Identity and Access Management (IAM) ポリシーで許可されていないリソースにアクセスしようとした場合、またはリクエスト URI で間違った AWS アカウント ID が使用された場合に返されます。詳細については、「[Amazon Glacier の ID とアクセス管理](security-iam.md)」を参照してください。 | 403 Forbidden | クライアント |
| BadRequest | リクエストを処理することができない場合に返されます。 | 400 Bad Request | クライアント |
| ExpiredTokenException | リクエストで使用しているセキュリティトークンが期限切れになっている場合に返されます。 | 403 Forbidden | クライアント |
| InsufficientCapacityException | 迅速リクエストを処理する容量が足りない場合に返されます。このエラーは、迅速取り出しにのみ該当し、標準取り出しまたは大容量取り出しには該当しません。 | 503 Service Unavailable | サーバー |
| InvalidParameterValueException | リクエストのパラメータの指定が不正である場合に返されます。 | 400 Bad Request | クライアント |
| InvalidSignatureException | リクエストの署名が無効である場合に返されます。 | 403 Forbidden | クライアント |
| LimitExceededException | リクエストが、ボールトの制限、タグの制限、またはプロビジョニングされた容量の制限のいずれかを超えている場合に返されます。 | 400 Bad Request | クライアント |
| MissingAuthenticationTokenException | 認証データがリクエストにない場合に返されます。 | 400 Bad Request | クライアント |
| MissingParameterValueException | 必須のヘッダーまたはパラメータがリクエストにない場合に返されます。 | 400 Bad Request | クライアント |
| PolicyEnforcedException | 取り出しジョブが現在のデータポリシーの取り出しレート制限を超えた場合に返されます。データ取り出しポリシーの詳細については、「[Amazon Glacier のデータ取り出しポリシー](data-retrieval-policy.md)」を参照してください。 | 400 Bad Request | クライアント |
| ResourceNotFoundException | ボールト、アップロード ID、ジョブ ID など、指定されたリソースがない場合に返されます。 | 404 Not Found | クライアント |
| RequestTimeoutException | アップロードされたアーカイブを、Amazon Glacier が受信する際にタイムアウトとなった場合に返されます。 | 408 Request Timeout | クライアント |
| SerializationException | リクエストの本文が無効になっている場合に返されます。JSON ペイロードが含まれる場合には、正しい形式になっていることを確認します。 | 400 Bad Request | クライアント |
| ServiceUnavailableException | サービスがリクエストを完了できない場合に返されます。 | 500 Internal Server Error | サーバー |
| ThrottlingException | Amazon Glacier に対するリクエストのレートを減らす必要がある場合に返されます。 | 400 Bad Request | クライアント |
| UnrecognizedClientException | アクセスキー ID またはセキュリティトークンが無効である場合に返されます。 | 400 Bad Request | クライアント |
さまさまな Amazon Glacier API によって同じ例外が返されるものの、異なる例外メッセージが用意されているため、発生した特定のエラーのトラブルシューティングに役立てることができます。
Amazon Glacier は、レスポンス本文でエラーに関する情報を返します。以下の例では、エラーレスポンスの例をいくつか挙げて説明します。
## 例 1: 存在しないジョブ ID を使用したジョブリクエストに関する説明
存在しないジョブについて [ジョブの説明 (GET JobID)](api-describe-job-get.md) リクエストを送信したとします。つまり、存在していないジョブ ID を指定したとします。
```
1. GET /-/vaults/examplevault/jobs/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVEXAMPLEbadJobID HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. 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 は以下のエラーレスポンスを返します。
```
HTTP/1.1 404 Not Found
x-amzn-RequestId: AAABaZ9N92Iiyv4N7sru3ABEpSQkuFtmH3NP6aAC51ixfjg
Content-Type: application/json
Content-Length: 185
Date: Wed, 10 Feb 2017 12:00:00 GMT
{
"code": "ResourceNotFoundException",
"message": "The job ID was not found: HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVEXAMPLEbadJobID",
"type": "Client"
}
```
コードの説明は以下のとおりです。
**コード**
一般的な例外の 1 つです。
*タイプ*: 文字列
**メッセージ**
エラーを返した API 特有のエラー発生条件の一般的な説明です。
*タイプ*: 文字列
**タイプ**
エラーの原因です。このフィールドの値は、`Client`、`Server`、`Unknown` のいずれかになります。
*型*: 文字列
前述のレスポンスでは次の点に注意してください。
+ このエラーレスポンスでは、Amazon Glacier によりステータスコードのうち、`4xx` と`5xx` の値が返されます。この例では、ステータスコードは `404 Not Found` です。
+ `Content-Type` ヘッダーの値 `application/json` は、本文の JSON を示しています。
+ 本文の JSON には、エラーに関する情報が表示されます。
前述のリクエストで、誤ったジョブ ID ではなく、存在しないボールトを指定したとします。すると、レスポンスには別のメッセージが返されます。
```
HTTP/1.1 404 Not Found
x-amzn-RequestId: AAABBeC9Zw0rp_5D0L8VfB3FA_WlTupqTKAUehMcPhdgni0
Content-Type: application/json
Content-Length: 154
Date: Wed, 10 Feb 2017 12:00:00 GMT
{
"code": "ResourceNotFoundException",
"message": "Vault not found for ARN: arn:aws:glacier:us-west-2:012345678901:vaults/examplevault",
"type": "Client"
}
```
## 例 2: リクエストパラメータに無効な値が設定されたジョブリクエストの一覧表示
この例では、[ジョブのリスト表示 (GET jobs)](api-jobs-get.md) リクエストを送信して、ボールトジョブと特定の `statuscode` を取得します。このとき、`statuscode` の値として許容される値 `finished`、`InProgress`、または `Succeeded` のいずれでもなく、誤って `Failed` を指定したとします。
```
GET /-/vaults/examplevault/jobs?statuscode=finished HTTP/1.1
Host: glacier.us-west-2.amazonaws.com
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 によって、適切なメッセージと併せて `InvalidParameterValueException` が返されます。
```
HTTP/1.1 400 Bad Request
x-amzn-RequestId: AAABaZ9N92Iiyv4N7sru3ABEpSQkuFtmH3NP6aAC51ixfjg
Content-Type: application/json
Content-Length: 141
Date: Wed, 10 Feb 2017 12:00:00 GMT
{
"code": "InvalidParameterValueException",
"message": "The job status code is not valid: finished",
"type: "Client"
}
```