az tag

  • Referens

Tagghantering på en resurs.

Kommandon

Name Description Typ Status
az tag add-value

Skapa ett taggvärde.

 Kärna Allmän tillgänglighet
az tag create

Skapa taggar på en specifik resurs.

 Kärna Allmän tillgänglighet
az tag delete

Ta bort taggar för en specifik resurs.

 Kärna Allmän tillgänglighet
az tag list

Visa en lista över hela uppsättningen taggar för en specifik resurs.

 Kärna Allmän tillgänglighet
az tag remove-value

Tar bort ett fördefinierat taggvärde för ett fördefinierat taggnamn.

 Kärna Allmän tillgänglighet
az tag update

Uppdatera uppsättningen taggar på en specifik resurs selektivt.

 Kärna Allmän tillgänglighet

az tag add-value

Redigera

Skapa ett taggvärde.

az tag add-value --name
                 --value

Exempel

Skapa ett taggvärde.

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

Obligatoriska parametrar

--name -n

Taggnamnet.

--value

Taggvärdet.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az tag create

Redigera

Skapa taggar på en specifik resurs.

Kommandot az tag create med ett ID skapar eller uppdaterar hela uppsättningen taggar på en resurs, resursgrupp eller prenumeration. Med den här åtgärden kan du lägga till eller ersätta hela uppsättningen taggar på den angivna resursen, resursgruppen eller prenumerationen. Den angivna entiteten kan ha högst 50 taggar. Obs! "tag create" fungerar som en "tag init" och därför är taggar som skapats med det här kommandot de enda som finns efter körningen.

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

Exempel

Skapa en tagg i prenumerationen.

az tag create --name MyTag

Skapa eller uppdatera hela uppsättningen taggar i en prenumeration.

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

Skapa eller uppdatera hela uppsättningen taggar i en resursgrupp.

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

Skapa eller uppdatera hela uppsättningen taggar på en resurs.

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

Valfria parametrar

--name -n

Namnet på taggen som ska skapas.

--resource-id

Resursidentifieraren för entiteten som taggas. En resurs, en resursgrupp eller en prenumeration kan vara taggade.

--tags

Taggarna som ska tillämpas på resursen.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az tag delete

Redigera

Ta bort taggar för en specifik resurs.

Kommandot az tag delete med ett ID tar bort hela uppsättningen taggar på en resurs, resursgrupp eller prenumeration.

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

Exempel

Ta bort en fördefinierad tagg från prenumerationen som inte är associerad med en resurs eller utan taggvärden.

az tag delete --name MyTag

Ta bort hela uppsättningen taggar i en prenumeration.

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

Ta bort hela uppsättningen taggar i en resursgrupp.

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

Ta bort hela uppsättningen taggar på en resurs. (Även om du använder --name tillsammans med --resource-id för att ange en enda tagg)

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

Valfria parametrar

--name -n

Namnet på taggen som ska tas bort.

--resource-id

Resursidentifieraren för entiteten som taggas. En resurs, en resursgrupp eller en prenumeration kan vara taggade.

--yes -y

Fråga inte efter bekräftelse.

standardvärde: False
Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az tag list

Redigera

Visa en lista över hela uppsättningen taggar för en specifik resurs.

Kommandot az tag list med ett ID visar hela uppsättningen taggar för en resurs, resursgrupp eller prenumeration.

az tag list [--resource-id]

Exempel

Visa en lista över hela uppsättningen taggar i en prenumeration.

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

Visa en lista över hela uppsättningen taggar i en resursgrupp.

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

Visa en lista över hela uppsättningen taggar på en resurs.

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

Valfria parametrar

--resource-id

Resursidentifieraren för entiteten som taggas. En resurs, en resursgrupp eller en prenumeration kan vara taggade.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az tag remove-value

Redigera

Tar bort ett fördefinierat taggvärde för ett fördefinierat taggnamn.

Med den här åtgärden kan du ta bort ett värde från listan med fördefinierade värden för ett befintligt fördefinierat taggnamn. Värdet som tas bort får inte användas som ett taggvärde för det angivna taggnamnet för någon resurs.

az tag remove-value --name
                    --value

Obligatoriska parametrar

--name -n

Taggnamnet.

--value

Taggvärdet.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az tag update

Redigera

Uppdatera uppsättningen taggar på en specifik resurs selektivt.

Kommandot az tag update med ett ID uppdaterar selektivt uppsättningen taggar för en resurs, resursgrupp eller prenumeration. Med den här åtgärden kan du ersätta, slå samman eller selektivt ta bort taggar på den angivna resursen, resursgruppen eller prenumerationen. Den angivna entiteten kan ha högst 50 taggar i slutet av åtgärden. Alternativet Ersätt ersätter hela uppsättningen befintliga taggar med en ny uppsättning. Alternativet "sammanfogning" gör det möjligt att lägga till taggar med nya namn och uppdatera värdena för taggar med befintliga namn. Alternativet "ta bort" tillåter selektiv borttagning av taggar baserat på förnamn eller namn/värde-par.

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

Exempel

Uppdatera uppsättningen taggar selektivt i en prenumeration med åtgärden "merge".

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

Uppdatera uppsättningen taggar på en resursgrupp selektivt med "ersätt"-åtgärden.

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

Uppdatera uppsättningen taggar på en resurs selektivt med åtgärden "ta bort".

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

Obligatoriska parametrar

--operation

Uppdateringsåtgärden. Alternativen är Sammanfoga, Ersätt och Ta bort.

accepterade värden: Delete, Merge, Replace
--resource-id

Resursidentifieraren för entiteten som taggas. En resurs, en resursgrupp eller en prenumeration kan vara taggade.

--tags

Taggarna som ska uppdateras på resursen.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.