MCP Tools Reference: maintenance.googleapis.com

Tool: summarize_maintenances

Fasst Wartungsarbeiten für ein bestimmtes Projekt und einen bestimmten Standort zusammen, indem aggregierte Statistiken bereitgestellt werden.

Parameter

  • parent (String, erforderlich): Das übergeordnete Element der Ressourcenwartung im Format projects/{project}/locations/{location}.
  • page_size (Ganzzahl, optional): Die maximale Anzahl von Ressourcenwartungen, die pro Seite gesendet werden sollen.
  • page_token (string, Optional): Ein Seitentoken, das von einem vorherigen SummarizeMaintenances-Aufruf empfangen wurde.
  • filter (string, Optional): Filtert die Liste gemäß https://google.aip.dev/160.
  • order_by (string, optional): Ergebnisse gemäß https://google.aip.dev/132 sortieren.

Rückgabewert

Die Methode gibt ein SummarizeMaintenancesResponse-Objekt zurück, das Folgendes enthält:

  • maintenances: Eine Liste von Wartungszusammenfassungen.
  • next_page_token: Ein Token, das als page_token in einer nachfolgenden Anfrage gesendet werden kann, um die nächste Ergebnisseite abzurufen.

Hinweise

  • Verwenden Sie „-“ als Standort für eine globale Zusammenfassung für alle Regionen.

Im folgenden Beispiel wird gezeigt, wie Sie mit curl das MCP-Tool summarize_maintenances aufrufen.

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

Eingabeschema

Anfragenachricht für die benutzerdefinierte Methode „SummarizeMaintenances“.

SummarizeMaintenancesRequest

JSON-Darstellung 
{
  "parent": string,
  "pageSize": integer,
  "pageToken": string,
  "filter": string,
  "orderBy": string
}
Felder
parent

string

Erforderlich. Die übergeordnete Ressource der Wartung, z. B. projects/123/locations/*
pageSize

integer

Die maximale Anzahl von Ressourcenwartungen, die pro Seite gesendet werden sollen. Die Standardseitengröße ist 20 und der Höchstwert 1.000.
pageToken

string

Das Seitentoken: Wenn das „next_page_token“ aus einer vorherigen Antwort angegeben wird, wird mit dieser Anfrage die nächste Seite gesendet.
filter

string

Filtern Sie die Liste gemäß https://google.aip.dev/160. Unterstützte Felder: - maintenance.maintenanceName Beispiele: - maintenance.maintenanceName="eb3b709c-9ca1-5472-9fb6-800a3849eda1"
orderBy

string

Die Ergebnisse werden gemäß https://google.aip.dev/132 sortiert.

Ausgabeschema

Anfragenachricht für die benutzerdefinierte Methode „SummarizeMaintenances“.

SummarizeMaintenancesResponse

JSON-Darstellung 
{
  "maintenances": [
    {
      object (MaintenanceSummary)
    }
  ],
  "nextPageToken": string,
  "unreachable": [
    string
  ]
}
Felder
maintenances[]

object (MaintenanceSummary)

Die resultierenden Zusammenfassungen.
nextPageToken

string

Wenn vorhanden, kann das Token für die nächste Seite für einen nachfolgenden SummarizeMaintenances-Aufruf angegeben werden, um die nächste Seite aufzulisten. Wenn das Feld leer ist, gibt es keine weiteren Seiten.
unreachable[]

string

Unsortierte Liste. Standorte, die nicht erreicht werden konnten.

MaintenanceSummary

JSON-Darstellung 
{
  "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)
    }
  ]
}
Felder
maintenanceName

string

Nur Ausgabe. Der Name der Wartung.
title

string

Nur Ausgabe. Der Titel der Wartung.
description

string

Nur Ausgabe. Die Beschreibung der Wartung.
category

enum (MaintenanceCategory)

Nur Ausgabe. Die Kategorie des Wartungsereignisses.
maintenanceScheduledStartTime

string (Timestamp format)

Nur Ausgabe. Geplanter Beginn der Wartung. Die Wartung beginnt um maintenanceScheduledStartTime oder später und wird nach Möglichkeit vor maintenanceScheduledEndTime abgeschlossen.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
maintenanceScheduledEndTime

string (Timestamp format)

Nur Ausgabe. Eine geschätzte (Best-Effort-Basis, nicht garantiert) Endzeit der geplanten Wartungsarbeiten.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
maintenanceStartTime

string (Timestamp format)

Nur Ausgabe. Das tatsächliche Datum, an dem die Wartung begonnen hat. Feld ist erst verfügbar, nachdem sich der Status in RUNNING geändert hat.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
maintenanceEndTime

string (Timestamp format)

Nur Ausgabe. Das tatsächliche Datum, an dem die Wartung erfolgreich abgeschlossen wurde. Feld ist erst verfügbar, nachdem sich der Status in SUCCEEDED geändert hat.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
userControllable

boolean

Nur Ausgabe. Gibt an, ob der Nutzer eine gewisse Kontrolle über die Wartung hat, entweder proaktiv, bevor die Wartung mit einer Wartungsrichtlinie geplant wurde, oder mit reaktiven Steuerelementen, nachdem sie geplant wurde (siehe Feld „controls“).
controls[]

object (MaintenanceControl)

Nur Ausgabe. Die Steuerung ist für diese Wartung verfügbar (möglicherweise nicht für jede Ressource, auf die die Wartung angewendet wird).
stats[]

object (Stats)

Nur Ausgabe. „Stats“ ist ein Feld von „ResourceMaintenance“, das zum Aggregieren der Statistiken verwendet wird.

Zeitstempel

JSON-Darstellung 
{
  "seconds": string,
  "nanos": integer
}
Felder
seconds

string (int64 format)

Stellt Sekunden der UTC-Zeit seit Unix-Epoche 1970-01-01T00:00:00Z dar. Muss einschließlich zwischen -62135596800 und 253402300799 liegen (entspricht 0001-01-01T00:00:00Z bis 9999-12-31T23:59:59Z).
nanos

integer

Nicht negative Sekundenbruchteile Nanosekunden-Auflösung. Dieses Feld enthält den Nanosekundenanteil der Dauer und ist keine Alternative zu Sekunden. Negative Sekundenwerte mit Bruchteilen müssen weiterhin nicht negative Nano-Werte haben, die zeitlich vorwärts gezählt werden. Muss zwischen 0 und 999.999.999 liegen (einschließlich).

MaintenanceControl

JSON-Darstellung 
{
  "control": enum (Control),
  "isCustom": boolean,
  "documentation": string
}
Felder
control

enum (Control)

Die Steuerung der Ressourcenwartung.
isCustom

boolean

Gibt an, ob das Steuerelement nur in der Service Producer API verfügbar ist (nicht über die Einheitliche Wartung).
documentation

string

Link zur Dokumentation für Service Producer zur Wartungssteuerung. Wird nur bereitgestellt, wenn isCustom true ist.

Statistik

JSON-Darstellung 
{
  "groupBy": string,
  "aggregates": [
    {
      object (Aggregate)
    }
  ]
}
Felder
groupBy

string

Mit „groupBy“ wird der Aggregattyp angegeben. Ein Beispiel für „group_by“ ist "state".
aggregates[]

object (Aggregate)

„Aggregates“ ist eine Liste mit <group, count>-Paaren. Wenn group_by beispielsweise "state" ist, könnte ein mögliches Tupel in der Liste „aggregates“ „SCHEDULED“ : 11 sein.

Aggregieren

JSON-Darstellung 
{
  "group": string,
  "count": string
}
Felder
group

string

Gibt an, für welchen spezifischen Wert von „group_by“ die Anzahl steht. Wenn „group_by“ beispielsweise "state" ist, könnte die entsprechende Gruppe "SCHEDULED" sein.
count

string (int64 format)

Die Anzahl der Elemente in der Gruppe.

MaintenanceCategory

Die Kategorie der Wartung.

Enums
MAINTENANCE_CATEGORY_UNSPECIFIED Kategorie nicht angegeben.
INFRASTRUCTURE Infrastrukturwartungen sind Zeiten, zu denen Google Cloud regelmäßig Netzwerkgeräte wartet, z. B. Google Cloud Interconnect. Diese Ereignisse werden normalerweise im Voraus geplant und wir benachrichtigen Sie nach Möglichkeit, damit Sie die Wartung der Infrastruktur planen und Ausfallzeiten vermeiden können. Infrastrukturwartungen werden nicht in festen Intervallen zwischen zwei Terminen durchgeführt, aber in der Regel mehrmals pro Jahr.
SERVICE_UPDATE Updates, die Fehlerkorrekturen, Änderungen oder neue Funktionen enthalten können, die mit vorhandenen Versionen abwärtskompatibel sind (einschließlich Patches). Bei einigen SPs können Nutzer die Planung dieser Wartungsereignisse über Wartungsfenster und/oder die Funktion „Wartung ablehnen“ steuern.

Steuerung

Legt den unterstützten Steuerungstyp fest. Kommentar (wie in Protokollen).

Enums
CONTROL_UNSPECIFIED Nicht angegebenes Steuerelement.
APPLY Kontrollgruppe anwenden
MANAGE_POLICY Richtlinienkontrolle verwalten
RESCHEDULE Verschieben der Steuerung

Tool-Annotationen

Destructive Hint: ❌ | Idempotent Hint: ✅ | Read Only Hint: ✅ | Open World Hint: ❌