Skip to main content
Die deutsche Sprachversion wurde als Serviceleistung für Sie durch maschinelle Übersetzung erstellt. Bei eventuellen Unstimmigkeiten hat die englische Sprachversion Vorrang.

Erstellen Sie eine EMS-Benachrichtigung

Beitragende

Sie können den folgenden Workflow verwenden, um ein neues EMS-Benachrichtigungsziel für den Empfang ausgewählter Ereignismeldungen zu erstellen.

Schritt 1: Konfigurieren Sie die systemweiten E-Mail-Einstellungen

Sie können den folgenden API-Aufruf durchführen, um die systemweiten E-Mail-Einstellungen zu konfigurieren.

HTTP-Methode und -Endpunkt

Dieser REST-API-Aufruf verwendet die folgende Methode und den folgenden Endpunkt.

HTTP-Methode Pfad

PATCH

/API/Support/ems
Verarbeitungsart

Synchron

Zusätzliche Eingabeparameter für die Curl-Beispiele

Zusätzlich zu den Parametern, die bei allen REST-API-Aufrufen üblich sind, werden die folgenden Parameter auch in den Curl-Beispielen für diesen Schritt verwendet.

Parameter Typ Erforderlich Beschreibung

Mail_von

Abfrage

Ja.

Legt den fest from In den Benachrichtigungs-E-Mail-Nachrichten.

Mail_Server

Abfrage

Ja.

Konfiguriert den Ziel-SMTP-Mailserver.
Beispiel für die Wellung
curl --request PATCH \
--location "https://$FQDN_IP/api/support/ems?mail_from=administrator@mycompany.com&mail_server=mail@mycompany.com" \
--include \
--header "Accept: */*" \
--header "Authorization: Basic $BASIC_AUTH"

Schritt 2: Definieren Sie einen Nachrichtenfilter

Sie können einen API-Aufruf ausgeben, um eine Filterregel zu definieren, die den Nachrichten entspricht.

HTTP-Methode und -Endpunkt

Dieser REST-API-Aufruf verwendet die folgende Methode und den folgenden Endpunkt.

HTTP-Methode Pfad

POST

/API/Support/ems/Filter
Verarbeitungsart

Synchron

Zusätzliche Eingabeparameter für die Curl-Beispiele

Zusätzlich zu den Parametern, die bei allen REST-API-Aufrufen üblich sind, werden die folgenden Parameter auch in den Curl-Beispielen für diesen Schritt verwendet.

Parameter Typ Erforderlich Beschreibung

Filtern

Text

Ja.

Enthält die Werte für die Filterkonfiguration.
Beispiel für die Wellung
curl --request POST \
--location "https://$FQDN_IP/api/support/ems/filters" \
--include \
--header "Accept: */*" \
--header "Authorization: Basic $BASIC_AUTH" \
--data @JSONinput
JSON-Eingabebeispiel
{
  "name": "test-filter",
  "rules.type": ["include"],
  "rules.message_criteria.severities": ["emergency"]
}

Schritt 3: Erstellen Sie ein Nachrichtenziel

Sie können einen API-Aufruf ausgeben, um ein Nachrichtenziel zu erstellen.

HTTP-Methode und -Endpunkt

Dieser REST-API-Aufruf verwendet die folgende Methode und den folgenden Endpunkt.

HTTP-Methode Pfad

POST

/API/Support/ems/Destinations
Verarbeitungsart

Synchron

Zusätzliche Eingabeparameter für die Curl-Beispiele

Zusätzlich zu den Parametern, die bei allen REST-API-Aufrufen üblich sind, werden die folgenden Parameter auch in den Curl-Beispielen für diesen Schritt verwendet.

Parameter Typ Erforderlich Beschreibung

Zielkonfiguration

Text

Ja.

Enthält die Werte für das Ereignisziel.
Beispiel für die Wellung
curl --request POST \
--location "https://$FQDN_IP/api/support/ems/destinations" \
--include \
--header "Accept: */*" \
--header "Authorization: Basic $BASIC_AUTH" \
--data @JSONinput
JSON-Eingabebeispiel
{
  "name": "test-destination",
  "type": "email",
  "destination": "administrator@mycompany.com",
  "filters.name": ["important-events"]
}