Использование тегов для Организации ресурсов Azure и иерархии управленияUse tags to organize your Azure resources and management hierarchy

Вы примените теги к ресурсам, группам ресурсов и подпискам Azure, чтобы логически упорядочить их в таксономии.You apply tags to your Azure resources, resource groups, and subscriptions to logically organize them into a taxonomy. Каждый тег состоит из пары "имя — значение".Each tag consists of a name and a value pair. Например, имя Environment и значение Production можно применить ко всем ресурсам в рабочей среде.For example, you can apply the name "Environment" and the value "Production" to all the resources in production.

Рекомендации по реализации стратегии тегов см. в разделе руководство по именованию ресурсов и созданию тегов.For recommendations on how to implement a tagging strategy, see Resource naming and tagging decision guide.

Важно!

В именах тегов не учитывается регистр для операций.Tag names are case-insensitive for operations. Обновляется или извлекается тег с именем тега, независимо от регистра.A tag with a tag name, regardless of casing, is updated or retrieved. Однако поставщик ресурсов может оставить регистр, который вы задаюте для имени тега.However, the resource provider might keep the casing you provide for the tag name. Вы увидите этот регистр в отчетах о затратах.You'll see that casing in cost reports.

В значениях тегов учитывается регистр.Tag values are case-sensitive.

Примечание

В этой статье приведены пошаговые инструкции по удалению персональных данных с устройства или из службы. Эти сведения можно использовать для соблюдения обязательств согласно Общему регламенту по защите данных (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. Если вы ищете общие сведения о GDPR, см. раздел о GDPR на Service Trust Portal.If you’re looking for general info about GDPR, see the GDPR section of the Service Trust portal.

Требуемый доступRequired access

Чтобы применить теги к ресурсу, необходимо иметь доступ на запись к типу ресурса Microsoft. Resources/Tags .To apply tags to a resource, you must have write access to the Microsoft.Resources/tags resource type. Роль « участник тегов » позволяет применять теги к сущности без доступа к самой сущности.The Tag Contributor role lets you apply tags to an entity without having access to the entity itself. В настоящее время роль участника тега не может применять теги к ресурсам или группам ресурсов на портале.Currently, the tag contributor role can't apply tags to resources or resource groups through the portal. Он может применять теги к подпискам на портале.It can apply tags to subscriptions through the portal. Она поддерживает все операции с тегами с помощью PowerShell и REST API.It supports all tag operations through PowerShell and REST API.

Роль участника также предоставляет необходимый доступ для применения тегов к любой сущности.The Contributor role also grants the required access to apply tags to any entity. Чтобы применить теги только к одному типу ресурсов, используйте роль участника для этого ресурса.To apply tags to only one resource type, use the contributor role for that resource. Например, чтобы применить теги к виртуальным машинам, используйте Участник виртуальных машин.For example, to apply tags to virtual machines, use the Virtual Machine Contributor.

PowerShellPowerShell

Применить ТегиApply tags

Azure PowerShell предлагает две команды для применения тегов- New-азтаг и Update-азтаг.Azure PowerShell offers two commands for applying tags - New-AzTag and Update-AzTag. Необходимо иметь модуль AZ. Resources 1.12.0 или более поздней версии.You must have the Az.Resources module 1.12.0 or later. Версию можно проверить с помощью Get-Module Az.Resources .You can check your version with Get-Module Az.Resources. Вы можете установить этот модуль или установить Azure PowerShell 3.6.1 или более поздней версии.You can install that module or install Azure PowerShell 3.6.1 or later.

New-азтаг заменяет все теги в ресурсе, группе ресурсов или подписке.The New-AzTag replaces all tags on the resource, resource group, or subscription. При вызове команды передайте идентификатор ресурса сущности, которую вы хотите пометить.When calling the command, pass in the resource ID of the entity you wish to tag.

В следующем примере набор тегов применяется к учетной записи хранения.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

После выполнения команды Обратите внимание, что ресурс имеет два тега.When the command completes, notice that the resource has two tags.

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

Если выполнить команду еще раз, но на этот раз с другими тегами, обратите внимание, что предыдущие Теги удалены.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

Чтобы добавить теги к ресурсу, который уже содержит теги, используйте Update-азтаг.To add tags to a resource that already has tags, use Update-AzTag. Задайте для параметра -Operation значение Merge.Set the -Operation parameter to Merge.

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

Обратите внимание, что два новых тега были добавлены к двум существующим тегам.Notice that the two new tags were added to the two existing tags.

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

Каждое имя тега может иметь только одно значение.Each tag name can have only one value. Если указать новое значение для тега, старое значение будет заменено даже при использовании операции MERGE.If you provide a new value for a tag, the old value is replaced even if you use the merge operation. В следующем примере тег Status изменяется с нормального на зеленый.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

Если для параметра -Operation задано значение Replace, существующие теги заменяются новым набором тегов.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

В ресурсе остаются только новые теги.Only the new tags remain on the resource.

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

Одни и те же команды также работают с группами ресурсов или подписками.The same commands also work with resource groups or subscriptions. Вы передаете идентификатор для группы ресурсов или подписки, которые необходимо пометить.You pass in the identifier for the resource group or subscription you want to tag.

Чтобы добавить новый набор тегов в группу ресурсов, используйте: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

Чтобы обновить теги для группы ресурсов, используйте: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

Чтобы добавить новый набор тегов к подписке, используйте: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

Чтобы обновить теги для подписки, используйте: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

В группе ресурсов может быть несколько ресурсов с одним и тем же именем.You may have more than one resource with the same name in a resource group. В этом случае можно задать каждый ресурс с помощью следующих команд: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 }

Вывод списка теговList tags

Чтобы получить теги для ресурса, группы ресурсов или подписки, используйте команду Get-азтаг и передайте идентификатор ресурса для сущности.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.

Чтобы просмотреть теги для ресурса, используйте:To see the tags for a resource, use:

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

Чтобы просмотреть теги для группы ресурсов, используйте:To see the tags for a resource group, use:

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

Чтобы просмотреть теги для подписки, используйте:To see the tags for a subscription, use:

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

Список по тегуList by tag

Чтобы получить ресурсы с указанными именем и значением тега, используйте:To get resources that have a specific tag name and value, use:

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

Чтобы получить ресурсы с заданным именем тега и любым значением тега, используйте:To get resources that have a specific tag name with any tag value, use:

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

Чтобы получить группы ресурсов с указанными именем и значением тега, используйте:To get resource groups that have a specific tag name and value, use:

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

Удалить тегиRemove tags

Чтобы удалить определенные теги, используйте Update-азтаг и Set -Operation для удаления.To remove specific tags, use Update-AzTag and set -Operation to Delete. Передайте теги, которые нужно удалить.Pass in the tags you want to delete.

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

Указанные теги удаляются.The specified tags are removed.

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

Чтобы удалить все теги, используйте команду Remove-азтаг .To remove all tags, use the Remove-AzTag command.

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

Azure CLIAzure CLI

Применить ТегиApply tags

При добавлении тегов в группу ресурсов или ресурс можно либо перезаписать существующие теги, либо добавить новые теги в существующие теги.When adding tags to a resource group or resource, you can either overwrite the existing tags or append new tags to existing tags.

Чтобы перезаписать теги для ресурса, используйте: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"

Чтобы добавить тег к существующим тегам для ресурса, используйте: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"

Чтобы перезаписать существующие теги в группе ресурсов, используйте:To overwrite the existing tags on a resource group, use:

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

Чтобы добавить тег к существующим тегам в группе ресурсов, используйте:To append a tag to the existing tags on a resource group, use:

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

В настоящее время Azure CLI не имеет команды для применения тегов к подпискам.Currently, Azure CLI doesn't have a command for applying tags to subscriptions. Однако можно использовать интерфейс командной строки для развертывания шаблона ARM, который применяет теги к подписке.However, you can use CLI to deploy an ARM template that applies the tags to a subscription. См. раздел применение тегов к группам ресурсов или подпискам.See Apply tags to resource groups or subscriptions.

Вывод списка теговList tags

Чтобы просмотреть существующие теги для ресурса, используйте:To see the existing tags for a resource, use:

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

Чтобы просмотреть существующие теги для группы ресурсов, используйте этот командлет:To see the existing tags for a resource group, use:

az group show -n examplegroup --query tags

Этот скрипт вернет ответ в следующем формате:That script returns the following format:

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

Список по тегуList by tag

Чтобы получить все ресурсы с определенным тегом и значением, используйте команду 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

Чтобы получить группы ресурсов с определенным тегом, используйте команду az group list:To get resource groups that have a specific tag, use az group list:

az group list --tag Dept=IT

Обработка пробеловHandling spaces

Если имена или значения тегов содержат пробелы, необходимо выполнить несколько дополнительных действий.If your tag names or values include spaces, you must take a couple of extra steps. В следующем примере все теги из группы ресурсов применяются к его ресурсам, если теги могут содержать пробелы.The following example applies all tags from a resource group to its resources when the tags may 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

ШаблоныTemplates

Вы можете помечать ресурсы, группы ресурсов и подписки во время развертывания с помощью шаблона диспетчер ресурсов.You can tag resources, resource groups, and subscriptions during deployment with a Resource Manager template.

Применить значенияApply values

В следующем примере выполняется развертывание учетной записи хранения с тремя тегами.The following example deploys a storage account with three tags. Два тега ( Dept и Environment ) задаются как литеральные значения.Two of the tags (Dept and Environment) are set to literal values. Для одного тега ( LastDeployed ) задан параметр, который по умолчанию имеет текущую дату.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": {}
        }
    ]
}

Применение объектаApply an object

Можно определить параметр объекта, который хранит несколько тегов, и применить этот объект к элементу тега.You can define an object parameter that stores several tags, and apply that object to the tag element. Такой подход обеспечивает большую гибкость, чем предыдущий пример, поскольку объект может иметь различные свойства.This approach provides more flexibility than the previous example because the object can have different properties. Каждое свойство в объекте становится отдельным тегом ресурса.Each property in the object becomes a separate tag for the resource. В следующем примере содержится параметр с именем tagValues, который применяется к элементу тега.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": {}
        }
    ]
}

Применение строки JSONApply a JSON string

Для хранения большого количества значений в одном теге примените строку JSON, представляющую значения.To store many values in a single tag, apply a JSON string that represents the values. Вся строка JSON хранится в виде одного тега, длина которого не должна превышать 256 символов.The entire JSON string is stored as one tag that can't exceed 256 characters. В следующем примере приведен один тег с именем CostCenter, содержащий несколько значений из строки 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": {}
        }
    ]
}

Применение тегов из группы ресурсовApply tags from resource group

Чтобы применить теги из группы ресурсов к ресурсу, используйте функцию resourceGroup () .To apply tags from a resource group to a resource, use the resourceGroup() function. При получении значения тега используйте tags[tag-name] синтаксис вместо tags.tag-name синтаксиса, так как некоторые символы не анализируются правильно в точечной нотации.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": {}
        }
    ]
}

Применение тегов к группам ресурсов или подпискамApply tags to resource groups or subscriptions

Вы можете добавить теги в группу ресурсов или подписку, развернув тип ресурса Microsoft. Resources/Tags .You can add tags to a resource group or subscription by deploying the Microsoft.Resources/tags resource type. Теги применяются к целевой группе ресурсов или подписке для развертывания.The tags are applied to the target resource group or subscription for the deployment. Каждый раз при развертывании шаблона заменяются все теги, которые были ранее применены.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')]"
                }
            }
        }
    ]
}

Чтобы применить теги к группе ресурсов, используйте либо PowerShell, либо Azure CLI.To apply the tags to a resource group, use either PowerShell or Azure CLI. Разверните в группе ресурсов, которую необходимо пометить.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

Чтобы применить теги к подписке, используйте либо PowerShell, либо Azure CLI.To apply the tags to a subscription, use either PowerShell or Azure CLI. Выполните развертывание в подписке, которую нужно пометить.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

Дополнительные сведения о развертывании подписок см. в статье Создание групп ресурсов и ресурсов на уровне подписки.For more information about subscription deployments, see Create resource groups and resources at the subscription level.

Следующий шаблон добавляет теги из объекта в группу ресурсов или подписку.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')]"
            }
        }
    ]
}

ПорталPortal

Если у пользователя нет необходимого доступа к применению тегов, можно назначить пользователю роль « участник тега ».If a user doesn't have the required access for applying tags, you can assign the Tag Contributor role to the user. Дополнительные сведения см. в разделе Учебник. предоставление пользователю доступа к ресурсам Azure с помощью RBAC и портал Azure.For more information, see Tutorial: Grant a user access to Azure resources using RBAC and the Azure portal.

  1. Чтобы просмотреть теги для ресурса или группы ресурсов, найдите существующие теги в разделе Обзор.To view the tags for a resource or a resource group, look for existing tags in the overview. Если теги ранее не применялись, то список будет пустым.If you have not previously applied tags, the list is empty.

    Просмотр тегов для ресурса или группы ресурсов

  2. Чтобы добавить тег, выберите Click here to add tags (Щелкните здесь, чтобы добавить теги).To add a tag, select Click here to add tags.

  3. Укажите имя и значение.Provide a name and value.

    Добавление тега

  4. При необходимости продолжайте добавлять теги.Continue adding tags as needed. Затем нажмите кнопку Сохранить.When done, select Save.

    Сохранение тегов

  5. Теперь теги отображаются в обзоре.The tags are now displayed in the overview.

    Отображение тегов

  6. Чтобы добавить или удалить тег, выберите Изменить.To add or delete a tag, select change.

  7. Чтобы удалить тег, щелкните значок корзины.To delete a tag, select the trash icon. Затем нажмите кнопку Сохранить.Then, select Save.

    Удаление тега

Вот как можно выполнить пакетное назначение тегов нескольким ресурсам.To bulk assign tags to multiple resources:

  1. В любом списке ресурсов установите флажки для ресурсов, которым требуется назначить тег.From any list of resources, select the checkbox for the resources you want to assign the tag. Затем выберите назначить Теги.Then, select Assign tags.

    Выбор нескольких ресурсов

  2. Добавьте имена и значения.Add names and values. Затем нажмите кнопку Сохранить.When done, select Save.

    Выбор элемента "Назначить"

Чтобы просмотреть все ресурсы с тегом, сделайте следующее.To view all resources with a tag:

  1. В меню портал Azure выполните поиск тегов.On the Azure portal menu, search for tags. Выберите его из доступных параметров.Select it from the available options.

    Поиск по тегу

  2. Выберите тег для просмотра ресурсов.Select the tag for viewing resources.

    Выбор тега

  3. Будут отображены все ресурсы с этим тегом.All resources with that tag are displayed.

    Просмотр ресурсов по тегу

REST APIREST API

Для работы с тегами с помощью REST API Azure используйте:To work with tags through the Azure REST API, use:

Наследование теговInherit tags

Теги, применяемые к группе ресурсов или подписке, не наследуются ресурсами.Tags applied to the resource group or subscription aren't inherited by the resources. Чтобы применить теги из подписки или группы ресурсов к ресурсам, см. раздел политики Azure — Теги.To apply tags from a subscription or resource group to the resources, see Azure Policies - tags.

Теги и выставление счетовTags and billing

С помощью тегов можно группировать данные о выставлении счетов.You can use tags to group your billing data. Например, если у вас работает несколько виртуальных машин для разных организаций, то с помощью тегов можно группировать сведения об использовании по месту возникновения затрат.For example, if you're running multiple VMs for different organizations, use the tags to group usage by cost center. Кроме того, теги можно использовать для группирования затрат по среде выполнения (например, сведения о выставленных счетах за виртуальные машины, запущенные в рабочей среде).You can also use tags to categorize costs by runtime environment, such as the billing usage for VMs running in the production environment.

Сведения о тегах можно получить с помощью API-интерфейсов использования ресурсов Azure и платной карты , а также файла данных, разделенных запятыми (CSV).You can retrieve information about tags through the Azure Resource Usage and Rate Card APIs or the usage comma-separated values (CSV) file. Этот файл можно скачать в Центре управления учетной записью Azure или на портале Azure.You download the usage file from the Azure Account Center or Azure portal. Дополнительные сведения см. в статье Скачивание или просмотр счета на оплату и данных о ежедневном использовании в Azure.For more information, see Download or view your Azure billing invoice and daily usage data. При скачивании файла сведений об использовании из Центра управления учетной записью Azure выберите Версия 2.When downloading the usage file from the Azure Account Center, select Version 2. Для служб, поддерживающих теги выставления счетов, эти теги отображаются в столбце Теги.For services that support tags with billing, the tags appear in the Tags column.

Подробнее об операциях REST API см. в справочнике по REST API для выставления счетов Azure.For REST API operations, see Azure Billing REST API Reference.

ОграниченияLimitations

Действительны следующие ограничения для тегов.The following limitations apply to tags:

  • Не все типы ресурсов поддерживают теги.Not all resource types support tags. Сведения о возможности применения тегов к типу ресурса см. в статье о поддержке тегов ресурсами Azure.To determine if you can apply a tag to a resource type, see Tag support for Azure resources.

  • Каждый ресурс, Группа ресурсов и подписка могут иметь не более 50 пар "имя-значение" для тегов.Each resource, resource group, and subscription can have a maximum of 50 tag name/value pairs. Если необходимо применить больше тегов, чем максимально допустимое число, используйте строку JSON для значения тега.If you need to apply more tags than the maximum allowed number, use a JSON string for the tag value. Строка JSON может содержать много значений, применяемых к одному имени тега.The JSON string can contain many values that are applied to a single tag name. Группа ресурсов или подписка может содержать множество ресурсов, каждая из которых содержит 50 пар "имя-значение" для тегов.A resource group or subscription can contain many resources that each have 50 tag name/value pairs.

  • Имя тега ограничено 512 символами, а значение тега — 256 символами.The tag name is limited to 512 characters, and the tag value is limited to 256 characters. Для учетных записей хранения имя тега ограничено 128 символами, а значение тега — 256 символами.For storage accounts, the tag name is limited to 128 characters, and the tag value is limited to 256 characters.

  • Теги нельзя применять к классическим ресурсам, например к облачным службам Microsoft Azure.Tags can't be applied to classic resources such as Cloud Services.

  • Имена тегов не могут содержать следующие символы: <, >, %, &, \, ?, /Tag names can't contain these characters: <, >, %, &, \, ?, /

    Примечание

    В настоящее время зоны Azure DNS и службы диспетчера трафика также не разрешают использовать пробелы в теге.Currently, Azure DNS zones and Traffic Manager services also don't allow the use of spaces in the tag.

    Передняя дверца Azure не поддерживает использование # в имени тега.Azure Front Door doesn't support the use of # in the tag name.

    Служба автоматизации Azure и Azure CDN поддерживают только 15 тегов для ресурсов.Azure Automation and Azure CDN only support 15 tags on resources.

Дальнейшие действияNext steps