MCP Tools Reference: memorystore.googleapis.com

Tool: list_backups

Alle Memorystore for Valkey-Sicherungen auflisten.

Im folgenden Beispiel wird gezeigt, wie Sie mit curl das MCP-Tool list_backups aufrufen.

Curl-Anfrage 
                  
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
}'

Eingabeschema

Anfrage für ListBackups.

ListBackupsRequest

JSON-Darstellung 
{
  "parent": string,
  "pageSize": integer,
  "pageToken": string
}
Felder
parent

string

Erforderlich. Der Ressourcenname der BackupCollection im Format projects/{project_id}/locations/{location_id}/backupCollections/{backup_collection_id}.
pageSize

integer

Optional. Die maximale Anzahl der Elemente, die zurückgegeben werden sollen.

Wenn nicht angegeben, wird vom Dienst der Standardwert 1.000 verwendet. Unabhängig vom page_size-Wert kann die Antwort eine unvollständige Liste enthalten und ein Aufrufer sollte sich nur auf die Antwort next_page_token verlassen, um zu bestimmen, ob noch weitere Cluster abzufragen sind.
pageToken

string

Optional. Der Wert next_page_token wurde gegebenenfalls von einer vorherigen ListBackupCollections-Anfrage zurückgegeben.

Ausgabeschema

Antwort für ListBackups.

ListBackupsResponse

JSON-Darstellung 
{
  "backups": [
    {
      object (Backup)
    }
  ],
  "nextPageToken": string,
  "unreachable": [
    string
  ]
}
Felder
backups[]

object (Backup)

Eine Liste der Sicherungen im Projekt.
nextPageToken

string

Token zum Abrufen der nächsten Ergebnisseite. Leer, wenn keine weiteren Ergebnisse in der Liste vorhanden sind.
unreachable[]

string

Sicherungen, die nicht erreicht werden konnten.

Sicherung

JSON-Darstellung 
{
  "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
}
Felder
name

string

ID. Vollständiger Ressourcenpfad der Sicherung. Der letzte Teil des Namens ist die Sicherungs-ID im folgenden Format: [YYYYMMDDHHMMSS]_[Shorted Instance UID] ODER vom Kunden bei der Sicherungsinstanz angegeben. Beispiel: 20240515123000_1234
createTime

string (Timestamp format)

Nur Ausgabe. Der Zeitpunkt, zu dem die Sicherung erstellt wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
instance

string

Nur Ausgabe. Der Instanzressourcenpfad dieser Sicherung.
instanceUid

string

Nur Ausgabe. Die Instanz-UID dieser Sicherung.
totalSizeBytes

string (int64 format)

Nur Ausgabe. Gesamtgröße der Sicherung in Byte.
expireTime

string (Timestamp format)

Nur Ausgabe. Der Zeitpunkt, zu dem die Sicherung abläuft.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
engineVersion

string

Nur Ausgabe. valkey-7.5/valkey-8.0 usw.
backupFiles[]

object (BackupFile)

Nur Ausgabe. Liste der Sicherungsdateien der Sicherung.
nodeType

enum (NodeType)

Nur Ausgabe. Knotentyp der Instanz.
replicaCount

integer

Nur Ausgabe. Anzahl der Replikate für die Instanz.
shardCount

integer

Nur Ausgabe. Anzahl der Shards für die Instanz.
backupType

enum (BackupType)

Nur Ausgabe. Typ der Sicherung.
state

enum (State)

Nur Ausgabe. Status der Sicherung.
encryptionInfo

object (EncryptionInfo)

Nur Ausgabe. Verschlüsselungsinformationen der Sicherung.
uid

string

Nur Ausgabe. Die vom System zugewiesene eindeutige Kennung der Sicherung.

Zeitstempel

JSON-Darstellung 
{
  "seconds": string,
  "nanos": integer
}
Felder
seconds

string (int64 format)

Stellt Sekunden der UTC-Zeit seit Unix-Epoche 1970-01-01T00:00:00Z dar. Muss einschließlich zwischen -62135596800 und 253402300799 liegen (entspricht 0001-01-01T00:00:00Z bis 9999-12-31T23:59:59Z).
nanos

integer

Nicht negative Sekundenbruchteile Nanosekunden-Auflösung. Dieses Feld enthält den Nanosekundenanteil der Dauer und ist keine Alternative zu Sekunden. Negative Sekundenwerte mit Bruchteilen müssen weiterhin nicht negative Nano-Werte haben, die zeitlich vorwärts gezählt werden. Muss zwischen 0 und 999.999.999 liegen (einschließlich).

BackupFile

JSON-Darstellung 
{
  "fileName": string,
  "sizeBytes": string,
  "createTime": string
}
Felder
fileName

string

Nur Ausgabe, z. B..rdb
sizeBytes

string (int64 format)

Nur Ausgabe. Größe der Sicherungsdatei in Byte.
createTime

string (Timestamp format)

Nur Ausgabe. Der Zeitpunkt, zu dem die Sicherungsdatei erstellt wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

EncryptionInfo

JSON-Darstellung 
{
  "encryptionType": enum (Type),
  "kmsKeyVersions": [
    string
  ],
  "kmsKeyPrimaryState": enum (KmsKeyState),
  "lastUpdateTime": string
}
Felder
encryptionType

enum (Type)

Nur Ausgabe. Verschlüsselungstyp.
kmsKeyVersions[]

string

Nur Ausgabe. KMS-Schlüsselversionen, die zum Schutz der ruhenden Daten verwendet werden.
kmsKeyPrimaryState

enum (KmsKeyState)

Nur Ausgabe. Der vom System wahrgenommene Status der primären Version des KMS-Schlüssels. Dieses Feld wird in Sicherungen nicht ausgefüllt.
lastUpdateTime

string (Timestamp format)

Nur Ausgabe. Der Zeitpunkt, zu dem die Verschlüsselungsinformationen zuletzt aktualisiert wurden.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

Tool-Annotationen

Destruktiver Hinweis: ❌ | Idempotenter Hinweis: ✅ | Nur-Lese-Hinweis: ✅ | Open-World-Hinweis: ❌