Skip to content

Commit 3b7f315

Browse files
committed
fix issues
1 parent e387e14 commit 3b7f315

File tree

3 files changed

+12
-12
lines changed

3 files changed

+12
-12
lines changed

articles/azure-resource-manager/management/tag-resources.md

Lines changed: 8 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Shows how to apply tags to organize Azure resources for billing and
44
ms.topic: conceptual
55
ms.date: 03/20/2020
66
---
7-
# Use tags to organize your Azure resources, resource groups, and subscriptions
7+
# Use tags to organize your Azure resources and management hierarchy
88

99
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. For example, you can apply the name "Environment" and the value "Production" to all the resources in production.
1010

@@ -14,7 +14,9 @@ For recommendations on how to implement a tagging strategy, see [Resource naming
1414

1515
## Required access
1616

17-
To apply tags to resources, the user must have write access to that resource type. To apply tags to all resource types, use the [Contributor](../../role-based-access-control/built-in-roles.md#contributor) role. 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](../../role-based-access-control/built-in-roles.md#virtual-machine-contributor).
17+
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.
18+
19+
The [Contributor](../../role-based-access-control/built-in-roles.md#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](../../role-based-access-control/built-in-roles.md#virtual-machine-contributor).
1820

1921
## PowerShell
2022

@@ -152,10 +154,6 @@ $resource = Get-AzResource -ResourceName sqlDatabase1 -ResourceGroupName example
152154
$resource | ForEach-Object { Update-AzTag -Tag @{ "Dept"="IT"; "Environment"="Test" } -ResourceId $_.ResourceId -Operation Merge }
153155
```
154156

155-
### Inherit tags
156-
157-
Tags applied to the resource group or subscription aren't inherited by the resources. To apply tags from a subscription or resource group to the resources, see [Azure Policies - tags](tag-policies.md).
158-
159157
### List tags
160158

161159
To get the tags for a resource, resource group, or subscription, use the [Get-AzTag](/powershell/module/az.resources/get-aztag) command and pass in the resource ID for the entity.
@@ -258,10 +256,6 @@ az group update -n examplegroup --set tags.'Status'='Approved'
258256

259257
Currently, Azure CLI doesn't support applying tags to subscriptions.
260258

261-
### Inherit tags
262-
263-
Tags applied to the resource group or subscription aren't inherited by the resources. To apply tags from a subscription or resource group to the resources, see [Azure Policies - tags](tag-policies.md).
264-
265259
### List tags
266260

267261
To see the existing tags for a resource, use:
@@ -563,6 +557,10 @@ To work with tags through the Azure REST API, use:
563557
* [Tags - Get At Scope](/rest/api/resources/tags/getatscope) (GET operation)
564558
* [Tags - Delete At Scope](/rest/api/resources/tags/deleteatscope) (DELETE operation)
565559

560+
## Inherit tags
561+
562+
Tags applied to the resource group or subscription aren't inherited by the resources. To apply tags from a subscription or resource group to the resources, see [Azure Policies - tags](tag-policies.md).
563+
566564
## Tags and billing
567565

568566
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.

articles/azure-resource-manager/management/toc.yml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -68,11 +68,11 @@
6868
items:
6969
- name: Decision guide
7070
href: /azure/cloud-adoption-framework/decision-guides/resource-tagging/?toc=/azure/azure-resource-manager/management/toc.json
71-
- name: Tag resources
71+
- name: Use tags
7272
href: tag-resources.md
7373
- name: Policies - compliance
7474
href: tag-policies.md
75-
- name: Tag support
75+
- name: Supported resource types
7676
href: tag-support.md
7777
- name: Manage resource groups
7878
items:

includes/resource-manager-tag-resources.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,8 @@
1010
ms.custom: include file
1111
---
1212

13+
If a user doesn't have the required access for applying tags, you can assign the **Tag Contributor** role to the user. For more information, see [Tutorial: Grant a user access to Azure resources using RBAC and the Azure portal](../..//role-based-access-control/quickstart-assign-role-user-portal.md).
14+
1315
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.
1416

1517
![View tags for resource or resource group](./media/resource-manager-tag-resources/view-tags.png)

0 commit comments

Comments
 (0)