---
sourceDocument: 호주 API 참조
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/api-reference

 Release :

    - australia

ft:locale :

    - ko-KR

ft:publication_title :

    - 호주 API 참조

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# DiscoveryAPI - 범위 지정됨

# DiscoveryAPI - 범위 지정됨 {#ariaid-title1}

* 릴리스 버전: Australia
* 
* 업데이트 날짜 2026년 03월 12일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 4분

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

이 클래스는 `sn_discovery` 네임스페이스에서 실행됩니다.

## DiscoveryAPI - discoverIpAddress(문자열 ipAddress, 문자열 애플리케이션, 문자열 소스) {#ariaid-title2}

지정된 IPv4 주소를 검색합니다.
MID 서버는 제공된 IP 주소 또는 지정된 애플리케이션을 기준으로 자동으로 선택됩니다.
{#r_DiscoAPIdiscoverIpAddress__table_c4m_wcd_qcb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 애플리케이션 | 문자열 | 옵션입니다. MID 서버용으로 구성된 애플리케이션입니다. 매개변수는 source 정의하되 매개변수는 정의하지 않으 application 려면 자리 표시자로 "NULL"을 사용합니다. 기본값: 검색 |
| ipAddress | 문자열 | 검색할 IP 주소입니다. |
| 소스 | 문자열 | 옵션입니다. 검색의 소스입니다. 검색이 트리거된 방법을 나타내는 검색 상태 기록의 선택적 소스 필드에도 동일한 값이 표시됩니다. 기본값: Discovery_API |
[표 1. 매개변수]

{#r_DiscoAPIdiscoverIpAddress__table_c4m_wcd_qcb} {#r_DiscoAPIdiscoverIpAddress__table_d4m_wcd_qcb__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 검색 상태 기록 sys_id. MID 서버 선택 중에 다음 예외가 발생할 수 있습니다. * NoSuitableMidServerFoundException: `이 디스커버리에 사용할 수 있는 적절한 MID 서버가 없음` * BadArgumentException: `MID 서버 선택 중 잘못된 인수가 탐지됨` {#r_DiscoAPIdiscoverIpAddress__ul_ms4_lqj_qcb} |
[표 2. 반환]

{#r_DiscoAPIdiscoverIpAddress__table_d4m_wcd_qcb}  

    var sysid = sn_discovery.DiscoveryAPI.discoverIpAddress("11.23.125.39");

## DiscoveryAPI - reportCiIpAddressStatus(객체 ipAddress, 객체 discoveryStatusSysId) {#ariaid-title3}

특정 상태 sys_id 및 IPv4 주소가 지정된 구성 항목의 검색 상태 요약을 반환하는 데 사용됩니다.
다음 예외가 발생할 수 있습니다.

* DiscoveryStatusNotFoundException: `시스템 ID가 "`<잘못된 값`>"인 디스커버리 상태가 존재하지 않는다는 메시지 표시`
* DiscoveryDeviceHistoryNotFoundException: `디스커버리 상태 시스템 ID "<`잘못된 값`>" 및 ipAddress "<`잘못된 값`>"이(가) 없는 장치 이력`
* IllegalArgumentException (유효하지 않은 입력 인수): 이 인수 예외는 입력 값이 null이 되는 것을 방지합니다.
  * `디스커버리 상태 시스템 ID는 null일 수 없습니다. `
  * `ipAddress는 null일 수 없습니다.`
  {#r_DiscoAPIreportCiIpAddressStatus__ul_ul2_c4t_rcb}
* IllegalArgumentException (데이터베이스에 저장된 값): 이 인수 예외는 잘못된 속성 값의 경우 잘못된 데이터가 호출자에게 반환되는 것을 방지합니다.
  * `디스커버리 상태 "상태" 속성은 null일 수 없습니다.`
  * `장치 기록 "소스" 속성은 null일 수 없습니다. `
  * `장치 기록 "문제" 속성이 정수가 아님: <`잘못된 값`>`
  * `장치 기록 "문제" 속성은 0보다 작을 수 없습니다. <`잘못된 값`>`
  {#r_DiscoAPIreportCiIpAddressStatus__ul_pjt_j4t_rcb}
{#r_DiscoAPIreportCiIpAddressStatus__ul_ztk_gft_rcb}
{#r_DiscoAPIreportCiIpAddressStatus__table_jlm_mts_rcb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| ipAddress | 문자열 | 스캔한 IPv4 주소입니다. |
| discoveryStatusSysId | 문자열 | 스캔한 IP 주소에 대한 검색 상태 기록의 sys_id입니다. |
[표 3. 매개변수]

{#r_DiscoAPIreportCiIpAddressStatus__table_jlm_mts_rcb} {#r_DiscoAPIreportCiIpAddressStatus__table_klm_mts_rcb__entry__2}

| 유형 | 설명 |
|-|-|
| 배열 | 변경 불가능한 [ReportCiStatusOutputJS](https://servicenow-prod.fluidtopics.net/8oZrDwyLZmqT_zcyKj~InA#c_ReportCiStatusOutputJSScopedAPI "ReportCiStatusOutputJS API는 DiscoveryAPI reportCiIpAddressStatus 메서드에 대한 특정 개체 속성을 반환한 후 이 정보를 JSON 문자열로 변환하는 메서드를 제공합니다.") 객체의 JavaScript 배열입니다. |
[표 4. 반환]

{#r_DiscoAPIreportCiIpAddressStatus__table_klm_mts_rcb}  

    var ipResultObj = sn_discovery.DiscoveryAPI.reportCiIpAddressStatus(ipAddress, discoveryStatus);

## DiscoveryAPI - reportCiStatus(객체 discoveryStatusSysId) {#ariaid-title4}

특정 검색 상태 sys_id이 지정된 CI 검색 상태의 요약을 반환하는 데 사용됩니다.
다음 예외가 발생할 수 있습니다.

* DiscoveryStatusNotFoundException: `시스템 ID가 "`<잘못된 값`>"인 디스커버리 상태가 존재하지 않습니다`.
* DiscoveryDeviceHistoryNotFoundException: `디스커버리 상태 시스템 ID "<`잘못된 값`>" 및 ipAddress "<`잘못된 값`>"이(가) 없는 장치 이력`
* IllegalArgumentException (유효하지 않은 입력 인수): 이 인수 예외는 입력 값이 null이 되는 것을 방지합니다.
  * `디스커버리 상태 시스템 ID는 null일 수 없습니다.`
  * `ipAddress는 null일 수 없습니다.`
  {#r_DiscoAPIreportCiStatus__ul_ul2_c4t_rcb}
* IllegalArgumentException (데이터베이스에 저장된 값): 이 인수 예외는 데이터베이스 액세스 값에 POST 조건을 적용합니다.
  * `디스커버리 상태 "상태" 속성은 null일 수 없습니다.`
  * `장치 기록 "소스" 속성은 null일 수 없습니다.`
  * `장치 기록 "문제" 속성이 정수가 아님: <`잘못된 값`>`
  * `장치 기록 "문제" 속성은 0보다 작을 수 없습니다. <`잘못된 값`>`
  {#r_DiscoAPIreportCiStatus__ul_pjt_j4t_rcb}
{#r_DiscoAPIreportCiStatus__ul_ztk_gft_rcb}
{#r_DiscoAPIreportCiStatus__table_fzx_cwt_rcb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| sys_id | 문자열 | 검색 상태 기록의 sys_id입니다. |
[표 5. 매개변수]

{#r_DiscoAPIreportCiStatus__table_fzx_cwt_rcb} {#r_DiscoAPIreportCiStatus__table_gzx_cwt_rcb__entry__2}

| 유형 | 설명 |
|-|-|
| 배열 | 변경 불가능한 [ReportCiStatusOutputJS](https://servicenow-prod.fluidtopics.net/8oZrDwyLZmqT_zcyKj~InA#c_ReportCiStatusOutputJSScopedAPI "ReportCiStatusOutputJS API는 DiscoveryAPI reportCiIpAddressStatus 메서드에 대한 특정 개체 속성을 반환한 후 이 정보를 JSON 문자열로 변환하는 메서드를 제공합니다.") 객체의 JavaScript 배열입니다. |
[표 6. 반환]

{#r_DiscoAPIreportCiStatus__table_gzx_cwt_rcb}  

    var ipResultObjArray = sn_discovery.DiscoveryAPI.reportCiStatus(discoveryStatus);
    for(var idx=0; idx < ipResultObjArray.length; idx++) {    
    var ipResultObj = ipResultObjArray[idx];