Freigeben über

Erstellen von Azure Recovery Services-Sicherungsrichtlinien mithilfe der REST-API

  • Artikel

In diesem Artikel erfahren Sie, wie Sie Richtlinien für die Sicherung von virtuellen Azure-Computern, SQL-Datenbanken in virtuellen Azure-Computern, SAP HANA-Datenbanken in virtuellen Azure-Computern und Azure-Dateifreigaben erstellen.

Weitere Informationen zum Erstellen oder Ändern einer Sicherungsrichtlinie für einen Azure Recovery Services-Tresor mithilfe der REST-API finden Sie hier.

Erstellen oder Aktualisieren einer Richtlinie

Verwenden Sie zum Erstellen oder Aktualisieren einer Azure Backup-Richtlinie den folgenden PUT-Vorgang:

PUT https://management.azure.com/Subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupPolicies/{policyName}?api-version=2019-05-13

Der {policyName} und der {vaultName} werden im URI angegeben. Zusätzliche Informationen werden im Anforderungstext angegeben.

Erstellen des Anforderungstexts

Wenn Sie eine Richtlinie zum Sichern virtueller Azure-Computer erstellen möchten, muss der Anforderungstext folgende Komponenten enthalten:

Name Erforderlich Type BESCHREIBUNG
properties True ProtectionPolicy:AzureIaaSVMProtectionPolicy ProtectionPolicyResource-Eigenschaften
tags Object Ressourcentags

Eine vollständige Liste der Definitionen im Anforderungstext finden Sie im REST-API-Artikel zu Sicherungsrichtlinien.

Beispiel für Anforderungstext

Dieser Abschnitt enthält den exemplarischen Anforderungstext zum Erstellen von Richtlinien für die Sicherung von virtuellen Azure-Computern, SQL-Datenbanken in virtuellen Azure-Computern, SAP HANA-Datenbanken in virtuellen Azure-Computern und Azure-Dateifreigaben.

Wählen Sie eine Datenquelle aus:

Im folgenden Anforderungstext wird eine Standardsicherungsrichtlinie für Azure-VM-Sicherungen definiert.

Diese Richtlinie:

  • Es wird jede Woche jeweils am Montag, Mittwoch und Donnerstag um 10:00 Uhr Pacific Standard Time eine Sicherungsdatei erstellt.
  • Die Sicherungsdateien, die jeweils am Montag, Mittwoch und Donnerstag erstellt werden, werden eine Woche lang beibehalten.
  • Die Sicherungsdateien, die jeden ersten Mittwoch und dritten Donnerstag eines Monats erstellt werden, werden zwei Monate lang aufbewahrt. (Vorherige Aufbewahrungsbedingungen werden überschrieben, falls vorhanden.)
  • Die Sicherungsdateien, die jeden vierten Montag und vierten Donnerstag im Februar und November erstellt werden, werden vier Jahre lang aufbewahrt. (Vorherige Aufbewahrungsbedingungen werden überschrieben, falls vorhanden.)
{
  "properties": {
    "backupManagementType": "AzureIaasVM",
    "timeZone": "Pacific Standard Time",
    "schedulePolicy": {
      "schedulePolicyType": "SimpleSchedulePolicy",
      "scheduleRunFrequency": "Weekly",
      "scheduleRunTimes": [
        "2018-01-24T10:00:00Z"
      ],
      "scheduleRunDays": [
        "Monday",
        "Wednesday",
        "Thursday"
      ]
    },
    "retentionPolicy": {
      "retentionPolicyType": "LongTermRetentionPolicy",
      "weeklySchedule": {
        "daysOfTheWeek": [
          "Monday",
          "Wednesday",
          "Thursday"
        ],
        "retentionTimes": [
          "2018-01-24T10:00:00Z"
        ],
        "retentionDuration": {
          "count": 1,
          "durationType": "Weeks"
        }
      },
      "monthlySchedule": {
        "retentionScheduleFormatType": "Weekly",
        "retentionScheduleWeekly": {
          "daysOfTheWeek": [
            "Wednesday",
            "Thursday"
          ],
          "weeksOfTheMonth": [
            "First",
            "Third"
          ]
        },
        "retentionTimes": [
          "2018-01-24T10:00:00Z"
        ],
        "retentionDuration": {
          "count": 2,
          "durationType": "Months"
        }
      },
      "yearlySchedule": {
        "retentionScheduleFormatType": "Weekly",
        "monthsOfYear": [
          "February",
          "November"
        ],
        "retentionScheduleWeekly": {
          "daysOfTheWeek": [
            "Monday",
            "Thursday"
          ],
          "weeksOfTheMonth": [
            "Fourth"
          ]
        },
        "retentionTimes": [
          "2018-01-24T10:00:00Z"
        ],
        "retentionDuration": {
          "count": 4,
          "durationType": "Years"
        }
      }
    }
  }
}

Im folgenden Anforderungstext wird eine erweiterte Sicherungsrichtlinie für Azure-VM-Sicherungen, die mehrere Sicherungen pro Tag erstellt, definiert.

Diese Richtlinie:

  • Erstellt täglich alle 4 Stunden ab 15:30 Uhr UTC eine Sicherung
  • Behält eine Momentaufnahme für die sofortige Wiederherstellung für 7 Tage bei
  • Behält die täglichen Sicherungen für 180 Tage bei
  • Behält die Sicherungen, die jede Woche Sonntag erstellt werden, 12 Wochen lang bei
  • Behält die Sicherungen, die am ersten Sonntag jedes Monats erstellt werden, 12 Monate lang bei
{
	"properties": {
		"backupManagementType": "AzureIaasVM",
		"policyType": "V2",
		"instantRPDetails": {},
		"schedulePolicy": {
			"schedulePolicyType": "SimpleSchedulePolicyV2",
			"scheduleRunFrequency": "Hourly",
			"hourlySchedule": {
				"interval": 4,
				"scheduleWindowStartTime": "2023-02-06T15:30:00Z",
				"scheduleWindowDuration": 24
			}
		},
		"retentionPolicy": {
			"retentionPolicyType": "LongTermRetentionPolicy",
			"dailySchedule": {
				"retentionTimes": [
					"2023-02-06T15:30:00Z"
				],
				"retentionDuration": {
					"count": 180,
					"durationType": "Days"
				}
			},
			"weeklySchedule": {
				"daysOfTheWeek": [
					"Sunday"
				],
				"retentionTimes": [
					"2023-02-06T15:30:00Z"
				],
				"retentionDuration": {
					"count": 12,
					"durationType": "Weeks"
				}
			},
			"monthlySchedule": {
				"retentionScheduleFormatType": "Weekly",
				"retentionScheduleWeekly": {
					"daysOfTheWeek": [
						"Sunday"
					],
					"weeksOfTheMonth": [
						"First"
					]
				},
				"retentionTimes": [
					"2023-02-06T15:30:00Z"
				],
				"retentionDuration": {
					"count": 12,
					"durationType": "Months"
				}
			}
		},
		"tieringPolicy": {
			"ArchivedRP": {
				"tieringMode": "DoNotTier",
				"duration": 0,
				"durationType": "Invalid"
			}
		},
		"instantRpRetentionRangeInDays": 7,
		"timeZone": "UTC",
		"protectedItemsCount": 0
	}
}

Wichtig

Die Uhrzeitformate für Zeitplan und Aufbewahrung unterstützen nur das DateTime-Format. Das Time-Format allein wird nicht unterstützt.

Antworten

Die Erstellung bzw. Aktualisierung von Sicherungsrichtlinien ist ein asynchroner Vorgang. Das bedeutet, dass in diesem Vorgang ein anderer Vorgang erstellt wird, der separat nachverfolgt werden muss.

Zwei Antworten werden zurückgegeben: „202 (Akzeptiert)“, wenn ein anderer Vorgang erstellt wird. „200 (OK)“, wenn dieser Vorgang abgeschlossen ist.

Name Typ BESCHREIBUNG
200 – OK ProtectionPolicyResource OK
202 – Akzeptiert Zulässig

Beispielantworten

Nachdem Sie die PUT-Anforderung für die Erstellung oder Aktualisierung der Richtlinie gesendet haben, wird als erste Antwort 202 (Zulässig) mit einem location- oder Azure-async-Header zurückgegeben.

HTTP/1.1 202 Accepted
Pragma: no-cache
Retry-After: 60
Azure-AsyncOperation: https://management.azure.com/Subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/SwaggerTestRg/providers/Microsoft.RecoveryServices/vaults/testVault/backupPolicies/testPolicy1/operations/00000000-0000-0000-0000-000000000000?api-version=2016-06-01
X-Content-Type-Options: nosniff
x-ms-request-id: db785be0-bb20-4598-bc9f-70c9428b170b
x-ms-client-request-id: e1f94eef-9b2d-45c4-85b8-151e12b07d03; e1f94eef-9b2d-45c4-85b8-151e12b07d03
Strict-Transport-Security: max-age=31536000; includeSubDomains
x-ms-ratelimit-remaining-subscription-writes: 1199
x-ms-correlation-request-id: db785be0-bb20-4598-bc9f-70c9428b170b
x-ms-routing-request-id: SOUTHINDIA:20180521T073907Z:db785be0-bb20-4598-bc9f-70c9428b170b
Cache-Control: no-cache
Date: Mon, 21 May 2018 07:39:06 GMT
Location: https://management.azure.com/Subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/SwaggerTestRg/providers/Microsoft.RecoveryServices/vaults/testVault/backupPolicies/testPolicy1/operationResults/00000000-0000-0000-0000-000000000000?api-version=2019-05-13
X-Powered-By: ASP.NET

Verfolgen Sie anschließend den resultierenden Vorgang mithilfe des location- oder Azure-AsyncOperation-Headers mit einem einfachen GET-Befehl nach.

GET https://management.azure.com/Subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/SwaggerTestRg/providers/Microsoft.RecoveryServices/vaults/testVault/backupPolicies/testPolicy1/operationResults/00000000-0000-0000-0000-000000000000?api-version=2019-05-13

Wenn der Vorgang abgeschlossen ist, wird 200 (OK) mit dem Richtlinieninhalt im Antworttext zurückgegeben.

{
  "id": "/Subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/SwaggerTestRg/providers/Microsoft.RecoveryServices/vaults/testVault/backupPolicies/testPolicy1",
  "name": "testPolicy1",
  "type": "Microsoft.RecoveryServices/vaults/backupPolicies",
  "properties": {
    "backupManagementType": "AzureIaasVM",
    "schedulePolicy": {
      "schedulePolicyType": "SimpleSchedulePolicy",
      "scheduleRunFrequency": "Weekly",
      "scheduleRunDays": [
        "Monday",
        "Wednesday",
        "Thursday"
      ],
      "scheduleRunTimes": [
        "2018-01-24T10:00:00Z"
      ],
      "scheduleWeeklyFrequency": 0
    },
    "retentionPolicy": {
      "retentionPolicyType": "LongTermRetentionPolicy",
      "weeklySchedule": {
        "daysOfTheWeek": [
          "Monday",
          "Wednesday",
          "Thursday"
        ],
        "retentionTimes": [
          "2018-01-24T10:00:00Z"
        ],
        "retentionDuration": {
          "count": 1,
          "durationType": "Weeks"
        }
      },
      "monthlySchedule": {
        "retentionScheduleFormatType": "Weekly",
        "retentionScheduleWeekly": {
          "daysOfTheWeek": [
            "Wednesday",
            "Thursday"
          ],
          "weeksOfTheMonth": [
            "First",
            "Third"
          ]
        },
        "retentionTimes": [
          "2018-01-24T10:00:00Z"
        ],
        "retentionDuration": {
          "count": 2,
          "durationType": "Months"
        }
      },
      "yearlySchedule": {
        "retentionScheduleFormatType": "Weekly",
        "monthsOfYear": [
          "February",
          "November"
        ],
        "retentionScheduleWeekly": {
          "daysOfTheWeek": [
            "Monday",
            "Thursday"
          ],
          "weeksOfTheMonth": [
            "Fourth"
          ]
        },
        "retentionTimes": [
          "2018-01-24T10:00:00Z"
        ],
        "retentionDuration": {
          "count": 4,
          "durationType": "Years"
        }
      }
    },
    "timeZone": "Pacific Standard Time",
    "protectedItemsCount": 0
  }
}

Wenn eine Richtlinie bereits zum Schutz eines Elements verwendet wird, führt ein Update in der Richtlinie zur Änderung des Schutzes für alle zugeordneten Elemente.

Nächste Schritte

Aktivieren Sie den Schutz für eine nicht geschützte Azure-VM (siehe Sichern einer Azure-VM mit Azure Backup über die REST-API).

Weitere Informationen zu den Azure Backup-REST-APIs finden Sie in den folgenden Dokumenten: