`mc ilm rule ls`

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

版本 RELEASE.2023-05-26T23-31-54Z 中變更：mc ilm rule ls --json 輸出在 updateAt 中包含原則修改時間。

語法

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

mc ilm rule list 命令的功能與 mc ilm rule ls 相同。

範例

以下指令會列出在 myminio MinIO 部署中，名為 mydata 的儲存桶的所有生命週期管理規則。

mc ilm rule ls myminio/mydata

指令的輸出可能類似如下：

┌───────────────────────────────────────────────────────────────────────────────┐
│ 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 │
└────────┴─────────┴────────┴─────────────────────┴────────────────┴───────────────┘

語法

mc ilm rule ls 指令的語法如下：

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

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

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

參數

別名

必要參數

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

mc ilm rule ls myminio/mydata

--expiry

可選參數

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

與 --transition 互斥。

--transition

可選參數

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

與 --expiry 互斥。

全域旗標

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

範例

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

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

mc ilm rule ls ALIAS/PATH

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

顯示策略修改時間

使用 mc ilm rule ls 及 --json，以顯示儲存桶的策略上次更新的時間。

mc ilm rule ls ALIAS/PATH --json

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

JSON 輸出中的 updateAt 屬性包含策略更新的日期和時間。

輸出類似如下：

{
 "status": "success",
 "target": "myminio/mybucket",
 "config": {
  "Rules": [
   {
    "Expiration": {
     "Days": 30
    },
    "ID": "ci1o2mg0sko6f1r3krv0",
    "Status": "Enabled"
   }
  ]
 },
 "updatedAt": "2023-06-09T19:45:30Z"
}

必要權限

如需列出規則所需的權限，請參閱父指令上的必要權限。

行為

S3 相容性

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

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