MCP Tools Reference: maintenance.googleapis.com

Ferramenta: list_resource_maintenances

Lista as manutenções de recursos para um determinado projeto e local.

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 ListResourceMaintenances anterior.
  • filter (string, opcional): filtre 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 ListResourceMaintenancesResponse, que contém:

  • resource_maintenances: uma lista de manutenções de recursos que correspondem aos critérios da solicitaçã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 uma visão global em todas as regiões.

O exemplo a seguir demonstra como usar curl para invocar a ferramenta list_resource_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": "list_resource_maintenances",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Esquema de entrada

A estrutura da solicitação para o método "ListResourceMaintenances".

ListResourceMaintenancesRequest

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

string

Obrigatório. O pai da manutenção do recurso.
pageSize

integer

O número máximo de manutenções de recursos a serem enviadas por página.
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.
orderBy

string

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

Esquema de saída

A estrutura de resposta para o método "ListResourceMaintenances".

ListResourceMaintenancesResponse

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

object (ResourceMaintenance)

As manutenções de recursos resultantes.
nextPageToken

string

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

string

Locais que não puderam ser alcançados.

ResourceMaintenance

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

Identificador. O nome do recurso "resource_maintenance". Formato: "projects/{project}/locations/{location}/resourceMaintenance/{resource-maintenance-id}"
resource

object (Resource)

Apenas saída. A especificação do recurso da manutenção de recursos.
maintenance

object (Maintenance)

Apenas saída. Os detalhes da manutenção.
state

enum (State)

Apenas saída. O estado da manutenção do recurso.
createTime

string (Timestamp format)

Apenas saída. O tempo de criação da manutenção do recurso.

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

string (Timestamp format)

Apenas saída. O horário de atualização da manutenção do recurso.

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. O horário em que a manutenção do recurso começou.

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. O horário em que a manutenção do recurso foi concluída.

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

string (Timestamp format)

Apenas saída. O horário em que a manutenção do recurso foi cancelada.

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

string (Timestamp format)

Apenas saída. O horário em que a manutenção do recurso foi programada para começar.

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. O horário em que a manutenção do recurso foi programada para terminar.

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 de programada (consulte o campo "controles").
controls[]

object (MaintenanceControl)

Apenas saída. Os controles da manutenção.
labels

map (key: string, value: string)

Opcional. Os rótulos no recurso, que podem ser usados para categorização, semelhantes aos rótulos de recursos do Kubernetes.

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
annotations

map (key: string, value: string)

Opcional. Anotações é um mapa de chave-valor não estruturado armazenado com um recurso que pode ser definido por ferramentas externas para armazenar e recuperar metadados arbitrários. Elas não podem ser consultadas e precisam ser preservadas ao modificar objetos.

Mais informações: https://kubernetes.io/docs/user-guide/annotations

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
uid

string

Apenas saída. O identificador exclusivo do recurso. O UID é exclusivo no tempo e espaço para esse recurso no escopo do serviço. Geralmente, ele é gerado pelo servidor quando um recurso é criado com sucesso e não pode ser modificado. O UID é usado para identificar exclusivamente recursos com reutilização de nome de recurso. Deve ser um UUID4.
etag

string

Apenas saída. Um valor opaco que identifica exclusivamente uma versão ou geração de um recurso. Pode ser usado para confirmar que o cliente e o servidor concordam com a ordenação de um recurso em criação.

Recurso

Representação JSON 
{
  "resourceName": string,
  "location": string,
  "type": string
}
Campos
resourceName

string

Apenas saída. Name é a referência ao recurso do consumidor afetado pela manutenção. Os valores disponíveis podem ser encontrados aqui: https://cloud.google.com/asset-inventory/docs/asset-names
location

string

Apenas saída. O local do recurso. Formato: us-central1
type

string

Apenas saída. O tipo de recurso. Os valores disponíveis podem ser encontrados aqui: https://cloud.google.com/asset-inventory/docs/asset-types#supported_resource_types. Nem todos os tipos de recursos têm manutenções informadas.

Manutenção

Representação JSON 
{
  "maintenanceName": string,
  "title": string,
  "description": string,
  "category": enum (MaintenanceCategory)
}
Campos
maintenanceName

string

"Maintenance" é o nome do recurso de manutenção correspondente, seguindo o esquema de nomenclatura padrão: "{maintenance-id}"
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 da manutenção.

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.

LabelsEntry

Representação JSON 
{
  "key": string,
  "value": string
}
Campos
key

string
value

string

AnnotationsEntry

Representação JSON 
{
  "key": string,
  "value": string
}
Campos
key

string
value

string

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.

Estado

O estado é o estado de uma manutenção de recursos.

Tipos enumerados
STATE_UNSPECIFIED Estado não especificado.
SCHEDULED Agendado para um período específico. Para manutenção disruptiva, ela precisa respeitar a política de manutenção, ou seja, as janelas disponíveis, as exclusões e o período de notificação.
RUNNING A manutenção está em andamento.
CANCELLED Não mais planejado, geralmente quando outra manutenção (por exemplo, upgrade para uma versão mais recente) já ocorreu ou o usuário pulou a manutenção.
SUCCEEDED Concluído com sucesso.

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