恢复已归档的对象

使用 Amazon S3 控制台还原对象

使用以下过程还原已归档到 S3 Glacier Flexible Retrieval 或 S3 Glacier Deep Archive 存储类或 S3 Intelligent-Tiering 归档访问或深度归档访问存储层的对象。

从 S3 Glacier Flexible Retrieval 或 S3 Glacier Deep Archive 还原对象

以下示例使用 restore-object 命令还原桶 amzn-s3-demo-bucket 中的对象 dir1/example.obj，时间为 25 天。

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 归档访问和深度归档访问还原对象

以下示例使用 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。

要使用单个请求还原多个归档对象，您可以使用 S3 批量操作。您为 S3 批量操作提供要操作的对象列表。S3 批量操作调用相应的 API 操作来执行指定的操作。单个批量操作任务可对包含 EB 级数据的数十亿个对象执行指定操作。

要创建批量操作任务，您必须有一个仅包含要还原的对象的清单。您可以使用 S3 清单来创建清单，也可以提供包含必要信息的 CSV 文件。有关更多信息，请参阅 指定清单。

在创建和运行 S3 批量操作任务之前，您必须向 Amazon S3 授予代表您执行 S3 批量操作的权限。有关所需的权限，请参阅授予批处理操作的权限。

有关批量操作的更多信息，请参阅使用批量操作还原对象和创建 S3 批量操作任务。

通过使用 s3:ObjectRestore:Completed 操作与 Amazon S3 事件通知特征，您可以收到对象还原完成的通知。有关启用事件通知的更多信息，请参阅 Enabling notifications by using Amazon SQS, Amazon SNS, and 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。