REST API を使用して Azure Backup 用の Azure Recovery Services コンテナーを作成する

2025-01-17

この記事では、REST API を使って Azure Recovery Services コンテナーを作成する方法を説明します。 Azure portal を使ったコンテナーの作成については、こちらの記事をご覧ください。

Recovery Services コンテナーは、データを格納する Azure のストレージエンティティです。データは通常、データのコピーであるか、仮想マシン (VM)、ワークロード、サーバー、ワークステーションのいずれかの構成情報です。 Recovery Services コンテナーを使用すると、IaaS VM (Linux または Windows) や Azure VM 内の SQL Server などのさまざまな Azure サービスのバックアップデータを保持できます。 Recovery Services コンテナーは、System Center DPM、Windows Server、Azure Backup Server などをサポートします。 Recovery Services コンテナーでは、管理オーバーヘッドを最小限に抑えながら、バックアップデータを簡単に整理できます。

開始する前に

Recovery Services コンテナーの作成を開始する前に、次の詳細を確認してください。

コンテナーの作成プロセスでは、api-version=2016-06-01 が使用されます。
REST API を使った Azure Recovery Services コンテナーの作成の概要は、コンテナー作成 REST API に関する記事で説明されています。この記事を参考にして、West US に testVault という名前のコンテナーを作成してみましょう。

Azure Recovery Services コンテナーを作成または更新するには、次の PUT 操作を使います。

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}?api-version=2016-06-01

要求を作成する

PUT 要求を作成するには、{subscription-id} パラメーターが必要です。複数のサブスクリプションをお持ちの場合は､Working with multiple subscriptionsを参照してください｡リソースの {resourceGroupName} と {vaultName} を api-version パラメーターと共に定義します。この記事では、api-version=2016-06-01 を使用します。

次のヘッダーは必須です｡

要求ヘッダー	説明
Content-Type:	必須。 `application/json` を設定します。
Authorization:	必須。有効な `Bearer`アクセストークンを設定します。

要求の作成方法の詳細については、「Components of a REST API request/response」(REST API 要求/応答のコンポーネント) を参照してください。

要求本文を作成する

要求本文を作成するには、以下の一般的な定義が使用されます。

名前	Required	タイプ	説明
eTag		String	省略可能な eTag
___location	true	String	リソースの場所
properties		VaultProperties	コンテナーのプロパティ
sku		SKU	各 Azure リソースの一意のシステム ID を示します
tags		Object	リソースタグ

コンテナー名とリソースグループ名は PUT URI で提供することに注意してください。要求本文では場所を定義します。

要求本文の例

次の例の本体を使うと、West US にコンテナーが作成されます。場所を指定します。 SKU は常に Standard です。

{
  "properties": {},
  "sku": {
    "name": "Standard"
  },
  "___location": "West US"
}

応答

Recovery Services コンテナーの作成または更新操作には、2 種類の成功応答があります。

名前	種類	説明
200 OK	コンテナー	[OK]
201 Created	コンテナー	作成済み

REST API の応答の詳細については、「Process the response message」(応答メッセージを処理する) を参照してください。

応答の例

前の要求本文の例からの圧縮された 201 Created 応答では、ID が割り当てられ、provisioningState が Succeeded であることが示されています。

{
  "___location": "westus",
  "name": "testVault",
  "properties": {
    "provisioningState": "Succeeded"
  },
  "id": "/subscriptions/77777777-b0c6-47a2-b37c-d8e65a629c18/resourceGroups/Default-RecoveryServices-ResourceGroup/providers/Microsoft.RecoveryServices/vaults/testVault",
  "type": "Microsoft.RecoveryServices/vaults",
  "sku": {
    "name": "Standard"
  }
}

次のステップ

このコンテナーに Azure VM をバックアップするためのバックアップポリシーを作成します。

Azure REST API について詳しくは、次のドキュメントをご覧ください。