Method: projects.locations.backups.list

يسرد جميع النسخ الاحتياطية.

طلب HTTP

GET https://firestore.googleapis.com/v1/{parent=projects/*/locations/*}/backups

يستخدم عنوان URL بنية تحويل الترميز gRPC.

معلمات المسار

المَعلمات
parent

string

مطلوبة. الموقع المطلوب إدراج النُسخ الاحتياطية منه.

التنسيق هو projects/{project}/locations/{location}. استخدِم "{location} = '-'" لسرد النسخ الاحتياطية من جميع المواقع الجغرافية للمشروع المعني. يتيح ذلك سرد نسخ احتياطية من موقع واحد أو من جميع المواقع.

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

الردّ على FirestoreAdmin.ListBackups.

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "backups": [
    {
      object (Backup)
    }
  ],
  "unreachable": [
    string
  ]
}
الحقول
backups[]

object (Backup)

قائمة بجميع النسخ الاحتياطية للمشروع.
unreachable[]

string

قائمة بالمواقع الجغرافية التي تعذّر جلب النُسخ الاحتياطية منها

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

نطاقات التفويض

يتطلب استخدام أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/datastore
  • https://www.googleapis.com/auth/cloud-platform

لمزيد من المعلومات، يُرجى الاطّلاع على نظرة عامة على المصادقة.