Share via

az tag

  • 參考

資源上的標籤管理。

命令

名稱 Description 類型 狀態
az tag add-value

建立標籤值。

 核心 GA
az tag create

在特定資源上建立標記。

 核心 GA
az tag delete

刪除特定資源上的標記。

 核心 GA
az tag list

列出特定資源上的整個標記集。

 核心 GA
az tag remove-value

刪除預先定義標籤名稱的預先定義標籤值。

 核心 GA
az tag update

選擇性地更新特定資源上的標記集。

 核心 GA

az tag add-value

編輯

建立標籤值。

az tag add-value --name
                 --value

範例

建立標籤值。

az tag add-value --name MyTag --value MyValue

必要參數

--name -n

標記名稱。

--value

標籤值。

全域參數
--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az tag create

編輯

在特定資源上建立標記。

具有 id 的 az tag create 命令會建立或更新資源、資源群組或訂用帳戶上的整個標記集。 此作業允許在指定的資源、資源群組或訂用帳戶上新增或取代整個標記集。 指定的實體最多可以有 50 個標籤。 請注意：'tag create' 的作用就像是 'tag init'，因此使用此命令建立的標籤是唯一在執行之後存在的標記。

az tag create [--name]
              [--resource-id]
              [--tags]

範例

在訂用帳戶中建立標記。

az tag create --name MyTag

在訂用帳戶上建立或更新整個標記集。

az tag create --resource-id /subscriptions/{subId} --tags Dept=Finance Status=Normal

在資源群組上建立或更新整個標記集。

az tag create --resource-id /subscriptions/{sub-id}/resourcegroups/{rg} --tags Dept=Finance Status=Normal

在資源上建立或更新整個標記集。

az tag create --resource-id /subscriptions/{sub-id}/resourcegroups/{rg}/providers/Microsoft.Compute/virtualMachines/{vmName} --tags Dept=Finance Status=Normal

選擇性參數

--name -n

要建立的標記名稱。

--resource-id

要標記之實體的資源識別碼。 可能會標記資源、資源群組或訂用帳戶。

--tags

要套用至資源的標記。

全域參數
--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az tag delete

編輯

刪除特定資源上的標記。

具有 id 的 az tag delete 命令會刪除資源、資源群組或訂用帳戶上的整個標記集。

az tag delete [--name]
              [--resource-id]
              [--yes]

範例

從與資源沒有關聯的訂用帳戶中刪除預先定義的標籤，或沒有標籤值。

az tag delete --name MyTag

刪除訂用帳戶上的整個標記集。

az tag delete --resource-id /subscriptions/{sub-id}

刪除資源群組上的整個標記集。

az tag delete --resource-id /subscriptions/{sub-id}/resourcegroups/{rg}

刪除資源上的整個標記集。 （即使使用 --name 搭配 --resource-id 來指定單一標記）

az tag delete --resource-id /subscriptions/{sub-id}/resourcegroups/{rg}/providers/Microsoft.Compute/virtualMachines/{vmName}

選擇性參數

--name -n

要刪除的標記名稱。

--resource-id

要標記之實體的資源識別碼。 可能會標記資源、資源群組或訂用帳戶。

--yes -y

不提示確認。

預設值: False
全域參數
--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az tag list

編輯

列出特定資源上的整個標記集。

具有識別碼的 az tag list 命令會列出資源、資源群組或訂用帳戶上的整個標記集。

az tag list [--resource-id]

範例

列出訂用帳戶上的整個標記集。

az tag list --resource-id /subscriptions/{sub-id}

列出資源群組上的整個標記集。

az tag list --resource-id /subscriptions/{sub-id}/resourcegroups/{rg}

列出資源上的整個標記集。

az tag list --resource-id /subscriptions/{sub-id}/resourcegroups/{rg}/providers/Microsoft.Compute/virtualMachines/{vmName}

選擇性參數

--resource-id

要標記之實體的資源識別碼。 可能會標記資源、資源群組或訂用帳戶。

全域參數
--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az tag remove-value

編輯

刪除預先定義標籤名稱的預先定義標籤值。

這項作業允許從現有預先定義標籤名稱的預先定義值清單中刪除值。 要刪除的值不得做為任何資源的指定標籤名稱的標記值。

az tag remove-value --name
                    --value

必要參數

--name -n

標記名稱。

--value

標籤值。

全域參數
--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az tag update

編輯

選擇性地更新特定資源上的標記集。

具有識別碼的 az tag update 命令會選擇性地更新資源、資源群組或訂用帳戶上的標記集。 此作業允許取代、合併或選擇性刪除指定資源、資源群組或訂用帳戶上的標記。 指定的實體在作業結束時最多可以有 50 個標記。 [取代] 選項會以新的集合取代整個現有標記集。 [合併] 選項允許新增具有新名稱的標籤，並更新具有現有名稱的標籤值。 [刪除] 選項允許根據指定的名稱或名稱/值組選擇性地刪除標記。

az tag update --operation {Delete, Merge, Replace}
              --resource-id
              --tags

範例

選擇性地使用「合併」作業更新訂用帳戶上的標記集。

az tag update --resource-id /subscriptions/{sub-id} --operation merge --tags key1=value1 key3=value3

選擇性地將資源群組上的標記集更新為「取代」作業。

az tag update --resource-id /subscriptions/{sub-id}/resourcegroups/{rg} --operation replace --tags key1=value1 key3=value3

選擇性地使用「刪除」作業來更新資源上的標記集。

az tag update --resource-id /subscriptions/{sub-id}/resourcegroups/{rg}/providers/Microsoft.Compute/virtualMachines/{vmName} --operation delete --tags key1=value1

必要參數

--operation

更新作業。 選項為 [合併]、[取代] 和 [刪除]。

接受的值: Delete, Merge, Replace
--resource-id

要標記之實體的資源識別碼。 可能會標記資源、資源群組或訂用帳戶。

--tags

要更新資源上的標記。

全域參數
--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。