2022 Zabbix中国峰会
2022 Zabbix中国峰会


Description 描述

object script.execute(object parameters)

This method allows to run a script on a host. 此方法允许在一个主机上运行一个脚本

Parameters 参数

(object) Parameters containing the ID of the script to run and the ID of the host. (object) 参数包含要运行脚本的id和主机的id

Parameter Type Description
string ID of the host to run the script on. 要运行脚本的主机id
string ID of the script to run. 要运行脚本的脚本id

Return values 返回值

(object) Returns the result of script execution. (object) 返回脚本执行的结果

Property Type Description
response string Whether the script was run successfully.

Possible values: success or failed. 脚本是否执行成功

可能的值 :成功失败
value string Script output. 脚本的输出结果

Examples 示例如下

Run a script 运行一个脚本

Run a "ping" script on a host. 在一个主机上运行一个 "ping"脚本


           "jsonrpc": "2.0",
           "method": "script.execute",
           "params": {
               "scriptid": "1",
               "hostid": "30079"
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1


           "jsonrpc": "2.0",
           "result": {
               "response": "success",
               "value": "PING ( 56(84) bytes of data.\n64 bytes from icmp_req=1 ttl=64 time=0.074 ms\n64 bytes from icmp_req=2 ttl=64 time=0.030 ms\n64 bytes from icmp_req=3 ttl=64 time=0.030 ms\n\n--- 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() in frontends/php/include/classes/api/services/CScript.php.