MCP Tools Reference: maintenance.googleapis.com

도구: list_resource_maintenances

특정 프로젝트와 위치의 리소스 유지보수를 나열합니다.

매개변수

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

반환 값

이 메서드는 다음이 포함된 ListResourceMaintenancesResponse 객체를 반환합니다.

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

참고

  • 모든 지역의 전역 보기를 보려면 위치로 '-'를 사용합니다.

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

입력 스키마

ListResourceMaintenances 메서드의 요청 구조입니다.

ListResourceMaintenancesRequest

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

string

필수 항목입니다. 리소스 유지보수의 상위 요소입니다.
pageSize

integer

페이지당 전송할 최대 리소스 유지관리 수입니다.
pageToken

string

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

string

https://google.aip.dev/160에 지정된 대로 목록을 필터링합니다.
orderBy

string

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

출력 스키마

ListResourceMaintenances 메서드의 응답 구조입니다.

ListResourceMaintenancesResponse

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

object (ResourceMaintenance)

결과 리소스 유지보수입니다.
nextPageToken

string

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

string

도달할 수 없는 위치입니다.

리소스 유지보수

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)

출력 전용입니다. 리소스 유지관리의 생성 시간입니다.

생성된 출력은 항상 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"입니다.
updateTime

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)

출력 전용입니다. 리소스 유지보수가 시작된 시간입니다.

생성된 출력은 항상 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)

출력 전용입니다. 리소스 유지보수가 완료된 시간입니다.

생성된 출력은 항상 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"입니다.
maintenanceCancelTime

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"입니다.
maintenanceScheduledStartTime

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"입니다.
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"입니다.
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)

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인 경우에만 제공됩니다.

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

주

State는 리소스 유지보수의 상태입니다.

열거형
STATE_UNSPECIFIED 지정되지 않은 상태입니다.
SCHEDULED 특정 기간에 예약됨 중단성 유지보수의 경우 유지보수 정책(사용 가능한 기간, 제외, 알림 기간)을 준수해야 합니다.
RUNNING 유지보수가 진행 중입니다.
CANCELLED 더 이상 계획되지 않음 (예: 최신 버전으로 업그레이드) 또는 사용자가 유지보수를 건너뛴 경우
SUCCEEDED 성공적으로 완료되었습니다.

컨트롤

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

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

도구 주석

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