Mengekspor salinan semua atau sebagian dokumen dari Google Cloud Firestore ke sistem penyimpanan lain, seperti Google Cloud Storage. Perubahan terbaru pada dokumen mungkin tidak ditampilkan dalam ekspor. Ekspor terjadi di latar belakang dan progresnya dapat dipantau serta dikelola melalui resource Operation yang dibuat. Output ekspor hanya dapat digunakan setelah operasi yang terkait selesai. Jika operasi ekspor dibatalkan sebelum selesai, sebagian data mungkin akan tertinggal di Google Cloud Storage.
Untuk detail selengkapnya tentang perilaku ekspor dan format output, lihat: https://cloud.google.com/firestore/docs/manage-data/export-import
Permintaan HTTP
POST https://firestore.googleapis.com/v1/{name=projects/*/databases/*}:exportDocuments
URL menggunakan sintaksis gRPC Transcoding.
Parameter jalur
Parameter | |
---|---|
name |
Wajib. Database yang akan diekspor. Harus dalam bentuk: |
Isi permintaan
Isi permintaan memuat data dengan struktur berikut:
Representasi JSON |
---|
{ "collectionIds": [ string ], "outputUriPrefix": string, "namespaceIds": [ string ], "snapshotTime": string } |
Kolom | |
---|---|
collectionIds[] |
ID koleksi yang akan diekspor. Tidak ditentukan berarti semua koleksi. |
outputUriPrefix |
URI output. Saat ini hanya mendukung URI Google Cloud Storage dalam bentuk: |
namespaceIds[] |
Daftar kosong mewakili semua namespace. Ini adalah penggunaan yang disarankan untuk database yang tidak menggunakan namespace. Elemen string kosong mewakili namespace default. Ini harus digunakan jika database memiliki data dalam namespace non-default, tetapi tidak ingin menyertakannya. Setiap namespace dalam daftar ini harus unik. |
snapshotTime |
Stempel waktu yang sesuai dengan versi database yang akan diekspor. Stempel waktu harus berada di masa lampau, dibulatkan ke menit, dan tidak lebih lama dari Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan maksimal sembilan digit fraksional. Contoh: |
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 informasi selengkapnya, lihat Ringkasan Autentikasi.