[comment]: # aside: 1

[comment]: # translation:outdated

[comment]: # ({5fa5406d-502c65c3})
# Aktionsobjekt

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

[comment]: # ({/5fa5406d-502c65c3})

[comment]: # ({cc3f51c7-73117797})
### Aktion

Das Aktionsobjekt hat die folgenden Eigenschaften.

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|actionid|ID|ID der Aktion.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *schreibgeschützt*<br>- *erforderlich* für Aktualisierungsvorgänge|
|esc\_period|string|Standarddauer des Operationsschritts. Muss mindestens 60 Sekunden betragen. Akzeptiert Sekunden, eine Zeiteinheit mit Suffix oder ein Benutzermakro.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *unterstützt*, wenn `eventsource` auf „durch einen Auslöser erstelltes Ereignis“, „internes Ereignis“ oder „bei einer Service-Statusaktualisierung erstelltes Ereignis“ gesetzt ist|
|eventsource|integer|Typ der Ereignisse, die von der Aktion verarbeitet werden.<br><br>Eine Liste der unterstützten Ereignistypen finden Sie in der [Ereignis-Eigenschaft `source`](/manual/api/reference/event/object#event).<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *konstant*<br>- *erforderlich* für Erstellungsvorgänge|
|name|string|Name der Aktion.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *erforderlich* für Erstellungsvorgänge|
|status|integer|Gibt an, ob die Aktion aktiviert oder deaktiviert ist.<br><br>Mögliche Werte:<br>0 - *(Standard)* aktiviert;<br>1 - deaktiviert.|
|pause\_symptoms|integer|Gibt an, ob die Eskalation pausiert werden soll, wenn das Ereignis ein Symptomereignis ist.<br><br>Mögliche Werte:<br>0 - Eskalation für Symptomprobleme nicht pausieren;<br>1 - *(Standard)* Eskalation für Symptomprobleme pausieren.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *unterstützt*, wenn `eventsource` auf „durch einen Auslöser erstelltes Ereignis“ gesetzt ist|
|pause\_suppressed|integer|Gibt an, ob die Eskalation während Wartungszeiträumen pausiert werden soll oder nicht.<br><br>Mögliche Werte:<br>0 - Eskalation nicht pausieren;<br>1 - *(Standard)* Eskalation pausieren.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *unterstützt*, wenn `eventsource` auf „durch einen Auslöser erstelltes Ereignis“ gesetzt ist|
|notify\_if\_canceled|integer|Gibt an, ob benachrichtigt werden soll, wenn die Eskalation abgebrochen wird.<br><br>Mögliche Werte:<br>0 - Nicht benachrichtigen, wenn die Eskalation abgebrochen wird;<br>1 - *(Standard)* Benachrichtigen, wenn die Eskalation abgebrochen wird.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *unterstützt*, wenn `eventsource` auf „durch einen Auslöser erstelltes Ereignis“ gesetzt ist|

[comment]: # ({/cc3f51c7-73117797})

[comment]: # ({59c01820-8757165b})
### Aktionsoperation

Das Objekt der Aktionsoperation definiert eine Operation, die ausgeführt wird,
wenn eine Aktion ausgeführt wird. Es hat die folgenden Eigenschaften.

|Eigenschaft|[Typ](/manual/api/reference_commentary#data-types)|Beschreibung|
|--|--|------|
|operationtype|integer|Typ der Operation.<br><br>Mögliche Werte:<br>0 - Nachricht senden;<br>1 - globales Skript;<br>2 - Host hinzufügen;<br>3 - Host entfernen;<br>4 - zu Hostgruppe hinzufügen;<br>5 - aus Hostgruppe entfernen;<br>6 - Vorlage verknüpfen;<br>7 - Verknüpfung der Vorlage aufheben;<br>8 - Host aktivieren;<br>9 - Host deaktivieren;<br>10 - Inventarmodus des Hosts festlegen;<br>13 - Host-Tags hinzufügen;<br>14 - Host-Tags entfernen.<br><br>Mögliche Werte, wenn `eventsource` des [Aktionsobjekts](#action) auf „durch einen Auslöser erzeugtes Ereignis“ oder „bei Aktualisierung des Servicestatus erzeugtes Ereignis“ gesetzt ist:<br>0 - „Nachricht senden“;<br>1 - „globales Skript“.<br><br>Mögliche Werte, wenn `eventsource` des [Aktionsobjekts](#action) auf „internes Ereignis“ gesetzt ist:<br>0 - „Nachricht senden“.<br><br>[Eigenschaftsverhalten](/manual/api/reference_commentary#property-behavior):<br>- *erforderlich*|
|esc\_period|string|Dauer eines Eskalationsschritts in Sekunden. Muss größer als 60 Sekunden sein. Akzeptiert Sekunden, eine Zeiteinheit mit Suffix oder ein Benutzermakro. Wenn auf 0 oder 0s gesetzt, wird die Standard-Eskalationsperiode der Aktion verwendet.<br><br>Standard: 0s.<br><br>[Eigenschaftsverhalten](/manual/api/reference_commentary#property-behavior):<br>- *unterstützt*, wenn `eventsource` des [Aktionsobjekts](#action) auf „durch einen Auslöser erzeugtes Ereignis“, „internes Ereignis“ oder „bei Aktualisierung des Servicestatus erzeugtes Ereignis“ gesetzt ist|
|esc\_step\_from|integer|Schritt, ab dem die Eskalation beginnt.<br><br>Standard: 1.<br><br>[Eigenschaftsverhalten](/manual/api/reference_commentary#property-behavior):<br>- *unterstützt*, wenn `eventsource` des [Aktionsobjekts](#action) auf „durch einen Auslöser erzeugtes Ereignis“, „internes Ereignis“ oder „bei Aktualisierung des Servicestatus erzeugtes Ereignis“ gesetzt ist|
|esc\_step\_to|integer|Schritt, bei dem die Eskalation endet.<br><br>Standard: 1.<br><br>[Eigenschaftsverhalten](/manual/api/reference_commentary#property-behavior):<br>- *unterstützt*, wenn `eventsource` des [Aktionsobjekts](#action) auf „durch einen Auslöser erzeugtes Ereignis“, „internes Ereignis“ oder „bei Aktualisierung des Servicestatus erzeugtes Ereignis“ gesetzt ist|
|evaltype|integer|[Auswertungsmethode](/manual/config/notifications/action/conditions#type-of-calculation) der Operationsbedingung.<br><br>Mögliche Werte:<br>0 - *(Standard)* Und/Oder;<br>1 - Und;<br>2 - Oder.|
|opcommand|object|Globales Skript, das ausgeführt werden soll.<br><br>Für das globale Skript muss die Eigenschaft `scriptid` definiert sein.<br><br>[Eigenschaftsverhalten](/manual/api/reference_commentary#property-behavior):<br>- *erforderlich*, wenn `operationtype` auf „globales Skript“ gesetzt ist|
|opcommand\_grp|array|Hostgruppen, auf denen globale Skripte ausgeführt werden.<br><br>Für die Hostgruppen muss die Eigenschaft `groupid` definiert sein.<br><br>[Eigenschaftsverhalten](/manual/api/reference_commentary#property-behavior):<br>- *erforderlich*, wenn `operationtype` auf „globales Skript“ gesetzt ist und `opcommand_hst` nicht gesetzt ist|
|opcommand\_hst|array|Host, auf dem globale Skripte ausgeführt werden.<br><br>Für die Hosts muss die Eigenschaft `hostid` definiert sein.<br><br>[Eigenschaftsverhalten](/manual/api/reference_commentary#property-behavior):<br>- *erforderlich*, wenn `operationtype` auf „globales Skript“ gesetzt ist und `opcommand_grp` nicht gesetzt ist|
|opconditions|array|Operationsbedingungen, die für Auslöser-Aktionen verwendet werden.<br><br>Das Objekt der Operationsbedingung wird [weiter unten ausführlich beschrieben](/manual/api/reference/action/object#action-operation-condition).|
|opgroup|array|Hostgruppen, zu denen Hosts hinzugefügt werden.<br><br>Für die Hostgruppen muss die Eigenschaft `groupid` definiert sein.<br><br>[Eigenschaftsverhalten](/manual/api/reference_commentary#property-behavior):<br>- *erforderlich*, wenn `operationtype` auf „zu Hostgruppe hinzufügen“ oder „aus Hostgruppe entfernen“ gesetzt ist|
|opmessage|object|Objekt, das die Daten über die von der Operation gesendete Nachricht enthält.<br><br>Das Objekt der Operationsnachricht wird [weiter unten ausführlich beschrieben](/manual/api/reference/action/object#action-operation-message).<br><br>[Eigenschaftsverhalten](/manual/api/reference_commentary#property-behavior):<br>- *erforderlich*, wenn `operationtype` auf „Nachricht senden“ gesetzt ist|
|opmessage\_grp|array|Benutzergruppen, an die Nachrichten gesendet werden.<br><br>Für die Benutzergruppen muss die Eigenschaft `usrgrpid` definiert sein.<br><br>[Eigenschaftsverhalten](/manual/api/reference_commentary#property-behavior):<br>- *erforderlich*, wenn `operationtype` auf „Nachricht senden“ gesetzt ist und `opmessage_usr` nicht gesetzt ist|
|opmessage\_usr|array|Benutzer, an die Nachrichten gesendet werden.<br><br>Für die Benutzer muss die Eigenschaft `userid` definiert sein.<br><br>[Eigenschaftsverhalten](/manual/api/reference_commentary#property-behavior):<br>- *erforderlich*, wenn `operationtype` auf „Nachricht senden“ gesetzt ist und `opmessage_grp` nicht gesetzt ist|
|optemplate|array|Vorlagen, die mit den Hosts verknüpft werden.<br><br>Für die Vorlagen muss die Eigenschaft `templateid` definiert sein.<br><br>[Eigenschaftsverhalten](/manual/api/reference_commentary#property-behavior):<br>- *erforderlich*, wenn `operationtype` auf „Vorlage verknüpfen“ oder „Verknüpfung der Vorlage aufheben“ gesetzt ist|
|opinventory|object|Inventarmodus, auf den der Host gesetzt wird.<br><br>Für das Inventar muss die Eigenschaft `inventory_mode` definiert sein.<br><br>[Eigenschaftsverhalten](/manual/api/reference_commentary#property-behavior):<br>- *erforderlich*, wenn `operationtype` auf „Inventarmodus des Hosts festlegen“ gesetzt ist|
|optag|array|Host-Tags, die hinzugefügt oder entfernt werden.<br><br>Für Tags muss die Eigenschaft `tag` definiert sein.<br>Die Eigenschaft `value` ist optional. <br><br>[Eigenschaftsverhalten](/manual/api/reference_commentary#property-behavior):<br>- *unterstützt*, wenn `operationtype` auf „Host-Tags hinzufügen“ oder „Host-Tags entfernen“ gesetzt ist.|

[comment]: # ({/59c01820-8757165b})

[comment]: # ({2b6e61d1-4aeccf9f})
#### Aktionsoperationsnachricht

Das Objekt für die Operationsnachricht enthält Daten über die Nachricht, die
von der Operation gesendet wird. Es hat die folgenden Eigenschaften.

|Eigenschaft|[Typ](/manual/api/reference_commentary#data-types)|Beschreibung|
|--|--|------|
|default\_msg|integer|Gibt an, ob der Standardtext und -betreff der Aktionsnachricht verwendet werden sollen.<br><br>Mögliche Werte:<br>0 - die Daten aus der Operation verwenden;<br>1 - *(Standard)* die Daten aus dem Medientyp verwenden.|
|mediatypeid|ID|ID des Medientyps, der zum Senden der Nachricht verwendet wird.<br><br>[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):<br>- *unterstützt*, wenn `operationtype` des [Aktionsoperationsobjekts](#action-operation), [Aktionswiederherstellungsoperationsobjekts](#action-recovery-operation) oder [Aktionsaktualisierungsoperationsobjekts](#action-update-operation) auf „Nachricht senden“ gesetzt ist oder wenn `operationtype` des [Aktionsaktualisierungsoperationsobjekts](#action-update-operation) auf „alle Beteiligten benachrichtigen“ gesetzt ist|
|message|string|Text der Operationsnachricht.<br><br>[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):<br>- *unterstützt*, wenn `default_msg` auf „die Daten aus der Operation verwenden“ gesetzt ist|
|subject|string|Betreff der Operationsnachricht.<br><br>[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):<br>- *unterstützt*, wenn `default_msg` auf „die Daten aus der Operation verwenden“ gesetzt ist|

[comment]: # ({/2b6e61d1-4aeccf9f})

[comment]: # ({87768497-6762fd66})
#### Bedingung für Aktionsoperationen

Das Objekt für die Bedingung einer Aktionsoperation definiert eine Bedingung, die erfüllt sein muss, um die aktuelle Operation auszuführen. Es hat die folgenden Eigenschaften.

|Eigenschaft|[Type](/manual/api/reference_commentary#data-types)|Beschreibung|
|--|--|------|
|conditiontype|integer|Typ der Bedingung.<br><br>Mögliche Werte:<br>14 - Ereignis bestätigt.<br><br>[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):<br>- *erforderlich*|
|value|string|Wert, mit dem verglichen wird.<br><br>[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):<br>- *erforderlich*|
|operator|integer|Bedingungsoperator.<br><br>Mögliche Werte:<br>0 - *(Standard)* =|

Die folgenden Operatoren und Werte werden für jeden Typ der Operationsbedingung unterstützt.

|Bedingung|Name der Bedingung|Unterstützte Operatoren|Erwarteter Wert|
|---------|--------------|-------------------|--------------|
|14|Ereignis bestätigt|=|Ob das Ereignis bestätigt ist.<br><br>Mögliche Werte:<br>0 - nicht bestätigt;<br>1 - bestätigt.|

[comment]: # ({/87768497-6762fd66})

[comment]: # ({fe3a08b5-d1e6762b})
### Wiederherstellungsoperation einer Aktion

Das Objekt für die Wiederherstellungsoperation einer Aktion definiert eine Operation, die ausgeführt wird, wenn ein Problem behoben wird.
Wiederherstellungsoperationen sind **nur** für Auslöser-, interne und Service-Aktionen möglich.
Es hat die folgenden Eigenschaften.

|Eigenschaft|[Typ](/manual/api/reference_commentary#data-types)|Beschreibung|
|--|--|------|
|operationtype|integer|Typ der Operation.<br><br>Mögliche Werte, wenn `eventsource` des [Aktionsobjekts](#action) auf „durch einen Auslöser erzeugtes Ereignis“ oder „bei Service-Statusaktualisierung erzeugtes Ereignis“ gesetzt ist:<br>0 - Nachricht senden;<br>1 - globales Skript;<br>11 - alle Beteiligten benachrichtigen.<br><br>Mögliche Werte, wenn `eventsource` des [Aktionsobjekts](#action) auf „internes Ereignis“ gesetzt ist:<br>0 - Nachricht senden;<br>11 - alle Beteiligten benachrichtigen.<br><br>[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):<br>- *erforderlich*|
|opcommand|object|Auszuführendes globales Skript.<br><br>Für das globale Skript muss die Eigenschaft `scriptid` definiert sein.<br><br>[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):<br>- *erforderlich*, wenn `operationtype` auf „globales Skript“ gesetzt ist|
|opcommand\_grp|array|Host-Gruppen, auf denen globale Skripte ausgeführt werden sollen.<br><br>Für die Host-Gruppen muss die Eigenschaft `groupid` definiert sein.<br><br>[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):<br>- *erforderlich*, wenn `eventsource` des [Aktionsobjekts](#action) auf „durch einen Auslöser erzeugtes Ereignis“ gesetzt ist, `operationtype` auf „globales Skript“ gesetzt ist und `opcommand_hst` nicht gesetzt ist|
|opcommand\_hst|array|Host, auf dem globale Skripte ausgeführt werden sollen.<br><br>Für die Hosts muss die Eigenschaft `hostid` definiert sein.<br><br>[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):<br>- *erforderlich*, wenn `eventsource` des [Aktionsobjekts](#action) auf „durch einen Auslöser erzeugtes Ereignis“ gesetzt ist, `operationtype` auf „globales Skript“ gesetzt ist und `opcommand_grp` nicht gesetzt ist|
|opmessage|object|Objekt mit den Daten zur von der Wiederherstellungsoperation gesendeten Nachricht.<br><br>Das Operationsnachrichtenobjekt wird [oben ausführlich beschrieben](/manual/api/reference/action/object#action-operation-message).<br><br>[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):<br>- *erforderlich*, wenn `operationtype` auf „Nachricht senden“ gesetzt ist|
|opmessage\_grp|array|Benutzergruppen, an die Nachrichten gesendet werden sollen.<br><br>Für die Benutzergruppen muss die Eigenschaft `usrgrpid` definiert sein.<br><br>[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):<br>- *erforderlich*, wenn `operationtype` auf „Nachricht senden“ gesetzt ist und `opmessage_usr` nicht gesetzt ist|
|opmessage\_usr|array|Benutzer, an die Nachrichten gesendet werden sollen.<br><br>Für die Benutzer muss die Eigenschaft `userid` definiert sein.<br><br>[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):<br>- *erforderlich*, wenn `operationtype` auf „Nachricht senden“ gesetzt ist und `opmessage_grp` nicht gesetzt ist|

[comment]: # ({/fe3a08b5-d1e6762b})

[comment]: # ({37748b62-f41f59ea})
### Aktualisierungsoperation einer Aktion

Das Objekt für die Aktualisierungsoperation einer Aktion definiert eine Operation, die ausgeführt wird, wenn ein Problem aktualisiert wird
(durch Kommentierung, Bestätigung, Änderung des Schweregrads oder manuelles Schließen).
Aktualisierungsoperationen sind **nur** für Auslöser- und Service-Aktionen möglich.
Es hat die folgenden Eigenschaften.

|Eigenschaft|[Type](/manual/api/reference_commentary#data-types)|Beschreibung|
|--|--|------|
|operationtype|integer|Typ der Operation.<br><br>Mögliche Werte:<br>0 - Nachricht senden;<br>1 - globales Skript;<br>12 - alle Beteiligten benachrichtigen.<br><br>[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):<br>- *erforderlich*|
|opcommand|object|Auszuführendes globales Skript.<br><br>Für das globale Skript muss die Eigenschaft `scriptid` definiert sein.<br><br>[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):<br>- *erforderlich*, wenn `operationtype` auf "global script" gesetzt ist|
|opcommand\_grp|array|Host-Gruppen, auf denen globale Skripte ausgeführt werden sollen.<br><br>Für die Host-Gruppen muss die Eigenschaft `groupid` definiert sein.<br><br>[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):<br>- *erforderlich*, wenn `eventsource` des [Action object](#action) auf "event created by a trigger" gesetzt ist, `operationtype` auf "global script" gesetzt ist und `opcommand_hst` nicht gesetzt ist|
|opcommand\_hst|array|Host, auf dem globale Skripte ausgeführt werden sollen.<br><br>Für die Hosts muss die Eigenschaft `hostid` definiert sein.<br><br>[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):<br>- *erforderlich*, wenn `eventsource` des [Action object](#action) auf "event created by a trigger" gesetzt ist, `operationtype` auf "global script" gesetzt ist und `opcommand_grp` nicht gesetzt ist|
|opmessage|object|Objekt mit den Daten zur von der Aktualisierungsoperation gesendeten Nachricht.<br><br>Das Objekt der Operationsnachricht wird [oben ausführlich beschrieben](/manual/api/reference/action/object#action-operation-message).|
|opmessage\_grp|array|Benutzergruppen, an die Nachrichten gesendet werden sollen.<br><br>Für die Benutzergruppen muss die Eigenschaft `usrgrpid` definiert sein.<br><br>[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):<br>- *erforderlich*, wenn `operationtype` auf "send message" gesetzt ist und `opmessage_usr` nicht gesetzt ist|
|opmessage\_usr|array|Benutzer, an die Nachrichten gesendet werden sollen.<br><br>Für die Benutzer muss die Eigenschaft `userid` definiert sein.<br><br>[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):<br>- *erforderlich*, wenn `operationtype` auf "send message" gesetzt ist und `opmessage_grp` nicht gesetzt ist|

[comment]: # ({/37748b62-f41f59ea})

[comment]: # ({aeaafcdb-0d8b3bb1})
### Aktionsfilter

Das Aktionsfilter-Objekt definiert eine Menge von Bedingungen, die erfüllt sein müssen, um die konfigurierten Aktionsoperationen auszuführen. Es hat die folgenden Eigenschaften.

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|conditions|array|Menge von [Filterbedingungen](#action-filter-condition), die zum Filtern der Ergebnisse verwendet werden. Die Bedingungen werden in der Reihenfolge ihrer Platzierung in der Formel sortiert.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *erforderlich*|
|evaltype|integer|[Auswertungsmethode](/manual/config/notifications/action/conditions#type-of-calculation) der Filterbedingungen.<br><br>Mögliche Werte:<br>0 - Und/Oder;<br>1 - Und;<br>2 - Oder;<br>3 - Benutzerdefinierter Ausdruck.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *erforderlich*|
|eval\_formula|string|Generierter Ausdruck, der zur Auswertung der Filterbedingungen verwendet wird. Der Ausdruck enthält IDs, die über `formulaid` auf bestimmte Filterbedingungen verweisen. Der Wert von `eval_formula` entspricht dem Wert von `formula` bei Filtern mit einem benutzerdefinierten Ausdruck.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *schreibgeschützt*|
|formula|string|Benutzerdefinierter Ausdruck, der zur Auswertung der Bedingungen von Filtern mit einem benutzerdefinierten Ausdruck verwendet wird. Der Ausdruck muss IDs enthalten, die über `formulaid` auf bestimmte Filterbedingungen verweisen. Die im Ausdruck verwendeten IDs müssen exakt mit den in den Filterbedingungen definierten IDs übereinstimmen: Keine Bedingung darf ungenutzt bleiben oder ausgelassen werden.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *erforderlich*, wenn `evaltype` auf „custom expression“ gesetzt ist|

[comment]: # ({/aeaafcdb-0d8b3bb1})

[comment]: # ({2cc23997-dd860074})
#### Aktionsfilterbedingung

Das Objekt der Aktionsfilterbedingung definiert eine bestimmte Bedingung, die vor der Ausführung der Aktionsoperationen geprüft werden muss.

|Property|[Type](/manual/api/reference_commentary#data-types)|Beschreibung|
|--|--|------|
|conditiontype|integer|Typ der Bedingung.<br><br>Mögliche Werte, wenn `eventsource` des [Action-Objekts](#action) auf „durch einen Auslöser erzeugtes Ereignis“ gesetzt ist:<br>0 - Host-Gruppe;<br>1 - Host;<br>2 - Auslöser;<br>3 - Ereignisname;<br>4 - Auslöser-Schweregrad;<br>6 - Zeitperiode;<br>13 - Host-Vorlage;<br>16 - Problem ist unterdrückt;<br>25 - Ereignis-Tag;<br>26 - Ereignis-Tag-Wert.<br><br>Mögliche Werte, wenn `eventsource` des [Action-Objekts](#action) auf „durch eine Discovery-Regel erzeugtes Ereignis“ gesetzt ist:<br>7 - Host-IP;<br>8 - Typ des erkannten Dienstes;<br>9 - Port des erkannten Dienstes;<br>10 - Discovery-Status;<br>11 - Dauer der Verfügbarkeit oder Nichtverfügbarkeit;<br>12 - empfangener Wert;<br>18 - Discovery-Regel;<br>19 - Discovery-Prüfung;<br>20 - Proxy;<br>21 - Discovery-Objekt.<br><br>Mögliche Werte, wenn `eventsource` des [Action-Objekts](#action) auf „durch aktive Agent-Autoregistrierung erzeugtes Ereignis“ gesetzt ist:<br>20 - Proxy;<br>22 - Host-Name;<br>24 - Host-Metadaten.<br><br>Mögliche Werte, wenn `eventsource` des [Action-Objekts](#action) auf „internes Ereignis“ gesetzt ist:<br>0 - Host-Gruppe;<br>1 - Host;<br>13 - Host-Vorlage;<br>23 - Ereignistyp;<br>25 - Ereignis-Tag;<br>26 - Ereignis-Tag-Wert.<br><br>Mögliche Werte, wenn `eventsource` des [Action-Objekts](#action) auf „bei Aktualisierung des Service-Status erzeugtes Ereignis“ gesetzt ist:<br>25 - Ereignis-Tag;<br>26 - Ereignis-Tag-Wert;<br>27 - Service;<br>28 - Service-Name.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|value|string|Wert, mit dem verglichen werden soll.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|value2|string|Sekundärer Wert, mit dem verglichen werden soll.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*, wenn `eventsource` des [Action-Objekts](#action) auf „durch einen Auslöser erzeugtes Ereignis“ gesetzt ist, `conditiontype` auf einen beliebigen möglichen Wert für Auslöser-Aktionen gesetzt ist und der Bedingungstyp (siehe unten) „26“ ist<br>- *required*, wenn `eventsource` des [Action-Objekts](#action) auf „internes Ereignis“ gesetzt ist, `conditiontype` auf einen beliebigen möglichen Wert für interne Aktionen gesetzt ist und der Bedingungstyp (siehe unten) „26“ ist<br>- *required*, wenn `eventsource` des [Action-Objekts](#action) auf „bei Aktualisierung des Service-Status erzeugtes Ereignis“ gesetzt ist, `conditiontype` auf einen beliebigen möglichen Wert für Service-Aktionen gesetzt ist und der Bedingungstyp (siehe unten) „26“ ist|
|formulaid|string|Beliebige eindeutige ID, die verwendet wird, um aus einem benutzerdefinierten Ausdruck auf die Bedingung zu verweisen. Darf nur Großbuchstaben enthalten. Die ID muss vom Benutzer beim Ändern von Filterbedingungen definiert werden, wird jedoch bei einer späteren Abfrage erneut generiert.|
|operator|integer|Bedingungs-[Operator](/manual/config/notifications/action/conditions).<br><br>Mögliche Werte:<br>0 - *(default)* gleich;<br>1 - ungleich;<br>2 - enthält;<br>3 - enthält nicht;<br>4 - in;<br>5 - ist größer oder gleich;<br>6 - ist kleiner oder gleich;<br>7 - nicht in;<br>8 - entspricht;<br>9 - entspricht nicht;<br>10 - Ja;<br>11 - Nein.|

::: notetip
Um besser zu verstehen, wie Filter mit verschiedenen Ausdruckstypen verwendet werden, siehe die Beispiele auf den Methodenseiten
[action.get](get#retrieve-discovery-actions) und
[action.create](create#using-a-custom-expression-filter).
:::

Die folgenden Operatoren und Werte werden für jeden Bedingungstyp unterstützt.

|Condition|Condition name|Supported operators|Expected value|
|-|--|--|------|
|0|Host-Gruppe|gleich,<br>ungleich|ID der Host-Gruppe.|
|1|Host|gleich,<br>ungleich|Host-ID.|
|2|Auslöser|gleich,<br>ungleich|Auslöser-ID.|
|3|Ereignisname|enthält,<br>enthält nicht|Ereignisname.|
|4|Auslöser-Schweregrad|gleich,<br>ungleich,<br>ist größer oder gleich,<br>ist kleiner oder gleich|Auslöser-Schweregrad. Eine Liste der unterstützten Auslöser-Schweregrade finden Sie in der [trigger-Property `severity`](/manual/api/reference/trigger/object#trigger).|
|5|Auslöser-Wert|gleich|Auslöser-Wert. Eine Liste der unterstützten Auslöser-Werte finden Sie in der [trigger-Property `value`](/manual/api/reference/trigger/object#trigger).|
|6|Zeitperiode|in, nicht in|Zeitpunkt, zu dem das Ereignis ausgelöst wurde, als [Zeitperiode](/manual/appendix/time_period).|
|7|Host-IP|gleich,<br>ungleich|Ein oder mehrere zu prüfende IP-Bereiche, durch Kommas getrennt. Weitere Informationen zu unterstützten Formaten von IP-Bereichen finden Sie im Abschnitt [Konfiguration der Netzwerk-Discovery](/manual/discovery/network_discovery/rule).|
|8|Typ des erkannten Dienstes|gleich,<br>ungleich|Typ des erkannten Dienstes. Der Diensttyp entspricht dem Typ der Discovery-Prüfung, die zur Erkennung des Dienstes verwendet wurde. Eine Liste der unterstützten Typen finden Sie in der [discovery check-Property `type`](/manual/api/reference/dcheck/object#discovery-check).|
|9|Port des erkannten Dienstes|gleich,<br>ungleich|Ein oder mehrere Port-Bereiche, durch Kommas getrennt.|
|10|Discovery-Status|gleich|Status eines erkannten Objekts.<br><br>Mögliche Werte:<br>0 - Host oder Dienst verfügbar;<br>1 - Host oder Dienst nicht verfügbar;<br>2 - Host oder Dienst erkannt;<br>3 - Host oder Dienst verloren.|
|11|Dauer der Verfügbarkeit oder Nichtverfügbarkeit|ist größer oder gleich,<br>ist kleiner oder gleich|Zeit in Sekunden, die angibt, wie lange sich das erkannte Objekt bereits im aktuellen Status befindet.|
|12|Empfangene Werte|gleich,<br>ungleich,<br>ist größer oder gleich,<br>ist kleiner oder gleich,<br>enthält,<br>enthält nicht|Wert, der bei der Durchführung einer Zabbix-Agent-, SNMPv1-, SNMPv2- oder SNMPv3-Discovery-Prüfung zurückgegeben wird.|
|13|Host-Vorlage|gleich,<br>ungleich|ID der verknüpften Vorlage.|
|16|Problem ist unterdrückt|Ja, Nein|Kein Wert erforderlich: Die Verwendung des Operators „Ja“ bedeutet, dass das Problem unterdrückt sein muss, „Nein“ bedeutet nicht unterdrückt.|
|18|Discovery-Regel|gleich,<br>ungleich|ID der Discovery-Regel.|
|19|Discovery-Prüfung|gleich,<br>ungleich|ID der Discovery-Prüfung.|
|20|Proxy|gleich,<br>ungleich|ID des Proxy.|
|21|Discovery-Objekt|gleich|Typ des Objekts, das das Discovery-Ereignis ausgelöst hat.<br><br>Mögliche Werte:<br>1 - erkannter Host;<br>2 - erkannter Dienst.|
|22|Host-Name|enthält,<br>enthält nicht,<br>entspricht,<br>entspricht nicht|Host-Name.<br>Die Verwendung eines regulären Ausdrucks wird für die Operatoren *entspricht* und *entspricht nicht* in Autoregistrierungsbedingungen unterstützt.|
|23|Ereignistyp|gleich|Bestimmtes internes Ereignis.<br><br>Mögliche Werte:<br>0 - Datenpunkt im Zustand „nicht unterstützt“;<br>1 - Datenpunkt im Zustand „normal“;<br>2 - LLD-Regel im Zustand „nicht unterstützt“;<br>3 - LLD-Regel im Zustand „normal“;<br>4 - Auslöser im Zustand „unbekannt“;<br>5 - Auslöser im Zustand „normal“.|
|24|Host-Metadaten|enthält,<br>enthält nicht,<br>entspricht,<br>entspricht nicht|Metadaten des automatisch registrierten Hosts.<br>Die Verwendung eines regulären Ausdrucks wird für die Operatoren *entspricht* und *entspricht nicht* unterstützt.|
|25|Tag|gleich,<br>ungleich,<br>enthält,<br>enthält nicht|Ereignis-Tag.|
|26|Tag-Wert|gleich,<br>ungleich,<br>enthält,<br>enthält nicht|Ereignis-Tag-Wert.|
|27|Service|gleich,<br>ungleich|Service-ID.|
|28|Service-Name|gleich,<br>ungleich|Service-Name.|

[comment]: # ({/2cc23997-dd860074})
