Skip to content

Commit 2fc01e3

Browse files
Merge pull request #262320 from tfitzmac/0103overview
add extension resource
2 parents 1c751e6 + 5c90834 commit 2fc01e3

File tree

1 file changed

+10
-6
lines changed

1 file changed

+10
-6
lines changed

articles/azure-resource-manager/management/overview.md

Lines changed: 10 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Azure Resource Manager overview
33
description: Describes how to use Azure Resource Manager for deployment, management, and access control of resources on Azure.
44
ms.topic: overview
5-
ms.date: 11/13/2023
5+
ms.date: 01/03/2024
66
ms.custom: contperf-fy21q1, contperf-fy21q3-portal, devx-track-arm-template
77
---
88
# What is Azure Resource Manager?
@@ -19,7 +19,7 @@ The following image shows the role Azure Resource Manager plays in handling Azur
1919

2020
:::image type="content" source="./media/overview/consistent-management-layer.png" alt-text="Diagram that shows the role of Azure Resource Manager in handling Azure requests." border="false":::
2121

22-
All capabilities that are available in the portal are also available through PowerShell, Azure CLI, REST APIs, and client SDKs. Functionality initially released through APIs will be represented in the portal within 180 days of initial release.
22+
All capabilities that are available in the portal are also available through PowerShell, Azure CLI, REST APIs, and client SDKs. Functionality initially released through APIs are represented in the portal within 180 days of initial release.
2323

2424
> [!IMPORTANT]
2525
> Azure Resource Manager will only support Transport Layer Security (TLS) 1.2 or later by Fall 2023. For more information, see [Migrating to TLS 1.2 for Azure Resource Manager](tls-support.md).
@@ -34,6 +34,7 @@ If you're new to Azure Resource Manager, there are some terms you might not be f
3434
* **declarative syntax** - Syntax that lets you state "Here's what I intend to create" without having to write the sequence of programming commands to create it. ARM templates and Bicep files are examples of declarative syntax. In those files, you define the properties for the infrastructure to deploy to Azure.
3535
* **ARM template** - A JavaScript Object Notation (JSON) file that defines one or more resources to deploy to a resource group, subscription, management group, or tenant. The template can be used to deploy the resources consistently and repeatedly. See [Template deployment overview](../templates/overview.md).
3636
* **Bicep file** - A file for declaratively deploying Azure resources. Bicep is a language that's been designed to provide the best authoring experience for infrastructure as code solutions in Azure. See [Bicep overview](../bicep/overview.md).
37+
* **extension resource** - A resource that adds to another resource's capabilities. For example, a role assignment is an extension resource. You apply a role assignment to any other resource to specify access. See [Extension resources](./extension-resource-types.md).
3738

3839
For more definitions of Azure terminology, see [Azure fundamental concepts](/azure/cloud-adoption-framework/ready/considerations/fundamental-concepts).
3940

@@ -57,7 +58,7 @@ With Resource Manager, you can:
5758

5859
## Understand scope
5960

60-
Azure provides four levels of scope: [management groups](../../governance/management-groups/overview.md), subscriptions, [resource groups](#resource-groups), and resources. The following image shows an example of these layers.
61+
Azure provides four levels of management scope: [management groups](../../governance/management-groups/overview.md), subscriptions, [resource groups](#resource-groups), and resources. The following image shows an example of these layers.
6162

6263
:::image type="content" source="./media/overview/scope-levels.png" alt-text="Diagram that illustrates the four levels of scope in Azure: management groups, subscriptions, resource groups, and resources." border="false":::
6364

@@ -124,9 +125,12 @@ The Azure Resource Manager service is designed for resiliency and continuous ava
124125
This resiliency applies to services that receive requests through Resource Manager. For example, Key Vault benefits from this resiliency.
125126

126127
### Resource group location alignment
127-
To reduce the likelihood of being impacted by region outages, if they occur, it's recommended to co-locate your resources with their resource group in the same region together.
128-
The resource group location is used to determine the location where Azure Resource Manager will store metadata related to all the resources within the resource group, which is then used for routing and caching. For instance, when you list your resources at the subscription or resource group scopes, Azure Resource Manager responds based off this cache.
129-
When the resource group's region is unavailable, Azure Resource Manager may be unable to update your resource's metadata and may block your write calls. By co-locating your resource and resource group region, you can reduce your chance of being affected by region unavailability since your resource and resource management metadata will all be stored in one region instead of multiple.
128+
129+
To reduce the impact of regional outages, we recommend that you locate resources in the same region as the resource group.
130+
131+
The resource group location is where Azure Resource Manager stores metadata for the resources in the resource group. Azure Resource Manager uses this location for routing and caching. For example, when you list your resources at the subscription or resource group scopes, Azure Resource Manager gets the information from the cache.
132+
133+
When the resource group's region is unavailable, Azure Resource Manager is unable to update your resource's metadata and blocks your write calls. By colocating your resource and resource group region, you reduce the risk of region unavailability because your resources and metadata exist in one region instead of multiple regions.
130134

131135
## Next steps
132136

0 commit comments

Comments
 (0)