Sie können einen Watcher registrieren, der Benachrichtigungen basierend auf bestimmten Kriterien erhält.
Um einen Watcher zu registrieren, können Sie die folgende API aufrufen.
POST /api/v1/notification-watcher
Nach dem Hinzufügen eines Watchers müssen Sie eine „notification_id“ (feature_name.notification_name) bei einer „watcher_id“ registrieren und Benachrichtigungen angeben, die der Watcher erhalten soll. Beachten Sie, dass der Watcher ohne die Registrierung keine Benachrichtigungen erhält. Rufen Sie die folgenden APIs mit den erforderlichen Anforderungsparametern auf, um „notification_id“ zu registrieren und Benachrichtigungen anzugeben. Weitere Informationen zu NSX-T Data Center-Benachrichtigungs-APIs finden Sie unter Handbuch für die NSX-T Data Center-API.
PUT /api/v1/notification-watchers/<watcher-id>
POST /api/v1/notification-watchers/<watcher-id>/notifications?action=add_uri_filters
mit den folgenden Anforderungsparametern:- notification_id: Eine Zeichenfolge, die „feature_name.notification_name“ identifiziert, um eine Benachrichtigung anzugeben, die Watcher für die durch „feature_name.notification_name“ identifizierte URI erhalten möchte.
- uri_filters: Optionale Liste der URIs zum Filtern von Benachrichtigungen basierend auf ihrem Richtlinienpfad. Wenn Sie „uri_filters“ angeben, können Sie anstelle eines bestimmten Werts auch * als Platzhalterzeichen verwenden.
Wenn „notification_id“ beispielsweise „group.change_name“ ist, lautet das „uri_filter“-Muster „/policy/api/v1/infra/domains/<domain>/groups/<group>“. Sie können das Muster als „/policy/api/v1/infra/domains/domain1/groups/group2“ angeben, um Benachrichtigungen speziell für Domäne1 und Gruppe2 abzurufen. Alternativ können Sie auch das Muster „/policy/api/v1/infra/domains/domain2/groups/*“ angeben, um Benachrichtigungen für alle Gruppen in Domäne2 abzurufen, oder als „/policy/api/v1/infra/domains/*/groups/*“, um Benachrichtigungen für alle Gruppen in allen Domänen zu erhalten.
Funktionsname | Funktionsbeschreibung | Benachrichtigungsname | Benachrichtigungsbeschreibung | URI |
---|---|---|---|---|
group | Von der NS-Gruppenfunktion unterstützte Benachrichtigungen. | change_notification | Gruppenbenachrichtigung, „<domain>“ identifiziert den Domänennamen und „<group>“ identifiziert den Gruppennamen. | /policy/api/v1/infra/domains/<domain>/groups/<group> |
monitoring | Von der Überwachungsfunktion unterstützte Benachrichtigungen. | alarm | Alarmbenachrichtigungen. „<alarm-id>“ identifiziert eine Alarminstanz. Eine Benachrichtigung wird gesendet, sobald eine Alarminstanz erstellt oder gelöscht wird und wenn die Alarminstanz aktualisiert wird. | /api/v1/alarms/<alarm-id> |
alarm_status_change_notification | Alarmbenachrichtigungen. „<alarm-id>“ identifiziert eine Alarminstanz. Eine Benachrichtigung wird gesendet, wenn eine Alarminstanz erstellt wird und wenn der Statuseigenschaftswert einer Alarminstanz aktualisiert wird. | /api/v1/alarms/<alarm-id> | ||
notification | Vom Benachrichtigungs-Framework unterstützte Benachrichtigungen. |
watcher | Plattformbenachrichtigung zur Übermittlung von Updates für die Watcher-Konfiguration. „<watcher-id>“ identifiziert den Watcher. | /api/v1/notification-watchers/<watcher-id> |
watcher_notification | Plattformbenachrichtigung zur Übermittlung von Updates für Benachrichtigungen. „<watcher-id>“ identifiziert den Watcher. | /api/v1/notification-watchers/<watcher-id>/notifications | ||
service_config | Von der Dienstkonfigurationsfunktion unterstützte Benachrichtigungen. | change_notification | Benachrichtigung zur Dienstkonfiguration. „<domain>“ identifiziert den Domänennamen, „<policy>“ identifiziert die Endpoint-Richtlinie und „<rule>“ identifiziert die Endpoint-Regel. Diese Benachrichtigung wird generiert, wenn eine in der Endpoint-Regel verwendete Dienstkonfiguration aktualisiert wird oder wenn das UPM-Profil aktualisiert wird. | /policy/api/v1/infra/domains/<domain>/endpoint-policies/<policy>/endpoint-rules/<rule> |
service_insertion | Vom Service Insertion-Modul unterstützte Benachrichtigungen. Derzeit unterstützt das Service Insertion-Modul Benachrichtigungen für Dienstprofil, Laufzeit der Dienstinstanz und Richtliniengruppen. |
instance_runtime_notification | Laufzeitbenachrichtigung der Dienstinstanz. „<service-id>“ identifiziert den Dienst, „<service-instance-id>“ identifiziert die Dienstinstanz. Die Benachrichtigung wird für bereitgestellte und nicht bereitgestellte Vorgänge gesendet. | /api/v1/serviceinsertion/services/<service-id>/service-instances/<service-instance-id>/instance-runtimes |
profile_notification | Benachrichtigung zur Änderung des Dienstprofils. „<service-reference>“ identifiziert den Dienstnamen und „<service-profile>“ identifiziert den Profilnamen. Die Benachrichtigung wird für das Erstellen, Aktualisieren und Löschen von Profilen gesendet. | /policy/api/v1/infra/service-references/<service-reference>/service-profiles/<service-profile> | ||
profile_chain_mapping_notification | Benachrichtigung über die Zuordnung der Dienstprofilkette. „<service-reference>“ identifiziert den Dienstnamen und „<service-profile>“ identifiziert den Profilnamen. Die Benachrichtigung wird gesendet, wenn ein Profil als Teil einer Dienstkette hinzugefügt oder entfernt wird. | /policy/api/v1/infra/service-references/<service-reference>/service-profiles/<service-profile>/service-chain-mappings | ||
profile_nsgroups_notification | Benachrichtigung zu Dienstprofil-NSGroups. „<service-reference>“ identifiziert den Dienstnamen und „<service-profile>“ identifiziert den Profilnamen. Diese Benachrichtigung wird immer dann ausgelöst, wenn eine Ost-West-Regel, die nsgroups enthält, mit dem jeweiligen Profil hinzugefügt oder gelöscht wird. | /policy/api/v1/infra/service-references/<service-reference>/service-profiles/<service-profile>/group-associations | ||
instance_nsgroups_notification | Benachrichtigung zu Dienstinstanz-NSGroups. „<service-id>“ identifiziert den Dienstnamen und „<service-instance-id>“ identifiziert die Dienstinstanz. Diese Benachrichtigung wird immer dann ausgelöst, wenn eine Nord-Süd-Regel, die „nsgroups“ enthält, mit der jeweiligen Instanz hinzugefügt oder gelöscht wird. | /api/v1/serviceinsertion/services/<service-id>/service-instances/<service-instance-id>/group-associations |