Method: projects.databases.restore

Membuat {i>database<i} baru dengan memulihkan dari cadangan yang ada.

Database baru harus berada di region cloud atau lokasi multi-region yang sama dengan cadangan yang sudah ada. Perilaku ini mirip dengan [FirestoreAdmin.CreateDatabase][google.firestore.admin.v1.CreateDatabase] kecuali, sebagai ganti membuat database kosong baru, database baru akan dibuat dengan jenis database, konfigurasi indeks, dan dokumen dari cadangan yang sudah ada.

long-running operation dapat digunakan untuk melacak progres pemulihan, dengan jenis kolom metadata Operasi menjadi RestoreDatabaseMetadata. Jenis response adalah Database jika pemulihan berhasil. Database baru tidak dapat dibaca atau ditulis sampai LRO selesai.

Permintaan HTTP

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

URL menggunakan sintaks gRPC Transcoding.

Parameter jalur

Parameter
parent

string

Wajib diisi. Project untuk memulihkan database. Format adalah projects/{projectId}.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi 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.
}
Kolom
databaseId

string

Wajib diisi. ID yang akan digunakan untuk database, yang akan menjadi komponen akhir dari nama resource database. ID basis data ini tidak boleh dikaitkan dengan basis data yang ada.

Nilai ini harus terdiri dari 4-63 karakter. Karakter yang valid adalah /[a-z][0-9]-/ dengan karakter pertama huruf dan huruf terakhir atau angka. Tidak boleh seperti UUID /[0-9a-f]{8}(-[0-9a-f]{4}){3}-[0-9a-f]{12}/.

"(default)" ID basis data juga valid.

Kolom union source.

source hanya dapat berupa salah satu dari yang berikut:
backup

string

Cadangan untuk memulihkan. Harus berasal dari project yang sama dengan induk.

Formatnya adalah: projects/{projectId}/locations/{location}/backups/{backup}

Isi respons

Jika berhasil, isi respons akan berisi instance Operation.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Ringkasan Autentikasi.