使用 REST API 更新 Azure 恢复服务保管库配置

本文介绍如何使用 REST API 更新 Azure 恢复服务保管库中的备份相关配置。

管理恢复服务保管库中的软删除操作

删除受保护项的备份是需要进行监控的重要操作。 为了防止意外删除，Azure 恢复服务保管库具有软删除功能。 此功能允许在删除后的一段时间内还原已删除的备份（如有必要）。

但在某些情况下，此功能不是必需的。 如果其中存在备份项，甚至软删除的备份项，则无法删除 Azure 恢复服务保管库。 如果需要立即删除保管库，这可能会带来问题。 例如：部署操作通常会在同一工作流中清理所创建的资源。 部署可以创建保管库、为项配置备份、执行测试还原，然后继续删除备份项和保管库。 如果保管库删除失败，则整个部署可能会失败。 禁用软删除是保证立即删除的唯一方法。

因此，需要根据具体场景谨慎选择对特定保管库禁用软删除功能。 详细了解 软删除。

使用 REST API 提取软删除状态

默认情况下，将为任何新建的恢复服务保管库启用软删除状态。 若要提取/更新保管库的软删除状态，请使用备份保管库的配置相关 REST API 文档

若要获取存储库当前软删除状态，请使用以下 GET 操作。

GET https://management.azure.com/Subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupconfig/vaultconfig?api-version=2019-06-15

GET URI 具有{subscriptionId}参数{vaultName}{vaultresourceGroupName}。 在此示例中， {vaultName} 为“testVault”，为 {vaultresourceGroupName} “testVaultRG”。 由于 URI 中提供了所有必需的参数，因此无需单独的请求正文。

GET https://management.azure.com/Subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/testVaultRG/providers/Microsoft.RecoveryServices/vaults/testVault/backupconfig/vaultconfig?api-version=2019-06-15

Responses

对“GET”操作的成功响应如下所示：

示例响应

提交“GET”请求后，将返回 200 个（成功）响应。

{
  "id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/testvaultRG/providers/Microsoft.RecoveryServices/vaults/testvault/backupconfig/vaultconfig",
  "name": "vaultconfig",
  "type": "Microsoft.RecoveryServices/vaults/backupconfig",
  "properties": {
    "enhancedSecurityState": "Enabled",
    "softDeleteFeatureState": "Enabled"
  }
}

使用 REST API 更新软删除状态

若要使用 REST API 更新恢复服务保管库的软删除状态，请使用以下 PUT 操作。

PUT https://management.azure.com/Subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupconfig/vaultconfig?api-version=2019-06-15

PUT URI 具有{subscriptionId}、{vaultName}、{vaultresourceGroupName}参数。 在此示例中， {vaultName} 为“testVault”，为 {vaultresourceGroupName} “testVaultRG”。 如果将 URI 替换为上述值，则 URI 将如下所示。

PUT https://management.azure.com/Subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/testVaultRG/providers/Microsoft.RecoveryServices/vaults/testVault/backupconfig/vaultconfig?api-version=2019-06-15

创建请求正文

以下常见定义用于创建请求正文

有关更多详细信息，请参阅 REST API 文档

示例请求正文

使用以下示例将软删除状态更新为“disabled”。

{
  "properties": {
    "enhancedSecurityState": "Enabled",
    "softDeleteFeatureState": "Disabled"
  }
}

PATCH操作的响应

“PATCH”操作的成功响应如下所示：

PATCH操作的示例响应

提交“PATCH”请求后，将返回 200（成功）响应。

{
  "id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/testvaultRG/providers/Microsoft.RecoveryServices/vaults/testvault/backupconfig/vaultconfig",
  "name": "vaultconfig",
  "type": "Microsoft.RecoveryServices/vaults/backupconfig",
  "properties": {
    "enhancedSecurityState": "Enabled",
    "softDeleteFeatureState": "Disabled"
  }
}

后续步骤

创建备份策略用于备份此保管库中的 Azure VM。

有关 Azure REST API 的详细信息，请参阅以下文档：

• Azure 恢复服务提供程序 REST API
• Azure REST API 入门