MCP Tools Reference: redis.googleapis.com

Outil : list_backup_collections

Liste toutes les collections de sauvegardes Memorystore for Redis Cluster.

L'exemple suivant montre comment utiliser curl pour appeler l'outil MCP list_backup_collections.

Requête 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
}'
                

Schéma d'entrée

Demande de ListBackupCollections.

ListBackupCollectionsRequest

Représentation JSON
{
  "parent": string,
  "pageSize": integer,
  "pageToken": string
}
Champs
parent

string

Obligatoire. Nom de ressource de l'emplacement backupCollection au format projects/{project_id}/locations/{location_id}, où location_id fait référence à une région Google Cloud.

pageSize

integer

Facultatif. Le nombre maximum d'éléments à renvoyer.

Si aucune valeur n'est spécifiée, une valeur par défaut de 1 000 est utilisée par le service. Quelle que soit la valeur page_size, la réponse peut inclure une liste partielle et un appelant ne doit s'appuyer que sur le next_page_token de la réponse pour déterminer s'il reste d'autres clusters à interroger.

pageToken

string

Facultatif. La valeur next_page_token renvoyée par une requête [ListBackupCollections] précédente, le cas échéant.

Schéma de sortie

Réponse pour ListBackupCollections

ListBackupCollectionsResponse

Représentation JSON
{
  "backupCollections": [
    {
      object (BackupCollection)
    }
  ],
  "nextPageToken": string,
  "unreachable": [
    string
  ]
}
Champs
backupCollections[]

object (BackupCollection)

Liste des backupCollections du projet.

Si la valeur location_id dans le champ parent de la requête est "-", toutes les régions disponibles pour le projet sont interrogées et les résultats agrégés. Si, dans une telle requête agrégée, une position est indisponible, une entrée backupCollection de substitution est incluse dans la réponse avec le champ name défini sur une valeur de la forme projects/{project_id}/locations/{location_id}/backupCollections/, le champ status défini sur ERROR et le champ status_message défini sur "location not available for ListBackupCollections".

nextPageToken

string

Jeton permettant de récupérer la page suivante des résultats ou non renseigné si la liste ne contient plus de résultats.

unreachable[]

string

Emplacements inaccessibles.

BackupCollection

Représentation JSON
{
  "name": string,
  "clusterUid": string,
  "cluster": string,
  "kmsKey": string,
  "uid": string,
  "createTime": string,
  "totalBackupSizeBytes": string,
  "totalBackupCount": string,
  "lastBackupTime": string
}
Champs
name

string

Identifiant. Chemin d'accès complet à la ressource de la collection de sauvegarde.

clusterUid

string

Uniquement en sortie. UID du cluster de la collection de sauvegardes.

cluster

string

Uniquement en sortie. Chemin d'accès complet à la ressource du cluster auquel appartient la collection de sauvegardes. Exemple : projects/{project}/locations/{location}/clusters/{cluster}

kmsKey

string

Uniquement en sortie. Clé KMS utilisée pour chiffrer les sauvegardes de cette collection de sauvegardes.

uid

string

Uniquement en sortie. Identifiant unique attribué par le système à la collection de sauvegardes.

createTime

string (Timestamp format)

Uniquement en sortie. Date et heure de création de la collection de sauvegardes.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

totalBackupSizeBytes

string (int64 format)

Uniquement en sortie. Taille totale de toutes les sauvegardes de la collection de sauvegardes.

totalBackupCount

string (int64 format)

Uniquement en sortie. Nombre total de sauvegardes dans la collection de sauvegardes.

lastBackupTime

string (Timestamp format)

Uniquement en sortie. Dernière date de création d'une sauvegarde dans la collection de sauvegardes.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

Horodatage

Représentation JSON
{
  "seconds": string,
  "nanos": integer
}
Champs
seconds

string (int64 format)

Représente les secondes de l'heure UTC à partir de l'epoch Unix 1970-01-01T00:00:00Z. La valeur doit être comprise entre -62135596800 et 253402300799 inclus (ce qui correspond à 0001-01-01T00:00:00Z et 9999-12-31T23:59:59Z).

nanos

integer

Fractions de secondes non négatives avec une précision de l'ordre de la nanoseconde. Ce champ correspond à la partie en nanosecondes de la durée, et non à une alternative aux secondes. Les valeurs de secondes négatives avec des fractions doivent toujours comporter des valeurs de nanosecondes non négatives comptabilisées dans le temps. La valeur doit être comprise entre 0 et 999 999 999 inclus.

Annotations d'outils

Indication destructive : ❌ | Indication idempotente : ✅ | Indication en lecture seule : ✅ | Indication Open World : ❌