jobParameters - Amazon Glacier
内容詳細情報

このページは、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

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

jobParameters

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

内容

ArchiveId

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

有効な値: Amazon Glacier (Amazon Glacier) への以前のリクエストから取得した有効なアーカイブ ID Amazon Glacier である必要があります。

タイプ: 文字列

必須: はい (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

タイプ: 文字列

必須: はい

詳細情報