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


---

# 클라우드 실행기 테스트 러너 REST API

# 클라우드 실행기 테스트 러너 REST API {#ariaid-title1}

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

Automated Test Framework(ATF)에 대한 클라우드 실행기에서 실행할 테스트를 관리합니다.
클라우드 실행기 테스트 실행기 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) 필요합니다. 이 API에서 사용할 수 있는 메서드는 현재 네임스페이스에서 실행되며 REST API 탐색기에서 ATF에 대한 원클릭 회귀 테스트인 API 이름을 사용하여 호출할 수 있습니다. 이 API에 액세스하려면 관리자 역할이 필요합니다.  
다음 작업에 이 API를 사용할 수 있습니다.

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

클라우드 실행기 테스트 러너 API는 및 [클라우드 실행기 테스트 사용자 REST API](https://servicenow-prod.fluidtopics.net/RLWwzuJf4Hs4qx1hYiWgsg#cloudrunner-testuser-api "Automated Test Framework(ATF)용 클라우드 실행기에서 실행할 테스트 사용자 작업을 관리합니다.")과 함께 [클라우드 실행기 테스트 생성 REST API](https://servicenow-prod.fluidtopics.net/gd5fAkM6ShuLCYrLtnNj1g#cloudrunner-testgeneration-api "Automated Test Framework(ATF)용 클라우드 실행기에서 실행할 테스트 작업 생성을 관리합니다.") 사용할 수 있습니다. 예를 들어 테스트(클라우드 실행기 테스트 생성 API)를 생성한 다음 브라우저 오케스트레이션 큐(클라우드 실행기 테스트 생성 API)에서 테스트 진행률을 확인하고 통과 또는 실패한 테스트 수를 확인할 수 있습니다.

이 API의 서버 API 참조 문서를 보려면 다음 문서를 참조하십시오 [클라우드 실행기 TestRunnerApi -- 범위, 전역](https://servicenow-prod.fluidtopics.net/fd7xPlOEOW_6VoOFU66KNw#cloudrnr-TestRunnerAPI-scoped "Automated Test Framework(ATF)에 대한 클라우드 실행기에서 실행할 테스트를 관리합니다. 이 API는 CloudRunnerApi 스크립트 포함의 일부입니다.").

## 클라우드 실행기 테스트 러너 - GET /now/sn_atf_tg/test_runner_progress {#ariaid-title2}

제공된 BOQ(브라우저 오케스트레이션 큐) 기록에 대해 실행된 각 테스트의 상태를 제공합니다.

### URL 형식

기본 URL: GET /api/now/sn_atf_tg/test_runner_progress

### 지원되는 요청 매개변수

{#cr-TestRunnerAPI-GET-test-run-progress__entry__2}

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

{#cr-TestRunnerAPI-GET-test-run-progress__entry__6}

| 이름 | 설명 |
|-|-|
| snboqId | 필수 진행률을 가져올 테스트 러너 작업의 BOQ 기록 sys_id입니다. 데이터 유형: 문자열 테이블: BOQ \[sn_atf_tg_sn_boq\] |
[표 2. 쿼리 매개변수]

{#cr-TestRunnerAPI-GET-test-run-progress__entry__10}

| 이름 | 설명 |
|-|-|
| 안 함 |   |
[표 3. 요청 본문 매개변수(XML 또는 JSON)]

### 헤더

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#cr-TestRunnerAPI-GET-test-run-progress__entry__14}{#cr-TestRunnerAPI-GET-test-run-progress__accept-RESTAPI}

| 머리글 | 설명 |
|-|-|
| 수용 | 응답 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다. 기본값: application/json |
[표 4. 요청 헤더]

{#cr-TestRunnerAPI-GET-test-run-progress__entry__18}

| 머리글 | 설명 |
|-|-|
| 안 함 |   |
[표 5. 응답 헤더]

### 상태 코드

이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#cr-TestRunnerAPI-GET-test-run-progress__table_vdy_gwz_31c__entry__2}

| 상태 코드 | 설명 |
|-|-|
| 200 | BOQ 작업의 진행률을 성공적으로 검색했습니다. |
| 400 | BOQ 기록 상태를 가져오는 동안 오류가 발생했습니다. 다음 메시지 중 하나를 반환합니다. * 전달된 BOQ ID 없음 -- BOQ ID가 제공되지 않았습니다. 요청 본문에 BOQ ID를 추가합니다. * BOQ 기록을 찾을 수 없음 -- 시스템 ID가 잘못되었습니다. BOQ 기록의 sys_id이 유효하고 기록이 있는지 확인합니다. {#cr-TestRunnerAPI-GET-test-run-progress__ul_d5p_btk_p1c} |
| 403 | 엔드포인트에 대한 사용자 액세스 권한을 부여하는 동안 오류가 발생했습니다. 사용자에게 관리자 역할이 있는지 확인합니다. |
[표 6. 상태 코드]

{#cr-TestRunnerAPI-GET-test-run-progress__table_vdy_gwz_31c}

### 응답 본문 매개변수(JSON 또는 XML)

{#cr-TestRunnerAPI-GET-test-run-progress__entry__30}

| 이름 | 설명 |
|-|-|
| 결과 | 테스트 러너 작업의 진행 결과 또는 요청이 실패한 이유를 설명하는 메시지를 포함하는 객체입니다. 데이터 유형: 객체 "result": { "progress": 100, "state": "completed" } 또는: { "result": { "message": "String" } } |
| 결과.메시지 | 테스트 러너 진행률을 검색할 수 없는 이유를 자세히 설명하는 오류 메시지입니다. message 매개변수는 성공적인 응답에서 반환되지 않습니다. 데이터 유형: 문자열 |
| 결과.진행률 | 실행 중인 상태에서 테스트가 얼마나 완료에 근접했는지를 나타내는 백분율입니다. 데이터 유형: 숫자 |
| 결과.상태 | BOQ 기록의 현재 상태입니다. 가능한 값: * 브라우저 요청됨: 테스트 생성 또는 테스트 실행을 위해 브라우저를 시작하라는 요청이 클라우드 인프라에 전송되었습니다. * Completed: 테스트 작업이 완료되었습니다. * 실패 상태: 테스트 작업이 실패했습니다. * 보류 중: 요청한 테스트 활동이 생성되었으며 실행 대기 중입니다. * 처리 중: 인스턴스는 요청이 클라우드 인프라로 전송되기 전에 실행 추적기가 클라우드 실행기에 대해 표시되어 있는지 확인하기 위해 기록을 스캔하고 있습니다. * 실행 중: 클라우드 인프라 브라우저가 보류 중인 테스트를 찾아 실행합니다. {#cr-TestRunnerAPI-GET-test-run-progress__ul_hph_y5h_41c} 데이터 유형: 문자열 |
[ ]

### cURL 요청

다음 요청은 BOQ 기록의 테스트 러너 작업 진행률을 조회합니다.

    curl "http://instance.service-now.com/api/now/sn_atf_tg/test_runner_progress?snboqId=<sys_id of SNBOQ record>" \ 
    --request GET \ 
    --header "Accept:application/json" \ 
    --user "username:password"

응답은 테스트가 100% 완료되었음을 나타냅니다.

    { 
      "result": { 
        "progress": 100, 
        "state": "completed" 
      } 
    }

다음 예제에서는 BOQ ID가 전달되지 않은 경우 400 오류 메시지를 반환합니다.

    curl "http://instance.service-now.com/api/now/sn_atf_tg/test_runner_progress" \
    --request GET \
    --header "Accept:application/json" \
    --user "username:password"

응답:

    {
      "result": {
        "message": "No SNBOQ ID passed in, add snboqId to request body"
      }
    }

다음 예제에서는 잘못된 BOQ ID가 전달되면 400 오류 메시지를 반환합니다.

    curl "http://instance.service-now.com/api/now/sn_atf_tg/test_runner_progress?snboqId=invalid_sys_id" \
    --request GET \
    --header "Accept:application/json" \
    --user "username:password"

응답:

    {
      "result": {
        "message": "Invalid SNBOQ sys_id passed in"
      }
    }

## 클라우드 실행기 테스트 러너 - POST /now/sn_atf_tg/cancel_test_runner {#ariaid-title3}

테스트 러너 작업을 완료 상태로 설정하고 실행 중인 생성된 테스트의 루트 추적기를 취소합니다.

### URL 형식

기본 URL: GET /now/sn_atf_tg/cancel_test_runner

### 지원되는 요청 매개변수

{#cr-TestRunnerAPI-POST-cancel-test-runner__entry__2}

| 이름 | 설명 |
|-|-|
| 없음 |   |
[표 7. 경로 매개변수]

{#cr-TestRunnerAPI-POST-cancel-test-runner__entry__6}

| 이름 | 설명 |
|-|-|
| 안 함 |   |
[표 8. 쿼리 매개변수]

{#cr-TestRunnerAPI-POST-cancel-test-runner__entry__10}

| 이름 | 설명 |
|-|-|
| snboqId | 취소할 테스트 러너 작업과 연결된 브라우저 오케스트레이션 큐(BOQ) 기록(sn_atf_tg_sn_boq)의 Sys_id입니다. 데이터 유형: 문자열 테이블: BOQ \[sn_atf_tg_sn_boq\] |
[표 9. 요청 본문 매개변수(XML 또는 JSON)]

### 헤더

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#cr-TestRunnerAPI-POST-cancel-test-runner__table_ism_z2j_41c__entry__2}{#cr-TestRunnerAPI-POST-cancel-test-runner__accept-RESTAPI}{#cr-TestRunnerAPI-POST-cancel-test-runner__content_type-RESTAPI}

| 머리글 | 설명 |
|-|-|
| 수용 | 응답 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다. 기본값: application/json |
| 콘텐츠-형식 | 요청 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다. 기본값: application/json |
[표 10. 요청 헤더]

{#cr-TestRunnerAPI-POST-cancel-test-runner__table_ism_z2j_41c} {#cr-TestRunnerAPI-POST-cancel-test-runner__entry__20}

| 머리글 | 설명 |
|-|-|
| 안 함 |   |
[표 11. 응답 헤더]

### 상태 코드

이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#cr-TestRunnerAPI-POST-cancel-test-runner__entry__24}{#cr-TestRunnerAPI-POST-cancel-test-runner__entry-200-status-code}

| 상태 코드 | 설명 |
|-|-|
| 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. |
| 400 | 작업을 취소하는 동안 오류가 발생했습니다. 다음 메시지 중 하나를 반환합니다. * 전달된 BOQ ID 없음 -- BOQ ID가 제공되지 않았습니다. 요청 본문에 BOQ ID를 추가합니다. * BOQ 기록을 찾을 수 없음 -- 시스템 ID가 잘못되었습니다. BOQ 기록의 sys_id이 유효하고 기록이 있는지 확인합니다. {#cr-TestRunnerAPI-POST-cancel-test-runner__ul_fzp_ztk_p1c} |
| 403 | 엔드포인트에 대한 사용자 액세스 권한을 부여하는 동안 오류가 발생했습니다. 사용자에게 관리자 역할이 있는지 확인합니다. |
[표 12. 상태 코드]

### 응답 본문 매개변수(JSON 또는 XML)

{#cr-TestRunnerAPI-POST-cancel-test-runner__entry__32}

| 이름 | 설명 |
|-|-|
| 결과 | 요청의 결과를 포함하는 객체입니다. "result": { "message": String } {#cr-TestRunnerAPI-POST-cancel-test-runner__codeblock_hhp_4k2_p1c} 데이터 유형: 객체 |
| 결과.메시지 | 테스트 취소의 성공 여부를 자세히 설명하는 메시지입니다. 데이터 유형: 문자열 |
[ ]

### cURL 요청

다음 예는 BOQ 기록의 sys_id에 따라 테스트 러너 취소 요청을 구성하는 방법을 보여줍니다.

    curl "https://instance.service-now.com/api/now/sn_atf_tg/cancel_test_runner" \ 
    --request POST \ 
    --header "Accept:application/json" \ 
    --header "Content-Type:application/json" \ 
    --data "{\"snboqId\":\"<sys_id of BOQ record>\"}" \ 
    --user "username:password"

테스트 러너가 성공적으로 취소되었음을 나타내는 응답 메시지입니다.

    { 
      "result": { 
        "message": "success" 
      } 
    } 

## 클라우드 실행기 테스트 러너 - POST /now/sn_atf_tg/test_runner {#ariaid-title4}

지정된 테스트 또는 테스트 도구 모음에 대한 BOQ \[sn_atf_tg_sn_boq\] 테이블에 테스트 러너 작업을 삽입한 다음, 클라우드 러너에서 실행됩니다.

### URL 형식

기본 URL: POST api/now/sn_atf_tg/test_runner

### 지원되는 요청 매개변수

{#cr-TestRunnerAPI-POST-test-runner__entry__2}

| 이름 | 설명 |
|-|-|
| 없음 |   |
[표 13. 경로 매개변수]

{#cr-TestRunnerAPI-POST-test-runner__entry__6}

| 이름 | 설명 |
|-|-|
| 안 함 |   |
[표 14. 쿼리 매개변수]

{#cr-TestRunnerAPI-POST-test-runner__entry__10}

| 이름 | 설명 |
|-|-|
| testId | 클라우드 실행기에서 실행할 테스트 \[sys_atf_test\] 또는 테스트 도구 모음 \[sys_atf_test_suite\]의 Sys_id입니다. |
[표 15. 요청 본문 매개변수(XML 또는 JSON)]

### 헤더

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#cr-TestRunnerAPI-POST-test-runner__table_gcx_1fj_41c__entry__2}{#cr-TestRunnerAPI-POST-test-runner__accept-RESTAPI}{#cr-TestRunnerAPI-POST-test-runner__content_type-RESTAPI}

| 머리글 | 설명 |
|-|-|
| 수용 | 응답 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다. 기본값: application/json |
| 콘텐츠-형식 | 요청 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다. 기본값: application/json |
[표 16. 요청 헤더]

{#cr-TestRunnerAPI-POST-test-runner__table_gcx_1fj_41c} {#cr-TestRunnerAPI-POST-test-runner__entry__20}

| 머리글 | 설명 |
|-|-|
| 안 함 |   |
[표 17. 응답 헤더]

### 상태 코드

이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#cr-TestRunnerAPI-POST-test-runner__entry__24}

| 상태 코드 | 설명 |
|-|-|
| 200 | 테스트 러너 BOQ 작업을 성공적으로 삽입했습니다. |
| 400 | 테스트 러너 작업을 시작하는 동안 오류가 발생했습니다. 다음 메시지 중 하나를 반환합니다. * 시스템 ID가 있는 테스트 또는 테스트 도구 모음을 찾을 수 없음 \<testId\> -- 잘못된 테스트 ID. 테스트(sys_atf_test) 또는 테스트 도구 모음(sys_atf_test_suite) 기록의 sys_id이 유효하고 기록이 존재하는지 확인합니다. * 통과된 테스트 ID가 없음 -- 통과된 테스트 ID가 없습니다. 요청 본문에 테스트 ID를 추가합니다. {#cr-TestRunnerAPI-POST-test-runner__ul_uht_ttk_p1c} |
| 403 | 엔드포인트에 대한 사용자 액세스 권한을 부여하는 동안 오류가 발생했습니다. 사용자에게 관리자 역할이 있는지 확인합니다. |
[표 18. 상태 코드]

### 응답 본문 매개변수(JSON 또는 XML)

{#cr-TestRunnerAPI-POST-test-runner__entry__32}

| 이름 | 설명 |
|-|-|
| 결과 | 요청의 결과를 포함하는 객체입니다. 데이터 유형: 객체 { "result": { "snboqId": "String" } } {#cr-TestRunnerAPI-POST-test-runner__codeblock_n5d_sxk_p1c} 또는: "result": { "message": "String" } {#cr-TestRunnerAPI-POST-test-runner__codeblock_hhp_4k2_p1c} |
| result.snboqId | 테스트 러너가 시작될 때 삽입되는 BOQ 기록의 Sys_id입니다. 데이터 유형: 문자열 테이블: BOQ \[sn_atf_tg_sn_boq\] |
| 결과.메시지 | 테스트 러너를 시작할 수 없는 이유를 자세히 설명하는 오류 메시지입니다. 데이터 유형: 문자열 |
[ ]

### cURL 요청

다음 요청은 BOQ \[sn_atf_tg_sn_boq\] 테이블에 테스트 러너 작업을 삽입합니다.

    curl "https://instance.service-now.com/api/now/sn_atf_tg/test_runner" \ 
    --request POST \ 
    --header "Accept:application/json" \ 
    --header "Content-Type:application/json" \ 
    --data "{\"testId\":\"<sys_id of ATF test or test suite>\"}" \ 
    --user "username:password"

응답 본문은 성공적으로 삽입된 테스트 러너 작업의 sys_id 반환합니다.

    { 
      "result": { 
        "snboqId": "<sys_id of newly inserted SNBOQ record>" 
      } 
    }

{#cr-TestRunnerAPI-POST-test-runner__codeblock_bhq_np3_41c}