共用方式為

使用 REST API 建立磁碟的 Azure 資料保護備份原則

本文說明如何透過 REST API 建立備份原則。

Azure 磁碟備份提供了一種可為受控磁碟提供快照集生命週期管理的現成解決方案，方法是定期自動建立快照集，並使用備份原則在設定的持續時間內保留該快照集。 您無須付出基礎結構成本，便可以管理磁碟快照集，也不需要自訂指令碼或任何額外的管理負荷。 這是損毀一致的備份解決方案，會使用增量快照集進行受控磁碟的時間點備份，且支援每天多次備份。 這也是無代理程式的解決方案，不會影響生產應用程式的效能。 它支援 OS 和資料磁碟的備份和還原 (包括共用磁碟)，不論其目前是否已連接到執行中的 Azure 虛擬機器。

備份原則會幫助控管備份的保留期和排程。 備份原則每天提供多次備份。 您可以重複使用備份原則，設定將多個 Azure 磁碟備份至保存庫，或使用 REST API 建立 Azure 復原服務保存庫的備份原則。

若要建立備份磁碟的原則，請執行下列動作：

建立原則

若要建立 Azure 備份原則，請使用下列 PUT 作業：

PUT https://management.azure.com/Subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataProtection/backupVaults/{vaultName}/backupPolicies/{policyName}?api-version=2021-01-01

{policyName} 和 {vaultName} 都會在 URI 中提供。 要求本文中會提供其他資訊。

重要事項

目前不支援更新或修改現有的原則。 可以改為建立具有所需詳細資料的新原則，並將其指派給相關的備份執行個體。

建立要求本文

例如，若要建立磁碟備份的原則，要求本文需要下列元件：

名稱 必要 類型 描述
properties True BaseBackupPolicy：BackupPolicy BaseBackupPolicyResource 屬性

如需要求本文中的完整定義清單，請參閱備份原則 REST API 文件。

要求本文範例

原則規定：

  • 排程觸發程序為每 4 小時 (PT4H)。 這表示大約每間隔 4 小時會備份一次，讓備份平均分配在一天之中。
  • 您可以選擇每 4、6、8 或 12 小時的觸發間隔。 若要將備份排程為每天一次，請使用 P1D。 備份會在每天的規定時間觸發一次。
  • 資料存放區是作業存放區，因為備份位於本機，所以資料不會儲存在備份保存庫。 在作業存放區中，每個備份執行個體會儲存七天 (P7D)。
{
"properties": {
    "datasourceTypes": [
        "Microsoft.Compute/disks"
      ],
      "name": "DiskPolicy",
      "objectType": "BackupPolicy",
      "policyRules": [
        {
          "backupParameters": {
            "backupType": "Incremental",
            "objectType": "AzureBackupParams"
          },
          "dataStore": {
            "dataStoreType": "OperationalStore",
            "objectType": "DataStoreInfoBase"
          },
          "name": "BackupHourly",
          "objectType": "AzureBackupRule",
          "trigger": {
            "objectType": "ScheduleBasedTriggerContext",
            "schedule": {
              "repeatingTimeIntervals": [
                "R/2020-04-05T13:00:00+00:00/PT4H"
              ]
            },
            "taggingCriteria": [
              {
                "isDefault": true,
                "tagInfo": {
                  "id": "Default_",
                  "tagName": "Default"
                },
                "taggingPriority": 99
              }
            ]
          }
        },
        {
          "isDefault": true,
          "lifecycles": [
            {
              "deleteAfter": {
                "duration": "P7D",
                "objectType": "AbsoluteDeleteOption"
              },
              "sourceDataStore": {
                "dataStoreType": "OperationalStore",
                "objectType": "DataStoreInfoBase"
              }
            }
          ],
          "name": "Default",
          "objectType": "AzureRetentionRule"
        }
      ]
    }
}

重要事項

時間格式僅支援「日期時間」， 不支援僅有「時間」的格式。 一天中的時間表示備份開始時間，而不是備份完成的時間。

完成備份作業所需的時間取決於各種因素，包括磁碟的大小，及連續備份間的流失。 不過，Azure 磁碟備份屬於無代理程式備份，所使用的增量快照集不影響生產應用程式效能。

若要深入瞭解原則建立的詳細資訊，請參閱 Azure 磁碟備份原則文件。

附註

  • 對於屬於標準 HDD、標準 SSD 和進階 SSD SKU 的 Azure 磁碟，您可以使用每小時頻率 (1、2、4、6、8 或 12 小時) 和每日頻率來定義備份排程。
  • 針對屬於進階 V2 和 Ultra 磁碟 SKU 的 Azure 磁碟，您可以使用每小時頻率 (僅 12 小時) 和每日頻率來定義備份排程。

回應

備份原則的建立/更新是一項同步作業，並會在作業成功時傳回 OK。

名稱 類型 描述
200 確定 BaseBackupPolicyResource [確定]

範例回應

當作業完成時，它會在回應本文中傳回 200 (確定) 以及原則內容。

{
    "id": "/subscriptions/73307177-bb00-4801-bd11-894b2f2d5162/resourceGroups/RG-BV/providers/Microsoft.DataProtection/backupVaults/BV-JPE-GRS/backupPolicies/DiskBackupPolicy-03",
    "name": "DiskBackupPolicy-03",
    "type": "Microsoft.DataProtection/backupVaults/backupPolicies",
    "properties": {
        "policyRules": [
            {
                "backupParameters": {
                    "backupType": "Incremental",
                    "objectType": "AzureBackupParams"
                },
                "trigger": {
                    "schedule": {
                        "repeatingTimeIntervals": [
                            "R/2021-07-01T19:00:00+00:00/P1D"
                        ],
                      },
                    "taggingCriteria": [
                        {
                            "tagInfo": {
                                "tagName": "Default",
                                "id": "Default_"
                            },
                            "taggingPriority": 99,
                            "isDefault": true
                        }
                    ],
                    "objectType": "ScheduleBasedTriggerContext"
                },
                "dataStore": {
                    "dataStoreType": "OperationalStore",
                    "objectType": "DataStoreInfoBase"
                },
                "name": "BackupDaily",
                "objectType": "AzureBackupRule"
            },
            {
                "lifecycles": [
                    {
                        "deleteAfter": {
                            "objectType": "AbsoluteDeleteOption",
                            "duration": "P7D"
                        },
                        "targetDataStoreCopySettings": [],
                        "sourceDataStore": {
                            "dataStoreType": "OperationalStore",
                            "objectType": "DataStoreInfoBase"
                        }
                    }
                ],
                "isDefault": true,
                "name": "Default",
                "objectType": "AzureRetentionRule"
            }
        ],
        "datasourceTypes": [
            "Microsoft.Compute/disks"
        ],
        "objectType": "BackupPolicy"
    }
}

後續步驟

啟用 Azure 磁碟的保護

如需 Azure 備份 REST API 的詳細資訊，請參閱下列文章：

  • Last updated on