`mc retention clear`

語法

mc retention clear 命令會移除儲存桶中物件或物件的一次寫入多次讀取 (WORM) 鎖定設定。您也可以移除儲存桶的預設物件鎖定設定。

若要變更處於法律保留下的物件的保留狀態，請使用 mc legalhold clear。

範例

以下命令會移除 myminio MinIO 部署上 mydata 儲存貯體中的預設物件鎖定設定

mc retention clear --default myminio/mydata

語法

此命令的語法如下

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

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

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

mc retention clear --version-id 與多個其他參數互斥。如需詳細資訊，請參閱參考文件。

參數

別名

必要

要清除物件鎖定設定的物件的完整路徑。指定已設定的 S3 相容服務的 alias 作為 ALIAS 儲存貯體路徑的前綴。例如

mc retention clear play/mybucket/object.txt

如果 ALIAS 指定儲存貯體或儲存貯體前綴，請包含
--recursive 以清除儲存貯體內容的物件鎖定設定。
如果 ALIAS 儲存貯體已啟用版本控制，則
mc retention clear 預設僅適用於最新的物件版本。使用 --version-id 或 --versions 以清除特定版本或物件所有版本的物件鎖定設定。

--default

選用

清除指定給 ALIAS 的儲存貯體的預設物件鎖定設定。

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

--recursive, r

選用

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

與 --version-id 互斥。

--rewind

選用

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

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

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

--version-id, vid

選用

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

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

與下列任何旗標互斥

--versions
--rewind
--recursive

--versions

選用

指示 mc retention clear 對儲存貯體中存在的所有物件版本進行操作。

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

一起使用 --versions 和 --rewind 以從特定時間點存在的所有物件版本中移除保留設定。

全域旗標

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

範例

清除物件或物件的物件鎖定設定

特定物件

mc retention clear ALIAS/PATH

以已設定的 S3 相容主機的 alias 取代 ALIAS。
以物件的路徑取代 PATH。

多個物件

將 mc retention clear 與 --recursive 搭配使用，以清除儲存貯體中所有物件的保留設定

mc retention clear --recursive ALIAS/PATH

以已設定的 S3 相容主機的 alias 取代 ALIAS。
以儲存貯體的路徑取代 PATH。

儲存貯體必須已啟用物件鎖定才能使用此命令。您只能在建立儲存貯體時啟用物件鎖定。如需更多關於建立已啟用物件鎖定的儲存貯體，請參閱 mc mb --with-lock。

S3 相容性

命令列工具 mc 是為與 AWS S3 API 相容而建構的，並已在 MinIO 和 AWS S3 上進行測試，以確保其預期的功能和行為。

MinIO 對於其他 S3 相容服務不提供任何保證，因為它們的 S3 API 實作未知，因此不受支援。雖然 mc 命令可能會如文件所述正常運作，但任何此類使用都需自行承擔風險。