MCP Tools Reference: maintenance.googleapis.com

도구: summarize_maintenances

집계된 통계를 제공하여 특정 프로젝트 및 위치의 유지보수를 요약합니다.

매개변수

  • parent(문자열, 필수): 리소스 유지관리의 상위 요소입니다(projects/{project}/locations/{location} 형식).
  • page_size (정수, 선택사항): 페이지당 전송할 최대 리소스 유지관리 수입니다.
  • page_token (문자열, 선택사항): 이전 SummarizeMaintenances 호출에서 받은 페이지 토큰입니다.
  • filter (문자열, 선택사항): https://google.aip.dev/160에 지정된 대로 목록을 필터링합니다.
  • order_by (문자열, 선택사항): https://google.aip.dev/132에 지정된 대로 결과를 정렬합니다.

반환 값

이 메서드는 다음을 포함하는 SummarizeMaintenancesResponse 객체를 반환합니다.

  • maintenances: 유지보수 요약 목록입니다.
  • next_page_token: 다음 페이지의 결과를 검색하기 위해 후속 요청에서 page_token으로 보낼 수 있는 토큰입니다.

참고

  • 모든 지역의 전역 요약의 위치로 '-'를 사용합니다.

다음 샘플은 curl를 사용하여 summarize_maintenances 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": "summarize_maintenances",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

입력 스키마

SummarizeMaintenances 맞춤 메서드의 요청 메시지입니다.

SummarizeMaintenancesRequest

JSON 표현 
{
  "parent": string,
  "pageSize": integer,
  "pageToken": string,
  "filter": string,
  "orderBy": string
}
필드
parent

string

필수 항목입니다. 리소스 유지보수의 상위 항목입니다(예: projects/123/locations/*).
pageSize

integer

페이지당 전송할 최대 리소스 유지관리 수입니다. 기본 페이지 크기는 20이고 최댓값은 1,000입니다.
pageToken

string

페이지 토큰: 이전 응답의 next_page_token이 제공되면 이 요청은 다음 페이지를 전송합니다.
filter

string

https://google.aip.dev/160에 지정된 대로 목록을 필터링합니다. 지원되는 필드는 다음과 같습니다. - maintenance.maintenanceName 예: - maintenance.maintenanceName="eb3b709c-9ca1-5472-9fb6-800a3849eda1"
orderBy

string

https://google.aip.dev/132에 지정된 대로 결과를 정렬합니다.

출력 스키마

SummarizeMaintenances 맞춤 메서드의 요청 메시지입니다.

SummarizeMaintenancesResponse

JSON 표현 
{
  "maintenances": [
    {
      object (MaintenanceSummary)
    }
  ],
  "nextPageToken": string,
  "unreachable": [
    string
  ]
}
필드
maintenances[]

object (MaintenanceSummary)

결과 요약입니다.
nextPageToken

string

있는 경우 다음 페이지 토큰을 후속 SummarizeMaintenances 호출에 제공하여 다음 페이지를 나열할 수 있습니다. 비어 있으면 더 이상 페이지가 없습니다.
unreachable[]

string

순서가 지정되지 않은 목록 도달할 수 없는 위치입니다.

MaintenanceSummary

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)
    }
  ]
}
필드
maintenanceName

string

출력 전용입니다. 유지보수 이름입니다.
title

string

출력 전용입니다. 유지보수의 제목입니다.
description

string

출력 전용입니다. 유지보수에 대한 설명입니다.
category

enum (MaintenanceCategory)

출력 전용입니다. 유지보수 이벤트의 카테고리입니다.
maintenanceScheduledStartTime

string (Timestamp format)

출력 전용입니다. 유지보수의 예약된 시작 시간입니다. 유지보수는 maintenanceScheduledStartTime 이후에 시작되며 maintenanceScheduledEndTime 전에 완료하기 위해 최선을 다할 것입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
maintenanceScheduledEndTime

string (Timestamp format)

출력 전용입니다. 예상 (최선을 다하지만 보장되지는 않음) 정기 점검 종료 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
maintenanceStartTime

string (Timestamp format)

출력 전용입니다. 유지보수가 시작된 실제 날짜입니다. 상태가 RUNNING로 변경된 후에만 필드가 표시됩니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
maintenanceEndTime

string (Timestamp format)

출력 전용입니다. 유지보수가 성공적으로 완료된 실제 날짜입니다. 상태가 SUCCEEDED로 변경된 후에만 필드가 표시됩니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. '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)

출력 전용입니다. 해당 유지보수에 사용할 수 있는 컨트롤입니다 (유지보수가 적용된 모든 리소스에 사용할 수 있는 것은 아님).
stats[]

object (Stats)

출력 전용입니다. 통계는 통계를 집계하는 데 사용되는 ResourceMaintenance의 필드입니다.

타임스탬프

JSON 표현 
{
  "seconds": string,
  "nanos": integer
}
필드
seconds

string (int64 format)

Unix epoch 1970-01-01T00:00:00Z 이후 UTC 시간의 초 단위로 표현합니다. -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

제어가 서비스 프로듀서 API에서만 사용할 수 있는지 (Unified Maintenance를 통해 사용할 수 없음) 나타냅니다.
documentation

string

유지보수 관리에 관한 서비스 프로듀서 문서 링크 isCustom이 true인 경우에만 제공됩니다.

통계

JSON 표현 
{
  "groupBy": string,
  "aggregates": [
    {
      object (Aggregate)
    }
  ]
}
필드
groupBy

string

groupBy는 집계 유형을 지정합니다. 예를 들어 group_by는 "state"일 수 있습니다.
aggregates[]

object (Aggregate)

집계는 <group, count> 쌍의 목록입니다. 예를 들어 group_by가 "state"인 경우 집계 목록의 가능한 튜플은 'SCHEDULED' : 11일 수 있습니다.

집계

JSON 표현 
{
  "group": string,
  "count": string
}
필드
group

string

count가 나타내는 group_by의 특정 값을 지정합니다. 예를 들어 group_by가 "state"이면 해당 그룹은 "SCHEDULED"일 수 있습니다.
count

string (int64 format)

그룹의 수입니다.

MaintenanceCategory

유지보수의 카테고리입니다.

열거형
MAINTENANCE_CATEGORY_UNSPECIFIED 지정되지 않은 카테고리입니다.
INFRASTRUCTURE 인프라 유지보수 이벤트는 Google Cloud가 네트워크 장비(예: Google Cloud Interconnect)에 대해 정기적인 유지보수를 수행하는 시간입니다. 이러한 이벤트는 일반적으로 미리 예약되며 가능한 경우 알림을 제공하므로 사용자가 인프라 유지보수 이벤트를 계획하고 다운타임을 방지할 수 있습니다. 인프라 유지보수 이벤트에는 발생하는 사고 사이에 설정된 간격이 없지만 일반적으로 1년에 몇 번 정도 발생합니다.
SERVICE_UPDATE 버그 수정, 변경사항 또는 기존 버전과 하위 호환되는 새로운 기능 (패치 포함)을 포함할 수 있는 업데이트입니다. 일부 SP에서는 사용자가 유지보수 기간을 사용하여 이러한 유지보수 이벤트의 일정을 제어하거나 유지보수 기능을 거부할 수 있습니다.

컨트롤

지원되는 컨트롤의 유형을 설정합니다. 주석 (로그에서와 같이).

열거형
CONTROL_UNSPECIFIED 지정되지 않은 컨트롤입니다.
APPLY 제어를 적용합니다.
MANAGE_POLICY 정책 제어 관리
RESCHEDULE 일정 변경 컨트롤

도구 주석

파괴적 힌트: ❌ | 멱등성 힌트: ✅ | 읽기 전용 힌트: ✅ | 오픈 월드 힌트: ❌