Vous pouvez enregistrer un observateur qui recevra des notifications en fonction de critères spécifiques.

Pour enregistrer un observateur, vous pouvez appeler l'API suivante.

POST /api/v1/notification-watcher

Après avoir ajouté un observateur, vous devez enregistrer un notification_id (feature_name.notification_name) avec un watcher_id et spécifier les notifications que l'observateur doit recevoir. Notez que sans l'enregistrement, l'observateur ne recevra aucune notification. Appelez les API suivantes avec les paramètres de la demande requis pour enregistrer notification_id et spécifier des notifications. Pour plus d'informations sur les API de notification NSX, consultez Guide de NSX API.

  • PUT /api/v1/notification-watchers/<watcher-id>
  • POST /api/v1/notification-watchers/<watcher-id>/notifications?action=add_uri_filters avec les paramètres de la demande suivants :
    • notification_id : chaîne identifiant feature_name.notification_name pour indiquer une notification que l'observateur souhaite recevoir pour l'URI identifié par feature_name.notification_name.
    • uri_filters : liste facultative d'URI pour filtrer les notifications en fonction de leur chemin d'accès de la stratégie. Lorsque vous spécifiez uri_filters, vous pouvez également utiliser * comme caractère générique au lieu d'une valeur spécifique.

      Par exemple, si notification_id est group.change_name, le modèle d'uri_filter est /policy/api/v1/infra/domains/<domain>/groups/<group>. Vous pouvez spécifier le modèle sous la forme /policy/api/v1/infra/domain1/groups/group2 pour obtenir des notifications spécifiques à domain1 et group2. Vous pouvez également spécifier le modèle /policy/api/v1/infra/domains/domain2/groups/* pour obtenir des notifications pour tous les groupes dans domain2 ou le spécifier sous la forme /policy/api/v1/infra/domains/*/groups/* pour obtenir des notifications pour tous les groupes de tous les domaines.

Le tableau suivant répertorie les noms des fonctionnalités et leurs URI respectifs.
Nom de la fonctionnalité Description de la fonctionnalité Nom de la notification Description de la notification URI
group Notifications prises en charge par la fonctionnalité NS Group. change_notification Notification de groupe, <domain> identifie le nom de domaine et <group> identifie le nom du groupe. /policy/api/v1/infra/domains/<domain>/groups/<group>
monitoring Notifications prises en charge par la fonctionnalité de surveillance. alarm Notifications d'alarme. <alarm-id> identifie une instance d'alarme. Une notification est envoyée chaque fois qu'une instance d'alarme est créée ou supprimée et lorsque l'instance d'alarme est mise à jour. /api/v1/alarms/<alarm-id>
alarm_status_change_notification Notifications d'alarme. <alarm-id> identifie une instance d'alarme. Une notification est envoyée chaque fois qu'une instance d'alarme est créée et lorsque la valeur de propriété d'état d'une instance d'alarme est mise à jour. /api/v1/alarms/<alarm-id>
notification

Notifications prises en charge par l'infrastructure de notification.

 watcher Notification de la plate-forme pour transmettre les mises à jour à la configuration de l'observateur. <watcher-id> identifie l'observateur. /api/v1/notification-watchers/<watcher-id>
watcher_notification Notification de la plate-forme pour transmettre les mises à jour aux notifications. <watcher-id> identifie l'observateur. /api/v1/notification-watchers/<watcher-id>/notifications
service_config Notifications prises en charge par la fonctionnalité Configuration du service. change_notification Notification de configuration du service. <domain> identifie le nom de domaine, <policy> identifie la stratégie de point de terminaison et <rule> identifie la règle de point de terminaison. Cette notification est générée lorsqu'une configuration de service utilisée dans la règle de point de terminaison est mise à jour ou lorsque le profil UPM est mis à jour. /policy/api/v1/infra/domains/<domain>/endpoint-policies/<policy>/endpoint-rules/<rule>
service_insertion

Notifications prises en charge par le module Insertion de services.

Actuellement, le module Insertion de services prend en charge les notifications pour le profil du service, l'exécution de l'instance de service et les groupes de stratégies.

 instance_runtime_notification Notification d'exécution de l'instance de service. <service-id> identifie le service, <service-instance-id> identifie l'instance de service. La notification sera envoyée pour les opérations déployées et non déployées. /api/v1/serviceinsertion/services/<service-id>/service-instances/<service-instance-id>/instance-runtimes
profile_notification Notification de modification du profil du service. <service-reference> identifie le nom du service et <service-profile> identifie le nom du profil. La notification sera envoyée pour la création, la mise à jour et la suppression du profil. /policy/api/v1/infra/service-references/<service-reference>/service-profiles/<service-profile>
profile_chain_mapping_notification Notification de mappage de chaîne de profil du service. <service-reference> identifie le nom du service et <service-profile> identifie le nom du profil. La notification sera envoyée lorsqu'un profil est ajouté ou supprimé dans le cadre d'une chaîne de services. /policy/api/v1/infra/service-references/<service-reference>/service-profiles/<service-profile>/service-chain-mappings
profile_nsgroups_notification Notification des NSGroups du profil du service. <service-reference> identifie le nom du service et <service-profile> identifie le nom du profil. Cette notification est déclenchée lorsqu'une règle est-ouest contenant des NSGroups est ajoutée ou supprimée avec le profil particulier. /policy/api/v1/infra/service-references/<service-reference>/service-profiles/<service-profile>/group-associations
instance_nsgroups_notification Notification NSGroups de l'instance de service. <service-id> identifie le nom du service et <service-instance-id> identifie l'instance de service. Cette notification est déclenchée chaque fois qu'une règle nord-sud contenant des NSGroups est ajoutée ou supprimée avec l'instance particulière. /api/v1/serviceinsertion/services/<service-id>/service-instances/<service-instance-id>/group-associations