Áú»¢¶Ä²©

This is a translation of the original English documentation page. Help us make it better.

itemprototype.get

?????

integer/array itemprototype.get(object parameters)

????? ?????? ????? ???? ????? ?? ???? ????? ????? ???????.

???? ?? ????? ???????? ??? ???. ?????? ??? ????? ?? ????? ???? ???? ??????? ????? ??????. ??? ????? ??????? ????? ????.

???????

(object) ??????? ???????? ?? ???? ?????.

????? ????? ???????? ?????.

????? ??? ?????
discoveryids string/array ???? ?? ???? ????? ?? ?????? ??????? ????? ?-LLD ???????.
graphids string/array ???? ?? ????-????? ?? ?????? ??????? ?????-????? ?? ?????.
hostids string/array ???? ?? ???? ????? ?? ?????? ??????? ??????? ???????.
herited boolean ?? ????? ?-'true' ???? ?? ????-????? ?? ?????? ????? ?????? ??????.
itemids string/array ???? ?? ???? ????? ?? ?????? ?? ?????? ???????.
monitored boolean ?? ????? ?-'true', ???? ?? ????-????? ?? ?????? ??????? ??????? ??????? ???????.
templated boolean ?? ????? ?-'true' ???? ?? ????-????? ?? ?????? ??????? ???????.
templateids string/array ???? ?? ???? ????? ?? ?????? ??????? ??????? ???????.
triggerids string/array ???? ?? ????-????? ?? ?????? ??????? ?????-????? ?? ?????.
selectDiscoveryRule query ???? ?????? discoveryRule ?? ??? ?????? ???? ????? ????? ???? ?? ?????? ?? ?????.
selectGraphs query ???? ?????? manual/api/reference/graphprototype/object#graph_prototype ?? ???? ????? ????? ???? ???? ????? ??? ?????? ?? ?????.< br>
???? ?'?????'.
selectHosts query ???? ?????? hosts ?? ???? ?????? ?????? ???? ?? ?????? ?? ?????.
selectTags query ???? ?? ??? ?? ?????? ?? ????? ??????? tags.
selectTriggers query ???? ?????? triggers ?? ???? ????? ?? ????? ???? ???? ????? ??? ?????? ?? ?????.

???? ?'count'.
selectPreprocessing query ???? ?????? preprocessing ?? ???????? ????? ????? ?? ????.

?? ?? ?? ????????? ?????:
type - (??????) ??? ?????? ?????? ??????:
1 - ????? ????? ?????;
2 - ????? ????;
3 - ????? ?????;
4 - ?????;
5 - ????? ????? ??????;< br>6 - ??????? ?? ??????;
7 - ????? ?? ??????;
8 - ????????? ???????;
9 - ????? ????;
10 - ????? ??????;
11 - XML XPath ;
12 - JSONPath;
13 - ?????;
14 - ????? ?????? ??????;
15 - ?? ???? ?????? ??????;
16 - ???? ?? ?? ????? ?-JSON;
17 - ???? ?? ?? ????? ?-XML;
18 - ???? ?? ?? ????? ??????? ????? ??????;
19 - ??? ??? ?????;
20 - ??? ??? ????? ?? ?????? ??;
21 - JavaScript;
22 - ????? Prometheus;
23 - Prometheus ?-JSON;
24 - CSV ?-JSON;
25 - ?????;
26 - ???? ?? ???? ???? ????;
27- XML ?-JSON.<br >
params - (??????) ??????? ?????? ??????? ?? ?????? ?????? ??????. ??????? ?????? ??????? ?? ??? LF (\n)character.
error_handler - (??????) ??? ?????? ????? ????? ?? ??? ???? ?????? ??????:
0 - ????? ?????? ?????? ?? ??? ??? Áú»¢¶Ä²©;<br >1 - Discard value;
2 - ???? ??? ????? ?????;
3 - ???? ????? ????? ?????? ?????.

error_handler_params - (string) ?????? ???? ???????.
selectValueMap query ???? ?????? valuemap ?? ??? ??? ?? ????? ?? ????.
filter object ???? ?? ?? ??????? ??????? ????? ?? ????? ?????.

???? ????, ???? ??????? ?? ???? ????????, ??????? ?? ??? ???? ?? ???? ?? ????? ??? ??????.

???? ??????? ??????:
???? - ?? ???? ?? ????? ????? ???? ?? ?????? ?? ?????.
limitSelects integer ????? ?? ???? ??????? ???????? ?? ??? ??-?????.

?? ?? ??-??????? ?????:
selectGraphs - ??????? ?????? ??? ??;
selectTriggers - ?????? ?????? ??? ?????.
sortfield string/array ???? ?? ?????? ??? ????????? ???????.

????? ??????? ??: itemid, name, key_, delay, type ?-status.
countOutput boolean ???????? ????, ???????? ??? ????? ?-'get', ??????? ?????? ?????? ?????????.
????? ????????
excludeSearch ??????
limit ???? ???
??? ??????
preservekeys ??????
????? ???????
searchByAny boolean
searchWildcardsEnabled ???????
sortorder ??????/????
startSearch boolean

???? ?????

(???? ???/????) ????? ???:

  • ???? ?? ?????;
  • ????? ?????????? ???????, ?? ?? ?????? countOutput ???? ?????.

???????

????? ????-????? ?? ?????? ???? LLD

???? ?? ?? ???? ?????? ?? ??????? ???? ???? ??? LLD ??????.

?????????:

{
            "jsonrpc": "2.0",
            "method": "itemprototype.get",
            "params": {
                "output": "??????",
                "discoveryids": "27426"
            },
            "auth": "038e1d7b1735c6a5436ee9eae095879e",
            "????": 1
       }

????????:

{
            "jsonrpc": "2.0",
            "?????": [
                {
                    "itemid": "23077",
                    "type": "0",
                    "snmp_oid": "",
                    "hostid": "10079",
                    "name": "?????? ??? ????? ?-en0",
                    "key_": "net.if.in[en0]",
                    "delay": "1m",
                    "history": "1w",
                    "trends": "365d",
                    "status": "0",
                    "value_type": "3",
                    "trapper_hosts": "",
                    "??????": "bps",
                    "logtimefmt": "",
                    "templateid": "0",
                    "valuemapid": "0",
                    "params": "",
                    "ipmi_sensor": "",
                    "authtype": "0",
                    "?? ?????": "",
                    "?????": "",
                    "???? ??????": "",
                    "???? ????": "",
                    "interfaceid": "0",
                    "?????": "",
                    "evaltype": "0",
                    "jmx_endpoint": "",
                    "master_itemid": "0",
                    "timeout": "3 ?????",
                    "url": "",
                    "query_fields": [],
                    "??????": "",
                    "status_codes": "200",
                    "follow_redirects": "1",
                    "post_type": "0",
                    "http_proxy": "",
                    "??????": [],
                    "retrieve_mode": "0",
                    "request_method": "0",
                    "output_format": "0",
                    "ssl_cert_file": "",
                    "ssl_key_file": "",
                    "ssl_key_password": "",
                    "verify_peer": "0",
                    "verify_host": "0",
                    "allow_traps": "0",
                    "discover": "0",
                    "uuid": "",
                    "???????": []
                },
                {
                    "itemid": "10010",
                    "type": "0",
                    "snmp_oid": "",
                    "hostid": "10001",
                    "name": "???? ???? (??? ?????? ??? ????)",
                    "key_": "system.cpu.load[percpu,avg1]",
                    "delay": "1m",
                    "history": "1w",
                    "trends": "365d",
                    "status": "0",
                    "value_type": "0",
                    "trapper_hosts": "",
                    "??????": "",
                    "logtimefmt": "",
                    "templateid": "0",
                    "valuemapid": "0",
                    "params": "",
                    "ipmi_sensor": "",
                    "authtype": "0",
                    "?? ?????": "",
                    "?????": "",
                    "???? ??????": "",
                    "???? ????": "",
                    "interfaceid": "0",
                    "description": "???? ????? ????? ????? ????? ?? ?????? ???? ???? ????? ?????.",
                    "evaltype": "0",
                    "jmx_endpoint": "",
                    "master_itemid": "0",
                    "timeout": "3 ?????",
                    "url": "",
                    "query_fields": [],
                    "??????": "",
                    "status_codes": "200",
                    "follow_redirects": "1",
                    "post_type": "0",
                    "http_proxy": "",
                    "??????": [],
                    "retrieve_mode": "0",
                    "request_method": "0",
                    "output_format": "0",
                    "ssl_cert_file": "",
                    "ssl_key_file": "",
                    "ssl_key_password": "",
                    "verify_peer": "0",
                    "verify_host": "0",
                    "allow_traps": "0",
                    "lastclock": "0",
                    "lastns": "0",
                    "lastvalue": "0",
                    "prevvalue": "0",
                    "discover": "0",
                    "uuid": "",
                    "???????": []
                }
            ],
            "????": 1
       }

????? ???? ????

??? ???? ???? ??? ???? ???? ?? ???? "25545".

?????????:

{
            "jsonrpc": "2.0",
            "method": "item.get",
            "params": {
                "output": "??????",
                "????": {
                    "type": "18",
                    "master_itemid": "25545"
                },
                "limit": "1"
            },
            "auth": "038e1d7b1735c6a5436ee9eae095879e",
            "????": 1
       }

????????:

{
            "jsonrpc": "2.0",
            "?????": [
                {
                    "itemid": "25547",
                    "type": "18",
                    "snmp_oid": "",
                    "hostid": "10116",
                    "name": "?????",
                    "key_": "apache.status.uptime.seconds",
                    "delay": "0",
                    "history": "90d",
                    "trends": "365d",
                    "status": "0",
                    "value_type": "3",
                    "trapper_hosts": "",
                    "??????": "",
                    "logtimefmt": "",
                    "templateid": "0",
                    "valuemapid": "0",
                    "params": "",
                    "ipmi_sensor": "",
                    "authtype": "0",
                    "?? ?????": "",
                    "?????": "",
                    "???? ??????": "",
                    "???? ????": "",
                    "interfaceid": "0",
                    "?????": "",
                    "evaltype": "0",
                    "master_itemid": "25545",
                    "jmx_endpoint": "",
                    "timeout": "3 ?????",
                    "url": "",
                    "query_fields": [],
                    "??????": "",
                    "status_codes": "200",
                    "follow_redirects": "1",
                    "post_type": "0",
                    "http_proxy": "",
                    "??????": [],
                    "retrieve_mode": "0",
                    "request_method": "0",
                    "output_format": "0",
                    "ssl_cert_file": "",
                    "ssl_key_file": "",
                    "ssl_key_password": "",
                    "verify_peer": "0",
                    "verify_host": "0",
                    "allow_traps": "0",
                    "discover": "0",
                    "uuid": "",
                    "???????": []
                }
            ],
            "????": 1
       }

??? ??-????? ?? ???? ???? HTTP

??? ?? ????? ?? ???? ???? HTTP ?? ???? ????? HEAD ???? ???? ???? ??????.

?????????:

{
            "jsonrpc": "2.0",
            "method": "itemprototype.get",
            "params": {
                "hostids": "10254",
                "????": {
                    "type": "19",
                    "request_method": "3"
                }
            },
            "????": 17,
            "auth": "d678e0b85688ce578ff061bd29a20d3b"
       }

????????:

{
            "jsonrpc": "2.0",
            "?????": [
                {
                    "itemid": "28257",
                    "type": "19",
                    "snmp_oid": "",
                    "hostid": "10254",
                    "name": "?????",
                    "key_": "????[{#INAME}]",
                    "delay": "{#IUPDATE}",
                    "history": "90d",
                    "trends": "30d",
                    "status": "0",
                    "value_type": "3",
                    "trapper_hosts": "",
                    "??????": "",
                    "logtimefmt": "",
                    "templateid": "28255",
                    "valuemapid": "0",
                    "params": "",
                    "ipmi_sensor": "",
                    "authtype": "0",
                    "?? ?????": "",
                    "?????": "",
                    "???? ??????": "",
                    "???? ????": "",
                    "interfaceid": "2",
                    "?????": "",
                    "evaltype": "0",
                    "jmx_endpoint": "",
                    "master_itemid": "0",
                    "timeout": "3 ?????",
                    "url": "{#IURL}",
                    "query_fields": [],
                    "??????": "",
                    "status_codes": "",
                    "follow_redirects": "0",
                    "post_type": "0",
                    "http_proxy": "",
                    "??????": [],
                    "retrieve_mode": "0",
                    "request_method": "3",
                    "output_format": "0",
                    "ssl_cert_file": "",
                    "ssl_key_file": "",
                    "ssl_key_password": "",
                    "verify_peer": "0",
                    "verify_host": "0",
                    "allow_traps": "0",
                    "discover": "0",
                    "uuid": "",
                    "???????": []
                }
            ],
            "????": 17
       }

??? ??

????

CItemPrototype::get()? ???? ui/include/classes/api/services/CItemPrototype.php.