Method: projects.locations.runtimes.reportEvent

런타임 이벤트를 보고하고 처리합니다.

HTTP 요청

POST https://notebooks.googleapis.com/v1/{name}:reportEvent

경로 매개변수

매개변수
name

string

필수 항목. 형식: projects/{projectId}/locations/{location}/runtimes/{runtimeId}

승인을 처리하려면 지정된 리소스 name에 대해 다음과 같은 IAM 권한이 필요합니다.

  • iam.permissions.none

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현
{
  "vmId": string,
  "event": {
    object (Event)
  }
}
필드
vmId

string

필수 항목입니다. VM을 인증하는 VM 하드웨어 토큰입니다. https://cloud.google.com/compute/docs/instances/verifying-instance-identity

event

object (Event)

필수 항목입니다. 보고할 이벤트입니다.

응답 본문

성공한 경우 응답 본문에 Operation의 인스턴스가 포함됩니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/notebooks

자세한 내용은 Authentication Overview를 참조하세요.

이벤트

관리형 / 준관리형 노트북 인스턴스의 이벤트 정의입니다.

JSON 표현
{
  "reportTime": string,
  "type": enum (EventType),
  "details": {
    string: string,
    ...
  }
}
필드
reportTime

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

type

enum (EventType)

이벤트 유형입니다.

details

map (key: string, value: string)

(선택사항) 이벤트 세부정보 이 필드는 이벤트 정보를 전달하는 데 사용됩니다.

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }

EventType

이벤트 유형의 정의입니다.

열거형
EVENT_TYPE_UNSPECIFIED 이벤트가 지정되지 않았습니다.
IDLE 인스턴스 / 런타임이 유휴 상태입니다.
HEARTBEAT 인스턴스 / 런타임을 사용할 수 있습니다. 이 이벤트는 기본 컴퓨팅 인스턴스 / 런타임이 작동 중임을 나타냅니다.
HEALTH 인스턴스 / 런타임 상태를 사용할 수 있습니다. 이 이벤트는 인스턴스 / 런타임 상태 정보를 나타냅니다.
MAINTENANCE 인스턴스 / 런타임을 사용할 수 있습니다. 이 이벤트를 통해 인스턴스 / 런타임이 컨트롤 플레인에 호스트 유지보수 정보를 전송할 수 있습니다. https://cloud.google.com/compute/docs/gpus/gpu-host-maintenance