Method: projects.databases.restore

Crea una base de datos nueva mediante el restablecimiento de una copia de seguridad existente.

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

long-running operation se puede usar para realizar un seguimiento del progreso del restablecimiento; el tipo de campo metadata de la operación es RestoreDatabaseMetadata. El tipo response es Database si el restablecimiento se realizó correctamente. No se podrá leer ni escribir la nueva base de datos hasta que se complete la LRO.

Solicitud HTTP

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

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

Parámetros de ruta de acceso

Parámetros
parent

string

Obligatorio. El proyecto en el que se restablecerá 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

Obligatorio. El ID que se usará para la base de datos, que se convertirá en el componente final del nombre del recurso de la base de datos. Este ID de la base de datos no debe estar asociado con una base de datos existente.

Este valor debe tener entre 4 y 63 caracteres. Los caracteres válidos son /[a-z][0-9]-/, en el que el primer carácter es 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}/.

El ID de la base de datos "(predeterminado)" también es válido.

Campo de unión source.

source puede ser una de las siguientes opciones:
backup

string

Copia de seguridad desde la que se restablecerá. Debe ser del mismo proyecto que el superior.

Formato: projects/{projectId}/locations/{location}/backups/{backup}

Cuerpo de la respuesta

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

Permisos de autorización

Se necesita uno de los siguientes alcances 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.