DiscoveryAPI - 범위 지정됨

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

    • DiscoveryAPI - 범위가 지정된 클래스는 단일 IPv4 주소의 빠른 검색을 시작하고 단일 CI 또는 모든 스캔된 CI에 대해 이전에 시작된 Discovery 상태에 대한 요약을 반환합니다.

    범위가 지정된 DiscoveryAPI - discoverIpAddress(문자열 ipAddress, 문자열 애플리케이션, 문자열 소스)

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

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

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

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

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

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

    범위가 지정된 Discovery API - reportCiIpAddressStatus(객체 ipAddress, 객체 discoveryStatusSysId)

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

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

    범위가 지정된 DiscoveryAPI - reportCiStatus(discoveryStatusSysId 객체)

    특정 Discovery 상태 sys_id가 제공된 CI Discovery 상태의 요약을 반환하는 데 사용됩니다.

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