È possibile registrare un watcher che riceverà notifiche in base a criteri specifici.

Per registrare un watcher, è possibile richiamare la seguente API.

POST /api/v1/notification-watcher

Dopo aver aggiunto un watcher, è necessario registrare un notification_id (feature_name.notification_name) con un watcher_id e specificare le notifiche che il watcher deve ricevere. Tenere presente che senza la registrazione il watcher non riceverà alcuna notifica. Richiamare le API seguenti con i parametri di richiesta necessari per registrare notification_id e specificare le notifiche. Per ulteriori informazioni sulle API di notifica di NSX, vedere Guida di NSX API.

  • PUT /api/v1/notification-watchers/<watcher-id>
  • POST /api/v1/notification-watchers/<watcher-id>/notifications?action=add_uri_filters con i seguenti parametri di richiesta:
    • notification_id: una stringa che identifica feature_name.notification_name per indicare una notifica che il watcher è interessato a ricevere per l'URI identificato da feature_name.notification_name.
    • uri_filters: elenco facoltativo di URI per filtrare le notifiche in base al percorso criteri. Quando si specifica uri_filters, è inoltre possibile utilizzare * come carattere jolly anziché un valore specifico.

      Ad esempio, se notification_id è group.change_name, il modello di uri_filter è /policy/api/v1/infra/domains/<domain>/groups/<group>. È possibile specificare il modello come /policy/api/v1/infra/domains/domain1/groups/group2 per ricevere notifiche specifiche di domain1 e group2. In alternativa, è anche possibile specificare il modello /policy/api/v1/infra/domains/domain2/groups/* per ricevere notifiche per tutti i gruppi in domain2 o specificarlo come /policy/api/v1/infra/domains/*/groups/* per ricevere notifiche per tutti i gruppi in tutti i domini.

Nella tabella seguente sono elencati i nomi delle funzionalità e i rispettivi URI.
Nome funzionalità Descrizione funzionalità Nome notifica Descrizione notifica URI
gruppo Notifiche supportate dalla funzionalità NSGroup. change_notification Notifica del gruppo, <domain> identifica il nome del dominio e <group> identifica il nome del gruppo. /policy/api/v1/infra/domains/<domain>/groups/<group>
monitoraggio Notifiche supportate dalla funzionalità di monitoraggio. avviso Notifiche di avviso. <alarm-id> identifica un'istanza di avviso. Una notifica viene inviata ogni volta che viene creata o eliminata un'istanza di avviso e quando l'istanza dell'avviso viene aggiornata. /api/v1/alarms/<alarm-id>
alarm_status_change_notification Notifiche di avviso. <alarm-id> identifica un'istanza di avviso. Una notifica viene inviata ogni volta che viene creata un'istanza di un avviso e quando il valore della proprietà dello stato di un'istanza di avviso viene aggiornato. /api/v1/alarms/<alarm-id>
notifica

Notifiche supportate dal framework di notifica.

 watcher Notifica della piattaforma per trasmettere gli aggiornamenti alla configurazione del watcher. <watcher-id> identifica il watcher. /api/v1/notification-watchers/<watcher-id>
watcher_notification Notifica della piattaforma per trasmettere gli aggiornamenti alle notifiche. <watcher-id> identifica il watcher. /api/v1/notification-watchers/<watcher-id>/notifications
service_config Notifiche supportate dalla funzionalità Configurazione servizio. change_notification Notifica della configurazione del servizio. <domain> identifica il nome del dominio, <policy> identifica il criterio dell'endpoint e <rule> identifica la regola dell'endpoint. Questa notifica viene generata quando viene aggiornata una configurazione del servizio utilizzata nella regola dell'endpoint o quando viene aggiornato il profilo UPM. /policy/api/v1/infra/domains/<domain>/endpoint-policies/<policy>/endpoint-rules/<rule>
service_insertion

Notifiche supportate dal modulo Inserimento del servizio.

Il modulo Inserimento del servizio supporta attualmente le notifiche per il profilo del servizio, il runtime dell'istanza di servizio e i gruppi di criteri.

 instance_runtime_notification Notifica di runtime dell'istanza di servizio. <service-id> identifica il servizio, <service-instance-id>identifica l'istanza del servizio. Le notifiche verranno inviate per le operazioni distribuite e non distribuite. /api/v1/serviceinsertion/services/<service-id>/service-instances/<service-instance-id>/instance-runtimes
profile_notification Notifica di modifica del profilo del servizio. <service-reference> identifica il nome del servizio e <service-profile> identifica il nome del profilo. Le notifiche verranno inviate per la creazione, l'aggiornamento o l'eliminazione del profilo. /policy/api/v1/infra/service-references/<service-reference>/service-profiles/<service-profile>
profile_chain_mapping_notification Notifica della mappatura della catena di profili di servizio. <service-reference> identifica il nome del servizio e <service-profile> identifica il nome del profilo. La notifica verrà inviata quando un profilo viene aggiunto o rimosso come parte di una catena di servizi. /policy/api/v1/infra/service-references/<service-reference>/service-profiles/<service-profile>/service-chain-mappings
profile_nsgroups_notification Notifica NSGroup del profilo del servizio. <service-reference> identifica il nome del servizio e <service-profile> identifica il nome del profilo. Questa notifica viene attivata ogni volta che una regola est-ovest contenente nsgroup viene aggiunta o eliminata con il profilo specifico. /policy/api/v1/infra/service-references/<service-reference>/service-profiles/<service-profile>/group-associations
instance_nsgroups_notification Notifica NSGroups dell'istanza di servizio. <service-id> identifica il nome del servizio e <service-instance-id> identifica l'istanza di servizio. Questa notifica viene attivata ogni volta che una regola nord-sud contenente nsgroup viene aggiunta o eliminata con l'istanza specifica. /api/v1/serviceinsertion/services/<service-id>/service-instances/<service-instance-id>/group-associations