Method: projects.databases.restore

Crea un nuovo database ripristinando un backup esistente.

Il nuovo database deve trovarsi nella stessa regione cloud o località a più regioni del backup esistente. Questo comportamento è simile a [FirestoreAdmin.CreateDatabase][google.firestore.admin.v1.CreateDatabase], tranne che per la creazione di un nuovo database vuoto, ne viene creato uno nuovo con il tipo di database, la configurazione dell'indice e i documenti di un backup esistente.

Il valore long-running operation può essere utilizzato per monitorare l'avanzamento del ripristino, dove il tipo di campo metadata dell'operazione corrisponde a RestoreDatabaseMetadata. Il tipo response è Database se il ripristino è riuscito. Il nuovo database non sarà leggibile o scrivibile fino al completamento dell'LRO.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
parent

string

Obbligatoria. Il progetto in cui ripristinare il database. Il formato è projects/{projectId}.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione 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.
}
Campi
databaseId

string

Obbligatoria. L'ID da utilizzare per il database, che diventerà il componente finale del nome della risorsa del database. Questo ID database non deve essere associato a un database esistente.

Questo valore deve contenere da 4 a 63 caratteri. I caratteri validi sono /[a-z][0-9]-/, con il primo carattere una lettera e l'ultimo una lettera o un numero. Non deve essere simile all'UUID /[0-9a-f]{8}(-[0-9a-f]{4}){3}-[0-9a-f]{12}/.

È valido anche l'ID database "(predefinito)".

Campo di unione source.

source può essere solo uno dei seguenti:
backup

string

Backup da cui eseguire il ripristino. Deve provenire dallo stesso progetto dell'elemento padre.

Il formato è: projects/{projectId}/locations/{location}/backups/{backup}

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di Operation.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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

Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.