Method: projects.databases.exportDocuments

Google Cloud Firestore'daki dokümanların tamamının veya bir alt kümesinin kopyasını Google Cloud Storage gibi başka bir depolama sistemine aktarır. Dokümanlarda yapılan son güncellemeler dışa aktarmaya yansıtılmayabilir. Dışa aktarma işlemi arka planda gerçekleştirilir. İşlemin ilerleme durumu, oluşturulan İşlem kaynağı aracılığıyla izlenip yönetilebilir. Dışa aktarma işleminin sonucu yalnızca ilişkili işlem tamamlandıktan sonra kullanılabilir. Bir dışa aktarma işlemi tamamlanmadan iptal edilirse Google Cloud Storage'da kısmi veriler kalabilir.

HTTP isteği

POST https://firestore.googleapis.com/v1beta2/{name=projects/*/databases/*}:exportDocuments

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
name

string

Dışa aktarılacak veritabanı. Şu biçimde olmalıdır: projects/{projectId}/databases/{databaseId}.

İstek içeriği

İstek gövdesi, aşağıdaki yapıya sahip verileri içerir:

JSON gösterimi
{
  "collectionIds": [
    string
  ],
  "outputUriPrefix": string
}
Alanlar
collectionIds[]

string

Dışa aktarılacak koleksiyon kimlikleri. Belirtilmemiş, tüm koleksiyonlar anlamına gelir.

outputUriPrefix

string

Çıkış URI'si. Şu anda yalnızca gs://BUCKET_NAME[/NAMESPACE_PATH] biçimindeki Google Cloud Storage URI'leri desteklenmektedir. Burada BUCKET_NAME, Google Cloud Storage paketinin adıdır ve NAMESPACE_PATH ise isteğe bağlı Google Cloud Storage ad alanı yoludur. Ad seçerken Google Cloud Storage adlandırma yönergelerini dikkate almayı unutmayın: https://cloud.google.com/storage/docs/naming. URI (ad alanı yolu olmayan) bir paketse, başlangıç zamanına göre bir önek oluşturulur.

Yanıt gövdesi

Başarılı olursa yanıt gövdesi, Operation öğesinin bir örneğini içerir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

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

Daha fazla bilgi için Kimlik Doğrulamaya Genel Bakış başlıklı makaleye bakın.