MCP Tools Reference: redis.googleapis.com

Herramienta: list_backups

Enumera todas las copias de seguridad de Memorystore for Redis Cluster.

En el siguiente ejemplo, se muestra cómo usar curl para invocar la herramienta de MCP list_backups.

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

Esquema de entrada

Solicitud para ListBackups.

ListBackupsRequest

Representación JSON 
{
  "parent": string,
  "pageSize": integer,
  "pageToken": string
}
Campos
parent

string

Obligatorio. Nombre del recurso de backupCollection con el formato: projects/{project_id}/locations/{location_id}/backupCollections/{backup_collection_id}
pageSize

integer

Es opcional. La cantidad máxima de elementos que se mostrarán.

Si no se especifica, el servicio usará un valor predeterminado de 1,000. Sin importar el valor de page_size, la respuesta puede incluir una lista parcial, y un emisor solo debe confiar en el next_page_token de la respuesta para determinar si quedan más clústeres para consultar.
pageToken

string

Es opcional. El valor de next_page_token que se muestra de una solicitud de [ListBackupCollections] anterior, si existe.

Esquema de salida

La respuesta para ListBackups.

ListBackupsResponse

Representación JSON 
{
  "backups": [
    {
      object (Backup)
    }
  ],
  "nextPageToken": string,
  "unreachable": [
    string
  ]
}
Campos
backups[]

object (Backup)

Es una lista de las copias de seguridad del proyecto.
nextPageToken

string

Token para recuperar la página siguiente de resultados o vaciar si no hay más resultados en la lista.
unreachable[]

string

Copias de seguridad a las que no se pudo acceder.

Copia de seguridad

Representación JSON 
{
  "name": string,
  "createTime": string,
  "cluster": string,
  "clusterUid": 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
}
Campos
name

string

Es el identificador. Es la ruta de acceso completa del recurso de la copia de seguridad. La última parte del nombre es el ID de la copia de seguridad con el siguiente formato: [AAAAMMDDHHMMSS]_[UID del clúster abreviado] O bien el ID especificado por el cliente durante la copia de seguridad del clúster. Ejemplo: 20240515123000_1234
createTime

string (Timestamp format)

Solo salida. Es la fecha y hora en que se creó la copia de seguridad.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
cluster

string

Solo salida. Es la ruta del recurso del clúster de esta copia de seguridad.
clusterUid

string

Solo salida. Es el UID del clúster de esta copia de seguridad.
totalSizeBytes

string (int64 format)

Solo salida. Tamaño total de la copia de seguridad en bytes.
expireTime

string (Timestamp format)

Solo salida. Fecha y hora en que vencerá la copia de seguridad.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
engineVersion

string

Solo salida. redis-7.2, valkey-7.5
backupFiles[]

object (BackupFile)

Solo salida. Es la lista de archivos de copia de seguridad de la copia de seguridad.
nodeType

enum (NodeType)

Solo salida. Es el tipo de nodo del clúster.
replicaCount

integer

Solo salida. Cantidad de réplicas del clúster.
shardCount

integer

Solo salida. Es la cantidad de fragmentos del clúster.
backupType

enum (BackupType)

Solo salida. Es el tipo de copia de seguridad.
state

enum (State)

Solo salida. Estado de la copia de seguridad.
encryptionInfo

object (EncryptionInfo)

Solo salida. Es la información de encriptación de la copia de seguridad.
uid

string

Solo salida. Es el identificador único de la copia de seguridad asignado por el sistema.

Marca de tiempo

Representación JSON 
{
  "seconds": string,
  "nanos": integer
}
Campos
seconds

string (int64 format)

Representa los segundos de la hora UTC desde la época de Unix 1970-01-01T00:00:00Z. Debe estar entre -62135596800 y 253402300799 inclusive (lo que corresponde a 0001-01-01T00:00:00Z a 9999-12-31T23:59:59Z).
nanos

integer

Fracciones no negativas de un segundo a una resolución de nanosegundos. Este campo es la parte de la duración en nanosegundos, no una alternativa a los segundos. Los valores de segundos negativos con fracciones deben tener valores nanos no negativos que se cuentan hacia adelante en el tiempo. Debe ser un valor entre 0 y 999,999,999, inclusive.

BackupFile

Representación JSON 
{
  "fileName": string,
  "sizeBytes": string,
  "createTime": string
}
Campos
fileName

string

Solo salida. Por ejemplo, .rdb
sizeBytes

string (int64 format)

Solo salida. Tamaño del archivo de copia de seguridad en bytes.
createTime

string (Timestamp format)

Solo salida. Es la fecha y hora en que se creó el archivo de copia de seguridad.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

EncryptionInfo

Representación JSON 
{
  "encryptionType": enum (Type),
  "kmsKeyVersions": [
    string
  ],
  "kmsKeyPrimaryState": enum (KmsKeyState),
  "lastUpdateTime": string
}
Campos
encryptionType

enum (Type)

Solo salida. Tipo de encriptación.
kmsKeyVersions[]

string

Solo salida. Son las versiones de clave de KMS que se usan para proteger los datos en reposo.
kmsKeyPrimaryState

enum (KmsKeyState)

Solo salida. Es el estado de la versión principal de la clave de KMS que percibe el sistema. Este campo no se completa en las copias de seguridad.
lastUpdateTime

string (Timestamp format)

Solo salida. Es la fecha y hora más reciente en la que se actualizó la información de encriptación.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

Anotaciones de herramientas

Sugerencia destructiva: ❌ | Sugerencia idempotente: ✅ | Sugerencia de solo lectura: ✅ | Sugerencia de mundo abierto: ❌