MCP Tools Reference: maintenance.googleapis.com

Herramienta: summarize_maintenances

Proporciona un resumen de los mantenimientos de un proyecto y una ubicación determinados a través de estadísticas agregadas.

Parámetros

  • parent (cadena, obligatorio): Es el elemento superior del mantenimiento del recurso, con el formato projects/{project}/locations/{location}.
  • page_size (número entero, opcional): Es la cantidad máxima de mantenimientos de recursos que se enviarán por página.
  • page_token (cadena, opcional): Es un token de página que se recibió de una llamada SummarizeMaintenances anterior.
  • filter (cadena, opcional): Filtra la lista como se especifica en https://google.aip.dev/160.
  • order_by (cadena, opcional): Ordena los resultados según se especifica en https://google.aip.dev/132.

Valor que se muestra

El método devuelve un objeto SummarizeMaintenancesResponse, que contiene lo siguiente:

  • maintenances: Es una lista de resúmenes de mantenimiento.
  • next_page_token: Es un token que se puede enviar como page_token en una solicitud posterior para recuperar la siguiente página de resultados.

Notas

  • Usa "-" como ubicación para obtener un resumen global de todas las regiones.

En el siguiente ejemplo, se muestra cómo usar curl para invocar la herramienta de MCP summarize_maintenances.

Solicitud de 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
}'

Esquema de entrada

Es el mensaje de solicitud para el método personalizado SummarizeMaintenances.

SummarizeMaintenancesRequest

Representación JSON 
{
  "parent": string,
  "pageSize": integer,
  "pageToken": string,
  "filter": string,
  "orderBy": string
}
Campos
parent

string

Obligatorio. Es el recurso principal del mantenimiento. p. ej., projects/123/locations/*
pageSize

integer

Es la cantidad máxima de mantenimientos de recursos que se pueden enviar por página. El tamaño de página predeterminado es 20 y el máximo es 1,000.
pageToken

string

Token de página: Si se proporciona el next_page_token de una respuesta anterior, esta solicitud enviará la página siguiente.
filter

string

Filtra la lista como se especifica en https://google.aip.dev/160. Entre los campos admitidos, se incluyen los siguientes: - maintenance.maintenanceName Ejemplos: - maintenance.maintenanceName="eb3b709c-9ca1-5472-9fb6-800a3849eda1"
orderBy

string

Los resultados del pedido se especifican en https://google.aip.dev/132.

Esquema de salida

Es el mensaje de solicitud para el método personalizado SummarizeMaintenances.

SummarizeMaintenancesResponse

Representación JSON 
{
  "maintenances": [
    {
      object (MaintenanceSummary)
    }
  ],
  "nextPageToken": string,
  "unreachable": [
    string
  ]
}
Campos
maintenances[]

object (MaintenanceSummary)

Son los resúmenes resultantes.
nextPageToken

string

Si está presente, el token de la página siguiente se puede proporcionar a una llamada posterior de SummarizeMaintenances para enumerar la página siguiente. Si está vacío, no hay más páginas.
unreachable[]

string

Lista sin ordenar. Ubicaciones a las que no se pudo llegar.

MaintenanceSummary

Representación 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)
    }
  ]
}
Campos
maintenanceName

string

Solo salida. Es el nombre del mantenimiento.
title

string

Solo salida. Es el título del mantenimiento.
description

string

Solo salida. Es la descripción del mantenimiento.
category

enum (MaintenanceCategory)

Solo salida. Es la categoría del evento de mantenimiento.
maintenanceScheduledStartTime

string (Timestamp format)

Solo salida. Hora de inicio programada del mantenimiento. El mantenimiento comenzará a las maintenanceScheduledStartTime o más tarde, y se hará todo lo posible para que finalice antes de las maintenanceScheduledEndTime.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
maintenanceScheduledEndTime

string (Timestamp format)

Solo salida. Hora de finalización estimada (mejor esfuerzo, no garantizada) del mantenimiento programado.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
maintenanceStartTime

string (Timestamp format)

Solo salida. Fecha real en la que comenzó el mantenimiento. Campo presente solo después de que el estado cambió a RUNNING.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
maintenanceEndTime

string (Timestamp format)

Solo salida. Fecha real en la que se completó el mantenimiento correctamente. Campo presente solo después de que el estado cambió a SUCCEEDED.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
userControllable

boolean

Solo salida. Indica si el usuario tiene cierto control sobre ese mantenimiento, ya sea de forma proactiva antes de que se programara el mantenimiento con la política de mantenimiento o con controles reactivos después de que se programó (consulta el campo de controles).
controls[]

object (MaintenanceControl)

Solo salida. Control disponible para ese mantenimiento (es posible que no esté disponible para todos los recursos a los que se aplica el mantenimiento).
stats[]

object (Stats)

Solo salida. Stats es un campo de ResourceMaintenance que se usa para agregar las estadísticas.

Marca de tiempo

Representación JSON 
{
  "seconds": string,
  "nanos": integer
}
Campos
seconds

string (int64 format)

Representa los segundos de la hora UTC desde la época de Unix 1970-01-01T00:00:00Z. Debe estar entre -62135596800 y 253402300799 inclusive (lo que corresponde a 0001-01-01T00:00:00Z a 9999-12-31T23:59:59Z).
nanos

integer

Fracciones no negativas de un segundo a una resolución de nanosegundos. Este campo es la parte de nanosegundos de la duración, no una alternativa a los segundos. Los valores de segundos negativos con fracciones deben tener valores nanos no negativos que se cuentan hacia adelante en el tiempo. Debe ser un valor entre 0 y 999,999,999, inclusive.

MaintenanceControl

Representación JSON 
{
  "control": enum (Control),
  "isCustom": boolean,
  "documentation": string
}
Campos
control

enum (Control)

El control del mantenimiento de los recursos
isCustom

boolean

Indica si el control solo está disponible en la API de Service Producer (no a través de Unified Maintenance).
documentation

string

Vínculo a la documentación del productor de servicios sobre el control de mantenimiento. Solo se proporciona cuando isCustom es true.

Estadísticas

Representación JSON 
{
  "groupBy": string,
  "aggregates": [
    {
      object (Aggregate)
    }
  ]
}
Campos
groupBy

string

groupBy especifica el tipo de agregado. Por ejemplo, un group_by podría ser "state".
aggregates[]

object (Aggregate)

Aggregates es una lista de pares <grupo, recuento>. Por ejemplo, si el parámetro group_by es "state", una tupla posible en la lista de agregados podría ser "SCHEDULED" : 11.

Agregación

Representación JSON 
{
  "group": string,
  "count": string
}
Campos
group

string

Especifica qué valor específico de group_by representa el recuento. Por ejemplo, si group_by es "state", su grupo correspondiente podría ser "SCHEDULED".
count

string (int64 format)

Es el recuento del grupo.

MaintenanceCategory

Es la categoría del mantenimiento.

Enums
MAINTENANCE_CATEGORY_UNSPECIFIED Categoría no especificada.
INFRASTRUCTURE Los eventos de mantenimiento de infraestructura son momentos en que Google Cloud realiza un mantenimiento regular en equipos de red, p. ej., Google Cloud Interconnect. Por lo general, estos eventos se programan con anticipación y proporcionamos notificaciones, cuando es posible, para que los usuarios puedan planificar el evento de mantenimiento de infraestructura y evitar el tiempo de inactividad. Los eventos de mantenimiento de infraestructura no tienen un intervalo establecido entre los casos, pero, por lo general, se realizan varias veces al año.
SERVICE_UPDATE Actualizaciones que pueden incluir correcciones de errores, cambios o funciones nuevas que son retrocompatibles con las versiones existentes (incluidos los parches). Algunos SP permiten que los usuarios controlen la programación de estos eventos de mantenimiento con períodos de mantenimiento o funciones de rechazo del mantenimiento.

Control

Establece el tipo de control admitido. Es un comentario (como en los registros).

Enums
CONTROL_UNSPECIFIED Control no especificado.
APPLY Aplica el control.
MANAGE_POLICY Administrar el control de políticas
RESCHEDULE Control de reprogramación.

Anotaciones de herramientas

Sugerencia destructiva: ❌ | Sugerencia idempotente: ✅ | Sugerencia de solo lectura: ✅ | Sugerencia de mundo abierto: ❌