MCP Tools Reference: cloud-sql

ツール: list_instances

プロジェクト内のすべての Cloud SQL インスタンスを一覧表示します。

次のサンプルは、curl を使用して list_instances MCP ツールを呼び出す方法を示しています。

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

入力スキーマ

インスタンス リスト リクエスト。

SqlInstancesListRequest

JSON 表現 
{
  "filter": string,
  "maxResults": integer,
  "pageToken": string,
  "project": string
}
フィールド
filter

string

レスポンスに含まれるリソースをフィルタリングするフィルタ式。式は「フィールド : 値」の形式です。たとえば、「instanceType:CLOUD_SQL_INSTANCE」です。フィールドは、「settings.userLabels.auto_start:true」など、JSON 表現に従って必要に応じてネストできます。

複数のフィルタ クエリはスペースで区切ります。例:「state:RUNNABLE instanceType:CLOUD_SQL_INSTANCE」です。デフォルトでは、各式は AND 式です。ただし、AND 式と OR 式は明示的に含めることができます。
maxResults

integer (uint32 format)

返されるインスタンスの最大数。サービスが返す値はこれよりも少ないことがあります。指定されていない場合は、最大で 500 個のインスタンスが返されます。最大値は 1,000 です。1,000 を超える値は 1,000 に強制変換されます。
pageToken

string

前に返されたページトークン。表示される大量の結果セットの一部を表します。
project

string

Cloud SQL インスタンスの一覧を取得するプロジェクトのプロジェクト ID。

出力スキーマ

MCP のインスタンス リスト レスポンス。

SqlInstancesListMcpResponse

JSON 表現 
{
  "kind": string,
  "warnings": [
    {
      object (ApiWarning)
    }
  ],
  "items": [
    {
      object (McpDatabaseInstance)
    }
  ],
  "nextPageToken": string
}
項目
kind

string

常に sql#instancesList になります。
warnings[]

object (ApiWarning)

リクエストの処理中に発生した警告のリスト。
items[]

object (McpDatabaseInstance)

mcp インスタンス リソースのリスト。
nextPageToken

string

大量の結果セットのページ割り付けに使用する、継続トークンです。次の結果ページを返すには、この値を次のリクエストに設定します。

ApiWarning

JSON 表現 
{
  "code": enum (SqlApiWarningCode),
  "message": string,
  "region": string
}
フィールド
code

enum (SqlApiWarningCode)

警告タイプを一意に識別するコード。
message

string

警告メッセージ
region

string

REGION_UNREACHABLE 警告のリージョン名。

McpDatabaseInstance

JSON 表現 
{
  "project": string,
  "name": string,
  "databaseVersion": string,
  "region": string,
  "edition": string,
  "tier": string,
  "dataDiskSizeGb": string,
  "availabilityType": string,
  "tags": {
    string: string,
    ...
  },
  "state": enum (SqlInstanceState)
}
フィールド
project

string

必須。 Cloud SQL インスタンスの一覧を取得するプロジェクトのプロジェクト ID。
name

string

必須。Cloud SQL インスタンスの名前。プロジェクト ID は含みません。
databaseVersion

string
region

string

省略可。Cloud SQL インスタンスの地理的リージョン。たとえば、us-central1、europe-west1、asia-east1 です。
edition

string

省略可。インスタンスのエディション。ENTERPRISE または ENTERPRISE_PLUS を指定できます。
tier

string

省略可。このインスタンスの階層（またはマシンタイプ）。
dataDiskSizeGb

string (Int64Value format)

省略可。データディスクのサイズ（GB）。デフォルト値は 100 です。
availabilityType

string

省略可。可用性タイプ。可能な値: * ZONAL: インスタンスは 1 つのゾーンからのみデータを提供します。そのゾーンが停止するとデータにアクセスできなくなる可能性があります。これはデフォルト値です。* REGIONAL: インスタンスはリージョン内の複数のゾーンからデータを提供できます（可用性が高い）。
tags

map (key: string, value: string)

省略可。入力専用。このインスタンスにバインドされているタグキーとタグ値。

"key": value ペアのリストを含むオブジェクト。例: { "name": "wrench", "mass": "1.3kg", "count": "3" }
state

enum (SqlInstanceState)

出力専用。Cloud SQL インスタンスの状態。

Int64Value

JSON 表現 
{
  "value": string
}
フィールド
value

string (int64 format)

int64 値。

TagsEntry

JSON 表現 
{
  "key": string,
  "value": string
}
フィールド
key

string
value

string

ツールのアノテーション

破壊的ヒント: ❌ | べき等ヒント: ❌ | 読み取り専用ヒント: ✅ | オープン ワールド ヒント: ❌