`mc ls`

語法

mc ls 命令會列出 MinIO 或其他與 S3 相容服務上的儲存區和物件。

您也可以對本機檔案系統使用 mc ls，以產生與 ls 命令類似的結果。

範例

以下命令會列出 myminio MinIO 部署上 mydata 儲存區中的所有物件和物件版本

mc ls --recursive --versions myminio/mydata

輸出類似以下內容

[2022-11-08 11:30:24 PST]    52MB  STANDARD log-data.csv
[2022-11-09 12:20:18 PST]    120MB WARM videos/event-2022-11-09.mp4

STANDARD 標示儲存在 MinIO 部署上的物件
WARM 標示儲存在具有相符名稱的遠端層級上的物件
videos/ 表示物件的前綴

語法

此命令具有以下語法

mc [GLOBALFLAGS] ls              \
                 [--incomplete]  \
                 [--recursive]   \
                 [--rewind]      \
                 [--versions]    \
                 [--summarize]   \
                 ALIAS [ALIAS ...]

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

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

參數

ALIAS

必要要複製的物件。

若要列出 MinIO 上的物件，請指定別名和該物件的完整路徑 (例如儲存區和物件路徑)。例如

mc ls play/mybucket/object.txt

若要列出本機檔案系統上的物件，請指定該物件的完整路徑。例如

mc ls ~/mydata/object.txt

如果您指定目錄或儲存桶給 ALIAS，您還必須指定 --recursive 以遞迴列出該目錄或儲存桶的內容。如果您省略 --recursive 引數，ls 僅會列出指定目錄或儲存桶頂層的物件。

incomplete, -I: 選用傳回指定 ALIAS 儲存桶上的任何未完成上傳。

--recursive, r: 選用遞迴列出 ALIAS 中的每個儲存桶或目錄的內容。

--rewind

選用

指示 mc ls 僅操作在指定時間點存在的物件版本。

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

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

同時使用 --rewind 和 --versions 來顯示在特定時間點存在的那些物件版本。

--versions

選用

指示 mc ls 操作儲存桶中存在的所有物件版本。

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

同時使用 --versions 和 --rewind 來顯示在特定時間點存在的那些物件版本。

--summarize: 選用顯示指定 ALIAS 路徑的摘要資訊。

全域旗標

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

範例

列出儲存桶內容

使用 mc ls 來列出儲存桶的內容

mc ls [--recursive] ALIAS/PATH

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

如果指定 S3 根目錄的路徑（僅 ALIAS），請包含 --recursive 選項。

列出物件版本

使用 mc ls --versions 來列出物件的所有版本

mc ls --versions ALIAS/PATH

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

需要版本控制

mc ls 需要儲存桶版本控制才能使用此功能。使用 mc version 來啟用儲存桶上的版本控制。

列出特定時間點的儲存桶內容

使用 mc ls --versions 來列出物件的所有版本

mc ls --rewind DURATION ALIAS/PATH

將 ALIAS 替換為 S3 相容主機的 alias。
將 PATH 替換為 S3 相容主機上儲存桶或物件的路徑。
將 DURATION 替換為命令傳回物件的時間點。例如，指定 30d 可傳回物件在目前日期前 30 天的版本。

需要版本控制

mc ls 需要儲存桶版本控制才能使用此功能。使用 mc version 來啟用儲存桶上的版本控制。

行為

S3 相容性

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

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