MCP Tools Reference: redis.googleapis.com

Ferramenta: list_backups

Listar todos os backups do Memorystore for Redis Cluster.

O exemplo a seguir demonstra como usar curl para invocar a ferramenta list_backups MCP.

Solicitação 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

Solicitação de ListBackups.

ListBackupsRequest

Representação JSON 
{
  "parent": string,
  "pageSize": integer,
  "pageToken": string
}
Campos
parent

string

Obrigatório. O nome do recurso backupCollection usando o formulário: projects/{project_id}/locations/{location_id}/backupCollections/{backup_collection_id}
pageSize

integer

Opcional. O número máximo de itens para retornar.

Caso não seja especificado, um valor padrão de 1000 será usado pelo serviço. Seja qual for o valor de page_size, a resposta pode incluir uma lista parcial, e o autor da chamada precisa confiar apenas no next_page_token da resposta para determinar se há mais clusters a serem consultados.
pageToken

string

Opcional. O valor next_page_token retornado de uma solicitação [ListBackupCollections] anterior, se houver.

Esquema de saída

Resposta para ListBackups.

ListBackupsResponse

Representação JSON 
{
  "backups": [
    {
      object (Backup)
    }
  ],
  "nextPageToken": string,
  "unreachable": [
    string
  ]
}
Campos
backups[]

object (Backup)

Uma lista de backups no projeto.
nextPageToken

string

Token para recuperar a próxima página de resultados ou um valor vazio se não houver mais resultados na lista.
unreachable[]

string

Backups que não puderam ser acessados.

Backup

Representação 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

Identificador. Caminho completo do recurso do backup. A última parte do nome é o ID do backup com o seguinte formato: [AAAAMMDDHHMMSS]_[UID abreviado do cluster] OU especificado pelo cliente durante o backup do cluster. Exemplo: 20240515123000_1234
createTime

string (Timestamp format)

Apenas saída. A hora em que o backup foi criado.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
cluster

string

Apenas saída. Caminho do recurso de cluster deste backup.
clusterUid

string

Apenas saída. UID do cluster deste backup.
totalSizeBytes

string (int64 format)

Apenas saída. Tamanho total do backup em bytes.
expireTime

string (Timestamp format)

Apenas saída. O horário em que o backup vai expirar.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
engineVersion

string

Apenas saída. redis-7.2, valkey-7.5
backupFiles[]

object (BackupFile)

Apenas saída. Lista de arquivos de backup do backup.
nodeType

enum (NodeType)

Apenas saída. Tipo de nó do cluster.
replicaCount

integer

Apenas saída. Número de réplicas do cluster.
shardCount

integer

Apenas saída. Número de fragmentos do cluster.
backupType

enum (BackupType)

Apenas saída. Tipo do backup.
state

enum (State)

Apenas saída. Estado do backup.
encryptionInfo

object (EncryptionInfo)

Apenas saída. Informações de criptografia do backup.
uid

string

Apenas saída. Identificador exclusivo atribuído pelo sistema ao backup.

Carimbo de data/hora

Representação JSON 
{
  "seconds": string,
  "nanos": integer
}
Campos
seconds

string (int64 format)

Representa os segundos do horário UTC desde a época Unix 1970-01-01T00:00:00Z. Precisa estar entre -62135596800 e 253402300799 (o que corresponde a 0001-01-01T00:00:00Z a 9999-12-31T23:59:59Z).
nanos

integer

Frações não negativas de um segundo com resolução de nanossegundos. Esse campo é a parte de nanossegundos da duração, não uma alternativa aos segundos. Os valores de segundos negativos com frações ainda precisam ter valores em nanossegundos não negativos que representam períodos posteriores. O valor precisa estar entre 0 e 999.999.999 (inclusive).

BackupFile

Representação JSON 
{
  "fileName": string,
  "sizeBytes": string,
  "createTime": string
}
Campos
fileName

string

Apenas saída. Por exemplo: .rdb
sizeBytes

string (int64 format)

Apenas saída. Tamanho do arquivo de backup em bytes.
createTime

string (Timestamp format)

Apenas saída. O horário em que o arquivo de backup foi criado.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

EncryptionInfo

Representação JSON 
{
  "encryptionType": enum (Type),
  "kmsKeyVersions": [
    string
  ],
  "kmsKeyPrimaryState": enum (KmsKeyState),
  "lastUpdateTime": string
}
Campos
encryptionType

enum (Type)

Apenas saída. Tipo de criptografia.
kmsKeyVersions[]

string

Apenas saída. Versões de chaves do KMS que estão sendo usadas para proteger os dados em repouso.
kmsKeyPrimaryState

enum (KmsKeyState)

Apenas saída. O estado da versão principal da chave do KMS percebido pelo sistema. Esse campo não é preenchido em backups.
lastUpdateTime

string (Timestamp format)

Apenas saída. A hora mais recente em que as informações de criptografia foram atualizadas.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

Anotações de ferramentas

Dica destrutiva: ❌ | Dica idempotente: ✅ | Dica somente leitura: ✅ | Dica de mundo aberto: ❌