MCP Tools Reference: cloud-sql

Strumento: list_instances

Elenca tutte le istanze Cloud SQL nel progetto.

Il seguente esempio mostra come utilizzare curl per richiamare lo strumento MCP list_instances.

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

Schema di input

Richiesta di elenco di istanze.

SqlInstancesListRequest

Rappresentazione JSON 
{
  "filter": string,
  "maxResults": integer,
  "pageToken": string,
  "project": string
}
Campi
filter

string

Un'espressione di filtro che filtra le risorse elencate nella risposta. L'espressione è nel formato campo:valore. Ad esempio, "instanceType:CLOUD_SQL_INSTANCE". I campi possono essere nidificati in base alle esigenze in base alla loro rappresentazione JSON, ad esempio "settings.userLabels.auto_start:true".

Le query di filtro multiple sono separate da spazi. Ad esempio: 'state:RUNNABLE instanceType:CLOUD_SQL_INSTANCE'. Per impostazione predefinita, ogni espressione è un'espressione AND. Tuttavia, puoi includere esplicitamente le espressioni AND e OR.
maxResults

integer (uint32 format)

Il numero massimo di istanze da restituire. Il servizio potrebbe restituire un numero inferiore a questo valore. Se non specificato, vengono restituite al massimo 500 istanze. Il valore massimo è 1000; i valori superiori a 1000 vengono forzati a 1000.
pageToken

string

Un token di pagina restituito in precedenza che rappresenta una parte del set più ampio di risultati da visualizzare.
project

string

ID progetto del progetto per cui elencare le istanze Cloud SQL.

Schema di output

Risposta all'elenco di istanze per MCP.

SqlInstancesListMcpResponse

Rappresentazione JSON 
{
  "kind": string,
  "warnings": [
    {
      object (ApiWarning)
    }
  ],
  "items": [
    {
      object (McpDatabaseInstance)
    }
  ],
  "nextPageToken": string
}
Campi
kind

string

Questo valore è sempre sql#instancesList.
warnings[]

object (ApiWarning)

Elenco degli avvisi che si sono verificati durante la gestione della richiesta.
items[]

object (McpDatabaseInstance)

Elenco delle risorse delle istanze mcp.
nextPageToken

string

Il token di continuazione, utilizzato per scorrere grandi set di risultati. Fornisci questo valore in una richiesta successiva per restituire la pagina successiva dei risultati.

ApiWarning

Rappresentazione JSON 
{
  "code": enum (SqlApiWarningCode),
  "message": string,
  "region": string
}
Campi
code

enum (SqlApiWarningCode)

Codice per identificare in modo univoco il tipo di avviso.
message

string

Il messaggio di avviso.
region

string

Il nome della regione per l'avviso REGION_UNREACHABLE.

McpDatabaseInstance

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

string

Obbligatorio. ID progetto del progetto per cui elencare le istanze Cloud SQL.
name

string

Obbligatorio. Nome dell'istanza Cloud SQL. L'ID progetto non è incluso.
databaseVersion

string
region

string

Facoltativo. La regione geografica dell'istanza Cloud SQL. Ad esempio, us-central1, europe-west1 e asia-east1.
edition

string

Facoltativo. La versione dell'istanza, che può essere ENTERPRISE o ENTERPRISE_PLUS.
tier

string

Facoltativo. Il livello (o tipo di macchina) per questa istanza.
dataDiskSizeGb

string (Int64Value format)

Facoltativo. Dimensione del disco dati in GB. Il valore predefinito è 100.
availabilityType

string

Facoltativo. Tipo di disponibilità. Valori potenziali: * ZONAL: l'istanza pubblica dati da una sola zona. Le interruzioni in questa zona influiscono sull'accessibilità dei dati. Questo è il valore predefinito. * REGIONAL: l'istanza può pubblicare dati da più zone in una regione (è a disponibilità elevata).
tags

map (key: string, value: string)

Facoltativo. Solo input. Chiavi e valori dei tag associati a questa istanza.

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
state

enum (SqlInstanceState)

Solo output. Stato dell'istanza Cloud SQL.

Int64Value

Rappresentazione JSON 
{
  "value": string
}
Campi
value

string (int64 format)

Il valore int64.

TagsEntry

Rappresentazione JSON 
{
  "key": string,
  "value": string
}
Campi
key

string
value

string

Annotazioni dello strumento

Suggerimento distruttivo: ❌ | Suggerimento idempotente: ❌ | Suggerimento di sola lettura: ✅ | Suggerimento open world: ❌