Dokümanların tamamının veya bir alt kümesinin bir kopyasını Google Cloud Firestore'dan Google Cloud Storage gibi başka bir depolama sistemine aktarır. Belgelerde yapılan son güncellemeler dışa aktarma işlemine yansıtılmayabilir. Dışa aktarma arka planda gerçekleşir ve ilerlemesi, oluşturulan Operasyon kaynağı aracılığıyla izlenebilir ve yönetilebilir. Bir dışa aktarmanın çıktısı yalnızca ilgili işlem tamamlandıktan sonra kullanılabilir. Bir dışa aktarma işlemi tamamlanmadan iptal edilirse, Google Bulut Depolama'da kısmi veriler kalabilir.
Dışa aktarma davranışı ve çıktı biçimi hakkında daha fazla ayrıntı için şu adrese bakın: https://cloud.google.com/firestore/docs/manage-data/export-import
HTTP isteği
POST https://firestore.googleapis.com/v1/{name=projects/*/databases/*}:exportDocuments
URL, gRPC Kod Dönüştürme sözdizimini kullanır.
Yol parametreleri
Parametreler | |
---|---|
name | Gerekli. Dışa aktarılacak veritabanı. Şu biçimde olmalıdır: |
Talep gövdesi
İstek gövdesi aşağıdaki yapıya sahip verileri içerir:
JSON gösterimi |
---|
{ "collectionIds": [ string ], "outputUriPrefix": string, "namespaceIds": [ string ], "snapshotTime": string } |
Alanlar | |
---|---|
collectionIds[] | Hangi koleksiyon kimliklerinin dışa aktarılacağı. Belirtilmemiş tüm koleksiyonlar anlamına gelir. |
outputUriPrefix | Çıkış URI'si. Şu anda yalnızca şu biçimdeki Google Cloud Storage URI'lerini desteklemektedir: |
namespaceIds[] | Boş bir liste tüm ad alanlarını temsil eder. Bu, ad alanları kullanmayan veritabanları için tercih edilen kullanımdır. Boş bir dize öğesi, varsayılan ad alanını temsil eder. Veritabanının varsayılan olmayan ad alanlarında verileri varsa ancak bunları dahil etmek istemiyorsa bu kullanılmalıdır. Bu listedeki her ad alanı benzersiz olmalıdır. |
snapshotTime | Dışa aktarılacak veritabanı sürümüne karşılık gelen zaman damgası. Zaman damgası geçmişte olmalı, dakikaya yuvarlanmalı ve RFC3339 UTC "Zulu" biçiminde, nanosaniye çözünürlüğe ve en fazla dokuz kesirli basamağa sahip bir zaman damgası. Örnekler: |
Yanıt gövdesi
Başarılı olursa, yanıt gövdesi Operation
örneğini içerir.
Yetki 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ış bölümüne bakın.