你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

使用 Azure 数据保护 REST API 将 Azure blob 还原到时间点

2025-06-19

本文描述如何使用 REST API 通过 Azure 备份服务还原 Blob 数据。还可以使用 Azure 门户、 Azure PowerShell、 Azure CLI 通过 Azure 备份还原 Azure Blob。

重要

在继续使用 Azure 备份来还原 Azure blob 之前，请参阅要点。

先决条件

本文假定你已为一个或多个存储帐户配置了备份。了解如何为块 Blob 数据配置备份（如尚未配置）。

为展示本文中的还原步骤，我们将引用资源组 msblobbackup-f2df34eb-5628-4570-87b2-0331d797c67d 下受现有备份保管库 TestBkpVault 保护的名为 testBkpVaultRG 的存储帐户中的 blob。

准备 Azure Blob 还原

现可对 Azure Blob 的操作备份和保管备份执行还原操作。

选择备份层：

操作备份
保管备份

提取还原的有效时间范围

由于 blob 的操作备份是连续的，因此没有要从中还原的不同点。相反，我们需要提取可以将 blob 还原到任何时间点的有效时间范围。在此示例中，我们检查过去 30 天内有效的还原时间范围。

可以使用查找可还原的时间范围 API 列出可还原的时间范围。它是一个 POST API，可触发操作来计算存储帐户中 blob 的连续备份范围。

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataProtection/backupVaults/{vaultName}/backupInstances/{backupInstanceName}/findRestorableTimeRanges?api-version=2021-01-01

在示例中，这转换为

POST https://management.azure.com/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx/resourceGroups/TestBkpVaultRG/providers/Microsoft.DataProtection/backupVaults/testBkpVault/backupInstances/msblobbackup-f2df34eb-5628-4570-87b2-0331d797c67d/findRestorableTimeRanges?api-version=2021-01-01

创建请求正文以提取有效的还原时间范围

若要触发操作来计算有效时间范围，下面显示了请求正文的组成部分。

名称	类型	说明
源数据存储类型	RestoreSourceDataStoreType	包含要还原的数据的数据存储
开始时间	字符串	用于列出还原范围请求的开始时间。采用 ISO 8601 格式。
结束时间	字符串	用于列出还原范围请求的结束时间。采用 ISO 8601 格式。

用于提取有效时间范围的示例请求正文

以下请求正文可定义提取可还原的连续数据的时间范围所需的属性。由于 blob 备份驻留在存储帐户中，因此数据存储为“可操作”。你可以提供开始时间和结束时间，以帮助缩短搜索过程并返回可用的时间范围。

{
  "sourceDataStoreType": "OperationalStore",
  "startTime": "",
  "endTime": ""
}

针对提取有效时间范围的响应

提交 POST 请求后，响应为 200(OK)，其中包含在请求的特定开始和结束时间段内，可还原的范围的开始和结束时间。

名称	类型	说明
200（确定）	AzureBackupFindRestorableTimeRangesResponseResource	确定
其他状态代码	CloudError	描述操作失败原因的错误响应。

针对提取有效时间范围的示例响应

HTTP/1.1 200 OK
Content-Length: 379
Content-Type: application/json
Expires: -1
Pragma: no-cache
X-Content-Type-Options: nosniff
x-ms-request-id:
Strict-Transport-Security: max-age=31536000; includeSubDomains
x-ms-ratelimit-remaining-subscription-writes: 1199
x-ms-correlation-request-id: a2b7c2d9-01f5-499a-b521-55da4862c79a
x-ms-routing-request-id: CENTRALUSEUAP:20210708T184646Z:4996a2bf-2df8-48a7-9b53-a552466a27f7
Cache-Control: no-cache
Date: Thu, 08 Jul 2021 18:46:45 GMT
Server: Microsoft-IIS/10.0
X-Powered-By: ASP.NET

{
  "id": "msblobbackup-f2df34eb-5628-4570-87b2-0331d797c67d",
  "type": "Microsoft.DataProtection/backupVaults/backupInstances/findRestorableTimeRanges",
  "properties": {
    "restorableTimeRanges": [
      {
        "startTime": "2021-07-06T18:46:45.947728Z",
        "endTime": "2021-07-08T18:46:45.9932408Z",
        "objectType": "RestorableTimeRange"
      }
    ],
    "objectType": "AzureBackupFindRestorableTimeRangesResponse"
  }
}

修复同一存储帐户的还原时间点之后，有多个还原选项。

选项 1：将所有 Blob 还原到某时间点

如果使用此选项，则会通过将存储帐户中的所有块 blob 回滚到选定的时间点来还原这些 blob。包含大量数据或见证高流失率的存储帐户可能需要更长的时间才能还原。

构造所有 blob 的时间点还原的请求正文

在这种情况下，需记住的要点是：

还原发生在同一存储帐户上，这意味着要还原的目标对象与源数据源相同。这反映在下面的还原目标信息部分中。
这些是连续备份，因此还原时间是一个时间点，而不是非重复的恢复点。
将还原所有 blob
备份所在的源数据存储是相同的存储帐户。因此，源数据存储是“可操作的”数据存储。

{
  "restoreRequestObject": {
    "objectType": "AzureBackupRecoveryTimeBasedRestoreRequest",
    "restoreTargetInfo": {
      "objectType": "RestoreTargetInfo",
      "recoveryOption": "FailIfExists",
      "restoreLocation": "westus",
      "datasourceInfo": {
        "datasourceType": "Microsoft.Storage/storageAccounts/blobServices",
        "objectType": "Datasource",
        "resourceID": "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx/resourceGroups/RG-BlobBackup/providers/Microsoft.Storage/storageAccounts/msblobbackup",
        "resourceLocation": "westus",
        "resourceName": "msblobbackup",
        "resourceType": "Microsoft.Storage/storageAccounts",
        "resourceUri": ""
      }
    },
    "sourceDataStoreType": "OperationalStore",
    "recoveryPointTime": "2021-07-08T00:00:00.0000000Z"
  }
}

选项 2：将少量容器还原到某时间点

使用此选项，可以选择最多 10 个要还原的容器，也可以使用前缀匹配还原 blob 的子集。最多可以在一个容器内或跨多个容器指定 10 个字典范围的 blob，以在给定时间点将这些 blob 恢复到它们以前的状态。如果使用前缀，请记住以下几点：

可以使用正斜杠 (/) 来分隔容器名称和 blob 前缀
指定的范围的开始包括在内，但是不包括指定的范围。

详细了解使用前缀还原 blob 范围。

构造选定的容器或几个 blob 的时间点还原的请求正文

在这种情况下，需记住的要点是：

还原发生在同一存储帐户上，这意味着要还原的目标对象与源数据源相同。这反映在下面的还原目标信息部分中。
这些是连续备份，因此还原时间是一个时间点，而不是非重复的恢复点。
将还原存储帐户中的少数项。它们可能是具有前缀模式的容器或 blob。
备份所在的源数据存储是相同的存储帐户。因此，源数据存储是“可操作的”数据存储。

{
  "restoreRequestObject": {
    "objectType": "AzureBackupRecoveryTimeBasedRestoreRequest",
    "restoreTargetInfo": {
      "objectType": "ItemLevelRestoreTargetInfo",
      "recoveryOption": "FailIfExists",
      "restoreLocation": "westus",
      "restoreCriteria": [
        {
          "objectType": "RangeBasedItemLevelRestoreCriteria",
          "minMatchingValue": "Container1",
          "maxMatchingValue": "Container10-0"
        }
      ],
      "datasourceInfo": {
        "datasourceType": "Microsoft.Storage/storageAccounts/blobServices",
        "objectType": "Datasource",
        "resourceID": "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx/resourceGroups/RG-BlobBackup/providers/Microsoft.Storage/storageAccounts/msblobbackup",
        "resourceLocation": "westus",
        "resourceName": "msblobbackup",
        "resourceType": "Microsoft.Storage/storageAccounts",
        "resourceUri": ""
      }
    },
    "sourceDataStoreType": "OperationalStore",
    "recoveryPointTime": "2021-07-08T00:00:00.0000000Z"
  }
}

提取相关恢复点

若要列出备份实例的所有可用恢复点，请使用列出恢复点 API。

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataProtection/backupVaults/{vaultName}/backupInstances/{backupInstanceName}/recoveryPoints?api-version=2021-07-01

准备请求正文以从保管备份执行还原。

下面是从保管备份还原容器 bash 2 的请求正文。

{
  "objectType": "AzureBackupRecoveryPointBasedRestoreRequest",
  "sourceDataStoreType": "VaultStore",
  "restoreTargetInfo": {
    "objectType": "itemLevelRestoreTargetInfo",
    "recoveryOption": "FailIfExists",
    "dataSourceInfo": {
      "objectType": "Datasource",
      "resourceID": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/Blob-Backup/providers/Microsoft.Storage/storageAccounts/azclitestrestore2",
      "resourceName": "azclitestrestore2",
      "resourceType": "Microsoft.Storage/storageAccounts",
      "resourceLocation": "not specified",
      "resourceUri": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/Blob-Backup/providers/Microsoft.Storage/storageAccounts/azclitestrestore2",
      "datasourceType": "Microsoft.Storage/storageAccounts/blobServices",
      "resourceProperties": {}
    },
    "restoreCriteria": [
      {
        "objectType": "ItemPathBasedRestoreCriteria",
        "itemPath": "bash2",
        "isPathRelativeToBackupItem": true,
        "subItemPathPrefix": null
      }
    ],
    "restoreLocation": "eastus2euap"
  },
  "recoveryPointId": "33fdef0e0e2e4594b63092ae9a56f58d"
}

如果要还原具有特定前缀的 blob，请提供前缀列表作为 subItemPathPrefix 的值。下面是从备份存储帐户的 container2 中还原以前缀 dd、ee 或 ff 开头的 blob 的示例。

   {
        "is_path_relative_to_backup_item": true,
        "item_path": "container2",
        "object_type": "ItemPathBasedRestoreCriteria",
        "sub_item_path_prefix": [
          "dd",
          "ee",
          "ff"
        ]
      }

验证还原请求

准备好请求正文后，可以使用验证还原 API 对其进行验证。与验证备份 API 一样，这是 POST 操作。

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataProtection/backupVaults/{vaultName}/backupInstances/{backupInstanceName}/validateRestore?api-version=2021-01-01

对于我们的示例，这已转换为：

POST "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx/resourceGroups/TestBkpVaultRG/providers/Microsoft.DataProtection/backupVaults/testBkpVault/backupInstances/msblobbackup-f2df34eb-5628-4570-87b2-0331d797c67d/validateRestore?api-version=2021-01-01"

此处详细介绍了此 POST API 的请求正文。在上一部分中，我们针对所有 blob 还原和少数项还原方案构造了相同的内容。我们使用相同的方法来触发验证操作。

针对验证还原请求的响应

验证还原请求是一个异步操作。这意味着，此操作会创建另一个需要单独跟踪的操作。

它将返回两个响应：创建另一个操作时为 202（已接受），该操作完成时为 200（确定）。

名称	类型	说明
200 正常		验证请求的状态
202 已接受		已接受

针对还原验证请求的响应的示例

提交 POST 操作后，初始响应将为带有 Azure-asyncOperation 标头的“202 已接受”。

HTTP/1.1 202 Accepted
Content-Length: 0
Expires: -1
Pragma: no-cache
Retry-After: 10
Azure-AsyncOperation: https://management.azure.com/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx/providers/Microsoft.DataProtection/locations/westus/operationStatus/ZmMzNDFmYWMtZWJlMS00NGJhLWE4YTgtMDNjYjI4Y2M5OTExOzVlNzMxZDBiLTQ3MDQtNDkzNS1hYmNjLWY4YWEzY2UzNTk1ZQ==?api-version=2021-01-01
X-Content-Type-Options: nosniff
x-ms-request-id:
Strict-Transport-Security: max-age=31536000; includeSubDomains
x-ms-ratelimit-remaining-subscription-writes: 1199
x-ms-correlation-request-id: bae60c92-669d-45a4-aed9-8392cca7cc8d
x-ms-routing-request-id: CENTRALUSEUAP:20210708T205935Z:f51db7a4-9826-4084-aa3b-ae640dc78af6
Cache-Control: no-cache
Date: Thu, 08 Jul 2021 20:59:35 GMT
Location: https://management.azure.com/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx/providers/Microsoft.DataProtection/locations/westus/operationResults/ZmMzNDFmYWMtZWJlMS00NGJhLWE4YTgtMDNjYjI4Y2M5OTExOzVlNzMxZDBiLTQ3MDQtNDkzNS1hYmNjLWY4YWEzY2UzNTk1ZQ==?api-version=2021-01-01
X-Powered-By: ASP.NET

使用简单的 GET 请求来跟踪 Azure-AsyncOperation 标头。请求成功后，它会返回“200 正常”，并返回成功状态响应。

 GET https://management.azure.com/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx/providers/Microsoft.DataProtection/locations/westus/operationStatus/ZmMzNDFmYWMtZWJlMS00NGJhLWE4YTgtMDNjYjI4Y2M5OTExOzVlNzMxZDBiLTQ3MDQtNDkzNS1hYmNjLWY4YWEzY2UzNTk1ZQ==?api-version=2021-01-01

{
  "id": "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx/providers/Microsoft.DataProtection/locations/westus/operationStatus/ZmMzNDFmYWMtZWJlMS00NGJhLWE4YTgtMDNjYjI4Y2M5OTExOzVlNzMxZDBiLTQ3MDQtNDkzNS1hYmNjLWY4YWEzY2UzNTk1ZQ==",
  "name": "ZmMzNDFmYWMtZWJlMS00NGJhLWE4YTgtMDNjYjI4Y2M5OTExOzVlNzMxZDBiLTQ3MDQtNDkzNS1hYmNjLWY4YWEzY2UzNTk1ZQ==",
  "status": "Succeeded",
  "startTime": "2021-07-08T20:59:35.0060264Z",
  "endTime": "2021-07-08T20:59:57Z"
}

触发还原请求

触发还原操作是 POST API。此处记录了有关触发还原操作的所有详细信息。

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataProtection/backupVaults/{vaultName}/backupInstances/{backupInstanceName}/restore?api-version=2021-01-01

对于我们的示例，这已转换为：

POST "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx/resourceGroups/TestBkpVaultRG/providers/Microsoft.DataProtection/backupVaults/testBkpVault/backupInstances/msblobbackup-f2df34eb-5628-4570-87b2-0331d797c67d/restore?api-version=2021-01-01"

创建还原操作的请求正文

验证请求后，可以使用相同的请求正文触发还原请求，只需进行细微的更改。

适用于所有 blob 还原的示例请求正文

对验证还原请求正文的唯一更改是在开始时删除“restoreRequest”对象。

{
  "objectType": "AzureBackupRecoveryTimeBasedRestoreRequest",
  "restoreTargetInfo": {
    "objectType": "RestoreTargetInfo",
    "recoveryOption": "FailIfExists",
    "restoreLocation": "westus",
    "datasourceInfo": {
      "datasourceType": "Microsoft.Storage/storageAccounts/blobServices",
      "objectType": "Datasource",
      "resourceID": "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx/resourceGroups/RG-BlobBackup/providers/Microsoft.Storage/storageAccounts/msblobbackup",
      "resourceLocation": "westus",
      "resourceName": "msblobbackup",
      "resourceType": "Microsoft.Storage/storageAccounts",
      "resourceUri": ""
    }
  },
  "sourceDataStoreType": "OperationalStore",
  "recoveryPointTime": "2021-07-08T00:00:00Z"
}

适用于项或部分 blob 还原的示例请求正文