Method: projects.locations.backupCollections.list

Elenca tutte le raccolte di backup di proprietà di un progetto consumer nella località (regione) specificata o in tutte le località.

Se locationId è specificato come - (carattere jolly), vengono eseguite query su tutte le regioni disponibili per il progetto e i risultati vengono aggregati.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
parent

string

Obbligatorio. Il nome della risorsa della posizione backupCollection utilizzando il formato: projects/{projectId}/locations/{locationId} dove locationId si riferisce a una regione Google Cloud.

Parametri di query

Parametri
pageSize

integer

Facoltativo. Il numero massimo di elementi da restituire.

Se non specificato, il servizio utilizzerà un valore predefinito di 1000. Indipendentemente dal valore di pageSize, la risposta può includere un elenco parziale e il chiamante deve fare affidamento solo a nextPageToken della risposta per determinare se sono rimasti altri cluster da interrogare.

pageToken

string

Facoltativo. Il valore nextPageToken restituito da una precedente richiesta [backupCollections.list], se presente.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

Risposta per [backupCollections.list].

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON
{
  "backupCollections": [
    {
      object (BackupCollection)
    }
  ],
  "nextPageToken": string,
  "unreachable": [
    string
  ]
}
Campi
backupCollections[]

object (BackupCollection)

Un elenco di backupCollection nel progetto.

Se locationId nel campo principale della richiesta è "-", vengono eseguite query su tutte le regioni disponibili per il progetto e i risultati vengono aggregati. Se in una query aggregata di questo tipo una località non è disponibile, nella risposta viene inclusa una voce di backupCollection segnaposto con il campo name impostato su un valore del modulo projects/{projectId}/locations/{locationId}/backupCollections/, il campo status impostato su ERROR e il campo statusMessage impostato su "location not available for backupCollections.list".

nextPageToken

string

Token per recuperare la pagina successiva di risultati o vuoto se non sono presenti altri risultati nell'elenco.

unreachable[]

string

Località non raggiungibili.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la Authentication Overview.