文件

mc tag list

語法

mc tag list 命令會列出儲存區或物件中的所有標籤。

以下命令會列出 myminio MinIO 部署上 mydata 儲存區的標籤

mc tag list myminio/mydata

此命令具有下列語法

mc [GLOBALFLAGS] tag set                   \
                 [--rewind "string"]       \
                 [--versions]              \
                 [--version-id "string"]*  \
                 ALIAS
  • 方括號 [] 表示選用參數。

  • 同一行的參數彼此相依。

  • 使用管道 | 運算子分隔的參數彼此互斥。

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

mc tag list --version-id 與多個參數互斥。請參閱參考文件以取得更多資訊。

參數

ALIAS
必要

MinIO 部署的別名,以及要列出所有標籤的物件完整路徑(例如,儲存桶和物件路徑)。例如:

mc tag list myminio/mybucket/object.txt
--recursive, r
選用

此功能於 RELEASE.2023-05-04T18-10-16Z 版本新增。

遞迴列出指定給ALIAS 路徑下的所有物件標籤。

--rewind
選用

指示mc tag list 僅對指定時間點存在的物件版本執行操作。

  • 若要回溯到過去的特定日期,請將日期指定為 ISO8601 格式的時間戳記。例如:--rewind "2020.03.24T10:00"

  • 若要回溯一段時間,請將持續時間指定為 #d#hh#mm#ss 格式的字串。例如:--rewind "1d2hh3mm4ss"

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

--versions
選用

指示mc tag list 對儲存桶中存在的所有物件版本執行操作。

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

同時使用--versions--rewind 可以列出特定時間點存在的所有物件版本的標籤。

--version-id, vid
選用

指示mc tag list 僅對指定的物件版本執行操作。

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

與以下參數互斥

全域標誌

此命令支援任何全域標誌

範例

列出儲存桶或物件的標籤

使用mc tag list 列出儲存桶或物件的標籤

mc tag list ALIAS/PATH
  • ALIAS 替換為 MinIO 部署的別名

  • PATH 替換為 MinIO 部署上儲存桶或物件的路徑。

行為

S3 相容性

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

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