MCP Tools Reference: redis.googleapis.com

Tool: list_backup_collections

Alle Memorystore for Redis Cluster-Sicherungssammlungen auflisten.

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

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

Eingabeschema

Anfrage für ListBackupCollections.

ListBackupCollectionsRequest

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

string

Erforderlich. Der Ressourcenname des Standorts der Sicherungssammlung im Format projects/{project_id}/locations/{location_id}, wobei sich location_id auf eine Google Cloud-Region bezieht.

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 Wert für `page_size` kann die Antwort eine unvollständige Liste enthalten und ein Aufrufer sollte sich nur auf die next_page_token in der Antwort 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 ListBackupCollections.

ListBackupCollectionsResponse

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

object (BackupCollection)

Eine Liste der Sicherungssammlungen im Projekt.

Wenn location_id im übergeordneten Feld der Anfrage „-“ ist, werden alle für das Projekt verfügbaren Regionen abgefragt und die Ergebnisse zusammengefasst. Wenn bei einer solchen zusammengefassten Abfrage ein Standort nicht verfügbar ist, wird in die Antwort ein Platzhalter für die Sicherungssammlung aufgenommen. Das name wird auf einen Wert im Format projects/{project_id}/locations/{location_id}/backupCollections/- gesetzt und das status wird auf „ERROR“ gesetzt und das status_message wird auf „location not available for ListBackupCollections“ gesetzt.

nextPageToken

string

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

unreachable[]

string

Standorte, die nicht erreicht werden konnten.

BackupCollection

JSON-Darstellung
{
  "name": string,
  "clusterUid": string,
  "cluster": string,
  "kmsKey": string,
  "uid": string,
  "createTime": string,
  "totalBackupSizeBytes": string,
  "totalBackupCount": string,
  "lastBackupTime": string
}
Felder
name

string

ID. Vollständiger Ressourcenpfad der Sicherungssammlung.

clusterUid

string

Nur Ausgabe. Die Cluster-UID der Sicherungssammlung.

cluster

string

Nur Ausgabe. Der vollständige Ressourcenpfad des Clusters, zu dem die Sicherungssammlung gehört. Beispiel: projects/{project}/locations/{location}/clusters/{cluster}

kmsKey

string

Nur Ausgabe. Der KMS-Schlüssel, der zum Verschlüsseln der Sicherungen in dieser Sicherungssammlung verwendet wird.

uid

string

Nur Ausgabe. Die vom System zugewiesene eindeutige ID der Sicherungssammlung.

createTime

string (Timestamp format)

Nur Ausgabe. Der Zeitpunkt, zu dem die Sicherungssammlung 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"

totalBackupSizeBytes

string (int64 format)

Nur Ausgabe. Gesamtgröße aller Sicherungen in der Sicherungssammlung.

totalBackupCount

string (int64 format)

Nur Ausgabe. Gesamtzahl der Sicherungen in der Sicherungssammlung.

lastBackupTime

string (Timestamp format)

Nur Ausgabe. Der Zeitpunkt, zu dem die letzte Sicherung in der Sicherungssammlung 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".

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 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 ist der Nanosekundenanteil der Dauer und 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.

Toolanmerkungen

Destruktiver Hinweis: ❌ | Idempotenter Hinweis: ✅ | Hinweis „Nur lesen“: ✅ | Hinweis „Offene Welt“: ❌