Method: projects.locations.backupCollections.list

Liste toutes les collections de sauvegardes appartenant à un projet consommateur dans l'emplacement (région) spécifié ou dans tous les emplacements.

Si locationId est défini sur - (caractère générique), toutes les régions disponibles pour le projet sont interrogées et les résultats sont agrégés.

Requête HTTP

GET https://redis.googleapis.com/v1beta1/{parent=projects/*/locations/*}/backupCollections

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
parent

string

Obligatoire. Nom de ressource de l'emplacement backupCollection au format projects/{projectId}/locations/{locationId}, où locationId fait référence à une région Google Cloud.

Paramètres de requête

Paramètres
pageSize

integer

Facultatif. Le nombre maximum d'éléments à renvoyer.

Si aucune valeur n'est spécifiée, une valeur par défaut de 1 000 est utilisée par le service. Quelle que soit la valeur pageSize, la réponse peut inclure une liste partielle et un appelant ne doit s'appuyer que sur le nextPageToken de la réponse pour déterminer s'il reste d'autres clusters à interroger.
pageToken

string

Facultatif. La valeur nextPageToken renvoyée par une requête [backupCollections.list] précédente, le cas échéant.

Corps de la requête

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

Corps de la réponse

Réponse pour backupCollections.list

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

Représentation JSON 
{
  "backupCollections": [
    {
      object (BackupCollection)
    }
  ],
  "nextPageToken": string,
  "unreachable": [
    string
  ]
}
Champs
backupCollections[]

object (BackupCollection)

Liste des backupCollections du projet.

Si la valeur locationId dans le champ parent de la requête est "-", toutes les régions disponibles pour le projet sont interrogées et les résultats agrégés. Si, dans une telle requête agrégée, un lieu n'est pas disponible, une entrée backupCollection de remplacement est incluse dans la réponse avec le champ name défini sur une valeur de la forme projects/{projectId}/locations/{locationId}/backupCollections/, le champ status défini sur ERROR et le champ statusMessage défini sur "location not available for backupCollections.list".
nextPageToken

string

Jeton permettant de récupérer la page suivante des résultats ou non renseigné si la liste ne contient plus de résultats.
unreachable[]

string

Emplacements inaccessibles.

Niveaux d'accès des autorisations

Nécessite l'un des niveaux d'accès OAuth suivants :

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

Pour plus d'informations, consultez la Authentication Overview.