MCP Tools Reference: maintenance.googleapis.com

Strumento: summarize_maintenances

Riassume le manutenzioni per un progetto e una località specifici fornendo statistiche aggregate.

Parametri

  • parent (stringa, obbligatorio): il padre della manutenzione della risorsa, nel formato projects/{project}/locations/{location}.
  • page_size (numero intero, facoltativo): il numero massimo di manutenzioni delle risorse da inviare per pagina.
  • page_token (stringa, facoltativo): un token di pagina ricevuto da una precedente chiamata SummarizeMaintenances.
  • filter (stringa, facoltativo): filtra l'elenco come specificato in https://google.aip.dev/160.
  • order_by (stringa, facoltativo): ordina i risultati come specificato in https://google.aip.dev/132.

Valore restituito

Il metodo restituisce un oggetto SummarizeMaintenancesResponse, che contiene:

  • maintenances: un elenco di riepiloghi della manutenzione.
  • next_page_token: un token che può essere inviato come page_token in una richiesta successiva per recuperare la pagina successiva dei risultati.

Note

  • Utilizza "-" come località per un riepilogo globale in tutte le regioni.

Il seguente esempio mostra come utilizzare curl per richiamare lo strumento MCP summarize_maintenances.

Richiesta 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
}'

Schema di input

Messaggio di richiesta per il metodo personalizzato SummarizeMaintenances.

SummarizeMaintenancesRequest

Rappresentazione JSON 
{
  "parent": string,
  "pageSize": integer,
  "pageToken": string,
  "filter": string,
  "orderBy": string
}
Campi
parent

string

Obbligatorio. Il parent della manutenzione della risorsa. Ad es. projects/123/locations/*
pageSize

integer

Il numero massimo di manutenzioni delle risorse da inviare per pagina. Le dimensioni della pagina predefinite sono 20 e il valore massimo è 1000.
pageToken

string

Il token di pagina: se viene fornito il next_page_token di una risposta precedente, questa richiesta invierà la pagina successiva.
filter

string

Filtra l'elenco come specificato in https://google.aip.dev/160. I campi supportati includono: - maintenance.maintenanceName Esempi: - maintenance.maintenanceName="eb3b709c-9ca1-5472-9fb6-800a3849eda1"
orderBy

string

Ordina i risultati come specificato in https://google.aip.dev/132.

Schema di output

Messaggio di richiesta per il metodo personalizzato SummarizeMaintenances.

SummarizeMaintenancesResponse

Rappresentazione JSON 
{
  "maintenances": [
    {
      object (MaintenanceSummary)
    }
  ],
  "nextPageToken": string,
  "unreachable": [
    string
  ]
}
Campi
maintenances[]

object (MaintenanceSummary)

I riepiloghi risultanti.
nextPageToken

string

Se presente, il token della pagina successiva può essere fornito a una successiva chiamata SummarizeMaintenances per elencare la pagina successiva. Se è vuoto, non ci sono altre pagine.
unreachable[]

string

Elenco non ordinato. Località non raggiungibili.

MaintenanceSummary

Rappresentazione 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)
    }
  ]
}
Campi
maintenanceName

string

Solo output. Il nome della manutenzione.
title

string

Solo output. Il titolo della manutenzione.
description

string

Solo output. La descrizione della manutenzione.
category

enum (MaintenanceCategory)

Solo output. La categoria dell'evento di manutenzione.
maintenanceScheduledStartTime

string (Timestamp format)

Solo output. Ora di inizio pianificata della manutenzione. La manutenzione inizierà alle ore maintenanceScheduledStartTime o più tardi, con il massimo impegno per terminare prima delle ore maintenanceScheduledEndTime.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
maintenanceScheduledEndTime

string (Timestamp format)

Solo output. Un orario di fine stimato (secondo il criterio del massimo impegno, non garantito) della manutenzione pianificata.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
maintenanceStartTime

string (Timestamp format)

Solo output. Data effettiva di inizio della manutenzione. Campo presente solo dopo che lo stato è cambiato in RUNNING.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
maintenanceEndTime

string (Timestamp format)

Solo output. Data effettiva in cui la manutenzione è stata completata correttamente. Campo presente solo dopo che lo stato è cambiato in SUCCEEDED.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
userControllable

boolean

Solo output. Indica se l'utente ha un certo controllo sulla manutenzione, in modo proattivo prima che venga pianificata con la policy di manutenzione o con controlli reattivi dopo la pianificazione (vedi il campo Controlli).
controls[]

object (MaintenanceControl)

Solo output. Controllo disponibile per la manutenzione (potrebbe non essere disponibile per ogni risorsa a cui viene applicata la manutenzione).
stats[]

object (Stats)

Solo output. Stats è un campo di ResourceMaintenance utilizzato per aggregare le statistiche.

Timestamp

Rappresentazione JSON 
{
  "seconds": string,
  "nanos": integer
}
Campi
seconds

string (int64 format)

Rappresenta i secondi di tempo UTC trascorsi dall'epoca di Unix 1970-01-01T00:00:00Z. Deve essere compreso tra -62135596800 e 253402300799 inclusi (corrispondenti a 0001-01-01T00:00:00Z e 9999-12-31T23:59:59Z).
nanos

integer

Frazioni di secondo non negative con risoluzione in nanosecondi. Questo campo è la parte in nanosecondi della durata, non un'alternativa ai secondi. I valori negativi dei secondi con frazioni devono comunque avere valori di nanosecondi non negativi che vengono conteggiati in avanti nel tempo. Deve essere compreso tra 0 e 999.999.999 inclusi.

MaintenanceControl

Rappresentazione JSON 
{
  "control": enum (Control),
  "isCustom": boolean,
  "documentation": string
}
Campi
control

enum (Control)

Il controllo della manutenzione delle risorse.
isCustom

boolean

Indica se il controllo è disponibile solo nell'API Service Producer (non tramite Unified Maintenance).
documentation

string

Link alla documentazione del produttore di servizi sul controllo della manutenzione. Fornito solo quando isCustom è true.

Statistiche

Rappresentazione JSON 
{
  "groupBy": string,
  "aggregates": [
    {
      object (Aggregate)
    }
  ]
}
Campi
groupBy

string

groupBy specifica il tipo di aggregazione. Ad esempio, un group_by potrebbe essere "state"
aggregates[]

object (Aggregate)

Aggregates è un elenco di coppie <gruppo, conteggio>. Ad esempio, se group_by è "state" una possibile tupla nell'elenco degli aggregati potrebbe essere "SCHEDULED" : 11,

Aggregazione

Rappresentazione JSON 
{
  "group": string,
  "count": string
}
Campi
group

string

Specifica il valore specifico di group_by che rappresenta il conteggio. Ad esempio, se group_by è "state", il gruppo corrispondente potrebbe essere "SCHEDULED".
count

string (int64 format)

Il conteggio del gruppo.

MaintenanceCategory

La categoria della manutenzione.

Enum
MAINTENANCE_CATEGORY_UNSPECIFIED Categoria non specificata.
INFRASTRUCTURE Gli eventi di manutenzione dell'infrastruttura sono i momenti in cui Google Cloud esegue la manutenzione regolare delle apparecchiature di rete, ad esempio Google Cloud Interconnect. Questi eventi vengono generalmente pianificati in anticipo e, quando possibile, inviamo una notifica in modo che gli utenti possano pianificare l'evento di manutenzione dell'infrastruttura ed evitare tempi di inattività. Gli eventi di manutenzione dell'infrastruttura non avvengono a intervalli regolari, ma in genere si verificano più volte all'anno.
SERVICE_UPDATE Aggiornamenti che possono includere correzioni di bug, modifiche o nuove funzionalità compatibili con le versioni esistenti (incluse le patch). Alcuni SP consentono agli utenti di controllare la pianificazione di questi eventi di manutenzione utilizzando finestre di manutenzione e/o funzionalità di negazione della manutenzione.

Controllo

Imposta il tipo di controllo supportato. commento (come nei log).

Enum
CONTROL_UNSPECIFIED Controllo non specificato.
APPLY Applica il controllo.
MANAGE_POLICY Gestisci il controllo dei criteri.
RESCHEDULE Controllo della riprogrammazione.

Annotazioni dello strumento

Suggerimento distruttivo: ❌ | Suggerimento idempotente: ✅ | Suggerimento di sola lettura: ✅ | Suggerimento open world: ❌