`mc ilm restore`

语法

Themc ilm restore该命令会创建远程存储层中归档对象的临时副本。默认情况下，副本将在1天后自动过期。

使用此命令允许应用程序通过MinIO部署访问分层对象（例如“热层”）。归档对象保留在远程层级上，而临时副本则成为HEAD对于该对象。

版本 mc 中的新功能：RELEASE.2023-04-12T02-21-51Z

使用mc stat要显示已恢复的对象是从本地临时副本还是从远程层读取。当前正在从远程层恢复过程中的对象显示状态为Ongoing : true.

EXAMPLE

以下命令将远程层中的过渡对象副本恢复回myminioMinIO 部署：

mc ilm restore myminio/mybucket/object.txt

SYNTAX

该命令具有以下语法：

mc [GLOBALFLAGS] ilm restore         \
                 [--days "int" ]     \
                 [--recursive]       \
                 [--vid "string"]    \
                 [--versions]        \
                 [--enc-c "string"]  \
                 ALIAS

Brackets[]表示可选参数。
共享同一行的参数是相互依赖的。
使用竖线分隔的参数|操作符是互斥的。

将示例复制到文本编辑器中，根据需要修改，然后在终端/Shell中运行命令。

参数

ALIAS

必需

MinIO别名存储桶和要恢复的归档对象路径。

mc ilm restore myminio/mybucket/object.txt

--days: 可选
MinIO 在恢复归档对象副本后将其过期的天数。

--enc-c

可选

使用服务器端加密或解密对象SSE-C 加密使用客户端管理的密钥。

该参数接受一个键值对，格式为KEY=VALUE

`KEY`	对象的完整路径为`alias/bucket/path/object.ext`. 您只能指定顶级路径，以便对该路径中的所有操作使用单一加密密钥。
`VALUE`	指定一个32字节的RawBase64编码密钥or一个64字节的十六进制编码密钥，用于SSE-C加密。原始 Base64 编码拒绝 `=`- 填充的密钥。省略填充或使用支持 RAW 格式的 Base64 编码器。

KEY

对象的完整路径为alias/bucket/path/object.ext.

您只能指定顶级路径，以便对该路径中的所有操作使用单一加密密钥。

VALUE

指定一个32字节的RawBase64编码密钥or一个64字节的十六进制编码密钥，用于SSE-C加密。

原始 Base64 编码拒绝 =- 填充的密钥。省略填充或使用支持 RAW 格式的 Base64 编码器。

KEY- 对象的完整路径为alias/bucket/path/object.
VALUE- 用于加密对象的32字节RAW Base64编码数据密钥。

例如：

# RawBase64-Encoded string "mybucket32byteencryptionkeyssec"
--enc-c "myminio/mybucket/prefix/object.obj=bXlidWNrZXQzMmJ5dGVlbmNyeXB0aW9ua2V5c3NlYwo"

您可以通过重复该参数来指定多个加密密钥。

指定前缀路径，对该路径下所有匹配的对象应用加密：

--enc-c "myminio/mybucket/prefix/=bXlidWNrZXQzMmJ5dGVlbmNyeXB0aW9ua2V5c3NlYwo"

Note

MinIO 强烈建议在生产工作负载中不要使用 SSE-C 加密。请通过 SSE-KMS 使用--enc-kms或通过 SSE-S3--enc-s3改为使用参数。

--recursive, r: 可选
恢复指定前缀下的所有对象。

--versions: 可选
恢复远程层级上对象的所有版本。

--version-id, vid: 可选
恢复远程层级上指定版本的对象。

全局标志

此命令支持任何全局标志.

示例

恢复已归档的对象

以下命令可恢复归档到远程层级的对象：

mc ilm restore myminio/mybucket/object.txt

恢复特定的已归档对象版本

以下命令可恢复归档到远程层的特定对象版本：

mc ilm restore --vid "VERSIONID" myminio/mybucket/object.txt

恢复存储桶前缀下的所有已归档对象

以下命令可恢复远程层级上指定前缀下归档的所有对象：

mc ilm restore --recursive myminio/mybucket/data/

行为

已恢复的对象会自动过期

MinIO 会在指定天数后自动使恢复的对象副本过期（默认值：1 天）。

已恢复对象成为HEAD

恢复的对象副本成为该对象命名空间的HEAD无论如何其版本历史记录。这可能导致应用程序在本地副本存在时返回"过时"数据。

S3 Compatibility

Themc命令行工具专为兼容 AWS S3 API 而构建，并已通过 MinIO 和 AWS S3 测试，确保功能与行为符合预期。

MinIO 不提供对其他 S3 兼容服务的保证，因为它们的 S3 API 实现方式未知，因此不受支持。尽管mc命令可能按文档所述工作，任何此类使用风险自负。