특정 조건에 따라 알림을 수신할 감시자를 등록할 수 있습니다.

감시자를 등록하려면 다음 API를 호출하면 됩니다.

POST /api/v1/notification-watcher

감시자를 추가한 후에는 watcher_id notification_id(feature_name.notification_name)를 등록하고 감시자가 수신해야 하는 알림을 지정해야 합니다. 등록하지 않으면 감시자가 알림을 수신하지 않습니다. notification_id를 등록하고 알림을 지정하는 데 필요한 요청 매개 변수를 사용하여 다음 API를 호출합니다. 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으로 식별된 URI를 수신하는 데 관심이 있다는 알림을 나타내는 feature_name.notification_name을 식별하는 문자열입니다.
    • 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
group NS 그룹 기능에서 지원되는 알림입니다. change_notification 그룹 알림 <domain>은 도메인 이름을 식별하고 <group>은 그룹 이름을 식별합니다. /policy/api/v1/infra/domains/<domain>/groups/<group>
monitoring 모니터링 기능에서 지원되는 알림입니다. 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 서비스 프로파일 NSGroup 알림입니다. <service-reference>는 서비스 이름을 식별하고 <service-profile>은 프로파일 이름을 식별합니다. 이 알림은 nsgroup이 포함된 East-West 규칙이 특정 프로파일에서 추가되거나 삭제될 때마다 트리거됩니다. /policy/api/v1/infra/service-references/<service-reference>/service-profiles/<service-profile>/group-associations
instance_nsgroups_notification 서비스 인스턴스 NSGroup 알림입니다. <service-id>는 서비스 이름을 식별하고 <service-instance-id>는 서비스 인스턴스를 식별합니다. 이 알림은 nsgroup이 포함된 North-South 규칙이 특정 인스턴스에서 추가되거나 삭제될 때마다 트리거됩니다. /api/v1/serviceinsertion/services/<service-id>/service-instances/<service-instance-id>/group-associations