template.get

Descripció

integer/array template.get(object parameters)

El mètode permet recuperar plantilles 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.

Paràmetres

(object) Paràmetres que defineixen la sortida esperada.

El mètode admet els paràmetres següents.

Paràmetre Tipus Descripció
templateids string/array Retorna només plantilles amb els ID de plantilla donats.
groupids string/array Retorna només els patrons que pertanyen als grups d'equips donats.
parentTemplateids string/array Retorna només les plantilles que són pares de les plantilles donades.
hostids string/array Retorna només patrons relacionats amb els hosts/patrons donats.
graphids string/array Retorna només els models que contenen els gràfics donats.
itemids string/array Retorna només els models que contenen els elements donats.
triggerids string/array Retorna només els patrons que contenen els triggers donats.
with_items flag Retorna només models amb articles.
with_triggers flag Retorna només els models que tenen triggers.
with_graphs flag Retorna només models que contenen gràfics.
with_httptests marca Retorna només models que tenen escenaris web.
evaltype integer Regles de cerca d'etiquetes.

Valors possibles:
0 - (per defecte) I/O;
2 - O.
tags array/objecte Retorna només models amb etiquetes donades. Concordança exacta per etiqueta i cerca entre majúscules i minúscules o no per valor de l'etiqueta en funció del valor de l'operador.
Format:[{"tag": "<etiqueta>", "valor": "< valor>", " operator": "<operador>"}, ...].
Una matriu buida retorna tots els models.

Possibles valors d'operador:
0 - (per defecte) Conté;
1 - És igual;
2 - No és com;
3 - No és igual< br>4 - Existeix;
5 - No existeix.
selectGroups query Retorna els grups d'equips als quals pertany la plantilla a la propietat grups.
selectTags query Retorna les etiquetes de plantilla a la propietat etiquetes.
selectHosts query Retorna els equips vinculats al model a la propietat equips.

Admet count.
selectTemplates query Retorna les plantilles de les quals la plantilla és secundària, a la propietat templates.

Admet count.
selectParentTemplates query Retorna les plantilles de les quals la plantilla n'és pare, a la propietat parentTemplates.

Admet count.
selectHttpTests query Retorna els escenaris web del model a la propietat httpTests.

Admet count.
selectItems query Retorna els elements del model a la propietat elements.

Admet count.
selectDiscoveries query Retorna els descobriments de baix nivell del model a la propietat discoveries.

Admet count.
selectTriggers query Retorna triggers del model a la propietat triggers.

Admet count.
selectGraphs query Retorna gràfics del model a la propietat gràfics.

Admet count.
selectMacros query Retorna macros del model a la propietat macros.
selectDashboards query Retorna els taulers de control de la plantilla a la propietat taulers de control.

Admet count.
selectValueMaps query Retorna una propietat valuemaps amb taules d'assignació de valors del model.
limitSelects integer Limita el nombre de registres retornats per subseleccions.

S'aplica a les subseleccions següents:
selectTemplates - els resultats s'ordenaran per name;< br>selectHosts - ordenats per host;
selectParentTemplates - ordenat per host;
selectItems - ordenat per name;
selectDiscoveries - ordenat per name;
selectTriggers - ordenat per description;
selectGraphs - ordenat per name;
selectDashboards - ordenat per name.
sortfield string/array Ordena el resultat segons les propietats donades.

Els valors possibles són: hostid, host, name, status.
countOutput boolean Aquests paràmetres en detall a la pàgina comentaris de referència.
editable boolean
excludeSearch boolean
filter object
limit integer
output query
preservekeys boolean
search object
searchByAny boolean
searchWildcardsEnabled boolean
sortorder string/array
startSearch boolean

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 les plantilles per nom

Recuperar totes les dades de dues plantilles anomenades "Linux" i "Windows".

Petició:

{
    "jsonrpc": "2.0",
    "method": "template.get",
    "params": {
        "output": "extend",
        "filter": {
            "host": [
                "Linux",
                "Windows"
            ]
        }
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}

Resposta:

{
    "jsonrpc": "2.0",
    "result": [
        {
            "proxy_hostid": "0",
            "host": "Linux",
            "status": "3",
            "disable_until": "0",
            "error": "",
            "available": "0",
            "errors_from": "0",
            "lastaccess": "0",
            "ipmi_authtype": "0",
            "ipmi_privilege": "2",
            "ipmi_username": "",
            "ipmi_password": "",
            "ipmi_disable_until": "0",
            "ipmi_available": "0",
            "snmp_disable_until": "0",
            "snmp_available": "0",
            "maintenanceid": "0",
            "maintenance_status": "0",
            "maintenance_type": "0",
            "maintenance_from": "0",
            "ipmi_errors_from": "0",
            "snmp_errors_from": "0",
            "ipmi_error": "",
            "snmp_error": "",
            "jmx_disable_until": "0",
            "jmx_available": "0",
            "jmx_errors_from": "0",
            "jmx_error": "",
            "name": "Linux",
            "flags": "0",
            "templateid": "10001",
            "description": "",
            "tls_connect": "1",
            "tls_accept": "1",
            "tls_issuer": "",
            "tls_subject": "",
            "tls_psk_identity": "",
            "tls_psk": "",
            "uuid": "282ffe33afc74cccaf1524d9aa9dc502"
        },
        {
            "proxy_hostid": "0",
            "host": "Windows",
            "status": "3",
            "disable_until": "0",
            "error": "",
            "available": "0",
            "errors_from": "0",
            "lastaccess": "0",
            "ipmi_authtype": "0",
            "ipmi_privilege": "2",
            "ipmi_username": "",
            "ipmi_password": "",
            "ipmi_disable_until": "0",
            "ipmi_available": "0",
            "snmp_disable_until": "0",
            "snmp_available": "0",
            "maintenanceid": "0",
            "maintenance_status": "0",
            "maintenance_type": "0",
            "maintenance_from": "0",
            "ipmi_errors_from": "0",
            "snmp_errors_from": "0",
            "ipmi_error": "",
            "snmp_error": "",
            "jmx_disable_until": "0",
            "jmx_available": "0",
            "jmx_errors_from": "0",
            "jmx_error": "",
            "name": "Windows",
            "flags": "0",
            "templateid": "10081",
            "description": "",
            "tls_connect": "1",
            "tls_accept": "1",
            "tls_issuer": "",
            "tls_subject": "",
            "tls_psk_identity": "",
            "tls_psk": "",
            "uuid": "522d17e1834049be879287b7c0518e5d"
        }
    ],
    "id": 1
}

Recuperar equips per plantilla

Recupera els equips que tenen la plantilla "10001" (Linux amb agent Zabbix) enllaçada.

Petició:

{
"jsonrpc": "2.0",
"method": "template.get",
"params": {
"output": "templateid",
"templateids": "10001",
"selectHosts": ["hostid", "name"]
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}

Resposta:

{
"jsonrpc": "2.0",
"result": [
{
"templateid": "10001",
"hosts": [
{
"hostid": "10084",
"name": "Zabbix server"
},
{
"hostid": "10603",
"name": "Host 1"
},
{
"hostid": "10604",
"name": "Host 2"
}
]
}
],
"id": 1
}

Cercar per etiquetes de plantilla

Cercar les plantilles on l'etiqueta "Nom d'equip" sigui igual a "{EQUIP.NOM}".

Petició:

{
    "jsonrpc": "2.0",
    "method": "template.get",
    "params": {
        "output": ["hostid"],
        "selectTags": "extend",
        "evaltype": 0,
        "tags": [
            {
                "tag": "Nom d'equip",
                "value": "{EQUIP.NOM}",
                "operator": 1
            }
        ]
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}

Response:

{
    "jsonrpc": "2.0",
    "result": [
        {
            "hostid": "10402",
            "tags": [
                {
                    "tag": "Host name",
                    "value": "{HOST.NAME}"
                }
            ]
        }
    ],
    "id": 1
}

Veieu també

Font

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