[comment]: # translation:outdated

[comment]: # ({668456d1-668456d1})
# auditlog.get

[comment]: # ({/668456d1-668456d1})

[comment]: # ({9ff01301-002826bb})
### Description

`integer/array auditlog.get(paramètres d'objet)`

Cette méthode permet de récupérer les enregistrement du journal d'audit en fonction des paramètres donnés.

::: noteclassic
Cette méthode est seulement disponible pour les utilisateurs du type *Super admin*. Les autorisations d'appeler la méthode peuvent être révoquées dans les paramètres de rôle d'utilisateur. Voir [Rôles utilisateur](/manual/web_interface/frontend_sections/users/user_roles) pour plus d'informations.
:::

[comment]: # ({/9ff01301-002826bb})

[comment]: # ({9f768a42-c9891e0d})
### Paramètres

`(objet)` Paramètres définissant la sortie souhaitée.

La méthode prend en charge les paramètres suivants :

|Paramètre|[Type](/manual/api/reference_commentary#data_types)|Description|
|---------|----------------------------------------------------------------|-----------|
|auditids|string/array|Renvoyer uniquement le journal d'audit avec les ID donnés.|
|userids|string/array|Renvoyer uniquement les journaux d'audit qui ont été créés par les utilisateurs donnés.|
|time\_from|timestamp|Renvoie uniquement les entrées du journal d'audit qui ont été créées après ou à l'heure donnée.|
|time\_till|timestamp|Renvoie uniquement les entrées du journal d'audit qui ont été créées avant ou à l'heure donnée.|
|sortfield|string/array|Trier le résultat selon les propriétés données.<br><br>Les valeurs possibles sont : `auditid`, `userid`, `clock`.|
|filter|object|Renvoyer uniquement les résultats qui correspondent exactement au filtre donné.<br><br>Accepte un tableau, où les clés sont des noms de propriété et les valeurs sont soit une valeur unique, soit un tableau de valeurs à comparer.< br><br>Prend également en charge le filtrage par champs de propriété de détails : `table_name`, `field_name`.|
|search|object|Recherche de sous-chaîne insensible à la casse dans le contenu des champs : `username`, `ip`, `resourcename`, `details`.|
|countOutput|boolean|Ces paramètres étant communs à toutes les méthodes `get`, ils sont décrits dans le [commentaire de référence](/manual/api/reference_commentary#common_get_method_parameters).|
|excludeSearch|boolean|^|
|limite|integer|^|
|sortie|query|^|
|preservekeys|boolean|^|
|searchByAny|boolean|^|
|searchWildcardsEnabled|boolean|^|
|ordredetri|string/array|^|
|startSearch|boolean|^|

[comment]: # ({/9f768a42-c9891e0d})

[comment]: # ({7223bab1-7223bab1})
### Valeurs retournées

`(integer/array)` Retourne soit : 

-   un tableau d'objets ;
-   le nombre d'objets récupérés, si le paramètre `countOutput` a été utilisé.

[comment]: # ({/7223bab1-7223bab1})

[comment]: # ({b41637d2-b41637d2})
### Exemples

[comment]: # ({/b41637d2-b41637d2})

[comment]: # ({a481af40-66670b26})
#### Récupérer le journal d'audit

Récupérer les deux derniers enregistrements du journal d'audit.

Requête :

``` {.java}
{
    "jsonrpc": "2.0",
    "method": "auditlog.get",
    "params": {
        "output": "extend",
        "sortfield": "clock",
        "sortorder": "DESC",
        "limit": 2
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}
```

Réponse :

``` {.java}
{
    "jsonrpc": "2.0",
    "result": [
        {
            "auditid": "cksstgfam0001yhdcc41y20q2",
            "userid": "1",
            "username": "Admin",
            "clock": "1629975715",
            "ip": "127.0.0.1",
            "action": "1",
            "resourcetype": "0",
            "resourceid": "0",
            "resourcename": "Jim",
            "recordsetid": "cksstgfal0000yhdcso67ondl",
            "details": "{\"user.name\":[\"update\",\"Jim\",\"\"],\"user.medias[37]\":[\"add\"],\"user.medias[37].\":[\"add\"],\"user.medias[37].mediatypeid\":[\"add\",\"1\"],\"user.medias[37].sendto\":[\"add\",\"support123@company.com\"]}"
            
        },
        {
            "auditid": "ckssofl0p0001yhdcqxclsg8r",
            "userid": "1",
            "username": "Admin",
            "clock": "1629967278",
            "ip": "127.0.0.1",
            "action": "0",
            "resourcetype": "0",
            "resourceid": "20",
            "resourcename": "John",
            "recordsetid": "ckssofl0p0000yhdcpxyo1jgo",
            "details": "{\"user.username\":[\"add\",\"John\"], \"user.userid:\":[\"add\",\"20\"],\"user.usrgrps[28]\":[\"add\"],\"user.usrgrps[28].usrgrpid\":[\"add\", \"7\"]}"
        }
    ],
    "id": 1
}
```

[comment]: # ({/a481af40-66670b26})

[comment]: # ({e2b9a859-e2b9a859})
### Voir également

- [Objet Audit log](/manual/api/reference/auditlog/object)

[comment]: # ({/e2b9a859-e2b9a859})

[comment]: # ({11b31975-11b31975})
### Source

CAuditLog::get() dans *ui/include/classes/api/services/CAuditLog.php*.

[comment]: # ({/11b31975-11b31975})