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

2024-08-05

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

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

准备工作

使用 REST API 创建 Azure 恢复服务保管库的过程在创建保管库 REST API 一文中有概述。让我们使用本文作为参考来在 China North 中创建名为 testVault 的保管库。

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

PUT https://management.chinacloudapi.cn/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 中提供的。请求正文定义位置。

示例请求正文

以下示例正文用来在“中国东部”区域中创建一个保管库。指定位置。 SKU 始终为“Standard”。

{
  "properties": {},
  "sku": {
    "name": "Standard"
  },
  "location": "China East"
}

响应

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

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

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

示例响应

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

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

通过