Method: projects.locations.backups.list

Répertorie toutes les sauvegardes.

Requête HTTP

GET https://firestore.googleapis.com/v1/{parent=projects/*/locations/*}/backups

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
parent

string

Obligatoire. Emplacement à partir duquel répertorier les sauvegardes.

Format : projects/{project}/locations/{location} Utilisez {location} = '-' pour répertorier les sauvegardes de tous les emplacements pour le projet donné. Cela permet de répertorier les sauvegardes d'un seul emplacement ou de tous les emplacements.

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Réponse pour FirestoreAdmin.ListBackups.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "backups": [
    {
      object (Backup)
    }
  ],
  "unreachable": [
    string
  ]
}
Champs
backups[]

object (Backup)

Liste de toutes les sauvegardes du projet.
unreachable[]

string

Liste des emplacements à partir desquels les sauvegardes existantes n'ont pas pu être récupérées.

Au lieu d'échouer l'intégralité des requêtes lorsqu'un seul établissement est inaccessible, cette réponse renvoie un ensemble de résultats partiel et une liste des emplacements impossibles à atteindre ici. La requête peut être relancée sur un seul emplacement pour obtenir une erreur concrète.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.