النسخ الاحتياطي لـ Azure VM باستخدام النسخ الاحتياطي لـ Azure عبر REST API
توضح هذه المقالة كيفية إدارة النسخ الاحتياطية من مشاركة ملف Azure باستخدام Azure Backup عبر REST API. تكوين الحماية لأول مرة VM Azure غير محمية مسبقًا تشغيل النسخ احتياطي عند الطلب VM Azure محمية وتعديل خصائص النسخ الاحتياطي VM النسخ الاحتياطي عبر API REST كما هو موضح هنا. لحماية جهاز Azure الظاهري باستخدام مدخل Microsoft Azure، راجع هذه المقالة.
تعرف على كيفية إنشاء مخزن وإنشاء برامج تعليمية لواجهة برمجة تطبيقات REST للنهج لإنشاء خزائن وسياسات جديدة.
لنفترض أنك تريد حماية جهاز ظاهري testVM ضمن مجموعة testRG موارد إلى مخزن testVaultخدمات الاسترداد ، موجود داخل مجموعة testVaultRGالموارد ، مع النهج الافتراضي (المسمى DefaultPolicy).
قم بتكوين نسخة احتياطية لمشاركة جهاز ظاهري Azure غير محمية باستخدام REST API
اكتشاف VMs Azure غير المحمية
أولًا، يجب أن يكون القبو قادرًا على التعرف على Azure VM. يتم تشغيل هذا باستخدام عملية التحديث. إنها عملية POST غير متزامنة تضمن حصول المخزن على آخر قائمة بجميع مشاركات الأجهزة الظاهرية غير المحمية في الاشتراك الحالي و"تخزينها مؤقتًا". بمجرد أن يتم تخزين الجهاز الظاهري مؤقتًا، سوف تكون خدمات الاسترداد قادرة على الوصول إلى VM وحمايتها.
POST https://management.azure.com/Subscriptions/{subscriptionId}/resourceGroups/{vaultresourceGroupname}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupFabrics/{fabricName}/refreshContainers?api-version=2016-12-01
يحتوي POST URI على معلمات {subscriptionId} و{vaultName}و {vaultresourceGroupName}و{fabricName}. {fabricName}هو Azure. وفقًا لمثالنا، {vaultName} هو "testVault" و {vaultresourceGroupName} هو "testVaultRG". وحيث لأنه يتم تقديم جميع المعلمات المطلوبة في معرّف الموارد المنتظم، فلا داعي لهيئة طلب منفصلة.
POST https://management.azure.com/Subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testVaultRG/providers/Microsoft.RecoveryServices/vaults/testVault/backupFabrics/Azure/refreshContainers?api-version=2016-12-01
الردود على عملية التحديث
عملية "التحديث" هي عملية غير متزامنة. وهذا يعني أن هذه العملية تنشئ عملية أخرى تحتاج إلى تعقبها بشكل منفصل.
تقوم بإرجاع استجابتين: 202 (مقبول) عند إنشاء عملية أخرى، و200 (موافق) عند اكتمال تلك العملية.
| Name | كتابة | الوصف |
|---|---|---|
| 204 لا يوجد محتوى | حسنًا مع عدم إرجاع أي محتوى | |
| 202 مقبولة | مقبول |
أمثلة على الاستجابات لعملية التحديث:
بمجرد إرسال طلب POST، يتم إرجاع استجابة 202 (مقبولة).
HTTP/1.1 202 Accepted
Pragma: no-cache
Retry-After: 60
X-Content-Type-Options: nosniff
x-ms-request-id: 43cf550d-e463-421c-8922-37e4766db27d
x-ms-client-request-id: 4910609f-bb9b-4c23-8527-eb6fa2d3253f; 4910609f-bb9b-4c23-8527-eb6fa2d3253f
Strict-Transport-Security: max-age=31536000; includeSubDomains
x-ms-ratelimit-remaining-subscription-writes: 1199
x-ms-correlation-request-id: 43cf550d-e463-421c-8922-37e4766db27d
x-ms-routing-request-id: SOUTHINDIA:20180521T105701Z:43cf550d-e463-421c-8922-37e4766db27d
Cache-Control: no-cache
Date: Mon, 21 May 2018 10:57:00 GMT
Location: https://management.azure.com/subscriptions//00000000-0000-0000-0000-000000000000/resourceGroups/testVaultRG/providers/microsoft.recoveryservices/vaults/testVault/backupFabrics/Azure/operationResults/aad204aa-a5cf-4be2-a7db-a224819e5890?api-version=2019-05-13
X-Powered-By: ASP.NET
تتبع العملية الناتجة باستخدام عنوان "Location" باستخدام أمر «GET» بسيط
GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testVaultRG/providers/microsoft.recoveryservices/vaults/testVault/backupFabrics/Azure/operationResults/aad204aa-a5cf-4be2-a7db-a224819e5890?api-version=2019-05-13
بمجرد اكتشاف جميع Azure VMs، يُرجع الأمر GET استجابة 204 (بلا محتوى). يقدر المخزن الآن على اكتشاف أي VM داخل الاشتراك.
HTTP/1.1 204 NoContent
Pragma: no-cache
X-Content-Type-Options: nosniff
x-ms-request-id: cf6cd73b-9189-4942-a61d-878fcf76b1c1
x-ms-client-request-id: 25bb6345-f9fc-4406-be1a-dc6db0eefafe; 25bb6345-f9fc-4406-be1a-dc6db0eefafe
Strict-Transport-Security: max-age=31536000; includeSubDomains
x-ms-ratelimit-remaining-subscription-reads: 14997
x-ms-correlation-request-id: cf6cd73b-9189-4942-a61d-878fcf76b1c1
x-ms-routing-request-id: SOUTHINDIA:20180521T105825Z:cf6cd73b-9189-4942-a61d-878fcf76b1c1
Cache-Control: no-cache
Date: Mon, 21 May 2018 10:58:25 GMT
X-Powered-By: ASP.NET
تحديد Azure VM ذات الصلة
يمكنك تأكيد أن "caching" يتم عن طريق إدراج كافة العناصر القابلة للحماية ضمن «subscription» وتحديد موقع VM المطلوب في الاستجابة. استجابة هذه العملية أيضًا توفر لك معلومات حول كيفية تعريف Recovery Services كجهاز ظاهري. بمجرد أن تكون على دراية بالنمط، يمكنك تخطي هذه الخطوة والمتابعة مباشرة إلى تمكين الحماية.
هذه العملية هي عملية GET.
GET https://management.azure.com/Subscriptions/{subscriptionId}/resourceGroups/{vaultresourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupProtectableItems?api-version=2016-12-01&$filter=backupManagementType eq 'AzureIaasVM'
يشتمل معرف الموارد المنتظم الخاص بـ GET جميع المعلمات المطلوبة. ليس هناك حاجة إلى نص طلب إضافي.
الاستجابات للحصول على العملية
| Name | كتابة | الوصف |
|---|---|---|
| 200 جيد | WorkloadProtectableItemResourceList | موافق |
أمثلة على الاستجابات للحصول على العملية:
بمجرد إرسال طلب GET، يتم إرجاع 200 رد (موافق).
HTTP/1.1 200 OK
Pragma: no-cache
X-Content-Type-Options: nosniff
x-ms-request-id: 7c2cf56a-e6be-4345-96df-c27ed849fe36
x-ms-client-request-id: 40c8601a-c217-4c68-87da-01db8dac93dd; 40c8601a-c217-4c68-87da-01db8dac93dd
Strict-Transport-Security: max-age=31536000; includeSubDomains
x-ms-ratelimit-remaining-subscription-reads: 14979
x-ms-correlation-request-id: 7c2cf56a-e6be-4345-96df-c27ed849fe36
x-ms-routing-request-id: SOUTHINDIA:20180521T071408Z:7c2cf56a-e6be-4345-96df-c27ed849fe36
Cache-Control: no-cache
Date: Mon, 21 May 2018 07:14:08 GMT
Server: Microsoft-IIS/8.0
X-Powered-By: ASP.NET
{
"value": [
{
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testVaultRG/providers/microsoft.recoveryservices/vaults/testVault/backupFabrics/Azure/protectionContainers/IaasVMContainer;iaasvmcontainerv2;testRG;testVM/protectableItems/vm;iaasvmcontainerv2;testRG;testVM",
"name": "iaasvmcontainerv2;testRG;testVM",
"type": "Microsoft.RecoveryServices/vaults/backupFabrics/protectionContainers/protectableItems",
"properties": {
"virtualMachineId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testRG/providers/Microsoft.Compute/virtualMachines/testVM",
"virtualMachineVersion": "Compute",
"resourceGroup": "testRG",
"backupManagementType": "AzureIaasVM",
"protectableItemType": "Microsoft.Compute/virtualMachines",
"friendlyName": "testVM",
"protectionState": "NotProtected"
}
},……………..
تلميح
يقتصر عدد القيم في استجابة GET على 200 للصفحة. استخدم الحقل 'nextLink' للحصول على عنوان URL لمجموعة الردود التالية.
تحتوي الاستجابة على قائمة بجميع Azure VMs غير المحمية وكل {value} تحتوي على جميع المعلومات المطلوبة بواسطة خدمة الاسترداد من Azure لتكوين النسخة الاحتياطية. لتكوين النسخ الاحتياطي، لاحظ {name} «field»{virtualMachineId} والحقل في {properties} القسم. إنشاء متغيرين من قيم الحقول هذه كما هو مذكور أدناه.
- containerName = "iaasvmcontainer;"+
{name} - protectedItemName = "vm;"+
{name} {virtualMachineId}يستخدم لاحقًا في نص الطلب
في المثال، تترجم القيم أعلاه إلى:
- containerName = "iaasvmcontainer;iaasvmcontainerv2;testRG;testVM"
- protectedItemName = "vm;iaasvmcontainerv2;testRG;testVM"
تمكين الحماية لجهاز Azure الظاهري
بعد أن يتم "cached" و "identified" لـ VM ذات الصلة، حدد نهج الحماية. لمعرفة المزيد حول النهج الحالية في المخزن، ارجع إلى قائمة «Policy API». ثم حدد «relevant policy»بالإشارة إلى اسم النهج. لإنشاء النهج، ارجع إلى «create» البرنامج التعليمي للنهج. يتم تحديد "DefaultPolicy" في المثال أدناه.
تمكين الحماية هو عملية PUT غير متزامنة تنشئ "عنصرًا محميًّا".
https://management.azure.com/Subscriptions/{subscriptionId}/resourceGroups/{vaultresourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupFabrics/{fabricName}/protectionContainers/{containerName}/protectedItems/{protectedItemName}?api-version=2019-05-13
تم إنشاء {containerName} و{protectedItemName} كما شيد أعلاه. {fabricName}هو Azure. على سبيل المثال، هذا يترجم إلى:
PUT https://management.azure.com/Subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testVaultRG/providers/Microsoft.RecoveryServices/vaults/testVault/backupFabrics/Azure/protectionContainers/iaasvmcontainer;iaasvmcontainerv2;testRG;testVM/protectedItems/vm;iaasvmcontainerv2;testRG;testVM?api-version=2019-05-13
قم بإنشاء نص الطلب
لإنشاء نسخة احتياطية، فيما يلي مكونات نص الطلب.
| Name | كتابة | الوصف |
|---|---|---|
| الخصائص | AzureIaaSVMProtectedItem | خصائص الموارد المحمية |
للحصول على قائمة كاملة بتعريفات نص الطلب وتفاصيل أخرى، راجع «create» مستند عنصر محمي REST API.
مثال على نص الطلب:
يحدد نص الطلب التالي الخصائص المطلوبة لإنشاء عنصر محمي.
{
"properties": {
"protectedItemType": "Microsoft.Compute/virtualMachines",
"sourceResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testRG/providers/Microsoft.Compute/virtualMachines/testVM",
"policyId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testVaultRG/providers/microsoft.recoveryservices/vaults/testVault/backupPolicies/DefaultPolicy"
}
}
{sourceResourceId}هو المذكور أعلاه من {virtualMachineId}الاستجابة لقائمة العناصر القابلة للحماية.
الاستجابات لإنشاء عملية عنصر محمي @01011011
الاستجابات لإنشاء عملية الصنف المحمي
يُعد إنشاء عنصر محمي بمثابة عملية غير متزامنة. وهذا يعني أن هذه العملية تنشئ عملية أخرى تحتاج إلى تعقبها بشكل منفصل.
تقوم بإرجاع استجابتين: 202 (مقبول) عند إنشاء عملية أخرى، و200 (موافق) عند اكتمال تلك العملية.
| Name | كتابة | الوصف |
|---|---|---|
| 200 جيد | ProtectedItemResource | موافق |
| 202 مقبولة | مقبول |
أمثلة على الاستجابات لإنشاء عملية عنصر محمي:
بمجرد إرسال طلب PUT لإنشاء عنصر محمي أو تحديثه، تكون الاستجابة الأولية 202 (مقبولة) بعنوان الموقع أو عنوان مزامنة Azure.
HTTP/1.1 202 Accepted
Pragma: no-cache
Retry-After: 60
Azure-AsyncOperation: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testVaultRG/providers/microsoft.recoveryservices/vaults/testVault/backupFabrics/Azure/protectionContainers/iaasvmcontainer;iaasvmcontainerv2;testRG;testVM/protectedItems/vm;testRG;testVM/operationsStatus/a0866047-6fc7-4ac3-ba38-fb0ae8aa550f?api-version=2019-05-13
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/testVaultRG/providers/microsoft.recoveryservices/vaults/testVault/backupFabrics/Azure/protectionContainers/iaasvmcontainer;iaasvmcontainerv2;testRG;testVM/protectedItems/vm;testRG;testVM/operationResults/a0866047-6fc7-4ac3-ba38-fb0ae8aa550f?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/testVaultRG/providers/microsoft.recoveryservices/vaults/testVault/backupFabrics/Azure/protectionContainers/iaasvmcontainer;iaasvmcontainerv2;testRG;testVM/protectedItems/vm;testRG;testVM/operationsStatus/a0866047-6fc7-4ac3-ba38-fb0ae8aa550f?api-version=2019-05-13
بمجرد اكتمال العملية، تقوم بإرجاع 200 (موافق) مع محتوى العنصر المحمي في نص الاستجابة.
{
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testVaultRG/providers/microsoft.recoveryservices/vaults/testVault/backupFabrics/Azure/protectionContainers/iaasvmcontainer;iaasvmcontainerv2;testRG;testVM/protectedItems/vm;testRG;testVM",
"name": "VM;testRG;testVM",
"type": "Microsoft.RecoveryServices/vaults/backupFabrics/protectionContainers/protectedItems",
"properties": {
"friendlyName": "testVM",
"virtualMachineId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testRG/providers/Microsoft.Compute/virtualMachines/testVM",
"protectionStatus": "Healthy",
"protectionState": "IRPending",
"healthStatus": "Passed",
"lastBackupStatus": "",
"lastBackupTime": "2001-01-01T00:00:00Z",
"protectedItemDataId": "17592691116891",
"extendedInfo": {
"recoveryPointCount": 0,
"policyInconsistent": false
},
"protectedItemType": "Microsoft.Compute/virtualMachines",
"backupManagementType": "AzureIaasVM",
"workloadType": "VM",
"containerName": "iaasvmcontainerv2;testRG;testVM",
"sourceResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testRG/providers/Microsoft.Compute/virtualMachines/testVM",
"policyId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testVaultRG/providers/microsoft.recoveryservices/vaults/testVault/backupPolicies/DefaultPolicy",
"policyName": "DefaultPolicy"
}
}
يؤكد هذا تمكين الحماية للجهاز الظاهري، وسيتم تشغيل النسخة الاحتياطية الأولى وفقًا لجدول النهج.
باستثناء الأقراص في النسخ الاحتياطي لـ Azure VM
يوفر Azure Backup أيضا طريقة لنسخ مجموعة فرعية من الأقراص احتياطيا بشكل انتقائي في Azure VM. يتم توفير المزيد من التفاصيل هنا. إذا كنت ترغب في إجراء نسخ احتياطي انتقائي لعدد قليل من الأقراص أثناء تمكين الحماية، يجب أن يكون مقتطف التعليمات البرمجية التالي هو نص الطلب أثناء تمكين الحماية.
{
"properties": {
"protectedItemType": "Microsoft.Compute/virtualMachines",
"sourceResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testRG/providers/Microsoft.Compute/virtualMachines/testVM",
"policyId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testVaultRG/providers/microsoft.recoveryservices/vaults/testVault/backupPolicies/DefaultPolicy",
"extendedProperties": {
"diskExclusionProperties":{
"diskLunList":[0,1],
"isInclusionList":true
}
}
}
}
في نص الطلب أعلاه، يتم توفير قائمة الأقراص التي سيتم إجراء إجراء الأقراص الاحتياطية في مقطع الخصائص الموسعة.
| الخاصية | القيمة |
|---|---|
| diskLunList | قائمة LUN القرص هي قائمة LUNs من أقراص البيانات. يتم دائمًا القيام بالنسخ الاحتياطي لنظام التشغيل ولا تحتاج إلى ذكرها. |
| IsInclusionList | يجب أن يكون صحيحاً ل LUNs ليتم تضمينها أثناء النسخ الاحتياطي. إذا كانت خاطئة، فسيتم استبعاد LUNs المذكورة أعلاه. |
لذلك، إذا كان المطلب هو إجراء نسخ احتياطي لقرص نظام التشغيل فقط، فيجب استبعاد جميع أقراص البيانات. أسهل طريقة هي القول بأنه لا ينبغي تضمين أي أقراص بيانات. لذلك ستكون قائمة LUN القرص فارغة وستكون IsInclusionListصحيحة. وبالمثل، فكر في الطريقة الأسهل لاختيار مجموعة فرعية: يجب استبعاد أو إدراج بعض الأقراص دائمًا. اختر قائمة LUN وقيمة متغير منطقية وفقًا لذلك.
تشغيل نسخة احتياطية عند الطلب لـ Azure VM المحمي.
بمجرد تكوين Azure VM للنسخ الاحتياطي، يتم تشغيل النسخ الاحتياطية وفقًا لجدول النهج. يمكنك انتظار أول نسخة احتياطية مجدولة أو تشغيل نسخة احتياطية عند الطلب في أي وقت. الاحتفاظ بالنسخ الاحتياطية عند الطلب منفصل عن الاحتفاظ بسياسة النسخ الاحتياطي ويمكن تحديده إلى وقت تاريخ معين. إذا لم يتم تحديدها، يفترض أن تكون 30 يومًا من يوم تشغيل النسخ الاحتياطي عند الطلب.
يعد تشغيل النسخ الاحتياطي عند الطلب بمثابة عملية POST.
POST https://management.azure.com/Subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupFabrics/{fabricName}/protectionContainers/{containerName}/protectedItems/{protectedItemName}/backup?api-version=2016-12-01
تم إنشاء {containerName} و{protectedItemName} كما شيد أعلاه. {fabricName}هو Azure. على سبيل المثال، هذا يترجم إلى:
POST https://management.azure.com/Subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testVaultRG/providers/Microsoft.RecoveryServices/vaults/testVault/backupFabrics/Azure/protectionContainers/iaasvmcontainer;iaasvmcontainerv2;testRG;testVM/protectedItems/vm;iaasvmcontainerv2;testRG;testVM/backup?api-version=2016-12-01
إنشاء نص الطلب للنسخ الاحتياطي عند الطلب
لتشغيل نسخة احتياطية عند الطلب، فيما يلي مكونات نص الطلب.
| Name | كتابة | الوصف |
|---|---|---|
| الخصائص | IaaSVMBackupRequest | خصائص مورد طلب النسخ الاحتياطي |
للحصول على قائمة كاملة بتعريفات نص الطلب والتفاصيل الأخرى، يرجى الإشارة إلىتشغيل النسخ الاحتياطية للعناصر المحمية لمستند REST API.
إنشاء نص الطلب للنسخ الاحتياطي عند الطلب
يحدد نص الطلب التالي الخصائص المطلوبة لتشغيل النسخ الاحتياطي لعنصر محمي. إذا لم يتم تحديد الاحتفاظ به، سيتم الاحتفاظ به لمدة 30 يومًا من وقت تشغيل مهمة النسخ الاحتياطي.
{
"properties": {
"objectType": "IaasVMBackupRequest",
"recoveryPointExpiryTimeInUTC": "2018-12-01T02:16:20.3156909Z"
}
}
الاستجابات للنسخ الاحتياطي عند الطلب
يعد تشغيل النسخ الاحتياطي عند الطلب عملية غير متزامنة. وهذا يعني أن هذه العملية تنشئ عملية أخرى تحتاج إلى تعقبها بشكل منفصل.
تقوم بإرجاع استجابتين: 202 (مقبول) عند إنشاء عملية أخرى، و200 (موافق) عند اكتمال تلك العملية.
| Name | كتابة | الوصف |
|---|---|---|
| 202 مقبولة | مقبول |
مثال للاستجابات للنسخ الاحتياطي عند الطلب
بمجرد إرسال طلب POST للنسخ الاحتياطي عند الطلب، تكون الاستجابة الأولية 202 (مقبولة) بعنوان الموقع أو عنوان مزامنة Azure.
HTTP/1.1 202 Accepted
Pragma: no-cache
Retry-After: 60
Azure-AsyncOperation: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testVaultRG/providers/microsoft.recoveryservices/vaults/testVault/backupFabrics/Azure/protectionContainers/iaasvmcontainer;iaasvmcontainerv2;testVaultRG;testVM/protectedItems/vm;testRG;testVM/operationsStatus/b8daecaa-f8f5-44ed-9f18-491a9e9ba01f?api-version=2019-05-13
X-Content-Type-Options: nosniff
x-ms-request-id: 7885ca75-c7c6-43fb-a38c-c0cc437d8810
x-ms-client-request-id: 7df8e874-1d66-4f81-8e91-da2fe054811d; 7df8e874-1d66-4f81-8e91-da2fe054811d
Strict-Transport-Security: max-age=31536000; includeSubDomains
x-ms-ratelimit-remaining-subscription-writes: 1199
x-ms-correlation-request-id: 7885ca75-c7c6-43fb-a38c-c0cc437d8810
x-ms-routing-request-id: SOUTHINDIA:20180521T083541Z:7885ca75-c7c6-43fb-a38c-c0cc437d8810
Cache-Control: no-cache
Date: Mon, 21 May 2018 08:35:41 GMT
Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testVaultRG/providers/microsoft.recoveryservices/vaults/testVault/backupFabrics/Azure/protectionContainers/iaasvmcontainer;iaasvmcontainerv2;testVaultRG;testVM/protectedItems/vm;testRG;testVM/operationResults/b8daecaa-f8f5-44ed-9f18-491a9e9ba01f?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/testVaultRG/providers/microsoft.recoveryservices/vaults/testVault/backupFabrics/Azure/protectionContainers/iaasvmcontainer;iaasvmcontainerv2;testRG;testVM/protectedItems/vm;testRG;testVM/operationsStatus/a0866047-6fc7-4ac3-ba38-fb0ae8aa550f?api-version=2019-05-13
بمجرد اكتمال العملية، تقوم بإرجاع 200 (موافق) بمعرف مهمة النسخ الاحتياطي الناتجة في مجموعة الاستجابة.
HTTP/1.1 200 OK
Pragma: no-cache
X-Content-Type-Options: nosniff
x-ms-request-id: a8b13524-2c95-445f-b107-920806f385c1
x-ms-client-request-id: 5a63209d-3708-4e69-a75f-9499f4c8977c; 5a63209d-3708-4e69-a75f-9499f4c8977c
Strict-Transport-Security: max-age=31536000; includeSubDomains
x-ms-ratelimit-remaining-subscription-reads: 14995
x-ms-correlation-request-id: a8b13524-2c95-445f-b107-920806f385c1
x-ms-routing-request-id: SOUTHINDIA:20180521T083723Z:a8b13524-2c95-445f-b107-920806f385c1
Cache-Control: no-cache
Date: Mon, 21 May 2018 08:37:22 GMT
Server: Microsoft-IIS/8.0
X-Powered-By: ASP.NET
{
"id": "00000000-0000-0000-0000-000000000000",
"name": "00000000-0000-0000-0000-000000000000",
"status": "Succeeded",
"startTime": "2018-05-21T08:35:40.9488967Z",
"endTime": "2018-05-21T08:35:40.9488967Z",
"properties": {
"objectType": "OperationStatusJobExtendedInfo",
"jobId": "7ddead57-bcb9-4269-ac31-6a1b57588700"
}
}
نظرًا لأن مهمة النسخ الاحتياطي عملية طويلة الأمد، فيجب تتبعها كما هو موضح في مهام المراقبة باستخدام مستند واجهة برمجة تطبيقات REST.
تعديل تكوين النسخ الاحتياطي لـ VM Azure المحمية
تغيير سياسة الحماية
لتغيير النهج الذي تتم حماية الجهاز الظاهري به، يمكنك استخدام نفس التنسيق كتمكين الحماية). ما عليك سوى تقديم معرّف النهج الجديد في نهج الطلب وإرسال الطلب. على سبيل المثال: لتغيير نهج testVM من "DefaultPolicy" إلى "ProdPolicy"، قم بتوفير معرف "ProdPolicy" في نص الطلب.
{
"properties": {
"protectedItemType": "Microsoft.Compute/virtualMachines",
"sourceResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testRG/providers/Microsoft.Compute/virtualMachines/testVM",
"policyId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testVaultRG/providers/microsoft.recoveryservices/vaults/testVault/backupPolicies/ProdPolicy"
}
}
سوف تتبع الاستجابة نفس التنسيق المذكور لتمكين الحماية
استبعاد الأقراص أثناء حماية Azure VM
إذا تم بالفعل النسخ الاحتياطي لـ Azure VM، يمكنك تحديد قائمة الأقراص التي سيتم نسخها نسخًا احتياطيًّا أو استبعادها عن طريق تغيير نهج الحماية. فقط قم بإعداد الطلب بنفس تنسيق باستثناء الأقراص أثناء تمكين الحماية
هام
نص الطلب أعلاه هو دائمًا النسخة النهائية من أقراص البيانات التي سيتم استبعادها أو تضمينها. لا يُضاف هذا إلى التكوين السابق. على سبيل المثال: إذا قمت أولًا بتحديث الحماية ك "exclude data disk 1" ثم كرر مع "exclude data disk 2"، يتم استبعاد قرص البيانات 2 فقط في النسخ الاحتياطية اللاحقة وسيتم تضمين قرص البيانات 1. هذه هي القائمة النهائية التي سيتم تضمينها / استبعادها في النسخ الاحتياطية اللاحقة.
للحصول على القائمة الحالية للأقراص التي يتم استبعادها أو تضمينها، احصل على معلومات العنصر المحمي كما هو مذكور هنا. ستوفر الاستجابة قائمة LUNs لقرص البيانات وتشير إلى ما إذا كانت مضمنة أو مستبعدة.
أوقف الحماية لكن احتفظ بالبيانات الموجودة
لإزالة الحماية على VM المحمية ولكن يتم إجراء للنسخ الاحتياطي للاحتفاظ بالبيانات بالفعل في نص الطلب وتقديم الطلب. بمجرد إزالة الارتباط مع النهج، لن يتم تشغيل النسخ الاحتياطية، ولن يتم إنشاء نقاط استرداد جديدة.
{
"properties": {
"protectedItemType": "Microsoft.Compute/virtualMachines",
"sourceResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testRG/providers/Microsoft.Compute/virtualMachines/testVM",
"policyId": ""
}
}
سوف تتبع الاستجابة نفس التنسيق المذكور لتشغيل النسخ الاحتياطي عند الطلب يجب تعقب المهمة الناتجة كما هو موضح في مهام الشاشة باستخدام مستند REST API.
إيقاف الحماية وحذف البيانات
لإزالة الحماية عن مشاركة ملف محمي وحذف بيانات النسخ الاحتياطي أيضًا، قم بإجراء عملية حذف كما هو مذكور بالتفصيلهنا.
تعتبر إيقاف الحماية وحذف البيانات عملية حذف .
DELETE https://management.azure.com/Subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupFabrics/{fabricName}/protectionContainers/{containerName}/protectedItems/{protectedItemName}?api-version=2019-05-13
تم إنشاء {containerName} و{protectedItemName} كما شيد أعلاه. {fabricName} هو "Azure". على سبيل المثال، هذا يترجم إلى:
DELETE https://management.azure.com//Subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testVaultRG/providers/Microsoft.RecoveryServices/vaults/testVault/backupFabrics/Azure/protectionContainers/iaasvmcontainer;iaasvmcontainerv2;testRG;testVM/protectedItems/vm;iaasvmcontainerv2;testRG;testVM?api-version=2019-05-13
الردود على حذف الحماية
حذف الحماية هي عملية غير متزامنة . وهذا يعني أن هذه العملية تنشئ عملية أخرى تحتاج إلى تعقبها بشكل منفصل.
يقوم بإرجاع استجابتين: 202 (مقبول) عند إنشاء عملية أخرى، و204 (NoContent) عند اكتمال هذه العملية.
| Name | كتابة | الوصف |
|---|---|---|
| 204 بلا محتوى | بلا محتوى | |
| 202 مقبولة | مقبول |
هام
للحماية من سيناريوهات الحذف العرضي، تتوفر ميزة «soft-delete» لخزنة Recovery Services. إذا تم تعيين حالة الحذف المبدئي للخزنة إلى تمكين، فلن تقوم عملية الحذف بحذف البيانات على الفور. سيتم الاحتفاظ بها لمدة 14 يومًا ثم تطهيرها بشكل دائم. لا يتم تحصيل رسوم منك مقابل التخزين لمدة 14 يومًا. للتراجع عن عملية الحذف، راجع قسم «undo-delete».
«undo-delete» الحذف
«Undoing» الحذف العرضي مشابه لإنشاء عنصر النسخ الاحتياطي. بعد التراجع عن الحذف، يتم الاحتفاظ بالعنصر ولكن لا يتم تشغيل أي نسخ احتياطية مستقبلية.
«Undoing» هو عملية PUT التي تشبه إلى حد كبير تغيير النهج و / أو تمكين الحماية. فقط توفر الغرض من التراجع عن الحذف مع متغير isRehydrate في نص الطلب وتقديم الطلب. على سبيل المثال: «undo» حذف testVM، يجب استخدام نص الطلب التالي.
{
"properties": {
"protectedItemType": "Microsoft.Compute/virtualMachines",
"protectionState": "ProtectionStopped",
"sourceResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testRG/providers/Microsoft.Compute/virtualMachines/testVM",
"isRehydrate": true
}
}
سوف تتبع الاستجابة نفس التنسيق المذكور لتشغيل النسخ الاحتياطي عند الطلب يجب تعقب المهمة الناتجة كما هو موضح في مهام الشاشة باستخدام مستند REST API.
الخطوات التالية
«Restore» الملفات من النسخ الاحتياطي لـ Azure VM.
للمزيد من المعلومات حول واجهات برمجة التطبيقات REST للنسخ الاحتياطي لـ Azure، راجع المستندات التالية: