Merge pull request #235581 from tfitzmac/0423move

add Python to move resources

Author: prmerger-automator[bot]

articles/azure-resource-manager/management/move-resource-group-and-subscription.md

@@ -2,8 +2,8 @@
 title: Move resources to a new subscription or resource group
 description: Use Azure Resource Manager to move resources to a new resource group or subscription.
 ms.topic: conceptual
-ms.date: 01/30/2023
-ms.custom: devx-track-azurecli, devx-track-azurepowershell, devx-track-arm-template
+ms.date: 04/24/2023
+ms.custom: devx-track-azurecli, devx-track-azurepowershell, devx-track-arm-template, ai-gen-docs
 ---
 
 # Move resources to a new resource group or subscription
@@ -16,6 +16,8 @@ If your move requires setting up new dependent resources, you'll experience an i
 
 Moving a resource only moves it to a new resource group or subscription. It doesn't change the location of the resource.
 
+[!INCLUDE [AI attribution](../../../includes/ai-generated-attribution.md)]
+
 ## Changed resource ID
 
 When you move a resource, you change its resource ID. The standard format for a resource ID is `/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}`. When you move a resource to a new resource group or subscription, you change one or more values in that path.
@@ -164,16 +166,21 @@ When the move has completed, you're notified of the result.
 
 ### Validate
 
-To test your move scenario without actually moving the resources, use the [Invoke-AzResourceAction](/powershell/module/az.resources/invoke-azresourceaction) command. Use this command only when you need to predetermine the results. To run this operation, you need the:
-
-* Resource ID of the source resource group
-* Resource ID of the target resource group
-* Resource ID of each resource to move
+To test your move scenario without actually moving the resources, use the [Invoke-AzResourceAction](/powershell/module/az.resources/invoke-azresourceaction) command. Use this command only when you need to predetermine the results.
 
 ```azurepowershell
+$sourceName = "sourceRG"
+$destinationName = "destinationRG"
+$resourcesToMove = @("app1", "app2")
+
+$sourceResourceGroup = Get-AzResourceGroup -Name $sourceName
+$destinationResourceGroup = Get-AzResourceGroup -Name $destinationName
+
+$resources = Get-AzResource -ResourceGroupName $sourceName | Where-Object { $_.Name -in $resourcesToMove }
+
 Invoke-AzResourceAction -Action validateMoveResources `
--ResourceId "/subscriptions/{subscription-id}/resourceGroups/{source-rg}" `
--Parameters @{ resources= @("/subscriptions/{subscription-id}/resourceGroups/{source-rg}/providers/{resource-provider}/{resource-type}/{resource-name}", "/subscriptions/{subscription-id}/resourceGroups/{source-rg}/providers/{resource-provider}/{resource-type}/{resource-name}", "/subscriptions/{subscription-id}/resourceGroups/{source-rg}/providers/{resource-provider}/{resource-type}/{resource-name}");targetResourceGroup = '/subscriptions/{subscription-id}/resourceGroups/{destination-rg}' }  
+-ResourceId $sourceResourceGroup.ResourceId `
+-Parameters @{ resources= $resources.ResourceId;targetResourceGroup = $destinationResourceGroup.ResourceId }  
 ```
 
 If validation passes, you see no output.
@@ -185,9 +192,13 @@ If validation fails, you see an error message describing why the resources can't
 To move existing resources to another resource group or subscription, use the [Move-AzResource](/powershell/module/az.resources/move-azresource) command. The following example shows how to move several resources to a new resource group.
 
 ```azurepowershell-interactive
-$webapp = Get-AzResource -ResourceGroupName OldRG -ResourceName ExampleSite
-$plan = Get-AzResource -ResourceGroupName OldRG -ResourceName ExamplePlan
-Move-AzResource -DestinationResourceGroupName NewRG -ResourceId $webapp.ResourceId, $plan.ResourceId
+$sourceName = "sourceRG"
+$destinationName = "destinationRG"
+$resourcesToMove = @("app1", "app2")
+
+$resources = Get-AzResource -ResourceGroupName $sourceName | Where-Object { $_.Name -in $resourcesToMove }
+
+Move-AzResource -DestinationResourceGroupName $destinationName -ResourceId $resources.ResourceId
 ```
 
 To move to a new subscription, include a value for the `DestinationSubscriptionId` parameter.
@@ -240,6 +251,86 @@ az resource move --destination-group newgroup --ids $webapp $plan
 
 To move to a new subscription, provide the `--destination-subscription-id` parameter.
 
+## Use Python
+
+### Validate
+
+To test your move scenario without actually moving the resources, use the [ResourceManagementClient.resources.begin_validate_move_resources](/python/api/azure-mgmt-resource/azure.mgmt.resource.resources.v2022_09_01.operations.resourcesoperations#azure-mgmt-resource-resources-v2022-09-01-operations-resourcesoperations-begin-validate-move-resources) method. Use this method only when you need to predetermine the results.
+
+```python
+import os
+from azure.identity import AzureCliCredential
+from azure.mgmt.resource import ResourceManagementClient
+
+credential = AzureCliCredential()
+subscription_id = os.environ["AZURE_SUBSCRIPTION_ID"]
+
+resource_client = ResourceManagementClient(credential, subscription_id)
+
+source_name = "sourceRG"
+destination_name = "destinationRG"
+resources_to_move = ["app1", "app2"]
+
+destination_resource_group = resource_client.resource_groups.get(destination_name)
+
+resources = [
+    resource for resource in resource_client.resources.list_by_resource_group(source_name)
+    if resource.name in resources_to_move
+]
+
+resource_ids = [resource.id for resource in resources]
+
+validate_move_resources_result = resource_client.resources.begin_validate_move_resources(
+    source_name,
+    {
+        "resources": resource_ids,
+        "target_resource_group": destination_resource_group.id
+    }
+).result()
+
+print("Validate move resources result: {}".format(validate_move_resources_result))
+```
+
+If validation passes, you see no output.
+
+If validation fails, you see an error message describing why the resources can't be moved.
+
+### Move
+
+To move existing resources to another resource group or subscription, use the [ResourceManagementClient.resources.begin_move_resources](/python/api/azure-mgmt-resource/azure.mgmt.resource.resources.v2022_09_01.operations.resourcesoperations#azure-mgmt-resource-resources-v2022-09-01-operations-resourcesoperations-begin-move-resources) method. The following example shows how to move several resources to a new resource group.
+
+```python
+import os
+from azure.identity import AzureCliCredential
+from azure.mgmt.resource import ResourceManagementClient
+
+credential = AzureCliCredential()
+subscription_id = os.environ["AZURE_SUBSCRIPTION_ID"]
+
+resource_client = ResourceManagementClient(credential, subscription_id)
+
+source_name = "sourceRG"
+destination_name = "destinationRG"
+resources_to_move = ["app1", "app2"]
+
+destination_resource_group = resource_client.resource_groups.get(destination_name)
+
+resources = [
+    resource for resource in resource_client.resources.list_by_resource_group(source_name)
+    if resource.name in resources_to_move
+]
+
+resource_ids = [resource.id for resource in resources]
+
+resource_client.resources.begin_move_resources(
+    source_name,
+    {
+        "resources": resource_ids,
+        "target_resource_group": destination_resource_group.id
+    }
+)
+```
+
 ## Use REST API
 
 ### Validate