Obtener entradas de log

Idioma:

Se pueden devolver entradas de log del dispositivo especificado. Cada entrada de log devuelve la fecha/hora de la entrada junto con propiedades de contenido específicas.

Notas - Según el número de logs, es posible que las entradas más antiguas del log no estén disponibles a causa de las restricciones de la memoria. Este mismo límite ocurre en la BUI y la CLI. Para obtener todos los logs del sistema, use la función collect que se describe en Comandos de gestión de logs.

Parámetro	Descripción
`start=index`	Comenzar a devolver logs del índice/tiempo dado.
`limit=number`	Limitar el número de entradas de log devueltas.

El índice de inicio establece como por defecto el valor de 0, que devuelve el primer log que se generó. No se permiten valores negativos y valores superiores o iguales al tamaño del log. El índice de inicio también puede ser una cadena de fecha/hora, por ejemplo, 20130724T03:21:55.

Notas - REST solo acepta la hora UTC. No se aceptan valores de fecha/hora que tengan más de un mes desde la fecha actual. La recuperación de los logs anteriores debe utilizar un número de índice para el valor de inicio. El valor de límite limita el número de logs devueltos para una solicitud dada. No se devuelve más que el valor de límite determinado.

Ejemplo de solicitud:

GET /api/log/v1/logs/audit?limit=4&start=1000 HTTP/1.1
Authorization: Basic Tm8gcGVla2luZyE=
Host: zfs-storage.example.com:215
Accept: application/json

Resultado de ejemplo:

HTTP/1.1 200 OK
X-Zfssa-Appliance-Api: 1.0
Content-Type: application/json
X-Zfssa-Api: development
Transfer-Encoding: chunked

{
    "logs": [
        {
            "address": "192.0.2.0",
            "annotation": "",
            "summary": "User logged in",
            "timestamp": "20131022T22:54:19",
            "user": "root"
        }, {
            "address": "192.0.2.0",
            "annotation": "",
            "summary": "Destroyed share \"zfs-storage-1:tst.volumes.py.34111.project/tst.volumes.py.34111.lun.7\"",
            "timestamp": "20131022T22:52:34",
            "user": "root"
        }, {
            "summary": "Joined workgroup \"RESTTESTWG\"",
            "timestamp": "20131022T22:54:23",
            "user": "<system>"
        }, {
            "address": "192.0.2.0",
            "annotation": "",
            "summary": "User logged in",
            "timestamp": "20131022T22:54:19",
            "user": "root"
        }
    ]
}