MCP Tools Reference: memorystore.googleapis.com

Strumento: list_backup_collections

Elenca tutte le raccolte di backup di Memorystore for Valkey.

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

Richiesta curl 
                  
curl --location 'https://memorystore.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 località 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 viene specificato, il servizio utilizzerà un valore predefinito di 1000. Indipendentemente dal valore di page_size, la risposta può includere un elenco parziale e un 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 parent 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 backupCollection segnaposto con il campo name impostato su un valore nel formato projects/{project_id}/locations/{location_id}/backupCollections/- e il campo status impostato su ERROR e il campo 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,
  "instanceUid": string,
  "instance": 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.
instanceUid

string

Solo output. L'UID dell'istanza della raccolta di backup.
instance

string

Solo output. Il percorso completo della risorsa dell'istanza a cui appartiene la raccolta di backup. Esempio: projects/{project}/locations/{location}/instances/{instance}
kmsKey

string

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

string

Solo output. Identificatore univoco assegnato dal sistema della raccolta di backup.
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 dell'ora UTC dall'epoca Unix 1970-01-01T00:00:00Z. Il valore deve essere compreso tra -62135596800 e 253402300799 inclusi (corrispondenti a 0001-01-01T00:00:00Z e 9999-12-31T23:59:59Z).
nanos

integer

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

Annotazioni dello strumento

Suggerimento distruttivo: ❌ | Suggerimento idempotente: ✅ | Suggerimento di sola lettura: ✅ | Suggerimento open world: ❌