MCP Tools Reference: memorystore.googleapis.com

Strumento: list_backups

Elenca tutti i backup di Memorystore for Valkey.

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

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_backups",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Schema di input

Richiesta per ListBackups.

ListBackupsRequest

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

string

Obbligatorio. Il nome della risorsa di backupCollection utilizzando il modulo: projects/{project_id}/locations/{location_id}/backupCollections/{backup_collection_id}
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 ListBackups.

ListBackupsResponse

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

object (Backup)

Un elenco di backup nel progetto.
nextPageToken

string

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

string

Backup non raggiungibili.

Backup

Rappresentazione JSON 
{
  "name": string,
  "createTime": string,
  "instance": string,
  "instanceUid": string,
  "totalSizeBytes": string,
  "expireTime": string,
  "engineVersion": string,
  "backupFiles": [
    {
      object (BackupFile)
    }
  ],
  "nodeType": enum (NodeType),
  "replicaCount": integer,
  "shardCount": integer,
  "backupType": enum (BackupType),
  "state": enum (State),
  "encryptionInfo": {
    object (EncryptionInfo)
  },
  "uid": string
}
Campi
name

string

Identificatore. Percorso completo della risorsa del backup. L'ultima parte del nome è l'ID backup con il seguente formato: [YYYYMMDDHHMMSS]_[Shorted Instance UID] O specificato dal cliente durante il backup dell'istanza. Esempio: 20240515123000_1234
createTime

string (Timestamp format)

Solo output. L'ora in cui è stato creato il 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".
instance

string

Solo output. Il percorso della risorsa dell'istanza di questo backup.
instanceUid

string

Solo output. UID dell'istanza di questo backup.
totalSizeBytes

string (int64 format)

Solo output. Dimensione totale del backup in byte.
expireTime

string (Timestamp format)

Solo output. L'ora in cui il backup scadrà.

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".
engineVersion

string

Solo output. valkey-7.5/valkey-8.0 e così via.
backupFiles[]

object (BackupFile)

Solo output. Elenco dei file di backup del backup.
nodeType

enum (NodeType)

Solo output. Tipo di nodo dell'istanza.
replicaCount

integer

Solo output. Numero di repliche per l'istanza.
shardCount

integer

Solo output. Numero di shard per l'istanza.
backupType

enum (BackupType)

Solo output. Tipo di backup.
state

enum (State)

Solo output. Lo stato del backup.
encryptionInfo

object (EncryptionInfo)

Solo output. Informazioni sulla crittografia del backup.
uid

string

Solo output. Identificatore univoco del backup assegnato dal sistema.

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.

BackupFile

Rappresentazione JSON 
{
  "fileName": string,
  "sizeBytes": string,
  "createTime": string
}
Campi
fileName

string

Solo output. Ad esempio: .rdb
sizeBytes

string (int64 format)

Solo output. Dimensioni del file di backup in byte.
createTime

string (Timestamp format)

Solo output. L'ora in cui è stato creato il file 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".

EncryptionInfo

Rappresentazione JSON 
{
  "encryptionType": enum (Type),
  "kmsKeyVersions": [
    string
  ],
  "kmsKeyPrimaryState": enum (KmsKeyState),
  "lastUpdateTime": string
}
Campi
encryptionType

enum (Type)

Solo output. Tipo di crittografia.
kmsKeyVersions[]

string

Solo output. Versioni delle chiavi KMS utilizzate per proteggere i dati inattivi.
kmsKeyPrimaryState

enum (KmsKeyState)

Solo output. Lo stato della versione primaria della chiave KMS percepito dal sistema. Questo campo non viene compilato nei backup.
lastUpdateTime

string (Timestamp format)

Solo output. L'ora più recente in cui sono state aggiornate le informazioni di crittografia.

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".

Annotazioni dello strumento

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