MCP Tools Reference: redis.googleapis.com

Strumento: list_backup_collections

Elenca tutte le raccolte di backup di Memorystore for Redis Cluster.

Il seguente esempio mostra come utilizzare curl per richiamare lo strumento MCP list_backup_collections.

Richiesta curl 
                  
curl --location 'https://redis.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "list_backup_collections",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Schema di input

Richiesta per ListBackupCollections.

ListBackupCollectionsRequest

Rappresentazione JSON 
{
  "parent": string,
  "pageSize": integer,
  "pageToken": string
}
Campi
parent

string

Obbligatorio. Il nome della risorsa della posizione backupCollection nel formato: projects/{project_id}/locations/{location_id}, dove location_id si riferisce a una regione Google Cloud.
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 page_size, la risposta può includere un elenco parziale e il chiamante deve fare affidamento solo su next_page_token della risposta per determinare se sono rimasti altri cluster da interrogare.
pageToken

string

Facoltativo. Il valore next_page_token restituito da una precedente richiesta [ListBackupCollections], se presente.

Schema di output

Risposta per ListBackupCollections.

ListBackupCollectionsResponse

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

object (BackupCollection)

Un elenco di backupCollection nel progetto.

Se location_id 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/{project_id}/locations/{location_id}/backupCollections/ e il campo status impostato su ERROR e status_message impostato su "location not available for ListBackupCollections".
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.

BackupCollection

Rappresentazione JSON 
{
  "name": string,
  "clusterUid": string,
  "cluster": string,
  "kmsKey": string,
  "uid": string,
  "createTime": string,
  "totalBackupSizeBytes": string,
  "totalBackupCount": string,
  "lastBackupTime": string
}
Campi
name

string

Identificatore. Percorso completo della risorsa della raccolta di backup.
clusterUid

string

Solo output. L'UID del cluster della raccolta di backup.
cluster

string

Solo output. Il percorso completo della risorsa del cluster a cui appartiene la raccolta di backup. Esempio: projects/{project}/locations/{location}/clusters/{cluster}
kmsKey

string

Solo output. La chiave KMS utilizzata per criptare i backup in questa raccolta di backup.
uid

string

Solo output. Identificatore univoco della raccolta di backup assegnato dal sistema.
createTime

string (Timestamp format)

Solo output. L'ora in cui è stata creata la raccolta di backup.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
totalBackupSizeBytes

string (int64 format)

Solo output. Dimensione totale di tutti i backup nella raccolta di backup.
totalBackupCount

string (int64 format)

Solo output. Numero totale di backup nella raccolta di backup.
lastBackupTime

string (Timestamp format)

Solo output. L'ultima volta che è stato creato un backup nella raccolta di backup.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

Timestamp

Rappresentazione JSON 
{
  "seconds": string,
  "nanos": integer
}
Campi
seconds

string (int64 format)

Rappresenta i secondi del tempo UTC a partire dall'epoca Unix 1970-01-01T00:00:00Z. Deve essere compreso tra -62135596800 e 253402300799 inclusi (corrispondenti a 0001-01-01T00:00:00Z e 9999-12-31T23:59:59Z).
nanos

integer

Frazioni di secondo non negative con risoluzione in nanosecondi. Questo campo è la porzione di nanosecondi della durata, non un'alternativa ai secondi. I valori negativi dei secondi con frazioni devono comunque avere valori di nanosecondi non negativi che contano in avanti nel tempo. Deve essere compreso tra 0 e 999.999.999 inclusi.

Annotazioni dello strumento

Suggerimento distruttivo: ❌ | Suggerimento idempotente: ✅ | Suggerimento di sola lettura: ✅ | Suggerimento di mondo aperto: ❌