您可以登錄將根據特定準則接收通知的監看程式。
若要登錄監看程式，您可以叫用以下 API。
POST /api/v1/notification-watcher
新增監看程式後，您必須在 watcher_id 中登錄一個 notification_id (feature_name.notification_name)，並指定監看程式應接收的通知。請注意，如果不進行此登錄，監看程式將不會接收任何通知。使用所需的要求參數叫用以下 API，以登錄 notification_id 並指定通知。如需 NSX 通知 API 的詳細資訊，請參閱《NSX 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> | ||
| notification | 通知架構支援的通知。 |
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 |
