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

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-testuser-api__cloudrnr-TestUserAPI-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 참조 문서를 보려면 다음 문서를 참조하십시오 [클라우드 실행기 TestUserApi - 범위, 전역](https://servicenow-prod.fluidtopics.net/liIGMaY80uOkcdjI0WE0WQ#cloudrnr-TestUserAPI-scoped "Automated Test Framework(ATF)용 클라우드 실행기에서 실행할 테스트 사용자 작업을 관리합니다. 이 API는 CloudRunnerApi 스크립트 포함의 일부입니다.").

## 클라우드 실행기 테스트 사용자 - GET /now/sn_atf_tg/test_user_progress {#ariaid-title2}

제공된 BOQ(브라우저 오케스트레이션 큐) 기록에 대한 테스트 사용자 작업의 상태를 제공합니다.

### URL 형식

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

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

{#cr-TestUserAPI-GET-test-user-progress__entry__2}

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

{#cr-TestUserAPI-GET-test-user-progress__entry__6}

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

{#cr-TestUserAPI-GET-test-user-progress__entry__10}

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

### 헤더

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

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

{#cr-TestUserAPI-GET-test-user-progress__entry__18}

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

### 상태 코드

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

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

{#cr-TestUserAPI-GET-test-user-progress__table_u3v_zh3_j1c}

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

{#cr-TestUserAPI-GET-test-user-progress__entry__30}

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

### cURL 요청

다음 요청 예시는 테스트 사용자 작업의 진행률을 확인하는 방법을 보여줍니다.

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

응답 본문:

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

## 클라우드 실행기 테스트 사용자 - GET /now/sn_atf_tg/is_valid_cloud_user {#ariaid-title3}

제공된 사용자가 유효한 클라우드 사용자인지 확인합니다.
이 메서드는 사용자가 다음 기준을 충족하는지 확인합니다.

* 존재함,
* 활성 여부,
* 잠겨 있지 않음,
* 암호 재설정이 필요합니다.
* 관리자입니다.
* 읽기 전용입니다.
* 웹 서비스 전용인지 여부

### URL 형식

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

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

{#cr-TestUserAPI-GET-is_valid_cloud_user__entry__2}

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

{#cr-TestUserAPI-GET-is_valid_cloud_user__entry__6}

| 이름 | 설명 |
|-|-|
| username | 필수 사용자가 다음 기준선 기준을 충족하는지 확인할 sys_user의 사용자 이름입니다. * 존재함, * 활성 여부, * 잠겨 있지 않음, * 암호 재설정이 필요합니다. * 관리자입니다. * 읽기 전용입니다. * 웹 서비스 전용인지 여부 {#cr-TestUserAPI-GET-is_valid_cloud_user__ul_orh_qnl_p1c} 이러한 조건 중 하나라도 실패하면 API는 실패한 기준에 대한 메시지와 함께 false 부울을 반환합니다. 데이터 유형: 문자열 |
[표 8. 쿼리 매개변수]

{#cr-TestUserAPI-GET-is_valid_cloud_user__entry__10}

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

### 헤더

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

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

{#cr-TestUserAPI-GET-is_valid_cloud_user__entry__18}

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

### 상태 코드

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

| 상태 코드 | 설명 |
|-|-|
| 200 | 사용자가 유효하고 클라우드 사용자 기준을 충족하는 경우 예 또는 아니오를 반환합니다. |
| 403 | 엔드포인트에 대한 사용자 액세스 권한을 부여하는 동안 오류가 발생했습니다. 사용자에게 관리자 역할이 있는지 확인합니다. |
[표 12. 상태 코드]

{#cr-TestUserAPI-GET-is_valid_cloud_user__table_u3v_zh3_j1c}

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

{#cr-TestUserAPI-GET-is_valid_cloud_user__entry__28}

| 이름 | 설명 |
|-|-|
| 결과 | 요청의 결과를 포함하는 객체입니다. "result": { "validUser": Boolean } {#cr-TestUserAPI-GET-is_valid_cloud_user__codeblock_hhp_4k2_p1c} 데이터 유형: 객체 |
| result.validUser | 사용자가 클라우드 사용자 기준을 충족하는지 여부를 나타내는 플래그입니다. 예일 때는 사용자가 기준을 충족합니다. 데이터 유형: 부울 |
[ ]

### cURL 요청

다음 요청은 제공된 sys_user가 클라우드 기능을 사용하기 위한 기준을 충족하는지 확인합니다.

    curl "http://instance.service-now.com/api/now/sn_atf_tg/is_valid_cloud_user?username=<username of sys_user to check>" \ 
    --request GET \ 
    --header "Accept:application/json" \ 
    --user "username:password"

응답 본문:

    { 
      "result": { 
        "validUser": <Boolean value indicating whether user is valid cloud user> 
      } 
    }

## 클라우드 실행기 테스트 사용자 - POST /now/sn_atf_tg/test_user {#ariaid-title4}

지정된 사용자 이름에 대해 BOQ \[sn_atf_tg_sn_boq\] 테이블에 테스트 사용자 작업을 삽입한 다음 클라우드 실행기에서 실행됩니다.

### URL 형식

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

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

{#cr-TestUserAPI-POST-test-user__entry__2}

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

{#cr-TestUserAPI-POST-test-user__entry__6}

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

{#cr-TestUserAPI-POST-test-user__entry__10}

| 이름 | 설명 |
|-|-|
| username | 필수 클라우드 실행기의 엔드 투 엔드 인프라를 테스트할 sys_user의 사용자 이름입니다. 데이터 유형: 문자열 |
[표 15. 요청 본문 매개변수(XML 또는 JSON)]

### 헤더

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

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

{#cr-TestUserAPI-POST-test-user__table_xh4_cfj_41c} {#cr-TestUserAPI-POST-test-user__entry__20}

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

### 상태 코드

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

| 상태 코드 | 설명 |
|-|-|
| 200 | 테스트 사용자 BOQ 작업을 성공적으로 삽입했습니다. |
| 400 | 테스트 사용자 작업을 시작하는 동안 오류가 발생했습니다. 빈 사용자 이름이 제공되거나 테이블에서 사용자를 찾을 수 없는 경우 서버에서 오류가 발생합니다sys_user. |
| 403 | 엔드포인트에 대한 사용자 액세스 권한을 부여하는 동안 오류가 발생했습니다. 사용자에게 관리자 역할이 있는지 확인합니다. |
[표 18. 상태 코드]

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

{#cr-TestUserAPI-POST-test-user__entry__32}

| 이름 | 설명 |
|-|-|
| 결과 | 요청의 결과를 포함하는 객체입니다. "result": { "snboqId": String } 또는: "result": { "message": "String" } 데이터 유형: 객체 |
| 결과.메시지 | 사용자 이름에 테스트 기능을 할당할 수 없는 이유를 자세히 설명하는 오류 메시지입니다. message 매개변수는 성공적인 응답에서 반환되지 않습니다. 데이터 유형: 문자열 |
| result.snboqId | 테스트 사용자 작업이 성공적으로 시작될 때 삽입되는 BOQ 기록의 Sys_id입니다. 데이터 유형: 문자열 테이블: BOQ \[sn_atf_tg_sn_boq\] |
[ ]

### cURL 요청

다음 요청 예는 지정된 사용자 이름에 대해 BOQ \[sn_atf_tg_sn_boq\] 테이블에 테스트 사용자 작업을 삽입하는 방법을 보여줍니다.

    curl "http://instance.service-now.com/api/now/sn_atf_tg/test_user" \ 
    --request POST \ 
    --header "Accept:application/json" \ 
    --header "Content-Type:application/json" \ 
    --data "{\"username\":\"<username of sys_user to test cloud infrastructure>\"}" \ 
    --user "username:password"

응답은 테스트 사용자 작업이 시작될 때 삽입되는 BOQ 기록의 sys_id를 반환합니다.

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

다음 예제에서는 사용자 이름이 전달되지 않았거나 잘못된 사용자 이름을 전달하면 400 오류 메시지를 반환합니다.

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

응답:

    {
      "result": {
        "message": "Unable to set cloud user as cloud user not valid"
      }
    }

## 클라우드 실행기 테스트 사용자 - POST /now/sn_atf_tg/cancel_test_user {#ariaid-title5}

브라우저 오케스트레이션 큐(BOQ) \[sn_atf_tg_sn_boq\] 테이블에서 테스트 사용자 작업 상태가 완료되도록 설정합니다.

### URL 형식

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

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

{#cr-TestUserAPI-POST-cancel-test-user__entry__2}

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

{#cr-TestUserAPI-POST-cancel-test-user__entry__6}

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

{#cr-TestUserAPI-POST-cancel-test-user__entry__10}

| 이름 | 설명 |
|-|-|
| snboqId | 필수 테스트 사용자 작업과 관련하여 취소할 BOQ 기록의 Sys_id입니다. 데이터 유형: 문자열 테이블: SNBOQ \[sn_atf_tg_sn_boq\] |
[표 21. 요청 본문 매개변수(XML 또는 JSON)]

### 헤더

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

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

{#cr-TestUserAPI-POST-cancel-test-user__table_m4k_dfj_41c} {#cr-TestUserAPI-POST-cancel-test-user__entry__20}

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

### 상태 코드

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

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

{#cr-TestUserAPI-POST-cancel-test-user__table_u3v_zh3_j1c}

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

{#cr-TestUserAPI-POST-cancel-test-user__entry__32}

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

### cURL 요청

다음 요청은 브라우저 오케스트레이션 큐 \[sn_atf_tg_sn_boq\] 테이블에서 테스트 사용자 작업을 취소하는 방법을 보여줍니다.

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

성공적인 응답 본문:

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

## 클라우드 실행기 테스트 사용자 - 게시 /now/sn_atf_tg/select_cloud_user {#ariaid-title6}

클라우드 실행기에서 엔드 투 엔드 테스트 사용자 작업을 시작합니다. 사용자가 관리자 역할로 로그인할 수 있는 경우, 이후 테스트 실행 및 테스트 생성에 대해 클라우드 사용자 속성은 기본적으로 이 사용자로 설정됩니다.

### URL 형식

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

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

{#cr-TestUserAPI-POST-select-cloud-user__entry__2}

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

{#cr-TestUserAPI-POST-select-cloud-user__entry__6}

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

{#cr-TestUserAPI-POST-select-cloud-user__entry__10}

| 이름 | 설명 |
|-|-|
| username | 필수 향후 테스트 러너 및 테스트 생성 작업을 위해 클라우드 사용자를 테스트하고 설정할 sys_user의 사용자 이름입니다. 데이터 유형: 문자열 |
[표 27. 요청 본문 매개변수(XML 또는 JSON)]

### 헤더

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

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

{#cr-TestUserAPI-POST-select-cloud-user__table_g43_2fj_41c} {#cr-TestUserAPI-POST-select-cloud-user__entry__20}

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

### 상태 코드

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

| 상태 코드 | 설명 |
|-|-|
| 200 | 엔드 투 엔드 클라우드 실행기 인프라를 성공적으로 테스트하고 향후 테스트 실행 및 테스트 생성 작업을 위해 클라우드 사용자를 설정했습니다. |
| 400 | 전체 엔드 투 엔드 클라우드 실행기 인프라를 테스트하고 클라우드 사용자를 설정하는 동안 오류가 발생했습니다. 사용자 이름이 비어 있지 않거나 해당 사용자가 지정된 사용자 이름의 sys_user 테이블에 있는지 확인합니다. |
| 403 | 엔드포인트에 대한 사용자 액세스 권한을 부여하는 동안 오류가 발생했습니다. 사용자에게 관리자 역할이 있는지 확인합니다. |
[표 30. 상태 코드]

{#cr-TestUserAPI-POST-select-cloud-user__table_u3v_zh3_j1c}

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

{#cr-TestUserAPI-POST-select-cloud-user__entry__32}

| 이름 | 설명 |
|-|-|
| 결과 | 요청의 결과를 포함하는 객체입니다. "result": { "message": "String" } {#cr-TestUserAPI-POST-select-cloud-user__codeblock_hhp_4k2_p1c} 데이터 유형: 객체 |
| 결과.메시지 | 클라우드 실행기 인프라에서 향후 테스트 실행 및 테스트 생성을 위해 사용자가 성공적으로 선택되었는지 여부를 자세히 설명하는 메시지입니다. 데이터 유형: 문자열 |
[ ]

### cURL 요청

다음 예는 클라우드 실행기 인프라에서 추후 테스트 실행 및 테스트 생성을 위해 특정 사용자를 선택하도록 요청하는 방법을 보여줍니다.

    curl "https://instance.service-now.com/api/now/sn_atf_tg/select_cloud_user" \ 
    --request POST \ 
    --header "Accept:application/json" \ 
    --header "Content-Type:application/json" \ 
    --data "{\"username\":\"<username of sys_user to set as cloud user>\"}" \ 
    --user "username:password"

응답 본문은 테스트 실행 및 생성을 위해 클라우드 사용자가 성공적으로 선택되었음을 나타내는 성공 메시지를 반환합니다.

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


