[comment]: # aside: 1

[comment]: # translation:outdated

[comment]: # ({43284bfe-8b1700c1})
# Skript-Objekt

Die folgenden Objekte stehen in direktem Zusammenhang mit der `script` API.

[comment]: # ({/43284bfe-8b1700c1})

[comment]: # ({1c7e0362-9c6db006})
### Skript

Das Skriptobjekt hat die folgenden Eigenschaften.

|Eigenschaft|[Typ](/manual/api/reference_commentary#data-types)|Beschreibung|
|--|--|------|
|scriptid|ID|ID des Skripts.<br><br>[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):<br>- *schreibgeschützt*<br>- *erforderlich* für Aktualisierungsvorgänge|
|name|string|Name des Skripts.<br><br>[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):<br>- *erforderlich* für Erstellungsvorgänge|
|type|integer|Skripttyp.<br><br>Mögliche Werte, wenn `scope` auf „action operation“ gesetzt ist:<br>0 - Skript;<br>1 - IPMI;<br>2 - SSH;<br>3 - TELNET;<br>5 - Webhook.<br><br>Mögliche Werte, wenn `scope` auf „manual host action“ oder „manual event action“ gesetzt ist:<br>6 - URL.<br><br>[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):<br>- *erforderlich* für Erstellungsvorgänge|
|command|string|Auszuführender Befehl.<br><br>[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):<br>- *erforderlich*, wenn `type` auf „Skript“, „IPMI“, „SSH“, „TELNET“ oder „Webhook“ gesetzt ist|
|scope|integer|Geltungsbereich des Skripts.<br><br>Mögliche Werte:<br>1 - action operation;<br>2 - manual host action;<br>4 - manual event action.<br><br>[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):<br>- *erforderlich* für Erstellungsvorgänge|
|execute\_on|integer|Wo das Skript ausgeführt werden soll.<br><br>Mögliche Werte:<br>0 - auf Zabbix Agent ausführen;<br>1 - auf Zabbix Server ausführen. Dies wird nur *unterstützt*, wenn die Ausführung globaler Skripte auf dem Zabbix Server aktiviert ist;<br>2 - *(Standard)* auf Zabbix Server oder Proxy ausführen.<br><br>[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):<br>- *unterstützt*, wenn `type` auf „Skript“ gesetzt ist|
|menu\_path|string|Durch Schrägstriche getrennte Ordner, die beim Klicken auf einen Host oder ein Ereignis eine menüartige Navigation im Frontend bilden.<br><br>[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):<br>- *unterstützt*, wenn `scope` auf „manual host action“ oder „manual event action“ gesetzt ist|
|authtype|integer|Für den SSH-Skripttyp verwendete Authentifizierungsmethode.<br><br>Mögliche Werte:<br>0 - Passwort;<br>1 - öffentlicher Schlüssel.<br><br>[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):<br>- *unterstützt*, wenn `type` auf „SSH“ gesetzt ist|
|username|string|Für die Authentifizierung verwendeter Benutzername.<br><br>[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):<br>- *erforderlich*, wenn `type` auf „SSH“ oder „TELNET“ gesetzt ist|
|password|string|Passwort für SSH-Skripte mit Passwortauthentifizierung und TELNET-Skripte.<br><br>[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):<br>- *unterstützt*, wenn `type` auf „SSH“ und `authtype` auf „password“ gesetzt ist oder `type` auf „TELNET“ gesetzt ist|
|publickey|string|Name der Datei mit dem öffentlichen Schlüssel für SSH-Skripte mit Authentifizierung per öffentlichem Schlüssel.<br><br>[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):<br>- *erforderlich*, wenn `type` auf „SSH“ und `authtype` auf „public key“ gesetzt ist|
|privatekey|string|Name der Datei mit dem privaten Schlüssel für SSH-Skripte mit Authentifizierung per öffentlichem Schlüssel.<br><br>[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):<br>- *erforderlich*, wenn `type` auf „SSH“ und `authtype` auf „public key“ gesetzt ist|
|port|string|Portnummer für SSH- und TELNET-Skripte.<br><br>[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):<br>- *unterstützt*, wenn `type` auf „SSH“ oder „TELNET“ gesetzt ist|
|groupid|ID|ID der Hostgruppe, auf der das Skript ausgeführt werden kann.<br><br>Wenn auf „0“ gesetzt, ist das Skript in allen Hostgruppen verfügbar.<br><br>Standard: 0.|
|usrgrpid|ID|ID der Benutzergruppe, die das Skript ausführen darf.<br><br>Wenn auf „0“ gesetzt, ist das Skript für alle Benutzergruppen verfügbar.<br><br>Standard: 0.<br><br>[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):<br>- *unterstützt*, wenn `scope` auf „manual host action“ oder „manual event action“ gesetzt ist|
|host\_access|integer|Zum Ausführen des Skripts erforderliche Host-Berechtigungen.<br><br>Mögliche Werte:<br>2 - *(Standard)* Lesen;<br>3 - Schreiben.<br><br>[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):<br>- *unterstützt*, wenn `scope` auf „manual host action“ oder „manual event action“ gesetzt ist|
|confirmation|string|Text des Bestätigungs-Pop-ups.<br>Das Pop-up wird angezeigt, wenn versucht wird, das Skript aus dem Zabbix Frontend auszuführen.<br><br>[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):<br>- *unterstützt*, wenn `scope` auf „manual host action“ oder „manual event action“ gesetzt ist|
|timeout|string|Zeitüberschreitung für die Ausführung des webhook-Skripts in Sekunden. Zeitsuffixe werden unterstützt (z. B. 30s, 1m).<br><br>Mögliche Werte: 1-60s.<br><br>Standard: 30s.<br><br>[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):<br>- *erforderlich*, wenn `type` auf „Webhook“ gesetzt ist|
|parameters|array|Array von [webhook-Eingabeparametern](/manual/api/reference/script/object#webhook-parameters).<br><br>[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):<br>- *unterstützt*, wenn `type` auf „Webhook“ gesetzt ist|
|description|string|Beschreibung des Skripts.|
|url|string|Benutzerdefinierte URL.<br><br>[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):<br>- *erforderlich*, wenn `type` auf „URL“ gesetzt ist|
|new_window|integer|URL in einem neuen Fenster öffnen.<br><br>Mögliche Werte:<br>0 - Nein;<br>1 - *(Standard)* Ja.<br><br>[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):<br>- *unterstützt*, wenn `type` auf „URL“ gesetzt ist|
|manualinput|integer|Gibt an, ob das Skript benutzerseitig bereitgestellte Eingaben akzeptiert.<br><br>Mögliche Werte:<br>0 - *(Standard)* Deaktiviert;<br>1 - Aktiviert;<br><br>[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):<br>- *unterstützt*, wenn `scope` auf „manual host action“ oder „manual event action“ gesetzt ist|
|manualinput_prompt|string|Text der Aufforderung für die manuelle Eingabe.<br><br>[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):<br>- *erforderlich*, wenn `manualinput` auf „Enabled“ gesetzt ist|
|manualinput_validator|string|Ein Zeichenkettenfeld zur Validierung der vom Benutzer bereitgestellten Eingabe. Die Zeichenkette besteht entweder aus einem regulären Ausdruck oder aus einer durch Kommas getrennten Menge von Werten.<br><br>[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):<br>- *erforderlich*, wenn `manualinput` auf „Enabled“ gesetzt ist|
|manualinput_validator_type|integer|Bestimmt den erwarteten Typ der Benutzereingabe.<br><br>Mögliche Werte:<br>0 - *(Standard)* Zeichenkette. Gibt an, dass manualinput_validator als regulärer Ausdruck behandelt werden soll;<br>1 - Liste. Gibt an, dass manualinput_validator als durch Kommas getrennte Liste möglicher Eingabewerte behandelt werden soll.<br><br>[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):<br>- *unterstützt*, wenn `manualinput` auf „Enabled“ gesetzt ist|
|manualinput_default_value|string|Standardwert zum automatischen Ausfüllen der Benutzereingabe.<br><br>[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):<br>- *unterstützt*, wenn `manualinput_validator_type` auf „String“ gesetzt ist|

[comment]: # ({/1c7e0362-9c6db006})

[comment]: # ({4ab66f57-05b0e37d})
#### webhook-Parameter

Parameter, die beim Aufruf an das webhook-Skript übergeben werden, haben die folgenden Eigenschaften.

|Eigenschaft|[Typ](/manual/api/reference_commentary#data-types)|Beschreibung|
|--|--|------|
|name|string|Parametername.<br><br>[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):<br>- *erforderlich*|
|value|string|Parameterwert. Unterstützt [Makros](/manual/appendix/macros/supported_by_location).|

[comment]: # ({/4ab66f57-05b0e37d})

[comment]: # ({0ba46586-587d2fd0})
### Debug

Debug-Informationen des ausgeführten webhook-Skripts. Das Debug-Objekt hat die
folgenden Eigenschaften.

|Eigenschaft|[Type](/manual/api/reference_commentary#data-types)|Beschreibung|
|--|--|------|
|logs|array|Array von [Log-Einträgen](/manual/api/reference/script/object#log-entry).|
|ms|string|Dauer der Skriptausführung in Millisekunden.|

[comment]: # ({/0ba46586-587d2fd0})

[comment]: # ({f7a09e87-8ea23127})
#### Protokolleintrag

Das Protokolleintrag-Objekt hat die folgenden Eigenschaften.

|Eigenschaft|[Typ](/manual/api/reference_commentary#data-types)|Beschreibung|
|--|--|------|
|level|integer|Protokollebene.|
|ms|string|Die in Millisekunden verstrichene Zeit seit der Ausführung des Skripts, bevor der Protokolleintrag hinzugefügt wurde.|
|message|string|Protokollnachricht.|

[comment]: # ({/f7a09e87-8ea23127})