Dela via

Skapa säkerhetskopieringsprinciper för Azure Recovery Services med hjälp av REST API

Den här artikeln beskriver hur du skapar principer för säkerhetskopiering av virtuella Azure-datorer, SQL-databas i virtuella Azure-datorer, SAP HANA-databas i virtuella Azure-datorer och Azure Files.

Läs mer om att skapa eller ändra en säkerhetskopieringsprincip för ett Azure Recovery Services-valv med hjälp av REST API.

Skapa eller uppdatera en princip

Om du vill skapa eller uppdatera en Azure Backup-princip använder du följande PUT-åtgärd .

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

{policyName} och {vaultName} finns angivna i URI:n. Ytterligare information finns i begärandetexten.

Skapa begärandetexten

Om du vill skapa en princip för säkerhetskopiering av virtuella Azure-datorer måste begärandetexten ha följande komponenter:

Namn Krävs Typ Beskrivning
egenskaper Sann ProtectionPolicy:AzureIaaSVMProtectionPolicy Egenskaper för skyddspolicyresurs
Taggar Objekt Resurstaggar

Den fullständiga listan över definitioner i begärandetexten finns i artikeln REST API för säkerhetskopieringsprincip.

Exempel på begärandetext

Det här avsnittet innehåller exempeltexten för begäran om att skapa principer för säkerhetskopiering av virtuella Azure-datorer, SQL-databas i virtuella Azure-datorer, SAP HANA-databas i virtuella Azure-datorer och Azure Files.

Välj en datakälla:

Följande begärandetext definierar en standardprincip för säkerhetskopiering av virtuella Azure-datorer.

Den här principen:

  • Gör en veckovis säkerhetskopiering varje måndag, onsdag, torsdag kl. 10:00 Pacific Standard Time.
  • Behåller de säkerhetskopior som görs varje måndag, onsdag, torsdag i en vecka.
  • Behåller de säkerhetskopior som görs varje första onsdag och tredje torsdag i en månad i två månader (åsidosätter eventuella tidigare kvarhållningsvillkor).
  • Behåller de säkerhetskopior som gjordes den fjärde måndagen och den fjärde torsdagen i februari och november i fyra år (åsidosätter eventuella tidigare kvarhållningsvillkor).
{
  "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"
        }
      }
    }
  }
}

Följande begärandetext definierar en förbättrad säkerhetskopieringsprincip för säkerhetskopiering av virtuella Azure-datorer som skapar flera säkerhetskopior om dagen.

Den här principen:

  • Tar en säkerhetskopia var 4:e timme från 15:30 UTC varje dag
  • Behåller ögonblicksbild av omedelbar återställning i 7 dagar
  • Behåller de dagliga säkerhetskopiorna i 180 dagar
  • Behåller de säkerhetskopior som tas på söndagen i varje vecka i 12 veckor
  • Behåller de säkerhetskopior som görs den första söndagen i varje månad i 12 månader
{
	"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
	}
}

Viktigt!

Tidsformaten för schema och kvarhållning stöder endast DateTime. De stöder inte enbart tidsformat.

Svaren

Skapandet/uppdateringen av säkerhetskopieringsprincipen är en asynkron åtgärd. Det innebär att den här åtgärden skapar en annan åtgärd som måste spåras separat.

Den returnerar två svar: 202 (accepterad) när en annan åtgärd skapas. Sedan 200 (OK) när åtgärden är klar.

Namn Typ Beskrivning
200 OK SkyddspolicyResource OK
202 Accepterad Har godkänts

Exempelsvar

När du skickar PUT-begäran om att skapa eller uppdatera principen är det första svaret 202 (accepterad) med en platsrubrik eller 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

Spåra sedan den resulterande åtgärden med hjälp av platsrubriken eller Azure-AsyncOperation-huvudet med ett enkelt GET-kommando .

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

När åtgärden är klar returneras 200 (OK) med principinnehållet i svarstexten.

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

Om en princip redan används för att skydda ett objekt resulterar alla uppdateringar i principen i att skyddet för alla sådana associerade objekt ändras.

Nästa steg

Aktivera skydd för en oskyddad virtuell Azure-dator.

Mer information om REST-API:er för Azure Backup finns i följande dokument: