`mc ilm restore`

語法

mc ilm restore 指令會建立一個遠端層級上封存物件的暫時副本。預設情況下，該副本會在 1 天後自動過期。

使用此指令允許應用程式透過 MinIO 部署（例如「熱層」）存取分層物件。封存的物件會保留在遠端層級上，而暫時副本會成為該物件的 HEAD。

新版本：RELEASE.2023-04-12T02-21-51Z

使用 mc stat 來顯示還原的物件是從本機暫時副本還是遠端層級讀取。目前正在從遠端層級還原的物件會顯示 Ongoing : true 的狀態。

範例

以下指令會將轉換物件的副本從遠端層級還原回 myminio MinIO 部署

mc ilm restore myminio/mybucket/object.txt

語法

此指令具有以下語法

mc [GLOBALFLAGS] ilm restore         \
                 [--days "int" ]     \
                 [--recursive]       \
                 [--vid "string"]    \
                 [--versions]        \
                 [--enc-c "string"]  \
                 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 編碼金鑰或一個 64 位元組的十六進位編碼金鑰，以用於 SSE-C 加密。 Raw Base64 編碼拒絕 `=` 填充金鑰。省略填充或使用支援 RAW 格式的 Base64 編碼器。

KEY

物件的完整路徑，格式為 alias/bucket/path/object.ext。

您可以僅指定頂層路徑，以對該路徑中的所有操作使用單一加密金鑰。

VALUE

指定一個 32 位元組的 RawBase64 編碼金鑰或一個 64 位元組的十六進位編碼金鑰，以用於 SSE-C 加密。

Raw 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"

注意

MinIO 強烈建議不要在生產工作負載中使用 SSE-C 加密。請改用透過 --enc-kms 參數的 SSE-KMS 或透過 --enc-s3 參數的 SSE-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 相容性

mc 命令列工具是為與 AWS S3 API 相容而建置的，並使用 MinIO 和 AWS S3 測試，以確保預期的功能和行為。

MinIO 不保證其他 S3 相容服務，因為它們的 S3 API 實作是未知的，因此不受支援。儘管 mc 指令可能如文件所述那樣工作，但任何此類使用均由您自行承擔風險。