Używanie tagów do organizowania zasobów platformy Azure i hierarchii zarządzaniaUse tags to organize your Azure resources and management hierarchy

Możesz zastosować znaczniki do zasobów platformy Azure, grup zasobów i subskrypcji, aby logicznie zorganizować je w taksonomię.You apply tags to your Azure resources, resource groups, and subscriptions to logically organize them into a taxonomy. Każdy tag składa się z nazwy i pary wartości.Each tag consists of a name and a value pair. Na przykład można zastosować nazwę „Środowisko” i wartość „Produkcyjne” do wszystkich zasobów w środowisku produkcyjnym.For example, you can apply the name "Environment" and the value "Production" to all the resources in production.

Aby zapoznać się z zaleceniami dotyczącymi sposobu implementowania strategii tagowania, zobacz Przewodnik po nazewnictwu i znakowaniu zasobów.For recommendations on how to implement a tagging strategy, see Resource naming and tagging decision guide.

Ważne

W nazwach tagów nie jest rozróżniana wielkość liter w operacjach.Tag names are case-insensitive for operations. Tag o nazwie znacznika, niezależnie od wielkości liter, jest aktualizowany lub pobierany.A tag with a tag name, regardless of casing, is updated or retrieved. Jednak dostawca zasobów może zachować wielkość liter podaną dla nazwy tagu.However, the resource provider might keep the casing you provide for the tag name. Zostanie wyświetlona wielkość liter w raportach kosztów.You'll see that casing in cost reports.

W wartościach tagów jest rozróżniana wielkość liter.Tag values are case-sensitive.

Uwaga

W tym artykule przedstawiono instrukcje dotyczące usuwania danych osobowych z urządzenia lub usługi, co jest pomocne w wypełnianiu obowiązków wynikających z RODO.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. Jeśli szukasz ogólnych informacji na temat RODO, zobacz sekcję RODO w portalu zaufania usług.If you’re looking for general info about GDPR, see the GDPR section of the Service Trust portal.

Wymagany dostępRequired access

Aby zastosować Tagi do zasobu, musisz mieć dostęp do zapisu dla typu zasobu Microsoft. resources/Tags .To apply tags to a resource, you must have write access to the Microsoft.Resources/tags resource type. Rola współautor tagów umożliwia stosowanie tagów do jednostki bez uzyskiwania dostępu do samej jednostki.The Tag Contributor role lets you apply tags to an entity without having access to the entity itself. Obecnie rola współautor tagów nie może stosować tagów do zasobów lub grup zasobów za pomocą portalu.Currently, the tag contributor role can't apply tags to resources or resource groups through the portal. Można stosować Tagi do subskrypcji za pomocą portalu.It can apply tags to subscriptions through the portal. Obsługuje wszystkie operacje tagów za poorednictwem programu PowerShell i interfejsu API REST.It supports all tag operations through PowerShell and REST API.

Rola współautor przyznaje również wymagany dostęp do stosowania tagów do dowolnej jednostki.The Contributor role also grants the required access to apply tags to any entity. Aby zastosować Tagi tylko do jednego typu zasobu, należy użyć roli współautor dla tego zasobu.To apply tags to only one resource type, use the contributor role for that resource. Aby na przykład zastosować Tagi do maszyn wirtualnych, użyj współautora maszyny wirtualnej.For example, to apply tags to virtual machines, use the Virtual Machine Contributor.

Program PowerShellPowerShell

Zastosuj TagiApply tags

Azure PowerShell oferuje dwa polecenia do stosowania tagów- New-AzTag i Update-AzTag.Azure PowerShell offers two commands for applying tags - New-AzTag and Update-AzTag. Musisz mieć moduł AZ. resources 1.12.0 lub nowszy.You must have the Az.Resources module 1.12.0 or later. Możesz sprawdzić swoją wersję za pomocą programu Get-Module Az.Resources .You can check your version with Get-Module Az.Resources. Możesz zainstalować ten moduł lub zainstalować Azure PowerShell 3.6.1 lub nowszy.You can install that module or install Azure PowerShell 3.6.1 or later.

Polecenie New-AzTag zastępuje wszystkie Tagi dla zasobu, grupy zasobów lub subskrypcji.The New-AzTag replaces all tags on the resource, resource group, or subscription. Podczas wywoływania polecenia, należy przekazać identyfikator zasobu jednostki, którą chcesz oznaczyć.When calling the command, pass in the resource ID of the entity you wish to tag.

W poniższym przykładzie zastosowano zestaw tagów do konta magazynu: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

Po zakończeniu wykonywania polecenia należy zauważyć, że zasób ma dwa Tagi.When the command completes, notice that the resource has two tags.

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

Jeśli ponownie uruchomisz polecenie, ale tym razem z różnymi tagami, Zauważ, że wcześniejsze znaczniki są usuwane.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

Aby dodać tagi do zasobu, który ma już Tagi, użyj polecenie Update-AzTag.To add tags to a resource that already has tags, use Update-AzTag. Ustaw parametr -Operation do scalenia.Set the -Operation parameter to Merge.

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

Zwróć uwagę, że dwa nowe Tagi zostały dodane do dwóch istniejących tagów.Notice that the two new tags were added to the two existing tags.

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

Nazwy poszczególnych tagów mogą mieć tylko jedną wartość.Each tag name can have only one value. Jeśli podano nową wartość dla tagu, stara wartość zostanie zamieniona nawet w przypadku użycia operacji scalania.If you provide a new value for a tag, the old value is replaced even if you use the merge operation. Poniższy przykład zmienia tag stanu z normalny na zielony.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

Po ustawieniu parametru -Operation do zastępowaniaistniejące Tagi są zastępowane nowym zestawem tagów.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

Tylko nowe Tagi pozostają w zasobie.Only the new tags remain on the resource.

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

Te same polecenia działają również z grupami zasobów lub subskrypcjami.The same commands also work with resource groups or subscriptions. Identyfikator dla grupy zasobów lub subskrypcji, który ma zostać oznakowany, jest przekazywany.You pass in the identifier for the resource group or subscription you want to tag.

Aby dodać nowy zestaw tagów do grupy zasobów, użyj: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

Aby zaktualizować Tagi dla grupy zasobów, użyj: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

Aby dodać nowy zestaw tagów do subskrypcji, użyj: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

Aby zaktualizować Tagi dla subskrypcji, użyj: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

Może istnieć więcej niż jeden zasób o tej samej nazwie w grupie zasobów.You may have more than one resource with the same name in a resource group. W takim przypadku można ustawić każdy zasób przy użyciu następujących poleceń: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 }

Tworzenie listy tagówList tags

Aby uzyskać Tagi dla zasobu, grupy zasobów lub subskrypcji, użyj polecenia Get-AzTag i przekaż identyfikator zasobu dla jednostki.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.

Aby wyświetlić Tagi dla zasobu, użyj:To see the tags for a resource, use:

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

Aby wyświetlić Tagi dla grupy zasobów, użyj:To see the tags for a resource group, use:

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

Aby wyświetlić Tagi dla subskrypcji, użyj:To see the tags for a subscription, use:

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

Lista według taguList by tag

Aby uzyskać zasoby z określoną nazwą i wartością tagu, użyj:To get resources that have a specific tag name and value, use:

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

Aby uzyskać zasoby z określoną nazwą tagu z dowolną wartością tagu, użyj:To get resources that have a specific tag name with any tag value, use:

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

Aby uzyskać grupy zasobów z określoną nazwą i wartością tagu, użyj:To get resource groups that have a specific tag name and value, use:

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

Usuń TagiRemove tags

Aby usunąć określone Tagi, użyj opcji Update-AzTag i Set -Operation do usunięcia.To remove specific tags, use Update-AzTag and set -Operation to Delete. Przekaż Tagi, które chcesz usunąć.Pass in the tags you want to delete.

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

Określone Tagi są usuwane.The specified tags are removed.

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

Aby usunąć wszystkie Tagi, użyj polecenia Remove-AzTag .To remove all tags, use the Remove-AzTag command.

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

Interfejs wiersza polecenia platformy AzureAzure CLI

Zastosuj TagiApply tags

Dodając Tagi do grupy zasobów lub zasobu, można zastąpić istniejące Tagi lub dołączyć nowe tagi do istniejących tagów.When adding tags to a resource group or resource, you can either overwrite the existing tags or append new tags to existing tags.

Aby zastąpić Tagi w zasobie, użyj:To overwrite the tags on a resource, use:

az resource tag --tags 'Dept=IT' 'Environment=Test' -g examplegroup -n examplevnet --resource-type "Microsoft.Network/virtualNetworks"

Aby dołączyć tag do istniejących tagów w zasobie, użyj:To append a tag to the existing tags on a resource, use:

az resource update --set tags.'Status'='Approved' -g examplegroup -n examplevnet --resource-type "Microsoft.Network/virtualNetworks"

Aby zastąpić istniejące Tagi w grupie zasobów, użyj:To overwrite the existing tags on a resource group, use:

az group update -n examplegroup --tags 'Environment=Test' 'Dept=IT'

Aby dołączyć tag do istniejących tagów w grupie zasobów, użyj:To append a tag to the existing tags on a resource group, use:

az group update -n examplegroup --set tags.'Status'='Approved'

Obecnie w interfejsie wiersza polecenia platformy Azure nie jest dostępne polecenie do stosowania tagów do subskrypcji.Currently, Azure CLI doesn't have a command for applying tags to subscriptions. Można jednak użyć interfejsu wiersza polecenia, aby wdrożyć szablon ARM, który stosuje Tagi do subskrypcji.However, you can use CLI to deploy an ARM template that applies the tags to a subscription. Zobacz stosowanie tagów do grup zasobów lub subskrypcji.See Apply tags to resource groups or subscriptions.

Tworzenie listy tagówList tags

Aby wyświetlić istniejące Tagi dla zasobu, użyj:To see the existing tags for a resource, use:

az resource show -n examplevnet -g examplegroup --resource-type "Microsoft.Network/virtualNetworks" --query tags

Aby wyświetlić istniejące tagi dla grupy zasobów, użyj:To see the existing tags for a resource group, use:

az group show -n examplegroup --query tags

Ten skrypt zwraca następujący format:That script returns the following format:

{
  "Dept"        : "IT",
  "Environment" : "Test"
}

Lista według taguList by tag

Aby uzyskać wszystkie zasoby, które mają określony tag i wartość, użyj az resource list :To get all the resources that have a particular tag and value, use az resource list:

az resource list --tag Dept=Finance

Aby uzyskać grupy zasobów, które mają określony tag, użyj az group list :To get resource groups that have a specific tag, use az group list:

az group list --tag Dept=IT

Obsługa spacjiHandling spaces

Jeśli nazwy tagów lub wartości zawierają spacje, należy wykonać kilka dodatkowych kroków.If your tag names or values include spaces, you must take a couple extra steps.

--tagsParametry w interfejsie wiersza polecenia platformy Azure mogą akceptować ciąg, który składa się z tablicy ciągów.The --tags parameters in the Azure CLI can accept a string that consists of an array of strings. Poniższy przykład zastępuje znaczniki w grupie zasobów, w której Tagi zawierają spacje i łącznik:The following example overwrites the tags in a resource group where the tags have spaces and hyphen:

TAGS=("Cost Center=Finance-1222" "Location=West US")
az group update --name examplegroup --tags "${TAGS[@]}"

Możesz użyć tej samej składni podczas tworzenia lub aktualizowania grupy zasobów lub zasobów przy użyciu --tags parametru.You can use the same syntax when you create or update a resource group or resources by using the --tags parameter.

Aby zaktualizować Tagi przy użyciu --set parametru, należy przekazać klucz i wartość jako ciąg.To update the tags by using the --set parameter, you must pass the key and value as a string. Poniższy przykład dołącza jeden tag do grupy zasobów:The following example appends a single tag to a resource group:

TAG="Cost Center='Account-56'"
az group update --name examplegroup --set tags."$TAG"

W tym przypadku wartość tagu jest oznaczona pojedynczymi cudzysłowami, ponieważ wartość ma łącznik.In the this case, the tag value is marked with single quotes because the value has a hyphen.

Może być również konieczne zastosowanie tagów do wielu zasobów.You might also need to apply tags to many resources. Poniższy przykład stosuje wszystkie Tagi z grupy zasobów do jej zasobów, gdy Tagi mogą zawierać spacje:The following example applies all tags from a resource group to its resources when the tags might contain spaces:

jsontags=$(az group show --name examplegroup --query tags -o json)
tags=$(echo $jsontags | tr -d '{}"' | sed 's/: /=/g' | sed "s/\"/'/g" | sed 's/, /,/g' | sed 's/ *$//g' | sed 's/^ *//g')
origIFS=$IFS
IFS=','
read -a tagarr <<< "$tags"
resourceids=$(az resource list -g examplegroup --query [].id --output tsv)
for id in $resourceids
do
  az resource tag --tags "${tagarr[@]}" --id $id
done
IFS=$origIFS

SzablonyTemplates

Podczas wdrażania za pomocą szablonu Menedżer zasobów można oznaczać zasoby, grupy zasobów i subskrypcje.You can tag resources, resource groups, and subscriptions during deployment with a Resource Manager template.

Zastosuj wartościApply values

Poniższy przykład wdraża konto magazynu z trzema tagami.The following example deploys a storage account with three tags. Dwa Tagi ( Dept i Environment ) są ustawione na wartości literału.Two of the tags (Dept and Environment) are set to literal values. Jeden tag ( LastDeployed ) jest ustawiony na parametr, który jest wartością domyślną bieżącej daty.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": {}
        }
    ]
}

Zastosuj obiektApply an object

Możesz zdefiniować parametr obiektu przechowującego kilka tagów i zastosować ten obiekt do elementu tagu.You can define an object parameter that stores several tags, and apply that object to the tag element. Takie podejście zapewnia większą elastyczność niż w poprzednim przykładzie, ponieważ obiekt może mieć różne właściwości.This approach provides more flexibility than the previous example because the object can have different properties. Każda właściwość obiektu będzie osobnym tagiem dla zasobu.Each property in the object becomes a separate tag for the resource. Poniższy przykład zawiera parametr o nazwie tagValues, który został zastosowany do elementu tagu.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": {}
        }
    ]
}

Zastosuj ciąg JSONApply a JSON string

Aby przechowywać wiele wartości w jednym tagu, zastosuj ciąg JSON reprezentujący te wartości.To store many values in a single tag, apply a JSON string that represents the values. Cały ciąg JSON jest przechowywany jako jeden tag, który nie może zawierać więcej niż 256 znaków.The entire JSON string is stored as one tag that can't exceed 256 characters. Poniższy przykład zawiera pojedynczy tag o nazwie CostCenter, który zawiera kilka wartości z ciągu 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": {}
        }
    ]
}

Zastosuj Tagi z grupy zasobówApply tags from resource group

Aby zastosować Tagi z grupy zasobów do zasobu, użyj funkcji resourceing () .To apply tags from a resource group to a resource, use the resourceGroup() function. Podczas pobierania wartości tagu Użyj tags[tag-name] składni zamiast tags.tag-name składni, ponieważ niektóre znaki nie są prawidłowo analizowane w notacji kropkowej.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": {}
        }
    ]
}

Stosowanie tagów do grup zasobów lub subskrypcjiApply tags to resource groups or subscriptions

Możesz dodać tagi do grupy zasobów lub subskrypcji, wdrażając typ zasobu Microsoft. resources/Tags .You can add tags to a resource group or subscription by deploying the Microsoft.Resources/tags resource type. Tagi są stosowane do docelowej grupy zasobów lub subskrypcji dla wdrożenia.The tags are applied to the target resource group or subscription for the deployment. Za każdym razem, gdy wdrażasz szablon, wszystkie znaczniki, które zostały wcześniej zastosowane, zostały zastąpione.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')]"
                }
            }
        }
    ]
}

Aby zastosować Tagi do grupy zasobów, użyj programu PowerShell lub interfejsu wiersza polecenia platformy Azure.To apply the tags to a resource group, use either PowerShell or Azure CLI. Wdróż w grupie zasobów, do której chcesz oznaczyć tag.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

Aby zastosować Tagi do subskrypcji, użyj programu PowerShell lub interfejsu wiersza polecenia platformy Azure.To apply the tags to a subscription, use either PowerShell or Azure CLI. Wdróż w subskrypcji, która ma być tagiem.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

Aby uzyskać więcej informacji na temat wdrożeń subskrypcji, zobacz Tworzenie grup zasobów i zasobów na poziomie subskrypcji.For more information about subscription deployments, see Create resource groups and resources at the subscription level.

Poniższy szablon dodaje Tagi z obiektu do grupy zasobów lub subskrypcji.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')]"
            }
        }
    ]
}

PortalPortal

Jeśli użytkownik nie ma wymaganego dostępu do stosowania tagów, można przypisać rolę współautor tagu do użytkownika.If a user doesn't have the required access for applying tags, you can assign the Tag Contributor role to the user. Aby uzyskać więcej informacji, zobacz Samouczek: udzielanie użytkownikom dostępu do zasobów platformy Azure przy użyciu RBAC i Azure Portal.For more information, see Tutorial: Grant a user access to Azure resources using RBAC and the Azure portal.

  1. Aby wyświetlić Tagi dla zasobu lub grupy zasobów, poszukaj istniejących tagów w przeglądzie.To view the tags for a resource or a resource group, look for existing tags in the overview. Jeśli wcześniej nie zastosowano tagów, lista będzie pusta.If you have not previously applied tags, the list is empty.

    Wyświetl Tagi dla zasobu lub grupy zasobów

  2. Aby dodać tag, wybierz pozycję kliknij tutaj, aby dodać tagi.To add a tag, select Click here to add tags.

  3. Podaj nazwę i wartość.Provide a name and value.

    Dodawanie tagu

  4. Kontynuuj dodawanie tagów zgodnie z wymaganiami.Continue adding tags as needed. Po zakończeniu wybierz pozycję Zapisz.When done, select Save.

    Zapisz Tagi

  5. Tagi są teraz wyświetlane w przeglądzie.The tags are now displayed in the overview.

    Pokaż Tagi

  6. Aby dodać lub usunąć tag, wybierz pozycję Zmień.To add or delete a tag, select change.

  7. Aby usunąć tag, wybierz ikonę kosza.To delete a tag, select the trash icon. Następnie wybierz pozycję Zapisz.Then, select Save.

    Usuń tag

Aby zbiorczo przypisać Tagi do wielu zasobów:To bulk assign tags to multiple resources:

  1. Z dowolnej listy zasobów zaznacz pole wyboru dla zasobów, dla których chcesz przypisać tag.From any list of resources, select the checkbox for the resources you want to assign the tag. Następnie wybierz pozycję Przypisz Tagi.Then, select Assign tags.

    Wybierz wiele zasobów

  2. Dodaj nazwy i wartości.Add names and values. Po zakończeniu wybierz pozycję Zapisz.When done, select Save.

    Wybierz pozycję Przypisz

Aby wyświetlić wszystkie zasoby ze znacznikiem:To view all resources with a tag:

  1. W menu Azure Portal Wyszukaj Tagi.On the Azure portal menu, search for tags. Wybierz ją z dostępnych opcji.Select it from the available options.

    Znajdź przez tag

  2. Wybierz tag do wyświetlania zasobów.Select the tag for viewing resources.

    Wybierz tag

  3. Wyświetlane są wszystkie zasoby z tym tagiem.All resources with that tag are displayed.

    Wyświetl zasoby według tagu

Interfejs API RESTREST API

Aby móc korzystać z tagów za pomocą interfejsu API REST platformy Azure, użyj:To work with tags through the Azure REST API, use:

Dziedzicz TagiInherit tags

Tagi zastosowane do grupy zasobów lub subskrypcji nie są dziedziczone przez zasoby.Tags applied to the resource group or subscription aren't inherited by the resources. Aby zastosować do zasobów Tagi z subskrypcji lub grupy zasobów, zobacz temat Zasady platformy Azure — Tagi.To apply tags from a subscription or resource group to the resources, see Azure Policies - tags.

Znaczniki i rozliczanieTags and billing

Tagów można użyć do grupowania danych dotyczących rozliczeń.You can use tags to group your billing data. Na przykład jeśli jest uruchomionych wiele maszyn wirtualnych różnych organizacji, możesz użyć tagów do grupowania użycia według centrum kosztu.For example, if you're running multiple VMs for different organizations, use the tags to group usage by cost center. Tagi umożliwiają również kategoryzowanie kosztów według środowiska uruchomieniowego, na przykład na potrzeby rozliczania użycia maszyn uruchomionych w środowisku produkcyjnym.You can also use tags to categorize costs by runtime environment, such as the billing usage for VMs running in the production environment.

Informacje o tagach można uzyskać za pomocą interfejsów API kart użycia zasobów platformy Azure i karty rate lub pliku z wartościami rozdzielanymi przecinkami (CSV).You can retrieve information about tags through the Azure Resource Usage and Rate Card APIs or the usage comma-separated values (CSV) file. Plik użycia można pobrać z Azure Portal.You download the usage file from the Azure portal. Aby uzyskać więcej informacji, zobacz pobieranie lub wyświetlanie faktury rozliczeń na platformie Azure oraz danych dziennego użycia.For more information, see Download or view your Azure billing invoice and daily usage data. Podczas pobierania pliku użycia z Centrum konta platformy Azure wybierz pozycję wersja 2.When downloading the usage file from the Azure Account Center, select Version 2. W przypadku usług, które obsługują Tagi z rozliczeniami, Tagi są wyświetlane w kolumnie Tagi .For services that support tags with billing, the tags appear in the Tags column.

Aby uzyskać informacje na temat operacji interfejsu API REST, zobacz Dokumentacja interfejsu API REST rozliczeń platformy Azure.For REST API operations, see Azure Billing REST API Reference.

OgraniczeniaLimitations

Tagi mają następujące ograniczenia:The following limitations apply to tags:

  • Nie wszystkie typy zasobów obsługują Tagi.Not all resource types support tags. Aby określić, czy można zastosować tag do typu zasobu, zobacz obsługa tagów dla zasobów platformy Azure.To determine if you can apply a tag to a resource type, see Tag support for Azure resources.

  • Dla każdego zasobu, grupy zasobów i subskrypcji może być maksymalnie 50 par nazwa/wartość tagu.Each resource, resource group, and subscription can have a maximum of 50 tag name/value pairs. Jeśli musisz zastosować więcej tagów niż maksymalna dozwolona liczba, użyj ciągu JSON dla wartości tagu.If you need to apply more tags than the maximum allowed number, use a JSON string for the tag value. Ciąg JSON może zawierać wiele wartości, które są stosowane do jednej nazwy tagu.The JSON string can contain many values that are applied to a single tag name. Grupa zasobów lub subskrypcja może zawierać wiele zasobów, dla których każda z nich ma 50 par nazwa/wartość.A resource group or subscription can contain many resources that each have 50 tag name/value pairs.

  • Nazwa tagu może zawierać maksymalnie 512 znaków, a wartość tagu jest ograniczona do 256 znaków.The tag name is limited to 512 characters, and the tag value is limited to 256 characters. W przypadku kont magazynu nazwa tagu jest ograniczona do 128 znaków, a wartość tagu jest ograniczona do 256 znaków.For storage accounts, the tag name is limited to 128 characters, and the tag value is limited to 256 characters.

  • Nie można zastosować tagów do zasobów klasycznych, takich jak Cloud Services.Tags can't be applied to classic resources such as Cloud Services.

  • Nazwy tagów nie mogą zawierać następujących znaków:,,,,, < > % & \ ? , /Tag names can't contain these characters: <, >, %, &, \, ?, /

    Uwaga

    Obecnie strefy Azure DNS i usługi Traffic Manager również nie zezwalają na używanie spacji w tagu.Currently, Azure DNS zones and Traffic Manager services also don't allow the use of spaces in the tag.

    Drzwi frontonu platformy Azure nie obsługują używania # w nazwie tagu.Azure Front Door doesn't support the use of # in the tag name.

    Azure Automation i Azure CDN obsługują tylko 15 tagów w zasobach.Azure Automation and Azure CDN only support 15 tags on resources.

Następne krokiNext steps