Merge pull request #270242 from mumian/0326-scope

Add scope transition information

Author: American-Dipper

articles/azure-resource-manager/templates/deploy-to-management-group.md

@@ -2,7 +2,7 @@
 title: Deploy resources to management group
 description: Describes how to deploy resources at the management group scope in an Azure Resource Manager template.
 ms.topic: conceptual
-ms.date: 03/20/2024
+ms.date: 03/26/2024
 ms.custom: devx-track-azurepowershell, devx-track-azurecli, devx-track-arm-template
 ---
 
@@ -130,6 +130,8 @@ When deploying to a management group, you can deploy resources to:
 * resource groups in the management group
 * the tenant for the resource group
 
+[!INCLUDE [Scope transitions](../../../includes/resource-manager-scope-transition.md)]
+
 An [extension resource](scope-extension-resources.md) can be scoped to a target that is different than the deployment target.
 
 The user deploying the template must have access to the specified scope.

articles/azure-resource-manager/templates/deploy-to-resource-group.md

@@ -3,7 +3,7 @@ title: Deploy resources to resource groups
 description: Describes how to deploy resources in an Azure Resource Manager template. It shows how to target more than one resource group.
 ms.topic: conceptual
 ms.custom: devx-track-arm-template
-ms.date: 03/20/2024
+ms.date: 03/26/2024
 ---
 
 # Resource group deployments with ARM templates
@@ -85,6 +85,8 @@ When deploying to a resource group, you can deploy resources to:
 * any subscription in the tenant
 * the tenant for the resource group
 
+[!INCLUDE [Scope transitions](../../../includes/resource-manager-scope-transition.md)]
+
 An [extension resource](scope-extension-resources.md) can be scoped to a target that is different than the deployment target.
 
 The user deploying the template must have access to the specified scope.

articles/azure-resource-manager/templates/deploy-to-subscription.md

@@ -2,7 +2,7 @@
 title: Deploy resources to subscription
 description: Describes how to create a resource group in an Azure Resource Manager template. It also shows how to deploy resources at the Azure subscription scope.
 ms.topic: conceptual
-ms.date: 03/20/2024
+ms.date: 03/26/2024
 ms.custom: devx-track-azurepowershell, devx-track-azurecli, devx-track-arm-template
 ---
 
@@ -169,6 +169,8 @@ When deploying to a subscription, you can deploy resources to:
 * resource groups within the subscription or other subscriptions
 * the tenant for the subscription
 
+[!INCLUDE [Scope transitions](../../../includes/resource-manager-scope-transition.md)]
+
 An [extension resource](scope-extension-resources.md) can be scoped to a target that is different than the deployment target.
 
 The user deploying the template must have access to the specified scope.

articles/azure-resource-manager/templates/deploy-to-tenant.md

@@ -2,7 +2,7 @@
 title: Deploy resources to tenant
 description: Describes how to deploy resources at the tenant scope in an Azure Resource Manager template.
 ms.topic: conceptual
-ms.date: 03/20/2024
+ms.date: 03/26/2024
 ms.custom: devx-track-azurepowershell, devx-track-azurecli, devx-track-arm-template
 ---
 
@@ -143,6 +143,8 @@ When deploying to a tenant, you can deploy resources to:
 * subscriptions
 * resource groups
 
+[!INCLUDE [Scope transitions](../../../includes/resource-manager-scope-transition.md)]
+
 An [extension resource](scope-extension-resources.md) can be scoped to a target that is different than the deployment target.
 
 The user deploying the template must have access to the specified scope.

includes/resource-manager-scope-transition.md

@@ -0,0 +1,7 @@
+---
+ms.service: azure-resource-manager
+ms.topic: include
+ms.date: 03/26/2024
+---
+
+The only prohibited scope transitions occur from Resource Group to Management Group, or from Subscription to Management Group.