DiscoveryAPI - 범위 지정됨

  • 릴리스 버전: Xanadu
  • 업데이트 날짜 2024년 08월 01일
  • 읽기4분

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

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

    DiscoveryAPI - discoverIpAddress(문자열 ipAddress, 문자열 애플리케이션, 문자열 소스)

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

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

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

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

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

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

    DiscoveryAPI - reportCiIpAddressStatus(개체 ipAddress, 개체 discoveryStatusSysId)

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

    다음과 같은 예외가 throw될 수 있습니다.
    • DiscoveryStatusNotFoundException: 다음 메시지를 표시합니다. 시스템 ID가 "<잘못된 값>"인 검색 상태가 존재하지 않습니다.
    • DiscoveryDeviceHistoryNotFoundException: 검색 상태 시스템 ID가 "<잘못된 값>" 및 ipAddress "<잘못된 값>"인 장치 기록이 없습니다.
    • IllegalArgumentException (유효하지 않은 입력 인수): 이 인수 예외는 입력 값이 null이 되는 것을 방지합니다.
      • 검색 상태 시스템 ID는 null일 수 없습니다.
      • ipAddress는 null일 수 없습니다.
    • IllegalArgumentException (데이터베이스에 저장된 값): 이 인수 예외는 잘못된 특성 값의 경우 잘못된 데이터가 호출자에게 반환되는 것을 방지합니다.
      • 검색 상태 "상태" 속성은 null일 수 없습니다.
      • 장치 이력 "소스" 속성은 null일 수 없습니다.
      • 장치 기록 'issues' 속성이 정수 아님<잘못된 값>
      • 장치 기록 "문제" 속성은 0보다 작을 수 없습니다. <잘못된 값입니다>
    표 3. 매개변수
    이름 유형 설명
    ipAddress 문자열 스캔한 IPv4 주소입니다.
    검색 상태 시스템 ID 문자열 스캔한 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일 수 없습니다.
      • 장치 기록 'issues' 속성이 정수 아님<잘못된 값>
      • 장치 기록 "문제" 속성은 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];