MCP Tools Reference: maintenance.googleapis.com

Ferramenta: summarize_maintenances

Resume as manutenções de um determinado projeto e local fornecendo estatísticas agregadas.

Parâmetros

  • parent (string, obrigatório): o recurso pai da manutenção, no formato projects/{project}/locations/{location}.
  • page_size (inteiro, opcional): o número máximo de manutenções de recursos a serem enviadas por página.
  • page_token (string, opcional): um token de página recebido de uma chamada SummarizeMaintenances anterior.
  • filter (string, opcional): filtra a lista conforme especificado em https://google.aip.dev/160.
  • order_by (string, opcional): ordena os resultados conforme especificado em https://google.aip.dev/132.

Valor de retorno

O método retorna um objeto SummarizeMaintenancesResponse, que contém:

  • maintenances: uma lista de resumos de manutenção.
  • next_page_token: um token que pode ser enviado como page_token em uma solicitação subsequente para recuperar a próxima página de resultados.

Observações

  • Use "-" como local para um resumo global em todas as regiões.

O exemplo a seguir demonstra como usar curl para invocar a ferramenta summarize_maintenances MCP.

Solicitação 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

Mensagem de solicitação para o método personalizado "SummarizeMaintenances".

SummarizeMaintenancesRequest

Representação JSON 
{
  "parent": string,
  "pageSize": integer,
  "pageToken": string,
  "filter": string,
  "orderBy": string
}
Campos
parent

string

Obrigatório. O recurso pai da manutenção. Por exemplo, projects/123/locations/*
pageSize

integer

O número máximo de manutenções de recursos a serem enviadas por página. O tamanho de página padrão é 20, e o máximo é 1.000.
pageToken

string

O token da página: se o next_page_token de uma resposta anterior for fornecido, esta solicitação enviará a página seguinte.
filter

string

Filtre a lista conforme especificado em https://google.aip.dev/160. Os campos aceitos incluem: - maintenance.maintenanceName Exemplos: - maintenance.maintenanceName="eb3b709c-9ca1-5472-9fb6-800a3849eda1"
orderBy

string

Ordene os resultados conforme especificado em https://google.aip.dev/132.

Esquema de saída

Mensagem de solicitação para o método personalizado "SummarizeMaintenances".

SummarizeMaintenancesResponse

Representação JSON 
{
  "maintenances": [
    {
      object (MaintenanceSummary)
    }
  ],
  "nextPageToken": string,
  "unreachable": [
    string
  ]
}
Campos
maintenances[]

object (MaintenanceSummary)

Os resumos resultantes.
nextPageToken

string

Se presente, o token da próxima página pode ser fornecido a uma chamada SummarizeMaintenances subsequente para listar a próxima página. Se estiver vazio, não haverá mais páginas.
unreachable[]

string

Lista não ordenada. Locais que não puderam ser alcançados.

MaintenanceSummary

Representação 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

Apenas saída. O nome da manutenção.
title

string

Apenas saída. O título da manutenção.
description

string

Apenas saída. A descrição da manutenção.
category

enum (MaintenanceCategory)

Apenas saída. A categoria do evento de manutenção.
maintenanceScheduledStartTime

string (Timestamp format)

Apenas saída. Horário de início programado da manutenção. A manutenção vai começar às maintenanceScheduledStartTime ou depois, com o melhor esforço para terminar antes das maintenanceScheduledEndTime.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
maintenanceScheduledEndTime

string (Timestamp format)

Apenas saída. Uma estimativa (da melhor maneira possível, não garantida) do horário de término da manutenção programada.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
maintenanceStartTime

string (Timestamp format)

Apenas saída. Data real em que a manutenção começou. Campo presente somente depois que o estado mudou para RUNNING.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
maintenanceEndTime

string (Timestamp format)

Apenas saída. Data real em que a manutenção foi concluída. Campo presente somente depois que o estado mudou para SUCCEEDED.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
userControllable

boolean

Apenas saída. Indica se o usuário tem algum controle sobre essa manutenção, seja de forma proativa antes de ela ser programada com a política de manutenção ou com controles reativos depois que ela foi programada (consulte o campo "controls").
controls[]

object (MaintenanceControl)

Apenas saída. Controle disponível para essa manutenção (pode não estar disponível para todos os recursos em que a manutenção é aplicada).
stats[]

object (Stats)

Apenas saída. "Stats" é um campo de "ResourceMaintenance" usado para agregar as estatísticas.

Carimbo de data/hora

Representação JSON 
{
  "seconds": string,
  "nanos": integer
}
Campos
seconds

string (int64 format)

Representa os segundos do horário UTC desde a época Unix 1970-01-01T00:00:00Z. Precisa estar entre -62135596800 e 253402300799 (o que corresponde a 0001-01-01T00:00:00Z a 9999-12-31T23:59:59Z).
nanos

integer

Frações não negativas de um segundo com resolução de nanossegundos. Esse campo é a parte de nanossegundos da duração, não uma alternativa aos segundos. Os valores de segundos negativos com frações ainda precisam ter valores em nanossegundos não negativos que representam períodos posteriores. O valor precisa ser de 0 a 999.999.999 (inclusive).

MaintenanceControl

Representação JSON 
{
  "control": enum (Control),
  "isCustom": boolean,
  "documentation": string
}
Campos
control

enum (Control)

O controle da manutenção de recursos.
isCustom

boolean

Indica se o controle está disponível apenas na API Service Producer (não no Unified Maintenance).
documentation

string

Link para a documentação do produtor de serviços sobre o controle de manutenção. Fornecido apenas quando isCustom é true.

Estatísticas

Representação JSON 
{
  "groupBy": string,
  "aggregates": [
    {
      object (Aggregate)
    }
  ]
}
Campos
groupBy

string

"groupBy" especifica o tipo de agregação. Por exemplo, um group_by pode ser "state"
aggregates[]

object (Aggregate)

"Aggregates" é uma lista de pares <grupo, contagem>. Por exemplo, se o group_by for "state", uma tupla possível na lista de agregações poderá ser "SCHEDULED" : 11,

Agregar

Representação JSON 
{
  "group": string,
  "count": string
}
Campos
group

string

Especifica qual valor específico da contagem group_by representa. Por exemplo, se group_by for "state", o grupo correspondente poderá ser "SCHEDULED".
count

string (int64 format)

A contagem do grupo.

MaintenanceCategory

A categoria da manutenção.

Tipos enumerados
MAINTENANCE_CATEGORY_UNSPECIFIED Categoria não especificada.
INFRASTRUCTURE Eventos de manutenção de infraestrutura são momentos em que o Google Cloud realiza manutenção regular em equipamentos de rede, como o Google Cloud Interconnect. Em geral, eles são programados com antecedência e, quando possível, enviamos notificações para que os usuários possam se planejar e evitar inatividade. Os eventos de manutenção de infraestrutura não têm um intervalo definido entre as ocorrências, mas geralmente acontecem várias vezes ao ano.
SERVICE_UPDATE Atualizações que podem incluir correções de bugs, mudanças ou novos recursos compatíveis com versões anteriores (incluindo patches). Alguns provedores de serviços permitem que os usuários controlem o agendamento desses eventos de manutenção usando janelas de manutenção e/ou recursos de negação de manutenção.

Controle

Define o tipo de controle compatível. "comment" (como em registros).

Tipos enumerados
CONTROL_UNSPECIFIED Controle não especificado.
APPLY Aplique o controle.
MANAGE_POLICY Gerenciar o controle de políticas.
RESCHEDULE Controle de reagendamento.

Anotações de ferramentas

Dica destrutiva: ❌ | Dica idempotente: ✅ | Dica somente leitura: ✅ | Dica de mundo aberto: ❌