Delen via

Back-upbeleid voor Azure Recovery Services maken met behulp van REST API

  • Artikel

In dit artikel wordt beschreven hoe u beleid maakt voor de back-up van azure-VM, SQL-database in Azure VM, SAP HANA-database in Azure VM en Azure-bestandsshare.

Meer informatie over het maken of wijzigen van een back-upbeleid voor een Azure Recovery Services-kluis met behulp van REST API.

Een beleid maken of bijwerken

Gebruik de volgende PUT-bewerking om een Azure Backup-beleid te maken of bij te werken.

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

De {policyName} en {vaultName} worden opgegeven in de URI. Aanvullende informatie vindt u in de aanvraagbody.

De hoofdtekst van de aanvraag maken

Als u een beleid wilt maken voor azure VM-back-up, moet de aanvraagbody de volgende onderdelen hebben:

Naam Vereist Type Description
properties Waar ProtectionPolicy:AzureIaaSVMProtectionPolicy ProtectionPolicyResource-eigenschappen
tags Object Resourcetags

Zie het rest API-artikel over back-upbeleid voor de volledige lijst met definities in de aanvraagbody.

Voorbeeld van aanvraagbody

Deze sectie bevat de voorbeeldtekst van de aanvraag voor het maken van beleid voor het maken van een back-up van azure-VM, SQL-database in Azure VM, SAP HANA-database in Azure VM en Azure-bestandsshare.

Kies een gegevensbron:

De volgende aanvraagbody definieert een standaardback-upbeleid voor Azure VM-back-ups.

Dit beleid:

  • Maakt een wekelijkse back-up elke maandag, woensdag, donderdag om 10:00 uur Pacific Standard Time.
  • Behoudt de back-ups die op elke maandag, woensdag, donderdag voor één week zijn gemaakt.
  • Behoudt de back-ups die worden gemaakt op elke eerste woensdag en derde donderdag van een maand gedurende twee maanden (overschrijft de vorige bewaarvoorwaarden, indien van toepassing).
  • Behoudt de back-ups die zijn gemaakt op vierde maandag en vierde donderdag in februari en november gedurende vier jaar (overschrijft de vorige bewaarvoorwaarden, indien van toepassing).
{
  "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"
        }
      }
    }
  }
}

De volgende aanvraagbody definieert een verbeterd back-upbeleid voor Azure VM-back-ups die meerdere back-ups per dag maken.

Dit beleid:

  • Maakt elke 4 uur een back-up vanaf 13:30 UUR UTC elke dag
  • Behoudt momentopname van direct herstel gedurende 7 dagen
  • Bewaart de dagelijkse back-ups gedurende 180 dagen
  • Behoudt de back-ups die op de zondag van elke week gedurende 12 weken zijn gemaakt
  • Behoudt de back-ups die zijn gemaakt op de eerste zondag van elke maand gedurende 12 maanden
{
	"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
	}
}

Belangrijk

De tijdnotaties voor planning en retentie ondersteunen alleen DateTime. Ze ondersteunen geen tijdnotatie alleen.

Antwoorden

Het maken/bijwerken van het back-upbeleid is een asynchrone bewerking. Dit betekent dat met deze bewerking een andere bewerking wordt gemaakt die afzonderlijk moet worden bijgehouden.

Er worden twee antwoorden geretourneerd: 202 (Geaccepteerd) wanneer er een andere bewerking wordt gemaakt. Vervolgens 200 (OK) wanneer deze bewerking is voltooid.

Name Type Description
200 OK Beveiligingsbeleidresource OK
202 Geaccepteerd Geaccepteerd

Voorbeeldantwoorden

Nadat u de PUT-aanvraag voor het maken of bijwerken van het beleid hebt ingediend, is het eerste antwoord 202 (geaccepteerd) met een locatieheader of Azure-async-header.

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

Volg vervolgens de resulterende bewerking met behulp van de locatieheader of Azure-AsyncOperation-header met een eenvoudige GET-opdracht .

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

Zodra de bewerking is voltooid, wordt 200 (OK) geretourneerd met de beleidsinhoud in de hoofdtekst van het antwoord.

{
  "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
  }
}

Als een beleid al wordt gebruikt om een item te beveiligen, resulteert elke update in het beleid in het wijzigen van de beveiliging voor al deze gekoppelde items.

Volgende stappen

Schakel beveiliging in voor een niet-beveiligde Azure-VM.

Zie de volgende documenten voor meer informatie over de REST API's van Azure Backup: