使用适用于 Azure 备份的 REST API 创建 Azure 恢复服务保管库

本文介绍如何使用 REST API 创建 Azure 恢复服务保管库。 若要使用 Azure 门户创建保管库,请参阅此文章

恢复服务保管库是 Azure 中用于存储数据的存储实体。 数据通常是虚拟机 (VM)、工作负荷、服务器或工作站的数据或配置信息的副本。 可以使用恢复服务保管库为各种 Azure 服务(例如 IaaS VM(Linux 或 Windows))和 Azure VM 中的 SQL Server 存储备份数据。 恢复服务保管库支持 System Center DPM、Windows Server、Azure 备份服务器等。 使用恢复服务保管库可以方便地组织备份数据,并将管理开销降至最低。

开始之前

在开始创建恢复服务保管库之前,请查看以下详细信息:

  • 保管库创建过程使用 api-version=2016-06-01
  • 使用 REST API 创建 Azure 恢复服务保管库的过程在创建保管库 REST API 一文中有概述。 让我们使用本文作为参考来在 West US 中创建名为 testVault 的保管库。

若要创建或更新 Azure 恢复服务保管库,请使用以下 PUT 操作:

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

创建请求

若要创建 PUT 请求,必须使用 {subscription-id} 参数。 如果拥有多个订阅,请参阅使用多个订阅。 你将定义资源的 {resourceGroupName}{vaultName} 以及 api-version 参数。 本文使用的是 api-version=2016-06-01

以下标头是必需的:

请求标头 说明
Content-Type: 必需。 设置为 application/json
Authorization: 必需。 设置为有效的Bearer访问令牌

有关如何创建请求的详细信息,请参阅 REST API 请求/响应的组件

创建请求正文

下面的通用定义用来构建请求正文:

名称 必需 类型​​ 说明
eTag String 可选的 eTag
___location String 资源位置
properties VaultProperties 保管库的属性
sku Sku 指明每个 Azure 资源的唯一系统标识符
标记 Object 资源标记

请注意,保管库名称和资源组名称是在 PUT URI 中提供的。 请求正文定义位置。

示例请求正文

以下示例正文用来在 West US 中创建一个保管库。 指定位置。 SKU 始终为 Standard

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

响应

对于要创建或更新恢复服务保管库的操作,有两个成功响应:

名称 Type 说明
200 正常 保管库 OK
201 Created 保管库 创建

有关 REST API 响应的详细信息,请参阅处理响应消息

示例响应

下面是前面的示例请求正文的精简后 201 Created 响应,该响应表明已分配了一个 ID 并且 provisioningStateSucceeded

{
  "___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 的详细信息,请参阅以下文档: