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


---

# RESTResponseV2 - 범위 지정, 전역

# RESTResponseV2 - 범위 지정, 전역 {#ariaid-title1}

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

RESTResponseV2 API는 아웃바운드 REST 메시지에 의해 반환된 데이터를 JavaScript 코드에서 사용할 수 있는 메서드를 제공합니다.

RESTResponseV2 개체는 RESTMessageV2 메서드 execute() 및 executeAsync()에 의해 반환됩니다.

범위가 지정된 애플리케이션 또는 전역 범위 내에서 이 API를 사용할 수 있습니다.

이 API는 `sn_ws` 네임스페이스에서 실행됩니다.

## RESTResponseV2 - getAllHeaders() {#ariaid-title2}

중복 헤더를 포함하여 응답에 포함된 모든 헤더를 반환합니다.
{#RRV2-getAllHeaders__table_hyh_l1l_gz__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 1. 매개변수]

{#RRV2-getAllHeaders__table_hyh_l1l_gz} {#RRV2-getAllHeaders__table_iyh_l1l_gz__entry__2}

| 유형 | 설명 |
|-|-|
| 목록\<GlideHTTPHeader\> | 응답에 포함된 헤더 목록입니다. 각 헤더는 헤더 <var class="keyword varname">이름</var> 과 <var class="keyword varname">값을</var> 포함하는 GlideHTTPHeader 객체로 표시됩니다. |
[표 2. 반환]

{#RRV2-getAllHeaders__table_iyh_l1l_gz}  
다음 코드 예제에서는 REST 테이블 API를 호출하는 방법을 보여 주고 응답에 있는 모든 헤더를 나열합니다.

    var request = new sn_ws.RESTMessageV2();
    request.setEndpoint('http://<SN_Instance_host>/api/now/table/incident');
    request.setHttpMethod('GET');

    request.setBasicAuth('username', 'password');
    request.setRequestHeader("Accept", "application/json");
    var res = request.execute();
    if (res.getStatusCode() != 200) {
      gs.info('Bad Request');
    }

    var headers = res.getAllHeaders();
    for(var i in headers){
      gs.info(headers[i].name + ': ' + headers[i].value);
    }

응답 헤더

    X-Is-Logged-In: true
    X-Transaction-ID: e3003cb2db8c
    X-Total-Count: 66
    X-Content-Type-Options: nosniff
    Pragma: no-store,no-cache
    Cache-Control: no-cache,no-store,must-revalidate,max-age=-1
    Expires: 0
    Content-Type: application/json;charset=UTF-8
    Date: Fri, 14 May 2021 16:05:10 GMT
    Connection: close
    Server: ServiceNow
    JSESSIONID=5041870726ADADFAB2EE2BF8E7E01596; Path=/; HttpOnly; SameSite=None; Secure
    Set-Cookie: glide_user=; Max-Age=0; Expires=Thu, 01-Jan-1970 00:00:10 GMT; Path=/; HttpOnly; SameSite=None; Secure
    Set-Cookie: glide_user_session=; Max-Age=0; Expires=Thu, 01-Jan-1970 00:00:10 GMT; Path=/; HttpOnly; SameSite=None; Secure
    Set-Cookie: glide_user_route=glide.f1aa2015b3fa5fa8dfe567386cde8fd5; Max-Age=2147483647; Expires=Wed, 01-Jun-2089 19:19:17 GMT; Path=/; HttpOnly; SameSite=None; Secure
    Set-Cookie: glide_session_store=AF003CB2DB8CF8103DD9C39D139619C7; Max-Age=1800; Expires=Fri, 14-May-2021 16:35:10 GMT; Path=/; HttpOnly; SameSite=None; Secure
    Set-Cookie: BIGipServerpool_ddershem=2643023626.45630.0000; path=/; Httponly; Secure; SameSite=None; Secure
    Strict-Transport-Security: max-age=63072000; includeSubDomains

## RESTResponseV2 - getBody() {#ariaid-title3}

REST 응답 본문의 내용을 가져옵니다.
요청 본문을 텍스트 콘텐츠로 가져오려는 경우 이 기능을 사용합니다. 응답을 이진 첨부 파일로 저장할 때는 이 방법을 사용하지 마십시오. RESTMessageV2 개체가 saveResponseBodyAsAttachment(...) 함수를 호출하는 경우 연결된 RESTResponseV2 개체에서 getBody() 를 사용하면 오류가 발생합니다. 응답을 첨부 파일로 저장할 때 아웃바운드 REST 메시지가 실패하면 응답에서 getErrorMessage() 를 호출하여 본문 콘텐츠를 검색합니다.
{#r_RESTResponseV2-getBody__table_vy2_525_jqg__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 3. 매개변수]

{#r_RESTResponseV2-getBody__table_vy2_525_jqg} {#r_RESTResponseV2-getBody__table_qpt_3f5_jq__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | REST 응답 본문입니다. |
[표 4. 반환]

{#r_RESTResponseV2-getBody__table_qpt_3f5_jq}  

    var sm = new sn_ws.RESTMessageV2("Yahoo Finance","get"); //Might throw exception if message doesn't exist or not visible due to scope.
    var response = sm.execute();
    var responseBody = response.getBody();

## RESTResponseV2 - get쿠키() {#ariaid-title4}

응답에 포함된 모든 쿠키를 반환합니다.
{#r_RESTResponseV2-getCookies__table_wcc_nbw_ns__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 5. 매개변수]

{#r_RESTResponseV2-getCookies__table_wcc_nbw_ns} {#r_RESTResponseV2-getCookies__table_xcc_nbw_ns__entry__2}

| 유형 | 설명 |
|-|-|
| 객체 | 쿠키를 나타내는 문자열의 배열입니다. 배열을 반복하여 각 쿠키에 대한 작업을 수행합니다. |
[표 6. 반환]

{#r_RESTResponseV2-getCookies__table_xcc_nbw_ns}  
응답에서 개별 쿠키를 표시합니다.

    var cookies = response.getCookies();
    for (var i = 0; i < cookies.length; i++) {
      gs.info('cookie: ' + cookies.get(i));
    }

출력:

    cookie: JSESSIONID=4135AA97A5D12DA22EF614AA2B0CAFD8.node20; Path=/; Secure; HttpOnly
    cookie: SABASESSIONID=370152970.36895.0000; path=/

## RESTResponseV2 - getErrorCode() {#ariaid-title5}

REST 트랜잭션 중에 오류가 발생한 경우 숫자 오류 코드를 가져옵니다.
이 오류 코드는 HTTP 오류 코드가 아닙니다.ServiceNow AI Platform ServiceNow 고객 지원의 도움이 필요한 경우 이 오류 코드를 제공하십시오.  
주:  
실제 오류 메시지의 내용을 검색하려면 [getBody()](https://servicenow-prod.fluidtopics.net/tvMVBuqNUND4Yqbu_l0O4Q#r_RESTResponseV2-getBody "REST 응답 본문의 내용을 가져옵니다.") 메서드를 사용합니다.
{#r_RESTResponseV2-getErrorCode__table_vy2_525_jqh__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 7. 매개변수]

{#r_RESTResponseV2-getErrorCode__table_vy2_525_jqh} {#r_RESTResponseV2-getErrorCode__table_qpt_3f5_jq__entry__2}

| 유형 | 설명 |
|-|-|
| 번호 | 숫자 오류 코드입니다(예: 소켓 시간 제한의 경우 1). |
[표 8. 반환]

{#r_RESTResponseV2-getErrorCode__table_qpt_3f5_jq}  

    var sm = new sn_ws.RESTMessageV2("Yahoo Finance","get"); //Might throw exception if message doesn't exist or not visible due to scope.
    var response = sm.execute();
    var errorCode = response.getErrorCode();

## RESTResponseV2 - getErrorMessage() {#ariaid-title6}

REST 트랜잭션 중에 오류가 발생한 경우 오류 메시지를 가져옵니다.
{#r_RESTResponseV2-getErrorMessage__table_vy2_525_jqi__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 9. 매개변수]

{#r_RESTResponseV2-getErrorMessage__table_vy2_525_jqi} {#r_RESTResponseV2-getErrorMessage__table_qpt_3f5_jq__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 오류 메시지. |
[표 10. 반환]

{#r_RESTResponseV2-getErrorMessage__table_qpt_3f5_jq}  

    var sm = new sn_ws.RESTMessageV2("Yahoo Finance","get"); //Might throw exception if message doesn't exist or not visible due to scope.
    var response = sm.execute();
    var errorMsg = response.getErrorMessage();

## RESTResponseV2 - getHeader(문자열 이름) {#ariaid-title7}

지정된 헤더의 값을 가져옵니다.
{#r_RESTResponseV2-getHeader_S__table_vy2_525_jq__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 이름 | 문자열 | Set-Cookie와 같이 값을 원하는 헤더의 이름입니다. |
[표 11. 매개변수]

{#r_RESTResponseV2-getHeader_S__table_vy2_525_jq} {#r_RESTResponseV2-getHeader_S__table_qpt_3f5_jq__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 지정된 헤더의 값입니다. |
[표 12. 반환]

{#r_RESTResponseV2-getHeader_S__table_qpt_3f5_jq}  

    var sm = new sn_ws.RESTMessageV2("Yahoo Finance","get"); //Might throw exception if message doesn't exist or not visible due to scope.
    var response = sm.execute();
    var headerVal = response.getHeader("Content-Type");

## RESTResponseV2 - getHeaders() {#ariaid-title8}

REST 응답에서 반환된 모든 헤더와 관련된 값을 가져옵니다.
주:  
Set-Cookie 헤더와 같은 헤더가 응답에 두 번 이상 있는 경우 이 함수는 중복된 헤더 중 마지막 헤더만 반환합니다. 중복을 포함한 모든 헤더를 반환하려면 getAllHeaders() 함수를 사용합니다.
{#r_RESTResponseV2-getHeaders__table_vy2_525_jqj__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 13. 매개변수]

{#r_RESTResponseV2-getHeaders__table_vy2_525_jqj} {#r_RESTResponseV2-getHeaders__table_qpt_3f5_jq__entry__2}

| 유형 | 설명 |
|-|-|
| 객체 | 각 헤더의 이름을 연결된 값에 매핑하는 객체입니다. |
[표 14. 반환]

{#r_RESTResponseV2-getHeaders__table_qpt_3f5_jq}  

    var sm = new sn_ws.RESTMessageV2("Yahoo Finance","get"); //Might throw exception if message doesn't exist or not visible due to scope.
    var response = sm.execute();
    var headers = response.getHeaders();

## RESTResponseV2 - getQueryString() {#ariaid-title9}

REST 엔드포인트로 전송된 완전히 해결된 쿼리를 가져옵니다.
이 쿼리에는 엔드포인트 URL과 REST 메시지의 변수에 할당된 값이 포함됩니다. 이 방법은 직접 요청에 대한 응답에만 사용합니다. 이 방법은 비동기적으로 전송된 요청이나 MID 서버를 사용하여 전송된 요청에는 지원되지 않습니다.
{#r_RESTResponseV2-getQueryString__table_vy2_525_jqk__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 15. 매개변수]

{#r_RESTResponseV2-getQueryString__table_vy2_525_jqk} {#r_RESTResponseV2-getQueryString__table_qpt_3f5_jq__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 완전히 해결된 쿼리입니다. |
[표 16. 반환]

{#r_RESTResponseV2-getQueryString__table_qpt_3f5_jq}  

    var sm = new sn_ws.RESTMessageV2("Yahoo Finance","get"); //Might throw exception if message doesn't exist or not visible due to scope.
    var response = sm.execute();
    var queryString = response.getQueryString();

## RESTResponseV2 - getResponseAttachmentSysid() {#ariaid-title10}

응답 본문 콘텐츠에서 생성된 첨부 파일의 sys_id 값을 가져옵니다.
이 응답과 연결된 RESTMessageV2 객체가 saveResponseBodyAsAttachment(...) 함수를 호출한 경우 getResponseAttachmentSysid() 를 사용하여 생성된 첨부 파일 기록의 sys_id 가져옵니다. 새 첨부 파일 기록으로 추가 작업을 수행하려는 경우 이 기능을 사용합니다.
{#r_RRV2-getResponseAttachmentSysid__table_kzq_vd2_vs__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 17. 매개변수]

{#r_RRV2-getResponseAttachmentSysid__table_kzq_vd2_vs} {#r_RRV2-getResponseAttachmentSysid__table_lzq_vd2_vs__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 새 첨부 파일 기록의 Sys_id입니다. |
[표 18. 반환]

{#r_RRV2-getResponseAttachmentSysid__table_lzq_vd2_vs}

## RESTResponseV2 - getStatusCode() {#ariaid-title11}

REST 제공자가 반환한 숫자 HTTP 상태 코드를 가져옵니다.
{#r_RESTResponseV2-getStatusCode__table_vy2_525_jql__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 19. 매개변수]

{#r_RESTResponseV2-getStatusCode__table_vy2_525_jql} {#r_RESTResponseV2-getStatusCode__table_qpt_3f5_jq__entry__2}

| 유형 | 설명 |
|-|-|
| 번호 | REST 제공자가 반환하는 숫자 상태 코드입니다(예: 성공적인 응답의 경우 200). |
[표 20. 반환]

{#r_RESTResponseV2-getStatusCode__table_qpt_3f5_jq}  

    var sm = new sn_ws.RESTMessageV2("Yahoo Finance","get"); //Might throw exception if message doesn't exist or not visible due to scope.
    var response = sm.execute();
    var statusCode = response.getStatusCode();

## RESTResponseV2 - haveError() {#ariaid-title12}

REST 트랜잭션 중에 오류가 있었는지 나타냅니다.
{#r_RESTResponseV2-haveError__table_vy2_525_jqm__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 21. 매개변수]

{#r_RESTResponseV2-haveError__table_vy2_525_jqm} {#r_RESTResponseV2-haveError__table_qpt_3f5_jq__entry__2}

| 유형 | 설명 |
|-|-|
| 부울 | 오류가 있으면 예를 반환하고 오류가 없는 경우 아니오를 반환합니다. |
[표 22. 반환]

{#r_RESTResponseV2-haveError__table_qpt_3f5_jq}  

    var sm = new sn_ws.RESTMessageV2("Yahoo Finance","get"); //Might throw exception if message doesn't exist or not visible due to scope.
    var response = sm.execute();
    var error = response.haveError();

## RESTResponseV2 - waitForResponse(Number timeoutSecs) {#ariaid-title13}

인스턴스가 웹 서비스 제공자로부터 응답을 기다리는 시간을 설정합니다.
이 메서드는 이 REST 응답에 대한 속성 glide.rest.outbound.ecc_response.timeout을 무효화합니다.
{#r_RESTResponseV2-waitForResponse_N__table_vy2_525_jq__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| timeoutSecs | 번호 | 이 응답을 기다리는 시간(초)입니다. |
[표 23. 매개변수]

{#r_RESTResponseV2-waitForResponse_N__table_vy2_525_jq} {#r_RESTResponseV2-waitForResponse_N__table_nxp_dmh_dr__entry__2}

| 유형 | 설명 |
|-|-|
| 무효 |   |
[표 24. 반환]

{#r_RESTResponseV2-waitForResponse_N__table_nxp_dmh_dr}  

    var sm = new sn_ws.RESTMessageV2("Yahoo Finance","get"); //Might throw exception if message doesn't exist or not visible due to scope.
    var response = sm.executeAsync();
    response.waitForResponse(60);