MCP Tools Reference: cloud-sql

Herramienta: list_instances

Enumera todas las instancias de Cloud SQL en el proyecto.

En el siguiente ejemplo, se muestra cómo usar curl para invocar la herramienta de MCP list_instances.

Solicitud de 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
}'

Esquema de entrada

Es la solicitud de la lista de instancias.

SqlInstancesListRequest

Representación JSON 
{
  "filter": string,
  "maxResults": integer,
  "pageToken": string,
  "project": string
}
Campos
filter

string

Es una expresión de filtro que filtra los recursos enumerados en la respuesta. La expresión tiene el formato campo:valor. Por ejemplo, "instanceType:CLOUD_SQL_INSTANCE". Los campos se pueden anidar según sea necesario, de acuerdo con su representación JSON, como "settings.userLabels.auto_start:true".

Las consultas de varios filtros se separan con espacios. Por ejemplo: 'state:RUNNABLE instanceType:CLOUD_SQL_INSTANCE'. De forma predeterminada, cada expresión es una expresión AND. Sin embargo, puedes incluir expresiones AND y OR de forma explícita.
maxResults

integer (uint32 format)

Es la cantidad máxima de instancias que se devolverán. El servicio puede mostrar menos que este valor. Si no se especifica, se devolverán, como máximo, 500 instancias. Como el valor máximo es 1,000, los valores superiores se convertirán a 1,000.
pageToken

string

Un token de página que se mostró antes y que representa parte del conjunto más grande de resultados para ver.
project

string

El ID del proyecto para el que se enumeran las instancias de Cloud SQL.

Esquema de salida

Es la respuesta de la lista de instancias para MCP.

SqlInstancesListMcpResponse

Representación JSON 
{
  "kind": string,
  "warnings": [
    {
      object (ApiWarning)
    }
  ],
  "items": [
    {
      object (McpDatabaseInstance)
    }
  ],
  "nextPageToken": string
}
Campos
kind

string

Siempre es sql#instancesList.
warnings[]

object (ApiWarning)

Es la lista de advertencias que se produjeron durante el procesamiento de la solicitud.
items[]

object (McpDatabaseInstance)

Es la lista de recursos de instancias de MCP.
nextPageToken

string

Es el token de continuación, que se usa para desplazarse por grandes conjuntos de resultados. Proporciona este valor en una solicitud posterior para mostrar la página siguiente de resultados.

ApiWarning

Representación JSON 
{
  "code": enum (SqlApiWarningCode),
  "message": string,
  "region": string
}
Campos
code

enum (SqlApiWarningCode)

Es el código que identifica de forma única el tipo de advertencia.
message

string

Es el mensaje de advertencia.
region

string

Es el nombre de la región para la advertencia REGION_UNREACHABLE.

McpDatabaseInstance

Representación JSON 
{
  "project": string,
  "name": string,
  "databaseVersion": string,
  "region": string,
  "edition": string,
  "tier": string,
  "dataDiskSizeGb": string,
  "availabilityType": string,
  "tags": {
    string: string,
    ...
  },
  "state": enum (SqlInstanceState)
}
Campos
project

string

Obligatorio. El ID del proyecto para el que se enumeran las instancias de Cloud SQL.
name

string

Obligatorio. Es el nombre de la instancia de Cloud SQL. Esto no incluye el ID del proyecto.
databaseVersion

string
region

string

Es opcional. Es la región geográfica de la instancia de Cloud SQL. Por ejemplo, us-central1, europe-west1 y asia-east1.
edition

string

Es opcional. Es la edición de la instancia y puede ser ENTERPRISE o ENTERPRISE_PLUS.
tier

string

Es opcional. Es el nivel (o tipo de máquina) de esta instancia.
dataDiskSizeGb

string (Int64Value format)

Es opcional. Tamaño del disco de datos en GB. El valor predeterminado es 100.
availabilityType

string

Es opcional. Es el tipo de disponibilidad. Valores posibles: * ZONAL: La instancia solo entrega datos de una zona. Las interrupciones en esa zona afectan la accesibilidad a los datos. Este es el valor predeterminado. * REGIONAL: La instancia puede entregar datos desde más de una zona en una región (tiene alta disponibilidad).
tags

map (key: string, value: string)

Es opcional. Solo entrada. Son las claves y los valores de las etiquetas que están vinculados a esta instancia.

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
state

enum (SqlInstanceState)

Solo salida. Es el estado de la instancia de Cloud SQL.

Int64Value

Representación JSON 
{
  "value": string
}
Campos
value

string (int64 format)

Es el valor int64.

TagsEntry

Representación JSON 
{
  "key": string,
  "value": string
}
Campos
key

string
value

string

Anotaciones de herramientas

Sugerencia destructiva: ❌ | Sugerencia idempotente: ❌ | Sugerencia de solo lectura: ✅ | Sugerencia de mundo abierto: ❌