Áú»¢¶Ä²©

graphprototype.get

¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®

integer/array graphprototype.get(object parameters)

El m¨¨tode permet recuperar prototipus de gr¨¤fics segons els par¨¤metres prove?ts.

Aquest m¨¨tode ¨¦s disponible per a usuaris de qualsevol mena. Els permisos per cridar al m¨¨tode es poden revocar a les configuracions de rols d'usuari. Per a m¨¦s informaci¨®, veieu Rols d'usuari.

±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð²õ

(object) ±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð²õ que defineixen la sortida esperada.

El m¨¨tode admet els par¨¤metres seg¨¹ents.

±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð Tipus ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®
discoveryids ID/array Retorna nom¨¦s prototips de gr¨¤fics que pertanyen a les regles de descobriment donades.
graphids ID/array Retorna nom¨¦s prototips de gr¨¤fics amb identificadors donats.
groupids ID/array Retorna nom¨¦s prototips de gr¨¤fics que pertanyen als equips dels grups d'equips donats.
hostids ID/array Retorna nom¨¦s prototips de gr¨¤fics que pertanyen als equips donats.
inherited boolean Si es defineix com a true, nom¨¦s retorna els prototips de gr¨¤fics heretats d'un model.
itemids string/array Retorna nom¨¦s prototips de gr¨¤fics que contenen els prototips d'elements donats.
templated boolean Si s'estableix en true, nom¨¦s retorna prototips de gr¨¤fics que pertanyen a plantilles.
templateids ID/array Retorna nom¨¦s prototips de gr¨¤fics que pertanyen a les plantilles donades.
selectDiscoveryRule query Retorna una propietat discoveryRule amb la regla LLD a la qual pertany el prototip de gr¨¤fic.
selectGraphItems query Retorna una propietat gitems amb els elements de gr¨¤fic emprats al prototip de gr¨¤fic.
selectGroups query Retorna una propietat groups amb els grups d'equips als quals pertany el prototip de gr¨¤fic.
selectHosts query Retorna una propietat hosts amb els equips als quals pertany el prototip de gr¨¤fic.
selectItems query Retorna una propietat items amb els elements i prototipus d'elements emprats al gr¨¤fic del prototip .
selectTemplateGroups query Retorna una propietat templategroups amb els grups de plantilles a les quals pertany el prototip de gr¨¤fic.
selectTemplates query Retorna una propietat plantilles amb les plantilles a les quals pertany el prototip de gr¨¤fic.
filter object Retorna nom¨¦s resultats que coincideixen exactament amb el filtre donat.

Accepta una matriu, on les claus s¨®n noms de propietat i els valors s¨®n un valor ¨²nic o una matriu de valors per comparar.

Admet filtres addicionals:
host - nom t¨¨cnic de l'equip al qual pertany el prototip de gr¨¤fic;
hostid - ID de l'equip al qual pertany el prototip de gr¨¤fic.
sortfield string/array Ordena el resultat segons les propietats donades.

Els valors possibles s¨®n: graphid, name, graphtype i discovered.
countOutput boolean Aquests par¨¤metres es descriuen en detall a comentaris de refer¨¨ncia.
editable boolean
excludeSearch boolean
limit entier
output °ù±ð±ç³Ü¨º³Ù±ð
preservekeys boolean
search objet
searchByAny boolean
searchWildcardsEnabled boolean
sortorder string/array
startSearch boolean
selectGroups
(obsolet)
query Aquest par¨¤metre ¨¦s obsolet; empreu en el seu lloc selectHostGroups o selectTemplateGroups.
Retorna la propietat grups amb els grups d'equips i grups de plantilles on el gr¨¤fic pertany.

Valors de retorn

(integer/array) Retorna un d'entre:

  • una taula d'objectes;
  • el recompte d'objectes recuperats, si s'empra el par¨¤metre countOutput.

Exemples

Recuperar prototips de gr¨¤fics d'una regla LLD

Recuperar tots els prototips de gr¨¤fics d'una regla de descoberta.

±Ê±ð³Ù¾±³¦¾±¨®:

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

Resposta:

{
       "jsonrpc": "2.0",
       "result": [
       {
       "graphid": "1017",
       "parent_itemid": "27426",
       "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",
       "discover": "0"
       }
       ],
       "id": 1
       }

Veieu tamb¨¦

Font

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