您可以注册将根据特定条件接收通知的监视程序。

要注册监视程序,您可以调用以下 API。

POST /api/v1/notification-watcher

添加监视程序后,必须注册一个 notification_id (feature_name.notification_name) 和 watcher_id,并指定监视程序应接收的通知。请注意,如果不进行此注册,监视程序将不会接收任何通知。使用所需的请求参数调用以下 API,以注册 notification_id 并指定通知。有关 NSX-T 通知 API 的详细信息,请参见《NSX-T Data Center API 指南》

  • PUT /api/v1/notification-watchers/<watcher-id>
  • POST /api/v1/notification-watchers/<watcher-id>/notifications?action=add_uri_filters,将使用以下请求参数:
    • notification_id:标识 feature_name.notification_name 的字符串,用于指示监视程序希望接收由 feature_name.notification_name 标识的 URI 的通知。
    • uri_filters:可选 URI 列表,用于根据策略路径筛选通知。指定 uri_filters 时,还可以使用 * 作为通配符,而不使用特定值。

      例如,假定 notification_id 为 group.change_name,uri_filter 模式为 /policy/api/v1/infra/domains/<domain>/groups/<group>。您可以将该模式指定为 /policy/api/v1/infra/domains/domain1/groups/group2,以获取特定于 domain1 和 group2 的通知。或者,您也可以将该模式指定为 /policy/api/v1/infra/domains/domain2/groups/*,以获取关于 domain2 中所有组的通知,或将其指定为 /policy/api/v1/infra/domains/*/groups/*,以获取关于所有域中所有组的通知。

下表列出了功能名称及其各自的 URI。
功能名称 功能描述 通知名称 通知描述 URI
NS 组功能支持的通知。 change_notification 关于组的通知,<domain> 标识域名,<group> 标识组名称。 /policy/api/v1/infra/domains/<domain>/groups/<group>
监控 监控功能支持的通知。 alarm 警报通知。<alarm-id> 标识警报实例。每当创建或删除警报实例以及更新警报实例时,便会发送通知。 /api/v1/alarms/<alarm-id>
alarm_status_change_notification 警报通知。<alarm-id> 标识警报实例。每当创建警报实例以及更新警报实例的状态属性值时,便会发送通知。 /api/v1/alarms/<alarm-id>
通知

通知框架支持的通知。

watcher 平台通知,用于传达对监视程序配置所做的更新。<watcher-id> 标识监视程序。 /api/v1/notification-watchers/<watcher-id>
watcher_notification 平台通知,用于传达对通知所做的更新。<watcher-id> 标识监视程序。 /api/v1/notification-watchers/<watcher-id>/notifications
service_config 服务配置功能支持的通知。 change_notification 服务配置通知。<domain> 标识域名,<policy> 标识端点策略,<rule> 标识端点规则。当更新端点规则中使用的服务配置或更新 UPM 配置文件时,将生成此通知。 /policy/api/v1/infra/domains/<domain>/endpoint-policies/<policy>/endpoint-rules/<rule>
service_insertion

服务插入模块支持的通知。

当前,服务插入模块支持有关服务配置文件、服务实例运行时和策略组的通知。

instance_runtime_notification 服务实例运行时通知。<service-id> 标识服务,<service-instance-id> 标识服务实例。将针对已部署和已取消部署的操作发送通知。 /api/v1/serviceinsertion/services/<service-id>/service-instances/<service-instance-id>/instance-runtimes
profile_notification 服务配置文件更改通知。<service-reference> 标识服务名称,<service-profile> 标识配置文件名称。将针对配置文件创建、更新和删除发送通知。 /policy/api/v1/infra/service-references/<service-reference>/service-profiles/<service-profile>
profile_chain_mapping_notification 服务配置文件链映射通知。<service-reference> 标识服务名称,<service-profile> 标识配置文件名称。当作为服务链的一部分添加或移除配置文件时,将发送通知。 /policy/api/v1/infra/service-references/<service-reference>/service-profiles/<service-profile>/service-chain-mappings
profile_nsgroups_notification 服务配置文件 NS 组通知。<service-reference> 标识服务名称,<service-profile> 标识配置文件名称。每当使用特定配置文件添加或删除包含 NS 组的东西向规则时,便会触发此通知。 /policy/api/v1/infra/service-references/<service-reference>/service-profiles/<service-profile>/group-associations
instance_nsgroups_notification 服务实例 NS 组通知。<service-id> 标识服务名称,<service-instance-id> 标识服务实例。每当使用特定实例添加或删除包含 NS 组的南北向规则时,便会触发此通知。 /api/v1/serviceinsertion/services/<service-id>/service-instances/<service-instance-id>/group-associations