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} है.

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

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

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

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