--- 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 --- # AccAgentsAPI - 범위 지정됨 # AccAgentsAPI - 범위 지정됨 {#ariaid-title1} * 릴리스 버전: Australia * * 업데이트 날짜 2026년 03월 12일 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 17분 AccAgentsAPI 스크립트 포함을 사용하면 사용 가능한 에이전트에 대한 관리 작업을 수행할 수 있습니다. 이 스크립트 포함에는 프레임워크(sn_agent) 스토어 애플리케이션이 필요 에이전트 클라이언트 수집기 하며 `sn_agent` 네임스페이스 내에서 제공됩니다. 자세한 내용은 [에이전트 클라이언트 수집기를](https://www.servicenow.com/docs/access?context=acc-landing-page&version=australia&pubname=australia-it-operations-management&ft:locale=en-US) 참조하십시오. REST API 솔루션은 [에이전트 클라이언트 수집기 API](https://servicenow-prod.fluidtopics.net/8UJsn3sn8UCZe2J7uoKjsQ#agnt_clnt_cll-api "에이전트 클라이언트 수집기 API는 사용 가능한 에이전트에 대한 작업을 관리하고 정책을 관리하는 엔드포인트를 제공합니다.")를 참조하십시오. 이 스크립트 포함은 다음을 가능하게 하는 메서드를 제공합니다. * 하나 이상의 에이전트에 대한 광범위한 정보를 가져옵니다. * 에이전트 로그를 가져오기 위한 요청을 제출하고 요청 진행률에 대한 정보를 검색합니다. * 데이터 수집을 시작하거나 중지합니다. * 에이전트를 다시 시작합니다. * 에이전트에서 검색 실행. ## AccAgentsAPI - AccAgentsAPI() {#ariaid-title2} AccAgentsAPI 인스턴스를 작성합니다. {#AccA-AccAgentsAPI__table_ohr_4qd_bpb__entry__3} | 이름 | 유형 | 설명 | |-|-|-| | 없음 | | | [표 1. 매개변수] {#AccA-AccAgentsAPI__table_ohr_4qd_bpb} 다음 예제에서는 AccAgentsAPI를 초기화하는 방법을 보여줍니다. var agentsApi = new sn_agent.AccAgentsAPI(); ## AccAgentsAPI - checkGrabLogRequestProgress(문자열 requestId) {#ariaid-title3} 로그 확보 요청의 상태를 확인합니다. [submitGrabLogRequest()](https://servicenow-prod.fluidtopics.net/w1VNjMhGovH04e02wH_LrQ#AccA-submitGrabLogRequest_S "활성/작동 중인 상태인 지정된 에이전트의 로그를 요청합니다.") 메서드를 실행하여 요청 ID를 가져옵니다. {#AccA-checkGrabLogRequestProgress_S__table_zk2_2g2_z4b__entry__3}{#AccA-checkGrabLogRequestProgress_S__accAgents-parm-desc-requestID} | 이름 | 유형 | 설명 | |-|-|-| | requestId | 문자열 | 에이전트 클라이언트 수집기 요청\[sn_agent_request\] 테이블의 요청 Sys_id입니다. | [표 2. 매개변수] {#AccA-checkGrabLogRequestProgress_S__table_zk2_2g2_z4b} {#AccA-checkGrabLogRequestProgress_S__table_al2_2g2_z4b__entry__2} | 속성 | 설명 | |-|-| | \ | 그랩 로그 요청 상태를 포함하는 JSON 객체입니다. { "status": Number, "output": "String" } | | 상태 | 그랩 로그 요청의 상태를 나타내는 번호입니다. 가능한 값: * 0: 로그 요청 획득이 완료되었습니다. * 1: 진행 중인 로그 요청을 가져옵니다. * 2: 로그 요청 선택 시간이 초과되었습니다. * 3: 로그 요청 가져오기에 오류가 있습니다. * 4: 로그 선택 요청을 찾을 수 없습니다. {#AccA-checkGrabLogRequestProgress_S__ul_orq_4qr_bpb} | | 출력 | 상태를 설명하는 정보입니다. | [표 3. 반환] {#AccA-checkGrabLogRequestProgress_S__table_al2_2g2_z4b} 다음 예제에서는 요청 ID를 사용하여 Grab 로그 요청의 상태를 가져오는 방법을 보여줍니다. var agentsApi = new sn_agent.AccAgentsAPI(); var logRequestStatus = agentsApi.checkGrabLogRequestProgress(""); gs.info(JSON.stringify(logRequestStatus, null, 2)); 출력: { "status": 2, "output": "Grab Log Request Timed Out" } ## AccAgentsAPI - getAgent(문자열 agentID) {#ariaid-title4} 지정된 에이전트의 정보를 가져옵니다. 에이전트 ID 목록을 가져오려면 다음을 수행합니다. * getAgentsList() 메서드를 실행합니다. * Agent Client Collector \[sn_agent_cmdb_ci_agent\] 테이블의 에이전트 ID 열을 확인합니다. * [에이전트 클라이언트 수집기 GET 목록](https://servicenow-prod.fluidtopics.net/8UJsn3sn8UCZe2J7uoKjsQ#agnt_clnt_cll-GET-list "관련 정보가 있는 에이전트 목록을 가져옵니다.") REST API를 실행합니다. {#AccA-getAgent_S__ul_yqc_3kj_z4b} {#AccA-getAgent_S__table_zk2_2g2_z4b__entry__3}{#AccA-getAgent_S__accAgents-parm-desc-agentID} | 이름 | 유형 | 설명 | |-|-|-| | agentID | 문자열 | 에이전트 클라이언트 수집기 \[sn_agent_cmdb_ci_agent\] 테이블의 에이전트 ID 열에 나열된 에이전트의 고유 ID입니다. | [표 4. 매개변수] {#AccA-getAgent_S__table_zk2_2g2_z4b} {#AccA-getAgent_S__table_al2_2g2_z4b__entry__2}{#AccA-getAgent_S__accAgents-rtrns-error} | 속성 | 설명 | |-|-| | \ | 확장 에이전트 정보를 포함하는 객체입니다. { "error": String, "agent": Object } | | 오류 | 오류 메시지. 오류가 없으면 Null입니다. 데이터 유형: 문자열 | | 에이전트 | "agent": { "agent_id": "String", "data_collection": Number, "ip_address": "String", "is_duplicate": Boolean, "is_restart_enabled": Boolean, "name": "String", "number_of_running_checks": Number, "status": Number, "up_since": "String", "version": "String" } | | agent.agent_id | 제출된 에이전트의 ID입니다. 데이터 유형: 문자열 | | agent.data_collection | 데이터 수집은 예약된 검사를 실행할지 여부를 나타냅니다. 이러한 검사는 이 에이전트를 실행하도록 예약된 정책의 일부입니다. 가능한 값: * 0: 켜짐 -- 검사가 예약된 대로 실행됩니다. * 1: 꺼짐(수동) -- 수동으로 검사가 비활성화되었습니다. * 2: 끄기(자동) -- CPU 사용량이 많아 검사가 자동으로 비활성화되었습니다. {#AccA-getAgent_S__ul_w4n_53p_bpb} 데이터 유형: 숫자 | | agent.ip_address | 에이전트 IP 주소입니다. 데이터 유형: 문자열 | | agent.is_duplicate | 이 에이전트가 다른 에이전트와 중복되는지 여부를 나타내는 플래그입니다. 주어진 호스트에는 에이전트가 하나만 있어야 합니다. 가능한 값: * true: 에이전트가 다른 에이전트 ID를 가진 Alive/Up 에이전트와 동일한 호스트를 가지고 있습니다. 중복 항목 끄기 또는 제거 * false: 이 에이전트에는 Alive/Up 상태의 중복이 없습니다. {#AccA-getAgent_S__ul_b34_ffl_bpb} 데이터 유형: 부울 | | agent.is_restart_enabled | 다시 시작을 사용할 수 있는지 여부를 나타내는 플래그입니다. 에이전트 다시 시작을 구성할 수 없습니다. OS 및 에이전트가 실행 중인 OS 버전에 따라 다릅니다. 가능한 값: * true: 이 에이전트에 대해 다시 시작이 활성화되었습니다. * 아니오: 이 에이전트에 대한 재시작이 비활성화되었습니다. {#AccA-getAgent_S__ul_bvp_dfl_bpb} 데이터 유형: 부울 | | agent.name | 에이전트의 이름입니다. 데이터 유형: 문자열 | | agent.number_of_running_checks | 에이전트가 실행하도록 예약된 검사 수입니다. 이러한 검사는 이 에이전트를 실행하도록 예약된 정책의 일부입니다. 데이터 유형: 숫자 | | agent.status | 에이전트의 상태입니다. 가능한 값: * 0: 활성/사용 중 - 에이전트가 활성 상태입니다. * 1: 경고 -- 에이전트가 지난 몇 분 동안 연결 유지 메시지를 받지 못했습니다. * 2: 다운 -- 에이전트가 오랫동안 연결 유지 메시지를 받지 못했습니다. * 3: 다시 시작 -- 에이전트가 다시 시작됩니다. {#AccA-getAgent_S__ul_adg_ffp_bpb} 데이터 유형: 숫자 | | agent.up_since | 에이전트의 상태가 활성/작동 상태가 된 이후의 UTC 시간입니다. 값은 [GlideDateTime](https://servicenow-prod.fluidtopics.net/fpVGOlVCBMRuW84vxoNBIw#c_GlideDateTimeScoped "범위가 지정된 GlideDateTime 클래스는 GlideDateTime 객체에 대한 작업을 수행하기 위한 메서드를 제공합니다.") 형식입니다. 데이터 유형: 문자열 | | agent.version | 에이전트 버전 에이전트 클라이언트 수집기 이 실행 중입니다. 데이터 유형: 문자열 | [표 5. 반환] {#AccA-getAgent_S__table_al2_2g2_z4b} 다음 예는 에이전트의 상태를 표시하는 방법을 보여줍니다. var agentsApi = new sn_agent.AccAgentsAPI(); var agentInfo = agentsAPI.getAgent(""); if (!gs.nil(agentInfo.error)) gs.error(agentInfo.error); else gs.info("agent status: " + agentInfo.agent.status); 출력: agent status: 2 다음 예는 모든 에이전트 상세 정보를 가져오는 방법을 보여줍니다. var agentsApi = new sn_agent.AccAgentsAPI(); var agentInfo = agentsAPI.getAgent(""); gs.info(JSON.stringify(agentInfo, null, 2)); 출력: { "error": null, "agent": { "name": "win2016-dc-64bit", "status": 0, "agent_id": "", "ip_address": "10.222.333.42", "number_of_running_checks": 1, "data_collection": 0, "is_restart_enabled": true, "is_duplicate": false, "up_since": "2021-03-24 11:04:38", "version": "2.4.0" } } ## AccAgentsAPI -- getAgentsList(문자열, encodedQuery, 숫자 제한) {#ariaid-title5} 관련 정보가 있는 에이전트 목록을 가져옵니다. {#AccA-getAgentsList_S_N__table_zk2_2g2_z4b__entry__3} | 이름 | 유형 | 설명 | |-|-|-| | encodedQuery | 문자열 | 표준 Glide 형식으로 인코딩된 쿼리 문자열입니다. [인코딩된 쿼리 문자열을 참조하세요.](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=australia&pubname=australia-platform-user-interface&ft:locale=en-US) | | 제한 | 번호 | 옵션입니다. 결과를 에이전트의 최대 수로 제한합니다. 필요하지 않은 경우 둘 다에 null 또는 undefined를 사용합니다. 기본값/최대값: 20,000 | [표 6. 매개변수] {#AccA-getAgentsList_S_N__table_zk2_2g2_z4b} {#AccA-getAgentsList_S_N__table_al2_2g2_z4b__entry__2}{#AccA-getAgentsList_S_N__accAgents-parm-agent-obj-id-entry}{#AccA-getAgentsList_S_N__accAgents-parm-agent-obj-dataCollect-entry}{#AccA-getAgentsList_S_N__accAgents-parm-agent-obj-ip-entry}{#AccA-getAgentsList_S_N__accAgents-parm-agent-obj-dup-entry}{#AccA-getAgentsList_S_N__accAgents-parm-agent-obj-restart-entry}{#AccA-getAgentsList_S_N__accAgents-parm-agent-obj-name-entry}{#AccA-getAgentsList_S_N__accAgents-parm-agent-obj-numChecks-entry}{#AccA-getAgentsList_S_N__accAgents-parm-agent-obj-status-entry}{#AccA-getAgentsList_S_N__accAgents-parm-agent-obj-up-entry}{#AccA-getAgentsList_S_N__accAgents-parm-agent-obj-version-entry} | 속성 | 설명 | |-|-| | \<배열\> | 확장 에이전트 정보를 포함하는 JSON 객체의 배열입니다. [ { "agent_id": "String", "data_collection": Number, "ip_address": "String", "is_duplicate": Boolean, "is_restart_enabled": Boolean, "name": "String", "number_of_running_checks": Number, "status": Number, "up_since": "String", "version": "String" } ] | | agent_id | 제출된 에이전트의 ID입니다. 데이터 유형: 문자열 | | data_collection | 데이터 수집은 예약된 검사를 실행할지 여부를 나타냅니다. 이러한 검사는 이 에이전트를 실행하도록 예약된 정책의 일부입니다. 가능한 값: * 0: 켜짐 -- 검사가 예약된 대로 실행됩니다. * 1: 꺼짐(수동) -- 수동으로 검사가 비활성화되었습니다. * 2: 끄기(자동) -- CPU 사용량이 많아 검사가 자동으로 비활성화되었습니다. {#AccA-getAgentsList_S_N__ul_w4n_53p_bpb} 데이터 유형: 숫자 | | ip_address | 에이전트 IP 주소입니다. 데이터 유형: 문자열 | | is_duplicate | 이 에이전트가 다른 에이전트와 중복되는지 여부를 나타내는 플래그입니다. 주어진 호스트에는 에이전트가 하나만 있어야 합니다. 가능한 값: * true: 에이전트가 다른 에이전트 ID를 가진 Alive/Up 에이전트와 동일한 호스트를 가지고 있습니다. 중복 항목 끄기 또는 제거 * false: 이 에이전트에는 Alive/Up 상태의 중복이 없습니다. {#AccA-getAgentsList_S_N__ul_b34_ffl_bpb} 데이터 유형: 부울 | | is_restart_enabled | 다시 시작을 사용할 수 있는지 여부를 나타내는 플래그입니다. 에이전트 다시 시작을 구성할 수 없습니다. OS 및 에이전트가 실행 중인 OS 버전에 따라 다릅니다. 가능한 값: * true: 이 에이전트에 대해 다시 시작이 활성화되었습니다. * 아니오: 이 에이전트에 대한 재시작이 비활성화되었습니다. {#AccA-getAgentsList_S_N__ul_bvp_dfl_bpb} 데이터 유형: 부울 | | 이름 | 에이전트의 이름입니다. 데이터 유형: 문자열 | | number_of_running_checks | 에이전트가 실행하도록 예약된 검사 수입니다. 이러한 검사는 이 에이전트를 실행하도록 예약된 정책의 일부입니다. 데이터 유형: 숫자 | | 상태 | 에이전트의 상태입니다. 가능한 값: * 0: 활성/사용 중 - 에이전트가 활성 상태입니다. * 1: 경고 -- 에이전트가 지난 몇 분 동안 연결 유지 메시지를 받지 못했습니다. * 2: 다운 -- 에이전트가 오랫동안 연결 유지 메시지를 받지 못했습니다. * 3: 다시 시작 -- 에이전트가 다시 시작됩니다. {#AccA-getAgentsList_S_N__ul_adg_ffp_bpb} 데이터 유형: 숫자 | | up_since | 에이전트의 상태가 활성/작동 상태가 된 이후의 UTC 시간입니다. 값은 [GlideDateTime](https://servicenow-prod.fluidtopics.net/fpVGOlVCBMRuW84vxoNBIw#c_GlideDateTimeScoped "범위가 지정된 GlideDateTime 클래스는 GlideDateTime 객체에 대한 작업을 수행하기 위한 메서드를 제공합니다.") 형식입니다. 데이터 유형: 문자열 | | 버전 | 에이전트 버전 에이전트 클라이언트 수집기 이 실행 중입니다. 데이터 유형: 문자열 | [표 7. 반환] {#AccA-getAgentsList_S_N__table_al2_2g2_z4b} 다음 예제에서는 쿼리 및 번호로 결과를 제한하는 방법을 보여줍니다. 이 쿼리는 최대 2개의 결과와 함께 다운 상태가 아닌 모든 에이전트를 반환합니다. var agentsApi = new sn_agent.AccAgentsAPI(); var agentList = agentsApi.getAgentsList("agent_extended_info.status!=2", 2); gs.info(JSON.stringify(agentList, null, 2)); 출력: [ { "name": "007-175", "status": 0, "agent_id": "007-175", "ip_address": "11.222.63.66", "number_of_running_checks": 0, "data_collection": 0, "is_restart_enabled": false, "is_duplicate": false, "up_since": "2021-03-24 14:36:45", "version": "2.4.0" }, { "name": "win2016-dc-64bit", "status": 0, "agent_id": "007-64", "ip_address": "10.222.333.42", "number_of_running_checks": 1, "data_collection": 0, "is_restart_enabled": true, "is_duplicate": false, "up_since": "2021-03-24 11:04:38", "version": "2.4.0" } ] 다음 예는 시스템의 모든 에이전트를 나열하는 방법을 보여줍니다. 이 예시에서는 쿼리를 사용하지 않으며 최대 결과 수가 없습니다. var agentsApi = new sn_agent.AccAgentsAPI(); var agentList = agentsApi.getAgentsList(null, 0); gs.info(JSON.stringify(agentList, null, 2)); 다음 예에서는 제공된 결과를 반복하고 각 에이전트 ID를 표시하는 방법을 보여줍니다. var agentsApi = new sn_agent.AccAgentsAPI(); var agentsList = agentsApi.getAgentsList(null, 0); for (var i = 0; i < agentsList.length; i++) gs.info("agent with id: " + agentsList[i].agent_id); 출력: sn_agent: agent with id: 000a00e0aa1aa3a4 sn_agent: agent with id: 000a00e1aa1aa3a4 sn_agent: agent with id: 000a00e2aa1aa3a4 ## AccAgentsAPI - restartAgent(문자열 agentID) {#ariaid-title6} 지정된 에이전트를 활성/작동 상태로 다시 시작합니다. 성능 문제가 발생하면 에이전트 클라이언트 수집기 에이전트를 다시 시작할 수 있습니다. 수동 다시 시작은 다음 환경에서 지원됩니다. * `systemd`를 사용하는 Linux 기반 에이전트 * Windows 에이전트 {#AccA-restartAgent_S__ul_zzv_z4q_dpb} 에이전트 ID 목록을 가져오려면 다음을 수행합니다. * getAgentsList() 메서드를 실행합니다. * Agent Client Collector \[sn_agent_cmdb_ci_agent\] 테이블의 에이전트 ID 열을 확인합니다. * [에이전트 클라이언트 수집기 GET 목록](https://servicenow-prod.fluidtopics.net/8UJsn3sn8UCZe2J7uoKjsQ#agnt_clnt_cll-GET-list "관련 정보가 있는 에이전트 목록을 가져옵니다.") REST API를 실행합니다. {#AccA-restartAgent_S__ul_yqc_3kj_z4b} {#AccA-restartAgent_S__table_zk2_2g2_z4b__entry__3}{#AccA-restartAgent_S__accAgents-parm-desc-agentID} | 이름 | 유형 | 설명 | |-|-|-| | agentID | 문자열 | 에이전트 클라이언트 수집기 \[sn_agent_cmdb_ci_agent\] 테이블의 에이전트 ID 열에 나열된 에이전트의 고유 ID입니다. | [표 8. 매개변수] {#AccA-restartAgent_S__table_zk2_2g2_z4b} {#AccA-restartAgent_S__table_al2_2g2_z4b__entry__2} | 유형 | 설명 | |-|-| | 문자열 | 오류 메시지는 해당하는 경우 null이며, 그렇지 않으면 null입니다. | [표 9. 반환] {#AccA-restartAgent_S__table_al2_2g2_z4b} 다음 예는 에이전트를 다시 시작하는 방법을 보여줍니다. var agentsApi = new sn_agent.AccAgentsAPI(); var err = agentsApi.restartAgent(""); if (!gs.nil(err)) gs.error(err); ## AccAgentsAPI - runDiscovery(문자열 agentID) {#ariaid-title7} 디스커버리 검사를 실행하여 에이전트와 관련된 CI를 찾습니다. 지정된 에이전트는 활성/작동 상태여야 합니다. 에이전트 ID 목록을 가져오려면 다음을 수행합니다. * getAgentsList() 메서드를 실행합니다. * Agent Client Collector \[sn_agent_cmdb_ci_agent\] 테이블의 에이전트 ID 열을 확인합니다. * [에이전트 클라이언트 수집기 GET 목록](https://servicenow-prod.fluidtopics.net/8UJsn3sn8UCZe2J7uoKjsQ#agnt_clnt_cll-GET-list "관련 정보가 있는 에이전트 목록을 가져옵니다.") REST API를 실행합니다. {#AccA-runDiscovery_S__ul_yqc_3kj_z4b} {#AccA-runDiscovery_S__table_zk2_2g2_z4b__entry__3}{#AccA-runDiscovery_S__accAgents-parm-desc-agentID} | 이름 | 유형 | 설명 | |-|-|-| | agentID | 문자열 | 에이전트 클라이언트 수집기 \[sn_agent_cmdb_ci_agent\] 테이블의 에이전트 ID 열에 나열된 에이전트의 고유 ID입니다. | [표 10. 매개변수] {#AccA-runDiscovery_S__table_zk2_2g2_z4b} {#AccA-runDiscovery_S__table_al2_2g2_z4b__entry__2} | 유형 | 설명 | |-|-| | 문자열 | 오류 메시지는 해당하는 경우 null이며, 그렇지 않으면 null입니다. 예를 들어 `ID가 인 에이전트가 작동하지 않음: no throw된 오류`입니다. | [표 11. 반환] {#AccA-runDiscovery_S__table_al2_2g2_z4b} 다음 예는 활성/작동 상태인 에이전트에서 검색을 실행하는 방법을 보여줍니다. var agentsApi = new sn_agent.AccAgentsAPI(); var err = agentsApi.runDiscovery(""); if (!gs.nil(err)) gs.error(err); ## AccAgentsAPI - setDataCollectionStatus(문자열 agentID, 부울 상태) {#ariaid-title8} 지정된 에이전트에 대해 지정된 데이터 수집 상태(활성화 여부에 따라 예/아니오)를 설정합니다. 에이전트 ID 목록을 가져오려면 다음을 수행합니다. * getAgentsList() 메서드를 실행합니다. * Agent Client Collector \[sn_agent_cmdb_ci_agent\] 테이블의 에이전트 ID 열을 확인합니다. * [에이전트 클라이언트 수집기 GET 목록](https://servicenow-prod.fluidtopics.net/8UJsn3sn8UCZe2J7uoKjsQ#agnt_clnt_cll-GET-list "관련 정보가 있는 에이전트 목록을 가져옵니다.") REST API를 실행합니다. {#AccA-setDataCollectionStatus_S_B__ul_yqc_3kj_z4b} {#AccA-setDataCollectionStatus_S_B__table_zk2_2g2_z4b__entry__3}{#AccA-setDataCollectionStatus_S_B__accAgents-parm-desc-agentID} | 이름 | 유형 | 설명 | |-|-|-| | agentID | 문자열 | 에이전트 클라이언트 수집기 \[sn_agent_cmdb_ci_agent\] 테이블의 에이전트 ID 열에 나열된 에이전트의 고유 ID입니다. | | 상태 | 부울 | 에이전트에 데이터 수집이 활성화되어 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 이 에이전트에 대한 데이터 수집을 활성화합니다. * false: 이 에이전트에 대한 데이터 수집을 비활성화합니다. {#AccA-setDataCollectionStatus_S_B__ul_iv2_jcz_bpb} 기본값: true | [표 12. 매개변수] {#AccA-setDataCollectionStatus_S_B__table_zk2_2g2_z4b} {#AccA-setDataCollectionStatus_S_B__table_al2_2g2_z4b__entry__2} | 유형 | 설명 | |-|-| | 문자열 | 오류 메시지는 해당하는 경우 null이며, 그렇지 않으면 null입니다. 예를 들어 `ID가 인 에이전트가 작동하지 않음: no throw된 오류`입니다. | [표 13. 반환] {#AccA-setDataCollectionStatus_S_B__table_al2_2g2_z4b} 다음 예는 에이전트 데이터 수집을 켜는 방법을 보여줍니다. var agentsApi = new sn_agent.AccAgentsAPI(); var err = agentsApi.setDataCollectionStatus("", true); if (!gs.nil(err)) gs.error(err); 다음 예시에서는 에이전트 데이터 수집을 끄는 방법을 보여줍니다. var agentsApi = new sn_agent.AccAgentsAPI(); var err = agentsApi.setDataCollectionStatus("", false); if (!gs.nil(err)) gs.error(err); ## AccAgentsAPI - submitGrabLogRequest(문자열 agentId) {#ariaid-title9} 활성/작동 중인 상태인 지정된 에이전트의 로그를 요청합니다. 주: 로그를 검색하고 진행 상황을 확인하려면 checkGrabLogRequestProgress() 메서드에 반환된 요청 ID를 전달합니다. {#AccA-submitGrabLogRequest_S__table_zk2_2g2_z4b__entry__3}{#AccA-submitGrabLogRequest_S__accAgents-parm-desc-agentID} | 이름 | 유형 | 설명 | |-|-|-| | agentID | 문자열 | 에이전트 클라이언트 수집기 \[sn_agent_cmdb_ci_agent\] 테이블의 에이전트 ID 열에 나열된 에이전트의 고유 ID입니다. | [표 14. 매개변수] {#AccA-submitGrabLogRequest_S__table_zk2_2g2_z4b} {#AccA-submitGrabLogRequest_S__table_al2_2g2_z4b__entry__2} | 속성 | 설명 | |-|-| | \ | 요청 ID 및 오류 정보를 포함하는 JSON 객체입니다. { "error": "String", "request_id": "String" } | | 오류 | 오류 메시지. 오류가 없으면 Null입니다. 데이터 유형: 문자열 | | request_id | 에이전트 클라이언트 수집기 요청\[sn_agent_request\] 테이블의 요청 Sys_id입니다. 이 ID를 사용하여 GET /agents/{request_id}/를 통해 요청 상태를 가져올 수 있습니다. 데이터 유형: 문자열 | [표 15. 반환] {#AccA-submitGrabLogRequest_S__table_al2_2g2_z4b} 다음 예제에서는 로그 요청 ID를 가져오는 방법을 보여줍니다. var agentsApi = new sn_agent.AccAgentsAPI(); var submittedRequest = agentsApi.submitGrabLogRequest(""); if (!gs.nil(submittedRequest.error)) gs.error(submittedRequest.error); else gs.info("Request ID: " + submittedRequest.request_id); 출력: Request ID: