**このページは、ボールトと 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 ストレージクラスへの移行を検討してください。 翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # ジョブの開始 (ジョブの POST) この操作では、次のタイプの Amazon Glacier ジョブを開始します。 + `archive-retrieval`- アーカイブを取得 + `inventory-retrieval`- ボールトのインベントリ **Topics** + [アーカイブまたはボールトインベントリ取得ジョブの初期化](#api-initiate-job-post-description) + [リクエスト](#api-initiate-job-post-requests) + [レスポンス](#api-initiate-job-post-responses) + [例](#api-initiate-job-post-examples) + [関連するセクション](#more-info-api-initiate-job-post) ## アーカイブまたはボールトインベントリ取得ジョブの初期化 アーカイブの取得やボールトインベントリの取得は、ユーザーがジョブを開始する必要がある非同期オペレーションです。一度開始したジョブはキャンセルできません。取得は、2 ステップのプロセスです。 1. [ジョブの開始 (ジョブの POST)](#api-initiate-job-post) オペレーションを使用して、取得ジョブを開始します。 **重要** データ取り出しポリシーにより、`PolicyEnforcedException` が発生して、取り出しジョブの開始リクエストが失敗することがあります。データ取り出しポリシーの詳細については、「[Amazon Glacier のデータ取り出しポリシー](data-retrieval-policy.md)」を参照してください。`PolicyEnforcedException` 例外の詳細については、「[エラーレスポンス](api-error-responses.md)」を参照してください。 1. ジョブが完了したら、[ジョブの出力の取得 (GET output)](api-job-output-get.md) オペレーションを使用してバイトをダウンロードします。 取得のリクエストは非同期的に実行されます。取得ジョブを開始すると、Amazon Glacier はジョブを作成し、レスポンスでジョブ ID を返します。Amazon Glacier がジョブを完了すると、ジョブの出力 (アーカイブデータまたはインベントリデータ) を取得できます。ジョブの出力の取得については、「[ジョブの出力の取得 (GET output)](api-job-output-get.md)」を参照してください。 出力を取得する前にジョブが完了している必要があります。次のオプションを使用してジョブの完了を確認できます。 + **Amazon SNS 通知を使用する-**ジョブの完了後に Amazon Glacier が通知を送信するトピックを指定できます。ジョブのリクエストごとに SNS トピックを指定できます。Amazon Glacier がジョブを完了した後にのみ、通知が送信されます。ジョブのリクエストごとに SNS トピックを指定することに加え、すべての取得に対してジョブの通知が送信されるように、ボールトにボールト通知を設定することもできます。詳細については、「[ボールトの通知設定の指定 (PUT notification-configuration)](api-vault-notifications-put.md)」を参照してください。 + ** ジョブの詳細を取得する-**ジョブの進行中に [ジョブの説明 (GET JobID)](api-describe-job-get.md) リクエストを実行して、ジョブのステータス情報を取得することができます。ただし、ジョブの完了を確認するには、Amazon SNS 通知を使用する方が効率的です。 **注記** 通知により取得する情報は、[ジョブの説明 (GET JobID)](api-describe-job-get.md) を呼び出して取得する情報と同じです。 特定のイベントに対して、ボールトの通知設定を追加するとともに、ジョブの開始リクエストで SNS トピックを指定した場合、Amazon Glacier は両方の通知を送信します。詳細については、「[ボールトの通知設定の指定 (PUT notification-configuration)](api-vault-notifications-put.md)」を参照してください。 ### ボールトインベントリ Amazon Glacier はボールトインベントリを約 1 日 1 回のペースで更新します。この更新は、アーカイブがボールトに最初にアップロードされた日から開始します。最後のインベントリ以降に、ボールトに対してアーカイブの追加や削除が行われていない場合、インベントリの日付は更新されません。ボールトインベントリに対してジョブを開始すると、Amazon Glacier は最後に生成したインベントリを返します。そのインベントリはポイントインタイムスナップショットであり、リアルタイムのデータではありません。 Amazon Glacier によりボールトに対して作成される最初のインベントリは、通常取得可能になるまで半日から最大 1 日かかります。 アーカイブをアップロードするごとにボールトインベントリを取得することは、あまり便利には感じられないかもしれません。しかし、Amazon Glacier にアップロードしたアーカイブのメタデータに関連するデータベースを、クライアント側で管理する場合を考えてみてください。そのような場合には、実際のボールトインベントリとデータベース内の情報とを必要に応じて照合できるため、ボールトインベントリの利便性が実感できるものと思われます。インベントリジョブの出力で返されるデータフィールドの詳細については、「[レスポンス本文](api-job-output-get.md#api-job-output-get-responses-elements)」を参照してください。 ### インベントリの取得の範囲 アーカイブの作成日でフィルタするか、制限を設定することによって、取得されるインベントリの項目数を制限できます。 **アーカイブの作成日によるフィルタリング** 次の間に作成されたアーカイブのインベントリアイテムを取得できます。`StartDate`そして`EndDate`これらのパラメータの値を**ジョブの開始**リクエスト。`StartDate` 以降から `EndDate` までに作成されたアーカイブが返されます。`StartDate` を指定せずに、`EndDate` のみを指定した場合、`StartDate` 以降に作成されたすべてのアーカイブのインベントリを取得します。`EndDate` を指定せずに、`StartDate` のみを指定した場合、`EndDate` までに作成されたすべてのアーカイブのインベントリを取得します。 **インベントリ項目の取得ごとの制限** 以下を設定することによって、返品されるインベントリの項目数を制限できます。`Limit`パラメータの**ジョブの開始**リクエスト。インベントリジョブの出力には、`Limit` に指定した最大数のインベントリ項目が含まれます。利用可能なインベントリ項目がまだ存在する場合、結果がページ分割されます。ジョブの完了後、[ジョブの説明 (GET JobID)](api-describe-job-get.md) オペレーションを使用して、次の**ジョブ開始**リクエストで使用するマーカーを取得することができます。マーカーは、次に取得するインベントリ項目のセットの開始点を示します。繰り返し作成することで、インベントリ全体をページスルーできます。**ジョブの開始**前のマーカーを使用したリクエスト**ジョブの説明**出力。インベントリ項目がこれ以上存在しないことを示す、**ジョブの説明**のマーカーに null が返されるまでこれを行います。 `Limit` パラメータは日付範囲のパラメータとともに使用できます。 ### アーカイブの取得範囲 アーカイブ全体またはアーカイブの特定の範囲に対して、アーカイブの取得を開始することができます。アーカイブの取得範囲を指定する場合、返されるバイト範囲か、アーカイブ全体を指定できます。指定する範囲は、メガバイト (MB) 単位に調整されている必要があります。つまり、範囲の開始値は 1 MB で割り切れる値で、範囲の終了値は 1 を足すと 1 MB で割り切れる値またはアーカイブの終了値と同じである必要があります。アーカイブの取得範囲がメガバイト単位に調整されていない場合、このオペレーションではレスポンスで `400` が返されます。さらに、**ジョブの出力の取得** ([ジョブの出力の取得 (GET output)](api-job-output-get.md)) を使用して、ダウンロードするデータのチェックサムの値を取得するには、指定する範囲が木構造ハッシュ可能になっている必要があります。木構造ハッシュ可能な範囲の詳細については、「[データをダウンロードするときのチェックサムの受信](checksum-calculations-range.md)」を参照してください。 ### 迅速、標準、および大容量階層 アーカイブの取得ジョブを開始する際、リクエストボディの `Tier` フィールドに以下のオプションのいずれかを指定できます。 + **`Expedited`** - 迅速では、アーカイブの復元についての緊急リクエストが臨時に必要になった場合にデータにすばやくアクセスできます。最大規模のアーカイブ (250 MB 以上) を除くすべてのアーカイブについては、迅速階層でアクセスしたデータは通常 1–5 分以内で使用可能になります。 + **`Standard`** - 標準では、数時間以内にすべてのアーカイブにアクセスできます。標準階層を使用してアクセスしたデータは、通常 3-5 時間以内に利用できるようになります。このオプションは、階層オプションを指定しないでジョブリクエストを行った場合のデフォルトです。 + **`Bulk`** – 大容量階層は Amazon Glacier の最低コスト層であり、1 日で大量のデータ (ペタバイト) を安価に取得できるようにします。大容量階層を使用してアクセスしたデータは、通常 5-12 時間以内に利用できるようになります。 迅速取り出しと大容量取り出しの詳細については、「[Amazon Glacier アーカイブの取得](downloading-an-archive-two-steps.md)」を参照してください。 ## リクエスト ジョブを開始するには、HTTP `POST` メソッドを使用し、ボールトの `jobs` サブリソースをリクエストの範囲として指定します。リクエストの JSON ドキュメントでジョブのリクエストの詳細を指定します。ジョブのタイプは `Type` フィールドで指定します。必要に応じて `SNSTopic` フィールドを指定することで、Amazon Glacier がジョブの完了後に通知を送信する Amazon SNS トピックを設定することができます。 **注記** Amazon SNS に通知を送信するには、トピックが存在しない場合は新しくトピックを作成する必要があります。 ではトピックを自動的に作成しません。Amazon Glacier はトピックを作成しません。トピックには、Amazon Glacier ボールトから公開を受信する権限が必要です。Amazon Glacier は、トピックへの公開権限がボールトにあるかどうかを確認しません。アクセス許可が適切に設定されていない場合、ジョブが完了しても、通知が送信されない可能性があります。 ### 構文 以下に示しているのは、ジョブの開始に対するリクエスト構文です。 ``` 1. POST /{{AccountId}}/vaults/{{VaultName}}/jobs HTTP/1.1 2. Host: glacier.{{Region}}.amazonaws.com 3. Date: {{Date}} 4. Authorization: {{SignatureValue}} 5. x-amz-glacier-version: 2012-06-01 6. 7. { 8. "jobParameters": { 9. "ArchiveId": "{{string}}", 10. "Description": "{{string}}", 11. "Format": "{{string}}", 12. "InventoryRetrievalParameters": { 13. "EndDate": "{{string}}", 14. "Limit": "{{string}}", 15. "Marker": "{{string}}", 16. "StartDate": "{{string}}" 17. }, 18. "OutputLocation": { 19. "S3": { 20. "AccessControlList": [ 21. { 22. "Grantee": { 23. "DisplayName": "{{string}}", 24. "EmailAddress": "{{string}}", 25. "ID": "{{string}}", 26. "Type": "{{string}}", 27. "URI": "{{string}}" 28. }, 29. "Permission": "{{string}}" 30. } 31. ], 32. "BucketName": "{{string}}", 33. "CannedACL": "{{string}}", 34. "Encryption": { 35. "EncryptionType": "{{string}}", 36. "KMSContext": "{{string}}", 37. "KMSKeyId": "{{string}}" 38. }, 39. "Prefix": "{{string}}", 40. "StorageClass": "{{string}}", 41. "Tagging": { 42. "{{string}}" : "{{string}}" 43. }, 44. "UserMetadata": { 45. "{{string}}" : "{{string}}" 46. } 47. } 48. }, 49. "RetrievalByteRange": "{{string}}", 50. "SelectParameters": { 51. "Expression": "{{string}}", 52. "ExpressionType": "{{string}}", 53. "InputSerialization": { 54. "csv": { 55. "Comments": "{{string}}", 56. "FieldDelimiter": "{{string}}", 57. "FileHeaderInfo": "{{string}}", 58. "QuoteCharacter": "{{string}}", 59. "QuoteEscapeCharacter": "{{string}}", 60. "RecordDelimiter": "{{string}}" 61. } 62. }, 63. "OutputSerialization": { 64. "csv": { 65. "FieldDelimiter": "{{string}}", 66. "QuoteCharacter": "{{string}}", 67. "QuoteEscapeCharacter": "{{string}}", 68. "QuoteFields": "{{string}}", 69. "RecordDelimiter": "{{string}}" 70. } 71. } 72. }, 73. "SNSTopic": "{{string}}", 74. "Tier": "{{string}}", 75. "Type": "{{string}}" 76. } 77. } ``` **注記** `AccountId` 値は、ボールトを所有するアカウントの AWS アカウント ID です。 AWS アカウント ID またはオプションで単一の '`-`' (ハイフン) を指定できます。この場合、Amazon Glacier はリクエストの署名に使用される認証情報に関連付けられた AWS アカウント ID を使用します。アカウント ID を使用する場合は、ID にハイフン ('-') を含めないでください。 ### リクエスト本文 リクエストは、リクエストの本文にある JSON 形式で以下のデータを受け入れます。 jobParameters ジョブ情報を指定するためのオプションを提供します。 *タイプ*: [jobParameters](api-jobParameters.md) オブジェクト *必須:* はい ## レスポンス Amazon Glacier がジョブを作成します。レスポンスでは、ジョブの URI が返されます。 ### 構文 ``` 1. HTTP/1.1 202 Accepted 2. x-amzn-RequestId: x-amzn-RequestId 3. Date: Date 4. Location: {{location}} 5. x-amz-job-id: {{jobId}} 6. x-amz-job-output-path: {{jobOutputPath}} ``` ### レスポンスヘッダー | ヘッダー | 説明 | | --- | --- | | Location | ジョブの相対 URI パス。この URI パスを使用して、ジョブのステータスを確認することができます。詳細については、「[ジョブの説明 (GET JobID)](api-describe-job-get.md)」を参照してください。
タイプ: 文字列
デフォルト: なし | | x-amz-job-id | ジョブの ID。この値も `Location` ヘッダーの一部として含まれます。
タイプ: 文字列
デフォルト: なし | | x-amz-job-output-path | Select の結果が保存されている場所へのパス。
タイプ: 文字列
デフォルト: なし | ### レスポンス本文 このオペレーションはレスポンス本文を返しません。 ### エラー この操作には、すべての Amazon Glacier オペレーションで共通して発生し得るエラーに加えて、次のエラーが含まれます。Amazon Glacier のエラーとエラーコードのリストについては、「[エラーレスポンス](api-error-responses.md)」を参照してください。 | コード | 説明 | HTTP ステータスコード | タイプ | | --- | --- | --- | --- | | InsufficientCapacityException | この迅速リクエストを処理する容量が足りない場合に返されます。このエラーは、迅速取り出しにのみ該当し、標準取り出しまたは大容量取り出しには該当しません。 | 503 Service Unavailable | サーバー | ## 例 ### リクエストの例: アーカイブ取得ジョブを開始する ``` 1. POST /-/vaults/examplevault/jobs 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 6. 7. { 8. "Type": "archive-retrieval", 9. "ArchiveId": "NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId", 10. "Description": "My archive description", 11. "SNSTopic": "arn:aws:sns:us-west-2:111111111111:Glacier-ArchiveRetrieval-topic-Example", 12. "Tier" : "Bulk" 13. } ``` 以下は、`RetrievalByteRange` フィールドを使用して、取得するアーカイブの範囲を指定するリクエストの本文の例です。 ``` { "Type": "archive-retrieval", "ArchiveId": "NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId", "Description": "My archive description", "RetrievalByteRange": "2097152-4194303", "SNSTopic": "arn:aws:sns:us-west-2:111111111111:Glacier-ArchiveRetrieval-topic-Example", "Tier" : "Bulk" } ``` ### レスポンスの例 ``` 1. HTTP/1.1 202 Accepted 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q 3. Date: Wed, 10 Feb 2017 12:00:00 GMT 4. Location: /111122223333/vaults/examplevault/jobs/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID 5. x-amz-job-id: HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID ``` ### リクエストの例: インベントリ取得ジョブを開始する 以下のリクエストでは、インベントリ取得ジョブを開始して、`examplevault` ボールトからアーカイブのリストを取得します。リクエストボディで `Format` が `CSV` に設定されています。これは、インベントリが CSV 形式で返されることを示しています。 ``` 1. POST /-/vaults/examplevault/jobs HTTP/1.1 2. Host: glacier.us-west-2.amazonaws.com 3. x-amz-Date: 20170210T120000Z 4. Content-Type: application/x-www-form-urlencoded 5. x-amz-glacier-version: 2012-06-01 6. Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2 7. 8. { 9. "Type": "inventory-retrieval", 10. "Description": "My inventory job", 11. "Format": "CSV", 12. "SNSTopic": "arn:aws:sns:us-west-2:111111111111:Glacier-InventoryRetrieval-topic-Example" 13. } ``` ### レスポンスの例 ``` 1. HTTP/1.1 202 Accepted 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q 3. Date: Wed, 10 Feb 2017 12:00:00 GMT 4. Location: /111122223333/vaults/examplevault/jobs/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID 5. x-amz-job-id: HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID ``` ### リクエストの例: 日付によるフィルタリングを使用し、制限を設定してインベントリの取得ジョブを開始し、後続のリクエストでインベントリ項目の次のページを取得する。 次のリクエストでは、日付によるフィルタリングを使用し、制限を設定して、ボールトインベントリ取得ジョブを開始します。 ``` 1. { 2. "ArchiveId": null, 3. "Description": null, 4. "Format": "CSV", 5. "RetrievalByteRange": null, 6. "SNSTopic": null, 7. "Type": "inventory-retrieval", 8. "InventoryRetrievalParameters": { 9. "StartDate": "2013-12-04T21:25:42Z", 10. "EndDate": "2013-12-05T21:25:42Z", 11. "Limit" : "10000" 12. }, 13. } ``` 以下のリクエストは、[ジョブの説明 (GET JobID)](api-describe-job-get.md) で取得したマーカーを使用して、インベントリ項目の次のページを取得する後続のリクエストの例です。 ``` 1. { 2. "ArchiveId": null, 3. "Description": null, 4. "Format": "CSV", 5. "RetrievalByteRange": null, 6. "SNSTopic": null, 7. "Type": "inventory-retrieval", 8. "InventoryRetrievalParameters": { 9. "StartDate": "2013-12-04T21:25:42Z", 10. "EndDate": "2013-12-05T21:25:42Z", 11. "Limit": "10000", 12. "Marker": "vyS0t2jHQe5qbcDggIeD50chS1SXwYMrkVKo0KHiTUjEYxBGCqRLKaiySzdN7QXGVVV5XZpNVG67pCZ_uykQXFMLaxOSu2hO_-5C0AtWMDrfo7LgVOyfnveDRuOSecUo3Ueq7K0" 13. }, 14. } ``` ### レスポンスの例 ``` 1. HTTP/1.1 202 Accepted 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q 3. Date: Wed, 10 Feb 2017 12:00:00 GMT 4. Location: /111122223333/vaults/examplevault/jobs/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID 5. x-amz-job-id: HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID 6. x-amz-job-output-path: test/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID/ ``` ## 関連するセクション + [ジョブの説明 (GET JobID)](api-describe-job-get.md) + [ジョブの出力の取得 (GET output)](api-job-output-get.md) + [Amazon Glacier の ID とアクセス管理](security-iam.md)