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

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