MCP Tools Reference: maintenance.googleapis.com

כלי: summarize_maintenances

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

פרמטרים

  • ‫parent (מחרוזת, חובה): ההורה של תחזוקת המשאב, בפורמט projects/{project}/locations/{location}.
  • ‫page_size (מספר שלם, אופציונלי): המספר המקסימלי של פעולות תחזוקה של משאבים לשליחה בכל דף.
  • ‫page_token (מחרוזת, אופציונלי): טוקן של דף שהתקבל מקריאה קודמת של SummarizeMaintenances.
  • ‫filter (מחרוזת, אופציונלי): סינון הרשימה בהתאם להגדרה בכתובת https://google.aip.dev/160.
  • ‫order_by (string, אופציונלי): סדר התוצאות, כפי שמפורט בכתובת https://google.aip.dev/132.

ערך מוחזר

השיטה מחזירה אובייקט SummarizeMaintenancesResponse, שמכיל:

  • ‫maintenances: רשימה של סיכומי תחזוקה.
  • ‫next_page_token: אסימון שאפשר לשלוח כ-page_token בבקשה הבאה כדי לאחזר את דף התוצאות הבא.

הערות

  • כדי ליצור סיכום גלובלי של כל האזורים, משתמשים ב-'-' בתור מיקום.

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

בקשת Curl 
                  
curl --location 'https://maintenance.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "summarize_maintenances",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

סכימת הקלט

הודעת בקשה לשיטה מותאמת אישית SummarizeMaintenances.

SummarizeMaintenancesRequest

ייצוג JSON 
{
  "parent": string,
  "pageSize": integer,
  "pageToken": string,
  "filter": string,
  "orderBy": string
}
שדות
parent

string

חובה. ההורה של תחזוקת המשאב. לדוגמה: projects/123/locations/*
pageSize

integer

המספר המקסימלי של פעולות תחזוקה של משאבים לשליחה לכל דף. גודל הדף שמוגדר כברירת מחדל הוא 20, והגודל המקסימלי הוא 1,000.
pageToken

string

טוקן הדף: אם מספקים את next_page_token מתשובה קודמת, הבקשה הזו תשלח את הדף הבא.
filter

string

מסננים את הרשימה לפי ההוראות שמופיעות במאמר https://google.aip.dev/160. השדות הנתמכים כוללים: – maintenance.maintenanceName דוגמאות: – maintenance.maintenanceName="eb3b709c-9ca1-5472-9fb6-800a3849eda1"
orderBy

string

התוצאות מוזמנות לפי ההגדרה בכתובת https://google.aip.dev/132.

סכימת הפלט

הודעת בקשה לשיטה מותאמת אישית SummarizeMaintenances.

SummarizeMaintenancesResponse

ייצוג JSON 
{
  "maintenances": [
    {
      object (MaintenanceSummary)
    }
  ],
  "nextPageToken": string,
  "unreachable": [
    string
  ]
}
שדות
maintenances[]

object (MaintenanceSummary)

הסיכומים שמתקבלים.
nextPageToken

string

אם הוא קיים, אפשר לספק את הטוקן של הדף הבא לקריאה הבאה של SummarizeMaintenances כדי להציג את הדף הבא. אם השדה ריק, אין עוד דפים.
unreachable[]

string

רשימה לא ממוינת. מיקומים שלא ניתן להגיע אליהם.

MaintenanceSummary

ייצוג JSON 
{
  "maintenanceName": string,
  "title": string,
  "description": string,
  "category": enum (MaintenanceCategory),
  "maintenanceScheduledStartTime": string,
  "maintenanceScheduledEndTime": string,
  "maintenanceStartTime": string,
  "maintenanceEndTime": string,
  "userControllable": boolean,
  "controls": [
    {
      object (MaintenanceControl)
    }
  ],
  "stats": [
    {
      object (Stats)
    }
  ]
}
שדות
maintenanceName

string

פלט בלבד. שם התחזוקה.
title

string

פלט בלבד. השם של התחזוקה.
description

string

פלט בלבד. תיאור התחזוקה.
category

enum (MaintenanceCategory)

פלט בלבד. הקטגוריה של אירוע התחזוקה.
maintenanceScheduledStartTime

string (Timestamp format)

פלט בלבד. זמן ההתחלה המתוזמן של התחזוקה. התחזוקה תתחיל בשעה maintenanceScheduledStartTime או מאוחר יותר, ונשתדל לסיים אותה לפני השעה maintenanceScheduledEndTime.

הפלט שנוצר תמיד יהיה בפורמט 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".
maintenanceScheduledEndTime

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".
maintenanceStartTime

string (Timestamp format)

פלט בלבד. התאריך בפועל שבו התחזוקה התחילה. השדה מופיע רק אחרי שהמצב השתנה ל-RUNNING.

הפלט שנוצר תמיד יהיה בפורמט 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".
maintenanceEndTime

string (Timestamp format)

פלט בלבד. התאריך בפועל שבו התחזוקה הסתיימה בהצלחה. השדה מופיע רק אחרי שהמצב השתנה ל-SUCCEEDED.

הפלט שנוצר תמיד יהיה בפורמט 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".
userControllable

boolean

פלט בלבד. מצוין אם למשתמש יש שליטה מסוימת על התחזוקה, באופן יזום לפני שהתחזוקה תוכננה באמצעות מדיניות התחזוקה, או באמצעות אמצעי בקרה תגובתיים אחרי שהיא תוכננה (ראו את השדה controls).
controls[]

object (MaintenanceControl)

פלט בלבד. אמצעי בקרה שזמין לתחזוקה הזו (יכול להיות שלא יהיה זמין לכל משאב שהתחזוקה חלה עליו).
stats[]

object (Stats)

פלט בלבד. ‫Stats הוא שדה של ResourceMaintenance שמשמש לצבירת הנתונים הסטטיסטיים.

חותמת הזמן

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

string (int64 format)

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

integer

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

MaintenanceControl

ייצוג JSON 
{
  "control": enum (Control),
  "isCustom": boolean,
  "documentation": string
}
שדות
control

enum (Control)

שליטה בתחזוקת המשאבים.
isCustom

boolean

השדה מציין אם אמצעי הבקרה זמין רק ב-Service Producer API (ולא דרך Unified Maintenance).
documentation

string

קישור למסמכי Service Producer בנושא בקרת תחזוקה. הערך מסופק רק אם isCustom הוא true.

נתונים סטטיסטיים

ייצוג JSON 
{
  "groupBy": string,
  "aggregates": [
    {
      object (Aggregate)
    }
  ]
}
שדות
groupBy

string

הפרמטר groupBy מציין את סוג הצבירה. לדוגמה, קבוצת ה-group_by יכולה להיות "state"
aggregates[]

object (Aggregate)

‫Aggregates היא רשימה של זוגות <group, count>. לדוגמה, אם group_by הוא "state", טופל אפשרי ברשימת המצטברים יכול להיות 'SCHEDULED' : 11.

במצטבר

ייצוג JSON 
{
  "group": string,
  "count": string
}
שדות
group

string

מציין איזה ערך ספציפי של group_by מייצג את הספירה. לדוגמה, אם group_by הוא "state", הקבוצה המתאימה יכולה להיות "SCHEDULED".
count

string (int64 format)

מספר הקבוצה.

MaintenanceCategory

קטגוריית התחזוקה.

טיפוסים בני מנייה (enum)
MAINTENANCE_CATEGORY_UNSPECIFIED הקטגוריה לא צוינה.
INFRASTRUCTURE אירועי תחזוקת תשתית הם מקרים שבהם Google Cloud מבצעת תחזוקה שוטפת בציוד הרשת, למשל Google Cloud Interconnect. בדרך כלל האירועים האלה מתוזמנים מראש, ואנחנו שולחים התראה כשזה אפשרי, כדי שהמשתמשים יוכלו להתכונן לאירוע תחזוקת התשתית ולמנוע השבתה. לא נקבע מרווח זמן קבוע בין אירועי תחזוקה של התשתית, אבל בדרך כלל הם מתרחשים כמה פעמים בשנה.
SERVICE_UPDATE עדכונים שיכולים לכלול תיקוני באגים, שינויים או תכונות חדשות שתואמות לאחור לגרסאות קיימות (כולל תיקוני אבטחה). חלק מספקי השירות מאפשרים למשתמשים לשלוט בתזמון של אירועי התחזוקה האלה באמצעות חלונות תחזוקה או תכונות שמאפשרות לדחות את התחזוקה.

שליטה

מגדירה את סוג הבקרה הנתמך. הערה (כמו ביומנים).

טיפוסים בני מנייה (enum)
CONTROL_UNSPECIFIED סוג השליטה לא צוין.
APPLY החלת אמצעי הבקרה.
MANAGE_POLICY ניהול של אמצעי בקרה למדיניות.
RESCHEDULE אמצעי בקרה לשינוי המועד.

הערות על כלים

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