Method: projects.databases.restore

Crea una nueva base de datos restaurando desde una copia de seguridad existente.

La nueva base de datos debe estar en la misma región de la nube o ubicación multirregional que la copia de seguridad existente. Esto se comporta de manera similar a [FirestoreAdmin.CreateDatabase][google.firestore.admin.v1.CreateDatabase] excepto que en lugar de crear una nueva base de datos vacía, se crea una nueva base de datos con el tipo de base de datos, la configuración del índice y los documentos de una copia de seguridad existente.

La long-running operation se puede utilizar para realizar un seguimiento del progreso de la restauración; el tipo de campo metadata de la operación es RestoreDatabaseMetadata . El tipo response es la Database si la restauración fue exitosa. La nueva base de datos no se puede leer ni escribir hasta que se haya completado el LRO.

solicitud HTTP

POST https://firestore.googleapis.com/v1/{parent=projects/*}/databases:restore

La URL utiliza la sintaxis de transcodificación gRPC .

Parámetros de ruta

Parámetros
parent

string

Requerido. El proyecto en el que se restaurará la base de datos. El formato es projects/{projectId} .

Cuerpo de la solicitud

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

Representación JSON
{
  "databaseId": string,

  // Union field source can be only one of the following:
  "backup": string
  // End of list of possible types for union field source.
}
Campos
databaseId

string

Requerido. El ID que se utilizará para la base de datos, que se convertirá en el componente final del nombre del recurso de la base de datos. Esta identificación de base de datos no debe estar asociada con una base de datos existente.

Este valor debe tener entre 4 y 63 caracteres. Los caracteres válidos son /[az][0-9]-/ siendo el primer carácter una letra y el último una letra o un número. No debe ser similar a un UUID /[0-9a-f]{8}(-[0-9a-f]{4}){3}-[0-9a-f]{12}/.

La identificación de la base de datos "(predeterminada)" también es válida.

source de campo sindical.

source puede ser sólo una de las siguientes:

backup

string

Copia de seguridad para restaurar. Debe ser del mismo proyecto que el padre.

El formato es: projects/{projectId}/locations/{location}/backups/{backup}

Cuerpo de respuesta

Si tiene éxito, el cuerpo de la respuesta contiene una instancia de Operation .

Ámbitos de autorización

Requiere uno de los siguientes ámbitos de OAuth:

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

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