Method: projects.databases.exportDocuments

Exporte une copie de tout ou partie des documents de Google Cloud Firestore vers un autre système de stockage, tel que Google Cloud Storage. Les mises à jour récentes des documents peuvent ne pas être reflétées dans l'exportation. L'exportation s'effectue en arrière-plan et sa progression peut être surveillée et gérée via la ressource Opération créée. Le résultat d’un export ne peut être utilisé qu’une fois l’opération associée effectuée. Si une opération d'exportation est annulée avant la fin, elle peut laisser des données partielles dans Google Cloud Storage.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC .

Paramètres du chemin

Paramètres
name

string

Base de données à exporter. Doit être de la forme : projects/{projectId}/databases/{databaseId} .

Corps de la demande

Le corps de la requête contient des données avec la structure suivante :

Représentation JSON
{
  "collectionIds": [
    string
  ],
  "outputUriPrefix": string
}
Des champs
collectionIds[]

string

Quels identifiants de collection exporter. Non spécifié signifie toutes les collections.

outputUriPrefix

string

L’URI de sortie. Actuellement, ne prend en charge que les URI Google Cloud Storage de la forme : gs://BUCKET_NAME[/NAMESPACE_PATH] , où BUCKET_NAME est le nom du bucket Google Cloud Storage et NAMESPACE_PATH est un chemin d'espace de noms Google Cloud Storage facultatif. Lorsque vous choisissez un nom, veillez à prendre en compte les directives de dénomination de Google Cloud Storage : https://cloud.google.com/storage/docs/naming . Si l'URI est un bucket (sans chemin d'espace de noms), un préfixe sera généré en fonction de l'heure de début.

Corps de réponse

En cas de succès, le corps de la réponse contient une instance de Operation .

Portées des autorisations

Nécessite l'une des étendues OAuth suivantes :

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

Pour plus d'informations, consultez la Présentation de l'authentification .