graphprototype.get

Descrizione

integer/array graphprototype.get(object parameters)

Questo metodo consente di recuperare i prototipi di grafico in base ai parametri specificati.

Questo metodo è disponibile per utenti di qualsiasi tipo. Le autorizzazioni per chiamare il metodo possono essere revocate nelle impostazioni del ruolo utente. Vedere User roles per ulteriori informazioni.

Parametri

(object) Parametri che definiscono l'output desiderato.

Il metodo supporta i seguenti parametri.

Parametro Type Descrizione
discoveryids ID/array Restituisce solo i prototipi di grafico che appartengono alle regole di discovery specificate.
graphids ID/array Restituisce solo i prototipi di grafico con gli ID specificati.
groupids ID/array Restituisce solo i prototipi di grafico che appartengono a host o template nei gruppi di host o gruppi di template specificati.
hostids ID/array Restituisce solo i prototipi di grafico che appartengono agli host specificati.
inherited boolean Se impostato su true, restituisce solo i prototipi di grafico ereditati da un template.
itemids ID/array Restituisce solo i prototipi di grafico che contengono i prototipi di item specificati.
templated boolean Se impostato su true, restituisce solo i prototipi di grafico che appartengono ai template.
templateids ID/array Restituisce solo i prototipi di grafico che appartengono ai template specificati.
selectDiscoveryData query Restituisce una proprietà discoveryData con i dati dell'oggetto di discovery del prototipo di grafico. L'oggetto di discovery del prototipo di grafico collega un prototipo di grafico rilevato a un prototipo di grafico da cui è stato rilevato.

Ha le seguenti proprietà:
parent_graphid - (ID) ID del prototipo di grafico da cui è stato creato il grafico;
status - (int) stato della discovery del grafico:
0 - (predefinito) il prototipo di grafico è rilevato,
1 - il prototipo di grafico non è più rilevato;
ts_delete - (timestamp) momento in cui un prototipo di grafico non più rilevato verrà eliminato.
selectDiscoveryRule query Restituisce una proprietà discoveryRule con la regola LLD a cui appartiene il prototipo di grafico.
selectDiscoveryRulePrototype query Restituisce una proprietà discoveryRulePrototype con il prototipo della regola LLD padre a cui appartiene il prototipo di grafico.
selectGraphItems query Restituisce una proprietà gitems con gli elementi del grafico utilizzati nel prototipo di grafico.
selectHostGroups query Restituisce una proprietà hostgroups con i gruppi di host a cui appartiene il prototipo di grafico.
selectHosts query Restituisce una proprietà hosts con gli host a cui appartiene il prototipo di grafico.
selectItems query Restituisce una proprietà items con gli item e i prototipi di item utilizzati nel prototipo di grafico.
selectTemplateGroups query Restituisce una proprietà templategroups con i gruppi di template a cui appartiene il prototipo di grafico.
selectTemplates query Restituisce una proprietà templates con i template a cui appartiene il prototipo di grafico.
filter object Restituisce solo i risultati che corrispondono esattamente al filtro specificato.

Accetta un oggetto in cui le chiavi sono nomi di proprietà e i valori sono un singolo valore oppure un array di valori da confrontare.

Non supporta proprietà del tipo di dati text data type.

Supporta proprietà aggiuntive:
host - nome tecnico dell'host a cui appartiene il prototipo di grafico;
hostid - ID dell'host a cui appartiene il prototipo di grafico.
sortfield string/array Ordina il risultato in base alle proprietà specificate.

Valori possibili: graphid, name, graphtype, discovered.
countOutput boolean Questi parametri sono descritti nel commento di riferimento.
editable boolean
excludeSearch boolean
limit integer
output query
preservekeys boolean
search object
searchByAny boolean
searchWildcardsEnabled boolean
sortorder string/array
startSearch boolean

Valori restituiti

(integer/array) Restituisce:

  • un array di oggetti;
  • il numero di oggetti recuperati, se è stato utilizzato il parametro countOutput.

Esempi

Recupero dei prototipi di grafico da una regola LLD

Recupera tutti i prototipi di grafico da una regola LLD.

Richiesta:

{
    "jsonrpc": "2.0",
    "method": "graphprototype.get",
    "params": {
        "output": "extend",
        "discoveryids": "27426"
    },
    "id": 1
}

Risposta:

{
    "jsonrpc": "2.0",
    "result": [
        {
            "graphid": "1017",
            "name": "Disk space usage {#FSNAME}",
            "width": "600",
            "height": "340",
            "yaxismin": "0.0000",
            "yaxismax": "0.0000",
            "templateid": "442",
            "show_work_period": "0",
            "show_triggers": "0",
            "graphtype": "2",
            "show_legend": "1",
            "show_3d": "1",
            "percent_left": "0.0000",
            "percent_right": "0.0000",
            "ymin_type": "0",
            "ymax_type": "0",
            "ymin_itemid": "0",
            "ymax_itemid": "0",
            "flags": "2"
            "discover": "0"
        }
    ],
    "id": 1
}

Vedi anche

Fonte

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