Documentation
Table of Contents
script.execute
§°§á§Ú§ã§Ñ§ß§Ú§Ö
object script.execute(§á§Ñ§â§Ñ§Þ§Ö§ä§â§í §à§Ò§ì§Ö§Ü§ä§Ñ)
§¿§ä§à§ä §Þ§Ö§ä§à§Õ §á§à§Ù§Ó§à§Ý§ñ§Ö§ä §Ù§Ñ§á§å§ã§ä§Ú§ä§î §ã§Ü§â§Ú§á§ä §ß§Ñ §ç§à§ã§ä§Ö §Ú§Ý§Ú §ã§à§Ò§í§ä§Ú§Ú. §©§Ñ §Ú§ã§Ü§Ý§ð§é§Ö§ß§Ú§Ö§Þ §ã§Ü§â§Ú§á§ä§à§Ó §ä§Ú§á§Ñ URL. §°§ß§Ú §ß§Ö §ñ§Ó§Ý§ñ§ð§ä§ã§ñ §Ú§ã§á§à§Ý§ß§ñ§Ö§Þ§í§Þ§Ú.
§¿§ä§à§ä §Þ§Ö§ä§à§Õ §Õ§à§ã§ä§å§á§Ö§ß §á§à§Ý§î§Ù§à§Ó§Ñ§ä§Ö§Ý§ñ§Þ §Ý§ð§Ò§à§Ô§à §ä§Ú§á§Ñ. §²§Ñ§Ù§â§Ö§ê§Ö§ß§Ú§ñ §ß§Ñ §Ó§í§Ù§à§Ó §Þ§Ö§ä§à§Õ§Ñ §Þ§à§Ø§ß§à §à§ä§à§Ù§Ó§Ñ§ä§î §Ó §ß§Ñ§ã§ä§â§à§Û§Ü§Ñ§ç §â§à§Ý§Ö§Û §á§à§Ý§î§Ù§à§Ó§Ñ§ä§Ö§Ý§ñ. §¥§à§á§à§Ý§ß§Ú§ä§Ö§Ý§î§ß§å§ð §Ú§ß§æ§à§â§Þ§Ñ§è§Ú§ð §ã§Þ. §Ó §â§Ñ§Ù§Õ§Ö§Ý§Ö §²§à§Ý§Ú §á§à§Ý§î§Ù§à§Ó§Ñ§ä§Ö§Ý§Ö§Û.
§±§Ñ§â§Ñ§Þ§Ö§ä§â§í
(§à§Ò§ì§Ö§Ü§ä) §±§Ñ§â§Ñ§Þ§Ö§ä§â§í, §Ü§à§ä§à§â§í§Ö §ã§à§Õ§Ö§â§Ø§Ñ§ä ID §Ó§í§á§à§Ý§ß§ñ§Ö§Þ§à§Ô§à §ã§Ü§â§Ú§á§ä§Ñ §Ú ID §å§Ù§Ý§Ñ §ã§Ö§ä§Ú.
| §±§Ñ§â§Ñ§Þ§Ö§ä§â | §´§Ú§á | §°§á§Ú§ã§Ñ§ß§Ú§Ö |
|---|---|---|
| hostid (§ä§â§Ö§Ò§å§Ö§ä§ã§ñ) |
§ã§ä§â§à§Ü§Ñ | ID §å§Ù§Ý§Ñ §ã§Ö§ä§Ú, §ß§Ñ §Ü§à§ä§à§â§à§Þ §ß§Ö§à§Ò§ç§à§Õ§Ú§Þ§à §Ó§í§á§à§Ý§ß§Ú§ä§î §ã§Ü§â§Ú§á§ä. |
| scriptid (§ä§â§Ö§Ò§å§Ö§ä§ã§ñ) |
§ã§ä§â§à§Ü§Ñ | ID §Ó§í§á§à§Ý§ß§ñ§Ö§Þ§à§Ô§à §ã§Ü§â§Ú§á§ä§Ñ. |
§£§à§Ù§Ó§â§Ñ§ë§Ñ§Ö§Þ§í§Ö §Ù§ß§Ñ§é§Ö§ß§Ú§ñ
(§à§Ò§ì§Ö§Ü§ä) §£§à§Ù§Ó§â§Ñ§ë§Ñ§Ö§ä §â§Ö§Ù§å§Ý§î§ä§Ñ§ä §Ó§í§á§à§Ý§ß§Ö§ß§Ú§ñ §ã§Ü§â§Ú§á§ä§Ñ.
| §³§Ó§à§Û§ã§ä§Ó§à | §´§Ú§á | §°§á§Ú§ã§Ñ§ß§Ú§Ö |
|---|---|---|
| response | §ã§ä§â§à§Ü§Ñ | §£§í§á§à§Ý§ß§Ú§Ý§ã§ñ §Ý§Ú §ã§Ü§â§Ú§á§ä §å§ã§á§Ö§ê§ß§à. §£§à§Ù§Þ§à§Ø§ß§í§Ö §Ù§ß§Ñ§é§Ö§ß§Ú§ñ: success §Ú§Ý§Ú failed. |
| value | §ã§ä§â§à§Ü§Ñ | §£§í§Ó§à§Õ §ã§Ü§â§Ú§á§ä§Ñ. |
§±§â§Ú§Þ§Ö§â§í
§£§í§á§à§Ý§ß§Ö§ß§Ú§Ö §ã§Ü§â§Ú§á§ä§Ñ
§£§í§á§à§Ý§ß§Ö§ß§Ú§Ö "ping" §ã§Ü§â§Ú§á§ä§Ñ §ß§Ñ §å§Ù§Ý§Ö §ã§Ö§ä§Ú.
§©§Ñ§á§â§à§ã:
{
"jsonrpc": "2.0",
"method": "script.execute",
"params": {
"scriptid": "1",
"hostid": "30079"
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}§°§ä§Ó§Ö§ä:
{
"jsonrpc": "2.0",
"result": {
"response": "success",
"value": "PING 127.0.0.1 (127.0.0.1) 56(84) bytes of data.\n64 bytes from 127.0.0.1: icmp_req=1 ttl=64 time=0.074 ms\n64 bytes from 127.0.0.1: icmp_req=2 ttl=64 time=0.030 ms\n64 bytes from 127.0.0.1: icmp_req=3 ttl=64 time=0.030 ms\n\n--- 127.0.0.1 ping statistics ---\n3 packets transmitted, 3 received, 0% packet loss, time 1998ms\nrtt min/avg/max/mdev = 0.030/0.044/0.074/0.022 ms\n"
},
"id": 1
}§ª§ã§ç§à§Õ§ß§í§Û §Ü§à§Õ
CScript::execute() §Ó frontends/php/include/classes/api/services/CScript.php.
Run a custom script with manual input
Run a "ping" script with command "ping -c {MANUALINPUT} {HOST.CONN}; case $? in [01]) true;; *) false;; esac" on a host.
{
"jsonrpc": "2.0",
"method": "script.execute",
"params": {
"scriptid": "7",
"hostid": "30079",
"manualinput": "2"
},
"id": 1
}Response:
{
"jsonrpc": "2.0",
"result": {
"response": "success",
"value": "PING 127.0.0.1 (127.0.0.1) 56(84) bytes of data.\n64 bytes from 127.0.0.1: icmp_seq=1 ttl=64 time=0.051 ms\n64 bytes from 127.0.0.1: icmp_seq=2 ttl=64 time=0.025 ms\n\n--- 127.0.0.1 ping statistics ---\n2 packets transmitted, 2 received, 0% packet loss, time 1021ms\nrtt min/avg/max/mdev = 0.025/0.038/0.051/0.013 ms",
"debug": []
},
"id": 1
}§ª§ã§ä§à§é§ß§Ú§Ü
CScript::execute() §Ó ui/include/classes/api/services/CScript.php.