這個外掛程式能將 Google Cloud Firestore 中所有或部分文件的副本匯出至其他儲存系統,例如 Google Cloud Storage。近期對文件所做的更新可能不會反映在匯出檔案中。匯出作業會在背景中執行,您可以透過已建立的 Operation 資源來監控及管理進度。只有在相關作業完成後,才能使用匯出結果。如在匯出作業完成前取消,部分資料可能仍會留在 Google Cloud Storage 中。
HTTP 要求
POST https://firestore.googleapis.com/v1beta1/{name=projects/*/databases/*}:exportDocuments
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 | |
---|---|
name |
要匯出的資料庫。格式應為 |
要求主體
要求主體的資料會採用以下結構:
JSON 表示法 |
---|
{ "collectionIds": [ string ], "outputUriPrefix": string } |
欄位 | |
---|---|
collectionIds[] |
要匯出的集合 ID。「未指定」:表示所有集合。 |
outputUriPrefix |
輸出 URI。目前僅支援以下格式的 Google Cloud Storage URI: |
回應主體
如果成功,回應主體會包含 Operation
的執行例項。
授權範圍
需要下列其中一種 OAuth 範圍:
https://www.googleapis.com/auth/datastore
https://www.googleapis.com/auth/cloud-platform
詳情請參閱驗證總覽。