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

script.getscriptsbyhosts

Description说明

object script.getscriptsbyhosts(array hostIds)

This method allows to retrieve scripts available on the given hosts此方法允许检索给定主机上可用的脚本.

Parameters参数

(string/array) IDs of hosts to return scripts for要返回脚本的主机的ID.

Return values返回值

(object) Returns an object with host IDs as properties and arrays of available scripts as values返回一个具有主机ID的对象和可用脚本的数组作为值.

The method will automatically expand macros in the confirmation text该方法将自动在confirmation文本中展开宏.

Examples范例

Retrieve scripts by host IDs通过主机ID检索脚本

Retrieve all scripts available on hosts "30079" and "30073"检索主机"30079" 和"30073"上可用的所有脚本。.

Request请求:

{
           "jsonrpc": "2.0",
           "method": "script.getscriptsbyhosts",
           "params": [
               "30079",
               "30073"
           ],
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Response响应:

{
           "jsonrpc": "2.0",
           "result": {
               "30079": [
                   {
                       "scriptid": "3",
                       "name": "Detect operating system",
                       "command": "sudo /usr/bin/nmap -O {HOST.CONN} 2>&1",
                       "host_access": "2",
                       "usrgrpid": "7",
                       "groupid": "0",
                       "description": "",
                       "confirmation": "",
                       "type": "0",
                       "execute_on": "1",
                       "hostid": "10001"
                   },
                   {
                       "scriptid": "1",
                       "name": "Ping",
                       "command": "/bin/ping -c 3 {HOST.CONN} 2>&1",
                       "host_access": "2",
                       "usrgrpid": "0",
                       "groupid": "0",
                       "description": "",
                       "confirmation": "",
                       "type": "0",
                       "execute_on": "1",
                       "hostid": "10001"
                   },
                   {
                       "scriptid": "2",
                       "name": "Traceroute",
                       "command": "/usr/bin/traceroute {HOST.CONN} 2>&1",
                       "host_access": "2",
                       "usrgrpid": "0",
                       "groupid": "0",
                       "description": "",
                       "confirmation": "",
                       "type": "0",
                       "execute_on": "1",
                       "hostid": "10001"
                   }
               ],
               "30073": [
                   {
                       "scriptid": "3",
                       "name": "Detect operating system",
                       "command": "sudo /usr/bin/nmap -O {HOST.CONN} 2>&1",
                       "host_access": "2",
                       "usrgrpid": "7",
                       "groupid": "0",
                       "description": "",
                       "confirmation": "",
                       "type": "0",
                       "execute_on": "1",
                       "hostid": "10001"
                   },
                   {
                       "scriptid": "1",
                       "name": "Ping",
                       "command": "/bin/ping -c 3 {HOST.CONN} 2>&1",
                       "host_access": "2",
                       "usrgrpid": "0",
                       "groupid": "0",
                       "description": "",
                       "confirmation": "",
                       "type": "0",
                       "execute_on": "1",
                       "hostid": "10001"
                   },
                   {
                       "scriptid": "2",
                       "name": "Traceroute",
                       "command": "/usr/bin/traceroute {HOST.CONN} 2>&1",
                       "host_access": "2",
                       "usrgrpid": "0",
                       "groupid": "0",
                       "description": "",
                       "confirmation": "",
                       "type": "0",
                       "execute_on": "1",
                       "hostid": "10001"
                   }
               ]
           },
           "id": 1
       }

Source源码

CScript::getScriptsByHosts() in frontends/php/include/classes/api/services/CScript.php.