`mc retention info`

語法

mc retention info 命令會設定儲存區中一個或多個物件的一次寫入多次讀取 (WORM) 鎖定設定。您也可以設定儲存區的預設物件鎖定設定，其中所有沒有明確物件鎖定設定的物件都會繼承儲存區預設值。

若要將物件鎖定在法律保留下，請使用mc legalhold set。

mc retention info需要指定的儲存區已啟用物件鎖定。您只能在建立儲存區時啟用物件鎖定。請參閱mc mb --with-lock以取得有關建立已啟用物件鎖定的儲存區的文件。

範例

以下命令傳回 myminio MinIO 部署上 mydata 儲存區的預設物件鎖定設定

mc retention info --default myminio/mydata

語法

此命令具有以下語法

mc [GLOBALFLAGS] retention info            \
                 [--default]               \
                 [--recursive]             \
                 [--rewind "string"]       \
                 [--version-id "string"]*  \
                 [--versions]              \
                 ALIAS

方括號 [] 表示選用參數。
同一行中的參數彼此互相依賴。
使用管道符號 | 分隔的參數彼此互斥。

將範例複製到文字編輯器中，並在終端機/shell 中執行命令前依需求修改。

mc retention info --version-id 與其他多個參數互斥。請參閱參考文件以取得更多資訊。

參數

ALIAS

必要

用於檢索物件鎖定設定的物件完整路徑。指定已設定的 S3 相容服務的別名作為 ALIAS 儲存桶路徑的前綴。例如

mc retention info play/mybucket/object.txt

如果 ALIAS 指定儲存桶或儲存桶前綴，請包含
--recursive 以傳回儲存桶或儲存桶前綴中所有物件的物件鎖定設定。
如果 ALIAS 儲存桶已啟用版本控制，
mc retention info 預設僅適用於最新的物件版本。使用 --version-id 或 --versions 以傳回特定版本或物件的所有版本的物件鎖定設定。

--default

選用

傳回指定給 ALIAS 的儲存桶的預設物件鎖定設定。

如果指定 --default，mc retention info 會忽略所有其他旗標。

--recursive, r

選用

遞迴傳回指定 ALIAS 路徑中所有物件的物件鎖定設定。

與 --version-id 互斥。

--rewind

選用

指示 mc retention info 僅對指定時間點存在的物件版本執行操作。

若要倒回至過去的特定日期，請將日期指定為 ISO8601 格式的時間戳記。例如：--rewind "2020.03.24T10:00"。
若要倒回一段時間，請將持續時間指定為 #d#hh#mm#ss 格式的字串。例如：--rewind "1d2hh3mm4ss"。

--rewind 要求指定的 ALIAS 必須是支援儲存桶版本控制的 S3 相容服務。對於 MinIO 部署，請使用 mc version 來啟用或停用儲存桶版本控制。

--version-id, vid

選用

指示 mc retention info 僅對指定的物件版本執行操作。

--version-id 要求指定的 ALIAS 必須是支援儲存桶版本控制的 S3 相容服務。對於 MinIO 部署，請使用 mc version 來啟用或停用儲存桶版本控制。

與下列任何旗標互斥

--versions
--rewind
--recursive

--versions

選用

指示 mc retention info 對儲存桶中存在的所有物件版本執行操作。

--versions 要求指定的 ALIAS 必須是支援儲存桶版本控制的 S3 相容服務。對於 MinIO 部署，請使用 mc version 來啟用或停用儲存桶版本控制。

一起使用 --versions 和 --rewind，以檢索特定時間點存在的所有物件版本的保留設定。

全域旗標

此命令支援任何全域旗標。

範例

檢索物件或物件的物件鎖定設定

特定物件

mc retention info ALIAS/PATH

將 ALIAS 替換為已設定的 S3 相容主機的 別名。
將 PATH 替換為物件的路徑。

多個物件

搭配使用 mc retention info 和 --recursive，以檢索儲存桶中所有物件的保留設定

mc retention info --recursive ALIAS/PATH

將 ALIAS 替換為已設定的 S3 相容主機的 別名。
將 PATH 替換為儲存桶的路徑。

儲存桶必須已啟用物件鎖定才能使用此命令。您只能在建立儲存桶時啟用物件鎖定。請參閱 mc mb --with-lock 以取得有關建立啟用物件鎖定的儲存桶的更多資訊。

檢索儲存桶的預設物件鎖定設定

搭配使用 mc retention info 和 --default，以檢索儲存桶的預設物件鎖定設定

mc retention info --default ALIAS/PATH

將 ALIAS 替換為
已設定的 S3 相容主機的 別名。
將 PATH 替換為儲存桶的路徑。

儲存桶必須已啟用物件鎖定才能使用此命令。您只能在建立儲存桶時啟用物件鎖定。請參閱 mc mb --with-lock 以取得有關建立啟用物件鎖定的儲存桶的更多資訊。

S3 相容性

mc 命令列工具是為與 AWS S3 API 相容而建置的，並已透過 MinIO 和 AWS S3 測試其預期的功能和行為。

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