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://memorystore.googleapis.com/v1alpha/{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 della raccolta di backup utilizzando il formato: projects/{projectId}/locations/{locationId} dove locationId fa riferimento 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 un chiamante deve fare affidamento solo su nextPageToken della risposta per determinare se ci sono altri cluster da sottoporre a query.
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 backupCollections 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 una posizione non è disponibile, nella risposta viene inclusa una voce di riserva backupCollection con il campo name impostato su un valore del tipo 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 di risultati successiva o vuoto se non ci sono altri risultati nell'elenco.
unreachable[]

string

Sedi che non è stato possibile raggiungere.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Autorizzazioni IAM

Richiede la seguente autorizzazione IAM per la risorsa parent:

  • memorystore.backupCollections.list

Per ulteriori informazioni, consulta la documentazione di IAM.