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


---

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

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

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

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

* 사용자 테스트 작업을 시작합니다.
* 클라우드 사용자를 설정합니다.
* 지정된 사용자가 유효한지 확인합니다.
* 사용자 테스트 작업의 진행률을 확인합니다.
* 테스트 작업을 취소합니다.
{#cloudrnr-TestUserAPI-scoped__cloudrnr-TestUserAPI-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 스크립트 포함의 일부입니다.")
* [클라우드 실행기 TestRunnerApi -- 범위, 전역](https://servicenow-prod.fluidtopics.net/fd7xPlOEOW_6VoOFU66KNw#cloudrnr-TestRunnerAPI-scoped "Automated Test Framework(ATF)에 대한 클라우드 실행기에서 실행할 테스트를 관리합니다. 이 API는 CloudRunnerApi 스크립트 포함의 일부입니다.")
* [클라우드 실행기 테스트 러너 REST API](https://servicenow-prod.fluidtopics.net/IsuX9pDHIQN0R4KLZNklrA#cloudrunner-testrunner-api "Automated Test Framework(ATF)에 대한 클라우드 실행기에서 실행할 테스트를 관리합니다.")
{#cloudrnr-TestUserAPI-scoped__ul_gd4_zsn_31c}

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

브라우저 오케스트레이션 큐 \[sn_atf_tg_sn_boq\] 테이블에서 테스트 사용자 작업 상태를 완료로 설정합니다.
{#cr-TestUserAPI-cancelJob_S__table_epx_lv4_g1c__entry__3}{#cr-TestUserAPI-cancelJob_S__cr-snboqId-ph-desc}

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

{#cr-TestUserAPI-cancelJob_S__table_epx_lv4_g1c} {#cr-TestUserAPI-cancelJob_S__table_fpx_lv4_g1c__entry__2}

| 유형 | 설명 |
|-|-|
| null | 성공하면 Null이고, 그렇지 않으면 오류 메시지입니다. |
| 오류 | 실패할 경우 발생할 수 있는 오류 메시지: * 전달된 BOQ ID 없음 -- 제공된 JSON 객체에 BOQ ID 항목이 없습니다. JSON 객체가 `{snboqId: "<sys_id>"}`로 구조화되어 있는지 확인합니다. * 잘못된 BOQ sys_id 전달됨 -- 제공된 ID는 브라우저 오케스트레이션 큐\[sn_atf_tg_sn_boq\] 테이블의 BOQ 기록용이어야 합니다. {#cr-TestUserAPI-cancelJob_S__ul_wqr_slb_j1c} |
[표 2. 반환]

{#cr-TestUserAPI-cancelJob_S__table_fpx_lv4_g1c}  
다음 예시에서는 관리자 사용자에 대해 테스트 사용자를 시작하고, 진행률을 확인하고, 테스트 사용자를 취소하는 방법을 보여줍니다. 잠긴 사용자를 유효한 클라우드 사용자로 확인한 후 코드는 클라우드 사용자를 ITIL 관리자로 설정합니다. 전역 범위에서 sn_atf_tg 네임스페이스를 사용합니다.

    var snboqId = CloudRunnerAPI.TestUserAPI.startJob({username: "abel.tuter"});

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

    CloudRunnerAPI.TestUserAPI.cancelJob({snboqId: snboqId});

    gs.info(CloudRunnerAPI.TestUserAPI.isValidCloudUser({username: <name of the user who has been locked out>}));

    CloudRunnerAPI.TestUserAPI.selectCloudUser({username: "itil_admin"});

출력:

    {progress: 64, state: running}
    User is missing the following criteria: 
    	User is locked out
    False

## TestUserApi -- isValidCloudUser(문자열, 사용자 이름) {#ariaid-title3}

제공된 사용자가 유효한 클라우드 사용자인지 확인합니다.
{#cr-TestUserAPI-isValidCloudUser_S__table_epx_lv4_g1c__entry__3}{#cr-TestUserAPI-isValidCloudUser_S__cr-userNm-ph-desc}

| 이름 | 유형 | 설명 |
|-|-|-|
| username | 객체 | 필수 사용자 \[sys_user\] 테이블에 나열된 유효한 사용자의 사용자 ID입니다. 이 값은 JSON 객체에서 문자열로 제공됩니다. 예: `{username: "abel.tuter"}`. |
[표 3. 매개변수]

{#cr-TestUserAPI-isValidCloudUser_S__table_epx_lv4_g1c} {#cr-TestUserAPI-isValidCloudUser_S__table_fpx_lv4_g1c__entry__2}

| 유형 | 설명 |
|-|-|
| 부울 | 제공된 사용자가 유효한 클라우드 사용자인지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 제공된 사용자가 올바른 클라우드 사용자입니다. * false: 다음 중 하나 이상의 이유로 제공된 사용자가 잘못되었습니다. * 사용자를 찾을 수 없습니다. * 사용자가 비활성 상태입니다. * 사용자가 잠겼습니다. * 사용자는 암호 재설정이 필요합니다. * 사용자에게 관리자 역할이 없습니다. * 사용자에게 읽기 전용 액세스 권한이 있습니다. * 사용자는 웹 서비스만 액세스할 수 있습니다. {#cr-TestUserAPI-isValidCloudUser_S__ul_gzz_dcg_m1c} {#cr-TestUserAPI-isValidCloudUser_S__ul_ofc_wzf_m1c} |
[표 4. 반환]

{#cr-TestUserAPI-isValidCloudUser_S__table_fpx_lv4_g1c}  
다음 예시에서는 관리자 사용자에 대해 테스트 사용자를 시작하고, 진행률을 확인하고, 테스트 사용자를 취소하는 방법을 보여줍니다. 잠긴 사용자를 유효한 클라우드 사용자로 확인한 후 코드는 클라우드 사용자를 ITIL 관리자로 설정합니다. 전역 범위에서 sn_atf_tg 네임스페이스를 사용합니다.

    var snboqId = CloudRunnerAPI.TestUserAPI.startJob({username: "abel.tuter"});

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

    CloudRunnerAPI.TestUserAPI.cancelJob({snboqId: snboqId});

    gs.info(CloudRunnerAPI.TestUserAPI.isValidCloudUser({username: <name of the user who has been locked out>}));

    CloudRunnerAPI.TestUserAPI.selectCloudUser({username: "itil_admin"});

출력:

    {progress: 64, state: running}
    User is missing the following criteria: 
    	User is locked out
    False

## TestUserApi -- progress(문자열 snboqId) {#ariaid-title4}

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

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

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

| 유형 | 설명 |
|-|-|
| 객체 | 테스트 진행률을 나타내는 JSON 객체입니다. { "progress": Number, "state": "String" } |
| 객체.진행률 | 테스트 진행률이 완료되었음을 나타냅니다. 유형: 번호 |
| 객체.상태 | BOQ 기록의 상태입니다. 가능한 값: * 보류 중 -- 요청된 테스트 활동이 생성되었으며 실행되기를 기다리고 있습니다.{#cr-TestUserAPI-progress_S__cr-prog-state-li-pending} {#cr-TestUserAPI-progress_S__cr-prog-state-li-pending} * 처리 중 -- 인스턴스는 요청이 클라우드 인프라로 전송되기 전에 실행 추적기가 클라우드 실행기에 대해 표시되어 있는지 확인하기 위해 기록을 스캔하고 있습니다. * 브라우저 요청됨 -- 테스트 생성 또는 테스트 실행을 위해 브라우저를 시작하라는 요청이 클라우드 인프라에 전송되었습니다.{#cr-TestUserAPI-progress_S__cr-prog-state-li-brsreq} {#cr-TestUserAPI-progress_S__cr-prog-state-li-brsreq} * 실행 중 -- 클라우드 인프라 브라우저가 보류 중인 테스트를 찾아 실행합니다. * 완료됨 - 테스트 작업이 완료되었습니다.{#cr-TestUserAPI-progress_S__cr-prog-state-li-complete} {#cr-TestUserAPI-progress_S__cr-prog-state-li-complete} * 실패 상태 -- 테스트 작업이 실패했습니다.{#cr-TestUserAPI-progress_S__cr-prog-state-li-failed} {#cr-TestUserAPI-progress_S__cr-prog-state-li-failed} {#cr-TestUserAPI-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-TestUserAPI-progress_S__ul_wqr_slb_j1c} |
[표 6. 반환]

{#cr-TestUserAPI-progress_S__table_fpx_lv4_g1c}  
다음 예시에서는 관리자 사용자에 대해 테스트 사용자를 시작하고, 진행률을 확인하고, 테스트 사용자를 취소하는 방법을 보여줍니다. 잠긴 사용자를 유효한 클라우드 사용자로 확인한 후 코드는 클라우드 사용자를 ITIL 관리자로 설정합니다. 전역 범위에서 sn_atf_tg 네임스페이스를 사용합니다.

    var snboqId = CloudRunnerAPI.TestUserAPI.startJob({username: "abel.tuter"});

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

    CloudRunnerAPI.TestUserAPI.cancelJob({snboqId: snboqId});

    gs.info(CloudRunnerAPI.TestUserAPI.isValidCloudUser({username: <name of the user who has been locked out>}));

    CloudRunnerAPI.TestUserAPI.selectCloudUser({username: "itil_admin"});

출력:

    {progress: 64, state: running}
    User is missing the following criteria: 
    	User is locked out
    False

## TestUserApi -- selectCloudUser(문자열 사용자 이름) {#ariaid-title5}

클라우드 실행기에서 엔드 투 엔드 테스트 사용자 작업을 시작합니다. 사용자가 관리자 역할로 올바르게 로그인할 수 있으면 클라우드 실행기 인프라에서 추후 테스트 실행 및 테스트 생성을 위해 클라우드 사용자 속성이 이 사용자로 설정됩니다.
{#cr-TestUserAPI-selectCloudUser_S__table_epx_lv4_g1c__entry__3}{#cr-TestUserAPI-selectCloudUser_S__cr-userNm-ph-desc}

| 이름 | 유형 | 설명 |
|-|-|-|
| username | 객체 | 필수 사용자 \[sys_user\] 테이블에 나열된 유효한 사용자의 사용자 ID입니다. 이 값은 JSON 객체에서 문자열로 제공됩니다. 예: `{username: "abel.tuter"}`. |
[표 7. 매개변수]

{#cr-TestUserAPI-selectCloudUser_S__table_epx_lv4_g1c} {#cr-TestUserAPI-selectCloudUser_S__table_fpx_lv4_g1c__entry__2}

| 유형 | 설명 |
|-|-|
| null | 성공하면 Null입니다. 그렇지 않은 경우 오류 메시지입니다. 클라우드 사용자를 클라우드 사용자로 설정할 수 없음 유효하지 않음 - 이 오류는 다음 중 하나 이상의 이유로 제공된 사용자가 잘못되었음을 나타냅니다. * 사용자를 찾을 수 없습니다. * 사용자가 비활성 상태입니다. * 사용자가 잠겼습니다. * 사용자는 암호 재설정이 필요합니다. * 사용자에게 관리자 역할이 없습니다. * 사용자에게 읽기 전용 액세스 권한이 있습니다. * 사용자는 웹 서비스만 액세스할 수 있습니다. {#cr-TestUserAPI-selectCloudUser_S__ul_gzz_dcg_m1c} |
[표 8. 반환]

{#cr-TestUserAPI-selectCloudUser_S__table_fpx_lv4_g1c}  
다음 예시에서는 관리자 사용자에 대해 테스트 사용자를 시작하고, 진행률을 확인하고, 테스트 사용자를 취소하는 방법을 보여줍니다. 잠긴 사용자를 유효한 클라우드 사용자로 확인한 후 코드는 클라우드 사용자를 ITIL 관리자로 설정합니다. 전역 범위에서 sn_atf_tg 네임스페이스를 사용합니다.

    var snboqId = CloudRunnerAPI.TestUserAPI.startJob({username: "abel.tuter"});

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

    CloudRunnerAPI.TestUserAPI.cancelJob({snboqId: snboqId});

    gs.info(CloudRunnerAPI.TestUserAPI.isValidCloudUser({username: <name of the user who has been locked out>}));

    CloudRunnerAPI.TestUserAPI.selectCloudUser({username: "itil_admin"});

출력:

    {progress: 64, state: running}
    User is missing the following criteria: 
    	User is locked out
    False

## TestUserApi -- startJob(문자열 사용자 이름) {#ariaid-title6}

클라우드 실행기에서 엔드 투 엔드 테스트 사용자 작업을 시작합니다.
{#cr-TestUserAPI-startJob_S__table_epx_lv4_g1c__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| username | 문자열 | 필수 클라우드 실행기의 엔드 투 엔드 인프라를 테스트할 sys_user의 사용자 이름입니다. |
[표 9. 매개변수]

{#cr-TestUserAPI-startJob_S__table_epx_lv4_g1c} {#cr-TestUserAPI-startJob_S__table_fpx_lv4_g1c__entry__2}

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

{#cr-TestUserAPI-startJob_S__table_fpx_lv4_g1c}  
다음 예시에서는 관리자 사용자에 대해 테스트 사용자를 시작하고, 진행률을 확인하고, 테스트 사용자를 취소하는 방법을 보여줍니다. 잠긴 사용자를 유효한 클라우드 사용자로 확인한 후 코드는 클라우드 사용자를 ITIL 관리자로 설정합니다. 전역 범위에서 sn_atf_tg 네임스페이스를 사용합니다.

    var snboqId = CloudRunnerAPI.TestUserAPI.startJob({username: "abel.tuter"});

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

    CloudRunnerAPI.TestUserAPI.cancelJob({snboqId: snboqId});

    gs.info(CloudRunnerAPI.TestUserAPI.isValidCloudUser({username: <name of the user who has been locked out>}));

    CloudRunnerAPI.TestUserAPI.selectCloudUser({username: "itil_admin"});

출력:

    {progress: 64, state: running}
    User is missing the following criteria: 
    	User is locked out
    False