Method: projects.locations.backupCollections.list

Listet alle Sicherungssammlungen auf, die einem Verbraucherprojekt entweder am angegebenen Standort (Region) oder an allen Standorten zugewiesen sind.

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

HTTP-Anfrage

GET https://memorystore.googleapis.com/v1beta/{parent=projects/*/locations/*}/backupCollections

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

Erforderlich. Der Ressourcenname des Speicherorts der Sicherungssammlung 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 nextPageToken in der Antwort 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 Sicherungssammlungen im Projekt.

Wenn das 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 zusammengefassten Abfrage ein Speicherort nicht verfügbar ist, wird in der Antwort ein Platzhaltereintrag für die Sicherungssammlung mit dem Wert „projects/{projectId}/locations/{locationId}/backupCollections/-“ für das Feld name, dem Wert „FEHLER“ für das Feld status und dem Wert „Speicherort nicht verfügbar für backupCollections.list“ für das Feld statusMessage eingefügt.
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

IAM-Berechtigungen

Erfordert die folgende IAM-Berechtigung für die Ressource parent:

  • memorystore.backupCollections.list

Weitere Informationen finden Sie in der IAM-Dokumentation.