MCP Tools Reference: cloud-sql

Outil : list_instances

Répertorie toutes les instances Cloud SQL du projet.

L'exemple suivant montre comment utiliser curl pour appeler l'outil MCP list_instances.

Requête curl 
                  
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
}'

Schéma d'entrée

Requête de liste d'instances.

SqlInstancesListRequest

Représentation JSON 
{
  "filter": string,
  "maxResults": integer,
  "pageToken": string,
  "project": string
}
Champs
filter

string

Expression de filtre qui filtre les ressources répertoriées dans la réponse. L'expression est au format champ:valeur. Par exemple, "instanceType:CLOUD_SQL_INSTANCE". Les champs peuvent être imbriqués selon les besoins, conformément à leur représentation JSON, par exemple "settings.userLabels.auto_start:true".

Plusieurs requêtes de filtrage sont séparées par un espace. Par exemple, 'state:RUNNABLE instanceType:CLOUD_SQL_INSTANCE'. Par défaut, chaque expression est une expression AND. Toutefois, vous pouvez inclure explicitement des expressions AND et OR.
maxResults

integer (uint32 format)

Nombre maximal d'instances à renvoyer. Le service peut renvoyer un nombre inférieur à cette valeur. Si aucune valeur n'est spécifiée, 500 instances au maximum sont renvoyées. La valeur maximale est 1 000. Les valeurs supérieures sont réduites à 1 000.
pageToken

string

Jeton de page précédemment renvoyé et représentant une partie de l'ensemble des résultats à afficher.
project

string

ID du projet pour lequel lister les instances Cloud SQL.

Schéma de sortie

Réponse de la liste des instances pour MCP.

SqlInstancesListMcpResponse

Représentation JSON 
{
  "kind": string,
  "warnings": [
    {
      object (ApiWarning)
    }
  ],
  "items": [
    {
      object (McpDatabaseInstance)
    }
  ],
  "nextPageToken": string
}
Champs
kind

string

Il s'agit toujours de sql#instancesList.
warnings[]

object (ApiWarning)

Liste des avertissements qui se sont produits lors du traitement de la requête.
items[]

object (McpDatabaseInstance)

Liste des ressources d'instance MCP.
nextPageToken

string

Jeton de continuité servant à parcourir les ensembles de résultats volumineux. Indiquez cette valeur dans une requête ultérieure pour renvoyer la page de résultats suivante.

ApiWarning

Représentation JSON 
{
  "code": enum (SqlApiWarningCode),
  "message": string,
  "region": string
}
Champs
code

enum (SqlApiWarningCode)

Code permettant d'identifier de manière unique le type d'avertissement.
message

string

Message d'avertissement
region

string

Nom de la région pour l'avertissement REGION_UNREACHABLE.

McpDatabaseInstance

Représentation JSON 
{
  "project": string,
  "name": string,
  "databaseVersion": string,
  "region": string,
  "edition": string,
  "tier": string,
  "dataDiskSizeGb": string,
  "availabilityType": string,
  "tags": {
    string: string,
    ...
  },
  "state": enum (SqlInstanceState)
}
Champs
project

string

Obligatoire. ID du projet pour lequel lister les instances Cloud SQL.
name

string

Obligatoire. Nom de l'instance Cloud SQL. Ce paramètre n'inclut pas l'ID du projet.
databaseVersion

string
region

string

Facultatif. Région géographique de l'instance Cloud SQL. Par exemple, us-central1, europe-west1 et asia-east1.
edition

string

Facultatif. Édition de l'instance, qui peut être ENTERPRISE ou ENTERPRISE_PLUS.
tier

string

Facultatif. Niveau (ou type de machine) de cette instance.
dataDiskSizeGb

string (Int64Value format)

Facultatif. Taille du disque de données en Go. La valeur par défaut est 100.
availabilityType

string

Facultatif. Type de disponibilité. Valeurs possibles : * ZONAL : l'instance ne diffuse des données que depuis une seule zone. Les pannes dans cette zone affectent l'accessibilité des données. Il s'agit de la valeur par défaut. * REGIONAL : l'instance peut diffuser des données provenant de plusieurs zones d'une région (elle est disponibilité élevée).
tags

map (key: string, value: string)

Facultatif. Uniquement en entrée. Clés et valeurs de tag associées à cette instance.

Objet contenant une liste de paires "key": value. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.
state

enum (SqlInstanceState)

Uniquement en sortie. État de l'instance Cloud SQL.

Int64Value

Représentation JSON 
{
  "value": string
}
Champs
value

string (int64 format)

Valeur int64.

TagsEntry

Représentation JSON 
{
  "key": string,
  "value": string
}
Champs
key

string
value

string

Annotations d'outils

Indication de destruction : ❌ | Indication d'idempotence : ❌ | Indication de lecture seule : ✅ | Indication de monde ouvert : ❌