Creare una notifica EMS
È possibile utilizzare il seguente flusso di lavoro per creare una nuova destinazione di notifica EMS per ricevere i messaggi di evento selezionati.
Passaggio 1: Configurare le impostazioni di posta elettronica a livello di sistema
È possibile effettuare la seguente chiamata API per configurare le impostazioni e-mail a livello di sistema.
Questa chiamata API REST utilizza il metodo e l'endpoint seguenti.
Metodo HTTP | Percorso |
---|---|
PATCH |
/api/support/ems |
Sincrono
Oltre ai parametri comuni a tutte le chiamate API REST, negli esempi di curl vengono utilizzati anche i seguenti parametri.
Parametro | Tipo | Obbligatorio | Descrizione |
---|---|---|---|
mail_from |
Query |
Sì |
Imposta |
mail_server |
Query |
Sì |
Consente di configurare il server di posta SMTP di destinazione. |
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"
Passo 2: Definizione di un filtro dei messaggi
È possibile effettuare una chiamata API per definire una regola di filtro corrispondente ai messaggi.
Questa chiamata API REST utilizza il metodo e l'endpoint seguenti.
Metodo HTTP | Percorso |
---|---|
POST |
/api/support/ems/filters |
Sincrono
Oltre ai parametri comuni a tutte le chiamate API REST, negli esempi di curl vengono utilizzati anche i seguenti parametri.
Parametro | Tipo | Obbligatorio | Descrizione |
---|---|---|---|
Filtro |
Corpo |
Sì |
Include i valori per la configurazione del filtro. |
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"]
}
Passo 3: Creazione di una destinazione di messaggio
È possibile effettuare una chiamata API per creare una destinazione del messaggio.
Questa chiamata API REST utilizza il metodo e l'endpoint seguenti.
Metodo HTTP | Percorso |
---|---|
POST |
/api/support/ems/destinations |
Sincrono
Oltre ai parametri comuni a tutte le chiamate API REST, negli esempi di curl vengono utilizzati anche i seguenti parametri.
Parametro | Tipo | Obbligatorio | Descrizione |
---|---|---|---|
Configurazione destinazione |
Corpo |
Sì |
Include i valori per la destinazione dell'evento. |
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"]
}