Method: projects.databases.exportDocuments

Exporta una copia de todos los documentos o un subconjunto de ellos de Google Cloud Firestore a otro sistema de almacenamiento, como Google Cloud Storage. Es posible que las actualizaciones recientes de los documentos no se reflejen en la exportación. La exportación se realiza en segundo plano y su progreso se puede supervisar y administrar a través del recurso de operación que se crea. El resultado de una exportación solo se puede usar una vez que se complete la operación asociada. Si se cancela una operación de exportación antes de que se complete, es posible que deje datos parciales en Google Cloud Storage.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
name

string

Base de datos para exportar. Debe tener el formato projects/{projectId}/databases/{databaseId}.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON 
{
  "collectionIds": [
    string
  ],
  "outputUriPrefix": string
}
Campos
collectionIds[]

string

Qué IDs de colección se exportarán. Sin especificar se refiere a todas las colecciones.
outputUriPrefix

string

El URI de salida. Actualmente, solo se admiten URI de Google Cloud Storage con el siguiente formato: gs://BUCKET_NAME[/NAMESPACE_PATH], en el que BUCKET_NAME es el nombre del bucket de Google Cloud Storage y NAMESPACE_PATH es una ruta opcional del espacio de nombres de Google Cloud Storage. Cuando elijas un nombre, asegúrate de considerar los lineamientos de nombres de Google Cloud Storage: https://cloud.google.com/storage/docs/naming. Si el URI es un bucket (sin una ruta de espacio de nombres), se generará un prefijo basado en la hora de inicio.

Cuerpo de la respuesta

Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de Operation.

Alcances de autorización

Se necesita uno de los siguientes permisos de OAuth:

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

Para obtener más información, consulta Descripción general de la autenticación.