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: 인스턴스가 하나의 영역에서만 데이터를 제공합니다. 해당 영역의 서비스 중단은 데이터 액세스 가능성에 영향을 미칩니다. 기본값입니다. * 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

도구 주석

파괴적 힌트: ❌ | 동일한 힌트: ❌ | 읽기 전용 힌트: ✅ | 오픈 월드 힌트: ❌