文件

mc ilm edit

變更於版本 RELEASE.2022-12-24T15-21-38Z:mc ilm edit 已由 mc ilm rule edit 取代。

語法

mc ilm edit 命令會修改 MinIO 儲存桶上現有的物件生命週期管理規則。

以下命令會修改 myminio 部署中 mydata 儲存桶的現有生命週期管理規則

mc ilm edit --id "c79ntj94b0t6rukh6lr0" --expiry-days 90  mydata/myminio

mc ilm edit --id "c79nu2p4b0t6qko19rgg" --expired-object-delete-marker mydata/myminio

mc ilm edit --id "c79n19dn10dnab109fg1" --transition-days 30 --tier "COLDTIER"

該命令會修改指定規則,如下所示

  • 刪除超過 90 天的物件。

  • 如果物件沒有其他剩餘的版本,則刪除 DeleteMarker 墓碑標記。

  • 將超過 30 天的物件轉換到 COLDTIER 遠端層。

此命令具有以下語法

mc [GLOBALFLAGS] ilm edit \
                 --id "string"                                                                                        \
                 [--prefix "string"]                                                                                  \
                 [--enable]                                                                                           \
                 [--disable]                                                                                          \
                 [--expiry-days "string" | --expired-object-delete-marker]                                            \
                 [--transition-days "string"] --tier "string"                                                \
                 [--noncurrentversion-expiration-days "string"]                                                       \
                 [--noncurrentversion-transition-days "string" --noncurrentversion-tier "string"] \
                 [--tags]                                                                                             \
                 ALIAS
  • 方括號 [] 表示選用參數。

  • 同一行中的參數彼此相關。

  • 使用管道符號 | 分隔的參數彼此互斥。

將範例複製到文字編輯器中,並在終端機/shell 中執行命令之前,根據需要進行修改。

參數

ALIAS
必要

要修改物件生命週期管理規則的 MinIO 部署上的 別名和儲存貯體完整路徑。例如

mc ilm edit myminio/mydata
--id
必要

規則的唯一 ID。使用 mc ilm rule ls 列出儲存貯體規則,並檢索您要修改的規則的 id

--disable
選用

停止使用該規則,但保留該規則以供將來使用。當規則停用時,物件不會轉換或過期。

--enable
選用

使用規則來轉換或使物件過期。

--prefix
選用

將管理規則限制為特定的儲存貯體前綴。

例如

mc ilm edit --prefix "meetingnotes/" myminio/mydata/ --expiry-days "90"

此命令修改一個規則,該規則會使 myminio 別名的 mydata 儲存貯體中,具有 meetingnotes/ 前綴的任何物件在 90 天後過期。

--expiry-days
選用

物件建立後保留的天數。MinIO 會在指定的天數過去後,將物件標記為刪除。

使用此選項時請謹慎,因為它的行為可能會導致上傳的物件立即過期。在指定的過期日期之後建立的任何物件都會自動符合過期條件。同樣地,指定早於目前系統主機日期時間的日曆日期,會將規則涵蓋的所有物件標記為刪除。一旦指定的日曆日期過去,請考慮立即移除使用此選項的任何 ILM 規則。

對於已版本化的儲存貯體,過期規則僅適用於目前物件版本。使用 --noncurrentversion-expiration-days 選項,將過期行為套用於非目前物件版本。

MinIO 使用掃描器處理程序來檢查物件是否符合所有已設定的生命週期管理規則。由於高 IO 工作負載或有限的系統資源而導致的掃描速度緩慢,可能會延遲生命週期管理規則的應用。如需更多資訊,請參閱生命週期管理物件掃描器

與下列選項互斥

如需更多資訊,請參閱物件刪除

--expired-object-delete-marker
選用

指定此選項可指示 MinIO 移除沒有剩餘物件版本的物件的刪除標記。具體來說,刪除標記是給定物件唯一剩下的「版本」。

此選項與下列選項互斥

MinIO 使用掃描器處理程序來檢查物件是否符合所有已設定的生命週期管理規則。由於高 IO 工作負載或有限的系統資源而導致的掃描速度緩慢,可能會延遲生命週期管理規則的應用。如需更多資訊,請參閱生命週期管理物件掃描器物件刪除

--noncurrentversion-expiration-days
選用

在物件版本變為非目前(即,該物件的不同版本現在是 HEAD)後,保留物件版本的天數。MinIO 會在指定的天數過去後,將非目前的物件版本標記為刪除。

此選項具有與 S3 NoncurrentVersionExpiration 動作相同的行為。

MinIO 使用掃描器處理程序來檢查物件是否符合所有已設定的生命週期管理規則。由於高 IO 工作負載或有限的系統資源而導致的掃描速度緩慢,可能會延遲生命週期管理規則的應用。如需更多資訊,請參閱生命週期管理物件掃描器

--noncurrentversion-transition-days
選用

物件在變為非目前(即,被同一物件的較新版本取代)後的天數,在此之後 MinIO 會將物件版本標記為符合轉換條件。一旦系統主機日期時間通過該日曆日期,MinIO 就會將物件轉換到 --tier 指定的已設定遠端儲存層。

此選項對未版本化的儲存貯體沒有作用。需要指定 --noncurrentversion-tier

此選項具有與 S3 NoncurrentVersionTransition 動作相同的行為。

MinIO 使用掃描器處理程序來檢查物件是否符合所有已設定的生命週期管理規則。由於高 IO 工作負載或有限的系統資源而導致的掃描速度緩慢,可能會延遲生命週期管理規則的應用。如需更多資訊,請參閱生命週期管理物件掃描器

--noncurrentversion-tier
選用

MinIO 將轉換非目前的物件版本到的遠端儲存層。指定由 mc admin tier 建立的遠端儲存層。

MinIO 不會自動將物件從先前指定的遠端層遷移到新的遠端層。MinIO 繼續將對儲存在舊遠端層上的物件的請求路由到舊遠端層。

--newer-noncurrentversions-expiration
選用

在應用過期之前要保留的物件非目前版本數量。超出指定數量的較舊非目前版本會過期。

預設情況下,當應用過期規則時,MinIO 不會保留任何非目前版本。

--newer-noncurrentversions-transition
選用

在目前儲存層上保留的物件非目前版本數量。超出指定數量的較舊非目前版本會轉換到指定的層。

預設情況下,當應用轉換規則時,MinIO 會轉換所有非目前版本。

--tags
選用

一或多個以 & 符號 & 分隔的鍵值對,描述要套用生命週期設定規則的物件標籤。

此選項與下列選項互斥

--transition-days
選用

從物件建立後,MinIO 將物件標記為符合轉換條件的日曆天數。MinIO 會將物件轉換到 --tier 指定的已設定遠端儲存層。

對於已版本化的儲存貯體,轉換規則僅適用於目前物件版本。使用 --noncurrentversion-transition-days 選項,將轉換行為套用於非目前物件版本。

需要指定 --tier

MinIO 使用掃描器處理程序來檢查物件是否符合所有已設定的生命週期管理規則。由於高 IO 工作負載或有限的系統資源而導致的掃描速度緩慢,可能會延遲生命週期管理規則的應用。如需更多資訊,請參閱生命週期管理物件掃描器

--tier
選用

MinIO 將轉換物件到的遠端儲存層。指定由 mc admin tier 建立的遠端儲存層。

如果指定 --transition-days,則為必填。

MinIO 不會自動將物件從先前指定的遠端層遷移到新的遠端層。MinIO 繼續將對儲存在舊遠端層上的物件的請求路由到舊遠端層。

全域標誌

此命令支援任何的全域標誌

範例

修改現有的生命週期管理規則

使用 mc ilm edit--id 來修改現有的物件過期規則

mc ilm edit ALIAS/PATH --id "RULEID" [FLAGS]
  • ALIAS 替換為 S3 相容主機的 別名

  • PATH 替換為 S3 相容主機上儲存貯體的路徑。

  • RULEID 替換為物件生命週期管理規則的唯一 ID。使用 mc ilm rule ls 來找到 RULEID

  • 指定任何其他標誌以新增或修改生命週期管理規則。例如,指定 --transition-days 以覆寫規則現有的轉換天數值。

停用生命週期管理規則

使用 mc ilm edit--disable 來停止使用現有的管理規則。

mc ilm edit --id "RULEID" --disable myminio/mybucket
  • RULEID 替換為物件生命週期管理規則的唯一 ID。使用 mc ilm rule ls 來找到 RULEID

  • myminio 替換為規則所在的部署的別名。

  • mybucket 替換為規則的儲存貯體。

行為

S3 相容性

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

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