Share via

REST API kullanarak Azure Kurtarma Hizmetleri yedekleme ilkeleri oluşturma

  • Makale

Bu makalede Azure VM yedeklemesi, Azure VM'de SQL veritabanı, Azure VM'de SAP HANA veritabanı ve Azure Dosya paylaşımı için ilkelerin nasıl oluşturulacağı açıklanır.

REST API kullanarak Azure Kurtarma Hizmetleri kasası için yedekleme ilkesi oluşturma veya değiştirme hakkında daha fazla bilgi edinin.

İlke oluşturma veya güncelleştirme

Azure Backup ilkesi oluşturmak veya güncelleştirmek için aşağıdaki PUT işlemini kullanın.

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

{policyName} ve{vaultName}, URI'de sağlanır. İstek gövdesinde ek bilgiler sağlanır.

İstek gövdesini oluşturma

Azure VM yedeklemesi için bir ilke oluşturmak istiyorsanız, istek gövdesinin aşağıdaki bileşenlere sahip olması gerekir:

Veri Akışı Adı Zorunlu Türü Açıklama
özellikler True ProtectionPolicy:AzureIaaSVMProtectionPolicy ProtectionPolicyResource özellikleri
tags Object Kaynak etiketleri

İstek gövdesindeki tanımların tam listesi için yedekleme ilkesi REST API makalesine bakın.

Örnek istek gövdesi

Bu bölümde, Azure VM'nin yedekleneceği ilkeler, Azure VM'deki SQL veritabanı, Azure VM'deki SAP HANA veritabanı ve Azure Dosya paylaşımı için ilkeler oluşturmak için örnek istek gövdesi sağlanır.

Veri kaynağı seçin:

Aşağıdaki istek gövdesi, Azure VM yedeklemeleri için standart bir yedekleme ilkesi tanımlar.

Bu ilke:

  • Her Pazartesi, Çarşamba, Perşembe günü Saat 10:00 Pasifik Standart Saati ile haftalık yedekleme alır.
  • Her Pazartesi, Çarşamba, Perşembe günü alınan yedeklemeleri bir hafta boyunca saklar.
  • İki ay boyunca her ayın ilk Çarşamba ve üçüncü Perşembe günü alınan yedeklemeleri korur (varsa, önceki saklama koşullarını geçersiz kılar).
  • Şubat ve Kasım aylarında dördüncü Pazartesi ve dördüncü Perşembe günleri alınan yedeklemeleri dört yıl boyunca korur (varsa, önceki saklama koşullarını geçersiz kılar).
{
  "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"
        }
      }
    }
  }
}

Aşağıdaki istek gövdesi, Azure VM yedeklemeleri için günde birden çok yedekleme oluşturan gelişmiş bir yedekleme ilkesi tanımlar.

Bu ilke:

  • Her gün 15:30 UTC'den itibaren 4 saatte bir yedekleme alır
  • Anlık kurtarma anlık görüntüsünü 7 gün boyunca korur
  • Günlük yedeklemeleri 180 gün boyunca korur
  • Her haftanın Pazar günü alınan yedeklemeleri 12 hafta boyunca saklar
  • Her ayın ilk Pazar günü alınan yedeklemeleri 12 ay boyunca korur
{
	"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
	}
}

Önemli

Zamanlama ve bekletme için saat biçimleri yalnızca DateTime'ı destekler. Yalnızca Zaman biçimini desteklemez.

Yanıtlar

Yedekleme ilkesi oluşturma/güncelleştirme zaman uyumsuz bir işlemdir. Bu, bu işlemin ayrı olarak izlenmesi gereken başka bir işlem oluşturduğu anlamına gelir.

İki yanıt döndürür: Başka bir işlem oluşturulduğunda 202 (Kabul Edildi). Ardından bu işlem tamamlandığında 200 (Tamam).

Adı Tür Açıklama
200 Tamam Koruma İlkesiKaynak Tamam
202 Kabul Edildi Kabul edildi

Örnek yanıtlar

İlke oluşturma veya güncelleştirme için PUT isteğini gönderdikten sonra, ilk yanıt konum üst bilgisi veya Azure-async-header ile 202 (Kabul Edildi) olur.

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

Ardından, basit bir GET komutuyla konum üst bilgisini veya Azure-AsyncOperation üst bilgisini kullanarak sonuçta elde edilen işlemi izleyin.

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

İşlem tamamlandıktan sonra, yanıt gövdesinde ilke içeriğiyle birlikte 200 (Tamam) döndürür.

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

Bir ilke bir öğeyi korumak için zaten kullanılıyorsa, ilkedeki herhangi bir güncelleştirme, bu tür ilişkili tüm öğeler için korumanın değiştirilmesine neden olur.

Sonraki adımlar

Korumasız bir Azure VM için korumayı etkinleştirin.

Azure Backup REST API'leri hakkında daha fazla bilgi için aşağıdaki belgelere bakın: