copy edit

tfitzmac · tfitzmac · commit 6b570eb15aec · 2025-01-22T12:12:20.000-08:00
diff --git a/articles/azure-resource-manager/management/create-private-link-access-portal.md b/articles/azure-resource-manager/management/create-private-link-access-portal.md
@@ -7,7 +7,7 @@ ms.date: 09/26/2024
 
 # Use portal to create private link for managing Azure resources
 
-This article explains how you can use [Azure Private Link](../../private-link/index.yml) to restrict access for managing resources in your subscriptions. It shows using the Azure portal for setting up management of resources through private access.
+This article explains how to use [Azure Private Link](../../private-link/index.yml) to restrict access for managing resources in your subscriptions. It shows how to use the Azure portal for setting up management of resources through private access.
 
 [!INCLUDE [Create content](../../../includes/resource-manager-create-rmpl.md)]
 
@@ -19,7 +19,7 @@ When you create a resource management private link, the private link association
 
    :::image type="content" source="./media/create-private-link-access-portal/search.png" alt-text="Screenshot of Azure portal search bar with 'Resource management' entered.":::
 
-1. If your subscription doesn't already have resource management private links, you'll see a blank page. Select **Create resource management private link**.
+1. If your subscription doesn't already have resource management private links, you see a blank page. Select **Create resource management private link**.
 
    :::image type="content" source="./media/create-private-link-access-portal/start-create.png" alt-text="Screenshot of Azure portal showing the 'Create resource management private link' button.":::
 
@@ -31,7 +31,7 @@ When you create a resource management private link, the private link association
 
 ## Create private endpoint
 
-Now, create a private endpoint that references the resource management private link.
+Next, create a private endpoint that references the resource management private link.
 
 1. Navigate to the **Private Link Center**. Select **Create private endpoint**.
 
@@ -61,4 +61,4 @@ To make sure your environment is properly configured, check the local IP address
 
 ## Next steps
 
-To learn more about private links, see [Azure Private Link](../../private-link/index.yml).
+To learn more about private links, see [Azure Private Link](../../private-link/index.yml).
diff --git a/articles/azure-resource-manager/management/resource-graph-samples.md b/articles/azure-resource-manager/management/resource-graph-samples.md
@@ -1,14 +1,14 @@
 ---
 title: Azure Resource Graph sample queries for Azure Resource Manager
 description: Sample Azure Resource Graph queries for Azure Resource Manager showing use of resource types and tables to access Azure Resource Manager related resources and properties.
-ms.date: 09/26/2024
+ms.date: 01/22/2025
 ms.topic: sample
 ms.custom: subject-resourcegraph-sample, devx-track-azurepowershell, devx-track-arm-template, devx-track-azurecli
 ---
 
 # Azure Resource Graph sample queries for Azure Resource Manager
 
-This page is a collection of [Azure Resource Graph](../../governance/resource-graph/overview.md) sample queries for Azure Resource Manager.
+This page contains a collection of [Azure Resource Graph](../../governance/resource-graph/overview.md) sample queries for Azure Resource Manager.
 
 ## Sample queries for tags
 
@@ -17,4 +17,4 @@ This page is a collection of [Azure Resource Graph](../../governance/resource-gr
 ## Next steps
 
 - Learn more about the [query language](../../governance/resource-graph/concepts/query-language.md).
-- Learn more about how to [explore resources](../../governance/resource-graph/concepts/explore-resources.md).
+- Learn more about how to [explore resources](../../governance/resource-graph/concepts/explore-resources.md).
diff --git a/articles/azure-resource-manager/management/tag-policies.md b/articles/azure-resource-manager/management/tag-policies.md
@@ -2,12 +2,12 @@
 title: Policy definitions for tagging resources
 description: Describes the Azure Policy definitions that you can assign to ensure tag compliance.
 ms.topic: conceptual
-ms.date: 09/26/2024
+ms.date: 01/22/2025
 ---
 
 # Assign policy definitions for tag compliance
 
-You use [Azure Policy](../../governance/policy/overview.md) to enforce tagging rules and conventions. By creating a policy, you avoid the scenario of resources being deployed to your subscription that don't have the expected tags for your organization. Instead of manually applying tags or searching for resources that aren't compliant, you create a policy that automatically applies the needed tags during deployment. Tags can also now be applied to existing resources with the new [Modify](../../governance/policy/concepts/effects.md#modify) effect and a [remediation task](../../governance/policy/how-to/remediate-resources.md). The following section shows example policy definitions for tags.
+Use [Azure Policy](../../governance/policy/overview.md) to enforce tagging rules and conventions. By creating a policy, you avoid the scenario of resources being deployed to your subscription that don't have the expected tags for your organization. Instead of manually applying tags or searching for resources that aren't compliant, create a policy that automatically applies the needed tags during deployment. With the new [Modify](../../governance/policy/concepts/effects.md#modify) effect and a [remediation task](../../governance/policy/how-to/remediate-resources.md), you can also apply tags to existing resources. The following section shows example policy definitions for tags.
 
 ## Policy definitions
 
@@ -16,4 +16,4 @@ You use [Azure Policy](../../governance/policy/overview.md) to enforce tagging r
 ## Next steps
 
 * To learn about tagging resources, see [Use tags to organize your Azure resources](tag-resources.md).
-* Not all resource types support tags. To determine if you can apply a tag to a resource type, see [Tag support for Azure resources](tag-support.md).
+* Not all resource types support tags. To determine if you can apply a tag to a resource type, see [Tag support for Azure resources](tag-support.md).
diff --git a/articles/azure-resource-manager/management/tag-resources-portal.md b/articles/azure-resource-manager/management/tag-resources-portal.md
@@ -2,7 +2,7 @@
 title: Tag resources, resource groups, and subscriptions with Azure portal
 description: Shows how to use Azure portal to apply tags to Azure resources.
 ms.topic: conceptual
-ms.date: 09/26/2024
+ms.date: 01/22/2025
 ---
 
 # Apply tags with Azure portal
@@ -11,13 +11,13 @@ This article describes how to use the Azure portal to tag resources. For tag rec
 
 ## Add tags
 
-If a user doesn't have the required access for adding 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).
+If a user doesn't have the required access for adding tags, 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).
 
-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.
+1. To view the tags for a resource or a resource group, look for existing tags in the overview. If you didn't previously apply tags, the list is empty.
 
    :::image type="content" source="./media/tag-resources-portal/view-tags.png" alt-text="Screenshot of Azure portal showing tags for a resource group.":::
 
-1. To add a tag, select **Click here to add tags**.
+1. To add a tag, select **Add tags**.
 
 1. Provide a name and value.
 
@@ -63,7 +63,7 @@ To view all resources with a tag:
 
    :::image type="content" source="./media/tag-resources-portal/select-tag.png" alt-text="Screenshot of Azure portal displaying a list of tags with one selected for viewing resources.":::
 
-1. All resources with that tag are displayed.
+1. The portal displays all resources with that tag.
 
    :::image type="content" source="./media/tag-resources-portal/view-resources-by-tag.png" alt-text="Screenshot of Azure portal showing a list of resources filtered by the selected tag.":::
 
diff --git a/articles/azure-resource-manager/management/tag-resources.md b/articles/azure-resource-manager/management/tag-resources.md
@@ -2,7 +2,7 @@
 title: Tag resources, resource groups, and subscriptions for logical organization
 description: Describes the conditions and limitations for using tags with Azure resources.
 ms.topic: conceptual
-ms.date: 09/26/2024
+ms.date: 01/22/2025
 ---
 
 # Use tags to organize your Azure resources and management hierarchy
@@ -30,10 +30,10 @@ Resource tags support all cost-accruing services. To ensure that cost-accruing s
 > Tags are stored as plain text. Never add sensitive values to tags. Sensitive values could be exposed through many methods, including cost reports, commands that return existing tag definitions, deployment histories, exported templates, and monitoring logs.
 
 > [!WARNING]
-> Please be careful while using non-English language in your tags. It can cause decoding progress failure while loading your VM's metadata from IMDS (Instance Metadata Service).
+> Be careful when using non-English language in your tags. It can cause decoding progress failure while loading your VM's metadata from IMDS (Instance Metadata Service).
 
 > [!IMPORTANT]
-> Tag names are case-insensitive for operations. A tag with a tag name, regardless of the 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 names are case-insensitive for operations. An operation updates or retrieves a tag with a tag name, regardless of the casing. However, the resource provider might keep the casing you provide for the tag name. You see that casing in cost reports.
 >
 > Tag values are case-sensitive.
 
@@ -51,38 +51,38 @@ There are two ways to get the required access to tag resources.
 
 Resources don't inherit the tags you apply to a resource group or a subscription. To apply tags from a subscription or resource group to the resources, see [Azure Policies - tags](tag-policies.md).
 
-You can group costs for an Azure resource by using the **cm-resource-parent** tag. This tag lets you review tagged costs in Microsoft Cost Management without having to use filters. The key for this tag is cm-resource-parent and its value is the resource ID of the Azure resource you want to group costs by. For example, to group costs by an Azure Virtual Desktop host pool, provide the resource ID of the host pool. For more information, see [Group related resources in the cost analysis](../../cost-management-billing/costs/group-filter.md#group-related-resources-in-the-resources-view).
+You can group costs for an Azure resource by using the **cm-resource-parent** tag. This tag lets you review tagged costs in Microsoft Cost Management without having to use filters. The key for this tag is `cm-resource-parent` and its value is the resource ID of the Azure resource you want to group costs by. For example, to group costs by an Azure Virtual Desktop host pool, provide the resource ID of the host pool. For more information, see [Group related resources in the cost analysis](../../cost-management-billing/costs/group-filter.md#group-related-resources-in-the-resources-view).
 
 ## Tags and billing
 
-You can use tags to group your billing data. If you're running multiple VMs for different organizations, for example, 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.
+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.
 
-You can retrieve information about tags by downloading the usage file available from the Azure portal. For more information, see [Download or view your Azure billing invoice and daily usage data](../../cost-management-billing/manage/download-azure-invoice-daily-usage-date.md). For services that support tags with billing, the tags appear in the **Tags** column.
+To retrieve information about tags, download the usage file from the Azure portal. For more information, see [Download or view your Azure billing invoice and daily usage data](../../cost-management-billing/manage/download-azure-invoice-daily-usage-date.md). For services that support tags with billing, the tags appear in the **Tags** column.
 
 For REST API operations, see [Azure Billing REST API Reference](/rest/api/billing/).
 
 ## Unique tags pagination
 
-When calling the [Unique Tags API](/rest/api/resources/tags/list) there's a limit to the size of each API response page that is returned. A tag that has a large set of unique values will require the API to fetch the next page to retrieve the remaining set of values. When this happens the tag key is shown again to indicate that the values are still under this key.  
+When you call the [Unique Tags API](/rest/api/resources/tags/list), there's a limit to the size of each API response page. A tag that has a large set of unique values requires the API to fetch the next page to retrieve the remaining set of values. When the results are divided over multiple pages, the API response shows the tag key again to indicate that the values are still under this key.  
 
-This can result in some tools, like the Azure portal, to show the tag key twice.  
+This behavior can result in some tools, like the Azure portal, showing the tag key twice.
 
 ## Limitations
 
 The following limitations apply to tags:
 
 * Not all resource types support tags. To determine if you can apply a tag to a resource type, see [Tag support for Azure resources](tag-support.md).
-* Each resource type might have specific requirements when working with tags. For example, tags on virtual machine (VM) extensions can only be updated when the VM is running. If you receive an error message while trying to update a tag, follow the instructions in the message.
+* Each resource type might have specific requirements when working with tags. For example, you can only update tags on virtual machine (VM) extensions when the VM is running. If you receive an error message while trying to update a tag, follow the instructions in the message.
 * Each resource, resource group, and subscription can have a maximum of 50 tag name-value pairs. If you need to apply more tags than the maximum allowed number, use a JSON string for the tag value. The JSON string can contain many of the values that you apply to a single tag name. A resource group or subscription can contain many resources that each have 50 tag name-value pairs.
 * The tag name has a limit of 512 characters and the tag value has a limit of 256 characters. For storage accounts, the tag name has a limit of 128 characters and the tag value has a limit of 256 characters.
 * Classic resources such as Cloud Services don't support tags.
-* Azure IP Groups and Azure Firewall Policies don't support PATCH operations. PATCH API method operations, therefore, can't update tags through the portal. Instead, you can use the update commands for those resources. You can update tags for an IP group, for example, with the [az network ip-group update](/cli/azure/network/ip-group#az-network-ip-group-update) command.
+* Azure IP Groups and Azure Firewall Policies don't support PATCH operations. PATCH API method operations, therefore, can't update tags through the portal. Instead, use the update commands for those resources. For example, you can update tags for an IP group with the [az network ip-group update](/cli/azure/network/ip-group#az-network-ip-group-update) command.
 * Tag names can't contain these characters: `<`, `>`, `%`, `&`, `\`, `?`, `/`
 
    > [!NOTE]
-   > * Azure Domain Name System (DNS) zones don't support the use of spaces or parentheses in the tag or a tag that starts with a number. Azure DNS tag names don't support special and unicode characters. The value can contain all characters.
+   > * Azure Domain Name System (DNS) zones don't support the use of spaces or parentheses in the tag or a tag that starts with a number. Azure DNS tag names don't support special and Unicode characters. The value can contain all characters.
    >
-   > * Traffic Manager doesn't support the use of spaces, `#` or `:` in the tag name. The tag name can't start with a number.
+   > * Traffic Manager doesn't support the use of spaces, `#`, or `:` in the tag name. The tag name can't start with a number.
    >
    > * Azure Front Door doesn't support the use of `#` or `:` in the tag name.
    >
@@ -103,4 +103,4 @@ The following limitations apply to tags:
   * [Azure PowerShell](tag-resources-powershell.md)
   * [Python](tag-resources-python.md)
   * [ARM templates](tag-resources-templates.md)
-  * [Bicep](tag-resources-bicep.md)
+  * [Bicep](tag-resources-bicep.md)
