Udostępnij za pośrednictwem

Tworzenie zasad tworzenia kopii zapasowych usługi Azure Recovery Services przy użyciu interfejsu API REST

  • Artykuł

W tym artykule opisano sposób tworzenia zasad tworzenia kopii zapasowych maszyn wirtualnych platformy Azure, bazy danych SQL na maszynie wirtualnej platformy Azure, bazy danych SAP HANA na maszynie wirtualnej platformy Azure i udziału plików platformy Azure.

Dowiedz się więcej o tworzeniu lub modyfikowaniu zasad tworzenia kopii zapasowych dla magazynu usługi Azure Recovery Services przy użyciu interfejsu API REST.

Tworzenie lub aktualizowanie zasad

Aby utworzyć lub zaktualizować zasady usługi Azure Backup, użyj następującej operacji PUT .

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

Identyfikator {policyName} i {vaultName} są podane w identyfikatorze URI. Dodatkowe informacje znajdują się w treści żądania.

Tworzenie treści żądania

Jeśli chcesz utworzyć zasady kopii zapasowej maszyny wirtualnej platformy Azure, treść żądania musi mieć następujące składniki:

Nazwisko Wymagania Type Opis
właściwości Prawda ProtectionPolicy:AzureIaaSVMProtectionPolicy Właściwości ProtectionPolicyResource
tags Objekt Tagi zasobów

Aby uzyskać pełną listę definicji w treści żądania, zobacz artykuł dotyczący interfejsu API REST zasad kopii zapasowych.

Przykładowa treść żądania

Ta sekcja zawiera przykładowe treść żądania tworzenia zasad tworzenia kopii zapasowej maszyny wirtualnej platformy Azure, bazy danych SQL na maszynie wirtualnej platformy Azure, bazy danych SAP HANA na maszynie wirtualnej platformy Azure i udziału plików platformy Azure.

Wybierz źródło danych:

Poniższa treść żądania definiuje standardowe zasady tworzenia kopii zapasowych dla kopii zapasowych maszyn wirtualnych platformy Azure.

Te zasady:

  • Wykonuje cotygodniową kopię zapasową co poniedziałek, środę, czwartek o godzinie 10:00 czasu pacyficznego (czas standardowy).
  • Zachowuje kopie zapasowe wykonywane w każdy poniedziałek, środa, czwartek przez jeden tydzień.
  • Zachowuje kopie zapasowe wykonywane co pierwszą środę i trzeci czwartek miesiąca przez dwa miesiące (zastępuje poprzednie warunki przechowywania, jeśli istnieją).
  • Zachowuje kopie zapasowe wykonane w czwarty poniedziałek i czwarty czwartek w lutym i listopadzie przez cztery lata (zastępuje poprzednie warunki przechowywania, jeśli istnieją).
{
  "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"
        }
      }
    }
  }
}

Poniższa treść żądania definiuje rozszerzone zasady tworzenia kopii zapasowych dla kopii zapasowych maszyn wirtualnych platformy Azure tworzących wiele kopii zapasowych dziennie.

Te zasady:

  • Wykonuje kopię zapasową co 4 godziny od 15:30 UTC codziennie
  • Zachowuje migawkę natychmiastowego odzyskiwania przez 7 dni
  • Zachowuje codzienne kopie zapasowe przez 180 dni
  • Zachowuje kopie zapasowe wykonywane w niedzielę każdego tygodnia przez 12 tygodni
  • Zachowuje kopie zapasowe wykonywane w pierwszą niedzielę każdego miesiąca przez 12 miesięcy
{
	"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
	}
}

Ważne

Formaty czasu dla harmonogramu i przechowywania obsługują tylko datę/godzinę. Nie obsługują one formatu czasowego.

Odpowiedzi

Tworzenie/aktualizowanie zasad kopii zapasowych jest operacją asynchroniczną. Oznacza to, że ta operacja tworzy inną operację, która musi być śledzona oddzielnie.

Zwraca dwie odpowiedzi: 202 (Zaakceptowane) podczas tworzenia innej operacji. Następnie 200 (OK) po zakończeniu tej operacji.

Nazwisko Pisz Opis
200 OK Zasady ochronyŹródło OK
Zaakceptowano 202 Zaakceptowano

Przykładowe odpowiedzi

Po przesłaniu żądania PUT do utworzenia lub zaktualizowania zasad początkowa odpowiedź to 202 (Zaakceptowane) z nagłówkiem lokalizacji lub nagłówkiem 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

Następnie śledź wynikową operację przy użyciu nagłówka lokalizacji lub nagłówka Azure-AsyncOperation za pomocą prostego polecenia GET .

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

Po zakończeniu operacji zwraca ona wartość 200 (OK) z zawartością zasad w treści odpowiedzi.

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

Jeśli zasady są już używane do ochrony elementu, każda aktualizacja w zasadach spowoduje zmodyfikowanie ochrony wszystkich skojarzonych elementów.

Następne kroki

Włącz ochronę niechronionej maszyny wirtualnej platformy Azure.

Aby uzyskać więcej informacji na temat interfejsów API REST usługi Azure Backup, zobacz następujące dokumenty: