監査ログの操作

概要

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 の検索エンドポイントとは異なり、フィルターは、GET クエリ文字列パラメーターとしてのみ送信できます。

フィルターはすべて、同じ書式に従います。

GET + クエリ文字列

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

重要なフィルタータイプ

監査ログをカリングおよびナビゲートするための重要なフィルタータイプは、次のとおりです。

項目タイプおよびアクション

フィルターの例

フィルターはすべて、上記のように同様の形式に従います。開始に役立つ、特定のユースケースでのターゲットの例を、以下にいくつか示します。

日付範囲

日付範囲は、inserted_at 日時 value とその日時に適用する操作の両方を指定する必要があるという点で、わずかに特殊なケースです。op

したがって、日付範囲クエリには常に 2 つのフィルター要素があり、それぞれが [inserted_at] パラメーターの横にネストされます。

サポートされている操作には、次が含まれます。

• gt：より大きい
• gte：以上
• lt：より小さい
• lte：以下

日付範囲の例