Erstellen Sie eine EMS-Benachrichtigung
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.
Dieser REST-API-Aufruf verwendet die folgende Methode und den folgenden Endpunkt.
HTTP-Methode | Pfad |
---|---|
PATCH |
/API/Support/ems |
Synchron
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 |
Mail_Server |
Abfrage |
Ja. |
Konfiguriert den Ziel-SMTP-Mailserver. |
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.
Dieser REST-API-Aufruf verwendet die folgende Methode und den folgenden Endpunkt.
HTTP-Methode | Pfad |
---|---|
POST |
/API/Support/ems/Filter |
Synchron
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. |
curl --request POST \
--location "https://$FQDN_IP/api/support/ems/filters" \
--include \
--header "Accept: */*" \
--header "Authorization: Basic $BASIC_AUTH" \
--data @JSONinput
{
"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.
Dieser REST-API-Aufruf verwendet die folgende Methode und den folgenden Endpunkt.
HTTP-Methode | Pfad |
---|---|
POST |
/API/Support/ems/Destinations |
Synchron
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. |
curl --request POST \
--location "https://$FQDN_IP/api/support/ems/destinations" \
--include \
--header "Accept: */*" \
--header "Authorization: Basic $BASIC_AUTH" \
--data @JSONinput
{
"name": "test-destination",
"type": "email",
"destination": "administrator@mycompany.com",
"filters.name": ["important-events"]
}