Búsqueda de datos de auditoría (consultas)
Para buscar mensajes de auditoría, utilice el servicio QueryAuditHistory. El servicio toma los siguientes parámetros opcionales:
|
Parámetro
|
Descripción
|
Valor por defecto
|
||
|---|---|---|---|---|
|
maxItems
|
El número máximo de resultados que se devolverán de la consulta. (INTEGER)
|
500 elementos
|
||
|
locale
|
El idioma en que se deben devolver los resultados. (STRING)
|
La configuración regional del usuario conectado que envía la consulta.
|
||
|
startDate
|
Fecha y hora. La consulta buscará mensajes de auditoría a partir de la fecha y hora que el usuario especifique aquí. (DATETIME)
|
No especificado
|
||
|
endDate
|
Fecha y hora. La consulta dejará de buscar mensajes de auditoría cuando la fecha/hora de los mensajes alcance la fecha y hora que el usuario especifique aquí. (DATETIME)
|
No especificado
|
||
|
query
|
Una cadena de consulta (en formato JSON).
|
N/D
|
||
|
auditCategory
|
La categoría de mensajes de auditoría que el usuario desea buscar. Consulte la tabla de categorías de auditoría en
Categorías de auditoría.
|
No especificado
|
El formato de este servicio es el siguiente:
QueryAuditHistory(maxItems [INTEGER], startDate [DATETIME], endDate [DATETIME],
auditCategory [STRING],query[QUERY], locale[STRING])
Por defecto, una consulta devuelve 500 filas. Para cambiar el número de filas que devuelve la consulta, defina el parámetro maxItems en el número de filas deseado. Hay un límite máximo en el número de filas que se pueden especificar para el parámetro maxItems. Un administrador del sistema define este límite al configurar el subsistema de auditoría. Para cambiar el límite máximo de maxItems, un administrador del sistema debe actualizar la opción de configuración Highest value that can be set for maxItems parameter for QueryAuditHistory en la
configuración del subsistema de auditoría. Este servicio toma un solo parámetro, MaxItemsQueryUpperLimit, que contiene un tipo base de ThingWorx de NUMBER. Este valor debe ser mayor o igual que 500 filas.