Sdílet prostřednictvím

Vytvoření zásad zálohování služby Azure Recovery Services pomocí rozhraní REST API

  • Článek

Tento článek popisuje, jak vytvořit zásady pro zálohování virtuálního počítače Azure, databáze SQL na virtuálním počítači Azure, databázi SAP HANA na virtuálním počítači Azure a sdílenou složku Azure.

Přečtěte si další informace o vytváření nebo úpravách zásad zálohování pro trezor služby Azure Recovery Services pomocí rozhraní REST API.

Vytvoření nebo aktualizace zásad

Pokud chcete vytvořit nebo aktualizovat zásady azure Backup, použijte následující operaci PUT .

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

Tyto identifikátory {policyName}{vaultName} jsou k dispozici v identifikátoru URI. V textu požadavku jsou k dispozici další informace.

Vytvoření textu požadavku

Pokud chcete vytvořit zásadu pro zálohování virtuálních počítačů Azure, tělo požadavku musí mít následující komponenty:

Název Požadováno Type Popis
vlastnosti True ProtectionPolicy:AzureIaaSVMProtectionPolicy Vlastnosti ProtectionPolicyResource
značky Object Značky prostředků

Úplný seznam definic v textu požadavku najdete v článku rozhraní REST API zásad zálohování.

Příklad textu požadavku

Tato část obsahuje příklad textu požadavku pro vytvoření zásad pro zálohování virtuálního počítače Azure, databáze SQL na virtuálním počítači Azure, databázi SAP HANA na virtuálním počítači Azure a sdílenou složku Azure.

Zvolte zdroj dat:

Následující text požadavku definuje standardní zásady zálohování pro zálohy virtuálních počítačů Azure.

Tato zásada:

  • Každý pondělí, středa, čtvrtek v 10:00 Tichomoří (standardní čas) trvá týdenní zálohování.
  • Uchovává zálohy pořízené každé pondělí, středa, čtvrtek po dobu jednoho týdne.
  • Uchovává zálohy pořízené každou první středu a třetí čtvrtek v měsíci po dobu dvou měsíců (pokud existují, přepíše předchozí podmínky uchovávání).
  • Uchovává zálohy pořízené čtvrtek čtvrtek v únoru a čtvrtém čtvrtek v únoru a listopadu po dobu čtyř let (pokud existují) přepíše předchozí podmínky uchovávání informací.
{
  "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"
        }
      }
    }
  }
}

Následující text požadavku definuje rozšířené zásady zálohování pro zálohy virtuálních počítačů Azure, které vytváří více záloh denně.

Tato zásada:

  • Provádí zálohování každých 4 hodin od 3:30 UTC každý den
  • Uchovává snímek okamžitého obnovení po dobu 7 dnů.
  • Uchovává denní zálohy po dobu 180 dnů.
  • Uchovává zálohy pořízené v neděli každého týdne po dobu 12 týdnů.
  • Uchovává zálohy pořízené v první neděli každého měsíce po dobu 12 měsíců.
{
	"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
	}
}

Důležité

Formáty času pro plán a uchovávání podporují pouze dateTime. Nepodporují samotný formát času.

Odpovědi

Vytvoření nebo aktualizace zásad zálohování je asynchronní operace. To znamená, že tato operace vytvoří jinou operaci, která se musí sledovat samostatně.

Vrátí dvě odpovědi: 202 (Přijato) při vytvoření jiné operace. Po dokončení této operace 200 (OK).

Name Typ Popis
200 OK Zásady ochrany – zdroj OK
202 Přijato Přijato

Ukázkové odpovědi

Po odeslání požadavku PUT pro vytvoření nebo aktualizaci zásad je počáteční odpověď 202 (Přijato) s hlavičkou umístění nebo hlavičkou 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

Pak pomocí hlavičky umístění nebo hlavičky Azure-AsyncOperation sledujte výslednou operaci pomocí jednoduchého příkazu 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 dokončení operace vrátí hodnotu 200 (OK) s obsahem zásad v textu odpovědi.

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

Pokud už zásadu používáte k ochraně položky, všechny aktualizace v zásadách způsobí úpravu ochrany všech takových přidružených položek.

Další kroky

Povolte ochranu pro nechráněný virtuální počítač Azure.

Další informace o rozhraních REST API služby Azure Backup najdete v následujících dokumentech: