`mc tag set`

語法

mc tag set 指令會將一個或多個標籤設定到儲存桶或物件。

MinIO 支援將最多 10 個自訂標籤新增到一個物件。

範例

以下指令在 myminio MinIO 部署上設定 mydata 儲存桶的標籤

mc tag set myminio/mydata "tag1=value1&tag2=value2"

語法

該指令具有以下語法

mc [GLOBALFLAGS] tag set                   \
                 [--rewind "string"]       \
                 [--versions]              \
                 [--version-id "string"]*  \
                 ALIAS                     \
                 "TAGS"

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

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

mc tag set --version-id 與多個參數互斥。有關詳細資訊，請參閱參考文件。

參數

ALIAS

必要

MinIO 部署的別名，以及要套用標籤的物件的完整路徑（例如，儲存桶和物件的路徑）。例如

mc tag set myminio/mybucket/object.txt

TAGS

必要

一個以 (&) 符號分隔的鍵值對清單 (KEY=VALUE)，其中每個鍵值對代表要指派給物件的一個標籤。例如：

mc tag set myminio/mybucket/object.txt "key1=value1&key2=value2"

--exclude-folders

選用

版本 RELEASE.2024-01-11T05-49-32Z 新增。

當與 --recursive 一起使用時，會使 mc tag set 不遍歷子前綴。標籤僅適用於指定路徑上的物件。需要 --recursive。

以下範例將標籤 destination=international 應用於 vacation-photos/cancun/ 的物件，但不應用於 vacation-photos/cancun/ocean/ 或其他前綴。

例如，上述操作會將標籤新增至 ``vacation-photos/cancun/pretty-beach.jpg`` 的物件，但不會新增至 ``vacation-photos/cancun/ocean/tropical-fish.jpg`` 的物件。

mc tag set myminio/vacation-photos/cancun "destination=international" --exclude-folders --recursive

--recursive, r: 選用

版本 RELEASE.2023-05-04T18-10-16Z 新增。

遞迴地將標籤應用於指定給 ALIAS 的路徑上的所有物件。

--rewind

選用

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

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

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

--versions

選用

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

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

一起使用 --versions 和 --rewind，以將標籤應用於在特定時間點存在的所有物件版本。

--version-id, --vid

選用

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

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

與下列參數互斥

--rewind
--versions

全域標誌

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

範例

將標籤套用至儲存桶或物件

使用 mc tag set 將標籤套用至儲存桶或物件

mc tag set ALIAS/PATH "TAGS"

將 ALIAS 替換為 MinIO 部署的別名。
將 PATH 替換為 MinIO 部署上儲存桶或物件的路徑。
將 TAGS 替換為一個或多個以 (&) 符號分隔的鍵值對，每個鍵值對代表一個標籤及其對應的值。

行為

S3 相容性

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

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