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
。
- --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 會轉換所有非目前版本。
- --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]
將
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 命令可能會如文件所述運作,但任何此類使用行為均由您自行承擔風險。