MCP Tools Reference: maintenance.googleapis.com

工具：get_resource_maintenance

检索有关特定资源维护的详细信息。

参数

  • name（字符串，必需）：服务内资源的资源名称，格式为 projects/{project}/locations/{location}/resourceMaintenances/{resource_maintenance_id}。

返回值

如果找到，则为 ResourceMaintenance 资源对象。

以下示例演示了如何使用 curl 调用 get_resource_maintenance MCP 工具。

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": "get_resource_maintenance",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

输入架构

GetResourceMaintenance 方法的请求结构。

GetResourceMaintenanceRequest

JSON 表示法 
{
  "name": string
}
字段
name

string

必需。服务内资源的名称。

输出架构

ResourceMaintenance 是一种资源，表示对资源的维护操作。

资源维护

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
}
字段
name

string

标识符。resource_maintenance 资源的名称。格式："projects/{project}/locations/{location}/resourceMaintenance/{resource-maintenance-id}"
resource

object (Resource)

仅限输出。资源维护的资源规范。
maintenance

object (Maintenance)

仅限输出。维护的详细信息。
state

enum (State)

仅限输出。资源维护的状态。
createTime

string (Timestamp format)

仅限输出。资源维护的创建时间。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
updateTime

string (Timestamp format)

仅限输出。资源维护的更新时间。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
maintenanceStartTime

string (Timestamp format)

仅限输出。资源维护开始的时间。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
maintenanceEndTime

string (Timestamp format)

仅限输出。资源维护完成的时间。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
maintenanceCancelTime

string (Timestamp format)

仅限输出。资源维护取消的时间。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
maintenanceScheduledStartTime

string (Timestamp format)

仅限输出。资源维护计划开始的时间。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
maintenanceScheduledEndTime

string (Timestamp format)

仅限输出。资源维护计划结束的时间。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
userControllable

boolean

仅限输出。表示用户是否对相应维护具有一定的控制权，无论是通过维护政策在安排维护之前主动控制，还是在安排维护之后通过被动控制（请参阅“controls”字段）来控制
controls[]

object (MaintenanceControl)

仅限输出。维护的控制措施。
labels

map (key: string, value: string)

可选。资源上的标签，可用于分类。与 Kubernetes 资源标签类似。

包含一系列 "key": value 对的对象。示例：{ "name": "wrench", "mass": "1.3kg", "count": "3" }。
annotations

map (key: string, value: string)

可选。注释是与资源一起存储的非结构化键值对映射，可由外部工具设置，用于存储和检索任意元数据。它们无法查询，并且在修改对象时应予以保留。

如需了解详情，请参阅 https://kubernetes.io/docs/user-guide/annotations

包含一系列 "key": value 对的对象。示例：{ "name": "wrench", "mass": "1.3kg", "count": "3" }。
uid

string

仅限输出。资源的唯一标识符。在服务范围内，UID 在此资源的时间和空间内是唯一的。它通常是服务器在成功创建资源时生成的，不得进行更改。当存在资源名称重用时，UID 可用来唯一地标识资源。此字段应为 UUID4。
etag

string

仅限输出。不透明值，用于唯一地标识资源的版本或世代。它可用于确认客户端和服务器是否就正在写入的资源的顺序达成一致。

资源

JSON 表示法 
{
  "resourceName": string,
  "location": string,
  "type": string
}
字段
resourceName

string

仅限输出。Name 是指受维护影响的消费资源。如需查看可用的值，请访问：https://cloud.google.com/asset-inventory/docs/asset-names
location

string

仅限输出。资源的位置。格式：us-central1
type

string

仅限输出。资源的类型。如需查看可用的值，请访问以下网址：https://cloud.google.com/asset-inventory/docs/asset-types#supported_resource_types。请注意，并非所有资源类型都会报告维护情况。

维护

JSON 表示法 
{
  "maintenanceName": string,
  "title": string,
  "description": string,
  "category": enum (MaintenanceCategory)
}
字段
maintenanceName

string

维护是相应维护资源的名称，遵循标准命名方案："{maintenance-id}"
title

string

仅限输出。维护的标题。
description

string

仅限输出。维护的说明。
category

enum (MaintenanceCategory)

仅限输出。维护的类别。

时间戳

JSON 表示法 
{
  "seconds": string,
  "nanos": integer
}
字段
seconds

string (int64 format)

表示世界协调时间 (UTC) 的秒数（从 Unix 纪元 1970-01-01T00:00:00Z 开始算起）。必须介于 -62135596800 到 253402300799 之间（含边界值），对应于 0001-01-01T00:00:00Z 到 9999-12-31T23:59:59Z。
nanos

integer

秒数的非负小数部分（以纳秒为单位）。此字段是时长的纳秒部分，而不是秒的替代项。对于含小数部分的负秒数，仍必须包含按时间递升的非负纳秒值。必须在 0 到 999,999,999 之间（含边界值）。

MaintenanceControl

JSON 表示法 
{
  "control": enum (Control),
  "isCustom": boolean,
  "documentation": string
}
字段
control

enum (Control)

资源维护的控制。
isCustom

boolean

表示控制变量是否仅在 Service Producer API 中可用（而非通过 Unified Maintenance）。
documentation

string

指向有关维护控制的服务提供方文档的链接。仅当 isCustom 为 true 时提供。

LabelsEntry

JSON 表示法 
{
  "key": string,
  "value": string
}
字段
key

string
value

string

AnnotationsEntry

JSON 表示法 
{
  "key": string,
  "value": string
}
字段
key

string
value

string

MaintenanceCategory

维护的类别。

枚举
MAINTENANCE_CATEGORY_UNSPECIFIED 未指定的类别。
INFRASTRUCTURE 基础设施维护事件是指 Google Cloud 对网络设备（例如 Google Cloud Interconnect）执行常规维护的时间。这些事件通常是提前安排的，我们会尽可能提供通知，以便用户针对基础设施维护事件进行规划并防止停机。基础架构维护事件相隔的时间不固定，但通常是一年几次。
SERVICE_UPDATE 更新可能包含与现有版本（包括补丁）向后兼容的 bug 修复、变更或新功能。部分 SP 允许用户使用维护期和/或拒绝维护功能来控制这些维护事件的安排。

州

State 是资源维护的状态。

枚举
STATE_UNSPECIFIED 未指定状态。
SCHEDULED 安排在特定时间段内。对于中断性维护，应遵守维护政策，即其可用窗口、排除项和通知期。
RUNNING 维护正在进行中。
CANCELLED 不再计划，通常是在其他维护（例如升级到较新版本）已发生或用户跳过维护时。
SUCCEEDED 已成功完成。

控制

设置支持的控制类型。注释（如日志中所示）。

枚举
CONTROL_UNSPECIFIED 未指定的控制类型。
APPLY 应用控制。
MANAGE_POLICY 管理政策控制。
RESCHEDULE 重新安排控制。

工具注释

破坏性提示：❌ | 等幂性提示：✅ | 只读提示：✅ | 开放世界提示：❌