共用方式為

使用 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」作業的成功回應如下所示：

名稱 類型 Description
200 確定 BackupResourceVaultConfig OK
範例回應

提交「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 文件

名稱 為必填項目 類型 Description
etag 繩子 可選的 eTag
位置 true 繩子 資源位置
properties VaultProperties 保存庫的屬性
tags 物體 資源標籤

範例請求正文

使用下列範例將軟刪除狀態更新為「已停用」。

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

PATCH 操作的回應

「PATCH」作業的成功回應如下所示：

名稱 類型 Description
200 確定 BackupResourceVaultConfig OK
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 的詳細資訊，請參閱下列檔：

  • Last updated on