مشاركة عبر

إنشاء نهج النسخ الاحتياطي لخدمات الاسترداد Azure باستخدام واجهة برمجة تطبيقات REST

  • مقالة

توضح هذه المقالة كيفية إنشاء نهج للنسخ الاحتياطي ل Azure VM وقاعدة بيانات SQL في Azure VM وقاعدة بيانات SAP HANA في Azure VM ومشاركة ملف Azure.

تعرف على المزيد حول إنشاء نهج نسخ احتياطي أو تعديله لمخزن Azure Recovery Services باستخدام REST API.

إنشاء نهج أو تحديثه

لإنشاء نهج Azure Backup أو تحديثه، استخدم عملية PUT التالية.

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

يتم توفير {policyName} و{vaultName} في URI. يتم توفير معلومات إضافية في نص الطلب.

قم بإنشاء نص الطلب

إذا كنت ترغب في إنشاء نهج للنسخ الاحتياطي ل Azure VM، يجب أن يحتوي نص الطلب على المكونات التالية:

الاسم مطلوبة نوع ‏‏الوصف
الخصائص صواب ProtectionPolicy:AzureIaaSVMProtectionPolicy خصائص ProtectionPolicyResource
العلامات ‏‏الكائن علامات المورد

للحصول على القائمة الكاملة للتعريفات في نص الطلب، راجع مقالة واجهة برمجة تطبيقات REST لنهج النسخ الاحتياطي.

نموذج طلب النص الأساسي

يوفر هذا القسم مثال نص الطلب لإنشاء نهج للنسخ الاحتياطي ل Azure VM وقاعدة بيانات SQL في Azure VM وقاعدة بيانات SAP HANA في Azure VM ومشاركة ملف Azure.

اختر مصدر بيانات:

يحدد نص الطلب التالي نهج النسخ الاحتياطي القياسي للنسخ الاحتياطية ل Azure VM.

هذا النهج:

  • يأخذ نسخة احتياطية أسبوعية كل يوم اثنين أو أربعاء أو خميس الساعة 10:00 صباحا بتوقيت المحيط الهادئ.
  • يحتفظ بالنسخ الاحتياطية التي تم أخذها في كل اثنين وأربعاء وخميس لمدة أسبوع واحد.
  • يحتفظ بالنسخ الاحتياطية التي تم أخذها كل أول أربعاء وثالث خميس من الشهر لمدة شهرين (يتجاوز شروط الاستبقاء السابقة، إن وجدت).
  • يحتفظ بالنسخ الاحتياطية التي تم أخذها رابع إثنين ورابع خميس في فبراير ونوفمبر لمدة أربع سنوات (يتجاوز شروط الاستبقاء السابقة، إن وجدت).
{
  "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"
        }
      }
    }
  }
}

يحدد نص الطلب التالي نهج نسخ احتياطي محسن لنسخ Azure VM الاحتياطية التي تنشئ نسخا احتياطية متعددة يوميا.

هذا النهج:

  • يأخذ نسخة احتياطية كل 4 ساعات من الساعة 3:30 مساء بالتوقيت العالمي المتفق عليه يوميا
  • يحتفظ بلقطة الاسترداد الفوري لمدة 7 أيام
  • يحتفظ بالنسخ الاحتياطية اليومية لمدة 180 يوما
  • يحتفظ بالنسخ الاحتياطية التي تم أخذها في يوم الأحد من كل أسبوع لمدة 12 أسبوعا
  • يحتفظ بالنسخ الاحتياطية المأخوذة في الأحد الأول من كل شهر لمدة 12 شهرا
{
	"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
	}
}

هام

تدعم تنسيقات الوقت للجدولة والاستبقاء تنسيق DateTime فقط. لا تدعم تنسيق الوقت وحده.

الاستجابات

إنشاء/تحديث نهج النسخ الاحتياطي هي عملية غير متزامنة. وهذا يعني أن هذه العملية تنشئ عملية أخرى تحتاج إلى تعقبها بشكل منفصل.

تقوم بإرجاع استجابتين: ‎202 (Accepted) عند إنشاء عملية أخرى. ثم ‎200 (OK) عند اكتمال تلك العملية.

Name كتابة ‏‏الوصف
200 جيد Protection PolicyResource موافق
202 مقبولة مقبول

أمثلة على الردود

بمجرد إرسال طلب PUT لإنشاء نهج أو تحديثه، تكون الاستجابة الأولية 202 (Accepted) بعنوان الموقع أو عنوان Azure-async.

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

ثم تعقب العملية الناتجة باستخدام رأس الموقع أو رأس Azure-AsyncOperation مع أمر 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

بمجرد اكتمال العملية، تقوم بإرجاع 200 (موافق) مع محتوى النهج في نص الاستجابة.

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

إذا وجد نهج قيد الاستخدام بالفعل لحماية عنصر، فإن أي تحديث في النهج سيؤدي إلى تعديل الحماية لجميع العناصر المقترنة.

الخطوات التالية

تمكين الحماية لجهاز ظاهري Azure غير محمي.

للمزيد من المعلومات حول واجهات برمجة التطبيقات REST للنسخ الاحتياطي لـ Azure، راجع المستندات التالية: