MCP Tools Reference: maintenance.googleapis.com

Tool: list_resource_maintenances

Listet Ressourcenwartungen für ein bestimmtes Projekt und einen bestimmten Standort auf.

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 ListResourceMaintenances-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 ListResourceMaintenancesResponse-Objekt zurück, das Folgendes enthält:

  • resource_maintenances: Eine Liste der Ressourcenwartungen, die den Anfragekriterien entsprechen.
  • 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 Ansicht über alle Regionen hinweg.

Im folgenden Beispiel wird gezeigt, wie Sie mit curl das MCP-Tool list_resource_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": "list_resource_maintenances",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Eingabeschema

Die Anfragestruktur für die Methode „ListResourceMaintenances“.

ListResourceMaintenancesRequest

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

string

Erforderlich. Die übergeordnete Ressource der Ressourcenwartung.
pageSize

integer

Die maximale Anzahl von Ressourcenwartungen, die pro Seite gesendet werden sollen.
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.
orderBy

string

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

Ausgabeschema

Die Antwortstruktur für die Methode „ListResourceMaintenances“.

ListResourceMaintenancesResponse

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

object (ResourceMaintenance)

Die resultierenden Ressourcenwartungen.
nextPageToken

string

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

string

Standorte, die nicht erreicht werden konnten.

Ressourcenwartung

JSON-Darstellung 
{
  "name": string,
  "resource": {
    object (Resource)
  },
  "maintenance": {
    object (Maintenance)
  },
  "state": enum (State),
  "createTime": string,
  "updateTime": string,
  "maintenanceStartTime": string,
  "maintenanceEndTime": string,
  "maintenanceCancelTime": string,
  "maintenanceScheduledStartTime": string,
  "maintenanceScheduledEndTime": string,
  "userControllable": boolean,
  "controls": [
    {
      object (MaintenanceControl)
    }
  ],
  "labels": {
    string: string,
    ...
  },
  "annotations": {
    string: string,
    ...
  },
  "uid": string,
  "etag": string
}
Felder
name

string

ID. Der Name der resource_maintenance-Ressource. Format: "projects/{project}/locations/{location}/resourceMaintenance/{resource-maintenance-id}"
resource

object (Resource)

Nur Ausgabe. Die Ressourcenspezifikation der Ressourcenwartung.
maintenance

object (Maintenance)

Nur Ausgabe. Details zur Wartung.
state

enum (State)

Nur Ausgabe. Der Status der Ressourcenwartung.
createTime

string (Timestamp format)

Nur Ausgabe. Der Erstellungszeitpunkt der Ressourcenwartung.

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"
updateTime

string (Timestamp format)

Nur Ausgabe. Der Zeitpunkt der Aktualisierung der Ressourcenwartung.

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. Der Zeitpunkt, zu dem die Ressourcenwartung begonnen 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. Der Zeitpunkt, zu dem die Wartung der Ressource abgeschlossen wurde.

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"
maintenanceCancelTime

string (Timestamp format)

Nur Ausgabe. Der Zeitpunkt, zu dem die Ressourcenwartung abgebrochen wurde.

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"
maintenanceScheduledStartTime

string (Timestamp format)

Nur Ausgabe. Der Zeitpunkt, zu dem die Wartung der Ressource geplant war.

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. Die Zeit, zu der die Wartung der Ressource planmäßig enden sollte.

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 diese 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 Einstellungen für die Wartung.
labels

map (key: string, value: string)

Optional. Die Labels der Ressource, die zur Kategorisierung verwendet werden können, ähnlich wie Kubernetes-Ressourcenlabels.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
annotations

map (key: string, value: string)

Optional. „Annotations“ ist eine unstrukturierte Schlüssel/Wert-Zuordnung, die mit einer Ressource gespeichert wird und von externen Tools festgelegt werden kann, um beliebige Metadaten zu speichern und abzurufen. Sie können nicht abgefragt werden und sollten beim Ändern von Objekten beibehalten werden.

Weitere Informationen: https://kubernetes.io/docs/user-guide/annotations

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
uid

string

Nur Ausgabe. Die eindeutige Kennzeichnung der Ressource. Die UID gilt zeitlich und räumlich im Rahmen des Dienstes nur für diese eine Ressource. Sie wird in der Regel nach dem Erstellen der Ressource vom Server generiert und darf nicht geändert werden. Die UID dient dazu, Ressourcen, deren Namen wiederverwendet werden, eindeutig zu kennzeichnen. Dies sollte eine UUID4 sein.
etag

string

Nur Ausgabe. Ein opaker Wert, der eine Version oder Generation einer Ressource eindeutig kennzeichnet. Damit kann bestätigt werden, dass Client und Server der Reihenfolge einer Ressource, die gerade geschrieben wird, zustimmen.

Ressource

JSON-Darstellung 
{
  "resourceName": string,
  "location": string,
  "type": string
}
Felder
resourceName

string

Nur Ausgabe. „Name“ ist der Verweis auf die von der Wartung betroffene Consumer-Ressource. Verfügbare Werte finden Sie hier: https://cloud.google.com/asset-inventory/docs/asset-names.
location

string

Nur Ausgabe. Der Standort der Ressource. Format: us-central1
type

string

Nur Ausgabe. Der Typ der Ressource Verfügbare Werte finden Sie unter https://cloud.google.com/asset-inventory/docs/asset-types#supported_resource_types. Bitte beachten Sie, dass nicht für alle Ressourcentypen Wartungsarbeiten gemeldet werden.

Wartung

JSON-Darstellung 
{
  "maintenanceName": string,
  "title": string,
  "description": string,
  "category": enum (MaintenanceCategory)
}
Felder
maintenanceName

string

„Maintenance“ ist der Name der entsprechenden Wartungsressource gemäß dem Standardbenennungsschema: "{maintenance-id}"
title

string

Nur Ausgabe. Der Titel der Wartung.
description

string

Nur Ausgabe. Die Beschreibung der Wartung.
category

enum (MaintenanceCategory)

Nur Ausgabe. Die Kategorie der Wartung.

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.

LabelsEntry

JSON-Darstellung 
{
  "key": string,
  "value": string
}
Felder
key

string
value

string

AnnotationsEntry

JSON-Darstellung 
{
  "key": string,
  "value": string
}
Felder
key

string
value

string

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 steuern und/oder Wartungsfunktionen ablehnen.

Bundesland

„State“ ist der Status einer Ressourcenwartung.

Enums
STATE_UNSPECIFIED Nicht angegebener Zustand.
SCHEDULED Für ein bestimmtes Zeitfenster geplant. Bei störenden Wartungsarbeiten muss die Wartungsrichtlinie eingehalten werden, d.h. die verfügbaren Zeitfenster, Ausschlüsse und der Benachrichtigungszeitraum.
RUNNING Die Wartung läuft.
CANCELLED Nicht mehr geplant, in der Regel, wenn bereits eine andere Wartung (z.B. Upgrade auf eine neuere Version) stattgefunden hat oder der Nutzer die Wartung übersprungen hat.
SUCCEEDED Erfolgreich abgeschlossen.

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: ❌