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.
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 |