MCP Tools Reference: cloud-sql

כלי: `list_instances`

הצגת רשימה של כל המכונות של Cloud SQL בפרויקט.

בדוגמה הבאה אפשר לראות איך משתמשים ב-curl כדי להפעיל את כלי ה-MCP‏ list_instances.

בקשת 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 }'

בקשת 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` ביטוי מסנן שמסנן את המשאבים שמופיעים בתשובה. הביטוי הוא מהצורה field:value. לדוגמה, instanceType:CLOUD_SQL_INSTANCE. אפשר להוסיף שדות מקוננים לפי הצורך, בהתאם לייצוג שלהם ב-JSON, כמו 'settings.userLabels.auto_start:true'. אם רוצים להשתמש בכמה שאילתות סינון, צריך להפריד ביניהן ברווח. לדוגמה. 'state:RUNNABLE instanceType:CLOUD_SQL_INSTANCE'. כברירת מחדל, כל ביטוי הוא ביטוי AND. עם זאת, אפשר לכלול ביטויים של AND ו-OR באופן מפורש.
`maxResults`	`integer (uint32 format)` מספר המופעים המקסימלי שיוחזרו. יכול להיות שהשירות יחזיר פחות מהערך הזה. אם לא מציינים ערך, מוחזרות לכל היותר 500 דוגמאות. הערך המקסימלי הוא 1,000. ערכים גבוהים יותר יומרו ל-1,000.
`pageToken`	`string` טוקן של דף שהוחזר בעבר ומייצג חלק מקבוצת התוצאות הגדולה יותר שרוצים לראות.
`project`	`string` מזהה הפרויקט שרוצים להציג את המכונות שלו ב-Cloud SQL.

סכימת פלט

תגובה לרשימת מופעים עבור 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.

code

enum (SqlApiWarningCode)

קוד שמזהה באופן ייחודי את סוג האזהרה.

message

string

הודעת האזהרה.

region

string

שם האזור שמופיע באזהרה REGION_UNREACHABLE.

McpDatabaseInstance

ייצוג ב-JSON

ייצוג ב-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,
  "name": string,
  "databaseVersion": string,
  "region": string,
  "edition": string,
  "tier": string,
  "dataDiskSizeGb": string,
  "availabilityType": string,
  "tags": {
    string: string,
    ...
  },
  "state": enum (SqlInstanceState)
}

שדות
`project`	`string` חובה. מזהה הפרויקט שרוצים להציג את המכונות שלו ב-Cloud SQL.
`name`	`string` חובה. השם של המכונה של Cloud SQL. הפרטים האלה לא כוללים את מזהה הפרויקט.
`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.

value

string (int64 format)

הערך int64.

TagsEntry

ייצוג ב-JSON
{ "key": string, "value": string }

שדות
`key`	`string`
`value`	`string`

הערות על כלי

רמז הרסני: ❌ | רמז אידמפוטנטי: ❌ | רמז לקריאה בלבד: ✅ | רמז לעולם פתוח: ❌

MCP Tools Reference: cloud-sql קל לארגן דפים בעזרת אוספים אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.

כלי: list_instances