Abonnement der Verteilerliste beenden

Um die Subskription der Verteilerliste aufzuheben, verwenden Sie den Link in der Fußzeile einer beliebigen E-Mail, die von der Verteilerliste gesendet wird.

Ereignisse für Benachrichtigungen

In der folgenden Tabelle sind die Ereignistypen aufgeführt, die der Benachrichtigungsdienst an Event Notifications sendet:

Hinzufügen einer Instanz von Event Notifications zur Verteilerliste für Benachrichtigungen

Bevor Sie eine Instanz von Event Notifications zur Verteilerliste für Benachrichtigungen hinzufügen können, müssen Sie sicherstellen, dass Sie bereits eine Instanz des Dienstes Event Notifications haben, die sich im selben Konto wie die Verteilerliste befindet. Wenn Sie keine Event Notifications Service-Instanz haben, siehe Erste Schritte mit Event Notifications. Führen Sie die folgenden Schritte aus, um eine vorhandene Event Notifications Dienstinstanz zur Benachrichtigungsverteilerliste hinzuzufügen:

1. Verwenden Sie die IBM Cloud-Konsole, wechseln Sie zu Verwalten > Konto > Benachrichtigungsverteilerliste.
2. Klicken Sie auf Hinzufügen > Event Notifications.
3. Wählen Sie eine Event Notifications Service-Instanz aus der Event Notifications Instanzliste aus. Wenn Sie nicht über eine Event Notifications Service-Instanz verfügen, die Sie mit Ihrem Konto verbinden können, können Sie eine im IBM Cloud Katalog erstellen.
4. Klicken Sie auf Hinzufügen.

Sie können keine Event Notifications Dienstinstanz zu einer bereits konfigurierten Benachrichtigungsverteilerliste hinzufügen.

Senden von Testbenachrichtigungen an eine Event Notifications-Instanz

Nachdem Sie eine Event Notifications Instanz zu Ihrer Benachrichtigungsverteilerliste hinzugefügt haben, können Sie testen, ob die vom Benachrichtigungsdienst erzeugten Ereignisse an diese Instanz weitergeleitet werden.

Führen Sie die folgenden Schritte aus, um eine Testmeldung an eine Instanz von Event Notifications zu senden:

1. Gehen Sie in der Konsole IBM Cloud auf Verwalten > Konto > Verteilerliste für Benachrichtigungen.
2. Wählen Sie die Instanz Event Notifications, an die Sie eine Testbenachrichtigung senden möchten, und klicken Sie auf das Symbol Aktionen > Test.
3. Wählen Sie den Ereignistyp aus, den Sie testen möchten, und klicken Sie dann auf Test senden.
   1. Wenn Sie die Testbenachrichtigung erneut senden möchten, klicken Sie auf Test erneut senden.

Details der Benachrichtigungsnutzdaten

Wenn eine Event Notifications Instanz zur Verteilerliste Ihres Kontos hinzugefügt wird und das Konto eine Benachrichtigung erhält, wird eine Benachrichtigungs-Nutzlast an diese Event Notifications Instanz gesendet. Die Eigenschaften des Payload-Objekts sind für alle Ereignistypen gleich. Siehe das folgende Payload-Beispiel, das detaillierte Informationen über ein Wartungsereignis zum Senden einer Testmeldung enthält:

{
   "instanceId": "12345678-abcd-1234-efgh-1234567890ab",
   "id": "CHG1234567",
   "source": "crn:v1:bluemix:public:notificationapi::a/<scope>:12345678-abcd-1234-efgh-1234567890ab::",
   "ibmenseverity": "high_impact",
   "severity": "high_impact",
   "ibmensourceid": "crn:v1:bluemix:public:notificationapi::a/<scope>:12345678-abcd-1234-efgh-1234567890ab::",
   "type": "com.ibm.cloud.notificationapi.maintenance",
   "time": "2025-10-08T18:31:09.363Z",
   "ibmendefaultshort": "Maintenance - High Impact: this is a maintenance test notif",
   "ibmendefaultlong": "this is a maintenance test notif \n \nSource ID: CHG1234567 \nType: Maintenance \nSeverity: High Impact \nStart Time: 23 Oct 2025, 7:09 PM UTC \nEnd Time: 24 Oct 2025, 7:09 PM UTC \nUpdate Time: 21 Oct 2025, 2:52 AM UTC \n\nthis is the body text and sev = 1\n\nThis is a test email, please disregard\n\n\n",
   "ibmensmstext": "Maintenance - High Impact: this is a maintenance test notif \nSource ID: CHG2755299 \nCategory: Maintenance \nSeverity: High Impact \n",
   "ibmensubject": "Maintenance - High Impact: this is a maintenance test notif",
   "ibmenhtmlbody": "<div> this is a maintenance test notif</div></br><div><div><b>Source ID:</b> CHG2755299</div><div><b>Type:</b> Maintenance</div><div><b>Severity:</b> High Impact</div><div><b>Start Time:</b> 23 Oct 2025, 7:09 PM UTC</div><div><b>End Time:</b> 24 Oct 2025, 7:09 PM UTC</div><div><b>Update Time:</b> 21 Oct 2025, 2:52 AM UTC</div></br>this is the body text and sev = 1</br></div><div></br><b>This is a test email, please disregard</b></br><div>",
   "specversion": "1.0",
   "datacontenttype": "application/json",
   "data": {
       "sourceID": "CHG1234567",
       "category": "maintenance",
       "severity": 1,
       "crnMasks": [],
       "startTime": "1761246551",
       "endTime": "1761332951",
       "title": [
           {
               "language": "en",
               "text": "this is a maintenance test notif"
           }
       ],
       "body": [
           {
               "content-type": "text/html",
               "language": "en",
               "text": "this is the body text and sev = 1"
           }
       ]
   }
}

In der folgenden Tabelle finden Sie weitere Informationen zu den Eigenschaften der Nutzlast der Meldung für Event Notifications.

Event Notifications-Instanz löschen

Sie können jede Instanz von Event Notifications löschen, die Sie der Benachrichtigungsliste hinzugefügt haben, indem Sie die folgenden Schritte ausführen:

1. Wählen Sie die Event Notifications Service-Instanz aus, die Sie aus der Benachrichtigungsverteilerliste löschen möchten, und klicken Sie auf das Symbol Aktionen .
2. Klicken Sie auf Löschen.

Kopfzeilen

Sie erhalten die Payload mit einem Header, den Sie in der Benutzeroberfläche konfiguriert haben, als Sie einen Webhook hinzugefügt haben, und mit einem zusätzlichen Versions-Header, der eine semantische Versionsnummer enthält. Dieser Versionsheader kann verwendet werden, um das erwartete Format der Webhook-Nutzdaten zu bestimmen.

Der aktuelle Header der Version ist "IBM-Notifications-API-Version": "v2.0.0".

Feldwerte

Die folgenden Beschreibungen enthalten Informationen zu den Feldwerten, die innerhalb der Nutzdaten gesendet werden:

body: Dieses Feld beschreibt das Ereignis, das auf der Plattform stattfindet, und betrifft Sie. Dieses Feld enthält eine detaillierte, benutzerlesbare Beschreibung der Benachrichtigung und kann mehrere Absätze lang sein. Es kann auch HTML-Formatierung enthalten. Dieses Feld ist so konfiguriert, dass mehrere Sprachen unterstützt werden, derzeit wird jedoch nur Englisch unterstützt.

category: Der Typ des Ereignisses. Mögliche Werte sind: incident (Vorfall), maintenance (Wartung), announcement (Ankündigung) und security bulletins (Sicherheitsbulletins).

componentNames: Wenn ein Service betroffen ist, wird dies in diesem Feld dargestellt. Dabei kann es sich auch um einen globalen Wert wie Component: IBM Cloud handeln, nicht nur um einen bestimmten Dienst. Siehe die Dienste auf der Katalogseite IBM Cloud.

regions: Dieses Feld zeigt die Position des Ereignisses an.

severity: Dieses Feld bezieht sich auf den Schweregrad des Ereignisses. Die Prioritätsstufe für Vorfälle kann 1, 2, 3 oder 4 sein, für Wartung high (Hoch), medium (Mittel) oder low (Niedrig) und für Ankündigungen major (Schwerwiegend) oder minor (Geringfügig). Ausführliche Beschreibungen der Bewertungsstufen finden Sie in den folgenden Beschreibungen:

* **Incidents**
  * `Severity 1`: Business-critical functionality is inoperable or critical interference failed. This severity usually applies to the production environment and the inability to access services is causing a critical impact on operations.
  * `Severity 2`: Core functionality is impacted. Service is operational but causing major impact on usage.
  * `Severity 3`: Partial or noncritical disruption to functionality with minimal or isolated impact.
  * `Severity 4`: A minor issue that requires action, but does not impact functionality or usage.
* **Maintenance**
  * `High impact`: Maintenance will, or is likely to cause service outages and disruptions.
  * `Medium impact`: Maintenance will, or is likely to cause measurable service degradation but not an actual outage.
  * `Low impact`: Maintenance will cause no service disruption during or after the maintenance window.
* **Announcements**
  * `Major`: Important incidents such as legal notices, service deprecation, or security patches.
  * `Minor`: Informative announcements such as product enhancements.

Das Attribut "severity" in der Nutzlast der Anfrage kann den Wert 0, 1, 2, 3 oder 4 annehmen. In der folgenden Tabelle sind die Schweregrade und die entsprechenden Klassifizierungen aufgeführt:

state: Dieses Feld ist nur für Wartung und Benachrichtigungen verfügbar. Sehen Sie sich die folgenden möglichen Werte an:

* Values for *Maintenance* states: Planned, In progress, Completed, Canceled, Failed
* Values for *Incident* states: New issue, Investigating, Resolved

title: Das Titelfeld teilt Ihnen mit, worum es bei der Benachrichtigung geht. Dieses Feld ist so konfiguriert, dass mehrere Sprachen unterstützt werden, derzeit wird jedoch nur Englisch unterstützt.

startTime, endTime: Sie können überprüfen, wann das Ereignis beginnt und wann es endet.

Die Felder startTime und endTime zeigen die Startzeit und die Endzeit des Ereignisses in Unix-Zeitmarken für die koordinierte Weltzeit an.

Felder, die innerhalb der Nutzdaten gesendet werden, können entweder erforderlich oder optional sein. Optionale Felder, z. B. startTime, werden übergeben, wenn die Benachrichtigung über diesen Informationstyp verfügt, und werden nicht übergeben, wenn die Benachrichtigung nicht über diesen Informationstyp verfügt. Erforderliche Felder, z. B. category, werden in jedem Fall übergeben. In der folgenden Tabelle ist aufgeführt, welche Felder erforderlich sind und welche optional:

In Zukunft können weitere Felder hinzugefügt werden, ohne dass eine größere Versionsänderung erforderlich ist. Dies bedeutet, dass jeder Code, der Benachrichtigungen verarbeitet, darauf vorbereitet sein sollte, die Felder zu ignorieren, die er nicht erkennt.

Senden von Testbenachrichtigungen an einen Webhook

Nachdem Sie mit den obigen Schritten einen Webhook konfiguriert haben, können Sie ihn ohne auf einfache Weise testen. Senden Sie eine Testbenachrichtigung an Ihren Webhook und vergewissern Sie sich, dass Ihre Webhook-Integration ordnungsgemäß funktioniert und die Benachrichtigung empfängt.

Führen Sie zum Senden einer Testbenachrichtigung an einen Webhook die folgenden Schritte aus:

1. Rufen Sie in der IBM Cloud-Konsole Verwalten > Konto > Benachrichtigungsverteilerliste auf.
2. Wählen Sie den Webhook aus, an den Sie eine Testbenachrichtigung senden möchten, und klicken auf das Symbol Aktionen .
3. Klicken Sie auf Testen > Test senden.
4. Wenn Sie die Testbenachrichtigung erneut senden möchten, klicken Sie auf Test erneut senden.