Method: projects.locations.backupPlans.backups.list

Répertorie les sauvegardes d'un BackupPlan donné.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
parent

string

Obligatoire. Le BackupPlan contenant les sauvegardes à répertorier. Format : projects/*/locations/*/backupPlans/*

L'autorisation IAM suivante est requise pour la ressource parent indiquée :

  • gkebackup.backups.list

Paramètres de requête

Paramètres
pageSize

integer

Nombre cible de résultats à renvoyer dans une seule réponse. Si aucune valeur n'est spécifiée, une valeur par défaut sera choisie par le service. Notez que la réponse peut inclure une liste partielle et qu'un appelant ne doit s'appuyer que sur le nextPageToken de la réponse pour déterminer s'il reste d'autres instances à interroger.

pageToken

string

Valeur de nextPageToken reçue d'un appel backups.list précédent. Fournissez-la pour récupérer la page suivante dans une liste de résultats comportant plusieurs pages. Lors de la pagination, tous les autres paramètres fournis à backups.list doivent correspondre à l'appel ayant fourni le jeton de page.

filter

string

Expression de correspondance de champ utilisée pour filtrer les résultats.

orderBy

string

Champ selon lequel trier les résultats.

Corps de la requête

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

Corps de la réponse

Message de réponse pour backups.list.

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)
    }
  ],
  "nextPageToken": string
}
Champs
backups[]

object (Backup)

Liste des sauvegardes correspondant aux critères donnés.

nextPageToken

string

Jeton pouvant être envoyé en tant que pageToken dans un appel backups.list ultérieur pour récupérer la page de résultats suivante. Si ce champ est omis ou vide, il n'y a plus de résultats à renvoyer.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

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