Method: projects.databases.restore

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

يجب أن تكون قاعدة البيانات الجديدة في نفس منطقة السحابة الإلكترونية أو الموقع الجغرافي المتعدد المناطق مثل النسخة الاحتياطية الحالية. يعمل هذا بشكل مشابه لـ [FirestoreAdmin.CreateDatabase][google.firestore.admin.v1.CreateDatabase] باستثناء إنشاء قاعدة بيانات جديدة فارغة، حيث يتم إنشاء قاعدة بيانات جديدة بنوع قاعدة البيانات وإعداد الفهرس والمستندات من نسخة احتياطية حالية.

يمكن استخدام long-running operation لتتبُّع مستوى تقدُّم عملية الاستعادة، ويكون نوع الحقل metadata في العملية هو RestoreDatabaseMetadata. والنوع response هو Database إذا تمت الاستعادة بنجاح. قاعدة البيانات الجديدة غير قابلة للقراءة أو للكتابة حتى يكتمل LRO.

طلب HTTP

POST https://firestore.googleapis.com/v1/{parent=projects/*}/databases:restore

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

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

المَعلمات
parent

string

مطلوب. المشروع الذي تريد استعادة قاعدة البيانات فيه. التنسيق هو projects/{projectId}.

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON 
{
  "databaseId": string,

  // Union field source can be only one of the following:
  "backup": string
  // End of list of possible types for union field source.
}
الحقول
databaseId

string

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

ويجب أن تتراوح هذه القيمة بين 4 و63 حرفًا. الأحرف الصالحة هي /[a-z][0-9]-/ مع الحرف الأول حرف وحرف آخر أو رقم. يجب ألا يكون معرّف التعريف الفريد (UUID) مماثلاً للرمز الفريد العالمي /[0-9a-f]{8}(-[0-9a-f]{4}){3}-[0-9a-f]{12}/.

"(تلقائي)" معرّف قاعدة البيانات صالح أيضًا.

حقل الاتحاد source.

يمكن أن يكون source واحدًا فقط مما يلي:
backup

string

الاحتفاظ بنسخة احتياطية للاستعادة من يجب أن يكون من نفس المشروع الرئيسي.

التنسيق هو: projects/{projectId}/locations/{location}/backups/{backup}

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال Operation.

نطاقات الأذونات

يتطلب هذا الإعداد أحد نطاقات OAuth التالية:

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

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