MCP Tools Reference: cloud-sql

כלי: list_users

הצגת רשימה של כל משתמשי מסד הנתונים במכונה של Cloud SQL.

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

בקשת 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_users",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

סכימת הקלט

SqlUsersListRequest

ייצוג ב-JSON 
{
  "instance": string,
  "project": string
}
שדות
instance

string

מזהה מופע של מסד נתונים. הפרטים האלה לא כוללים את מזהה הפרויקט.
project

string

מזהה הפרויקט שמכיל את המופע.

סכימת פלט

תשובה של רשימת משתמשים.

UsersListResponse

ייצוג ב-JSON 
{
  "kind": string,
  "items": [
    {
      object (User)
    }
  ],
  "nextPageToken": string
}
שדות
kind

string

הערך הזה תמיד יהיה sql#usersList.
items[]

object (User)

רשימה של משאבי משתמשים במופע.
nextPageToken
(deprecated)

string

לא בשימוש.

משתמש

ייצוג ב-JSON 
{
  "kind": string,
  "password": string,
  "etag": string,
  "name": string,
  "host": string,
  "instance": string,
  "project": string,
  "type": enum (SqlUserType),
  "iamEmail": string,
  "passwordPolicy": {
    object (UserPasswordValidationPolicy)
  },
  "databaseRoles": [
    string
  ],

  // Union field user_details can be only one of the following:
  "sqlserverUserDetails": {
    object (SqlServerUserDetails)
  }
  // End of list of possible types for union field user_details.

  // Union field _dual_password_type can be only one of the following:
  "dualPasswordType": enum (DualPasswordType)
  // End of list of possible types for union field _dual_password_type.

  // Union field _iam_status can be only one of the following:
  "iamStatus": enum (IamStatus)
  // End of list of possible types for union field _iam_status.
}
שדות
kind

string

הערך הזה תמיד יהיה sql#user.
password

string

הסיסמה של המשתמש.
etag

string

השדה הזה הוצא משימוש ויוסר מגרסה עתידית של ה-API.
name

string

שם המשתמש במכונה של Cloud SQL. אפשר להשמיט את הערך update כי הוא כבר מצוין בכתובת ה-URL.
host

string

זה שינוי אופציונלי. המארח שאליו המשתמש יכול להתחבר. בפעולות insert, ברירת המחדל של host היא מחרוזת ריקה. בפעולות update, המארח מצוין כחלק מכתובת ה-URL של הבקשה. אי אפשר לעדכן את שם המארח אחרי ההוספה. במכונת MySQL, חובה להגדיר את האפשרות הזו. במכונת PostgreSQL או SQL Server, האפשרות הזו היא אופציונלית.
instance

string

השם של המכונה של Cloud SQL. הפרטים האלה לא כוללים את מזהה הפרויקט. אפשר להשמיט את הערך update כי הוא כבר מצוין בכתובת ה-URL.
project

string

מזהה הפרויקט שמכיל את מסד הנתונים של Cloud SQL. אם רלוונטי, הדומיין של אפליקציות Google מופיע כקידומת. אפשר להשמיט את הערך update כי הוא כבר מצוין בכתובת ה-URL.
type

enum (SqlUserType)

סוג המשתמש. ההגדרה הזו קובעת את השיטה לאימות המשתמש במהלך הכניסה. ברירת המחדל היא סוג המשתמש המובנה במסד הנתונים.
iamEmail

string

זה שינוי אופציונלי. כתובת האימייל המלאה של משתמש IAM. השדה הזה לא ימולא עבור משתמשים רגילים במסד הנתונים. רלוונטי רק למשתמשים במסד נתונים של MySQL.
passwordPolicy

object (UserPasswordValidationPolicy)

מדיניות אימות סיסמאות ברמת המשתמש.
databaseRoles[]

string

זה שינוי אופציונלי. חברות בתפקידים של המשתמש
שדה איחוד user_details. פרטי המשתמש עבור סוג מסוים של מסד נתונים user_details יכולים להיות רק אחד מהערכים הבאים:
sqlserverUserDetails

object (SqlServerUserDetails)

שדה איחוד _dual_password_type.

הערך _dual_password_type יכול להיות רק אחד מהבאים:
dualPasswordType

enum (DualPasswordType)

סטטוס הסיסמה הכפולה של המשתמש.

שדה איחוד _iam_status.

הערך _iam_status יכול להיות רק אחד מהבאים:
iamStatus

enum (IamStatus)

מציין אם קבוצה פעילה או לא פעילה לאימות מסד נתונים של IAM.

SqlServerUserDetails

ייצוג ב-JSON 
{
  "disabled": boolean,
  "serverRoles": [
    string
  ]
}
שדות
disabled

boolean

אם המשתמש הושבת
serverRoles[]

string

תפקידי השרת של המשתמש

UserPasswordValidationPolicy

ייצוג ב-JSON 
{
  "allowedFailedAttempts": integer,
  "passwordExpirationDuration": string,
  "enableFailedAttemptsCheck": boolean,
  "status": {
    object (PasswordStatus)
  },
  "enablePasswordVerification": boolean
}
שדות
allowedFailedAttempts

integer

מספר ניסיונות ההתחברות הכושלים שמותרים לפני שהמשתמש ננעל.
passwordExpirationDuration

string (Duration format)

משך הזמן עד שתוקף הסיסמה יפוג אחרי שהיא תעודכן.

משך זמן בשניות עם עד תשע ספרות אחרי הנקודה העשרונית, שמסתיים ב-'s'. דוגמה: "3.5s".
enableFailedAttemptsCheck

boolean

אם הערך הוא True, הבדיקה של ניסיונות התחברות כושלים תופעל.
status

object (PasswordStatus)

פלט בלבד. סטטוס הסיסמה לקריאה בלבד.
enablePasswordVerification

boolean

אם הערך הוא True, המשתמש צריך לציין את הסיסמה הנוכחית לפני שינוי הסיסמה. הסימון הזה נתמך רק ב-MySQL.

משך הזמן

ייצוג ב-JSON 
{
  "seconds": string,
  "nanos": integer
}
שדות
seconds

string (int64 format)

השניות החתומות של טווח הזמן. הערך חייב להיות בין ‎-315,576,000,000 לבין ‎+315,576,000,000, כולל. הערה: הגבולות האלה מחושבים לפי: 60 שניות/דקה * 60 דקות/שעה * 24 שעות/יום * 365.25 ימים/שנה * 10,000 שנים
nanos

integer

שברים חתומים של שנייה ברזולוציית ננו-שנייה של טווח הזמן. משכי זמן של פחות משנייה אחת מיוצגים באמצעות שדה seconds עם הערך 0 ושדה nanos עם ערך חיובי או שלילי. למשכי זמן של שנייה אחת או יותר, הערך בשדה nanos צריך להיות שונה מאפס ובעל אותו סימן כמו הערך בשדה seconds. הערך חייב להיות בין ‎-999,999,999 ל-‎+999,999,999, כולל.

PasswordStatus

ייצוג ב-JSON 
{
  "locked": boolean,
  "passwordExpirationTime": string
}
שדות
locked

boolean

אם הערך הוא True, למשתמש אין הרשאות להתחבר.
passwordExpirationTime

string (Timestamp format)

זמן התפוגה של הסיסמה הנוכחית.

הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה בפורמט Z עם 0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים חוץ מ-Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".

חותמת הזמן

ייצוג ב-JSON 
{
  "seconds": string,
  "nanos": integer
}
שדות
seconds

string (int64 format)

מייצג את מספר השניות מאז ראשית זמן יוניקס (Unix epoch) ב-1 בינואר 1970 בשעה 00:00:00 UTC. הערך חייב להיות בין ‎-62135596800 ל-253402300799, כולל (שמתאים לטווח 0001-01-01T00:00:00Z עד 9999-12-31T23:59:59Z).
nanos

integer

שברים לא שליליים של שנייה ברזולוציית ננו-שנייה. השדה הזה מייצג את החלק של הננו-שניות במשך הזמן, ולא מהווה חלופה לשניות. ערכי שניות שליליים עם שברים עדיין צריכים לכלול ערכי ננו-שניות לא שליליים שסופרים קדימה בזמן. הערך חייב להיות בין 0 ל-999,999,999, כולל.

הערות על כלי

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