Method: projects.databases.restore

मौजूदा बैकअप से डेटा वापस करके नया डेटाबेस बनाता है.

नया डेटाबेस, मौजूदा बैकअप वाले क्लाउड क्षेत्र या कई क्षेत्रों वाली जगह पर ही होना चाहिए. यह [FirestoreAdmin.CreateDatabase][google.firestore.admin.v1.CreateDatabase] की तरह ही काम करता है. सिर्फ़ एक नया खाली डेटाबेस बनाने के बजाय, एक नया डेटाबेस बना दिया जाता है. इसमें मौजूदा बैकअप से डेटाबेस के प्रकार, इंडेक्स कॉन्फ़िगरेशन, और दस्तावेज़ों की मदद ली जाती है.

long-running operation का इस्तेमाल, डेटा वापस लाने की प्रक्रिया को ट्रैक करने के लिए किया जा सकता है. साथ ही, कार्रवाई के metadata फ़ील्ड टाइप को RestoreDatabaseMetadata माना जाता है. अगर डेटा वापस लाने की प्रोसेस पूरी हो गई है, तो response टाइप Database है. एलआरओ के पूरा होने तक, नए डेटाबेस को न तो पढ़ा जा सकता है और न ही उसमें बदलाव किया जा सकता है.

एचटीटीपी अनुरोध

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

यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ के पैरामीटर

पैरामीटर
parent

string

ज़रूरी है. वह प्रोजेक्ट जिसमें डेटाबेस को वापस लाना है. फ़ॉर्मैट projects/{projectId} है.

अनुरोध का मुख्य भाग

अनुरोध के मुख्य हिस्से में, इस तरह का डेटा शामिल होता है:

जेएसओएन के काेड में दिखाना 
{
  "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

ज़्यादा जानकारी के लिए, पुष्टि करने से जुड़ी खास जानकारी देखें.