ينشئ قاعدة بيانات جديدة عن طريق الاستعادة من نسخة احتياطية موجودة.
يجب أن تكون قاعدة البيانات الجديدة في منطقة السحابة الإلكترونية نفسها أو في الموقع الجغرافي المتعدد المناطق مثل النسخة الاحتياطية الحالية. يعمل هذا على غرار [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 |
مطلوبة. المشروع الذي ستتم استعادة قاعدة البيانات فيه. التنسيق هو |
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "databaseId": string, // Union field |
الحقول | |
---|---|
databaseId |
مطلوبة. المعرِّف المطلوب استخدامه لقاعدة البيانات، والذي سيصبح المكوّن الأخير في اسم مورد قاعدة البيانات. يجب عدم إقران معرّف قاعدة البيانات هذا بقاعدة بيانات موجودة. ويجب أن تتألف هذه القيمة من 4 إلى 63 حرفًا. الأحرف الصالحة هي /[a-z][0-9]-/ حيث يبدأ الحرف الأول بحرف آخر أو رقم. يجب ألا يشبه المعرّف الفريد العالمي (UUID) /[0-9a-f]{8}(-[0-9a-f]{4}){3}-[0-9a-f]{12}/. رقم تعريف قاعدة البيانات "(التلقائي)" صالح أيضًا. |
حقل الاتحاد يمكن أن يكون الحقل " |
|
backup |
نسخة احتياطية للاستعادة منها. يجب أن يكون الطالب من المشروع نفسه الذي ينتمي إليه أحد الوالدَين. التنسيق هو: |
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال Operation
.
نطاقات التفويض
يتطلب استخدام أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/datastore
https://www.googleapis.com/auth/cloud-platform
لمزيد من المعلومات، يُرجى الاطّلاع على نظرة عامة على المصادقة.