Usare i tag per organizzare le risorse di Azure e la gerarchia di gestioneUse tags to organize your Azure resources and management hierarchy

I tag vengono applicati alle risorse, ai gruppi di risorse e alle sottoscrizioni di Azure per organizzarli in modo logico in una tassonomia.You apply tags to your Azure resources, resource groups, and subscriptions to logically organize them into a taxonomy. Ogni tag è costituito da una coppia di nome e valore.Each tag consists of a name and a value pair. Ad esempio, è possibile applicare il nome "Environment" e il valore "Production" a tutte le risorse nell'ambiente di produzione.For example, you can apply the name "Environment" and the value "Production" to all the resources in production.

Per indicazioni su come implementare una strategia di assegnazione di tag, vedere la pagina relativa alla denominazione delle risorse e all'assegnazione di tag.For recommendations on how to implement a tagging strategy, see Resource naming and tagging decision guide.

Importante

I nomi di tag non fanno distinzione tra maiuscole e minuscole per le operazioni.Tag names are case-insensitive for operations. Un tag con un nome di tag, indipendentemente dalla combinazione di maiuscole e minuscole, viene aggiornato o recuperato.A tag with a tag name, regardless of casing, is updated or retrieved. Il provider di risorse, tuttavia, può contenere le maiuscole e minuscole fornite per il nome del tag.However, the resource provider might keep the casing you provide for the tag name. Si noterà che le maiuscole e minuscole nei report sui costi.You'll see that casing in cost reports.

I valori dei tag distinguono tra maiuscole e minuscoleTag values are case-sensitive.

Nota

Questo articolo illustra le procedure per l'eliminazione dei dati personali dal dispositivo o dal servizio e può essere usato per adempiere gli obblighi del Regolamento generale sulla protezione dei dati (GDPR).This article provides steps for how to delete personal data from the device or service and can be used to support your obligations under the GDPR. Per informazioni generali sulla normativa GDPR, vedere la sezione GDPR del portale Service Trust.If you’re looking for general info about GDPR, see the GDPR section of the Service Trust portal.

Accesso obbligatorioRequired access

Per applicare i tag a una risorsa, è necessario disporre dell'accesso in scrittura al tipo di risorsa Microsoft. resources/Tags .To apply tags to a resource, you must have write access to the Microsoft.Resources/tags resource type. Il ruolo di collaboratore Tag consente di applicare tag a un'entità senza avere accesso all'entità stessa.The Tag Contributor role lets you apply tags to an entity without having access to the entity itself. Attualmente, il ruolo Collaboratore tag non può applicare tag a risorse o gruppi di risorse tramite il portale.Currently, the tag contributor role can't apply tags to resources or resource groups through the portal. Può applicare tag alle sottoscrizioni tramite il portale.It can apply tags to subscriptions through the portal. Supporta tutte le operazioni sui tag tramite PowerShell e l'API REST.It supports all tag operations through PowerShell and REST API.

Il ruolo collaboratore concede anche l'accesso richiesto per applicare tag a qualsiasi entità.The Contributor role also grants the required access to apply tags to any entity. Per applicare tag a un solo tipo di risorsa, usare il ruolo di collaboratore per tale risorsa.To apply tags to only one resource type, use the contributor role for that resource. Ad esempio, per applicare tag a macchine virtuali, usare il ruolo di Collaboratore Macchina virtuale.For example, to apply tags to virtual machines, use the Virtual Machine Contributor.

PowerShellPowerShell

Applica tagApply tags

Azure PowerShell offre due comandi per l'applicazione di tag- New-AzTag e Update-AzTag.Azure PowerShell offers two commands for applying tags - New-AzTag and Update-AzTag. È necessario avere il modulo AZ. resources 1.12.0 o versione successiva.You must have the Az.Resources module 1.12.0 or later. È possibile controllare la versione con Get-Module Az.Resources .You can check your version with Get-Module Az.Resources. È possibile installare il modulo o installare Azure PowerShell 3.6.1 o versione successiva.You can install that module or install Azure PowerShell 3.6.1 or later.

New-AzTag sostituisce tutti i tag per la risorsa, il gruppo di risorse o la sottoscrizione.The New-AzTag replaces all tags on the resource, resource group, or subscription. Quando si chiama il comando, passare l'ID risorsa dell'entità a cui si vuole assegnare un tag.When calling the command, pass in the resource ID of the entity you wish to tag.

Nell'esempio seguente viene applicato un set di tag a un account di archiviazione:The following example applies a set of tags to a storage account:

$tags = @{"Dept"="Finance"; "Status"="Normal"}
$resource = Get-AzResource -Name demoStorage -ResourceGroup demoGroup
New-AzTag -ResourceId $resource.id -Tag $tags

Al termine del comando, si noti che la risorsa ha due tag.When the command completes, notice that the resource has two tags.

Properties :
        Name    Value
        ======  =======
        Dept    Finance
        Status  Normal

Se si esegue di nuovo il comando, ma questa volta con tag diversi, si noterà che i tag precedenti vengono rimossi.If you run the command again but this time with different tags, notice that the earlier tags are removed.

$tags = @{"Team"="Compliance"; "Environment"="Production"}
New-AzTag -ResourceId $resource.id -Tag $tags
Properties :
        Name         Value
        ===========  ==========
        Environment  Production
        Team         Compliance

Per aggiungere tag a una risorsa che dispone già di tag, usare Update-AzTag.To add tags to a resource that already has tags, use Update-AzTag. Impostare il parametro -Operation su merge.Set the -Operation parameter to Merge.

$tags = @{"Dept"="Finance"; "Status"="Normal"}
Update-AzTag -ResourceId $resource.id -Tag $tags -Operation Merge

Si noti che i due nuovi tag sono stati aggiunti ai due tag esistenti.Notice that the two new tags were added to the two existing tags.

Properties :
        Name         Value
        ===========  ==========
        Status       Normal
        Dept         Finance
        Team         Compliance
        Environment  Production

Ogni nome di tag può avere un solo valore.Each tag name can have only one value. Se si specifica un nuovo valore per un tag, il valore precedente viene sostituito anche se si utilizza l'operazione di Unione.If you provide a new value for a tag, the old value is replaced even if you use the merge operation. Nell'esempio seguente viene modificato il tag di stato da Normal a Green.The following example changes the Status tag from Normal to Green.

$tags = @{"Status"="Green"}
Update-AzTag -ResourceId $resource.id -Tag $tags -Operation Merge
Properties :
        Name         Value
        ===========  ==========
        Status       Green
        Dept         Finance
        Team         Compliance
        Environment  Production

Quando si imposta il parametro -Operation su Replace, i tag esistenti vengono sostituiti dal nuovo set di tag.When you set the -Operation parameter to Replace, the existing tags are replaced by the new set of tags.

$tags = @{"Project"="ECommerce"; "CostCenter"="00123"; "Team"="Web"}
Update-AzTag -ResourceId $resource.id -Tag $tags -Operation Replace

Solo i nuovi tag rimangono nella risorsa.Only the new tags remain on the resource.

Properties :
        Name        Value
        ==========  =========
        CostCenter  00123
        Team        Web
        Project     ECommerce

Gli stessi comandi funzionano anche con i gruppi di risorse o le sottoscrizioni.The same commands also work with resource groups or subscriptions. Si passa l'identificatore per il gruppo di risorse o la sottoscrizione che si vuole contrassegnare.You pass in the identifier for the resource group or subscription you want to tag.

Per aggiungere un nuovo set di tag a un gruppo di risorse, usare:To add a new set of tags to a resource group, use:

$tags = @{"Dept"="Finance"; "Status"="Normal"}
$resourceGroup = Get-AzResourceGroup -Name demoGroup
New-AzTag -ResourceId $resourceGroup.ResourceId -tag $tags

Per aggiornare i tag per un gruppo di risorse, usare:To update the tags for a resource group, use:

$tags = @{"CostCenter"="00123"; "Environment"="Production"}
$resourceGroup = Get-AzResourceGroup -Name demoGroup
Update-AzTag -ResourceId $resourceGroup.ResourceId -Tag $tags -Operation Merge

Per aggiungere un nuovo set di tag a una sottoscrizione, usare:To add a new set of tags to a subscription, use:

$tags = @{"CostCenter"="00123"; "Environment"="Dev"}
$subscription = (Get-AzSubscription -SubscriptionName "Example Subscription").Id
New-AzTag -ResourceId "/subscriptions/$subscription" -Tag $tags

Per aggiornare i tag per una sottoscrizione, usare:To update the tags for a subscription, use:

$tags = @{"Team"="Web Apps"}
$subscription = (Get-AzSubscription -SubscriptionName "Example Subscription").Id
Update-AzTag -ResourceId "/subscriptions/$subscription" -Tag $tags -Operation Merge

È possibile avere più di una risorsa con lo stesso nome in un gruppo di risorse.You may have more than one resource with the same name in a resource group. In tal caso, è possibile impostare ogni risorsa con i comandi seguenti:In that case, you can set each resource with the following commands:

$resource = Get-AzResource -ResourceName sqlDatabase1 -ResourceGroupName examplegroup
$resource | ForEach-Object { Update-AzTag -Tag @{ "Dept"="IT"; "Environment"="Test" } -ResourceId $_.ResourceId -Operation Merge }

Elencare tagList tags

Per ottenere i tag per una risorsa, un gruppo di risorse o una sottoscrizione, usare il comando Get-AzTag e passare l'ID risorsa per l'entità.To get the tags for a resource, resource group, or subscription, use the Get-AzTag command and pass in the resource ID for the entity.

Per visualizzare i tag per una risorsa, usare:To see the tags for a resource, use:

$resource = Get-AzResource -Name demoStorage -ResourceGroup demoGroup
Get-AzTag -ResourceId $resource.id

Per visualizzare i tag per un gruppo di risorse, usare:To see the tags for a resource group, use:

$resourceGroup = Get-AzResourceGroup -Name demoGroup
Get-AzTag -ResourceId $resourceGroup.ResourceId

Per visualizzare i tag per una sottoscrizione, usare:To see the tags for a subscription, use:

$subscription = (Get-AzSubscription -SubscriptionName "Example Subscription").Id
Get-AzTag -ResourceId "/subscriptions/$subscription"

Elenca per tagList by tag

Per ottenere le risorse con un nome e un valore di tag specifici, usare:To get resources that have a specific tag name and value, use:

(Get-AzResource -Tag @{ "CostCenter"="00123"}).Name

Per ottenere le risorse con un nome di tag specifico con qualsiasi valore di tag, usare:To get resources that have a specific tag name with any tag value, use:

(Get-AzResource -TagName "Dept").Name

Per ottenere i gruppi di risorse con un nome e un valore di tag specifici, usare:To get resource groups that have a specific tag name and value, use:

(Get-AzResourceGroup -Tag @{ "CostCenter"="00123" }).ResourceGroupName

Rimuovi TagRemove tags

Per rimuovere tag specifici, usare Update-AzTag e set -Operation per eliminare.To remove specific tags, use Update-AzTag and set -Operation to Delete. Passare i tag che si desidera eliminare.Pass in the tags you want to delete.

$removeTags = @{"Project"="ECommerce"; "Team"="Web"}
Update-AzTag -ResourceId $resource.id -Tag $removeTags -Operation Delete

I tag specificati vengono rimossi.The specified tags are removed.

Properties :
        Name        Value
        ==========  =====
        CostCenter  00123

Per rimuovere tutti i tag, usare il comando Remove-AzTag .To remove all tags, use the Remove-AzTag command.

$subscription = (Get-AzSubscription -SubscriptionName "Example Subscription").Id
Remove-AzTag -ResourceId "/subscriptions/$subscription"

Interfaccia della riga di comando di AzureAzure CLI

Applica tagApply tags

L'interfaccia della riga di comando di Azure offre due comandi per applicare tag: AZ Tag create e AZ Tag Update.Azure CLI offers two commands for applying tags - az tag create and az tag update. È necessario disporre dell'interfaccia della riga di comando di Azure 2.10.0 o versione successiva.You must have Azure CLI 2.10.0 or later. È possibile controllare la versione con az version .You can check your version with az version. Per aggiornare o installare, vedere installare l'interfaccia dellariga di comando di Azure.To update or install, see Install the Azure CLI.

AZ Tag create sostituisce tutti i tag per la risorsa, il gruppo di risorse o la sottoscrizione.The az tag create replaces all tags on the resource, resource group, or subscription. Quando si chiama il comando, passare l'ID risorsa dell'entità a cui si vuole assegnare un tag.When calling the command, pass in the resource ID of the entity you wish to tag.

Nell'esempio seguente viene applicato un set di tag a un account di archiviazione:The following example applies a set of tags to a storage account:

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

Al termine del comando, si noti che la risorsa ha due tag.When the command completes, notice that the resource has two tags.

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

Se si esegue di nuovo il comando, ma questa volta con tag diversi, si noterà che i tag precedenti vengono rimossi.If you run the command again but this time with different tags, notice that the earlier tags are removed.

az tag create --resource-id $resource --tags Team=Compliance Environment=Production
"properties": {
  "tags": {
    "Environment": "Production",
    "Team": "Compliance"
  }
},

Per aggiungere tag a una risorsa che dispone già di tag, usare AZ Tag Update.To add tags to a resource that already has tags, use az tag update. Impostare il parametro --Operation per eseguire il merge.Set the --operation parameter to Merge.

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

Si noti che i due nuovi tag sono stati aggiunti ai due tag esistenti.Notice that the two new tags were added to the two existing tags.

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

Ogni nome di tag può avere un solo valore.Each tag name can have only one value. Se si specifica un nuovo valore per un tag, il valore precedente viene sostituito anche se si utilizza l'operazione di Unione.If you provide a new value for a tag, the old value is replaced even if you use the merge operation. Nell'esempio seguente viene modificato il tag di stato da Normal a Green.The following example changes the Status tag from Normal to Green.

az tag update --resource-id $resource --operation Merge --tags Status=Green
"properties": {
  "tags": {
    "Dept": "Finance",
    "Environment": "Production",
    "Status": "Green",
    "Team": "Compliance"
  }
},

Quando si imposta il parametro --Operation su Replace, i tag esistenti vengono sostituiti dal nuovo set di tag.When you set the --operation parameter to Replace, the existing tags are replaced by the new set of tags.

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

Solo i nuovi tag rimangono nella risorsa.Only the new tags remain on the resource.

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

Gli stessi comandi funzionano anche con i gruppi di risorse o le sottoscrizioni.The same commands also work with resource groups or subscriptions. Si passa l'identificatore per il gruppo di risorse o la sottoscrizione che si vuole contrassegnare.You pass in the identifier for the resource group or subscription you want to tag.

Per aggiungere un nuovo set di tag a un gruppo di risorse, usare:To add a new set of tags to a resource group, use:

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

Per aggiornare i tag per un gruppo di risorse, usare:To update the tags for a resource group, use:

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

Per aggiungere un nuovo set di tag a una sottoscrizione, usare:To add a new set of tags to a subscription, use:

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

Per aggiornare i tag per una sottoscrizione, usare:To update the tags for a subscription, use:

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

Elencare tagList tags

Per ottenere i tag per una risorsa, un gruppo di risorse o una sottoscrizione, usare il comando AZ Tag List e passare l'ID risorsa per l'entità.To get the tags for a resource, resource group, or subscription, use the az tag list command and pass in the resource ID for the entity.

Per visualizzare i tag per una risorsa, usare:To see the tags for a resource, use:

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

Per visualizzare i tag per un gruppo di risorse, usare:To see the tags for a resource group, use:

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

Per visualizzare i tag per una sottoscrizione, usare:To see the tags for a subscription, use:

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

Elenca per tagList by tag

Per ottenere le risorse con un nome e un valore di tag specifici, usare:To get resources that have a specific tag name and value, use:

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

Per ottenere le risorse con un nome di tag specifico con qualsiasi valore di tag, usare:To get resources that have a specific tag name with any tag value, use:

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

Per ottenere i gruppi di risorse con un nome e un valore di tag specifici, usare:To get resource groups that have a specific tag name and value, use:

az group list --tag Dept=Finance

Rimuovi TagRemove tags

Per rimuovere tag specifici, usare AZ Tag Update e set --Operation to Delete.To remove specific tags, use az tag update and set --operation to Delete. Passare i tag che si desidera eliminare.Pass in the tags you want to delete.

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

I tag specificati vengono rimossi.The specified tags are removed.

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

Per rimuovere tutti i tag, usare il comando AZ Tag delete .To remove all tags, use the az tag delete command.

az tag delete --resource-id $resource

Gestione di spaziHandling spaces

Se i nomi o i valori dei tag includono spazi, racchiuderli tra virgolette doppie.If your tag names or values include spaces, enclose them in double quotes.

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

ModelliTemplates

È possibile contrassegnare risorse, gruppi di risorse e sottoscrizioni durante la distribuzione con un modello di Gestione risorse.You can tag resources, resource groups, and subscriptions during deployment with a Resource Manager template.

Applica valoriApply values

Nell'esempio seguente viene distribuito un account di archiviazione con tre tag.The following example deploys a storage account with three tags. Due dei tag ( Dept e Environment ) sono impostati su valori letterali.Two of the tags (Dept and Environment) are set to literal values. Un tag ( LastDeployed ) è impostato su un parametro il cui valore predefinito è la data corrente.One tag (LastDeployed) is set to a parameter that defaults to the current date.

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "utcShort": {
            "type": "string",
            "defaultValue": "[utcNow('d')]"
        },
        "location": {
            "type": "string",
            "defaultValue": "[resourceGroup().location]"
        }
    },
    "resources": [
        {
            "apiVersion": "2019-04-01",
            "type": "Microsoft.Storage/storageAccounts",
            "name": "[concat('storage', uniqueString(resourceGroup().id))]",
            "location": "[parameters('location')]",
            "tags": {
                "Dept": "Finance",
                "Environment": "Production",
                "LastDeployed": "[parameters('utcShort')]"
            },
            "sku": {
                "name": "Standard_LRS"
            },
            "kind": "Storage",
            "properties": {}
        }
    ]
}

Applicare un oggettoApply an object

È possibile definire un parametro oggetto in cui vengono memorizzati diversi tag e applicare tale oggetto all'elemento tag.You can define an object parameter that stores several tags, and apply that object to the tag element. Questo approccio offre una maggiore flessibilità rispetto all'esempio precedente, perché l'oggetto può avere proprietà diverse.This approach provides more flexibility than the previous example because the object can have different properties. Ogni proprietà nell'oggetto diventa un tag separato per la risorsa.Each property in the object becomes a separate tag for the resource. L'esempio seguente include un parametro denominato tagValues che viene applicato all'elemento tag.The following example has a parameter named tagValues that is applied to the tag element.

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "location": {
            "type": "string",
            "defaultValue": "[resourceGroup().location]"
        },
        "tagValues": {
            "type": "object",
            "defaultValue": {
                "Dept": "Finance",
                "Environment": "Production"
            }
        }
    },
    "resources": [
        {
            "apiVersion": "2019-04-01",
            "type": "Microsoft.Storage/storageAccounts",
            "name": "[concat('storage', uniqueString(resourceGroup().id))]",
            "location": "[parameters('location')]",
            "tags": "[parameters('tagValues')]",
            "sku": {
                "name": "Standard_LRS"
            },
            "kind": "Storage",
            "properties": {}
        }
    ]
}

Applicare una stringa JSONApply a JSON string

Per memorizzare più valori in un singolo tag, è possibile applicare una stringa JSON che rappresenta tali valori.To store many values in a single tag, apply a JSON string that represents the values. L'intera stringa JSON viene archiviata come un tag che non può superare i 256 caratteri.The entire JSON string is stored as one tag that can't exceed 256 characters. L'esempio seguente include un tag singolo denominato CostCenter che contiene più valori da una stringa JSON:The following example has a single tag named CostCenter that contains several values from a JSON string:

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "location": {
            "type": "string",
            "defaultValue": "[resourceGroup().location]"
        }
    },
    "resources": [
        {
            "apiVersion": "2019-04-01",
            "type": "Microsoft.Storage/storageAccounts",
            "name": "[concat('storage', uniqueString(resourceGroup().id))]",
            "location": "[parameters('location')]",
            "tags": {
                "CostCenter": "{\"Dept\":\"Finance\",\"Environment\":\"Production\"}"
            },
            "sku": {
                "name": "Standard_LRS"
            },
            "kind": "Storage",
            "properties": {}
        }
    ]
}

Applicare i tag dal gruppo di risorseApply tags from resource group

Per applicare i tag da un gruppo di risorse a una risorsa, usare la funzione resourceGroup () .To apply tags from a resource group to a resource, use the resourceGroup() function. Quando si recupera il valore del tag, usare la tags[tag-name] sintassi invece della tags.tag-name sintassi, perché alcuni caratteri non vengono analizzati correttamente nella notazione del punto.When getting the tag value, use the tags[tag-name] syntax instead of the tags.tag-name syntax, because some characters aren't parsed correctly in the dot notation.

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "location": {
            "type": "string",
            "defaultValue": "[resourceGroup().location]"
        }
    },
    "resources": [
        {
            "apiVersion": "2019-04-01",
            "type": "Microsoft.Storage/storageAccounts",
            "name": "[concat('storage', uniqueString(resourceGroup().id))]",
            "location": "[parameters('location')]",
            "tags": {
                "Dept": "[resourceGroup().tags['Dept']]",
                "Environment": "[resourceGroup().tags['Environment']]"
            },
            "sku": {
                "name": "Standard_LRS"
            },
            "kind": "Storage",
            "properties": {}
        }
    ]
}

Applicare tag a gruppi di risorse o sottoscrizioniApply tags to resource groups or subscriptions

È possibile aggiungere tag a un gruppo di risorse o a una sottoscrizione distribuendo il tipo di risorsa Microsoft. resources/Tags .You can add tags to a resource group or subscription by deploying the Microsoft.Resources/tags resource type. I tag vengono applicati al gruppo di risorse o alla sottoscrizione di destinazione per la distribuzione.The tags are applied to the target resource group or subscription for the deployment. Ogni volta che si distribuisce il modello, sostituire eventuali tag applicati in precedenza.Each time you deploy the template you replace any tags there were previously applied.

{
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "tagName": {
            "type": "string",
            "defaultValue": "TeamName"
        },
        "tagValue": {
            "type": "string",
            "defaultValue": "AppTeam1"
        }
    },
    "variables": {},
    "resources": [
        {
            "type": "Microsoft.Resources/tags",
            "name": "default",
            "apiVersion": "2019-10-01",
            "dependsOn": [],
            "properties": {
                "tags": {
                    "[parameters('tagName')]": "[parameters('tagValue')]"
                }
            }
        }
    ]
}

Per applicare i tag a un gruppo di risorse, usare PowerShell o l'interfaccia della riga di comando di Azure.To apply the tags to a resource group, use either PowerShell or Azure CLI. Eseguire la distribuzione nel gruppo di risorse che si desidera contrassegnare.Deploy to the resource group that you want to tag.

New-AzResourceGroupDeployment -ResourceGroupName exampleGroup -TemplateFile https://raw.githubusercontent.com/Azure/azure-docs-json-samples/master/azure-resource-manager/tags.json
az deployment group create --resource-group exampleGroup --template-uri https://raw.githubusercontent.com/Azure/azure-docs-json-samples/master/azure-resource-manager/tags.json

Per applicare i tag a una sottoscrizione, usare PowerShell o l'interfaccia della riga di comando di Azure.To apply the tags to a subscription, use either PowerShell or Azure CLI. Eseguire la distribuzione nella sottoscrizione che si vuole contrassegnare.Deploy to the subscription that you want to tag.

New-AzSubscriptionDeployment -name tagresourcegroup -Location westus2 -TemplateUri https://raw.githubusercontent.com/Azure/azure-docs-json-samples/master/azure-resource-manager/tags.json
az deployment sub create --name tagresourcegroup --location westus2 --template-uri https://raw.githubusercontent.com/Azure/azure-docs-json-samples/master/azure-resource-manager/tags.json

Per altre informazioni sulle distribuzioni delle sottoscrizioni, vedere creare gruppi di risorse e risorse a livello di sottoscrizione.For more information about subscription deployments, see Create resource groups and resources at the subscription level.

Il modello seguente aggiunge i tag da un oggetto a un gruppo di risorse o a una sottoscrizione.The following template adds the tags from an object to either a resource group or subscription.

"$schema": "https://schema.management.azure.com/schemas/2018-05-01/subscriptionDeploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "tags": {
            "type": "object",
            "defaultValue": {
                "TeamName": "AppTeam1",
                "Dept": "Finance",
                "Environment": "Production"
            }
        }
    },
    "variables": {},
    "resources": [
        {
            "type": "Microsoft.Resources/tags",
            "name": "default",
            "apiVersion": "2019-10-01",
            "dependsOn": [],
            "properties": {
                "tags": "[parameters('tags')]"
            }
        }
    ]
}

PortalePortal

Se un utente non ha l'accesso richiesto per l'applicazione di tag, è possibile assegnare all'utente il ruolo Collaboratore per tag.If a user doesn't have the required access for applying tags, you can assign the Tag Contributor role to the user. Per altre informazioni, vedere Esercitazione: Concedere l'accesso alle risorse di Azure a un utente usando il controllo degli accessi in base al ruolo e il portale di Azure.For more information, see Tutorial: Grant a user access to Azure resources using RBAC and the Azure portal.

  1. Per visualizzare i tag per una risorsa o un gruppo di risorse, cercare i tag esistenti nella panoramica.To view the tags for a resource or a resource group, look for existing tags in the overview. Se in precedenza non sono stati applicati tag, l'elenco è vuoto.If you have not previously applied tags, the list is empty.

    Visualizzare i tag per la risorsa o il gruppo di risorse

  2. Per aggiungere un tag, selezionare Fare clic qui per aggiungere i tag.To add a tag, select Click here to add tags.

  3. Specificare un nome e valore.Provide a name and value.

    Aggiungere un tag

  4. Continuare ad aggiungere i tag in base alle esigenze.Continue adding tags as needed. Al termine scegliere Salva.When done, select Save.

    Salvare i tag

  5. I tag vengono ora visualizzati nella panoramica.The tags are now displayed in the overview.

    Visualizzare i tag

  6. Per aggiungere o eliminare un tag, selezionare Modifica.To add or delete a tag, select change.

  7. Per eliminare un tag, selezionare l'icona Cestino.To delete a tag, select the trash icon. Selezionare quindi Salva.Then, select Save.

    Eliminare un tag

Per eseguire l'assegnazione in blocco dei tag a più risorse:To bulk assign tags to multiple resources:

  1. Da qualsiasi elenco di risorse selezionare la casella di controllo per le risorse a cui si vuole assegnare il tag.From any list of resources, select the checkbox for the resources you want to assign the tag. Selezionare quindi Assegna tag.Then, select Assign tags.

    Selezionare più risorse

  2. Aggiungere nomi e valori.Add names and values. Al termine scegliere Salva.When done, select Save.

    Selezionare Assegna

Per visualizzare tutte le risorse con un tag:To view all resources with a tag:

  1. Nel menu del portale di Azure cercare tag.On the Azure portal menu, search for tags. Selezionare il tag tra le opzioni disponibili.Select it from the available options.

    Ricerca in base al tag

  2. Selezionare il tag per la visualizzazione delle risorse.Select the tag for viewing resources.

    Selezionare il tag

  3. Vengono visualizzate tutte le risorse con tale tag.All resources with that tag are displayed.

    Visualizzare le risorse in base al tag

API RESTREST API

Per lavorare con i tag tramite l'API REST di Azure, usare:To work with tags through the Azure REST API, use:

Eredita TagInherit tags

I tag applicati al gruppo di risorse o alla sottoscrizione non vengono ereditati dalle risorse.Tags applied to the resource group or subscription aren't inherited by the resources. Per applicare tag da una sottoscrizione o un gruppo di risorse alle risorse, vedere criteri di Azure-Tag.To apply tags from a subscription or resource group to the resources, see Azure Policies - tags.

Tag e fatturazioneTags and billing

È possibile usare i tag per raggruppare i dati di fatturazione.You can use tags to group your billing data. Se, ad esempio, sono in esecuzione più macchine virtuali per organizzazioni diverse, usare i tag per raggrupparne l'uso in base al centro di costo.For example, if you're running multiple VMs for different organizations, use the tags to group usage by cost center. È anche possibile usare i tag per classificare i costi in base all'ambiente di runtime; ad esempio, l'uso di fatturazione per le macchine virtuali in esecuzione nell'ambiente di produzione.You can also use tags to categorize costs by runtime environment, such as the billing usage for VMs running in the production environment.

È possibile recuperare informazioni sui tag tramite le API di utilizzo delle risorse di Azure e delle schede tariffarie oppure il file con valori delimitati da virgole (CSV) di utilizzo.You can retrieve information about tags through the Azure Resource Usage and Rate Card APIs or the usage comma-separated values (CSV) file. Il file di utilizzo viene scaricato dal portale di Azure.You download the usage file from the Azure portal. Per altre informazioni, vedere Scaricare o visualizzare la fattura e i dati di uso giornalieri di Azure.For more information, see Download or view your Azure billing invoice and daily usage data. Quando si scarica il file d'uso dal Centro account di Azure, selezionare Versione 2.When downloading the usage file from the Azure Account Center, select Version 2. Per i servizi che supportano tag con fatturazione, i tag vengono visualizzati nella colonna Tag.For services that support tags with billing, the tags appear in the Tags column.

Per le operazioni API REST, vedere Riferimento API REST alla fatturazione di Azure.For REST API operations, see Azure Billing REST API Reference.

LimitazioniLimitations

Ai tag si applicano le limitazioni seguenti:The following limitations apply to tags:

  • Non tutti i tipi di risorse supportano i tag.Not all resource types support tags. Per determinare se è possibile applicare un tag a un tipo di risorsa, vedere Supporto dei tag per le risorse di Azure.To determine if you can apply a tag to a resource type, see Tag support for Azure resources.

  • Ogni risorsa, gruppo di risorse e sottoscrizione può avere un massimo di 50 coppie nome/valore di tag.Each resource, resource group, and subscription can have a maximum of 50 tag name/value pairs. Se è necessario applicare più tag rispetto al numero massimo consentito, usare una stringa JSON per il valore del tag.If you need to apply more tags than the maximum allowed number, use a JSON string for the tag value. La stringa JSON può contenere diversi valori applicati a un singolo nome di tag.The JSON string can contain many values that are applied to a single tag name. Un gruppo di risorse o una sottoscrizione può contenere molte risorse, ognuna delle quali ha 50 coppie nome/valore di tag.A resource group or subscription can contain many resources that each have 50 tag name/value pairs.

  • Il nome del tag è limitato a 512 caratteri e il valore del tag è limitato a 256 caratteri.The tag name is limited to 512 characters, and the tag value is limited to 256 characters. Per gli account di archiviazione, il nome del tag è limitato a 128 caratteri e il valore a 256 caratteri.For storage accounts, the tag name is limited to 128 characters, and the tag value is limited to 256 characters.

  • Non è possibile applicare tag alle risorse classiche, ad esempio Servizi cloud.Tags can't be applied to classic resources such as Cloud Services.

  • I nomi dei tag non possono contenere i caratteri seguenti: <, >, %, &, \, ?, /Tag names can't contain these characters: <, >, %, &, \, ?, /

    Nota

    Attualmente, le zone DNS di Azure e i servizi di gestione traffico non consentono l'uso di spazi nel tag.Currently, Azure DNS zones and Traffic Manager services also don't allow the use of spaces in the tag.

    La porta anteriore di Azure non supporta l'uso di # nel nome del tag.Azure Front Door doesn't support the use of # in the tag name.

    Automazione di Azure e la rete CDN di Azure supportano solo 15 tag sulle risorse.Azure Automation and Azure CDN only support 15 tags on resources.

Passaggi successiviNext steps