使用 Azure CLI 套用標籤

本文說明如何使用 Azure CLI 來標記資源、資源群組和訂用帳戶。 如需標記的建議及限制事項，請參閱使用標籤組織 Azure 資源和管理階層。

套用標記

Azure CLI 提供兩個命令來套用標籤：az tag create 和 az tag update。 您必須有 Azure CLI 2.10.0 版或更新版本。 您可以使用 az version 來檢查您的版本。 若要更新或安裝，請參閱安裝 Azure CLI。

az tag create 會取代資源、資源群組或訂用帳戶上的所有標記。 呼叫命令後，會傳入您要標記的實體資源識別碼。

下列範例會將一組標記套用至儲存體帳戶：

resource=$(az resource show -g demoGroup -n demostorage --resource-type Microsoft.Storage/storageAccounts --query "id" --output tsv)
az tag create --resource-id $resource --tags Dept=Finance Status=Normal

當命令完成時，請注意資源有兩個標記。

"properties": {
  "tags": {
    "Dept": "Finance",
    "Status": "Normal"
  }
},

如果您再次執行命令，但這次使用不同的標籤，請注意之前的標籤會消失。

az tag create --resource-id $resource --tags Team=Compliance Environment=Production

"properties": {
  "tags": {
    "Environment": "Production",
    "Team": "Compliance"
  }
},

若要將標記新增至已有標記的資源，請使用 az tag update。 將 --operation 參數設定為 Merge。

az tag update --resource-id $resource --operation Merge --tags Dept=Finance Status=Normal

請注意，現有的標籤會隨著新增的兩個新標籤成長。

"properties": {
  "tags": {
    "Dept": "Finance",
    "Environment": "Production",
    "Status": "Normal",
    "Team": "Compliance"
  }
},

每個標記名稱只能有一個值。 如果提供標籤新的值，即使您使用合併作業,新的標籤仍會取代舊值。 下列範例會將 Status 標記從「一般」變更為「綠色」。

az tag update --resource-id $resource --operation Merge --tags Status=Green

"properties": {
  "tags": {
    "Dept": "Finance",
    "Environment": "Production",
    "Status": "Green",
    "Team": "Compliance"
  }
},

將 --operation 參數設為 Replace 後，新的標籤集會取代現有的標籤。

az tag update --resource-id $resource --operation Replace --tags Project=ECommerce CostCenter=00123 Team=Web

只有新的標記會保留在資源上。

"properties": {
  "tags": {
    "CostCenter": "00123",
    "Project": "ECommerce",
    "Team": "Web"
  }
},

相同的命令也會使用資源群組或訂用帳戶。 將標籤傳入您要標記的資源群組或訂用帳戶的識別碼。

若要將新的標記集新增至資源群組，請使用：

group=$(az group show -n demoGroup --query id --output tsv)
az tag create --resource-id $group --tags Dept=Finance Status=Normal

若要更新資源群組的標記，請使用：

az tag update --resource-id $group --operation Merge --tags CostCenter=00123 Environment=Production

若要將新的標記集新增至訂用帳戶，請使用：

sub=$(az account show --subscription "Demo Subscription" --query id --output tsv)
az tag create --resource-id /subscriptions/$sub --tags CostCenter=00123 Environment=Dev

若要更新訂用帳戶的標記，請使用：

az tag update --resource-id /subscriptions/$sub --operation Merge --tags Team="Web Apps"

列出標籤

若要取得資源、資源群組或訂用帳戶的標籤，請使用 az tag list 命令，並傳遞實體的資源識別碼。

若要查看資源的標記，請使用：

resource=$(az resource show -g demoGroup -n demostorage --resource-type Microsoft.Storage/storageAccounts --query "id" --output tsv)
az tag list --resource-id $resource

若要查看資源群組的標記，請使用：

group=$(az group show -n demoGroup --query id --output tsv)
az tag list --resource-id $group

若要查看訂用帳戶的標記，請使用：

sub=$(az account show --subscription "Demo Subscription" --query id --output tsv)
az tag list --resource-id /subscriptions/$sub

依標記列出

若要取得具有特定標記名稱和值的資源，請使用：

az resource list --tag CostCenter=00123 --query [].name

若要取得具有特定標記名稱與任何標記值的資源，請使用：

az resource list --tag Team --query [].name

若要取得具有特定標記名稱和值的資源群組，請使用：

az group list --tag Dept=Finance

移除標記

若要移除特定標記，請使用 az tag update 並將 --operation 設定為 Delete。 傳入您要刪除標籤的資源識別碼。

az tag update --resource-id $resource --operation Delete --tags Project=ECommerce Team=Web

您已移除指定的標籤。

"properties": {
  "tags": {
    "CostCenter": "00123"
  }
},

若要移除所有標記，請使用 az tag delete 命令。

az tag delete --resource-id $resource

處理空格

如果您的標籤名稱或值包含空格，請用引號括住。

az tag update --resource-id $group --operation Merge --tags "Cost Center"=Finance-1222 Location="West US"

下一步

• 並非所有資源類型都支援標記。 若要判斷您是否可以將標籤套用至資源類型，請參閱 Azure 資源的標籤支援。
• 如需如何實作標記策略的建議，請參閱資源命名和標記決策指南。
• 如需標記的建議及限制事項，請參閱使用標籤組織 Azure 資源和管理階層。