MCP Tools Reference: cloud-sql

Ferramenta: list_instances

Liste todas as instâncias do Cloud SQL no projeto.

O exemplo a seguir demonstra como usar curl para invocar a ferramenta list_instances MCP.

Solicitação 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

Solicitação de lista de instâncias.

SqlInstancesListRequest

Representação JSON 
{
  "filter": string,
  "maxResults": integer,
  "pageToken": string,
  "project": string
}
Campos
filter

string

Uma expressão de filtro que filtra os recursos listados na resposta. A expressão está na forma de field:value. Por exemplo, "instanceType:CLOUD_SQL_INSTANCE". Os campos podem ser aninhados conforme necessário de acordo com a representação JSON, como "settings.userLabels.auto_start:true".

Várias consultas de filtro são separadas por um espaço. Por exemplo. 'state:RUNNABLE instanceType:CLOUD_SQL_INSTANCE'. Por padrão, cada expressão é uma expressão AND. No entanto, você pode incluir expressões AND e OR explicitamente.
maxResults

integer (uint32 format)

O número máximo de instâncias a serem retornadas. O serviço pode retornar um valor inferior a este. Se não for especificado, no máximo 500 instâncias serão retornadas. O valor máximo é 1.000. Valores maiores serão convertidos para 1.000.
pageToken

string

Um token de página retornado anteriormente representando parte do conjunto maior de resultados para exibição.
project

string

ID do projeto para em que listar as instâncias do Cloud SQL.

Esquema de saída

Resposta da lista de instâncias para o MCP.

SqlInstancesListMcpResponse

Representação JSON 
{
  "kind": string,
  "warnings": [
    {
      object (ApiWarning)
    }
  ],
  "items": [
    {
      object (McpDatabaseInstance)
    }
  ],
  "nextPageToken": string
}
Campos
kind

string

É sempre sql#instancesList.
warnings[]

object (ApiWarning)

Lista de avisos que ocorreram durante o processamento da solicitação.
items[]

object (McpDatabaseInstance)

Lista de recursos de instância do MCP.
nextPageToken

string

O token de continuação, usado para percorrer conjuntos grandes de resultados. Forneça esse valor em uma solicitação subsequente para retornar a próxima página de resultados.

ApiWarning

Representação JSON 
{
  "code": enum (SqlApiWarningCode),
  "message": string,
  "region": string
}
Campos
code

enum (SqlApiWarningCode)

Código para identificar exclusivamente o tipo de aviso.
message

string

A mensagem de aviso.
region

string

O nome da região para o aviso REGION_UNREACHABLE.

McpDatabaseInstance

Representação 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

Obrigatório. ID do projeto para em que listar as instâncias do Cloud SQL.
name

string

Obrigatório. Nome da instância do Cloud SQL. Isso não inclui o ID do projeto.
databaseVersion

string
region

string

Opcional. A região geográfica da instância do Cloud SQL. Por exemplo, us-central1, europe-west1 e asia-east1.
edition

string

Opcional. A edição da instância, que pode ser "ENTERPRISE" ou "ENTERPRISE_PLUS".
tier

string

Opcional. O nível (ou tipo de máquina) dessa instância.
dataDiskSizeGb

string (Int64Value format)

Opcional. Tamanho do disco de dados em GB. O valor padrão é 100.
availabilityType

string

Opcional. Tipo de disponibilidade. Valores possíveis: * ZONAL: a instância veicula dados de apenas uma zona. As interrupções nessa zona afetam a acessibilidade dos dados. Esse é o valor padrão. * REGIONAL: a instância pode veicular dados de mais de uma zona em uma região (ela é altamente disponível).
tags

map (key: string, value: string)

Opcional. Somente entrada. Chaves e valores de tag vinculados a esta instância.

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
state

enum (SqlInstanceState)

Apenas saída. Estado da instância do Cloud SQL.

Int64Value

Representação JSON 
{
  "value": string
}
Campos
value

string (int64 format)

O valor int64.

TagsEntry

Representação JSON 
{
  "key": string,
  "value": string
}
Campos
key

string
value

string

Anotações de ferramentas

Dica destrutiva: ❌ | Dica idempotente: ❌ | Dica somente leitura: ✅ | Dica de mundo aberto: ❌