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


---

# 클라우드 실행기 TestRunnerApi -- 범위, 전역

# 클라우드 실행기 TestRunnerApi -- 범위, 전역 {#ariaid-title1}

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

Automated Test Framework(ATF)에 대한 클라우드 실행기에서 실행할 테스트를 관리합니다.
이 API는 CloudRunnerApi 스크립트 포함의 일부입니다.  
다음 작업에 이 API를 사용할 수 있습니다.

* 클라우드 실행기 브라우저에서 ATF 테스트 또는 테스트 도구 모음을 시작합니다.
* 테스트 작업의 진행률을 확인합니다.
* 테스트 작업을 취소합니다.
{#cloudrnr-TestRunnerAPI-scoped__cloudrnr-TestRunnerAPI-scoped_ul_vwb_wvn_31c}

전역 범위에서 이 API는 sn_atf_tg 네임스페이스 내에서 실행됩니다. 이 API를 사용하려면 (sn_atf_tg) 플러그인이 활성화되어 있어야 합니다 [ATF Test Generator and Cloud Runner](https://www.servicenow.com/docs/access?context=atf-tg-cr-intro&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US) .  
참조 :

* [클라우드 실행기 TestGenerationApi - 범위, 전역](https://servicenow-prod.fluidtopics.net/NMBPPEHfCdxBInWgGSEPiQ#cloudrnr-TestGenerationAPI-scoped "Automated Test Framework(ATF)용 클라우드 실행기에서 실행할 테스트 작업 생성을 관리합니다. 이 API는 CloudRunnerApi 스크립트 포함의 일부입니다.")
* [클라우드 실행기 TestUserApi - 범위, 전역](https://servicenow-prod.fluidtopics.net/liIGMaY80uOkcdjI0WE0WQ#cloudrnr-TestUserAPI-scoped "Automated Test Framework(ATF)용 클라우드 실행기에서 실행할 테스트 사용자 작업을 관리합니다. 이 API는 CloudRunnerApi 스크립트 포함의 일부입니다.")
* [클라우드 실행기 테스트 사용자 REST API](https://servicenow-prod.fluidtopics.net/RLWwzuJf4Hs4qx1hYiWgsg#cloudrunner-testuser-api "Automated Test Framework(ATF)용 클라우드 실행기에서 실행할 테스트 사용자 작업을 관리합니다.")
{#cloudrnr-TestRunnerAPI-scoped__ul_gd4_zsn_31c}

## TestRunnerApi -- cancelJob(문자열 snboqId) {#ariaid-title2}

테스트 러너 작업을 완료 상태로 설정하고 실행 중인 생성된 테스트의 루트 추적기를 취소합니다.
{#cr-TestRunnerAPI-cancelJob_S__table_epx_lv4_g1c__entry__3}{#cr-TestRunnerAPI-cancelJob_S__cr-snboqId-ph-desc}

| 이름 | 유형 | 설명 |
|-|-|-|
| snboqId | 문자열 | 필수 브라우저 오케스트레이션 큐 \[sn_atf_tg_sn_boq\] 테이블의 BOQ 기록 sys_id입니다. |
[표 1. 매개변수]

{#cr-TestRunnerAPI-cancelJob_S__table_epx_lv4_g1c} {#cr-TestRunnerAPI-cancelJob_S__table_fpx_lv4_g1c__entry__2}

| 유형 | 설명 |
|-|-|
| null | 성공하면 Null이고, 그렇지 않으면 오류 메시지입니다. |
[표 2. 반환]

{#cr-TestRunnerAPI-cancelJob_S__table_fpx_lv4_g1c}  
다음 예제에서는 테스트를 시작하고, ATF 테스트를 실행하고, 진행률을 표시하고, 테스트 실행을 중지하는 방법을 보여줍니다. 전역 범위에서 sn_atf_tg 네임스페이스를 사용합니다.

    var snboqId = CloudRunnerAPI.TestRunnerAPI.startJob({
    	"testId": "<sys_id>"
    });

    gs.info(JSON.stringify(CloudRunnerAPI.TestRunnerAPI.progress({"snboqId": snboqId})));

    CloudRunnerAPI.TestRunnerAPI.cancelJob({"snboqId": snboqId});

출력:

    {progress: 64, state: running}

## TestRunnerApi -- progress(문자열 snboqId) {#ariaid-title3}

제공된 BOQ(브라우저 오케스트레이션 큐) 기록에 대해 실행된 각 테스트의 상태를 제공합니다.
{#cr-TestRunnerAPI-progress_S__table_epx_lv4_g1c__entry__3}{#cr-TestRunnerAPI-progress_S__cr-snboqId-ph-desc}

| 이름 | 유형 | 설명 |
|-|-|-|
| snboqId | 문자열 | 필수 브라우저 오케스트레이션 큐 \[sn_atf_tg_sn_boq\] 테이블의 BOQ 기록 sys_id입니다. |
[표 3. 매개변수]

{#cr-TestRunnerAPI-progress_S__table_epx_lv4_g1c} {#cr-TestRunnerAPI-progress_S__table_fpx_lv4_g1c__entry__2}{#cr-TestRunnerAPI-progress_S__cr-prog-state-ph-desc}

| 유형 | 설명 |
|-|-|
| 객체 | 테스트 진행률을 나타내는 JSON 객체입니다. { "progress": Number, "state": "String" } |
| 객체.진행률 | 테스트 진행률이 완료되었음을 나타냅니다. 유형: 번호 |
| 객체.상태 | BOQ 기록의 상태입니다. 가능한 값: * 보류 중 -- 요청된 테스트 활동이 생성되었으며 실행되기를 기다리고 있습니다.{#cr-TestRunnerAPI-progress_S__cr-prog-state-li-pending} {#cr-TestRunnerAPI-progress_S__cr-prog-state-li-pending} * 처리 중 -- 인스턴스는 요청이 클라우드 인프라로 전송되기 전에 실행 추적기가 클라우드 실행기에 대해 표시되어 있는지 확인하기 위해 기록을 스캔하고 있습니다. * 브라우저 요청됨 -- 테스트 생성 또는 테스트 실행을 위해 브라우저를 시작하라는 요청이 클라우드 인프라에 전송되었습니다.{#cr-TestRunnerAPI-progress_S__cr-prog-state-li-brsreq} {#cr-TestRunnerAPI-progress_S__cr-prog-state-li-brsreq} * 실행 중 -- 클라우드 인프라 브라우저가 보류 중인 테스트를 찾아 실행합니다. * 완료됨 - 테스트 작업이 완료되었습니다.{#cr-TestRunnerAPI-progress_S__cr-prog-state-li-complete} {#cr-TestRunnerAPI-progress_S__cr-prog-state-li-complete} * 실패 상태 -- 테스트 작업이 실패했습니다.{#cr-TestRunnerAPI-progress_S__cr-prog-state-li-failed} {#cr-TestRunnerAPI-progress_S__cr-prog-state-li-failed} {#cr-TestRunnerAPI-progress_S__ul_rvl_vsg_l1c} 유형: 문자열 |
| 오류 | 실패할 경우 발생할 수 있는 오류 메시지: * 전달된 BOQ ID 없음 -- 제공된 JSON 객체에 BOQ ID 항목이 없습니다. JSON 객체가 `{snboqId: "<sys_id>"}`로 구조화되어 있는지 확인합니다. * 잘못된 BOQ sys_id 전달됨 -- 제공된 ID는 브라우저 오케스트레이션 큐\[sn_atf_tg_sn_boq\] 테이블의 BOQ 기록용이어야 합니다. {#cr-TestRunnerAPI-progress_S__ul_wqr_slb_j1c} |
[표 4. 반환]

{#cr-TestRunnerAPI-progress_S__table_fpx_lv4_g1c}  
다음 예제에서는 테스트를 시작하고, ATF 테스트를 실행하고, 진행률을 표시하고, 테스트 실행을 중지하는 방법을 보여줍니다. 전역 범위에서 sn_atf_tg 네임스페이스를 사용합니다.

    var snboqId = CloudRunnerAPI.TestRunnerAPI.startJob({
    	"testId": "<sys_id>"
    });

    gs.info(JSON.stringify(CloudRunnerAPI.TestRunnerAPI.progress({"snboqId": snboqId})));

    CloudRunnerAPI.TestRunnerAPI.cancelJob({"snboqId": snboqId});

출력:

    {progress: 64, state: running}

## TestRunnerApi -- startJob(문자열 testId) {#ariaid-title4}

클라우드 실행기 브라우저에서 ATF 테스트 또는 테스트 도구 모음을 시작합니다.
{#cr-TestRunnerAPI-startJob_S__table_epx_lv4_g1c__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| testId | 문자열 | 필수 클라우드 실행기 브라우저에서 실행할 ATF 테스트 또는 테스트 도구 모음의 sys_id입니다. 다음 테이블 중 하나에 있습니다. * 테스트 \[sys_atf_test\] * 테스트 도구 모음 \[sys_atf_test_suite\] {#cr-TestRunnerAPI-startJob_S__ul_gqc_yj4_l1c} |
[표 5. 매개변수]

{#cr-TestRunnerAPI-startJob_S__table_epx_lv4_g1c} {#cr-TestRunnerAPI-startJob_S__table_fpx_lv4_g1c__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 브라우저 오케스트레이션 큐 \[sn_atf_tg_sn_boq\] 테이블의 BOQ 기록 sys_id입니다. |
[표 6. 반환]

{#cr-TestRunnerAPI-startJob_S__table_fpx_lv4_g1c}  
다음 예제에서는 테스트를 시작하고, ATF 테스트를 실행하고, 진행률을 표시하고, 테스트 실행을 중지하는 방법을 보여줍니다. 전역 범위에서 sn_atf_tg 네임스페이스를 사용합니다.

    var snboqId = CloudRunnerAPI.TestRunnerAPI.startJob({
    	"testId": "<sys_id>"
    });

    gs.info(JSON.stringify(CloudRunnerAPI.TestRunnerAPI.progress({"snboqId": snboqId})));

    CloudRunnerAPI.TestRunnerAPI.cancelJob({"snboqId": snboqId});

출력:

    {progress: 64, state: running}