Использование тегов для Организации ресурсов 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 about 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.For general information about GDPR, see the GDPR section of the Microsoft Trust Center and the GDPR section of the Service Trust portal.

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

Есть два способа получить необходимый доступ к ресурсам тегов.There are two ways to get the required access to tag resources.

  • Вы можете иметь доступ на запись к типу ресурса Microsoft. Resources/Tags .You can have write access to the Microsoft.Resources/tags resource type. Этот доступ позволяет пометить любой ресурс, даже если у вас нет доступа к самому ресурсу.This access lets you tag any resource, even if you don't have access to the resource itself. Роль участника тега предоставляет этот доступ.The Tag Contributor role grants this access. В настоящее время роль участника тега не может применять теги к ресурсам или группам ресурсов на портале.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.

  • Вы можете иметь доступ на запись к самому ресурсу.You can have write access to the resource itself. Роль участника предоставляет необходимый доступ для применения тегов к любой сущности.The Contributor role 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

Azure CLI предлагает две команды для применения тегов — AZ Tag Create и AZ Tag Update.Azure CLI offers two commands for applying tags - az tag create and az tag update. Необходимо иметь Azure CLI 2.10.0 или более поздней версии.You must have Azure CLI 2.10.0 or later. Версию можно проверить с помощью az version .You can check your version with az version. Сведения об обновлении или установке см. в разделе установка Azure CLI.To update or install, see Install the Azure CLI.

Тег AZ Create заменяет все теги в ресурсе, группе ресурсов или подписке.The az tag create 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:

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

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

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

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

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

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

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

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

Каждое имя тега может иметь только одно значение.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.

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

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

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

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

Одни и те же команды также работают с группами ресурсов или подписками.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:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

az group list --tag Dept=Finance

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

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

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

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

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

Чтобы удалить все теги, используйте команду AZ Tag Delete .To remove all tags, use the az tag delete command.

az tag delete --resource-id $resource

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

Если имена или значения тегов содержат пробелы, заключите их в двойные кавычки.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"

Шаблоны ARMARM templates

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

Примечание

Теги, применяемые с помощью шаблона ARM, перезапишут все существующие теги.The tags you apply through the ARM template overwrite any existing tags.

Применить значения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/2019-04-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/2019-04-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/2019-04-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/2019-04-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. Дополнительные сведения см. в статье Учебник. Предоставление доступа пользователю с помощью 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.

Сведения о тегах можно получить, загрузив файл использования, файл данных с разделителями-запятыми (CSV), доступный в портал Azure.You can retrieve information about tags by downloading the usage file, a comma-separated values (CSV) file available from the 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