還原已封存的物件

使用 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命令來還原物件 dir1/example.obj 在儲存貯體amzn-s3-demo-bucket中 25 天。

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

如果範例中使用的語法導致 Windows JSON 用戶端發生錯誤，請使用下列語法取代還原請求：

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

從 S3 Intelligent-Tiering Archive Access 和 Deep Archive Access 還原物件

下列範例使用 restore-object命令來還原物件 dir1/example.obj 儲存貯體中的 amzn-s3-demo-bucket到 常用存取層。

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

如需詳細資訊，請參閱 restore-object 在 AWS CLI 命令參考 中。

Amazon S3 為您提供啟動封存物件還原API的操作。如需詳細資訊，請參閱 RestoreObject 在 Amazon Simple Storage Service API參考 中。

如需如何使用 還原 S3 Glacier Flexible Retrieval 或 S3 Glacier Deep Archive 中封存物件的範例 AWS SDKs，請參閱 Amazon S3 API參考 中的程式碼範例。

若要使用單一請求還原多個封存的物件，您可以使用 S3 批次操作。您可以為 S3 批次操作提供一份要進行操作的物件清單。S3 Batch Operations 會呼叫個別API操作來執行指定的操作。單一批次作業任務可在包含數 EB 資料的數十億個物件上執行指定的操作。

若要建立批次操作任務，您必須擁有清單檔案，且當中只包含您要還原的物件。您可以使用 S3 庫存建立資訊清單，也可以提供CSV檔案所需的資訊。如需詳細資訊，請參閱指定資訊清單。

在建立和執行 S3 批次操作任務之前，您必須將許可授予 Amazon S3，以便代表您執行 S3 批次操作。如要了解必要的許可，請參閱 授予批次操作的許可。

如需批次操作的詳細資訊，請參閱 使用批次操作還原物件 和 建立 S3 批次操作任務

您可以使用 s3:ObjectRestore:Completed動作搭配 Amazon S3 Event Notifications 功能，在物件還原完成時收到通知。如需啟用事件通知的詳細資訊，請參閱使用 Amazon SQS、Amazon SNS和 啟用通知 AWS Lambda。如需各種ObjectRestore事件類型的詳細資訊，請參閱 SQS、 SNS和 Lambda 支援的事件類型。

使用 檢查物件的還原狀態和過期日期 AWS CLI

下列範例使用 head-object命令來檢視物件的中繼資料 dir1/example.obj 在儲存貯體 中amzn-s3-demo-bucket。當您對要還原的物件執行此命令時，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 的詳細資訊，請參閱 head-object 在 AWS CLI 命令參考 中。

Amazon S3 提供可讓您擷取物件中繼資料API的操作。若要使用 檢查封存物件的還原狀態和過期日期RESTAPI，請參閱 HeadObject 在 Amazon Simple Storage Service API參考 中。