Azure リソースを新しいリソースグループまたはサブスクリプションに移動する

[アーティクル]
04/24/2023

この記事では、Azure リソースを別の Azure サブスクリプションまたは同じサブスクリプションの別のリソースグループに移動する方法について説明します。リソースの移動には、Azure portal、Azure PowerShell、Azure CLI、または REST API を使用できます。

移動操作の間は、ソースグループとターゲットグループの両方がロックされます。これらのリソースグループに対する書き込み操作および削除操作は、移動が完了するまでブロックされます。このロックはリソースグループでリソースを追加、更新、削除できなくなることを意味します。リソースが停止されるわけではありません。たとえば、Azure SQL 論理サーバー、そのサーバーのデータベース、そのサーバーに依存している他のリソースを新しいリソースグループやサブスクリプションに移動しても、そのデータベースを使用するアプリケーションにダウンタイムは発生しません。引き続きデータベースの読み取りと書き込みを行うことができます。ロックは最大 4 時間継続できますが、ほとんどの移動は、はるかに短い時間で完了します。

移動を行うものに依存しているリソースを新たに設定し直すことが必要な場合は、再設定を済ますまで、それらのサービスが中断されます。

リソースを移動しても、新しいリソースグループまたはサブスクリプションに移動されるだけです。リソースの場所は変わりません。

変更されたリソース ID

リソースを移動すると、そのリソース ID は変更されます。リソース ID の標準形式は /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} です。リソースを新しいリソースグループまたはサブスクリプションに移動するときは、そのパス内の 1 つ以上の値を変更します。

リソース ID を任意の場所で使用する場合、その値を変更する必要があります。たとえば、ポータル内にリソース ID を参照するカスタムダッシュボードがある場合は、その値を更新する必要があります。新しいリソース ID のために更新する必要があるスクリプトまたはテンプレートを探します。

リソースの移動前のチェックリスト

リソースを移動する前に行うべき重要な手順がいくつかあります。これらの条件を確認することにより、エラーの発生を回避できます。

移動元と移動先のサブスクリプションがアクティブである必要があります。無効になっているアカウントを有効にするときに問題がある場合は、Azure サポートリクエストを作成します。問題の種類として [サブスクリプション管理] を選択します。
移動元と移動先のサブスクリプションは、同じ Microsoft Entra テナント内に存在している必要があります。両方のサブスクリプションに同じテナント ID があることを確認するには、Azure PowerShell または Azure CLI を使用します。

Azure PowerShell では、次を使用します。
```
(Get-AzSubscription -SubscriptionName <your-source-subscription>).TenantId
(Get-AzSubscription -SubscriptionName <your-destination-subscription>).TenantId
```
Azure CLI では、次を使用します。
```
az account show --subscription <your-source-subscription> --query tenantId
az account show --subscription <your-destination-subscription> --query tenantId
```
移動元と移動先のサブスクリプションのテナント ID が同じでない場合、次の方法でテナント ID を調整する必要があります。
- Azure サブスクリプションの所有権を別のアカウントに譲渡する
- Azure サブスクリプションを Microsoft Entra ID に関連付けるまたは追加する方法
クラウドソリューションプロバイダー (CSP) パートナーとの間でリソースを移動する場合は、「サブスクライバーと CSP の間で Azure サブスクリプションを転送する」を参照してください。
移動するリソースは、移動操作をサポートしているリソースである必要があります。移動をサポートしているリソースのリストは、「Move operation support for resources」(リソースの移動操作のサポート) を参照してください。
一部のサービスには、リソースを移動するときに特定の制限または要件があります。次のサービスのいずれかを移動する場合は、移動の前にそのガイダンスを確認してください。
- Azure Stack Hub を使用している場合は、グループ間でリソースを移動することはできません。
- App Services の移動ガイダンス
- Azure DevOps Services の移動ガイダンス
- クラシックデプロイモデルの移動ガイダンス - Classic Compute、Classic Storage、Classic Virtual Networks、Cloud Services
- Cloud Services (延長サポート) の移動ガイダンス
- ネットワークの移動ガイダンス
- Recovery Services の移動ガイダンス
- 仮想マシンの移動ガイダンス
- Azure サブスクリプションを新しい管理グループに移動するには、「サブスクリプションの移動」を参照してください。
移動するリソースのリソースプロバイダーについて、移動先のサブスクリプションに登録する必要があります。登録しないと、 リソースの種類についてサブスクリプションへの登録が行われていないことを示すエラーが発生します。このエラーは、リソースを新しいサブスクリプションに移動するが、そのサブスクリプションがそのリソースの種類で使用されたことがない場合に発生する可能性があります。

PowerShell で登録状態を取得するには、次のコマンドを使用します。
```
Set-AzContext -Subscription <destination-subscription-name-or-id>
Get-AzResourceProvider -ListAvailable | Select-Object ProviderNamespace, RegistrationState
```
リソースプロバイダーを登録するには、次のコマンドを使用します。
```
Register-AzResourceProvider -ProviderNamespace Microsoft.Batch
```
Azure CLI で登録状態を取得するには、次のコマンドを使用します。
```
az account set -s <destination-subscription-name-or-id>
az provider list --query "[].{Provider:namespace, Status:registrationState}" --out table
```
リソースプロバイダーを登録するには、次のコマンドを使用します。
```
az provider register --namespace Microsoft.Batch
```
リソースを移動する前に、リソースの移動先となるサブスクリプションのサブスクリプションクォータをチェックします。リソースを移動することでサブスクリプションが制限を上回る場合、クォータの引き上げを要求できるかどうかを確認する必要があります。制限の一覧と引き上げを要求する方法については、「Azure サブスクリプションとサービスの制限、クォータ、制約」を参照してください。
リソースを動かすアカウントには少なくとも次のアクセス許可を与える必要があります。
- ソースリソースグループの Microsoft.Resources/subscriptions/resourceGroups/moveResources/action。
- ターゲットリソースグループの Microsoft.Resources/subscriptions/resourceGroups/write。
Azure ロールがリソース (または子リソース) に直接割り当てられているリソースを移動する場合、ロールの割り当ては移動されず、孤立します。移動した後は、ロールの割り当てを再作成する必要があります。最終的に、孤立したロールの割り当ては自動的に削除されますが、移動する前にロールの割り当てを削除することをお勧めします。

ロールの割り当てを管理する方法の詳細については、Azure ロールの割り当ての一覧表示に関するセクションおよび Azure ロールを割り当てる方法に関するページを参照してください。
サブスクリプション間で移動を行う場合は、リソースとその依存リソースを同じリソースグループ内に配置し、それらを一緒に移動する必要があります。たとえば、マネージドディスクを備えた VM では、マネージドディスクを他の依存リソースと共に、VM と一緒に移動する必要があります。

リソースを新しいサブスクリプションに移動する場合は、そのリソースに依存リソースがあるかどうか、およびそれらが同じリソースグループ内に置かれているかどうかを確認します。それらのリソースが同じリソースグループ内にない場合は、同じリソースグループに統合することができるかどうかを確認します。その場合は、リソースグループ間の移動操作を使用して、該当するすべてのリソースを同じリソースグループに配置します。

詳細については、「サブスクリプション間での移動のシナリオ」を参照してください。

サブスクリプション間での移動のシナリオ

サブスクリプション間でリソースを移動するには、次の 3 つの手順を行います。

Diagram that shows the three-step process of moving resources across subscriptions.

説明のため、依存リソースを 1 つだけ取り上げます。

手順 1:依存リソースが別々のリソースグループに分散されている場合は、まずそれらを 1 つのリソースグループに移動します。
手順 2:リソースと依存リソースを、ソースサブスクリプションからターゲットサブスクリプションにまとめて移動します。
手順 3:必要に応じて、依存リソースをターゲットサブスクリプション内の別々のリソースグループに再配布します。

ポータルの使用

リソースを移動するには、それらのリソースが含まれているリソースグループを選択します。

移動するリソースを選択する。すべてのリソースを移動するには、一覧の上部にあるチェックボックスをオンにします。または、リソースを個別に選択します。

Screenshot of the Azure portal showing the selection of resources to move.

[移動] ボタンを選択します。

Screenshot of the Azure portal displaying the Move button with three options.

このボタンにより、次の 3 つのオプションが提示されます。

新しいリソースグループに移動します。
新しいサブスクリプションに移動します。
新しいリージョンに移動します。リージョンを変更する方法については、「リージョン間でのリソースの移動 (リソースグループから)」を参照してください。

リソースを新しいリソースグループに移動するか新しいサブスクリプションに移動するかを選択します。

ソースリソースグループが自動的に設定されます。移動先のリソースグループを指定します。新しいサブスクリプションに移行する場合は、サブスクリプションも指定します。 [次へ] を選択します。

Screenshot of the Azure portal where the user specifies the destination resource group for the move operation.

ポータルでは、リソースを移動できると検証されます。検証の完了を待ちます。

Screenshot of the Azure portal showing the validation process for the move operation.

検証が正常に完了したら、 [次へ] を選択します。

そのリソースのツールとスクリプトを更新する必要があること確認します。リソースの移動を開始するには、 [移動] を選択します。

Screenshot of the Azure portal where the user acknowledges the need to update tools and scripts before starting the move operation.

移動が完了すると、結果が通知されます。

Screenshot of the Azure portal displaying a notification with the results of the move operation.

Azure PowerShell の使用

検証

実際にリソースを移動せずに移動シナリオをテストするには、AzResourceAction コマンドを使用します。このコマンドは、結果を事前に確認する必要がある場合にのみ使用してください。

$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 $sourceResourceGroup.ResourceId `
   -Parameters @{
      resources = $resources.ResourceId;  # Wrap in an @() array if providing a single resource ID string.
      targetResourceGroup = $destinationResourceGroup.ResourceId
   }

検証に成功した場合、出力は表示されません。

検証が失敗した場合は、リソースを移動できない理由を説明するエラーメッセージが表示されます。

詳細ビュー

既存のリソースを別のリソースグループまたはサブスクリプションに移動するには、Move-AzResource コマンドを使用します。次の例では、いくつかのリソースを新しいリソースグループに移動する方法を示します。

$sourceName = "sourceRG"
$destinationName = "destinationRG"
$resourcesToMove = @("app1", "app2")

$resources = Get-AzResource -ResourceGroupName $sourceName | Where-Object { $_.Name -in $resourcesToMove }

Move-AzResource -DestinationResourceGroupName $destinationName -ResourceId $resources.ResourceId

新しいサブスクリプションに移動する場合は、DestinationSubscriptionId パラメーターの値を含めます。

Azure CLI の使用

検証

実際にリソースを移動せずに移動シナリオをテストするには、az resource invoke-action コマンドを使用してください。このコマンドは、結果を事前に確認する必要がある場合にのみ使用してください。この操作を実行するには、次の要件を満たす必要があります。

ソースリソースグループのリソース ID
ターゲットリソースグループのリソース ID
移動する各リソースのリソース ID

要求本文で、\" を使用して二重引用符をエスケープします。

az resource invoke-action --action validateMoveResources \
  --ids "/subscriptions/{subscription-id}/resourceGroups/{source-rg}" \
  --request-body "{  \"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}\" }"

検証に成功した場合、以下のようになります。

{} Finished ..

検証が失敗した場合は、リソースを移動できない理由を説明するエラーメッセージが表示されます。

詳細ビュー

既存のリソースを別のリソースグループまたはサブスクリプションに移動するには、az resource move コマンドを使用します。 --ids パラメーターには、移動するリソース ID のスペース区切りリストを指定します。

次の例では、いくつかのリソースを新しいリソースグループに移動する方法を示します。 Bash ターミナルで Azure CLI を使うときに機能します。

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

次の例は、PowerShell コンソールで同じコマンドを実行する方法を示しています。

$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

新しいサブスクリプションに移動するには、--destination-subscription-id パラメーターを指定します。

Python の使用

検証

実際にリソースを移動することなく移動シナリオをテストするには、ResourceManagementClient.resources.begin_validate_move_resources メソッドを使用します。このメソッドは、結果を事前に確認する必要がある場合にのみ使用してください。

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))

検証に成功した場合、出力は表示されません。

検証が失敗した場合は、リソースを移動できない理由を説明するエラーメッセージが表示されます。

詳細ビュー

既存のリソースを別のリソースグループまたはサブスクリプションに移動するには、ResourceManagementClient.resources.begin_move_resources メソッドを使用します。次の例では、いくつかのリソースを新しいリソースグループに移動する方法を示します。

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
    }
)

REST API を使用する

検証

移動の検証操作を使用すると、実際にリソースを移動することなく、必要な移動のシナリオをテストすることができます。この操作は、正常に移動されるかどうかを確認する目的で使用します。移動要求を送信すると、検証が自動的に呼び出されます。この操作は、結果を事前に確認する必要がある場合にのみ使用してください。この操作を実行するには、次の要件を満たす必要があります。

ソースリソースグループの名前
ターゲットリソースグループのリソース ID
移動する各リソースのリソース ID
アカウントのアクセストークン

次の要求を送信します。

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

要求本文:

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

要求が正しい形式になっていれば、次の応答が操作から返されます。

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
...

状態コード 202 は、検証要求が受け付けられたものの、移動操作に成功するかどうかの判断はまだ出ていないことを示します。 location 値には、長時間実行される操作の状態をチェックするための URL が格納されます。

状態をチェックするには、次の要求を送信します。

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

操作が実行されている間は、継続的に状態コード 202 が返されます。 retry-after 値に示されている時間 (秒) が経過するのを待って再試行してください。移動操作の検証が正常に完了すると、状態コード 204 が返されます。移動の検証に失敗した場合は、次のようなエラーメッセージが返されます。

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

詳細ビュー

既存のリソースを別のリソースグループまたはサブスクリプションに移動するには、リソースの移動操作を使用します。

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

要求の本文で、ターゲットリソースグループと、移動するリソースを指定します。

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

よく寄せられる質問

質問: 通常数分で終わるはずのリソースの移動で、既に 1 時間近くかかっています。何か問題がありますか。

リソースの移動は、さまざまなフェーズを持つ複雑な操作です。移動しようとしているリソースのリソースプロバイダー以外のものが関与している可能性があります。リソースプロバイダー間の依存関係を理由に、Azure Resource Manager では操作が完了するまで時間として 4 時間が許容されています。この期間によって、リソースプロバイダーは一時的な問題から復旧する機会を与えられています。移動要求が 4 時間以内である場合、操作は完了する試みを続けるため、まだ成功する可能性があります。この期間中、移動元のリソースグループと移動先のリソースグループは一貫性の問題を回避するためにロックされます。

質問: リソースの移動中に、リソースグループが 4 時間ロックされるのはなぜですか?

移動要求の完了には、最大 4 時間の猶予が与えられます。移動中のリソースに対する変更を防ぐために、リソースの移動中は、ソースとターゲットの両方のリソースグループがロックされます。

移動要求には 2 つのフェーズがあります。最初のフェーズでは、リソースが移動されます。 2 番目のフェーズでは、移動中のリソースに依存している他のリソースプロバイダーに通知が送信されます。リソースプロバイダーがいずれかのフェーズで失敗した場合、リソースグループが 4 時間にわたってロックされる可能性があります。許容時間中、Resource Manager では失敗したステップが再試行されます。

4 時間の内にリソースを移動できなかった場合、Resource Manager によって両方のリソースグループのロックが解除されます。正常に移動されたリソースは、移動先のリソースグループ内にあります。移動に失敗したリソースは、移動元のリソースグループに残ります。

質問: リソースの移動中に移動元のリソースグループと移動先のリソースグループがロックされると、どのような影響がありますか?

このロックにより、いずれのリソースグループも削除できなくなり、いずれのリソースグループにも新しいリソースを作成できなくなり、移動に関与するリソースを削除することもできなくなります。

次の図は、進行中の移動の一部であるリソースグループをユーザーが削除しようとした場合に Azure portal から返されるエラーメッセージを示しています。

Screenshot of the Azure portal showing an error message when trying to delete a resource group involved in an ongoing move operation.

質問: "MissingMoveDependentResources" というエラーコードはどういう意味ですか?

リソースを移動する場合は、その依存リソースが、移動先のリソースグループまたはサブスクリプションに存在しているか、または移動要求に含まれている必要があります。依存リソースがこの要件を満たしていない場合は、MissingMoveDependentResources エラーコードが返されます。エラーメッセージには、移動要求に含める必要がある依存リソースに関する詳細が含まれています。

たとえば、仮想マシンを移動には、3 つの異なるリソースプロバイダーと、7 つのリソースの種類を移動することが必要な場合があります。それらのリソースプロバイダーとリソースの種類を次に示します。

Microsoft.Compute
- virtualMachines
- disks
Microsoft.Network
- networkInterfaces
- publicIPAddresses
- networkSecurityGroups
- virtualNetworks
Microsoft.Storage
- storageAccounts

もう 1 つの一般的な例として、仮想ネットワークの移動があります。その仮想ネットワークに関連付けられている他のいくつかのリソースを移動することが必要になる場合があります。移動要求には、パブリック IP アドレス、ルートテーブル、仮想ネットワークゲートウェイ、ネットワークセキュリティグループなどの移動が必要になる場合があります。一般に、仮想ネットワークゲートウェイは常に仮想ネットワークと同じリソースグループ内に存在する必要があります。個別に移動することはできません。

質問: エラーコード "RequestDisallowedByPolicy" は何を意味しますか?

Resource Manager は、移動を試行する前に、移動要求を検証します。この検証には、移動に関連するリソースで定義されているポリシーのチェックが含まれます。たとえば、キーコンテナーを移動しようとしても、組織にターゲットリソースグループへのキーコンテナーの作成を拒否するポリシーがある場合、検証は失敗し、移動はブロックされます。返されるエラーコードは RequestDisallowedByPolicy です。

ポリシーの詳細については、「Azureポリシーとは」を参照してください。

質問: Azure 内の一部のリソースを移動できないのはなぜですか?

現時点では、Azure 内のすべてのリソースが移動するわけではありません。移動をサポートしているリソースのリストについては、「リソースの移動操作のサポート」」を参照してください。

質問: 1 回の操作で移動できるリソースの数はどのくらいですか?

可能であれば、大規模な移動は個別の移動操作に分けます。 1 回の操作に含まれるリソースが 800 を超えると、Resource Manager から直ちにエラーが返されます。ただし、800 未満のリソースの移動でも、タイムアウトで失敗になることがあります。

質問: リソースが正常な状態にないというエラーの意味は何ですか?

リソースが正常な状態にないために移動できないことを示すエラーメッセージが表示された場合、実際に移動をブロックしているのは依存リソースであることがあります。通常、エラーコードは MoveCannotProceedWithResourcesNotInSucceededState です。

ソースまたはターゲットのリソースグループに仮想ネットワークが含まれている場合は、移動中に仮想ネットワークのすべての依存リソースの状態が確認されます。この確認には、仮想ネットワークに直接的または間接的に依存するそのようなリソースが含まれます。これらのリソースのいずれかがエラー状態の場合、移動はブロックされます。たとえば、仮想ネットワークを使用する仮想マシンで障害が発生した場合、移動はブロックされます。移動は、仮想マシンが移動するリソースの 1 つではなく、移動用のリソースグループのいずれにも存在しない場合でもブロックされます。

このエラーが発生した場合は、2 つの選択肢があります。仮想ネットワークのないリソースグループにリソースを移動するか、サポートにお問い合わせください。

次のステップ

移動をサポートしているリソースのリストは、「Move operation support for resources」(リソースの移動操作のサポート) を参照してください。

Azure リソースを新しいリソース グループまたはサブスクリプションに移動する

変更されたリソース ID

リソースの移動前のチェック リスト

サブスクリプション間での移動のシナリオ

ポータルの使用

Azure PowerShell の使用

検証

詳細ビュー

Azure CLI の使用

検証

詳細ビュー

Python の使用

検証

詳細ビュー

REST API を使用する

検証

詳細ビュー

よく寄せられる質問

次のステップ

その他のリソース

Azure リソースを新しいリソースグループまたはサブスクリプションに移動する

リソースの移動前のチェックリスト