Method: projects.locations.backupCollections.list

Listet alle Sicherungssammlungen auf, die einem Consumer-Projekt am angegebenen Standort (Region) oder an allen Standorten gehören.

Wenn locationId als - (Platzhalter) angegeben wird, werden alle für das Projekt verfügbaren Regionen abgefragt und die Ergebnisse werden zusammengefasst.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

Pflichtangabe. Der Ressourcenname des BackupCollection-Standorts im Format projects/{projectId}/locations/{locationId}, wobei sich locationId auf eine Google Cloud-Region bezieht.

Abfrageparameter

Parameter
pageSize

integer

Optional. Die maximale Anzahl der Elemente, die zurückzugeben sind.

Wenn nicht angegeben, wird vom Dienst der Standardwert 1.000 verwendet. Unabhängig vom pageSize-Wert kann die Antwort eine unvollständige Liste enthalten und ein Aufrufer sollte sich nur auf die Antwort nextPageToken verlassen, um zu bestimmen, ob noch weitere Cluster abzufragen sind.
pageToken

string

Optional. Der Wert nextPageToken wurde gegebenenfalls von einer vorherigen [backupCollections.list]-Anfrage zurückgegeben.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Antwort für [backupCollections.list].

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "backupCollections": [
    {
      object (BackupCollection)
    }
  ],
  "nextPageToken": string,
  "unreachable": [
    string
  ]
}
Felder
backupCollections[]

object (BackupCollection)

Eine Liste der backupCollections im Projekt.

Wenn locationId im übergeordneten Feld der Anfrage „-“ ist, werden alle für das Projekt verfügbaren Regionen abgefragt und die Ergebnisse zusammengefasst. Wenn in einer solchen aggregierten Abfrage ein Standort nicht verfügbar ist, wird in die Antwort ein Platzhalter-backupCollection-Eintrag aufgenommen, bei dem das Feld name auf einen Wert der Form projects/{projectId}/locations/{locationId}/backupCollections/- gesetzt ist, das Feld status auf ERROR und das Feld statusMessage auf „location not available for backupCollections.list“.
nextPageToken

string

Token zum Abrufen der nächsten Ergebnisseite. Leer, wenn keine weiteren Ergebnisse in der Liste vorhanden sind.
unreachable[]

string

Standorte, die nicht erreicht werden konnten.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter Authentication Overview.