MCP Tools Reference: maintenance.googleapis.com

Herramienta: list_resource_maintenances

Enumera los mantenimientos de recursos para una ubicación y un proyecto determinados.

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 ListResourceMaintenances 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 ListResourceMaintenancesResponse, que contiene lo siguiente:

  • resource_maintenances: Es una lista de mantenimientos de recursos que coinciden con los criterios de la solicitud.
  • 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 una vista global de todas las regiones.

En el siguiente ejemplo, se muestra cómo usar curl para invocar la herramienta de MCP list_resource_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": "list_resource_maintenances",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Esquema de entrada

Es la estructura de la solicitud para el método ListResourceMaintenances.

ListResourceMaintenancesRequest

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

string

Obligatorio. Es el recurso principal del mantenimiento.
pageSize

integer

Es la cantidad máxima de mantenimientos de recursos que se pueden enviar por página.
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.
orderBy

string

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

Esquema de salida

Es la estructura de respuesta del método ListResourceMaintenances.

ListResourceMaintenancesResponse

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

object (ResourceMaintenance)

Son los mantenimientos de recursos resultantes.
nextPageToken

string

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

string

Ubicaciones a las que no se pudo llegar.

Mantenimiento de recursos

Representación 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
}
Campos
name

string

Es el identificador. Es el nombre del recurso resource_maintenance. Formato: "projects/{project}/locations/{location}/resourceMaintenance/{resource-maintenance-id}"
resource

object (Resource)

Solo salida. Es la especificación del recurso para el mantenimiento del recurso.
maintenance

object (Maintenance)

Solo salida. Son los detalles del mantenimiento.
state

enum (State)

Solo salida. Es el estado del mantenimiento del recurso.
createTime

string (Timestamp format)

Solo salida. Es la fecha y hora de creación del mantenimiento del recurso.

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

string (Timestamp format)

Solo salida. Es la hora de actualización del mantenimiento del recurso.

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. Es la fecha y hora en que comenzó el mantenimiento del recurso.

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. Es la fecha y hora en la que se completó el mantenimiento del recurso.

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

string (Timestamp format)

Solo salida. Fecha y hora en que se canceló el mantenimiento del recurso.

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

string (Timestamp format)

Solo salida. Es la fecha y hora en que se programó el inicio del mantenimiento del recurso.

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. Fecha y hora en que se programó la finalización del mantenimiento del recurso.

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 con la política de mantenimiento o con controles reactivos después de que se programara (consulta el campo de controles).
controls[]

object (MaintenanceControl)

Solo salida. Los controles del mantenimiento.
labels

map (key: string, value: string)

Es opcional. Son las etiquetas del recurso, que se pueden usar para la categorización, de forma similar a las etiquetas de recursos de Kubernetes.

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
annotations

map (key: string, value: string)

Es opcional. Las anotaciones son un mapa de pares clave-valor no estructurado que se almacena con un recurso que herramientas externas pueden establecer para almacenar y recuperar metadatos arbitrarios. No se pueden consultar y deben conservarse cuando se modifican objetos.

Más información: https://kubernetes.io/docs/user-guide/annotations

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
uid

string

Solo salida. Identificador único del recurso. El UID es único en el tiempo y espacio para este recurso dentro del alcance de este servicio. Normalmente, el servidor lo genera durante la creación correcta de un recurso y no se debe cambiar. El UID se usa para identificar los recursos de manera única en caso de la reutilización de nombres de recursos y debe ser un UUID4.
etag

string

Solo salida. Valor opaco que identifica de manera única a una versión o generación de un recurso. Se puede usar para confirmar que el cliente y el servidor están de acuerdo en el orden del recurso que se escribe.

Recurso

Representación JSON 
{
  "resourceName": string,
  "location": string,
  "type": string
}
Campos
resourceName

string

Solo salida. Name es la referencia al recurso del consumidor afectado por el mantenimiento. Puedes encontrar los valores disponibles aquí: https://cloud.google.com/asset-inventory/docs/asset-names
location

string

Solo salida. Ubicación del recurso. Formato: us-central1
type

string

Solo salida. El tipo de recurso. Los valores disponibles se pueden encontrar aquí: https://cloud.google.com/asset-inventory/docs/asset-types#supported_resource_types. Ten en cuenta que no se informarán los mantenimientos de todos los tipos de recursos.

Mantenimiento

Representación JSON 
{
  "maintenanceName": string,
  "title": string,
  "description": string,
  "category": enum (MaintenanceCategory)
}
Campos
maintenanceName

string

Maintenance es el nombre del recurso de mantenimiento correspondiente según el esquema de nombres estándar: "{maintenance-id}"
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 mantenimiento.

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.

LabelsEntry

Representación JSON 
{
  "key": string,
  "value": string
}
Campos
key

string
value

string

AnnotationsEntry

Representación JSON 
{
  "key": string,
  "value": string
}
Campos
key

string
value

string

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.

Estado

El estado es el estado de un mantenimiento de recursos.

Enums
STATE_UNSPECIFIED Significa que el estado no se especificó.
SCHEDULED Se programó para un período específico. En el caso del mantenimiento disruptivo, se debe respetar la política de mantenimiento, es decir, los períodos disponibles, las exclusiones y el período de notificación.
RUNNING El mantenimiento está en curso.
CANCELLED Ya no está planificado, por lo general, cuando ya se realizó otro mantenimiento (p.ej., actualización a una versión más reciente) o el usuario omitió el mantenimiento.
SUCCEEDED Se completó correctamente.

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