MCP Tools Reference: cloud-sql

Tool: list_instances

Alle Cloud SQL-Instanzen im Projekt auflisten.

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

Curl-Anfrage 
                  
curl --location 'https://sqladmin.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "list_instances",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Eingabeschema

Anfrage an die Instanzliste.

SqlInstancesListRequest

JSON-Darstellung 
{
  "filter": string,
  "maxResults": integer,
  "pageToken": string,
  "project": string
}
Felder
filter

string

Ein Filterausdruck, der in der Antwort aufgeführte Ressourcen filtert. Der Ausdruck hat das Format "field:value". Beispiel: "instanceType: CLOUD_SQL_INSTANCE". Felder können je nach JSON-Darstellung verschachtelt werden, z. B. "settings.userLabels.auto_start:true".

Mehrere Filterabfragen werden durch Leerzeichen getrennt. Beispiel: 'state:RUNNABLE instanceType:CLOUD_SQL_INSTANCE'. Standardmäßig ist jeder Ausdruck ein AND-Ausdruck. Sie können jedoch AND- und OR-Ausdrücke explizit einfügen.
maxResults

integer (uint32 format)

Die maximale Anzahl der zurückzugebenden Instanzen. Der Dienst gibt möglicherweise weniger als diesen Wert zurück. Wenn nicht angegeben, werden maximal 500 Instanzen zurückgegeben. Der Höchstwert ist 1.000. Werte über 1.000 werden implizit auf 1.000 umgewandelt.
pageToken

string

Ein zuvor zurückgegebenes Seitentoken, das einen Teil der größeren anzuzeigenden Ergebnisse darstellt.
project

string

Projekt-ID des Projekts, für das Cloud SQL-Instanzen aufgelistet werden sollen.

Ausgabeschema

Antwort der Instanzliste für MCP.

SqlInstancesListMcpResponse

JSON-Darstellung 
{
  "kind": string,
  "warnings": [
    {
      object (ApiWarning)
    }
  ],
  "items": [
    {
      object (McpDatabaseInstance)
    }
  ],
  "nextPageToken": string
}
Felder
kind

string

Dies ist immer sql#instancesList.
warnings[]

object (ApiWarning)

Liste der Warnungen, die bei der Verarbeitung der Anfrage aufgetreten sind.
items[]

object (McpDatabaseInstance)

Liste der MCP-Instanzressourcen.
nextPageToken

string

Das Fortsetzungstoken, das zum Durchblättern großer Ergebnismengen verwendet wird. Geben Sie diesen Wert in einer nachfolgenden Anfrage an, um die nächste Ergebnisseite zurückzugeben.

ApiWarning

JSON-Darstellung 
{
  "code": enum (SqlApiWarningCode),
  "message": string,
  "region": string
}
Felder
code

enum (SqlApiWarningCode)

Code zur eindeutigen Identifizierung des Warnungstyps.
message

string

Warnmeldung.
region

string

Der Name der Region für die Warnung REGION_UNREACHABLE.

McpDatabaseInstance

JSON-Darstellung 
{
  "project": string,
  "name": string,
  "databaseVersion": string,
  "region": string,
  "edition": string,
  "tier": string,
  "dataDiskSizeGb": string,
  "availabilityType": string,
  "tags": {
    string: string,
    ...
  },
  "state": enum (SqlInstanceState)
}
Felder
project

string

Erforderlich. Projekt-ID des Projekts, für das Cloud SQL-Instanzen aufgelistet werden sollen.
name

string

Erforderlich. Name der Cloud SQL-Instanz. Die Projekt-ID ist darin nicht enthalten.
databaseVersion

string
region

string

Optional. Die geografische Region der Cloud SQL-Instanz. Zum Beispiel: us-central1, europe-west1 und asia-east1.
edition

string

Optional. Die Version der Instanz kann ENTERPRISE oder ENTERPRISE_PLUS sein.
tier

string

Optional. Die Stufe oder der Maschinentyp für diese Instanz.
dataDiskSizeGb

string (Int64Value format)

Optional. Größe des Datenlaufwerks in GB. Der Standardwert ist 100.
availabilityType

string

Optional. Verfügbarkeitstyp Mögliche Werte: * ZONAL: Die Instanz stellt Daten aus nur einer Zone bereit. Ausfälle in dieser Zone wirken sich auf die Datenverfügbarkeit aus. Dies ist der Standardwert. * REGIONAL: Die Instanz kann Daten aus mehreren Zonen in einer Region bereitstellen (hohe Verfügbarkeit).
tags

map (key: string, value: string)

Optional. Nur Eingabe. Tag-Schlüssel und Tag-Werte, die an diese Instanz gebunden sind.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
state

enum (SqlInstanceState)

Nur Ausgabe. Status der Cloud SQL-Instanz.

Int64Value

JSON-Darstellung 
{
  "value": string
}
Felder
value

string (int64 format)

Der int64-Wert.

TagsEntry

JSON-Darstellung 
{
  "key": string,
  "value": string
}
Felder
key

string
value

string

Tool-Annotationen

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