[comment]: # translation:outdated [comment]: # ({cd91b3fe-cd91b3fe}) # script.get [comment]: # ({/cd91b3fe-cd91b3fe}) [comment]: # ({ce6433f5-96ec37bc}) ### Beschreibung `integer/array script.get(object parameters)` Mit dieser Methode können Skripte entsprechend den angegebenen Parametern abgerufen werden. ::: noteclassic Diese Methode ist für Benutzer aller Typen verfügbar. Die Berechtigungen zum Aufrufen der Methode können in den Einstellungen der Benutzerrolle entzogen werden. Weitere Informationen finden Sie unter [Benutzerrollen](/manual/web_interface/frontend_sections/users/user_roles). ::: [comment]: # ({/ce6433f5-96ec37bc}) [comment]: # ({0d0f6412-c425a65a}) ### Parameter `(object)` Parameter, die die gewünschte Ausgabe definieren. Die Methode unterstützt die folgenden Parameter. |Parameter|[Type](/manual/api/reference_commentary#data-types)|Beschreibung| |--|--|------| |groupids|ID/array|Gibt nur Skripte zurück, die für die angegebenen Host-Gruppen ausgeführt werden können.| |hostids|ID/array|Gibt nur Skripte zurück, die auf den angegebenen Hosts ausgeführt werden können.| |scriptids|ID/array|Gibt nur Skripte mit den angegebenen IDs zurück.| |usrgrpids|ID/array|Gibt nur Skripte zurück, die von Benutzern in den angegebenen Benutzergruppen ausgeführt werden können.| |selectHostGroups|query|Gibt eine Eigenschaft [`hostgroups`](/manual/api/reference/hostgroup/object) mit Host-Gruppen zurück, für die das Skript ausgeführt werden kann.| |selectHosts|query|Gibt eine Eigenschaft [`hosts`](/manual/api/reference/host/object) mit Hosts zurück, auf denen das Skript ausgeführt werden kann.| |selectActions|query|Gibt eine Eigenschaft [`actions`](/manual/api/reference/action/object) mit Aktionen zurück, mit denen das Skript verknüpft ist.| |sortfield|string/array|Sortiert das Ergebnis nach den angegebenen Eigenschaften.

Mögliche Werte: `scriptid`, `name`.| |countOutput|boolean|Diese Parameter sind im [Referenzkommentar](/manual/api/reference_commentary#common-get-method-parameters) beschrieben.| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^| [comment]: # ({/0d0f6412-c425a65a}) [comment]: # ({7223bab1-7223bab1}) ### Rückgabewerte `(integer/array)` Gibt entweder Folgendes zurück: - ein Array von Objekten; - die Anzahl der abgerufenen Objekte, wenn der Parameter `countOutput` verwendet wurde. [comment]: # ({/7223bab1-7223bab1}) [comment]: # ({b41637d2-b41637d2}) ### Beispiele [comment]: # ({/b41637d2-b41637d2}) [comment]: # ({04ad24fc-6d428f32}) #### Alle Skripte abrufen Rufen Sie alle konfigurierten Skripte ab. [Anfrage](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "script.get", "params": { "output": "extend" }, "id": 1 } ``` Antwort: ```json { "jsonrpc": "2.0", "result": [ { "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", "timeout": "30s", "scope": "2", "port": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "menu_path": "", "url": "", "new_window": "1", "manualinput": "0", "manualinput_prompt": "", "manualinput_validator": "", "manualinput_validator_type": "0", "manualinput_default_value": "", "parameters": [] }, { "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", "timeout": "30s", "scope": "2", "port": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "menu_path": "", "url": "", "new_window": "1", "manualinput": "0", "manualinput_prompt": "", "manualinput_validator": "", "manualinput_validator_type": "0", "manualinput_default_value": "", "parameters": [] }, { "scriptid": "3", "name": "Betriebssystem erkennen", "command": "sudo /usr/bin/nmap -O {HOST.CONN} 2>&1", "host_access": "2", "usrgrpid": "7", "groupid": "0", "description": "", "confirmation": "", "type": "0", "execute_on": "1", "timeout": "30s", "scope": "2", "port": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "menu_path": "", "url": "", "new_window": "1", "manualinput": "0", "manualinput_prompt": "", "manualinput_validator": "", "manualinput_validator_type": "0", "manualinput_default_value": "", "parameters": [] }, { "scriptid": "4", "name": "Webhook", "command": "try {\n var request = new HttpRequest(),\n response,\n data;\n\n request.addHeader('Content-Type: application/json');\n\n response = request.post('https://localhost/post', value);\n\n try {\n response = JSON.parse(response);\n }\n catch (error) {\n response = null;\n }\n\n if (request.getStatus() !== 200 || !('data' in response)) {\n throw 'Unexpected response.';\n }\n\n data = JSON.stringify(response.data);\n\n Zabbix.log(3, '[Webhook Script] response data: ' + data);\n\n return data;\n}\ncatch (error) {\n Zabbix.log(3, '[Webhook Script] script execution failed: ' + error);\n throw 'Execution failed: ' + error + '.';\n}", "host_access": "2", "usrgrpid": "7", "groupid": "0", "description": "", "confirmation": "", "type": "5", "execute_on": "1", "timeout": "30s", "scope": "2", "port": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "menu_path": "", "url": "", "new_window": "1", "manualinput": "0", "manualinput_prompt": "", "manualinput_validator": "", "manualinput_validator_type": "0", "manualinput_default_value": "", "parameters": [ { "name": "token", "value": "{$WEBHOOK.TOKEN}" }, { "name": "host", "value": "{HOST.HOST}" }, { "name": "v", "value": "2.2" } ] }, { "scriptid": "5", "name": "URL", "command": "", "host_access": "2", "usrgrpid": "0", "groupid": "0", "description": "", "confirmation": "Zu {HOST.NAME} gehen?", "type": "6", "execute_on": "1", "timeout": "30s", "scope": "4", "port": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "menu_path": "", "url": "http://zabbix/ui/zabbix.php?action=latest.view&hostids[]={HOST.ID}", "new_window": "0", "manualinput": "0", "manualinput_prompt": "", "manualinput_validator": "", "manualinput_validator_type": "0", "manualinput_default_value": "", "parameters": [] }, { "scriptid": "6", "name": "URL mit Benutzereingabe", "command": "", "host_access": "2", "usrgrpid": "0", "groupid": "0", "description": "", "confirmation": "Zabbix-Seite {MANUALINPUT} öffnen?", "type": "6", "execute_on": "1", "timeout": "30s", "scope": "2", "port": "", "authtype": "0", "username": "", "password": "", "publickey": "", "privatekey": "", "menu_path": "", "url": "http://zabbix/ui/zabbix.php?action={MANUALINPUT}", "new_window": "0", "manualinput": "1", "manualinput_prompt": "Wählen Sie eine zu öffnende Seite aus:", "manualinput_validator": "dashboard.view,script.list,actionlog.list", "manualinput_validator_type": "1", "parameters": [] } ], "id": 1 } ``` [comment]: # ({/04ad24fc-6d428f32}) [comment]: # ({8f0410a4-b0b740ec}) ### Siehe auch - [Host](/manual/api/reference/host/object#object-details) - [Host-Gruppe](/manual/api/reference/hostgroup/object#object-details) [comment]: # ({/8f0410a4-b0b740ec}) [comment]: # ({90dfc753-90dfc753}) ### Quelle CScript::get() in *ui/include/classes/api/services/CScript.php*. [comment]: # ({/90dfc753-90dfc753})