문서 본문으로 이동
문서API 참조작업 기록 조회
GETBearer 토큰

작업 기록 조회

/api/v1/audit

고정 팀의 서버, 스냅샷, 방화벽 및 사설 네트워크에 제출된 작업을 조회합니다. 회수된 리소스도 포함하며 감사 권한이 필요합니다. 페이지당 10개이며 자격 증명과 실행 상태는 반환하지 않습니다.

호출 전 확인

업무 기록만 조회하며 작업을 재시도하거나 공급자를 호출하지 않습니다. 자격 증명, 서명, 공급자 원문 및 실행 상태를 제외하며 전체 감사 내보내기가 아닙니다.

API 필드명, 자료형, 코드는 모든 언어에서 그대로 유지됩니다.

요청 예시

cURL
curl "https://tovahub.com/api/v1/audit?type=all&action=shutdown&page=1" \
  -H "Authorization: Bearer $TOVAHUB_TOKEN"

예시만 표시합니다. 이 페이지는 API 요청을 보내지 않습니다.

응답 예시
JSON
{
  "page": 1,
  "limit": 10,
  "total": 1,
  "events": [
    {
      "id": "server:507f1f77bcf86cd799439014",
      "type": "server",
      "action": "shutdown",
      "actor": {
        "id": "507f1f77bcf86cd799439012",
        "name": "Alex"
      },
      "resource": {
        "id": "507f1f77bcf86cd799439013",
        "name": "api-node"
      },
      "createdAt": "2026-11-12T04:00:00.000Z"
    }
  ]
}

매개변수

type쿼리 · 선택

string

all, server, firewall 또는 network이며 기본값은 all입니다.

action쿼리 · 선택

string

스키마의 정확한 작업 하나 또는 all이며 기본값은 all입니다. 유형과 작업이 맞지 않으면 빈 페이지를 반환합니다.

page쿼리 · 선택

integer

페이지 번호는 1–10000이며 페이지당 기록은 10개입니다.

응답

HTTP 상태 200

인증된 고정 팀의 안전한 작업 기록입니다. 작업 상태, 자격 증명 및 공급자 데이터는 제외합니다.

pageinteger

요청한 페이지 번호이며 1부터 시작합니다.

limit10

고정 페이지 크기입니다.

totalinteger

고정 팀에서 조건에 맞는 기록의 총 개수입니다.

eventsarray

조건에 맞는 최신 작업이며 최대 10개입니다.

events[].idstring

server, firewall 또는 network 접두사가 있는 고정 기록 ID입니다.

events[].typestring

server, firewall 또는 network입니다.

events[].actionstring

요청 스키마에 정의된 정확한 안전 작업 이름입니다.

events[].actorobject

id와 name입니다. 사용할 수 없는 신원은 null이며 다른 팀의 신원을 조회하지 않습니다.

events[].resourceobject

플랫폼 ID와 표시 이름이며 사용할 수 없으면 null입니다. 회수된 리소스일 수 있습니다.

events[].createdAtstring

작업이 접수된 ISO 8601 시간입니다.