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

2025-01-18

本文介绍如何使用 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 并且 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 的详细信息，请参阅以下文档：

通过