MCP Tools Reference: memorystore.googleapis.com

工具：list_backups

列出所有 Memorystore for Valkey 备份。

以下示例演示了如何使用 curl 调用 list_backups MCP 工具。

Curl 请求 
                  
curl --location 'https://memorystore.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
}'

输入架构

对 ListBackups 的请求。

ListBackupsRequest

JSON 表示法 
{
  "parent": string,
  "pageSize": integer,
  "pageToken": string
}
字段
parent

string

必需。backupCollection 的资源名称，格式为：projects/{project_id}/locations/{location_id}/backupCollections/{backup_collection_id}
pageSize

integer

可选。需要返回的最大项数。

如果未指定，则服务将使用默认值 1000。无论 page_size 值如何，响应都可能包含部分列表，调用方应仅依赖响应的 next_page_token 来确定是否还有更多集群需要查询。
pageToken

string

可选。从之前的 ListBackupCollections 请求返回的 next_page_token 值（如果有）。

输出架构

对 ListBackups 的响应。

ListBackupsResponse

JSON 表示法 
{
  "backups": [
    {
      object (Backup)
    }
  ],
  "nextPageToken": string,
  "unreachable": [
    string
  ]
}
字段
backups[]

object (Backup)

项目中的备份列表。
nextPageToken

string

用于检索下一页结果的令牌。如果列表中没有更多结果，则为空。
unreachable[]

string

无法访问的备份。

备份

JSON 表示法 
{
  "name": string,
  "createTime": string,
  "instance": string,
  "instanceUid": 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
}
字段
name

string

标识符。备份的完整资源路径。名称的最后一部分是备份 ID，格式如下：[YYYYMMDDHHMMSS]_[缩短的实例 UID] 或客户在备份实例时指定的 ID。示例：20240515123000_1234
createTime

string (Timestamp format)

仅限输出。备份的创建时间。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
instance

string

仅限输出。此备份的实例资源路径。
instanceUid

string

仅限输出。此备份的实例 UID。
totalSizeBytes

string (int64 format)

仅限输出。备份的总大小（以字节为单位）。
expireTime

string (Timestamp format)

仅限输出。备份的到期时间。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
engineVersion

string

仅限输出。valkey-7.5/valkey-8.0 等。
backupFiles[]

object (BackupFile)

仅限输出。备份的备份文件列表。
nodeType

enum (NodeType)

仅限输出。实例的节点类型。
replicaCount

integer

仅限输出。实例的副本数。
shardCount

integer

仅限输出。实例的分片数。
backupType

enum (BackupType)

仅限输出。备份的类型。
state

enum (State)

仅限输出。备份的状态。
encryptionInfo

object (EncryptionInfo)

仅限输出。备份的加密信息。
uid

string

仅限输出。系统为备份分配的唯一标识符。

时间戳

JSON 表示法 
{
  "seconds": string,
  "nanos": integer
}
字段
seconds

string (int64 format)

表示世界协调时间 (UTC) 的秒数（从 Unix 纪元 1970-01-01T00:00:00Z 开始算起）。必须介于 -62135596800 和 253402300799 之间（含边界值），对应于 0001-01-01T00:00:00Z 到 9999-12-31T23:59:59Z。
nanos

integer

秒数的非负小数部分（以纳秒为单位）。此字段是时长的纳秒部分，而不是秒的替代值。对于含小数部分的负秒数，仍必须包含按时间递升的非负纳秒值。必须在 0 到 999,999,999 之间（含边界值）。

BackupFile

JSON 表示法 
{
  "fileName": string,
  "sizeBytes": string,
  "createTime": string
}
字段
fileName

string

仅限输出。例如：.rdb
sizeBytes

string (int64 format)

仅限输出。备份文件的大小（以字节为单位）。
createTime

string (Timestamp format)

仅限输出。备份文件的创建时间。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。

EncryptionInfo

JSON 表示法 
{
  "encryptionType": enum (Type),
  "kmsKeyVersions": [
    string
  ],
  "kmsKeyPrimaryState": enum (KmsKeyState),
  "lastUpdateTime": string
}
字段
encryptionType

enum (Type)

仅限输出。加密类型。
kmsKeyVersions[]

string

仅限输出。用于保护静态数据的 KMS 密钥版本。
kmsKeyPrimaryState

enum (KmsKeyState)

仅限输出。系统感知的 KMS 密钥主要版本的状态。此字段不会在备份中填充。
lastUpdateTime

string (Timestamp format)

仅限输出。加密信息最近一次更新的时间。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。

工具注释

破坏性提示：❌ | 等幂性提示：✅ | 只读提示：✅ | 开放世界提示：❌