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

[アーティクル]
04/13/2024

この記事では、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 コンテナーでは、管理オーバーヘッドを最小限に抑えながら、バックアップデータを簡単に整理できます。

開始する前に

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 について詳しくは、次のドキュメントをご覧ください。

次の方法で共有