مشاركة عبر


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

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

إدارة عمليات الحذف المبدئي في مخزن خدمات الاسترداد

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

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

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

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

بشكل افتراضي، سيتم تمكين حالة الحذف المبدئي لأي مخزن خدمات الاسترداد الذي تم إنشاؤه حديثا. لإحضار/تحديث حالة الحذف المبدئي لمخزن، استخدم مستند واجهة برمجة تطبيقات 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". نظرا لأن جميع المعلمات المطلوبة متوفرة في URI ، فلا داعي لنص طلب منفصل.

GET https://management.azure.com/Subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/testVaultRG/providers/Microsoft.RecoveryServices/vaults/testVault/backupconfig/vaultconfig?api-version=2019-06-15

الاستجابات

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

الاسم نوع Description
200 جيد BackupResourceVaultConfig OK
مثال على الاستجابة

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

{
  "id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/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/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/testVaultRG/providers/Microsoft.RecoveryServices/vaults/testVault/backupconfig/vaultconfig?api-version=2019-06-15

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

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

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

الاسم مطلوبة نوع Description
eTag السلسلة‬ علامة إلكترونية اختيارية
مكان صحيح السلسلة‬ موقع المورد
الخصائص خصائص Vault خصائص المخزن
العلامات Object علامات الموارد

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

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

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

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

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

الاسم نوع Description
200 جيد BackupResourceVaultConfig OK
مثال على الاستجابة لعملية PATCH

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

{
  "id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/testvaultRG/providers/Microsoft.RecoveryServices/vaults/testvault/backupconfig/vaultconfig",
  "name": "vaultconfig",
  "type": "Microsoft.RecoveryServices/vaults/backupconfig",
  "properties": {
    "enhancedSecurityState": "Enabled",
    "softDeleteFeatureState": "Disabled"
  }
}

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

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

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