Method: projects.databases.exportDocuments

Exportiert eine Kopie aller oder eines Teils von Dokumenten von Google Cloud Firestore in ein anderes Speichersystem wie Google Cloud Storage. Kürzlich an Dokumenten vorgenommene Aktualisierungen werden möglicherweise nicht im Export berücksichtigt. Der Export wird im Hintergrund ausgeführt und der Fortschritt kann über die erstellte Vorgangsressource überwacht und verwaltet werden. Die Ausgabe eines Exports kann erst verwendet werden, nachdem der zugehörige Vorgang abgeschlossen ist. Wenn ein Exportvorgang vor dem Abschluss abgebrochen wird, bleiben möglicherweise unvollständige Daten in Google Cloud Storage erhalten.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
name

string

Zu exportierende Datenbank. Muss das Format projects/{projectId}/databases/{databaseId} haben.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung
{
  "collectionIds": [
    string
  ],
  "outputUriPrefix": string
}
Felder
collectionIds[]

string

Die zu exportierenden Sammlungs-IDs. „Nicht angegeben“ bedeutet alle Sammlungen.

outputUriPrefix

string

Der Ausgabe-URI. Derzeit werden Google Cloud Storage-URIs im Format gs://BUCKET_NAME[/NAMESPACE_PATH] nur unterstützt, wobei BUCKET_NAME der Name des Google Cloud Storage-Buckets und NAMESPACE_PATH ein optionaler Google Cloud Storage-Namespace-Pfad ist. Beachten Sie bei der Wahl des Namens die Namensrichtlinien von Google Cloud Storage: https://cloud.google.com/storage/docs/naming. Wenn der URI ein Bucket (ohne Namespace-Pfad) ist, wird ein Präfix auf Basis der Startzeit generiert.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von Operation.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.