Skip to content

Commit 13b4749

Browse files
Merge pull request #51291 from staleycyn/patch-4
Update 6-design-for-resource-tags.md
2 parents bf91c15 + b38650f commit 13b4749

File tree

1 file changed

+7
-5
lines changed

1 file changed

+7
-5
lines changed

learn-pr/wwl-azure/design-governance/includes/6-design-for-resource-tags.md

Lines changed: 7 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,9 @@
11
[Resource tags](/azure/azure-resource-manager/management/tag-resources?tabs=json) are another way to organize resources. Tags provide extra information, or metadata, about your resources.
22

3+
> [!VIDEO https://learn-video.azurefd.net/vod/player?id=670885a7-e1ed-43af-b32e-6052dbd6e7a4]
4+
35
> [!TIP]
4-
> Before you start a resource tagging project, ask yourself what you want to accomplish. Will reporting or billing use tags? Can you use the tags to enable more effective searching for Tailwind Traders? Will automated scripts use tags? Be sure to clearly define your goals.
6+
> Before you start a resource tagging project, ask yourself what you want to accomplish. Can you use the tags to enable more effective searching for Tailwind Traders? Do automated scripts use tags? Be sure to clearly define your goals.
57
68
### Things to know about resource tags
79

@@ -13,15 +15,15 @@ As you plan the governance strategy for Tailwind Traders, consider these charact
1315

1416
- Resource tags can be added, modified, and deleted. These actions can be done with PowerShell, the Azure CLI, Azure Resource Manager (ARM) templates, the REST API, or the Azure portal.
1517

16-
- [Tags can be applied](/azure/azure-resource-manager/management/tag-resources) to a resource group. However, tags applied to a resource group aren't inherited by the resources in the group.
18+
- [Tags can be applied](/azure/azure-resource-manager/management/tag-resources) to a resource group. However, tags applied to a resource group aren't inherited.
1719

1820
### Things to consider when creating resource tags
1921

2022
You created the organizational hierarchy for Tailwind Traders. Now you need to determine which resource tags to apply.
2123

2224
:::image type="content" source="../media/resource-tags.png" alt-text="Diagram that shows an example hierarchy of resource tags." border="false":::
2325

24-
- **Consider your organization's taxonomy**. Align your resource tags with accepted department nomenclature to make it easier to understand. Are there recognized terms for compliance or cost reporting for the Tailwind Traders organization? Add tags for office locations, confidentiality levels, or other defined policies.
26+
- **Consider your organization's taxonomy**. Align your resource tags with accepted department nomenclature. Are there recognized terms for compliance or cost reporting for the Tailwind Traders organization? Add tags for office locations, confidentiality levels, or other defined policies.
2527

2628
- **Consider whether you need IT-aligned or business-aligned tagging**. Implement IT-aligned tagging or business-aligned tagging, or a combination of these approaches to be most effective.
2729

@@ -40,7 +42,7 @@ You created the organizational hierarchy for Tailwind Traders. Now you need to d
4042
| Tag type | Description | Example name-value pairs |
4143
| --- | --- | --- |
4244
| **Functional** | Functional tags categorize resources according to their purpose within a workload. This tag shows the deployed environment for a resource, or other functionality and operational details. | - `app = catalogsearch1` <br> - `tier = web` <br> - `webserver = apache` <br> - `env = production, dev, staging` |
43-
| **Classification** | Classification tags identify a resource by how it's used and what policies apply to it. | - `confidentiality = private` <br> - `SLA = 24hours` |
45+
| **Classification** | Classification tags identify resource usage. | - `confidentiality = private` <br> - `SLA = 24hours` |
4446
| **Accounting** | Accounting tags allow a resource to be associated with specific groups within an organization for billing purposes. | - `department = finance` <br> - `program = business-initiative` <br> - `region = northamerica` |
4547
| **Partnership** | Partnership tags provide information about the people (other than IT members) who are associated with a resource, or otherwise affected by the resource. | - `owner = jsmith` <br> - `contactalias = catsearchowners` <br> - `stakeholders = user1;user2;user3` |
4648
| **Purpose** | Purpose tags align resources to business functions to better support investment decisions. | - `businessprocess = support` <br> - `businessimpact = moderate` <br> - `revenueimpact = high` |
@@ -52,4 +54,4 @@ You created the organizational hierarchy for Tailwind Traders. Now you need to d
5254
- **Consider which resources require tagging**. Keep in mind that you don't need to enforce that a specific tag is present on all Tailwind Traders resources. You might decide that only mission-critical resources have the `Impact` tag. All nontagged resources would then not be considered as mission critical.
5355

5456
> [!NOTE]
55-
> To implement an effective resource tagging structure, be sure to seek input from the different stakeholders in your organization.
57+
> To implement an effective resource tagging structure, be sure to seek input from the different stakeholders in your organization.

0 commit comments

Comments
 (0)