MCP Tools Reference: maintenance.googleapis.com

Strumento: list_resource_maintenances

Elenca le manutenzioni delle risorse per un progetto e una località specifici.

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 ListResourceMaintenances.
  • 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 ListResourceMaintenancesResponse, che contiene:

  • resource_maintenances: Un elenco di manutenzioni delle risorse che corrispondono ai criteri della richiesta.
  • 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 una visualizzazione globale in tutte le regioni.

Il seguente esempio mostra come utilizzare curl per richiamare lo strumento MCP list_resource_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": "list_resource_maintenances",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Schema di input

La struttura della richiesta per il metodo ListResourceMaintenances.

ListResourceMaintenancesRequest

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

string

Obbligatorio. Il padre della manutenzione della risorsa.
pageSize

integer

Il numero massimo di manutenzioni delle risorse da inviare per pagina.
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.
orderBy

string

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

Schema di output

La struttura della risposta per il metodo ListResourceMaintenances.

ListResourceMaintenancesResponse

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

object (ResourceMaintenance)

Le manutenzioni delle risorse risultanti.
nextPageToken

string

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

string

Località non raggiungibili.

ResourceMaintenance

Rappresentazione JSON 
{
  "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
}
Campi
name

string

Identificatore. Il nome della risorsa resource_maintenance. Formato: "projects/{project}/locations/{location}/resourceMaintenance/{resource-maintenance-id}"
resource

object (Resource)

Solo output. La specifica della risorsa per la manutenzione della risorsa.
maintenance

object (Maintenance)

Solo output. I dettagli della manutenzione.
state

enum (State)

Solo output. Lo stato della manutenzione della risorsa.
createTime

string (Timestamp format)

Solo output. L'ora di creazione della manutenzione della risorsa.

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

string (Timestamp format)

Solo output. L'ora di aggiornamento della manutenzione della risorsa.

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. L'ora in cui è iniziata la manutenzione della risorsa.

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. L'ora in cui è stata completata la manutenzione della risorsa.

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

string (Timestamp format)

Solo output. L'ora in cui è stata annullata la manutenzione della risorsa.

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

string (Timestamp format)

Solo output. L'ora in cui è pianificato l'inizio della manutenzione della risorsa.

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. L'ora in cui è prevista la fine della manutenzione della risorsa.

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 dei controlli)
controls[]

object (MaintenanceControl)

Solo output. I controlli della manutenzione.
labels

map (key: string, value: string)

Facoltativo. Le etichette sulla risorsa, che possono essere utilizzate per la classificazione, simili alle etichette delle risorse Kubernetes.

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
annotations

map (key: string, value: string)

Facoltativo. Le annotazioni sono una mappa chiave-valore non strutturata archiviata con una risorsa che può essere impostata da strumenti esterni per archiviare e recuperare metadati arbitrari. Non sono interrogabili e devono essere conservati durante la modifica degli oggetti.

Scopri di più: https://kubernetes.io/docs/user-guide/annotations

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
uid

string

Solo output. Identificatore unico della risorsa. L'UID è unico nello spazio e nel tempo per questa risorsa nell'ambito del servizio. Viene tipicamente generato dal server durante la creazione di una risorsa e non deve essere modificato. L'UID viene utilizzato per identificare in modo unico le risorse quando i nomi risorsa vengono riutilizzati. Deve essere un UUID4.
etag

string

Solo output. Valore opaco che identifica in modo unico una versione o generazione di una risorsa. Può essere usato per confermare che client e server concordano nell'ordine di una risorsa in fase di scrittura.

Risorsa

Rappresentazione JSON 
{
  "resourceName": string,
  "location": string,
  "type": string
}
Campi
resourceName

string

Solo output. Name è il riferimento alla risorsa consumer interessata dalla manutenzione. I valori disponibili sono disponibili qui: https://cloud.google.com/asset-inventory/docs/asset-names
location

string

Solo output. Località della risorsa. Formato: us-central1
type

string

Solo output. Il tipo di risorsa. I valori disponibili sono disponibili qui: https://cloud.google.com/asset-inventory/docs/asset-types#supported_resource_types. Tieni presente che non per tutti i tipi di risorse verranno segnalate le manutenzioni.

Manutenzione

Rappresentazione JSON 
{
  "maintenanceName": string,
  "title": string,
  "description": string,
  "category": enum (MaintenanceCategory)
}
Campi
maintenanceName

string

Manutenzione è il nome della risorsa di manutenzione corrispondente secondo lo schema di denominazione standard: "{maintenance-id}"
title

string

Solo output. Il titolo della manutenzione.
description

string

Solo output. La descrizione della manutenzione.
category

enum (MaintenanceCategory)

Solo output. La categoria della manutenzione.

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.

LabelsEntry

Rappresentazione JSON 
{
  "key": string,
  "value": string
}
Campi
key

string
value

string

AnnotationsEntry

Rappresentazione JSON 
{
  "key": string,
  "value": string
}
Campi
key

string
value

string

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.

Stato

Lo stato è lo stato di manutenzione di una risorsa.

Enum
STATE_UNSPECIFIED Stato non specificato.
SCHEDULED Pianificati per una determinata finestra. Per la manutenzione distruttiva, deve rispettare la policy di manutenzione, ovvero i periodi disponibili, le esclusioni e il periodo di notifica.
RUNNING La manutenzione è in corso.
CANCELLED Non più pianificata, in genere quando è già stata eseguita un'altra manutenzione (ad es. l'upgrade a una versione più recente) o l'utente ha saltato la manutenzione.
SUCCEEDED Completato.

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