감사 로그 사용하기

개요

Frame.io는 애플리케이션에서 수행되는 대다수의 활동에 대해 감사 로그를 지원하고 유지 관리합니다. 여기에는 핵심 리소스에 대한 기본 CRUD와 일부 특수 추상화(예: AssetVersioned)가 모두 포함됩니다.

권한 및 사용 권한

계정 관리자만 계정의 감사 로그에 액세스할 수 있으며, 감사 로그 엔드포인트에 대한 모든 호출은 다음과 같이 account_id로 범위가 지정되어야 합니다.

GET https://api.frame.io/v2/accounts/:id/audit_logs

응답

감사 로그 응답은 모두 유사한 형식을 가집니다.

1
{
2
    "_type": "audit",
3
    "account_id": "<account-id>",
4
    "action": "<ActionTaken>",
5
    "actor": {
6
        "_type": "user",
7
        "id": "<user-id>",
8
    },
9
    "actor_id": "<user-id>",
10
    "id": "<audit-id>",
11
    "inserted_at": "<ISO-8601-datetime>",
12
    "item_id": "<resource-id>",
13
    "item_type": "<ResourceType>",
14
    "resource": {...},
15
    "team_id": "<team-id>",
16
    "updated_at": "<ISO-8601-datetime>"
17
}

필터

감사 로그는 날짜 범위를 비롯한 다양한 필터를 지원합니다. Frame.io의 Search 엔드포인트와 달리 필터는 GET 쿼리 문자열 매개변수로만 보낼 수 있습니다.

모든 필터는 다음과 동일한 형식을 따릅니다.

GET + 쿼리 문자열

1
GET
2
https://api.frame.io/accounts/:id/audit_logs?filter[filter_type1]=value1&filter[filter_type2]=value2

주요 필터 유형

감사 로그를 추출하고 탐색하기 위한 주요 필터 유형은 다음과 같습니다.

항목 유형 및 작업

필터 예시

필터는 위에서 설명한 바와 같이 모두 유사한 형식을 따릅니다. 다음은 시작하는 데 도움이 될 수 있는 특정 사용 사례를 타깃으로 한 몇 가지 예시입니다.

날짜 범위

날짜 범위는 inserted_at datetime value 및 해당 datetime에 적용할 op를 모두 지정해야 한다는 점에서 약간 특수한 경우입니다. 따라서 날짜 범위 쿼리에는 항상 두 개의 필터 요소가 있으며, 각 필터 요소는 [inserted_at] 매개변수 옆에 중첩됩니다.

지원되는 연산자는 다음과 같습니다.

• gt: 초과
• gte: 이상
• lt: 미만
• lte: 이하

날짜 범위 예시