---
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


---

# AgentNowHandler - 범위 지정됨

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

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

AgentNowHandler 스크립트 포함은 요청 시 검사 정의를 실행하고, 요청 시 실행 및 테스트 검사 실행의 상태를 확인하고, 요청 시 실행된 백그라운드 확인을 중지할 수 있는 메서드를 제공합니다.

이 스크립트 포함에는 프레임워크(sn_agent) 스토어 애플리케이션이 필요 에이전트 클라이언트 수집기 하며 `sn_agent` 네임스페이스 내에서 제공됩니다. 자세한 내용은 [에이전트 클라이언트 수집기를](https://www.servicenow.com/docs/access?context=acc-landing-page&version=australia&pubname=australia-it-operations-management&ft:locale=en-US) 참조하십시오.

REST API 솔루션은 [에이전트 클라이언트 수집기 API](https://servicenow-prod.fluidtopics.net/8UJsn3sn8UCZe2J7uoKjsQ#agnt_clnt_cll-api "에이전트 클라이언트 수집기 API는 사용 가능한 에이전트에 대한 작업을 관리하고 정책을 관리하는 엔드포인트를 제공합니다.")를 참조하십시오.

## AgentNowHandler - AgentNowHandler() {#ariaid-title2}

AgentNowHandler 인스턴스를 작성합니다.
{#AgentNowHnl-AgentNowHandler__table_ohr_4qd_bpb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 없음 |   |   |
[표 1. 매개변수]

{#AgentNowHnl-AgentNowHandler__table_ohr_4qd_bpb}  
다음 예제에서는 AgentNowHandler를 초기화하는 방법을 보여줍니다.

    var handler = new sn_agent.AgentNowHandler();

## AgentNowHandler - getRequestStatus(문자열 requestId) {#ariaid-title3}

지정된 ID로 요청의 상태를 가져옵니다.
{#AgentNowHnl-getRequestStatus_S__table_zk2_2g2_z4b__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| requestId | 문자열 | runCheckForCis() 메서드를 호출하여 생성된 검사 요청 ID입니다. |
[표 2. 매개변수]

{#AgentNowHnl-getRequestStatus_S__table_zk2_2g2_z4b} {#AgentNowHnl-getRequestStatus_S__table_al2_2g2_z4b__entry__2}

| 속성 | 설명 |
|-|-|
| 객체 | 요청의 상태와 해당하는 오류 메시지입니다. |
| 상태 | 요청 상태입니다. 가능한 값: * 완료 -- 검사에 성공했습니다. * 실패 -- 검사에 실패했습니다. 자세한 내용은 오류 메시지를 참조하십시오. * mid_flow -- 요청 출력이 MID 서버에서 처리되고 있습니다. * 처리 중 -- 검사가 진행 중입니다. * timeout -- 검사 처리가 runCheckForCis() 메서드에 설정된 시간 제한을 초과했습니다. {#AgentNowHnl-getRequestStatus_S__ul_edm_1rr_5qb} 데이터 유형: 문자열 |
| err_msg | 오류 메시지(있는 경우) 가능한 값: * 관련 CI에 대한 에이전트를 찾을 수 없습니다. * 지정된 ID의 신원 조사 요청이 없습니다. * 지정된 ID의 요청이 없습니다. * 지정된 ID에 테스트 결과가 없습니다. * 요청 시간 제한입니다. {#AgentNowHnl-getRequestStatus_S__ul_qcf_zcq_5qb} 데이터 유형: 문자열 |
[표 3. 반환]

{#AgentNowHnl-getRequestStatus_S__table_al2_2g2_z4b}  
다음 예시에서는 요청의 상태를 가져오는 방법을 보여줍니다.

    var handler = new sn_agent.AgentNowHandler();
    var check = {checkDefId: "158279505372b30034b8ddeeff7b1270"};
    var computerGr = new GlideRecord("cmdb_ci_computer");
    computerGr.query();
    var requestId = handler.runCheckForCis(computerGr, check, 0, 60);

    var reqStatusJson = handler.getRequestStatus(requestId);
    gs.info(JSON.stringify(reqStatusJson));

## AgentNowHandler - getTestResultStatus(문자열 testResultId) {#ariaid-title4}

지정된 테스트 결과의 테스트 검사 상태를 가져옵니다.
{#AgentNowHnl-getTestResultStatus_S__table_zk2_2g2_z4b__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| testResultId | 문자열 | 테스트 검사 요청을 생성하여 생성된 테스트 결과 ID입니다. |
[표 4. 매개변수]

{#AgentNowHnl-getTestResultStatus_S__table_zk2_2g2_z4b} {#AgentNowHnl-getTestResultStatus_S__table_al2_2g2_z4b__entry__2}

| 속성 | 설명 |
|-|-|
| 상태 | 테스트 결과의 상태입니다. 가능한 값: * 0: 보류 중 * 1: 진행 중 * 2: 완료 * 3: 지정된 ID에 테스트 결과 없음 {#AgentNowHnl-getTestResultStatus_S__ul_yyq_4bq_5qb} 데이터 유형: 문자열 |
| 출력 | 상태를 설명하는 출력입니다. 데이터 유형: 문자열 |
[표 5. 반환]

{#AgentNowHnl-getTestResultStatus_S__table_al2_2g2_z4b}  
다음 예제에서는 완료된 테스트 검사 요청의 결과 상태를 가져오는 방법을 보여줍니다.

    var testCheckStatusJson = handler.getTestResultStatus("testResultId");
    gs.info(JSON.stringify(testCheckStatusJson));

## AgentNowHandler - runCheckForCis(객체 ci, 객체 검사, 번호 우선순위, 번호 시간 제한) {#ariaid-title5}

지정된 구성 항목에 대한 검사를 실행합니다.
{#AgentNowHnl-runCheckForCis_O_O_N_N__table_zk2_2g2_z4b__entry__3}{#AgentNowHnl-runCheckForCis_O_O_N_N__agntNowHlr-parm-ph-chkparms}

| 이름 | 유형 | 설명 |
|-|-|-|
| CI | [GlideRecord](https://servicenow-prod.fluidtopics.net/PdjBDkljzRHVS4qRn2BIdw#c_GlideRecordScopedAPI "범위가 지정된 GlideRecord API는 데이터베이스 작업에 사용됩니다.") | 검사가 작동하는 모든 CMDB 테이블(모든 애플리케이션, 호스트 또는 에이전트)의 GlideRecord입니다. |
| 확인 | 객체 | 검사 ID 및 선택적 검사 매개변수입니다. "check": { "checkDefId": "String", "params": {Object} } |
| check.checkDefId | 문자열 | 검사 정의 \[sn_agent_check_def\] 테이블에 있는 검사 정의의 Sys_id입니다. |
| check.params | 객체 | 옵션입니다. 매개변수 이름 및 값의 맵입니다. 이러한 설정은 검사 정의의 매개변수 기록과 지정된 값을 재정의하는 데 사용할 수 있습니다. "params": { "<parameter name>": "String" } {#AgentNowHnl-runCheckForCis_O_O_N_N__agntNowHlr-parm-cd-chkparms} |
| 우선순위 | 번호 | ECC 큐에 설정할 요청의 우선순위입니다. 가능한 값: * 0: 대화형 * 1: 긴급 * 2: 표준 {#AgentNowHnl-runCheckForCis_O_O_N_N__ul_bkf_hnq_wqb} |
| 시간 제한 | 번호 | 요청의 시간 제한 값(초)입니다. |
[표 6. 매개변수]

{#AgentNowHnl-runCheckForCis_O_O_N_N__table_zk2_2g2_z4b} {#AgentNowHnl-runCheckForCis_O_O_N_N__table_al2_2g2_z4b__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 생성된 백그라운드 확인 요청의 Sys_id입니다. |
[표 7. 반환]

{#AgentNowHnl-runCheckForCis_O_O_N_N__table_al2_2g2_z4b}  
다음 예제에서는 백그라운드 확인을 실행하고 요청 ID를 가져오는 방법을 보여줍니다.

    var handler = new sn_agent.AgentNowHandler();
    var check = {checkDefId: "028fcd5067c80010b7b72dbd2685ef4f"};
    var computerGr = new GlideRecord("cmdb_ci_computer");
    computerGr.query();
    var requestId = handler.runCheckForCis(computerGr, check, 0, 60);

    gs.info(requestId);

출력:

    b9cf14aedb5e30106f4810284b961990

## AgentNowHandler - stopBackgroundCheck(문자열 requestId) {#ariaid-title6}

신원 조사를 중지합니다.
신원 조회를 시작하려면 runCheckForCis() 메서드를 사용하십시오.
{#AgentNowHnl-stopBackgroundCheck_S__table_zk2_2g2_z4b__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| requestId | 문자열 | runCheckForCis() 메서드를 호출하여 생성된 백그라운드 확인 요청의 ID입니다. |
[표 8. 매개변수]

{#AgentNowHnl-stopBackgroundCheck_S__table_zk2_2g2_z4b} {#AgentNowHnl-stopBackgroundCheck_S__table_al2_2g2_z4b__entry__2}

| 유형 | 설명 |
|-|-|
| 없음 |   |
[표 9. 반환]

{#AgentNowHnl-stopBackgroundCheck_S__table_al2_2g2_z4b}  
다음 예는 백그라운드 확인 실행을 중지하는 방법을 보여줍니다.

    handler.stopBackgroundCheck(backRequestId);