معرفة تكوين النسخة الاحتياطية الدورية في Azure Service Fabric

يتكون النسخ الاحتياطي الدوري لخدمات الحالة الموثوقة أو الجهات الفاعلة الموثوقة من الخطوات التالية:

  1. إنشاء نهج النسخ الاحتياطي: في هذه الخطوة، إنشاء نهج نسخ احتياطي واحد أو أكثر وفقا للمتطلبات.

  2. تمكين النسخ الاحتياطي: في هذه الخطوة، يمكنك إقران نهج النسخ الاحتياطي التي أنشئت في الخطوة 1 بالكيانات أو التطبيق أو الخدمة أو القسم المطلوب.

إنشاء نهج النسخ الاحتياطي

تتكون سياسة النسخة الاحتياطية من التكوينات التالية:

  • الاستعادة التلقائية عند فقدان البيانات: يحدد ما إذا كان سيتم تشغيل الاستعادة تلقائيا باستخدام أحدث نسخة احتياطية متاحة في حالة تعرض القسم لحدث فقدان البيانات.

إشعار

من المستحسن عدم تعيين "استعادة تلقائية" في مجموعات الإنتاج

  • النسخ الاحتياطية الإضافية القصوى: يحدد الحد الأقصى لعدد النسخ الاحتياطية الإضافية التي سيتم أخذها بين النسخ الاحتياطي الكامل اثنين. الحد الأقصى للنسخ الاحتياطية المتزايدة تحديد الحد الأعلى. يتم أخذ نسخة احتياطية كاملة قبل إكمال عدد محدد من النسخ الاحتياطية الإضافية في أحد الشروط التالية

    1. النسخة المتماثلة لم تتخذ النسخ الاحتياطي الكامل منذ أن أصبح الأساسي.

    2. اقتطاع بعض سجلات السجل منذ آخر نسخة احتياطية.

    3. مرت النسخة المتماثلة الحد الأقصى المتراكمة BackupLogSizeInMB.

  • جدول النسخ الاحتياطي: الوقت أو التردد الذي يجب أن تأخذ النسخ الاحتياطية الدورية. يمكن للمرء إصلاح عاجل للنسخ الاحتياطية لتكون متكررة في فترة زمنية محددة أو في وقت محدد يوميا / أسبوعيا.

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

      {
          "ScheduleKind": "FrequencyBased",
          "Interval": "PT10M"
      }
      
    2. جدول النسخ الاحتياطي المستند إلى الوقت:يجب استخدام نوع الجدول هذا إذا كانت الحاجة إلى أخذ النسخ الاحتياطي للبيانات في أوقات محددة من اليوم أو الأسبوع. يمكن أن يكون نوع تكرار الجدولة يوميا أو أسبوعيا.

      1. جدول النسخ الاحتياطي اليومي المستند إلى الوقت: استخدام نوع الجدول هذا إذا كانت الحاجة إلى أخذ النسخ الاحتياطي للبيانات في أوقات محددة من اليوم. لتحديد هذا، تعيين ScheduleFrequencyType إلى يوميا؛ وتعيين إلى قائمة الوقت المطلوب خلال اليوم في RunTimes تنسيق ISO8601، سيتم تجاهل التاريخ المحدد جنبا إلى جنب مع الوقت. على سبيل المثال، 0001-01-01T18:00:00 يمثل 6:00 مساء كل يوم، متجاهلا تاريخ الجزء 0001-01-01. يوضح المثال أدناه التكوين لتشغيل النسخ الاحتياطي اليومي في الساعة 9:00 صباحا و 6:00 مساء كل يوم.

        {
            "ScheduleKind": "TimeBased",
            "ScheduleFrequencyType": "Daily",
            "RunTimes": [
              "0001-01-01T09:00:00Z",
              "0001-01-01T18:00:00Z"
            ]
        }
        
      2. جدول النسخ الاحتياطي الأسبوعي المستند إلى الوقت:يجب استخدام نوع الجدول هذا إذا كانت الحاجة إلى أخذ النسخ الاحتياطي للبيانات في أوقات محددة من اليوم. لتحديد هذا، تعيين ScheduleFrequencyType إلى أسبوعية؛ تعيين RunDays إلى قائمة الأيام في أسبوع عندما يحتاج إلى تشغيل النسخ الاحتياطي وتعيين RunTimes إلى قائمة الوقت المطلوب خلال اليوم في تنسيق ISO8601، سيتم تجاهل التاريخ المحدد جنبا إلى جنب مع الوقت. قائمة بالأيام من الأسبوع عند تشغيل النسخ الاحتياطي الدوري. يوضح المثال أدناه التكوين لتشغيل النسخ الاحتياطي اليومي في 9: 00 ص و 6: 00 م أثناء الاثنين إلى الجمعة.

        {
            "ScheduleKind": "TimeBased",
            "ScheduleFrequencyType": "Weekly",
            "RunDays": [
               "Monday",
               "Tuesday",
               "Wednesday",
               "Thursday",
               "Friday"
            ],
            "RunTimes": [
              "0001-01-01T09:00:00Z",
              "0001-01-01T18:00:00Z"
            ]
        }
        
  • التخزين الاحتياطي: تحديد الموقع لتحميل النسخ الاحتياطية. يمكن أن يكون التخزين إما مخزن النقطة Azure أو مشاركة الملف.

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

      {
          "StorageKind": "AzureBlobStore",
          "FriendlyName": "Azure_storagesample",
          "ConnectionString": "<Put your Azure blob store connection string here>",
          "ContainerName": "BackupContainer"
      }
      

      إشعار

      خدمة استعادة النسخ الاحتياطي لا تعمل مع تخزين V1 Azure

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

      1. مصادقة Windows المتكاملة، حيث يتم توفير الوصول إلى مشاركة الملفات إلى كافة أجهزة الكمبيوتر التي تنتمي إلى الكتلة "نسيج الخدمة". في هذه الحالة، تعيين الحقول التالية لتكوين تخزين النسخ الاحتياطي المستندة إلى مشاركة الملفات.

        {
            "StorageKind": "FileShare",
            "FriendlyName": "Sample_FileShare",
            "Path": "\\\\StorageServer\\BackupStore"
        }
        
      2. حماية مشاركة الملفات باستخدام اسم المستخدم وكلمة المرور، حيث يتم توفير الوصول إلى مشاركة الملفات لمستخدمي معينين. توفر مواصفات تخزين مشاركة الملف أيضا إمكانية تحديد اسم المستخدم الثانوي وكلمة المرور الثانوية لتوفير بيانات اعتماد احتياطية في حالة فشل المصادقة مع اسم المستخدم الأساسي وكلمة المرور الأساسية. في هذه الحالة، تعيين الحقول التالية لتكوين تخزين النسخ الاحتياطي المستندة إلى مشاركة الملفات.

        {
            "StorageKind": "FileShare",
            "FriendlyName": "Sample_FileShare",
            "Path": "\\\\StorageServer\\BackupStore",
            "PrimaryUserName": "backupaccount",
            "PrimaryPassword": "<Password for backupaccount>",
            "SecondaryUserName": "backupaccount2",
            "SecondaryPassword": "<Password for backupaccount2>"
        }
        

إشعار

تأكد من أن موثوقية التخزين تفي بمتطلبات الموثوقية لبيانات النسخ الاحتياطي أو تتجاوزها.

  • فترة الاستبقاء: تحديد النهج للاحتفاظ النسخ الاحتياطية في التخزين المكون. اعتماد فترة الاستبقاء الأساسي فقط.
    1. نهج الاستبقاء الأساسي:يسمح نهج الاستبقاء بضمان الاستخدام الأمثل للتخزين عن طريق إزالة ملفات النسخ الاحتياطي التي لم تعد مطلوبة. RetentionDuration يمكن تحديد لتعيين الفترة الزمنية التي يلزم الاحتفاظ بنسخ احتياطية لها في التخزين. MinimumNumberOfBackups هي معلمة اختيارية يمكن تحديدها للتأكد من أن العدد المحدد من النسخ الاحتياطية يتم الاحتفاظ به دائما بغض النظر عن RetentionDuration . يوضح المثال أدناه التكوين للاحتفاظ النسخ الاحتياطية لمدة 10 أيام ولا يسمح عدد النسخ الاحتياطية للذهاب أقل من 20.

      {
          "RetentionPolicyType": "Basic",
          "RetentionDuration" : "P10D",
          "MinimumNumberOfBackups": 20
      }
      

تمكين النسخ الاحتياطي الدوري

بعد تعريف نهج النسخ الاحتياطي للوفاء بمتطلبات النسخ الاحتياطي للبيانات، يجب أن يكون نهج النسخ الاحتياطي مقترنا بشكل مناسب إما بتطبيقأو خدمةأو قسم.

إشعار

تأكد من عدم وجود أي ترقيات للتطبيق قيد التقدم قبل تمكين النسخ الاحتياطي

النشر الهرمي لسياسة النسخ الاحتياطي

في نهج Service Fabric، تكون العلاقة بين التطبيق والخدمة والأقسام هرمية كما هو موضح في نموذج التطبيق. يمكن إقران نهج النسخ الاحتياطي إما بتطبيق أوخدمةأو قسم في التسلسل الهرمي. نهج النسخ الاحتياطي نشر هرميا إلى المستوى التالي. على افتراض وجود نهج النسخ الاحتياطي واحد فقط التي تم إنشاؤها والمرتبطة بتطبيق، سيتم نسخ كافة أقسام الحالة الموثوقة تنتمي إلى كافة خدمات الحالة الموثوق بها و "جهات فاعلة موثوق بها"للتطبيق احتياطيا باستخدام نهج النسخ الاحتياطي. أو إذا كان نهج النسخ الاحتياطي مقترنا بخدمة موثوق بها،سيتم نسخ كافة أقسامها احتياطيا باستخدام نهج النسخ الاحتياطي.

تجاوز نهج النسخ الاحتياطي

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

مثال

يستخدم هذا المثال الإعداد مع تطبيقين، MyApp_Aو MyApp_B. يحتوي MyApp_A التطبيق على خدمتين موثوقة ذات حالة، SvcA1 وSvcA3، وخدمة ممثل موثوق بها واحدة، ActorA2. يحتوي SvcA1 على ثلاثة أقسام بينما يحتوي كل من ActorA2 و SvcA3 على قسمين. التطبيق MyApp_B يحتوي على ثلاث خدمات موثوقة Stateful، SvcB1،SvcB2،وSvcB3. يحتوي SvcB1 و SvcB2 على قسمين لكل منهما بينما يحتوي SvcB3 على ثلاثة أقسام.

افترض أن متطلبات النسخ الاحتياطي للبيانات هذه التطبيقات كما يلي

  1. MyApp_A

    1. إنشاء النسخ الاحتياطي اليومي للبيانات لجميع أقسام جميع الخدمات موثوق الدولةوالجهات الفاعلة موثوق بها تنتمي إلى التطبيق. Upload بيانات النسخ الاحتياطي إلى موقع BackupStore1.

    2. واحدة من الخدمات، SvcA3،يتطلب النسخ الاحتياطي للبيانات كل ساعة.

    3. حجم البيانات في القسم SvcA1_P2 هو أكثر من المتوقع وينبغي تخزين بيانات النسخ الاحتياطي إلى موقع تخزين مختلف BackupStore2.

  2. MyApp_B

    1. إنشاء نسخة احتياطية من البيانات كل يوم أحد في الساعة 8:00 صباحا لجميع أقسام خدمة SvcB1. Upload بيانات النسخ الاحتياطي إلى موقع BackupStore1.

    2. إنشاء نسخة احتياطية من البيانات كل يوم في الساعة 8:00 صباحا لقسم SvcB2_P1. Upload بيانات النسخ الاحتياطي إلى موقع BackupStore1.

لمعالجة هذه المتطلبات النسخ الاحتياطي للبيانات، يتم إنشاء نهج النسخ الاحتياطي BP_1 BP_5 ويتم تمكين النسخ الاحتياطي كما يلي.

  1. MyApp_A

    1. إنشاء نهج النسخ الاحتياطي، BP_1،مع جدول النسخ الاحتياطي المستندة إلى التردد حيث يتم تعيين التردد إلى 24 ساعة. وتخزين النسخ الاحتياطي تكوينها لاستخدام موقع التخزين BackupStore1. تمكين هذا النهج للتطبيق MyApp_A باستخدام تمكين التطبيق النسخ الاحتياطي API. يتيح هذا الإجراء النسخ الاحتياطي للبيانات باستخدام نهج النسخ الاحتياطي BP_1 لكافة أقسام خدمات Stateful الموثوق بهاوالجهات الفاعلة الموثوقة التي تنتمي إلى تطبيق MyApp_A.

    2. إنشاء نهج النسخ الاحتياطي، BP_2،مع جدول النسخ الاحتياطي المستندة إلى التردد حيث يتم تعيين التردد إلى ساعة واحدة. وتخزين النسخ الاحتياطي تكوينها لاستخدام موقع التخزين BackupStore1. تمكين هذا النهج لخدمة SvcA3 باستخدام تمكين API النسخ الاحتياطي الخدمة. يتجاوز هذا الإجراء النهج الذي تم نشره BP_1 بواسطة نهج النسخ الاحتياطي الممكن بشكل صريح BP_2 لكافة أقسام الخدمة SvcA3 المؤدية إلى النسخ الاحتياطي للبيانات باستخدام نهج النسخ الاحتياطي BP_2 لهذه الأقسام.

    3. إنشاء نهج النسخ الاحتياطي، BP_3، مع جدول النسخ الاحتياطي المستندة إلى التردد حيث يتم تعيين التردد إلى 24 ساعة. وتخزين النسخ الاحتياطي تكوين لاستخدام موقع التخزين BackupStore2. تمكين هذا النهج SvcA1_P2 القسم باستخدام تمكين API النسخ الاحتياطي القسم. يتجاوز هذا الإجراء نهج نشر BP_1 بواسطة نهج النسخ الاحتياطي تمكين صريح BP_3 SvcA1_P2القسم .

  2. MyApp_B

    1. إنشاء نهج النسخ الاحتياطي، BP_4، مع جدول النسخ الاحتياطي المستندة إلى الوقت حيث يتم تعيين نوع تكرار الجدولة أسبوعيا، يتم تعيين أيام التشغيل إلى الأحد، ويتم تعيين أوقات التشغيل إلى 8:00 ص. تخزين النسخ الاحتياطي تكوين لاستخدام موقع التخزين BackupStore1. تمكين هذا النهج لخدمة SvcB1 باستخدام تمكين خدمة النسخ الاحتياطي API. يتيح هذا الإجراء النسخ الاحتياطي للبيانات باستخدام نهج النسخ الاحتياطي BP_4 لكافة أقسام الخدمة SvcB1.

    2. إنشاء نهج النسخ الاحتياطي، BP_5، مع جدول النسخ الاحتياطي المستندة إلى الوقت حيث يتم تعيين نوع تكرار الجدولة إلى يوميا ويتم تعيين أوقات التشغيل إلى 8:00 صباحا. تخزين النسخ الاحتياطي تكوين لاستخدام موقع التخزين BackupStore1. تمكين هذا النهج للقسم SvcB2_P1 باستخدام تمكين API النسخ الاحتياطي القسم. يتيح هذا الإجراء النسخ الاحتياطي للبيانات باستخدام BP_5 نهج النسخ الاحتياطي SvcB2_P1القسم .

يوضح الرسم التخطيطي التالي نهج النسخ الاحتياطي الممكنة بشكل صريح وسياسات النسخ الاحتياطي التي تم نشرها.

Service Fabric Application Hierarchy

تعطيل النسخ الاحتياطي

يمكن تعطيل نهج النسخ الاحتياطي عندما لا تكون هناك حاجة للنسخ الاحتياطي للبيانات. يمكن تعطيل نهج النسخ الاحتياطي الممكن في تطبيق فقط في نفس التطبيق باستخدام تعطيل API النسخ الاحتياطي للتطبيق، ويمكن تعطيل نهج النسخ الاحتياطي الممكن في خدمة في نفس الخدمة باستخدام تعطيل API النسخ الاحتياطي الخدمة، ويمكن تعطيل نهج النسخ الاحتياطي تمكين في قسم في نفس القسم باستخدام تعطيل API النسخ الاحتياطي القسم.

  • تعطيل نهج النسخ الاحتياطي لتطبيق توقف كافة النسخ الاحتياطية البيانات الدورية يحدث نتيجة لنشر نهج النسخ الاحتياطي إلى أقسام الخدمة الحالة الموثوق بها أو أقسام الممثل الموثوق بها.

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

  • تعطيل نهج النسخ الاحتياطي لقسم توقف كافة النسخ الاحتياطي للبيانات الدورية يحدث بسبب نهج النسخ الاحتياطي في القسم.

  • أثناء تعطيل النسخ الاحتياطي لكيان (تطبيق/خدمة/قسم)، CleanBackup يمكن تعيين إلى true لحذف كافة النسخ الاحتياطية في التخزين المكون.

    {
        "CleanBackup": true 
    }
    

إشعار

تأكد من عدم وجود أية ترقيات للتطبيق قيد التقدم قبل تعطيل النسخ الاحتياطي

تعليق النسخ الاحتياطي واستئنافه

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

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

الفرق بين تعليق وتعطيل النسخ الاحتياطية

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

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

استعادة تلقائية لفقدان البيانات

تفقد قسم الخدمة البيانات بسبب فشل غير متوقع. على سبيل المثال، القرص لاثنين من أصل ثلاثة نسخ متماثلة لقسم (بما في ذلك النسخة المتماثلة الأساسية) يحصل معطوب أو مسح.

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

إشعار

من المستحسن عدم تعيين "استعادة تلقائية" في مجموعات الإنتاج

تحديث تكوين النسخ الاحتياطي

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

  • معلومات تكوين النسخ الاحتياطي للتطبيق: توفر تفاصيل سياسة النسخ الاحتياطي المطبقة في التطبيق وجميع السياسات التي تم تجاوزها في الخدمات والأقسام التابعة للتطبيق. كما يتضمن معلومات التعليق للتطبيق وخدماته والأقسام.

  • معلومات تكوين النسخ الاحتياطي للخدمة: توفر تفاصيل نهج النسخ الاحتياطي الفعال في الخدمة والنطاق الذي تم تطبيق هذا النهج فيه وكافة النهج التي تم تجاوزها في أقسامها. كما يتضمن معلومات التعليق للخدمة وأقسامها.

  • معلومات تكوين النسخ الاحتياطي القسم: يوفر تفاصيل نهج النسخ الاحتياطي الفعال في القسم والنطاق الذي تم تطبيق هذا النهج. كما يتضمن معلومات التعليق للأقسام.

سرد النسخ الاحتياطية المتوفرة

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

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

فيما يلي معلومات مختصرة حول المتغيرات المعتمدة.

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