MCP Tools Reference: cloud-sql

Alat: list_instances

Mencantumkan semua instance Cloud SQL dalam project.

Contoh berikut menunjukkan cara menggunakan curl untuk memanggil alat MCP list_instances.

Permintaan 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
}'

Skema Input

Permintaan daftar instance.

SqlInstancesListRequest

Representasi JSON 
{
  "filter": string,
  "maxResults": integer,
  "pageToken": string,
  "project": string
}
Kolom
filter

string

Ekspresi filter yang memfilter resource yang tercantum dalam respons. Ekspresi dalam bentuk field:value. Misalnya, 'instanceType:CLOUD_SQL_INSTANCE'. Kolom dapat disusun bertingkat sesuai kebutuhan berdasarkan representasi JSON-nya, seperti 'settings.userLabels.auto_start:true'.

Beberapa kueri filter dipisahkan dengan spasi. Misalnya. 'state:RUNNABLE instanceType:CLOUD_SQL_INSTANCE'. Secara default, setiap ekspresi adalah ekspresi AND. Namun, Anda dapat menyertakan ekspresi AND dan OR secara eksplisit.
maxResults

integer (uint32 format)

Jumlah maksimum instance yang akan ditampilkan. Layanan mungkin menampilkan lebih sedikit dari nilai ini. Jika tidak ditentukan, paling banyak 500 instance akan ditampilkan. Nilai maksimum adalah 1.000; nilai di atas 1.000 akan dikonversi menjadi 1.000.
pageToken

string

Token halaman yang sebelumnya ditampilkan yang merepresentasikan bagian dari kumpulan hasil yang lebih besar untuk dilihat.
project

string

Project ID project yang instance Cloud SQL-nya akan dicantumkan.

Skema Output

Respons daftar instance untuk MCP.

SqlInstancesListMcpResponse

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

string

Ini selalu sql#instancesList.
warnings[]

object (ApiWarning)

Daftar peringatan yang terjadi saat menangani permintaan.
items[]

object (McpDatabaseInstance)

Daftar resource instance mcp.
nextPageToken

string

Token lanjutan, yang digunakan untuk melihat halaman melalui kumpulan hasil yang besar. Berikan nilai ini dalam permintaan berikutnya untuk menampilkan halaman hasil berikutnya.

ApiWarning

Representasi JSON 
{
  "code": enum (SqlApiWarningCode),
  "message": string,
  "region": string
}
Kolom
code

enum (SqlApiWarningCode)

Kode untuk mengidentifikasi jenis peringatan secara unik.
message

string

Pesan peringatan.
region

string

Nama wilayah untuk peringatan REGION_UNREACHABLE.

McpDatabaseInstance

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

string

Wajib. Project ID project yang instance Cloud SQL-nya akan dicantumkan.
name

string

Wajib. Nama instance Cloud SQL. Ini tidak menyertakan project ID.
databaseVersion

string
region

string

Opsional. Region geografis instance Cloud SQL. Misalnya, us-central1, europe-west1, dan asia-east1.
edition

string

Opsional. Edisi instance, dapat berupa ENTERPRISE atau ENTERPRISE_PLUS.
tier

string

Opsional. Tingkatan (atau jenis mesin) untuk instance ini.
dataDiskSizeGb

string (Int64Value format)

Opsional. Ukuran disk data dalam GB. Nilai defaultnya adalah 100.
availabilityType

string

Opsional. Jenis ketersediaan. Nilai yang mungkin: * ZONAL: Instance menyajikan data hanya dari satu zona. Pemadaman layanan di zona tersebut memengaruhi aksesibilitas data. Ini adalah nilai defaultnya. * REGIONAL: Instance dapat menyajikan data dari lebih dari satu zona dalam suatu region (memiliki ketersediaan tinggi).
tags

map (key: string, value: string)

Opsional. Hanya input. Kunci tag dan nilai tag yang terikat ke instance ini.

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
state

enum (SqlInstanceState)

Hanya output. Status instance Cloud SQL.

Int64Value

Representasi JSON 
{
  "value": string
}
Kolom
value

string (int64 format)

Nilai int64.

TagsEntry

Representasi JSON 
{
  "key": string,
  "value": string
}
Kolom
key

string
value

string

Anotasi Alat

Petunjuk Destruktif: ❌ | Petunjuk Idempoten: ❌ | Petunjuk Hanya Baca: ✅ | Petunjuk Dunia Terbuka: ❌