حدثّ تكوينات مخزن Azure Recovery Services باستخدام واجهة برمجة تطبيقات REST

توضح هذه المقالة كيفية تحديث تكوينات النسخ الاحتياطي ذات الصلة في مخزن خدمات Azure Recovery Services باستخدام واجهة برمجة تطبيقات REST.

حالة الحذف المبدئي

حذف النسخ الاحتياطية لعنصر محمي عملية مهمة يجب مراقبتها. للحماية من عمليات الحذف العرضية، يحتوي مخزن خدمات Azure Recovery Services على إمكانية حذف مبدئي. تسمح لك هذه الإمكانية باستعادة النسخ الاحتياطية المحذوفة، إذا لزم الأمر، خلال فترة زمنية بعد الحذف.

ولكن توجد سيناريوهات لا تتطلب هذه القدرة. لا يمكن حذف مخزن Azure Recovery Services في حال وجود عناصر نسخ احتياطي في حالة الحذف المبدئي في المخزن. قد يسبب ذلك مشكلة إذا كان المخزن بحاجة إلى حذفه على الفور. على سبيل المثال: غالبا ما تقوم عمليات التوزيع بتنظيف الموارد التي تم إنشاؤها في نفس سير العمل. يمكن للتوزيع إنشاء مخزن وتكوين نسخ احتياطية لعنصر والقيام باستعادة اختبار ثم المتابعة لحذف عناصر النسخ الاحتياطي والمخزن. إذا فشل حذف المخزن، قد تفشل عملية التوزيع بأكملها. تعطيل الحذف المبدئي هو الطريقة الوحيدة لضمان الحذف الفوري.

لذلك تحتاج إلى اختيار بعناية ما إذا كان أو لم يكن لتعطيل الحذف المبدئي لمخزن معين اعتمادًا على السيناريو. لمزيد من المعلومات، راجع الحذف المبدئي لمقالة.

إحضار الحذف المبدئي باستخدام حالة واجهة برمجة تطبيقات REST

بشكل افتراضي، سيتم تمكين حالة الحذف المبدئي لأي مخزن Recovery Services منشأ حديثًا. لجلب أو تحديث حالة الحذف المبدئي للمخزن، استخدم مستند واجهة برمجة تطبيقات REST المرتبط بالنسخ الاحتياطي

لجلب الحالة الحالية لحذف مبدئي للمخزن، استخدم عملية GET التالية

GET https://management.azure.com/Subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupconfig/vaultconfig?api-version=2019-06-15

يحتوي GET URI على معلمات {subscriptionId} و{vaultName}و {vaultresourceGroupName}. في هذا المثال، {vaultName} هو "testVault" و {vaultresourceGroupName} هو "testVaultRG". وحيث لأنه يتم تقديم جميع المعلمات المطلوبة في معرّف الموارد المنتظم، فلا داعي لهيئة طلب منفصلة.

GET https://management.azure.com/Subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testVaultRG/providers/Microsoft.RecoveryServices/vaults/testVault/backupconfig/vaultconfig?api-version=2019-06-15

الردود

تظهر الاستجابة الناجحة لعملية "GET" أدناه:

الاسم	النوع	‏‏الوصف
200 جيد	BackupResourceVaultConfig	موافق

مثال على الاستجابة

بمجرد تقديم طلب GET، سترجع استجابة 200 (ناجحة).

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testvaultRG/providers/Microsoft.RecoveryServices/vaults/testvault/backupconfig/vaultconfig",
  "name": "vaultconfig",
  "type": "Microsoft.RecoveryServices/vaults/backupconfig",
  "properties": {
    "enhancedSecurityState": "Enabled",
    "softDeleteFeatureState": "Enabled"
  }
}

تحديث الحذف المبدئي باستخدام حالة واجهة برمجة تطبيقات REST

لتحديث حالة الحذف المبدئي لمخزن خدمات الاسترداد باستخدام واجهة برمجة تطبيقات REST، استخدم عملية PUT التالية

PUT https://management.azure.com/Subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupconfig/vaultconfig?api-version=2019-06-15

يحتوي PUT URI على معلمات {subscriptionId} و{vaultName}و {vaultresourceGroupName}. في هذا المثال، {vaultName} هو "testVault" و {vaultresourceGroupName} هو "testVaultRG". إذا استبدلنا URI بالقيم أعلاه، فسيبدو URI هكذا.

PUT https://management.azure.com/Subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testVaultRG/providers/Microsoft.RecoveryServices/vaults/testVault/backupconfig/vaultconfig?api-version=2019-06-15

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

تُستخدم التعريفات الشائعة التالية لإنشاء نص طلب

لمزيد من التفاصيل، راجع وثائق واجهة برمجة تطبيقات REST

الاسم	مطلوبة	نوع	‏‏الوصف
eTag		السلسلة	eTag اختيارية
موقع	صحيح	السلسلة	موقع المورد
الخصائص		VaultProperties	خصائص المخزن
العلامات		‏‏الكائن	علامات المورد

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

يُستخدم المثال التالي لتحديث حالة الحذف المبدئي إلى 'معطّل'.

{
  "properties": {
    "enhancedSecurityState": "Enabled",
    "softDeleteFeatureState": "Disabled"
  }
}

الاستجابات لعملية PATCH

تظهر الاستجابة الناجحة لعملية "GET" أدناه:

الاسم	النوع	‏‏الوصف
200 جيد	BackupResourceVaultConfig	موافق

أمثلة الاستجابة لعملية PATCH

بمجرد تقديم طلب PATCH، سترجع استجابة 200 (ناجحة).

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testvaultRG/providers/Microsoft.RecoveryServices/vaults/testvault/backupconfig/vaultconfig",
  "name": "vaultconfig",
  "type": "Microsoft.RecoveryServices/vaults/backupconfig",
  "properties": {
    "enhancedSecurityState": "Enabled",
    "softDeleteFeatureState": "Disabled"
  }
}

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

إنشاء نهج نسخ احتياطي لنسخ جهاز Azure الظاهري احتياطيًا في هذا المخزن.

لمزيد من المعلومات حول Azure REST APIs، راجع المستندات التالية:

• واجهة برمجة تطبيقات REST الخاصة بموفر Azure Recovery Services
• بدء استخدام Azure REST API