クイック スタート: API を使用して VM 復元ポイントを作成する

Azureコンピューティング REST API を使用して、同じリージョンまたはリージョン間で、VM のアプリケーション整合性またはクラッシュ整合性の復元ポイントを作成します。

API リファレンス: ポイントの復元 | ストア ポイント コレクション | PowerShell

前提条件

• VM 復元ポイントの要件の詳細をご覧ください。
• 復元ポイントを作成する前に、 サポート要件 と 制限事項 を確認してください。

VM 復元ポイントの作成

次のセクションでは、Azure コンピューティング REST API を使用して VM 復元ポイントを作成するために必要な手順について説明します。

詳細については、復元ポイント、PowerShell、および復元ポイント コレクションに関する API ドキュメントを参照してください。

手順 1: VM 復元ポイント コレクションを作成する

復元ポイント コレクションは、VM のすべての復元ポイントを保持する親リソースです。

Restore Point Collections — Create or Update API を呼び出す:

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/restorePointCollections/{collectionName}?api-version=2025-04-01

リクエストボディ:

  {
    "location": "<region>",
    "properties": {
      "source": {
        "id": "<VM Arm Id>"
      },
      "instantAccess": true
    }
  }

• locationローカル コレクションの VM のリージョン、またはリージョン間コレクションのターゲット リージョンに設定します (また、ソース復元ポイント コレクションの ARM リソース ID をsource.idに含めます)。
• 必要に応じて、インスタント アクセスを有効にするには、propertiesに"instantAccess": trueを追加します。 この設定は、コレクションに作成されたすべての復元ポイントに適用されます。 API バージョン 2025-04-01 以降が 必要です。 この設定は、Premium SSD v2 ディスクと Ultra ディスクを データ ディスクとして使用する VM にのみ適用されます。

手順 2: VM 復元ポイントを作成する

復元ポイントを呼び出 す - 手順 1 で作成したコレクション内に API を作成します。

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/restorePointCollections/{collectionName}/restorePoints/{restorePointName}?api-version=2025-04-01

リクエストボディ:

  {
    "name": "<restorePointName>",
    "properties": {
     "instantAccessDurationMinutes": 120,
      "provisioningState": "Succeeded",
    }
  }

注: instantAccessDurationMinutes は省略可能なパラメーターです。 既定値は 300 (5 時間) です。 小さい値に設定できますが、300 以下に設定できます。 これは将来の復元ポイントに適用され、既に作成されている既存の復元ポイントには適用されません。

主なリクエスト本文のプロパティ:

手順 3: VM 復元ポイントの作成の状態を追跡する

ローカル復元ポイント は数秒以内に完了します。 復元ポイントの provisioningState を確認します。復元ポイントは Creating から Succeeded (または Failed) に遷移します。

リージョン間の復元ポイント は、実行時間の長い操作です。 復元ポイントをポーリングする —$expand=instanceViewを使用して API を取得し、ディスクごとのコピーの進行状況 (completionPercent) を確認します。 復元ポイントは、すべてのディスク復元ポイントのレプリケーションが完了した後にのみ使用できます。

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/restorePointCollections/{collectionName}/restorePoints/{restorePointName}?$expand=instanceView&api-version=2025-04-01

インスタント アクセスの状態: コレクションでインスタント アクセスが有効になっている場合は、復元ポイント instantAccessState チェックして、すべてのディスク復元ポイントの統合アクセス状態を検証します。 InstantAccessまたはAvailableWithInstantAccessの値は、復元ポイントがディスクの高速復元の準備ができている状態であることを意味します。 個々のディスク復元ポイントの状態を調べる必要がある場合にのみ、instanceViewでディスクごとのsnapshotAccessStateを使用します。

手順 4: インスタント アクセスを無効にする

VM で有効になっている IA を無効にするには、次の REST API 呼び出しを使用します。

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/restorePointCollections/{restorePointCollectionName}?api-version=2025-04-01

リクエストボディ:

  {
    "location": "<region>",
    "properties": {
      "source": {
        "id": "<VM Arm Id>"
      },
      "instantAccess": false
    }
  }

次のステップ

• 復元ポイントの管理に関する詳細は、こちらをご覧ください。
• Azure ポータル、CLI、または PowerShell を使用して復元ポイントを作成します。
• Azureの仮想マシンのバックアップと復元のオプションに関する詳細を参照してください。