Címkék alkalmazása az Azure CLI-vel

  • Cikk

Ez a cikk azt ismerteti, hogyan címkézhet meg erőforrásokat, erőforráscsoportokat és előfizetéseket az Azure CLI használatával. A címkékre vonatkozó javaslatokért és korlátozásokért lásd: Címkék használata az Azure-erőforrások és a felügyeleti hierarchia rendszerezéséhez.

Címkék alkalmazása

Az Azure CLI két parancsot kínál a címkék alkalmazásához: az tag create és az tag update. Rendelkeznie kell az Azure CLI 2.10.0-s vagy újabb verziójával. A verziót a használatával az versionellenőrizheti. A frissítéshez vagy a telepítéshez lásd : Az Azure CLI telepítése.

A az tag create az erőforrás, az erőforráscsoport vagy az előfizetés összes címkéjének lecserélése. A parancs meghívásakor adja meg a címkézni kívánt entitás erőforrás-azonosítóját.

Az alábbi példa címkéket alkalmaz egy tárfiókra:

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

Amikor a parancs befejeződik, figyelje meg, hogy az erőforrás két címkét tartalmaz.

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

Ha ismét futtatja a parancsot, de ezúttal más címkékkel, figyelje meg, hogy a korábbi címkék eltűnnek.

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

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

Ha címkéket szeretne hozzáadni egy már címkéket tartalmazó erőforráshoz, használja a következőt az tag update: . Állítsa a paramétert --operation értékre Merge.

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

Figyelje meg, hogy a meglévő címkék a két új címke hozzáadásával növekednek.

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

Minden címkenév csak egy értékkel rendelkezhet. Ha új értéket ad meg egy címkéhez, az új címke lecseréli a régi értéket, még akkor is, ha az egyesítési műveletet használja. Az alábbi példa normálrólzöldre módosítja a Status címkét.

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

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

Amikor a paramétert értékre --operationReplaceállítja, az új címkekészlet lecseréli a meglévő címkéket.

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

Csak az új címkék maradnak az erőforráson.

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

Ugyanezek a parancsok erőforráscsoportokkal vagy előfizetésekkel is működnek. Adja meg a címkézni kívánt erőforráscsoport vagy előfizetés azonosítóját.

Ha új címkekészletet szeretne hozzáadni egy erőforráscsoporthoz, használja a következőt:

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

Egy erőforráscsoport címkéinek frissítéséhez használja a következőt:

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

Ha új címkekészletet szeretne hozzáadni egy előfizetéshez, használja a következőt:

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

Az előfizetés címkéinek frissítéséhez használja a következőt:

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

Címkék listázása

Egy erőforrás, erőforráscsoport vagy előfizetés címkéinek lekéréséhez használja az az tag list parancsot, és adja meg az entitás erőforrás-azonosítóját.

Egy erőforrás címkéinek megtekintéséhez használja a következőt:

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

Egy erőforráscsoport címkéinek megtekintéséhez használja a következőt:

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

Az előfizetés címkéinek megtekintéséhez használja a következőt:

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

Lista címke szerint

Ha egy adott címkenévvel és értékkel rendelkező erőforrásokat szeretne lekérni, használja a következőt:

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

Ha egy adott címkenévvel rendelkező erőforrásokat szeretne lekérni bármilyen címkeértékkel, használja a következőt:

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

Ha egy adott címkenévvel és értékkel rendelkező erőforráscsoportokat szeretne lekérni, használja a következőt:

az group list --tag Dept=Finance

Címkék eltávolítása

Adott címkék eltávolításához használja a parancsot az tag update , és állítsa a következőre --operation : Delete. Adja meg a törölni kívánt címkék erőforrás-azonosítóját.

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

Eltávolította a megadott címkéket.

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

Az összes címke eltávolításához használja az az tag delete parancsot.

az tag delete --resource-id $resource

Szóközök kezelése

Ha a címkenevek vagy -értékek szóközöket tartalmaznak, tegye őket idézőjelek közé.

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

Következő lépések