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


---

# CMDBQueryBuilderAPI - 전역

# CMDBQueryBuilderAPI - 전역 {#ariaid-title1}

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

서버 측 스크립트에서 쿼리 작성기 작업을 실행하는 구성 관리 데이터베이스(CMDB) 메서드를 제공합니다.

이 API에는 애플리케이션(com.snc.cmdb)이 구성 관리 데이터베이스(CMDB) 필요합니다.  
주:  

이 API는 전역 범위에서만 사용할 수 있습니다. 범위가 지정된 응용 프로그램에서 이러한 메서드를 사용하려면 다음 문서를 [CMDBQBScopedScriptableAPI - 범위가 지정됨](https://servicenow-prod.fluidtopics.net/ZZhldQ2SXhvV64Lt6iQhUw#CMDBQBScopedAPI "서버 측 스크립트에서 쿼리 작성기 작업을 실행하는 구성 관리 데이터베이스(CMDB) 메서드를 제공합니다.")참조하십시오.

쿼리 작성기에 대한 CMDB 자세한 내용은 다음 문서를 참조하십시오 [CMDB Query Builder](https://www.servicenow.com/docs/access?context=cmdb-query-builder-landing-page&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US).

## CMDBQueryBuilderAPI - createReport(문자열 savedQueryId, 문자열 savedQueryName) {#ariaid-title2}

쿼리 작성기 쿼리의 결과를 구성 관리 데이터베이스(CMDB) 표시하고 보고서의 URL을 반환하는 보고서를 만듭니다.
범위가 지정된 애플리케이션의 경우 을 사용합니다 [CMDBQBScopedScriptableAPI - createReport(String savedQueryId, String savedQueryName)](https://servicenow-prod.fluidtopics.net/ZZhldQ2SXhvV64Lt6iQhUw#CMDBQB-createReport_S_S "쿼리 작성기 쿼리의 결과를 구성 관리 데이터베이스(CMDB) 표시하고 보고서의 URL을 반환하는 보고서를 만듭니다.").
{#CMDBQBuilder-createReport_S_S__id_dv4_sps_pbc__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| savedQueryId | 문자열 | 보고서에 사용할 쿼리의 Sys_id입니다. 쿼리 이름이 제공된 경우에는 이 매개변수가 필요하지 않습니다. 테이블: 저장된 쿼리 \[qb_saved_query\] |
| savedQueryName | 문자열 | 보고서에 사용할 쿼리의 이름입니다. 쿼리 sys_id가 제공된 경우에는 이 매개변수가 필요하지 않습니다. 테이블: 저장된 쿼리 \[qb_saved_query\] 테이블의 이름 필드에 저장됩니다. |
[표 1. 매개변수]

{#CMDBQBuilder-createReport_S_S__id_dv4_sps_pbc} {#CMDBQBuilder-createReport_S_S__id_tbd_tps_pbc__entry__2}

| 유형 | 설명 |
|-|-|
| 객체 | 생성된 보고서 및 오류에 대한 상세 정보입니다. { "error": "String", "message": "String", "status": "String" } |
| \<Object\>.error | 오류 코드입니다. 보고서 생성에 실패하거나 잘못된 입력 매개변수가 제공된 경우 반환됩니다. 가능한 오류: * `USER_NOT_AUTHORIZED_EXCEPTION` * `INVALID_PARAM` * `QUERY_SYS_ID_INVALID` * `REPORT_INELIGIBLE` {#CMDBQBuilder-createReport_S_S__ul_bgg_kls_pbc} 데이터 유형: 문자열 |
| \<Object\>.메시지 | 보고서 생성의 성공 또는 실패에 대한 세부 정보를 포함하는 메시지입니다. 가능한 메시지: * `<report-url>` * `사용자에게 CMDBQueryBuilder 쿼리 보고서를 작성할 권한이 없습니다.` * `잘못된 매개변수입니다. 저장된 쿼리의 유효한 sysId 또는 유효한 이름을 입력하십시오.` * `잘못된 queryId입니다. 저장된 유효한 쿼리 ID를 입력하십시오.` * `보고서를 만들려면 쿼리에 하나 이상의 실행이 있는 일정이 있어야 합니다.` {#CMDBQBuilder-createReport_S_S__ul_cgg_kls_pbc}[Schedule a CMDB query](https://www.servicenow.com/docs/access?context=create-cmdb-query-schedule&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US) 또한 참조하십시오. 데이터 유형: 문자열 |
| \<Object\>.status | 상태 코드입니다. 업데이트에 성공하면 반환됩니다. 값: `성공` 데이터 유형: 문자열 |
[표 2. 반환]

{#CMDBQBuilder-createReport_S_S__id_tbd_tps_pbc}  
이 예제에서는 저장된 쿼리 이름을 전달하여 보고서를 만드는 방법을 보여 줍니다.

    var queryReport = SNC.CMDBQueryBuilderAPI.createReport('', 'CMDBQueryTest1');

    gs.info(JSON.stringify(JSON.parse(queryReport), null, 2));

출력:

    {
       "message":"\/sys_report_template.do?sysparm_report_source_id=6d299cf81bbd4210bccf42a3b24bcb7a&sysparm_type=list&sysparm_title=CMDBQueryTest1&sysparm_source_type=source&sysparm_from_list=true&sysparm_chart_size=large&sysparm_manual_labor=true",
       "status":"success"
    }

이 예에서는 제공된 쿼리 이름이 잘못된 경우의 오류를 보여줍니다.

    var queryReport = SNC.CMDBQueryBuilderAPI.createReport('', 'Test');

    gs.info(JSON.stringify(JSON.parse(queryReport), null, 2));

출력:

    {
       "error":"INVALID_PARAM",
       "message":"Invalid Parameters. Please provide either a valid sysId or a valid name of a saved query"
    }

## CMDBQueryBuilderAPI - deleteQuery(문자열 savedQueryId, 문자열 savedQueryName) {#ariaid-title3}

쿼리 작성기 쿼리를 삭제합니다 구성 관리 데이터베이스(CMDB) .
범위가 지정된 애플리케이션의 경우 을 사용합니다 [CMDBQBScopedScriptableAPI - deleteQuery(String savedQueryId, String savedQueryName)](https://servicenow-prod.fluidtopics.net/ZZhldQ2SXhvV64Lt6iQhUw#CMDBQB-deleteQuery_S_S "쿼리 작성기 쿼리를 삭제합니다 구성 관리 데이터베이스(CMDB) .").
{#CMDBQBuilder-deleteQuery_S_S__id_smz_nqs_pbc__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| savedQueryId | 문자열 | 삭제할 쿼리의 Sys_id입니다. 쿼리 이름이 제공되면 이 매개변수를 빈 문자열로 제공할 수 있습니다. 테이블: 저장된 쿼리 \[qb_saved_query\] |
| savedQueryName | 문자열 | 삭제할 쿼리의 이름입니다. 쿼리 sys_id가 제공된 경우에는 이 매개변수가 필요하지 않습니다. 테이블: 저장된 쿼리 \[qb_saved_query\] 테이블의 <var class="keyword varname">이름</var> 필드에 저장됩니다. |
[표 3. 매개변수]

{#CMDBQBuilder-deleteQuery_S_S__id_smz_nqs_pbc} {#CMDBQBuilder-deleteQuery_S_S__id_ekn_4qs_pbc__entry__2}

| 유형 | 설명 |
|-|-|
| 객체 | 삭제된 쿼리 및 오류에 대한 상세 정보입니다. { "error": "String", "message": "String", "status": "String" } |
| \<Object\>.error | 오류 코드입니다. 삭제 작업이 실패하거나 잘못된 입력 매개변수가 제공된 경우 반환됩니다. 가능한 오류: * `USER_NOT_AUTHORIZED_EXCEPTION` * `INVALID_PARAM` * `QUERY_DELETE_FAILED` {#CMDBQBuilder-deleteQuery_S_S__ul_ynr_pl4_pbc} 데이터 유형: 문자열 |
| \<Object\>.메시지 | 삭제 작업의 성공 또는 실패에 대한 상세 정보를 포함하는 메시지입니다. 가능한 메시지: * `저장된 쿼리를 삭제했습니다.` * `사용자에게 CMDBQueryBuilder 쿼리를 삭제할 권한이 없습니다.` * `잘못된 매개변수입니다. 저장된 쿼리의 유효한 sysId 또는 유효한 이름을 입력하십시오.` * `지정된 저장된 쿼리를 삭제하지 못함` {#CMDBQBuilder-deleteQuery_S_S__ul_znr_pl4_pbc} 데이터 유형: 문자열 |
| \<Object\>.status | 상태 코드입니다. 업데이트에 성공하면 반환됩니다. 값: `성공` 데이터 유형: 문자열 |
[표 4. 반환]

{#CMDBQBuilder-deleteQuery_S_S__id_ekn_4qs_pbc}  
이 예시에서는 쿼리 이름을 전달하여 저장된 쿼리를 삭제하는 방법을 보여줍니다.

    var delQuery = SNC.CMDBQueryBuilderAPI.deleteQuery('', 'CMDBQueryTest1');

    gs.info(JSON.stringify(JSON.parse(delQuery), null, 2));

출력:

    {
       "message":"Successfully deleted the saved query",
       "status":"success"
    }

## CMDBQueryBuilderAPI - getSavedQueryExecutionDetails(문자열 savedQueryName, 부울 executeQuery, 숫자 timeout) {#ariaid-title4}

쿼리 작성기 쿼리에 대한 실행 상세 정보를 반환합니다 구성 관리 데이터베이스(CMDB) .
선택적으로 현재 실행 상세 정보를 반환하기 위해 쿼리를 실행할 수 있습니다.

쿼리를 실행하는 동안 시간 제한 또는 메모리 문제가 발생하는 경우 쿼리 배치 크기를 미세 조정하여 이러한 문제를 완화할 수 있습니다. 자세한 내용은 [쿼리 작성기 저장된 쿼리의 일괄 처리 크기를](https://www.servicenow.com/docs/access?context=batch-size-query&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US) 참조하세요.

범위가 지정된 애플리케이션의 경우 을 사용합니다 [CMDBQBScopedScriptableAPI - getSavedQueryExecutionDetails(문자열 savedQueryName, 부울 executeQuery, 숫자 timeout)](https://servicenow-prod.fluidtopics.net/ZZhldQ2SXhvV64Lt6iQhUw#CMDBQB-getSavedQueryExeDts_S_B_N "쿼리 작성기 쿼리에 대한 실행 상세 정보를 반환합니다 구성 관리 데이터베이스(CMDB) .").
{#CMDBQBuilder-getSavedQueryExecutionDetails_S_B__id_ezv_4vz_pbc__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| savedQueryName | 문자열 | 실행 상세 정보를 검색할 쿼리의 이름입니다. 테이블: 저장된 쿼리 \[qb_saved_query\] 테이블의 <var class="keyword varname">이름</var> 필드입니다. |
| executeQuery | 부울 | 옵션입니다. 지정된 쿼리를 실행할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * 예: 지정된 쿼리를 실행하고 실행 상세 정보를 반환합니다. * 아니오: 지정된 쿼리를 실행하지 않습니다. 쿼리에 대한 가장 최근 실행 상세 정보를 반환합니다. {#CMDBQBuilder-getSavedQueryExecutionDetails_S_B__ul_enk_jtn_kjb} 기본값: false |
| 시간 제한 | 번호 | 옵션입니다. 기본 쿼리 실행 시간 제한 5분을 무효화하는 정수 값입니다. 단위: 초 기본값: 5분 |
[표 5. 매개변수]

{#CMDBQBuilder-getSavedQueryExecutionDetails_S_B__id_ezv_4vz_pbc} {#CMDBQBuilder-getSavedQueryExecutionDetails_S_B__id_wyc_pvz_pbc__entry__2}

| 유형 | 설명 |
|-|-|
| 객체 | 쿼리 실행 및 오류에 대한 상세 정보입니다. { "error": "String", "execution_batch_size": Number, "message": "String", "query_id": "String", "status": "String", "table_name": "String" } |
| \<Object\>.error | 오류 코드입니다. 쿼리 실행이 실패하거나 지정된 쿼리를 찾을 수 없는 경우 반환됩니다. 가능한 오류: * `QUERY_EXECUTION_NOT_FOUND` * `QUERY_NOT_FOUND` * `QUERY_EXECUTION_FAILED` * `USER_NOT_AUTHORIZED_EXCEPTION` {#CMDBQBuilder-getSavedQueryExecutionDetails_S_B__ul_ylr_lyn_kjb} 데이터 유형: 문자열 |
| \<Object\>.execution_batch_size | 쿼리 실행에 할당된 배치 크기 100입니다. 이 값은 매개변수가 executeQuery true인 경우에만 반환됩니다. [Batch size for CMDB Query Builder queries](https://www.servicenow.com/docs/access?context=batch-size-query&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US) 또한 참조하십시오. 데이터 유형: 숫자 |
| \<Object\>.메시지 | 오류 코드에 대한 세부 정보를 포함하는 메시지입니다. 쿼리 실행이 실패하거나 지정된 쿼리를 찾을 수 없는 경우 반환됩니다. 가능한 메시지: * `쿼리 실행 상세 정보를 찾을 수 없습니다. 쿼리를 실행하십시오.` * `지정된 저장된 쿼리를 찾을 수 없습니다. 저장된 쿼리의 이름을 전달하고 있는지 확인하십시오.` * `쿼리 실행에 실패했습니다. 유효한 쿼리를 사용하십시오.` * `사용자에게 CMDBQueryBuilder 쿼리를 실행할 권한이 없습니다.` {#CMDBQBuilder-getSavedQueryExecutionDetails_S_B__ul_kwz_zsz_pbc} 데이터 유형: 문자열 |
| \<Object\>.query_id | 쿼리 실행의 Sys_id입니다. 데이터 유형: 문자열 테이블: 쿼리 상태 \[qb_query_status\] |
| \<Object\>.status | 쿼리 실행의 상태입니다. * COMPLETE: 실행이 완료되었습니다. * FAILED: 쿼리를 실행하는 동안 오류가 발생했습니다. * TIME_OUT: 쿼리 실행 시간이 초과되었습니다. * MAX_LIMIT: 최대 반환 결과 수에 도달했습니다. {#CMDBQBuilder-getSavedQueryExecutionDetails_S_B__ul_p2f_5yn_kjb} 데이터 유형: 문자열 |
| \<Object\>.table_name | 쿼리 실행 상세 정보가 포함된 테이블의 이름입니다. 데이터 유형: 문자열 |
[표 6. 반환]

{#CMDBQBuilder-getSavedQueryExecutionDetails_S_B__id_wyc_pvz_pbc}  
이 예제에서는 저장된 쿼리의 실행 상태를 가져오는 방법을 보여 줍니다.

    var savedQuery = SNC.CMDBQueryBuilderAPI.getSavedQueryExecutionDetails('CMDBQueryTest1');

    gs.info(JSON.stringify(JSON.parse(savedQuery), null, 2));

출력:

    {
       "query_id":"024fd53a7773330033b5270bba106141",
       "table_name":"u_cmdb_qb_result_598918aacb4dbf3f1a8dcf03fce6a5d57151a4e2",
       "status":COMPLETE
    }

이 예시에서는 저장된 쿼리를 실행하고 쿼리 실행 제한 시간 값을 10분으로 설정하는 방법을 보여줍니다.

    var savedQuery = SNC.CMDBQueryBuilderAPI.getSavedQueryExecutionDetails('CMDBQueryTest2', true, 600);

    gs.info(JSON.stringify(JSON.parse(savedQuery), null, 2));

출력:

    {
      "execution_batch_size": 100,
      "query_id": "e73428b4939baa50779bfdfb5cba1047",
      "table_name": "u_cmdb_qb_result_f0eed95be923bf3d439c87c028ae3c3af53aa739",
      "status": "COMPLETE"
    }

다음 예는 이전 예에서 저장된 쿼리 CMDBQueryTest2에 대한 결과 테이블의 정보에 액세스하는 방법을 보여줍니다. 결과 필터에서 결과 테이블 이름 다음에 <kbd class="ph userinput">.list</kbd> 를 사용할 수도 있습니다.

    var resultTableName = 'u_cmdb_qb_result_f7593958e298869427726be96f88155cce269806';
    var queryId = '76bd283c931bee502285f4cc5cba10da'; // insert the query ID here
    var gr = new GlideRecord(resultTableName);
    gr.addQuery('query', queryId);
    gr.query();
    if (gr.next()) { 
         gs.info(gr.getDisplayValue('u_server_1')); // field name in the result table
    }

출력:

    PS LoadBal01

## CMDBQueryBuilderAPI - saveQuery(String savedQueryName, String queryJson) {#ariaid-title5}

쿼리 작성기 쿼리를 구성 관리 데이터베이스(CMDB) 저장하고 저장된 쿼리의 sys_id 반환합니다.
범위가 지정된 애플리케이션의 경우 을 사용합니다 [CMDBQBScopedScriptableAPI - saveQuery(String savedQueryName, String queryJson)](https://servicenow-prod.fluidtopics.net/ZZhldQ2SXhvV64Lt6iQhUw#CMDBQB-saveQuery_S_S "쿼리 작성기 쿼리를 구성 관리 데이터베이스(CMDB) 저장하고 저장된 쿼리의 sys_id 반환합니다.").
{#CMDBQBuilder-saveQuery_S_S__id_dzn_1v5_pbc__entry__3}{#CMDBQBuilder-saveQuery_S_S__save-query-name}{#CMDBQBuilder-saveQuery_S_S__save-query-json}

| 이름 | 유형 | 설명 |
|-|-|-|
| savedQueryName | 문자열 | 쿼리를 저장할 이름입니다. 테이블: 저장된 쿼리 \[qb_saved_query\] 테이블의 이름 필드에 저장됩니다. |
| queryJson | 문자열 | 쿼리를 정의하는 JSON입니다. 테이블: 저장된 쿼리 \[qb_saved_query\] 테이블의 쿼리 필드에 저장됩니다. |
[표 7. 매개변수]

{#CMDBQBuilder-saveQuery_S_S__id_dzn_1v5_pbc} {#CMDBQBuilder-saveQuery_S_S__id_d3f_bv5_pbc__entry__2}

| 유형 | 설명 |
|-|-|
| 객체 | 저장된 쿼리 및 오류에 대한 상세 정보를 포함하는 객체입니다. { "error": "String", "message": "String", "status": "String" } |
| \<Object\>.error | 오류 코드입니다. 저장 작업이 실패하거나 잘못된 입력 매개변수가 제공된 경우 반환됩니다. 가능한 오류: * `USER_NOT_AUTHORIZED_EXCEPTION` * `QUERY_NAME_INVALID` * `QUERY_INVALID` * `QUERY_EXISTS_ALREADY` * `QUERY_SAVE_FAILED` {#CMDBQBuilder-saveQuery_S_S__ul_pp2_ttm_pbc} 데이터 유형: 문자열 |
| \<Object\>.메시지 | 저장 작업의 성공 또는 실패에 대한 상세 정보를 포함하는 메시지입니다. 가능한 메시지: * `sysId <sy_id>를 사용하여 쿼리를 저장했습니다.` * `사용자에게 CMDBQueryBuilder 쿼리를 저장할 권한이 없습니다.` * `쿼리 이름이 비어 있습니다. 이름을 입력하십시오` * `QueryJson이 잘못되었습니다. 유효한 queryJson을 제공하십시오.` * `쿼리 이름이 이미 사용 중입니다. 다른 이름을 사용하십시오.` * `쿼리를 저장하는 동안 예기치 않은 예외 발생` {#CMDBQBuilder-saveQuery_S_S__ul_qj1_qvm_pbc} 데이터 유형: 문자열 |
| \<Object\>.status | 상태 코드입니다. 저장 작업이 성공하면 반환됩니다. 값: `성공` 데이터 유형: 문자열 |
[표 8. 반환]

{#CMDBQBuilder-saveQuery_S_S__id_d3f_bv5_pbc}  
이 예에서는 저장된 쿼리 \[qb_saved_query\] 테이블에 쿼리를 추가하는 방법을 보여 줍니다.

    var queryJson = "{\"type\":\"cmdb\",\"nodes\":[{\"label\":\"Server\",\"unique_id\":\"d93f96981b310210bccf42a3b24bcb41\",\"nodeType\":\"class\",\"image\":\"images/app.ngbsm/server.svg\",\"properties\":\"\",\"allowed_connections\":[],\"filters\":{\"platform\":\"cmdb_ci_server\",\"custom\":\"\"},\"ci_type\":\"cmdb_ci_server\",\"ci_type_label\":\"Server\",\"sys_id\":\"d93f96981b310210bccf42a3b24bcb41\",\"x\":72,\"y\":337,\"returnValues\":[],\"filters_attrib\":\"\",\"applied_filters\":\"\",\"isStartNode\":true,\"nodeId\":\"d93f96981b310210bccf42a3b24bcb41_4_23_2024_5_50_54\",\"name\":\"Server 1\",\"type\":\"class\",\"refFilterApplied\":false,\"focused\":false,\"id\":\"d93f96981b310210bccf42a3b24bcb41_4_23_2024_5_50_54\",\"className\":\"cmdb_ci_server\"},{\"label\":\"Database\",\"unique_id\":\"b640269c1b310210bccf42a3b24bcb36\",\"nodeType\":\"class\",\"image\":\"images/app.ngbsm/database.svg\",\"properties\":\"\",\"allowed_connections\":[],\"filters\":{\"platform\":\"cmdb_ci_database\",\"custom\":\"\"},\"ci_type\":\"cmdb_ci_database\",\"ci_type_label\":\"Database\",\"sys_id\":\"b640269c1b310210bccf42a3b24bcb36\",\"x\":510,\"y\":340,\"returnValues\":[],\"filters_attrib\":\"\",\"applied_filters\":\"\",\"isStartNode\":false,\"nodeId\":\"b640269c1b310210bccf42a3b24bcb36_4_23_2024_5_50_57\",\"name\":\"Database 1\",\"type\":\"class\",\"refFilterApplied\":false,\"focused\":false,\"id\":\"b640269c1b310210bccf42a3b24bcb36_4_23_2024_5_50_57\",\"className\":\"cmdb_ci_database\"}],\"edges\":[{\"id\":\"Server 1_Database 1\",\"from\":\"d93f96981b310210bccf42a3b24bcb41_4_23_2024_5_50_54\",\"to\":\"b640269c1b310210bccf42a3b24bcb36_4_23_2024_5_50_57\",\"isDotted\":false,\"type\":\"relation\",\"isReverse\":false,\"direction\":\"outbound\",\"hiddenLevel\":0,\"relations\":[\"607ad1b2c0a8010e01941856b365af90\",\"1a9cb166f1571100a92eb60da2bce5c5\"]}],\"usedNames\":{\"cmdb_ci_server\":1,\"cmdb_ci_database\":1}}";

    var newQuery = SNC.CMDBQueryBuilderAPI.saveQuery('CMDBQueryTest1', queryJson);

    gs.info(JSON.stringify(JSON.parse(newQuery), null, 2));

출력:

    {
       "message":"Successfully saved the query with sysId d93f96981b310210bccf42a3b24bcb41",
       "status":"success"
    }

## CMDBQueryBuilderAPI - updateQuery(String savedQueryId, String savedQueryName, String queryJson) {#ariaid-title6}

쿼리 작성기 쿼리에 대한 JSON을 업데이트합니다 구성 관리 데이터베이스(CMDB) .
범위가 지정된 애플리케이션의 경우 을 사용합니다 [CMDBQBScopedScriptableAPI - updateQuery(String savedQueryId, String savedQueryName, String queryJson)](https://servicenow-prod.fluidtopics.net/ZZhldQ2SXhvV64Lt6iQhUw#CMDBQB-updateQuery_S_S_S "쿼리 작성기 쿼리에 대한 JSON을 업데이트합니다 구성 관리 데이터베이스(CMDB) .").
{#CMDBQBuilder-updateQuery_S_S_S__id_s3p_mv5_pbc__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| savedQueryId | 문자열 | 업데이트할 쿼리의 Sys_id입니다. 쿼리 이름이 제공된 경우에는 이 매개변수가 필요하지 않습니다. 테이블: 저장된 쿼리 \[qb_saved_query\] |
| savedQueryName | 문자열 | 업데이트할 쿼리의 이름입니다. 쿼리 sys_id가 제공된 경우에는 이 매개변수가 필요하지 않습니다. 테이블: 저장된 쿼리 \[qb_saved_query\] 테이블의 <var class="keyword varname">이름</var> 필드에 저장됩니다. |
| queryJson | 문자열 | 쿼리를 업데이트할 JSON입니다. 테이블: 저장된 쿼리 \[qb_saved_query\] 테이블의 <var class="keyword varname">쿼리</var> 필드에 저장됩니다. |
[표 9. 매개변수]

{#CMDBQBuilder-updateQuery_S_S_S__id_s3p_mv5_pbc} {#CMDBQBuilder-updateQuery_S_S_S__id_opl_4v5_pbc__entry__2}

| 유형 | 설명 |
|-|-|
| 객체 | 업데이트된 쿼리 및 오류에 대한 상세 정보입니다. { "error": "String", "message": "String", "status": "String" } |
| \<Object\>.error | 오류 코드입니다. 업데이트에 실패하거나 잘못된 입력 매개변수가 제공된 경우 반환됩니다. 가능한 오류: * `USER_NOT_AUTHORIZED_EXCEPTION` * `INVALID_PARAM` * `QUERY_INVALID` * `QUERY_UPDATE_FAILED` * `UNAUTHORIZED_REPORT_SOURCE_USER` {#CMDBQBuilder-updateQuery_S_S_S__ul_xbd_nd4_pbc} 데이터 유형: 문자열 |
| \<Object\>.메시지 | 업데이트의 성공 또는 실패에 대한 상세 정보를 포함하는 메시지입니다. 가능한 메시지: * `저장된 쿼리를 업데이트했습니다.` * `사용자에게 CMDBQueryBuilder 쿼리를 업데이트할 권한이 없습니다.` * `잘못된 매개변수입니다. 저장된 쿼리의 유효한 sysId 또는 유효한 이름을 입력하십시오.` * `QueryJson이 잘못되었습니다. 유효한 queryJson을 제공하십시오.` * `지정된 저장된 쿼리를 업데이트하지 못함` * `사용자에게 저장된 쿼리의 보고서 소스를 업데이트할 권한이 없습니다.` {#CMDBQBuilder-updateQuery_S_S_S__ul_ybd_nd4_pbc} 데이터 유형: 문자열 |
| \<Object\>.status | 상태 코드입니다. 업데이트에 성공하면 반환됩니다. 값: `성공` 데이터 유형: 문자열 |
[표 10. 반환]

{#CMDBQBuilder-updateQuery_S_S_S__id_opl_4v5_pbc}  
이 예제에서는 쿼리 이름을 전달하여 저장된 쿼리를 업데이트하는 방법을 보여 줍니다.

    var queryJson = "{\"type\":\"cmdb\",\"nodes\":[{\"label\":\"Server\",\"unique_id\":\"d93f96981b310210bccf42a3b24bcb41\",\"nodeType\":\"class\",\"image\":\"images/app.ngbsm/server.svg\",\"properties\":\"\",\"allowed_connections\":[],\"filters\":{\"platform\":\"cmdb_ci_server\",\"custom\":\"\"},\"ci_type\":\"cmdb_ci_server\",\"ci_type_label\":\"Server\",\"sys_id\":\"d93f96981b310210bccf42a3b24bcb41\",\"x\":72,\"y\":336,\"returnValues\":[],\"filters_attrib\":\"\",\"applied_filters\":\"\",\"isStartNode\":true,\"nodeId\":\"d93f96981b310210bccf42a3b24bcb41_4_23_2024_5_50_54\",\"name\":\"Server 1\",\"type\":\"class\",\"refFilterApplied\":false,\"focused\":false,\"id\":\"d93f96981b310210bccf42a3b24bcb41_4_23_2024_5_50_54\",\"className\":\"cmdb_ci_server\"},{\"label\":\"Web Server\",\"unique_id\":\"984f5a981b310210bccf42a3b24bcb03\",\"nodeType\":\"class\",\"image\":\"images/app.ngbsm/web_server.svg\",\"properties\":\"\",\"allowed_connections\":[],\"filters\":{\"platform\":\"cmdb_ci_web_server\",\"custom\":\"\"},\"ci_type\":\"cmdb_ci_web_server\",\"ci_type_label\":\"Web Server\",\"sys_id\":\"984f5a981b310210bccf42a3b24bcb03\",\"x\":446,\"y\":330,\"returnValues\":[],\"filters_attrib\":\"\",\"applied_filters\":\"\",\"isStartNode\":false,\"nodeId\":\"984f5a981b310210bccf42a3b24bcb03_4_23_2024_6_32_19\",\"name\":\"Web Server 1\",\"type\":\"class\",\"refFilterApplied\":false,\"focused\":false,\"id\":\"984f5a981b310210bccf42a3b24bcb03_4_23_2024_6_32_19\",\"className\":\"cmdb_ci_web_server\"}],\"edges\":[{\"id\":\"Server 1_Web Server 1\",\"from\":\"d93f96981b310210bccf42a3b24bcb41_4_23_2024_5_50_54\",\"to\":\"984f5a981b310210bccf42a3b24bcb03_4_23_2024_6_32_19\",\"isDotted\":false,\"type\":\"relation\",\"isReverse\":false,\"direction\":\"outbound\",\"hiddenLevel\":0,\"relations\":[\"607ad1b2c0a8010e01941856b365af90\"]}],\"usedNames\":{\"cmdb_ci_server\":1,\"cmdb_ci_database\":1,\"cmdb_ci_web_server\":1}}";

    var queryUpdate = SNC.CMDBQueryBuilderAPI.updateQuery('', 'CMDBQueryTest1', queryJson);

    gs.info(JSON.stringify(JSON.parse(queryUpdate), null, 2));

출력:

    {
       "message":"Successfully updated the saved query",
       "status":"success"
    }

이 예제에서는 쿼리 sys_id와 이름이 모두 메서드 호출에서 누락된 경우의 오류를 보여줍니다.

    var queryJson = "{\"type\":\"cmdb\",\"nodes\":[{\"label\":\"Server\",\"unique_id\":\"d93f96981b310210bccf42a3b24bcb41\",\"nodeType\":\"class\",\"image\":\"images/app.ngbsm/server.svg\",\"properties\":\"\",\"allowed_connections\":[],\"filters\":{\"platform\":\"cmdb_ci_server\",\"custom\":\"\"},\"ci_type\":\"cmdb_ci_server\",\"ci_type_label\":\"Server\",\"sys_id\":\"d93f96981b310210bccf42a3b24bcb41\",\"x\":72,\"y\":336,\"returnValues\":[],\"filters_attrib\":\"\",\"applied_filters\":\"\",\"isStartNode\":true,\"nodeId\":\"d93f96981b310210bccf42a3b24bcb41_4_23_2024_5_50_54\",\"name\":\"Server 1\",\"type\":\"class\",\"refFilterApplied\":false,\"focused\":false,\"id\":\"d93f96981b310210bccf42a3b24bcb41_4_23_2024_5_50_54\",\"className\":\"cmdb_ci_server\"},{\"label\":\"Web Server\",\"unique_id\":\"984f5a981b310210bccf42a3b24bcb03\",\"nodeType\":\"class\",\"image\":\"images/app.ngbsm/web_server.svg\",\"properties\":\"\",\"allowed_connections\":[],\"filters\":{\"platform\":\"cmdb_ci_web_server\",\"custom\":\"\"},\"ci_type\":\"cmdb_ci_web_server\",\"ci_type_label\":\"Web Server\",\"sys_id\":\"984f5a981b310210bccf42a3b24bcb03\",\"x\":446,\"y\":330,\"returnValues\":[],\"filters_attrib\":\"\",\"applied_filters\":\"\",\"isStartNode\":false,\"nodeId\":\"984f5a981b310210bccf42a3b24bcb03_4_23_2024_6_32_19\",\"name\":\"Web Server 1\",\"type\":\"class\",\"refFilterApplied\":false,\"focused\":false,\"id\":\"984f5a981b310210bccf42a3b24bcb03_4_23_2024_6_32_19\",\"className\":\"cmdb_ci_web_server\"}],\"edges\":[{\"id\":\"Server 1_Web Server 1\",\"from\":\"d93f96981b310210bccf42a3b24bcb41_4_23_2024_5_50_54\",\"to\":\"984f5a981b310210bccf42a3b24bcb03_4_23_2024_6_32_19\",\"isDotted\":false,\"type\":\"relation\",\"isReverse\":false,\"direction\":\"outbound\",\"hiddenLevel\":0,\"relations\":[\"607ad1b2c0a8010e01941856b365af90\"]}],\"usedNames\":{\"cmdb_ci_server\":1,\"cmdb_ci_database\":1,\"cmdb_ci_web_server\":1}}";

    var queryUpdate = SNC.CMDBQueryBuilderAPI.updateQuery('', '', queryJson);

    gs.info(JSON.stringify(JSON.parse(queryUpdate), null, 2));

출력:

    {
       "error":"INVALID_PARAM",
       "message":"Invalid Parameters. Please provide either a valid sysId or a valid name of a saved query"
    }