graphitem.get

Descrizione

integer/array graphitem.get(object parameters)

Il metodo consente di recuperare gli elementi dei grafici in base ai parametri specificati.

Questo metodo è disponibile per gli utenti di qualsiasi tipo. Le autorizzazioni per chiamare il metodo possono essere revocate nelle impostazioni del ruolo utente. Per ulteriori informazioni, vedere Ruoli utente.

Parametri

(object) Parametri che definiscono l'output desiderato.

Il metodo supporta i seguenti parametri.

Parametro Tipo Descrizione
graphids ID/array Restituisce solo i graph item che appartengono ai grafici specificati.
itemids ID/array Restituisce solo i graph item con gli ID item specificati.
type integer Restituisce solo i graph item del tipo specificato.

Per un elenco dei tipi di graph item supportati, fare riferimento alla pagina dell'oggetto graph item.
selectGraphs query Restituisce una proprietà graphs con un array di grafici a cui l'item appartiene.
sortfield string/array Ordina il risultato in base alle proprietà specificate.

Valori possibili: gitemid.
countOutput boolean Questi parametri sono descritti nel commento di riferimento.
editable boolean
limit integer
output query
preservekeys boolean
sortorder string/array

Valori restituiti

(integer/array) Restituisce o:

  • una matrice di oggetti;
  • il conteggio degli oggetti recuperati, se il parametro countOutput è stato usato.

Esempi

Recupero degli item del grafico da un grafico

Recupera tutti gli item del grafico utilizzati in un grafico con informazioni aggiuntive sull'item e sull'host.

Richiesta:

{
    "jsonrpc": "2.0",
    "method": "graphitem.get",
    "params": {
        "output": "extend",
        "graphids": "387"
    },
    "id": 1
}

Risposta:

{
    "jsonrpc": "2.0",
    "result": [
        {
            "gitemid": "1242",
            "graphid": "387",
            "itemid": "22665",
            "drawtype": "1",
            "sortorder": "1",
            "color": "FF5555",
            "yaxisside": "0",
            "calc_fnc": "2",
            "type": "0"
        },
        {
            "gitemid": "1243",
            "graphid": "387",
            "itemid": "22668",
            "drawtype": "1",
            "sortorder": "2",
            "color": "55FF55",
            "yaxisside": "0",
            "calc_fnc": "2",
            "type": "0"
        },
        {
            "gitemid": "1244",
            "graphid": "387",
            "itemid": "22671",
            "drawtype": "1",
            "sortorder": "3",
            "color": "009999",
            "yaxisside": "0",
            "calc_fnc": "2",
            "type": "0"
        }
    ],
    "id": 1
}

Guarda anche

Fonte

CGraphItem::get() in ui/include/classes/api/services/CGraphItem.php.