Cómo trabajar con registros de auditoría

Información general

Frame.io admite y mantiene registros de auditoría para la gran mayoría de las actividades que se realizan en sus aplicaciones. Esto incluye tanto operaciones CRUD básicas en activos principales como algunas abstracciones especiales (por ejemplo, AssetVersioned).

Ámbito y permisos

Solo los administradores de cuenta pueden acceder a los registros de auditoría de una cuenta, y todas las llamadas al punto final de registros de auditoría deben tener el ámbito de un account_id de la siguiente manera:

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

Respuestas

Todas las respuestas de registro de auditoría tienen un formato similar:

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
}

Filtros

Los registros de auditoría admiten una amplia variedad de filtros, incluidos los intervalos de fecha. A diferencia de los puntos finales de búsqueda de Frame.io, los filtros solo se pueden enviar como parámetros de cadena de consulta GET.

Todos los filtros siguen el mismo formato:

GET + cadena de consulta

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

Tipos de filtro principales

Los tipos de filtro principales para seleccionar y navegar por los registros de auditoría son los siguientes:

Tipos de elementos y acciones

Ejemplos de filtros

Todos los filtros siguen un formato similar, como se indica arriba. A continuación, se incluyen algunos ejemplos para casos de uso específicos que pueden ayudarle a empezar.

Intervalo de fechas

Los intervalos de fecha son un caso ligeramente especial, ya que es necesario especificar el datetime inserted_at, el value y la operación que se aplicará a ese datetime. Por lo tanto, las consultas de intervalo de fecha siempre tendrán dos elementos de filtro, cada uno de los cuales se anidará junto a un parámetro [inserted_at].

Entre las operaciones compatibles se incluyen las siguientes:

• gt: mayor que
• gte: mayor o igual que
• lt: menor que
• lte: menor o igual que

Ejemplos de intervalos de fecha