MCP Tools Reference: redis.googleapis.com

Herramienta: list_backup_collections

Muestra todas las colecciones de copias de seguridad de Memorystore for Redis Cluster.

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

Solicitud 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
}'
                

Esquema de entrada

Solicitud de ListBackupCollections.

ListBackupCollectionsRequest

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

string

Obligatorio. Es el nombre del recurso de la ubicación de backupCollection con el formato projects/{project_id}/locations/{location_id}, en el que location_id hace referencia a una región de Google Cloud.

pageSize

integer

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

Opcional. El valor next_page_token que se muestra de una solicitud de [ListBackupCollections] previa, si existe.

Esquema de salida

La respuesta para ListBackupCollections.

ListBackupCollectionsResponse

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

object (BackupCollection)

Es una lista de backupCollections en el proyecto.

Si el location_id en el campo superior de la solicitud es “-”, se consultan todas las regiones disponibles para el proyecto y los resultados agregados. Si en una consulta agregada de este tipo no está disponible una ubicación, se incluye una entrada de backupCollection de marcador de posición en la respuesta con el name establecido en un valor del formulario projects/{project_id}/locations/{location_id}/backupCollections/- y el status establecido en ERROR y el status_message establecido en "location not available for ListBackupCollections".

nextPageToken

string

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

unreachable[]

string

Ubicaciones a las que no se pudo llegar.

BackupCollection

Representación JSON
{
  "name": string,
  "clusterUid": string,
  "cluster": string,
  "kmsKey": string,
  "uid": string,
  "createTime": string,
  "totalBackupSizeBytes": string,
  "totalBackupCount": string,
  "lastBackupTime": string
}
Campos
name

string

Es el identificador. Es la ruta de acceso completa del recurso de la colección de copias de seguridad.

clusterUid

string

Solo salida. Es el UID del clúster de la colección de copias de seguridad.

cluster

string

Solo salida. Es la ruta de acceso completa del recurso del clúster al que pertenece la colección de copias de seguridad. Ejemplo: projects/{project}/locations/{location}/clusters/{cluster}

kmsKey

string

Solo salida. Es la clave de KMS que se usa para encriptar las copias de seguridad en esta colección de copias de seguridad.

uid

string

Solo salida. Es el identificador único asignado por el sistema de la colección de copias de seguridad.

createTime

string (Timestamp format)

Solo salida. Es la hora en la que se creó la colección de copias 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".

totalBackupSizeBytes

string (int64 format)

Solo salida. Es el tamaño total de todas las copias de seguridad en la colección de copias de seguridad.

totalBackupCount

string (int64 format)

Solo salida. Es la cantidad total de copias de seguridad en la colección de copias de seguridad.

lastBackupTime

string (Timestamp format)

Solo salida. Es la última vez que se creó una copia de seguridad en la colección de copias 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".

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 nanosegundos de la duración, 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 estar entre 0 y 999,999,999 inclusive.

Anotaciones de herramientas

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