Utilisation des journaux d'audit

Présentation

Frame.io prend en charge et maintient des journaux d’audit pour la grande majorité des activités dans ses applications.Cela inclut les opérations CRUD de base sur les ressources principales et certaines abstractions spéciales (par exemple AssetVersioned).

Portée et autorisations

Seuls les administrateurs de compte peuvent accéder aux journaux d’audit d’un compte, et tous les appels au point d’entrée des journaux d’audit doivent être étendus à un account_id comme suit :

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

Réponses

Toutes les réponses des journaux d’audit ont un format similaire :

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
}

Filtres

Les journaux d’audit prennent en charge différents filtres, y compris les périodes.Contrairement aux points d’entrée de recherche de Frame.io, les filtres peuvent être envoyés uniquement comme paramètres de chaîne de requête GET.

Tous les filtres suivent le même formatage :

GET + chaîne de requête

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

Types de filtres clés

Les types de filtres clés pour filtrer et naviguer dans les journaux d’audit sont :” ] } ```

Types d’éléments et actions

Exemples de filtres

Tous les filtres suivent un format similaire, comme décrit ci-dessous.Voici quelques exemples ciblant des cas d’usage spécifiques qui peuvent vous aider à commencer.

Périodes

Les périodes constituent un cas légèrement particulier, dans la mesure où il est nécessaire de spécifier à la fois la inserted_at datetime Valeur, et l’opération à appliquer à cette datetime. Par conséquent, les requêtes de période comporteront toujours deux éléments de filtre, dont chacun sera lui-même imbriqué à côté d’un paramètre [inserted_at].

Les opérations prises en charge incluent :

• gt : supérieur à
• gte : supérieur ou égal à
• lt : inférieur à
• lte : inférieur ou égal à

Exemples de périodes