jobParameters - Amazon Glacier
内容詳細

このページは、ボールトと 2012 年リリース当時の REST API を使用する、Amazon Glacier サービスの既存のお客様のみを対象としています。

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

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

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

jobParameters

ジョブを定義するためのオプションを提供します。

内容

ArchiveId

必要なアーカイブの ID。このフィールドは、Type フィールドが select または archive-retrieval に設定されている場合に必要です。インベントリ取得ジョブのリクエストでこのフィールドを指定すると、エラーが発生します。

有効な値: Amazon Glacier に対する過去のリクエストで取得した有効なアーカイブ ID である必要があります。

タイプ: 文字列

必須: はい (Type が select または archive-retrieval に設定されている場合)

説明

ジョブの任意の説明。

有効な値: 説明は 1,024 バイト以下である必要があります。使用可能な文字は、制御コードを除く 7 ビット ASCII コードです。具体的には、32-126 (10 進) または 0x20-0x7E (16 進) の ASCII 値です。

タイプ: 文字列

必須: いいえ

Format

(オプション) ボールトインベントリを取得するジョブを開始する場合の出力形式。インベントリジョブを開始する際に、Format フィールドを指定しなかった場合、デフォルトの形式は JSON です。

有効な値: CSV | JSON

タイプ: 文字列

必須: いいえ

InventoryRetrievalParameters

インベントリの取得の範囲に使用される入力パラメータ。

型: InventoryRetrievalJobInput オブジェクト

必須: いいえ

OutputLocation

選択ジョブの結果が保存されている場所についての情報を含むオブジェクト。

型: OutputLocation オブジェクト

必須: はい (select ジョブの場合)

RetrievalByteRange

取得するバイト範囲archive-retrieval、という形式にします。StartByteValue-EndByteValue「。このフィールドが指定されていない場合、アーカイブ全体が取得されます。このフィールドを指定する場合、バイト範囲はメガバイト単位 (1024 x 1024) に調整されている必要があります。メガバイト単位に調整するとは、StartByteValue は 1 MB で割り切れる値、EndByteValue は 1 を足すと 1 MB で割り切れる値またはアーカイブの終了値 (アーカイブのバイトサイズの値から 1 を引いた値) に等しい値である必要があるということです。RetrievalByteRange がメガバイト単位に調整されていない場合、このオペレーションではレスポンスで 400 が返されます。

inventory-retrieval または select ジョブのリクエストでこのフィールドを指定すると、エラーが発生します。

タイプ: 文字列

必須: いいえ

SelectParameters

選択に使用されるパラメータに関する情報を含むオブジェクト。

型: SelectParameters オブジェクト

必須: いいえ

SNSTopic

ジョブが完了し、出力をダウンロードする準備ができたときに Amazon Glacier が通知を送信する Amazon SNS トピックの Amazon リソースネーム (ARN)。指定したトピックから受信者に通知が発行されます。

SNS トピックは存在している必要があります。トピックが存在しない場合、Amazon Glacier が自動的にトピックを作成することはありません。さらに、SNS トピックには、ジョブを作成したアカウントでトピックにメッセージを発行することを許可するポリシーが必要です。SNS トピック名については、を参照してください。CreateTopicのAmazon Simple Notification Service API リファレンス。

タイプ: 文字列

必須: いいえ

Tier

選択またはアーカイブの取得ジョブに使用する層。 Standard は使用されるデフォルト値です。

有効な値: Expedited | Standard | Bulk

タイプ: 文字列

必須: いいえ

Type

ジョブのタイプ。アーカイブに SELECT クエリを実行するジョブ、アーカイブを取得するジョブ、またはボールトインベントリを取得するジョブを開始することができます。

有効な値: select | archive-retrieval | inventory-retrieval

タイプ: 文字列

必須: はい

詳細