エラーレスポンス - Amazon Glacier
例 1: 存在しないジョブ ID を使用したジョブリクエストに関する説明例 2: リクエストパラメータに無効な値が設定されたジョブリクエストの一覧表示

このページは、Vaults と 2012 年の元の REST API を使用する Amazon Glacier サービスの既存のお客様専用です。

アーカイブストレージソリューションをお探しの場合は、Amazon Glacier Amazon S3、S3 Glacier Flexible Retrieval、S3 S3 Glacier Deep Archive の Amazon Glacier ストレージクラスを使用することをお勧めします。これらのストレージオプションの詳細については、Amazon Glacier ストレージクラス」を参照してください。

Amazon Glacier (元のスタンドアロンボールトベースのサービス) は、2025 年 12 月 15 日以降、既存の顧客に影響を与えずに新規顧客を受け入れなくなります。Amazon Glacier は、ボールトにデータを保存する独自の APIs を備えたスタンドアロンサービスであり、Amazon S3 および Amazon S3 Glacier ストレージクラスとは異なります。既存のデータは Amazon Glacier で無期限に安全でアクセス可能です。移行は必要ありません。低コストの長期アーカイブストレージの場合、 は Amazon S3 Glacier ストレージクラス AWS を推奨します。これにより、S3 バケットベースの APIs、フル AWS リージョン 可用性、低コスト、 AWS サービス統合で優れたカスタマーエクスペリエンスを実現できます。拡張機能が必要な場合は、Amazon Glacier ボールトから Amazon S3 Glacier ストレージクラスにデータを転送するためのソリューションガイダンスを使用して、Amazon S3 Glacier ストレージクラスへの移行を検討してください。 AWS Amazon Glacier Amazon S3

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

エラーレスポンス

API は、エラーが発生すると以下の例外のいずれか 1 つを返します。

Code 説明 HTTP ステータスコード タイプ
AccessDeniedException AWS Identity and Access Management (IAM) ポリシーで許可されていないリソースにアクセスしようとした場合、またはリクエスト URI で間違った AWS アカウント ID が使用された場合に返されます。詳細については、「Amazon Glacier の Identity and Access Management」を参照してください。 403 Forbidden クライアント
BadRequest リクエストを処理することができない場合に返されます。 400 Bad Request クライアント
ExpiredTokenException リクエストで使用しているセキュリティトークンが期限切れになっている場合に返されます。 403 Forbidden クライアント
InsufficientCapacityException 迅速リクエストを処理する容量が足りない場合に返されます。このエラーは、迅速取り出しにのみ該当し、標準取り出しまたは大容量取り出しには該当しません。 503 Service Unavailable [Server] (サーバー)
InvalidParameterValueException リクエストのパラメータの指定が不正である場合に返されます。 400 Bad Request クライアント
InvalidSignatureException リクエストの署名が無効である場合に返されます。 403 Forbidden クライアント
LimitExceededException リクエストが、ボールトの制限、タグの制限、またはプロビジョニングされた容量の制限のいずれかを超えている場合に返されます。 400 Bad Request クライアント
MissingAuthenticationTokenException 認証データがリクエストにない場合に返されます。 400 Bad Request クライアント
MissingParameterValueException 必須のヘッダーまたはパラメータがリクエストにない場合に返されます。 400 Bad Request クライアント
PolicyEnforcedException 取り出しジョブが現在のデータポリシーの取り出しレート制限を超えた場合に返されます。データ取り出しポリシーの詳細については、「Amazon Glacier データ取得ポリシー」を参照してください。 400 Bad Request クライアント
ResourceNotFoundException ボールト、アップロード ID、ジョブ ID など、指定されたリソースがない場合に返されます。 404 Not Found クライアント
RequestTimeoutException アーカイブのアップロード中に Amazon Glacier (Amazon Glacier) がタイムアウトすると返されます。 408 Request Timeout クライアント
SerializationException リクエストの本文が無効になっている場合に返されます。JSON ペイロードが含まれる場合には、正しい形式になっていることを確認します。 400 Bad Request クライアント
ServiceUnavailableException サービスがリクエストを完了できない場合に返されます。 500 Internal Server Error [Server] (サーバー)
ThrottlingException Amazon Glacier へのリクエストのレートを下げる必要がある場合に返されます。 400 Bad Request クライアント
UnrecognizedClientException アクセスキー ID またはセキュリティトークンが無効である場合に返されます。 400 Bad Request クライアント

さまざまな Amazon Glacier APIs が同じ例外を返しますが、発生した特定のエラーのトラブルシューティングに役立つさまざまな例外メッセージがあります。

Amazon Glacier はレスポンス本文にエラー情報を返します。以下の例では、エラーレスポンスの例をいくつか挙げて説明します。

例 1: 存在しないジョブ ID を使用したジョブリクエストに関する説明

存在しないジョブについて ジョブの説明 (GET JobID) リクエストを送信したとします。つまり、存在していないジョブ ID を指定したとします。

GET /-/vaults/examplevault/jobs/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVEXAMPLEbadJobID 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 は次のエラーレスポンスを返します。

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"
  }

コードの説明は以下のとおりです。

Code

一般的な例外の 1 つです。

タイプ: 文字列

メッセージ

エラーを返した API 特有のエラー発生条件の一般的な説明です。

タイプ: 文字列

Type

エラーの原因です。このフィールドの値は、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) リクエストを送信して、ボールトジョブと特定の 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"
}