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

  • 릴리스 버전: Zurich
  • 업데이트 날짜 2025년 07월 31일
  • 소요 시간: 11분

    • Automated Test Framework(ATF)용 클라우드 실행기에서 실행할 테스트를 관리합니다.

    Cloud Runner Test Runner API에는 (sn_atf_tg) 플러그인이 ATF Test Generator and Cloud Runner 필요합니다. 이 API에서 사용할 수 있는 메서드는 now 네임스페이스에서 실행되며, REST API 탐색기에서 API 이름, ATF에 대한 원클릭 회귀 테스트를 사용하여 호출할 수 있습니다. 이 API에 액세스하려면 관리자 역할이 필요합니다.

    다음 작업에 이 API를 사용할 수 있습니다.
    • 클라우드 실행기 브라우저에서 ATF 테스트 또는 테스트 도구 모음을 시작합니다.
    • 테스트 작업의 진행률을 확인합니다.
    • 테스트 작업을 취소합니다.

    Cloud Runner Test Runner API는 및 와 함께 클라우드 실행기 테스트 생성 REST API 사용할 수 있습니다클라우드 실행기 테스트 사용자 REST API. 예를 들어 테스트(Cloud Runner Test Generation API)를 생성한 후 브라우저 오케스트레이션 큐(Cloud Runner TEST Generation API)에서 테스트 진행률을 확인하고 통과 또는 실패한 테스트 수를 확인할 수 있습니다.

    이 API의 서버 API 참조 설명서를 보려면 문서를 참조하십시오 클라우드 실행기 TestRunnerApi – 범위 지정, 전역.

    클라우드 실행기 테스트 실행기 - GET /now/sn_atf_tg/test_runner_progress

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

    URL 형식

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

    지원되는 요청 매개변수

    표 1. 경로 매개변수
    이름 설명
    없음
    표 2. 쿼리 매개변수
    이름 설명
    snboqId 필수 진행률을 가져올 테스트 러너 작업의 BOQ 기록 sys_id입니다.

    데이터 유형: 문자열

    표: BOQ [sn_atf_tg_sn_boq]
    표 3. 요청 본문 매개변수(XML 또는 JSON)
    이름 설명
    없음

    헤더

    다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 이 작업에 고유한 방식으로 적용됩니다. REST API에 사용되는 일반 헤더 목록은 지원되는 REST API 헤더를 참조하세요.

    표 4. 요청 헤더
    헤더 설명
    수용 응답 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다.

    기본값: application/json
    표 5. 응답 헤더
    헤더 설명
    없음

    상태 코드

    다음 상태 코드는 이 HTTP 작업에 적용됩니다. REST API에서 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하세요.

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

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

    이름 설명
    결과 테스트 러너 작업의 진행률 결과 또는 요청이 실패한 이유를 설명하는 메시지가 포함된 객체입니다.

    데이터 유형: 객체

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

    또는:

    {
  "result": { 
    "message": "String" 
  } 
}
    결과.메시지 테스트 러너 진행률을 검색할 수 없는 이유를 자세히 설명하는 오류 메시지입니다. 성공적인 응답에서 메시지 매개변수가 반환되지 않습니다.

    데이터 유형: 문자열
    결과.진행률 실행 중 상태일 때 테스트 완료에 얼마나 가까웠는지를 나타내는 백분율입니다.

    데이터 유형: 숫자
    결과.상태 BOQ 기록의 현재 상태입니다.
    가능한 값:
    • 브라우저 요청됨: 테스트 생성 또는 테스트 실행을 위해 브라우저를 시작하기 위해 요청이 클라우드 인프라로 전송되었습니다.
    • 완료됨: 테스트 작업이 완료되었습니다.
    • 실패한 상태: 테스트 작업이 실패했습니다.
    • 보류 중: 요청한 테스트 활동이 생성되어 실행 대기 중입니다.
    • 처리 중: 요청이 클라우드 인프라로 전송되기 전에 인스턴스가 실행 추적기가 클라우드 실행기에 대해 표시되는지 확인하기 위해 기록을 스캔합니다.
    • 실행 중: 클라우드 인프라 브라우저가 보류 중인 테스트를 찾아 실행합니다.

    데이터 유형: 문자열

    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

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

    URL 형식

    기본 URL: GET /now/sn_atf_tg/cancel_test_runner

    지원되는 요청 매개변수

    표 7. 경로 매개변수
    이름 설명
    없음
    표 8. 쿼리 매개변수
    이름 설명
    없음
    표 9. 요청 본문 매개변수(XML 또는 JSON)
    이름 설명
    snboqId 취소할 테스트 러너 작업과 연결된 BOQ(브라우저 오케스트레이션 큐) 기록(sn_atf_tg_sn_boq)의 Sys_id입니다.

    데이터 유형: 문자열

    표: BOQ [sn_atf_tg_sn_boq]

    헤더

    다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 이 작업에 고유한 방식으로 적용됩니다. REST API에 사용되는 일반 헤더 목록은 지원되는 REST API 헤더를 참조하세요.

    표 10. 요청 헤더
    헤더 설명
    수용 응답 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다.

    기본값: application/json
    콘텐츠-형식 요청 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다.

    기본값: application/json
    표 11. 응답 헤더
    헤더 설명
    없음

    상태 코드

    다음 상태 코드는 이 HTTP 작업에 적용됩니다. REST API에서 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하세요.

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

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

    이름 설명
    결과 요청 결과를 포함하는 객체입니다.
    
  "result": { 
    "message": String
  }

    데이터 유형: 객체
    결과.메시지 테스트 취소가 성공했는지 여부를 자세히 설명하는 메시지입니다.

    데이터 유형: 문자열

    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

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

    URL 형식

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

    지원되는 요청 매개변수

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

    헤더

    다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 이 작업에 고유한 방식으로 적용됩니다. REST API에 사용되는 일반 헤더 목록은 지원되는 REST API 헤더를 참조하세요.

    표 16. 요청 헤더
    헤더 설명
    수용 응답 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다.

    기본값: application/json
    콘텐츠-형식 요청 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다.

    기본값: application/json
    표 17. 응답 헤더
    헤더 설명
    없음

    상태 코드

    다음 상태 코드는 이 HTTP 작업에 적용됩니다. REST API에서 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하세요.

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

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

    이름 설명
    결과 요청 결과를 포함하는 객체입니다.

    데이터 유형: 객체

    { 
  "result": { 
    "snboqId": "String" 
  } 
}

    또는:

    
  "result": { 
    "message": "String"
  }
    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>" 
  } 
}