Resources verplaatsen naar een nieuwe resource groep of een nieuw abonnementMove resources to a new resource group or subscription

In dit artikel wordt beschreven hoe u Azure-resources verplaatst naar een ander Azure-abonnement of een andere resource groep onder hetzelfde abonnement.This article shows you how to move Azure resources to either another Azure subscription or another resource group under the same subscription. U kunt de Azure Portal, Azure PowerShell, Azure CLI of de REST API gebruiken om resources te verplaatsen.You can use the Azure portal, Azure PowerShell, Azure CLI, or the REST API to move resources.

Zowel de bron groep als de doel groep worden tijdens de verplaatsings bewerking vergrendeld.Both the source group and the target group are locked during the move operation. Schrijf en verwijderbewerkingen op de brongroepen zijn geblokkeerd totdat de verplaatsing is voltooid.Write and delete operations are blocked on the resource groups until the move completes. Deze vergrendeling betekent dat u kunt geen toevoegen, bijwerken of verwijderen van resources in de resourcegroepen, maar dit betekent niet dat de resources zijn geblokkeerd.This lock means you can't add, update, or delete resources in the resource groups, but it doesn't mean the resources are frozen. Als u een SQL-Server en de bijbehorende database naar een nieuwe resourcegroep verplaatsen, er een toepassing die gebruikmaakt van de database zonder uitvaltijd.For example, if you move a SQL Server and its database to a new resource group, an application that uses the database experiences no downtime. Dit kan nog steeds lezen en schrijven naar de database.It can still read and write to the database.

Als u een resource verplaatst, wordt deze alleen verplaatst naar een nieuwe resource groep of een nieuw abonnement.Moving a resource only moves it to a new resource group or subscription. De locatie van de resource wordt niet gewijzigd.It doesn't change the location of the resource.

Controlelijst voor het verplaatsen van resourcesChecklist before moving resources

Voordat u een resource verplaatst, moeten er enkele belangrijke stappen worden uitgevoerd.There are some important steps to do before moving a resource. U kunt fouten voorkomen door te controleren of aan de volgende voorwaarden is voldaan.By verifying these conditions, you can avoid errors.

  1. De resources die u wilt verplaatsen, moeten de verplaatsings bewerking ondersteunen.The resources you want to move must support the move operation. Zie ondersteuning voor het verplaatsen van resources voor bronnenvoor een lijst met resources die kunnen worden verplaatst.For a list of which resources support move, see Move operation support for resources.

  2. Sommige services hebben specifieke beperkingen of vereisten bij het verplaatsen van resources.Some services have specific limitations or requirements when moving resources. Als u een van de volgende services hebt verplaatst, controleert u of er richt lijnen zijn voordat u verdergaat.If you've moving any of the following services, check that guidance before moving.

  3. De bron-en doel abonnementen moeten actief zijn.The source and destination subscriptions must be active. Als u problemen ondervindt bij het inschakelen van een uitgeschakeld account, maakt u een ondersteunings aanvraag voor Azure.If you have trouble enabling an account that has been disabled, create an Azure support request. Selecteer Abonnementsbeheer voor het probleemtype.Select Subscription Management for the issue type.

  4. De bron- en doelabonnementen moeten aanwezig zijn in dezelfde Azure Active Directory-tenant.The source and destination subscriptions must exist within the same Azure Active Directory tenant. Om te controleren dat beide abonnementen dezelfde tenant-ID hebben, gebruikt u Azure PowerShell of Azure CLI.To check that both subscriptions have the same tenant ID, use Azure PowerShell or Azure CLI.

    Voor Azure PowerShell gebruiken:For Azure PowerShell, use:

    (Get-AzSubscription -SubscriptionName <your-source-subscription>).TenantId
    (Get-AzSubscription -SubscriptionName <your-destination-subscription>).TenantId
    

    Gebruik voor Azure CLI:For Azure CLI, use:

    az account show --subscription <your-source-subscription> --query tenantId
    az account show --subscription <your-destination-subscription> --query tenantId
    

    Als de tenant-id's voor de bron- en doelabonnementen niet hetzelfde zijn, moet u de volgende methoden gebruiken om af te stemmen van de tenant-id's:If the tenant IDs for the source and destination subscriptions aren't the same, use the following methods to reconcile the tenant IDs:

  5. Het doelabonnement moet zijn geregistreerd voor de resourceprovider van de resource die wordt verplaatst.The destination subscription must be registered for the resource provider of the resource being moved. Als u niet het geval is, ontvangt u een foutmelding waarin staat dat de abonnement is niet geregistreerd voor een resourcetype.If not, you receive an error stating that the subscription is not registered for a resource type. Mogelijk ziet u deze fout wanneer u een resource verplaatst naar een nieuw abonnement, maar dat abonnement nooit is gebruikt voor dat resource type.You might see this error when moving a resource to a new subscription, but that subscription has never been used with that resource type.

    Gebruik de volgende opdrachten om op te halen van de registratiestatus voor PowerShell:For PowerShell, use the following commands to get the registration status:

    Set-AzContext -Subscription <destination-subscription-name-or-id>
    Get-AzResourceProvider -ListAvailable | Select-Object ProviderNamespace, RegistrationState
    

    Gebruik het volgende voor het registreren van een resourceprovider:To register a resource provider, use:

    Register-AzResourceProvider -ProviderNamespace Microsoft.Batch
    

    Gebruik de volgende opdrachten om op te halen van de status van de registratie voor Azure CLI:For Azure CLI, use the following commands to get the registration status:

    az account set -s <destination-subscription-name-or-id>
    az provider list --query "[].{Provider:namespace, Status:registrationState}" --out table
    

    Gebruik het volgende voor het registreren van een resourceprovider:To register a resource provider, use:

    az provider register --namespace Microsoft.Batch
    
  6. Het verplaatsen van de resources account moet ten minste de volgende machtigingen hebben:The account moving the resources must have at least the following permissions:

    • Microsoft.Resources/subscriptions/resourceGroups/moveResources/action op de resourcegroep.Microsoft.Resources/subscriptions/resourceGroups/moveResources/action on the source resource group.
    • Microsoft.Resources/subscriptions/resourceGroups/write op de doel-resourcegroep.Microsoft.Resources/subscriptions/resourceGroups/write on the destination resource group.
  7. Controleer voordat u de resources verplaatst, de abonnementquota voor het abonnement dat u de resources wilt verplaatsen.Before moving the resources, check the subscription quotas for the subscription you're moving the resources to. Als het verplaatsen van de resources betekent dat het abonnement overschrijdt de grenzen, moet u om te controleren of u een verhoging van de quota kan opvragen.If moving the resources means the subscription will exceed its limits, you need to review whether you can request an increase in the quota. Zie voor een lijst van beperkingen en hoe u een verhoging Azure-abonnement en Servicelimieten, quotums en beperkingen.For a list of limits and how to request an increase, see Azure subscription and service limits, quotas, and constraints.

  8. Voor een verplaatsing tussen abonnementen moeten de resource en de afhankelijke resources zich in dezelfde resource groep bevinden en moeten ze samen worden verplaatst.For a move across subscriptions, the resource and its dependent resources must be located in the same resource group and they must be moved together. Een virtuele machine met Managed disks vereist bijvoorbeeld dat de virtuele machine en de beheerde schijven samen worden verplaatst, samen met andere afhankelijke bronnen.For example, a VM with managed disks would require the VM and the managed disks to be moved together, along with other dependent resources.

    Als u een resource naar een nieuw abonnement verplaatst, controleert u of de resource afhankelijke resources heeft en of ze zich in dezelfde resource groep bevinden.If you're moving a resource to a new subscription, check to see whether the resource has any dependent resources, and whether they're located in the same resource group. Als de resources zich niet in dezelfde resource groep bevinden, controleert u of de resources kunnen worden geconsolideerd in dezelfde resource groep.If the resources aren't in the same resource group, check to see whether the resources can be consolidated into the same resource group. Als dit het geval is, kunt u al deze resources in dezelfde resource groep plaatsen met behulp van een Verplaats bewerking tussen resource groepen.If so, bring all these resources into the same resource group by using a move operation across resource groups.

    Zie scenario voor verplaatsen tussen abonnementenvoor meer informatie.For more information, see Scenario for move across subscriptions.

Scenario voor het verplaatsen van meerdere abonnementenScenario for move across subscriptions

Het verplaatsen van resources van het ene naar het andere abonnement is een proces dat uit drie stappen bestaat:Moving resources from one subscription to another is a three-step process:

scenario voor het verplaatsen van meerdere abonnementen

Voor illustratie doeleinden hebben we slechts één afhankelijke resource.For illustration purposes, we have only one dependent resource.

  • Stap 1: Als afhankelijke resources over verschillende resource groepen worden gedistribueerd, moet u deze eerst verplaatsen naar één resource groep.Step 1: If dependent resources are distributed across different resource groups, first move them into one resource group.
  • Stap 2: Verplaats de resource en afhankelijke resources samen van het bron abonnement naar het doel abonnement.Step 2: Move the resource and dependent resources together from the source subscription to the target subscription.
  • Stap 3: U kunt de afhankelijke resources eventueel opnieuw distribueren naar verschillende resource groepen binnen het doel abonnement.Step 3: Optionally, redistribute the dependent resources to different resource groups within the target subscription.

Verplaatsen validerenValidate move

De verplaatsingsbewerking valideren kunt u het testen van uw scenario verplaatsen zonder daadwerkelijk de resources te verplaatsen.The validate move operation lets you test your move scenario without actually moving the resources. Gebruik deze bewerking om te controleren of de verplaatsing slaagt.Use this operation to check if the move will succeed. Validatie wordt automatisch aangeroepen wanneer u een verplaatsings aanvraag verzendt.Validation is automatically called when you send a move request. Gebruik deze bewerking alleen als u de resultaten vooraf moet bepalen.Use this operation only when you need to predetermine the results. Als u wilt deze bewerking uitvoeren, moet u de:To run this operation, you need the:

  • naam van de resourcegroepname of the source resource group
  • Resource-ID van de doelresourcegroepresource ID of the target resource group
  • Resource-ID van elke resource verplaatsenresource ID of each resource to move
  • de toegangstoken voor uw accountthe access token for your account

De volgende aanvraag verzenden:Send the following request:

POST https://management.azure.com/subscriptions/<subscription-id>/resourceGroups/<source-group>/validateMoveResources?api-version=2019-05-10
Authorization: Bearer <access-token>
Content-type: application/json

Met een aanvraagtekst:With a request body:

{
 "resources": ["<resource-id-1>", "<resource-id-2>"],
 "targetResourceGroup": "/subscriptions/<subscription-id>/resourceGroups/<target-group>"
}

Als de aanvraag is ingedeeld, retourneert de bewerking:If the request is formatted correctly, the operation returns:

Response Code: 202
cache-control: no-cache
pragma: no-cache
expires: -1
location: https://management.azure.com/subscriptions/<subscription-id>/operationresults/<operation-id>?api-version=2018-02-01
retry-after: 15
...

De statuscode 202 geeft aan dat de validatieaanvraag is geaccepteerd, maar deze nog niet nog bepaald als de bewerking voor verplaatsen slaagt.The 202 status code indicates the validation request was accepted, but it hasn't yet determined if the move operation will succeed. De location waarde bevat een URL die u gebruikt om de status van de langdurige bewerking te controleren.The location value contains a URL that you use to check the status of the long-running operation.

Om te controleren of de status, de volgende aanvraag te verzenden:To check the status, send the following request:

GET <location-url>
Authorization: Bearer <access-token>

Terwijl de bewerking wordt nog steeds uitgevoerd, wordt u voor het ontvangen van de statuscode 202 blijven.While the operation is still running, you continue to receive the 202 status code. Wacht het aantal seconden aangegeven in de retry-after waarde voordat u doorgaat.Wait the number of seconds indicated in the retry-after value before trying again. Als de verplaatsing is gevalideerd, ontvangt u de statuscode 204.If the move operation validates successfully, you receive the 204 status code. Als de validatie voor het verplaatsen is mislukt, ontvangt u een foutbericht weergegeven, zoals:If the move validation fails, you receive an error message, such as:

{"error":{"code":"ResourceMoveProviderValidationFailed","message":"<message>"...}}

Gebruik de portalUse the portal

Als u resources wilt verplaatsen, selecteert u de resource groep met deze resources en selecteert u vervolgens de knop verplaatsen .To move resources, select the resource group with those resources, and then select the Move button.

resources verplaatsen

Selecteer of u de resources naar een nieuwe resourcegroep of een nieuw abonnement verplaatsen wilt.Select whether you're moving the resources to a new resource group or a new subscription.

Selecteer de resources wilt verplaatsen en de resourcegroep van de bestemming.Select the resources to move and the destination resource group. Bevestig dat u wilt bijwerken scripts voor deze resources, en selecteer OK.Acknowledge that you need to update scripts for these resources and select OK. Als u het pictogram bewerken abonnement in de vorige stap hebt geselecteerd, moet u ook het doelabonnement.If you selected the edit subscription icon in the previous step, you must also select the destination subscription.

doel selecteren

In meldingen, ziet u dat de verplaatsing wordt uitgevoerd.In Notifications, you see that the move operation is running.

move-status weergeven

Wanneer deze is voltooid, krijgt u een melding van het resultaat.When it has completed, you're notified of the result.

Zet resultaten weergeven

Als er een fout optreedt, raadpleegt u problemen met het verplaatsen van Azure-resources naar een nieuwe resource groep of een nieuw abonnement.If you get an error, see Troubleshoot moving Azure resources to new resource group or subscription.

Azure PowerShell gebruikenUse Azure PowerShell

Als u bestaande resources wilt verplaatsen naar een andere resource groep of een ander abonnement, gebruikt u de opdracht Move-AzResource .To move existing resources to another resource group or subscription, use the Move-AzResource command. In het volgende voor beeld ziet u hoe u verschillende resources kunt verplaatsen naar een nieuwe resource groep.The following example shows how to move several resources to a new resource group.

$webapp = Get-AzResource -ResourceGroupName OldRG -ResourceName ExampleSite
$plan = Get-AzResource -ResourceGroupName OldRG -ResourceName ExamplePlan
Move-AzResource -DestinationResourceGroupName NewRG -ResourceId $webapp.ResourceId, $plan.ResourceId

Als u wilt verplaatsen naar een nieuw abonnement, een waarde bevatten voor de DestinationSubscriptionId parameter.To move to a new subscription, include a value for the DestinationSubscriptionId parameter.

Als er een fout optreedt, raadpleegt u problemen met het verplaatsen van Azure-resources naar een nieuwe resource groep of een nieuw abonnement.If you get an error, see Troubleshoot moving Azure resources to new resource group or subscription.

Azure CLI gebruikenUse Azure CLI

Als u bestaande resources naar een andere resourcegroep of abonnement, gebruikt u de verplaatsen van de az resource opdracht.To move existing resources to another resource group or subscription, use the az resource move command. Geef de resource-id's van de resources te verplaatsen.Provide the resource IDs of the resources to move. In het volgende voor beeld ziet u hoe u verschillende resources kunt verplaatsen naar een nieuwe resource groep.The following example shows how to move several resources to a new resource group. In de --ids parameter, Geef een door spaties gescheiden lijst van de resource-id's te verplaatsen.In the --ids parameter, provide a space-separated list of the resource IDs to move.

webapp=$(az resource show -g OldRG -n ExampleSite --resource-type "Microsoft.Web/sites" --query id --output tsv)
plan=$(az resource show -g OldRG -n ExamplePlan --resource-type "Microsoft.Web/serverfarms" --query id --output tsv)
az resource move --destination-group newgroup --ids $webapp $plan

Als u wilt verplaatsen naar een nieuw abonnement, bieden de --destination-subscription-id parameter.To move to a new subscription, provide the --destination-subscription-id parameter.

Als er een fout optreedt, raadpleegt u problemen met het verplaatsen van Azure-resources naar een nieuwe resource groep of een nieuw abonnement.If you get an error, see Troubleshoot moving Azure resources to new resource group or subscription.

REST API gebruikenUse REST API

Als u bestaande resources wilt verplaatsen naar een andere resource groep of een ander abonnement, gebruikt u de bewerking resources verplaatsen .To move existing resources to another resource group or subscription, use the Move resources operation.

POST https://management.azure.com/subscriptions/{source-subscription-id}/resourcegroups/{source-resource-group-name}/moveResources?api-version={api-version}

In de hoofdtekst van de aanvraag geeft u de doelresourcegroep die is en de resources te verplaatsen.In the request body, you specify the target resource group and the resources to move.

{
 "resources": ["<resource-id-1>", "<resource-id-2>"],
 "targetResourceGroup": "/subscriptions/<subscription-id>/resourceGroups/<target-group>"
}

Als er een fout optreedt, raadpleegt u problemen met het verplaatsen van Azure-resources naar een nieuwe resource groep of een nieuw abonnement.If you get an error, see Troubleshoot moving Azure resources to new resource group or subscription.

Volgende stappenNext steps

Zie ondersteuning voor het verplaatsen van resources voor bronnenvoor een lijst met resources die kunnen worden verplaatst.For a list of which resources support move, see Move operation support for resources.