アーカイブされたオブジェクトの復元

Amazon S3 コンソールを使用してオブジェクトを復元する

次の手順を使用して、S3 Glacier Flexible Retrieval または S3 Glacier Deep Archive  ストレージクラス、または S3 Intelligent-Tiering Archive Access または Deep Archive Access ストレージ層にアーカイブされたオブジェクトを復元します。

S3 Glacier Flexible Retrieval または S3 Glacier Deep Archive からオブジェクトを復元する

次の例では restore-object コマンドを使用して、25 日間でバケット amzn-s3-demo-bucket にオブジェクト dir1/example.obj を復元します。

aws s3api restore-object --bucket amzn-s3-demo-bucket --key dir1/example.obj --restore-request '{"Days":25,"GlacierJobParameters":{"Tier":"Standard"}}'

この例で使用されている JSON 構文が原因で Windows クライアントにエラーが生じる場合は、復元リクエストを以下の構文に置き換えてください。

--restore-request Days=25,GlacierJobParameters={"Tier"="Standard"}

S3 Intelligent-Tiering Archive Access と Deep Archive Access からオブジェクトを復元する

次の例では restore-object コマンドを使用して、バケット amzn-s3-demo-bucket のオブジェクト dir1/example.obj を高頻度アクセス階層に復元します。

aws s3api restore-object --bucket amzn-s3-demo-bucket --key dir1/example.obj --restore-request '{}'

復元ステータスを監視する

restore-object リクエストのステータスをモニタリングするには、次の head-object コマンドを使用します。

aws s3api head-object --bucket amzn-s3-demo-bucket --key dir1/example.obj

詳細については、AWS CLI コマンドリファレンスの「restore-object」を参照してください。

Amazon S3 には、アーカイブされたオブジェクトの復元を開始するための API オペレーションが用意されています。詳細については、「Amazon Simple Storage Service API リファレンス」の「RestoreObject」を参照してください。

AWS SDK を使って S3 Glacier Flexible Retrieval または S3 Glacier Deep Archive 内にアーカイブされたオブジェクトを復元する方法の例については、「Amazon S3 API リファレンス」の「Code examples」を参照してください。

1 つのリクエストで複数のアーカイブされたオブジェクトを復元するには、S3 バッチオペレーションを使用できます。S3 バッチオペレーションには、オペレーションターゲットのオブジェクトのリストを指定します。S3 バッチオペレーションは、各 API オペレーションを呼び出して、指定されたオペレーションを実行します。1 つのバッチオペレーションジョブで、エクサバイトのデータを含む数十億ものオブジェクトに対して、指定されたオペレーションを実行できます。

バッチオペレーションジョブを作成するには、復元するオブジェクトのみを含むマニフェストが必要です。S3 Inventory を使用してマニフェストを作成することも、必要な情報を含む CSV ファイルを提供することもできます。詳細については、「マニフェストの指定」を参照してください。

S3 バッチオペレーションジョブを作成して実行する前に、お客様に代わって S3 バッチオペレーションを実行するためのアクセス権限を Amazon S3 に付与する必要があります。必要なアクセス許可については、「バッチオペレーションに対するアクセス許可の付与」を参照してください。

バッチオペレーションの詳細については、「バッチオペレーションを使ってオブジェクトを復元する」と「S3 バッチオペレーションジョブの作成」を参照してください。

Amazon S3 イベント通知機能を使って、s3:ObjectRestore:Completed アクションを使用すると、オブジェクトの復元完了の通知を受け取ることができます。イベント通知を有効にする方法の詳細については、「Amazon SQS、Amazon SNS、および AWS Lambda を使用した通知の有効化」を参照してください。さまざまな ObjectRestore イベントタイプの詳細については、「SQS、SNS、および Lambda でサポートされているイベントタイプ」を参照してください。

オブジェクトのリストアステータスと有効期限を AWS CLI コマンドで確認します。

次の例では head-object コマンドを使用して、バケット amzn-s3-demo-bucket のオブジェクト dir1/example.obj のメタデータを表示します。復元中のオブジェクトに対してこのコマンドを実行すると、Amazon S3 は復元が進行中であるかどうか、さらには有効期限を返します (該当する場合)。

aws s3api head-object --bucket amzn-s3-demo-bucket --key dir1/example.obj

期待される出力 (復元中):

{
    "Restore": "ongoing-request=\"true\"",
    "LastModified": "2020-06-16T21:55:22+00:00",
    "ContentLength": 405,
    "ETag": "\"b662d79adeb7c8d787ea7eafb9ef6207\"",
    "VersionId": "wbYaE2vtOV0iIBXrOqGAJt3fP1cHB8Wi",
    "ContentType": "binary/octet-stream",
    "ServerSideEncryption": "AES256",
    "Metadata": {},
    "StorageClass": "GLACIER"
}

期待される出力 (復元完了):

{
    "Restore": "ongoing-request=\"false\", expiry-date=\"Wed, 12 Aug 2020 00:00:00 GMT\"",
    "LastModified": "2020-06-16T21:55:22+00:00",
    "ContentLength": 405,
    "ETag": "\"b662d79adeb7c8d787ea7eafb9ef6207\"",
    "VersionId": "wbYaE2vtOV0iIBXrOqGAJt3fP1cHB8Wi",
    "ContentType": "binary/octet-stream",
    "ServerSideEncryption": "AES256",
    "Metadata": {},
    "StorageClass": "GLACIER"
}

head-object の詳細については、「AWS CLI コマンドリファレンス」の「head-object」を参照してください。

Amazon S3 には、オブジェクトメタデータを取得するための API オペレーションが用意されています。REST API を使用してアーカイブされたオブジェクトの復元ステータスと有効期限を確認するには、「Amazon Simple Storage Service API リファレンス」の「HeadObject」を参照してください。