MCP Tools Reference: redis.googleapis.com

Ferramenta: list_backup_collections

Lista todas as coleções de backup do Memorystore for Redis Cluster.

O exemplo a seguir demonstra como usar curl para invocar a ferramenta list_backup_collections do 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_backup_collections",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Esquema de entrada

Solicitação de ListBackupCollections.

ListBackupCollectionsRequest

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

string

Obrigatório. O nome do recurso do local de backupCollection usando o formato: projects/{project_id}/locations/{location_id}, em que location_id se refere a uma região do Google Cloud.
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 poderá incluir uma lista parcial, e o autor da chamada precisará 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 ListBackupCollections.

ListBackupCollectionsResponse

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

object (BackupCollection)

Uma lista de backupCollections no projeto.

Se o location_id no campo pai da solicitação for "-", todas as regiões disponíveis para o projeto serão consultadas e os resultados, agregados. Se, em uma consulta agregada, um local não estiver disponível, uma entrada de backupCollection de marcador será incluída na resposta com o name definido como um valor do formulário projects/{project_id}/locations/{location_id}/backupCollections/- e o status definido como ERROR e o status_message definido como "local não disponível para ListBackupCollections".
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

Locais que não puderam ser alcançados.

BackupCollection

Representação JSON 
{
  "name": string,
  "clusterUid": string,
  "cluster": string,
  "kmsKey": string,
  "uid": string,
  "createTime": string,
  "totalBackupSizeBytes": string,
  "totalBackupCount": string,
  "lastBackupTime": string
}
Campos
name

string

Identificador. Caminho completo do recurso da coleção de backup.
clusterUid

string

Apenas saída. O uid do cluster da coleção de backup.
cluster

string

Apenas saída. O caminho completo do recurso do cluster a que a coleção de backup pertence. Exemplo: projects/{project}/locations/{location}/clusters/{cluster}
kmsKey

string

Apenas saída. A chave do KMS usada para criptografar os backups nessa coleção.
uid

string

Apenas saída. Identificador exclusivo da coleção de backup atribuído pelo sistema.
createTime

string (Timestamp format)

Apenas saída. O horário em que a coleção de backup foi criada.

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

string (int64 format)

Apenas saída. Tamanho total de todos os backups na coleção.
totalBackupCount

string (int64 format)

Apenas saída. Número total de backups na coleção.
lastBackupTime

string (Timestamp format)

Apenas saída. A última vez que um backup foi criado na coleção.

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

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 (inclusive), 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 a segundos. Os valores de segundos negativos com frações ainda precisam ter valores em nanossegundos não negativos que representam períodos posteriores. Precisa estar entre 0 e 999.999.999 (inclusive).

Anotações da ferramenta

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