指定したユーザーの監査ログエントリを取得

import requests
url = "https://api.frame.io/v2/users/erfb57e0-79f2-4bc7-9b70-99fbc175175c/events"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.json())

[
  {
    "anonymous_user_id": null,
    "client": null,
    "event_type": "asset_created",
    "event_details": {
      "account_id": "6bdcb4d9-9a2e-4548-a765-ae6b27a6c024",
      "ext": ".png",
      "filesize": 170144,
      "filetype": "image/png",
      "index": -17,
      "name": "Sample asset.png",
      "parent_id": "ba6cd478-5ca3-4c1a-2186-82cdaecb3e6c",
      "private": false,
      "project_id": "e9794c94-16a4-4e33-b4e6-cdd9757d0e24",
      "sm_refresh_at": "2024-06-28T21:42:54Z",
      "uploaded_at": "2024-06-28T21:42:54.437202Z"
    },
    "id": 1944044771,
    "inserted_at": "2024-06-28T21:42:54.516273Z",
    "ip_address": "255.255.255.255",
    "project_id": "j2794c94-16a4-4e33-b4e6-cdd9757d0e24",
    "resource_id": "92je2963-24ae-4cd1-be13-19a93c92eb6e",
    "resource_type": "asset",
    "team_id": "5j4d6420-fa8d-4e85-af05-0f26785c54f5",
    "source": "unknown",
    "user_id": "b72b57e0-79f2-4bc7-9b70-99fbc175175c",
    "updated_at": "2024-06-28T21:42:54.516273Z"
  }
]

クエリパラメーターで一部のフィルタリングを行い、指定されたユーザーの監査ログを取得します。これは、指定したユーザーの activity log と考えるのが最適です。

認証

AuthorizationBearer

Bearer <token>形式のBearer認証。tokenは認証トークンです。

パスパラメータ

user_idstring必須形式: "uuid"デフォルト値 erfb57e0-79f2-4bc7-9b70-99fbc175175c

User ID

クエリパラメータ

filters[start_date]stringオプション形式: "date"

ISO 開始日

filters[end_date]stringオプション形式: "date"

ISO 終了日

filters[resource_type]enumオプション

リソースタイプでフィルター

filters[event_type]enumオプション

アクティビティの種類でフィルター

filters[team_id]stringオプション形式: "uuid"

チーム ID でフィルター

filters[project_id]stringオプション形式: "uuid"

プロジェクト ID でフィルター

filters[resource_id]stringオプション形式: "uuid"

リソース ID (アセット ID、プロジェクト ID、ユーザー ID) でフィルター

filters[user_id]stringオプション形式: "uuid"

ユーザー ID でフィルター

filters[ip_address]stringオプション

IP アドレスでフィルター

pageintegerオプションデフォルト値 1

ページ番号

page_sizeintegerオプション<=200デフォルト値 50

ページあたりのレコード数

レスポンスヘッダー

linkstringオプション

Pagination links

page-numberinteger

Current page of results

per-pageinteger

Number of entries per page

totalinteger

Total entries across all pagess

total-pagesinteger

Number of pages

レスポンス

Succesful Event logs response

account_idstring or nullオプション形式: "uuid"

anonymous_user_idstring or nullオプション形式: "uuid"

clientstring or nullオプション

監査イベントをトリガーした API クライアント。これは、常に入力されるとは限りません。

イベントを生成した API 呼び出しが OAuth アプリ経由で行われた場合は oauth_app/:uuid のようになり、開発者トークン経由で行われた場合は user_token/:uuid のようになります。UUID は、そのトークンが属するユーザー ID です。

以下に例を示します。

user_token/57823879-e541-49b0-b902-c43794c4400c
oauth_app/80ccf0bb-ae91-49c4-8aec-8f6238c14947
web/2024-06-10-18-15
pipeline-media-warden/cbd0061f6f190489e8af3137b8707b33f498f53f
null

event_typeenumオプション

event_detailsobjectオプション

イベントの詳細。イベントのタイプによって大きく異なりますが、応答例にいくつか例があります。

iddoubleオプション

一意の ID

inserted_atstringオプション形式: "date-time"

ip_addressstring or nullオプション

このイベントに関連付けられた IP アドレス

project_idstring or nullオプション形式: "uuid"

このアクションが発生したプロジェクト ID

resource_idstringオプション形式: "uuid"

参照リソースの ID

resource_typeenumオプション

参照リソースのタイプ

team_idstring or nullオプション形式: "uuid"

チーム ID

sourceenumオプション

指定された監査ログエントリを生成したアクションのソース

user_idstring or nullオプション形式: "uuid"

ユーザー ID

updated_atstringオプション形式: "date-time"

エラー

401

Unauthorized Error

404

Not Found Error