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

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