device.offboard

Este método permite eliminar dispositivos móviles para dejar de utilizarlos con la aplicación móvil de Zabbix.

El método está disponible para usuarios User, Admin y Super admin si EnableMobileDevices está habilitado y el usuario tiene acceso a los dispositivos. El acceso a los métodos de la API se puede revocar en la configuración del rol de usuario.

Los usuarios User y Admin solo pueden eliminar sus propios dispositivos.

Firma del método: object device.offboard(object parameters)

Origen del método: CDevice::offboard() en ui/include/classes/api/services/CDevice.php

Parámetros

Parameter Type Description
uuid string Identificador único universal del dispositivo (UUIDv7). Coincide con deviceid.
force boolean Establezca true para ignorar el error "Device not found" y eliminar el dispositivo de forma forzada.

Valor predeterminado: false

Valores devueltos

Devuelve un objeto que contiene el UUID del dispositivo eliminado.

Ejemplos

Eliminar dispositivo

Elimina un dispositivo con el UUID indicado, ignorando el error "Dispositivo no encontrado".

Solicitud:

{
    "jsonrpc": "2.0",
    "method": "device.offboard",
    "params": {
        "uuid": "019d0106-5eef-7154-a159-bb29e35d38e5",
        "force": true
    },
    "id": 1
}

Respuesta:

{
    "jsonrpc": "2.0",
    "result": {
        "uuid": "019d0106-5eef-7154-a159-bb29e35d38e5"
    },
    "id": 1
}