---
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) 소요 시간: 14분

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를 사용할 수 있습니다.

* 테스트 생성 작업을 시작합니다.
* 테스트 생성 작업의 진행률을 확인합니다.
* 테스트 생성 작업을 취소합니다.
{#cloudrunner-testgeneration-api__cloudrnr-TestGenerationAPI-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/IsuX9pDHIQN0R4KLZNklrA#cloudrunner-testrunner-api "Automated Test Framework(ATF)에 대한 클라우드 실행기에서 실행할 테스트를 관리합니다.") 사용할 수 있습니다. 예를 들어 테스트 생성 API를 호출하여 테스트를 실행한 다음 브라우저 오케스트레이션 큐(클라우드 실행기 테스트 생성 API)에서 테스트 진행률을 확인한 다음 통과하거나 실패한 테스트 수를 확인할 수 있습니다.

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

## 클라우드 실행기 테스트 생성 - GET /now/sn_atf_tg/test_generation_progress {#ariaid-title2}

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

### URL 형식 {#cr-TestGenAPI-GET-test-gen-progress__section_mdy_gwz_31c}

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

### 지원되는 요청 매개변수 {#cr-TestGenAPI-GET-test-gen-progress__section_ndy_gwz_31c}

{#cr-TestGenAPI-GET-test-gen-progress__table_ody_gwz_31c__entry__2}

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

{#cr-TestGenAPI-GET-test-gen-progress__table_ody_gwz_31c} {#cr-TestGenAPI-GET-test-gen-progress__table_pdy_gwz_31c__entry__2}

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

{#cr-TestGenAPI-GET-test-gen-progress__table_pdy_gwz_31c} {#cr-TestGenAPI-GET-test-gen-progress__table_qdy_gwz_31c__entry__2}

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

{#cr-TestGenAPI-GET-test-gen-progress__table_qdy_gwz_31c}

### 헤더 {#cr-TestGenAPI-GET-test-gen-progress__section_rdy_gwz_31c}

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

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

{#cr-TestGenAPI-GET-test-gen-progress__table_sdy_gwz_31c} {#cr-TestGenAPI-GET-test-gen-progress__table_tdy_gwz_31c__entry__2}

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

{#cr-TestGenAPI-GET-test-gen-progress__table_tdy_gwz_31c}

### 상태 코드 {#cr-TestGenAPI-GET-test-gen-progress__section_udy_gwz_31c}

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

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

{#cr-TestGenAPI-GET-test-gen-progress__table_vdy_gwz_31c}

### 응답 본문 매개변수(JSON 또는 XML) {#cr-TestGenAPI-GET-test-gen-progress__section_wdy_gwz_31c}

{#cr-TestGenAPI-GET-test-gen-progress__table_xdy_gwz_31c__entry__2}

| 이름 | 설명 |
|-|-|
| 결과 | 생성된 테스트 작업의 진행 결과 또는 요청 실패 이유를 설명하는 메시지가 포함된 객체입니다. 데이터 유형: 객체 "result": { "testsSucceeded": Number, "testsFailed": Number, "testsPending": Number, "testsInProgress": Number, "testsSkipped": Number } } 또는: { "result": { "message": "String" } } |
| 결과.메시지 | 테스트 생성 진행률을 검색할 수 없는 이유를 자세히 설명하는 오류 메시지입니다. message 매개변수는 성공적인 응답에서 반환되지 않습니다. 데이터 유형: 문자열 |
| result.tests성공 | 통과한 생성된 테스트 수입니다. 데이터 유형: 숫자 |
| result.testsFailed | 실패한 생성된 테스트 수입니다. 데이터 유형: 숫자 |
| result.testsPending | 생성된 테스트를 기다리는 사용 케이스 수입니다. 데이터 유형: 숫자 |
| result.testsInProgress | 테스트가 생성된 사용 사례 수입니다. 데이터 유형: 숫자 |
| result.tests건너뜀 | 작업 취소로 인해 건너뛴 테스트 수입니다. 데이터 유형: 숫자 |
[ ]

{#cr-TestGenAPI-GET-test-gen-progress__table_xdy_gwz_31c}  

### cURL 요청 {#cr-TestGenAPI-GET-test-gen-progress__example_ydy_gwz_31c}

다음 GET 호출은 snboqId 1234와 연결된 생성된 테스트에 대한 진행률 정보를 반환합니다.

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

출력:

    { 
      "result": { 
        "testsSucceeded": 0, 
        "testsFailed": 0, 
        "testsPending": 0, 
        "testsInProgress": 0, 
        "testsSkipped": 161 
      } 
    }

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

    curl "http://instance.service-now.com/api/now/sn_atf_tg/test_generation_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_generation_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_generation {#ariaid-title3}

테스트 생성 작업 및 관련 업데이트 세트 기록을 완료 상태로 설정합니다. 실행 중인 생성된 테스트의 루트 추적기를 취소합니다. 취소 시 진행 중인 테스트 작업이 있는 경우, 이 메서드는 생성된 진행 중인 테스트 기록을 건너뜀으로 설정합니다.
비즈니스 규칙 또는 접근 제어 규칙(ACL) 문제로 인해 테스트가 자동으로 실패하거나 취소될 수 있습니다. 실패 또는 취소된 테스트에 대한 자세한 내용은 생성된 테스트 테이블을 확인하십시오.

### URL 형식

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

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

{#cr-TestGenAPI-POST-cancel-test-gen__entry__2}

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

{#cr-TestGenAPI-POST-cancel-test-gen__entry__6}

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

{#cr-TestGenAPI-POST-cancel-test-gen__table_o1y_cwz_31c__entry__2}

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

{#cr-TestGenAPI-POST-cancel-test-gen__table_o1y_cwz_31c}

### 헤더

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

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

{#cr-TestGenAPI-POST-cancel-test-gen__entry__20}

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

### 상태 코드

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

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

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

{#cr-TestGenAPI-POST-cancel-test-gen__entry__32}

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

### cURL 요청

다음 요청은 지정된 BOQ 기록의 테스트 생성 작업을 취소합니다.

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

응답 본문은 취소의 성공 메시지를 반환합니다.

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

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

    curl "http://instance.service-now.com/api/now/sn_atf_tg/cancel_test_generation" \
    --request POST \
    --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/cancel_test_generation" \
    --request POST \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{\"snboqId\":\"invalid_sys_id\"}" \
    --user "username":"password"

응답:

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

## 클라우드 실행기 테스트 생성 - POST /now/sn_atf_tg/test_generation {#ariaid-title4}

테스트 작업을 시작하기 위해 브라우저 오케스트레이션 큐(BOQ) \[sn_atf_tg_sn_boq\] 테이블에 기록을 삽입합니다.

### URL 형식 {#cr-TestGenAPI-POST-test-generation__section_k1y_cwz_31c}

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

### 지원되는 요청 매개변수 {#cr-TestGenAPI-POST-test-generation__section_l1y_cwz_31c}

{#cr-TestGenAPI-POST-test-generation__table_m1y_cwz_31c__entry__2}

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

{#cr-TestGenAPI-POST-test-generation__table_m1y_cwz_31c} {#cr-TestGenAPI-POST-test-generation__table_n1y_cwz_31c__entry__2}

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

{#cr-TestGenAPI-POST-test-generation__table_n1y_cwz_31c} {#cr-TestGenAPI-POST-test-generation__table_o1y_cwz_31c__entry__2}

| 이름 | 설명 |
|-|-|
| catalogEncodedQuery | 테스트를 생성할 카탈로그 항목을 지정하는 인코딩된 쿼리입니다. 빈 문자열이 모든 카탈로그 항목으로 기본 설정됩니다. 인코딩된 쿼리 구성에 대한 자세한 내용은 다음 문서를 참조하십시오 [Encoded query strings](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=australia&pubname=australia-platform-user-interface&ft:locale=en-US). 데이터 유형: 문자열 |
| 이메일 | 테스트 생성이 완료되면 경보를 보낼 이메일 주소입니다. 데이터 유형: 문자열 |
| maxTestCount | 생성할 전체 테스트 수입니다. 허용되는 값: 1에서 9,999 사이의 모든 숫자. 데이터 유형: 숫자 기본값: 9999 |
| maxTestCountPerItem | 카탈로그 항목당 생성할 테스트 수입니다. 허용되는 값: 1에서 10 사이의 모든 숫자. 데이터 유형: 숫자 기본값: 10 |
| maxTestCountPerTable | 테이블당 생성할 테스트 수입니다. 허용되는 값: 1에서 10 사이의 모든 숫자. 데이터 유형: 숫자 기본값: 10 |
| scopeForGeneratingTests | false로 설정된 경우 separateUpdateSetPerScope 필요합니다. 생성된 모든 테스트를 배치할 범위의 Sys_id입니다. 데이터 유형: 문자열 |
| separateUpdateSetPerScope | 생성된 테스트를 각 도구 모음, 업데이트 세트 및 범위로 분리할지 또는 테스트를 하나의 도구 모음, 업데이트 세트 및 범위에 배치할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 테스트는 각 테이블 또는 카탈로그 항목의 범위에 따라 해당 도구 모음 및 업데이트 세트에 배치됩니다. * false: 생성된 모든 테스트가 동일한 도구 모음, 업데이트 세트 및 범위에 배치됩니다. false scopeForGeneratingTests 인 경우 요청에 필요합니다. {#cr-TestGenAPI-POST-test-generation__ul_l4b_qfj_y1c} 데이터 유형: 부울 기본값: true |
| 테스트 도구 모음 | 옵션입니다. 테스트 생성을 통해 만들 테스트 도구 모음의 이름을 설정합니다. 데이터 유형: 문자열 기본값: ATF 생성 도구 모음 - \<time_stamp\> |
| tableEncodedQuery | 테스트를 생성할 테이블을 지정하는 인코딩된 쿼리입니다. 빈 문자열이 모든 테이블에 기본적으로 적용됩니다. 인코딩된 쿼리 구성에 대한 자세한 내용은 다음 문서를 참조하십시오 [Encoded query strings](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=australia&pubname=australia-platform-user-interface&ft:locale=en-US). 데이터 유형: 문자열 |
| userEncodedQuery | 테스트를 생성할 사용자를 지정하는 인코딩된 쿼리입니다. 빈 문자열 입력은 기본적으로 모든 테이블로 설정됩니다. 인코딩된 쿼리 구성에 대한 자세한 내용은 다음 문서를 참조하십시오 [Encoded query strings](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=australia&pubname=australia-platform-user-interface&ft:locale=en-US). 데이터 유형: 문자열 |
[표 15. 요청 본문 매개변수(XML 또는 JSON)]

{#cr-TestGenAPI-POST-test-generation__table_o1y_cwz_31c}

### 헤더 {#cr-TestGenAPI-POST-test-generation__section_vpj_gxz_31c}

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

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

{#cr-TestGenAPI-POST-test-generation__table_krf_y2j_41c} {#cr-TestGenAPI-POST-test-generation__table_xpj_gxz_31c__entry__2}

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

{#cr-TestGenAPI-POST-test-generation__table_xpj_gxz_31c}

### 상태 코드 {#cr-TestGenAPI-POST-test-generation__section_s1y_cwz_31c}

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

| 상태 코드 | 설명 |
|-|-|
| 200 | 테스트 생성 BOQ 작업을 성공적으로 삽입했습니다. 처리 중 모든 오류는 BOQ 기록 로그에 표시됩니다. 기본적으로 모든 입력은 모든 테이블 및 서비스 카탈로그 항목에 대해 최대 테스트 수를 생성합니다. |
| 403 | 엔드포인트에 대한 사용자 액세스 권한을 부여하는 동안 오류가 발생했습니다. 사용자에게 관리자 역할이 있는지 확인합니다. |
[표 18. 상태 코드]

{#cr-TestGenAPI-POST-test-generation__table_t1y_cwz_31c}

### 응답 본문 매개변수(JSON 또는 XML) {#cr-TestGenAPI-POST-test-generation__section_u1y_cwz_31c}

{#cr-TestGenAPI-POST-test-generation__table_v1y_cwz_31c__entry__2}

| 이름 | 설명 |
|-|-|
| 결과 | 요청의 결과를 포함하는 객체입니다. "result": { "snboqId": String } 데이터 유형: 객체 |
| result.snboqId | 테스트 생성이 시작될 때 sn_atf_tg_sn_boq 테이블에 삽입된 기록의 Sys_id입니다. 데이터 유형: 문자열 |
[ ]

{#cr-TestGenAPI-POST-test-generation__table_v1y_cwz_31c}  

### cURL 요청 {#cr-TestGenAPI-POST-test-generation__example_w1y_cwz_31c}

다음 요청 예시에서는 요청 매개변수 없이 인스턴스에서 새 테스트 작업을 시작하고 BOQ 테이블에 작업을 삽입합니다.

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

응답 본문:

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

다음 요청 예시에서는 최대 테스트 수가 2인 새 테스트 작업을 시작하고 테스트를 인시던트 테이블로 필터링한 다음 BOQ 테이블에 작업을 삽입합니다.

    curl "http://instance.service-now.com/api/now/sn_atf_tg/test_generation" \ 
    --request POST \ 
    --header "Accept:application/json" \ 
    --header "Content-Type:application/json" \ 
    --data "{\"maxTestCount\":\"2\",\"tableEncodedQuery\":\"name=incident\",\"testSuite\":\"Suite123\"}" \ 
    --user "username":"password"

{#cr-TestGenAPI-POST-test-generation__codeblock_grj_5ph_41c}

응답 본문:

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

{#cr-TestGenAPI-POST-test-generation__codeblock_pkx_5ph_41c}