DiscoveryAPI - 범위 지정됨

  • 릴리스 버전: Zurich
  • 업데이트 날짜 2025년 07월 31일
  • 소요 시간: 4분

    • DiscoveryAPI 클래스는 단일 IPv4 주소의 빠른 검색을 시작하고 단일 CI(구성 항목) 또는 모든 스캔된 CI에 대해 이전에 시작된 검색 상태의 요약을 반환하는 메서드를 제공합니다.

    이 클래스 실행은 sn_discovery 네임스페이스에 있습니다.

    DiscoveryAPI - discoverIpAddress(String ipAddress, String application, string source)

    지정된 IPv4 주소를 검색합니다.

    MID 서버는 제공된 IP 주소 또는 지정된 애플리케이션을 기준으로 자동으로 선택됩니다.

    표 1. 매개변수
    이름 유형 설명
    애플리케이션 문자열 옵션입니다. MID 서버용으로 구성된 애플리케이션입니다.

    매개 변수는 정의하지만 매개 변수는 정의 source 하지 않으려면 application "NULL"을 자리 표시자로 사용합니다.

    기본값: Discovery
    ipAddress 문자열 검색할 IP 주소입니다.
    소스 문자열 옵션입니다. 검색의 소스입니다. 이와 동일한 값이 검색 상태 기록의 선택적 소스 필드에 나타나며, 이는 검색이 트리거된 방법을 나타냅니다.

    기본값: Discovery_API
    표 2. 반환
    유형 설명
    문자열 검색 상태 레코드 sys_id.
    MID 서버 선택 중에 다음 예외가 발생할 수 있습니다.
    • NoSuitableMidServerFoundException: 이 디스커버리에 사용할 수 있는 적절한 MID 서버가 없음
    • BadArgumentException: MID 서버 선택 중 잘못된 인수가 탐지됨
    		 
    var sysid = sn_discovery.DiscoveryAPI.discoverIpAddress("11.23.125.39");

    DiscoveryAPI - reportCiIpAddressStatus(Object ipAddress, Object discoveryStatusSysId)

    특정 상태 sys_id 및 IPv4 주소가 지정된 구성 항목의 검색 상태 요약을 반환하는 데 사용됩니다.

    다음과 같은 예외가 throw될 수 있습니다.
    • DiscoveryStatusNotFoundException: 다음 메시지가 표시됩니다. 시스템 ID가 '<잘못된 값>'인 Discovery 상태가 없습니다.
    • DiscoveryDeviceHistoryNotFoundException: 디스커버리 상태 시스템 ID "<잘못된 값>" 및 ipAddress "<잘못된 값>"이 있는 장치 기록은 존재하지 않습니다.
    • IllegalArgumentException (유효하지 않은 입력 인수): 이 인수 예외는 입력 값이 null이 되는 것을 방지합니다.
      • 디스커버리 상태 시스템 ID는 null일 수 없습니다.
      • ipAddress는 null일 수 없습니다.
    • IllegalArgumentException (데이터베이스에 저장된 값): 이 인수 예외는 잘못된 특성 값의 경우 잘못된 데이터가 호출자에게 반환되는 것을 방지합니다.
      • 디스커버리 상태 "상태" 속성은 null일 수 없습니다.
      • 장치 이력 "소스" 속성은 null일 수 없습니다.
      • 장치 이력 "문제" 속성이 정수가 아닙니다. <잘못된 값입니다>
      • 장치 이력 "문제" 속성은 0보다 작을 수 없습니다. <잘못된 값입니다>
    표 3. 매개변수
    이름 유형 설명
    ipAddress 문자열 스캔한 IPv4 주소입니다.
    디스커버리 StatusSysId 문자열 검사한 IP 주소에 대한 검색 상태 기록의 sys_id입니다.
    표 4. 반환
    유형 설명
    배열 변경할 수 없는 ReportCiStatusOutputJS 개체의 JavaScript 배열입니다. 
    var ipResultObj = sn_discovery.DiscoveryAPI.reportCiIpAddressStatus(ipAddress, discoveryStatus);

    DiscoveryAPI - reportCiStatus(객체 discoveryStatusSysId)

    특정 디스커버리 상태 sys_id가 지정된 CI 디스커버리 상태의 요약을 반환하는 데 사용됩니다.

    다음과 같은 예외가 throw될 수 있습니다.
    • DiscoveryStatusNotFoundException: 시스템 ID가 "<잘못된 값>"인 디스커버리 상태가 존재하지 않습니다.
    • DiscoveryDeviceHistoryNotFoundException: 디스커버리 상태 시스템 ID "<잘못된 값>" 및 ipAddress "<잘못된 값>"이 있는 장치 기록은 존재하지 않습니다.
    • IllegalArgumentException (유효하지 않은 입력 인수): 이 인수 예외는 입력 값이 null이 되는 것을 방지합니다.
      • 디스커버리 상태 시스템 ID는 null일 수 없습니다.
      • ipAddress는 null일 수 없습니다.
    • IllegalArgumentException (데이터베이스에 저장된 값): 이 인수 예외는 데이터베이스 액세스 값에 사후 조건을 적용합니다.
      • 디스커버리 상태 "상태" 속성은 null일 수 없습니다.
      • 장치 이력 "소스" 속성은 null일 수 없습니다.
      • 장치 이력 "문제" 속성이 정수가 아닙니다. <잘못된 값입니다>
      • 장치 이력 "문제" 속성은 0보다 작을 수 없습니다. <잘못된 값입니다>
    표 5. 매개변수
    이름 유형 설명
    sys_id 문자열 검색 상태 기록의 sys_id.
    표 6. 반환
    유형 설명
    배열 변경할 수 없는 ReportCiStatusOutputJS 개체의 JavaScript 배열입니다. 
    var ipResultObjArray = sn_discovery.DiscoveryAPI.reportCiStatus(discoveryStatus);
for(var idx=0; idx < ipResultObjArray.length; idx++) {    
var ipResultObj = ipResultObjArray[idx];