`mc ilm ls`

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

語法

mc ilm ls 命令以表格格式總結 MinIO 儲存貯體上所有已設定的物件生命週期管理規則。

該命令的輸出可能類似於以下內容

┌───────────────────────────────────────────────────────────────────────────────┐
│ Transition for latest version (Transition)                                    │
├────────┬─────────┬────────┬─────────────────────┬──────────────┬──────────────┤
│ ID     │ STATUS  │ PREFIX │ TAGS                │ DAYS TO TIER │ TIER         │
├────────┼─────────┼────────┼─────────────────────┼──────────────┼──────────────┤
│ rule-1 │ Enabled │ doc/   │ key1=val1&key2=val2 │            0 │ WARM-MINIO-1 │
└────────┴─────────┴────────┴─────────────────────┴──────────────┴──────────────┘
┌────────────────────────────────────────────────────────────────┐
│ Transition for older versions (NoncurrentVersionTransition)    │
├────────┬─────────┬────────┬──────┬──────────────┬──────────────┤
│ ID     │ STATUS  │ PREFIX │ TAGS │ DAYS TO TIER │ TIER         │
├────────┼─────────┼────────┼──────┼──────────────┼──────────────┤
│ rule-2 │ Enabled │ logs/  │ -    │           10 │ WARM-MINIO-1 │
└────────┴─────────┴────────┴──────┴──────────────┴──────────────┘
┌────────────────────────────────────────────────────────────────────────────────────────┐
│ Expiration for latest version (Expiration)                                             │
├────────┬─────────┬────────┬─────────────────────┬────────────────┬─────────────────────┤
│ ID     │ STATUS  │ PREFIX │ TAGS                │ DAYS TO EXPIRE │ EXPIRE DELETEMARKER │
├────────┼─────────┼────────┼─────────────────────┼────────────────┼─────────────────────┤
│ rule-1 │ Enabled │ doc/   │ key1=val1&key2=val2 │             30 │ false               │
└────────┴─────────┴────────┴─────────────────────┴────────────────┴─────────────────────┘
┌──────────────────────────────────────────────────────────────────────────────────┐
│ Expiration for older versions (NoncurrentVersionExpiration)                      │
├────────┬─────────┬────────┬─────────────────────┬────────────────┬───────────────┤
│ ID     │ STATUS  │ PREFIX │ TAGS                │ DAYS TO EXPIRE │ KEEP VERSIONS │
├────────┼─────────┼────────┼─────────────────────┼────────────────┼───────────────┤
│ rule-1 │ Enabled │ doc/   │ key1=val1&key2=val2 │             15 │             0 │
│ rule-2 │ Enabled │ logs/  │ -                   │              1 │             3 │
└────────┴─────────┴────────┴─────────────────────┴────────────────┴───────────────┘

範例

以下命令列出 myminio MinIO 部署上 mydata 儲存貯體的所有生命週期管理規則

mc ilm ls myminio/mydata

語法

mc ilm ls 命令具有以下語法

mc [GLOBALFLAGS] ilm ls                        \
                 [--expiry | --transition]     \

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

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

參數

ALIAS

必要

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

mc ilm ls myminio/mydata

--expiry

選用

mc ilm ls 僅返回與生命週期規則到期相關的欄位。

與 --transition 互斥。

--transition

選用

mc ilm ls 僅返回與生命週期規則轉換相關的欄位。

與 --expiry 互斥。

全域標誌

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

範例

列出儲存桶生命週期管理規則

使用 mc ilm ls 列出儲存桶的生命週期管理規則

mc ilm ls ALIAS/PATH

將 ALIAS 替換為 S3 相容主機的 alias。
將 PATH 替換為 S3 相容主機上儲存桶的路徑。

行為

S3 相容性

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

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