REST Resource: alerts

{
  "customerId": string,
  "alertId": string,
  "createTime": string,
  "startTime": string,
  "endTime": string,
  "type": string,
  "source": string,
  "data": {
    "@type": string,
    field1: ...,
    ...
  },
  "securityInvestigationToolLink": string,
  "deleted": boolean,
  "metadata": {
    object (AlertMetadata)
  },
  "updateTime": string,
  "etag": string
}

string

출력 전용. 고객의 Google Workspace 계정의 고유 식별자입니다.

string

출력 전용. 알림의 고유 식별자입니다.

string (Timestamp format)

출력 전용. 알림이 생성된 시간입니다.

string (Timestamp format)

필수 항목입니다. 이 알림을 발생시킨 이벤트가 시작 또는 감지된 시간입니다.

string (Timestamp format)

선택사항. 이 알림을 발생시킨 이벤트의 운영이 중지된 시간입니다. 제공되는 경우 종료 시간이 시작 시간 이전이어야 합니다. 제공되지 않으면 진행 중인 알림이 표시됩니다.

string

필수 항목입니다. 알림의 유형입니다. 알림이 생성된 후에만 출력됩니다. 사용 가능한 알림 유형 목록은 Google Workspace 알림 유형을 참고하세요.

string

필수 항목입니다. 알림을 보고한 시스템의 고유 식별자입니다. 알림이 생성된 후에만 출력됩니다.

지원되는 소스는 다음과 같습니다.

• Google 운영
• 휴대기기 관리
• Gmail 피싱
• 데이터 손실 방지
• 도메인 전체 테이크아웃
• 국가 스폰서 공격
• Google ID
• 앱 중단

object

선택사항. 이 알림과 관련된 데이터입니다(예: google.apps.alertcenter.type.DeviceCompromised).

string

출력 전용. 이 알림에 대한 보안 조사 도구 쿼리(선택사항)

boolean

출력 전용. 이 알림이 삭제로 표시된 경우 True입니다.

object (AlertMetadata)

출력 전용. 이 알림과 연결된 메타데이터입니다.

string (Timestamp format)

출력 전용. 이 알림이 최종 업데이트된 시간입니다.

string

선택사항. etag는 동시에 발생한 알림 업데이트가 서로를 덮어쓰지 않도록 방지하는 낙관적 동시 실행 제어에 사용됩니다. 경합 상태를 피하기 위해 알림 업데이트를 실행하기 위해 읽기-수정-쓰기 주기에서 시스템이 etag를 사용하는 것이 좋습니다. 알림이 포함된 응답에 etag가 반환되며, 시스템은 해당 etag를 업데이트 요청에 포함하여 알림을 동일한 버전의 알림에 적용해야 합니다.

업데이트 호출에 etag가 제공되지 않으면 기존 알림을 무조건 덮어씁니다.

{
  "customerId": string,
  "alertId": string,
  "status": string,
  "assignee": string,
  "updateTime": string,
  "severity": string,
  "etag": string
}

string

출력 전용. 고객의 Google Workspace 계정의 고유 식별자입니다.

string

출력 전용. 알림 식별자입니다.

string

알림의 현재 상태입니다. 지원되는 값은 다음과 같습니다.

• 시작되지 않음
• IN_PROGRESS
• 폐쇄됨

string

알림에 할당된 사용자의 이메일 주소입니다.

string (Timestamp format)

출력 전용. 이 메타데이터가 마지막으로 업데이트된 시간입니다.

string

알림의 심각도 값입니다. 알림 센터는 알림 생성 시 이 필드를 설정하며, 확인할 수 없는 경우 기본값은 빈 문자열로 설정됩니다. 이 필드의 업데이트 작업에 지원되는 값은 다음과 같습니다.

• 높음
• 보통
• 낮음

string

선택사항. etag는 낙관적 동시 실행 제어를 위해 알림 메타데이터의 동시 업데이트가 서로를 덮어쓰지 않도록 방지하는 방식으로 사용됩니다. 경합 상태를 방지하기 위해 시스템은 읽기-수정-쓰기 주기에서 etag를 사용하여 메타데이터 업데이트를 실행하는 것이 좋습니다. etag는 알림 메타데이터를 포함하는 응답에 반환되며, 시스템은 해당 etag를 알림 메타데이터 업데이트 요청에 포함하여 해당 변경사항이 동일한 버전의 알림 메타데이터에 적용되도록 해야 합니다.

알림 메타데이터를 업데이트하는 호출에 etag가 제공되지 않으면 기존 알림 메타데이터를 맹목적으로 덮어씁니다.