device.offboard

Questo metodo consente di rimuovere (disassociare) i dispositivi mobili da utilizzare con l'app mobile Zabbix.

Il metodo è disponibile per gli utenti User, Admin e Super admin se EnableMobileDevices è abilitato e l'utente dispone dell'accesso ai dispositivi.
L'accesso ai metodi API può essere revocato nella configurazione del ruolo utente.

Gli utenti User e Admin possono rimuovere solo i propri dispositivi.

Firma del metodo: object device.offboard(object parameters)

Origine del metodo: CDevice::offboard() in ui/include/classes/api/services/CDevice.php

Parametri

Parametro Tipo Descrizione
uuid string Identificatore univoco universale del dispositivo (UUIDv7). Corrisponde a deviceid.
force boolean Impostare su true per ignorare l'errore "Device not found" e rimuovere forzatamente il dispositivo.

Predefinito: false

Valori restituiti

Restituisce un oggetto contenente l'UUID del dispositivo rimosso.

Esempi

Rimuovi dispositivo

Rimuove un dispositivo con l'UUID specificato, ignorando l'errore "Dispositivo non trovato".

Richiesta:

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

Risposta:

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