식별 및 조정 API

릴리스 버전: Australia

업데이트 날짜 2026년 03월 12일

소요 시간: 182분

식별 및 조정 API는 IRE(식별 및 조정 엔진)를 사용하여 중복 CI(구성 항목)의 생성을 최소화하고, 을구성 관리 데이터베이스(CMDB)(를) 업데이트할 때 승인된 소스의 정보만 수락하여 CI 속성을 조정하는 엔드포인트를 제공합니다.

이 API를 사용하려면 사용자에게 itil 또는 자산 역할이 있어야 합니다.

IRE에 대한 자세한 내용은 IRE(식별 및 조정 엔진)를 참조하십시오.

식별 및 조정 - POST /now/identifyreconcile

지정된 페이로드(요청 본문)에 식별 및 조정 규칙을 적용하여 CI CMDB (구성 항목)를 삽입하거나 업데이트합니다. 직접 업데이트 CMDB 하는 대신 이 API를 사용합니다.

엔드포인트를 식별 및 조정 - POST /now/identifyreconcile/query 사용하여 데이터베이스에 대한 변경 내용을 커밋하지 않고 이 엔드포인트에 페이로드 제출을 시뮬레이션합니다.

향상된 IRE 옵션을 지정해야 하는 경우 엔드포인트를 식별 및 조정 - POST /now/identifyreconcile/enhanced 대신 사용합니다. 향상된 IRE 옵션에 대한 자세한 내용은 IRE(식별 및 조정 엔진)를 참조하십시오.

URL 형식

버전이 지정된 URL: /api/now/{api_version}/identifyreconcile

기본 URL: /api/now/identifyreconcile

주:

사용 가능한 버전은 REST API 탐색기에 지정됩니다. 스크립트 기반 REST API의 경우 스크립트 기반 REST 서비스 양식에 추가 버전 정보가 있습니다.

지원되는 요청 매개변수

표 1. 경로 매개변수
이름	설명
api_version	옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 `v1` 또는 `v2`입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오. 데이터 유형: 문자열

표 2. 쿼리 매개변수
이름	설명
sysparm_data_source	CI 정보의 소스입니다. 구성 항목 [cmdb_ci] 테이블의 discovery_source 필드에 대해 정의된 선택 값 중 하나여야 합니다. 데이터 유형: 문자열 기본값: 미완료 페이로드 테이블에 API 페이로드를 삽입합니다.

표 3. 요청 본문 매개변수(XML 또는 JSON)
이름	설명
항목	만들거나 업데이트할 CI 목록입니다. 데이터 유형: 객체 배열 `"items": [ { "className": "String", "internal_id": "String", "lookup": [Array], "related": [Array], "settings": {Object}, "sys_object_source_info": {Object}, "values": {Object} } ]`
items.className	필수 만들거나 업데이트할 CI의 sys_class_name(클래스/테이블 이름)입니다. 이 값은 cmdb_ci_linux_server 또는 cmdb_ci_win_server와 같은 모든 CMDB 테이블이 될 수 있습니다. 데이터 유형: 문자열
items.internal_id	이 페이로드에 있는 이 항목의 고유 식별자입니다. 모든 값이 될 수 있지만 페이로드 내에서 고유해야 합니다. 데이터 유형: 문자열
항목.조회	각 객체가 조회 기반 식별 기록을 설명하는 객체의 배열입니다. 이러한 기록은 구성 항목 [cmdb_ci] 테이블에 대한 참조가 있는 조회 테이블을 기반으로 최상위 구성 항목을 식별하는 데 사용됩니다. 데이터 유형: 객체 배열 `"lookup": [ { "className": "String", "internal_id": "String", "sys_object_source_info": {Object}, "values": {Object} } ]`
items.lookup.className	필수 만들거나 업데이트할 CI의 sys_class_name 또는 클래스/테이블 이름입니다. 이 값은 cmdb_serial_number이나 cmdb_ci_network_adapter 등의 클래스/테이블 또는 비CMDB계층 구조 클래스일 수 CMDB 있습니다. 데이터 유형: 문자열
items.lookup.internal_id	이 페이로드에 있는 이 조회 기록의 고유 식별자입니다. 모든 값이 될 수 있지만 페이로드 내에서 고유해야 합니다. 데이터 유형: 문자열
items.lookup.sys_object_source_info	지정된 데이터 소스에 대한 고유 CI 식별자를 설명하는 객체입니다. 소스마다 동일한 CI에 대해 서로 다른 이름-값 쌍이 있을 수 있습니다. 데이터 유형: 객체 `"sys_object_source_info": { "source_feed": "String", "source_name": "String", "source_native_key": "String", "source_recency_timestamp": "String" }`
items.lookup.sys_object_source_info.source_feed	이 CI를 보내는 피드를 고유하게 식별하는 이름입니다. 소스에 여러 피드가 있을 수 있는 경우 사용합니다. 데이터 유형: 문자열
items.lookup.sys_object_source_info.source_name	CI 정보의 데이터 소스입니다. 이 값은 구성 항목 [cmdb_ci] 테이블의 discovery_source 필드에 대해 정의된 선택 값 중 하나여야 합니다. 데이터 유형: 문자열
items.lookup.sys_object_source_info.source_native_key	CI 소스의 고유 키/ID입니다. 항목에 고유한 모든 문자열이 될 수 있습니다. 데이터 유형: 문자열
items.lookup.sys_object_source_info.source_recency_timestamp	CI를 스캔한 UTC 날짜 및 시간입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD hh:mm:ss
항목.조회.값	이 조회 항목의 필드를 이름/값 쌍으로 설명하는 객체입니다. 여기서 이름은 필드 이름입니다. 데이터 유형: 객체 필드 이름과 유형은 사용자가 선택한 필드에 따라 달라집니다(예: `"values": { "ip_address": "String", "mac_address": "String", "serial_number": "String", "serial_number_type": "String", "valid": "String" }`
항목.관련	식별되는 최상위 CI에 대한 참조가 있는 관련 테이블을 기반으로 각 객체가 만들거나 업데이트할 항목 기록을 설명하는 객체의 배열입니다. 관련 항목 [cmdb_related_entry] 테이블의 규칙은 이 배열에 포함될 수 있는 기록 유형을 정의합니다. 관련 테이블은 구성 항목 [cmdb_ci] 테이블을 확장하거나 확장하지 않을 수 있습니다. 이러한 기록은 구성 항목을 식별하는 데 사용되지 않습니다. 데이터 유형: 객체 배열 `"related": [ { "className": "String", "internal_id": "String", "sys_object_source_info": {Object}, "values": {Object} } ]`
items.related.className	필수 만들거나 업데이트할 관련 항목의 sys_class_name 또는 클래스/테이블 이름입니다. 데이터 유형: 문자열
items.related.internal_id	이 페이로드에 있는 이 관련 항목에 대한 고유 식별자입니다. 모든 값이 될 수 있지만 페이로드 내에서 고유해야 합니다. 데이터 유형: 문자열
items.related.sys_object_source_info	지정된 데이터 소스에 대한 고유 CI 식별자를 설명하는 객체입니다. 소스마다 동일한 CI에 대해 서로 다른 이름-값 쌍이 있을 수 있습니다. 데이터 유형: 객체 `"sys_object_source_info": { "source_feed": "String", "source_name": "String", "source_native_key": "String", "source_recency_timestamp": "String" }`
items.related.sys_object_source_info.source_feed	이 관련 항목을 보내는 피드를 고유하게 식별하는 이름입니다. 소스에 여러 피드가 있을 수 있는 경우 사용합니다. 데이터 유형: 문자열
items.related.sys_object_source_info.source_name	관련 항목 정보의 데이터 소스입니다. 이 값은 구성 항목 [cmdb_ci] 테이블의 discovery_source 필드에 대해 정의된 선택 값 중 하나여야 합니다. 데이터 유형: 문자열
items.related.sys_object_source_info.source_native_key	관련 항목에 대한 소스의 고유 키/ID입니다. 항목에 고유한 모든 문자열이 될 수 있습니다. 데이터 유형: 문자열
items.related.sys_object_source_info.source_recency_timestamp	관련 항목을 스캔한 UTC 날짜 및 시간입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD hh:mm:ss
항목.관련.값	이 관련 항목에 대해 작성하거나 업데이트할 필드를 이름/값 쌍으로 설명하는 객체입니다. 여기서 이름은 필드 이름입니다. 참조 필드의 경우 값은 참조된 sys_id여야 합니다. 데이터 유형: 객체 필드 이름과 유형은 사용자가 선택한 필드에 따라 달라집니다(예: `"values": { "host_name": "String", "ip_address": "String", "name": "String", "os_name": "String", "sys_class_name": "String" }`
항목.설정	허용되는 업데이트 유형을 정의하는 매개변수를 포함하는 객체입니다. 데이터 유형: 객체 `"settings": { "skipReclassificationRestrictionRules": Boolean, "updateWithoutDowngrade": Boolean, "updateWithoutSwitch": Boolean, "updateWithoutUpgrade": Boolean }`
items.settings.skipReclassificationRestrictionRules	IRE가 페이로드 항목의 클래스와 일치하는 재분류 제한 규칙 실행을 건너뛰어야 하는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. true: 규칙 실행을 건너뜁니다. false: 규칙을 실행합니다. 기본값: false
items.settings.updateWithoutDowngrade	이 CI에 대해 업데이트와 다운그레이드가 모두 허용되는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. 예: 항목을 업데이트하지만 다운그레이드는 허용되지 않습니다. 아니오: 항목 업데이트와 다운그레이드가 모두 허용됩니다. 데이터 유형: 부울 기본값: false
items.settings.updateWithoutSwitch	이 CI를 업데이트할 수 있고 클래스를 전환할 수 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. 예: 항목을 업데이트하지만 클래스 전환은 허용되지 않습니다. 아니오: 항목 업데이트와 클래스 전환이 모두 허용됩니다. 데이터 유형: 부울 기본값: false
items.settings.updateWithoutUpgrade	이 CI에 대해 업데이트와 업그레이드가 모두 허용되는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. 예: 항목을 업데이트하지만 업그레이드는 허용되지 않습니다. 아니오: 항목 업데이트와 업그레이드가 모두 허용됩니다. 데이터 유형: 부울 기본값: false
items.sys_object_source_info	고유 CI 식별자를 설명하는 객체입니다. 데이터 유형: 객체 `"sys_object_source_info": { "source_feed": "String", "source_name": "String", "source_native_key": "String", "source_recency_timestamp": "String" }`
items.sys_object_source_info.source_feed	이 CI를 보내는 피드를 고유하게 식별하는 이름입니다. 소스에 여러 피드가 있을 수 있는 경우 사용합니다. 데이터 유형: 문자열
items.sys_object_source_info.source_name	CI 정보의 데이터 소스입니다. 이 값은 구성 항목 [cmdb_ci] 테이블의 discovery_source 필드에 대해 정의된 선택 값 중 하나여야 합니다. 데이터 유형: 문자열
items.sys_object_source_info.source_native_key	CI 소스의 고유 키/ID입니다. 항목에 고유한 모든 문자열이 될 수 있습니다. 데이터 유형: 문자열
items.sys_object_source_info.source_recency_timestamp	CI를 스캔한 UTC 날짜 및 시간입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD hh:mm:ss
항목.값	이 CI에 대해 작성하거나 업데이트할 필드를 이름/값 쌍으로 설명하는 객체입니다(여기서 이름은 필드 이름). 참조 필드의 경우 값은 참조된 sys_id여야 합니다. 데이터 유형: 객체 필드 이름과 유형은 사용자가 선택한 필드에 따라 달라집니다(예: `"values": { "host_name": "String", "ip_address": "String", "name": "String", "os_name": "String", "sys_class_name": "String" }`
참조 항목	페이로드의 두 항목 간 참조 목록입니다. 각 참조 항목의 값은 클래스에 정의된 IRE 규칙을 사용하여 CI를 식별하기 전에 채워집니다. 데이터 유형: 객체 배열 `"referenceItems": [ { "referenced": "String", "referencedBy": "String", "referenceField": "String" } ]`
referenceItems.referenced	internal_id 다른 항목에서 참조하는 항목에 대해 정의되어 있습니다. 데이터 유형: 문자열
referenceItems.referencedBy	internal_id 다른 항목을 참조하는 항목에 대해 정의되어 있습니다. 데이터 유형: 문자열
referenceItems.referenceField	항목의 클래스/테이블에 있는 참조 필드의 이름입니다 referencedBy . 데이터 유형: 문자열
관계	페이로드에 정의된 두 항목 간의 관계 목록입니다. 이 배열의 객체는 다음 두 가지 형식 중 하나를 사용할 수 있습니다. 이 객체는 페이로드 items 배열의 항목 인덱스를 나타내는 값과 함께 이름-값 쌍을 사용하여 parentchild 두 최상위 항목 간의 관계를 정의할 수 있습니다. 이 객체는 키/값 쌍을 child_id 사용하여 parent_id 최상위 항목, 관련 항목 또는 조회 항목을 포함하여 두 항목 간의 관계를 정의할 수 있으며, 값은 해당 항목에 대해 정의된 값을 나타낼 internal_id 수 있습니다. 데이터 유형: 객체 배열 `"relations": [ { "child": Number, "parent": Number, "sys_rel_source_info": {Object}, "type": "String" } ]` `"relations": [ { "child_id": "String", "parent_id": "String", "sys_rel_source_info": {Object}, "type": "String" } ]`
관계.하위	관계의 하위 항목을 나타내는 배열에 있는 items CI 객체의 정수 인덱스입니다. 데이터 유형: 숫자
relations.child_id	internal_id 관계에 있는 하위 항목의 객체입니다. 데이터 유형: 문자열
relations.parent	관계의 상위를 나타내는 배열에 있는 items CI 객체의 정수 인덱스입니다. 데이터 유형: 숫자
relations.parent_id	internal_id 관계의 상위 항목입니다. 데이터 유형: 문자열
relations.sys_rel_source_info	관계에 대한 검색 소스 정보입니다. 비의존성 관계의 경우 이 정보는 관계 소스 [sys_rel_source] 테이블에 있습니다. 데이터 유형: 객체 `"sys_rel_source_info": { "source_name": "String", "source_feed": "String" }`
relations.sys_rel_source_info.source_name	검색 소스 이름입니다. 기본값: API 메서드 매개변수에 전달된 디스커버리 소스입니다.
relations.sys_rel_source_info.source_feed	검색 소스 내의 하위 검색/검사에 해당하는 모든 문자열입니다. 기본값: 테이블에서 기록을 생성할 때 source_feed 열에 "알 수 없음"sys_rel_source 저장됩니다.
관계.유형	상위 항목과 하위 항목 간에 존재하는 관계의 유형입니다. CI 관계 유형 [cmdb_rel_type] 테이블의 이름 필드 값이어야 합니다. 데이터 유형: 문자열

헤더

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 지원되는 REST API 헤더를 참조하십시오.

표 4. 요청 헤더
머리글	설명
수용	응답 본문의 데이터 형식입니다. application/json만 지원합니다.
콘텐츠-형식	요청 본문의 데이터 형식입니다. application/json만 지원합니다.

표 5. 응답 헤더
머리글	설명
안 함

상태 코드

이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하십시오.

표 6. 상태 코드
상태 코드	설명
200	성공입니다. 요청이 성공적으로 처리되었습니다.
401	권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다.
500	내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다.

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


이름	설명
결과	쿼리에 의해 생성된 결과 목록입니다. 데이터 유형: 배열 `"result": [ "additionalCommittedItems": [Array], "additionalCommittedRelations": [Array], "items": [Array], "relations": [Array] ]`
result.additionalCommittedItems	삽입하거나 업데이트할 요청 본문 items 배열에 포함되지 않은 CI 목록입니다. 데이터 유형: 객체 배열 `"additionalCommittedItems": [ { "className": "String", "errorCount": Number, "identificationAttempts": [Array], "inputIndices": [Array], "markers": [Array], "mergedPayloads": [Array], "operation": "String", "sysId": "String" } ]`
result.additionalCommittedItems.className	이 추가 CI의 sys_class_name입니다. 데이터 유형: 문자열
result.additionalCommittedItems.errorCount	이 추가 CI를 처리하는 동안 발생한 오류 수입니다. 데이터 유형: 숫자
result.additionalCommittedItems.errors	이 추가 CI를 처리하는 동안 발생한 오류 목록입니다. 데이터 유형: 객체 배열 `"errors": [ { "error": "String", "message": "String" } ]`
result.additionalCommittedItems.errors.error	이 추가 CI를 처리하는 동안 발생한 오류 유형입니다. 데이터 유형: 문자열
result.additionalCommittedItems.errors.message	이 추가 CI를 처리하는 동안 오류 메시지가 발생했습니다. 데이터 유형: 문자열
result.additionalCommittedItems.identificationAttempts	이 추가 CI를 식별하기 위해 수행한 시도 목록입니다. 데이터 유형: 객체 배열 `"identificationAttempts": [ { "attemptResult": "String", "attributes": [Array], "hybridEntryCiAttributes": [Array], "identiferName": "String", "searchOnTable": [Array] } ]`
result.additionalCommittedItems.identificationAttempts.attemptResult	이 추가 CI 식별 시도의 결과입니다. 가능한 값: 일치: 식별에 성공했습니다. 식별자 규칙 테이블에서 지정된 속성과 정확히 일치하는 고유한 CI를 찾았습니다. MULTI_MATCH: 오류로 인해 식별에 실패했습니다. 지정된 속성과 일치할 때 식별자 규칙 테이블에서 중복 CI가 발견되었습니다. NO_MATCH: 식별에 실패했습니다. 식별자 규칙 테이블에서 지정된 속성과 일치하는 CI를 찾을 수 없습니다. 건너뜀: 식별을 시도하지 않았습니다. 이 식별자 규칙 테이블 검색에 필요한 속성이 제공되지 않아 규칙이 적용되지 않았습니다. 데이터 유형: 문자열
result.additionalCommittedItems.identificationAttempts.attributes	이 추가 CI 식별 시도 중에 사용되는 CI 식별자 항목 속성의 배열입니다. 데이터 유형: 배열 속성 이름과 유형은 다음과 같이 요청 본문 데이터와 사용 중인 식별자에 따라 다릅니다. `"attributes": [ "serial_number": "String", "serial_number_type": "String" ]`
result.additionalCommittedItems.identificationAttempts.hybridEntryCiAttributes	이 추가 CI 식별 시도 중에 사용된 CI 식별자 항목 속성의 목록입니다. 데이터 유형: 배열 속성 이름과 유형은 다음과 같이 요청 본문 데이터와 사용 중인 식별자에 따라 다릅니다. `"hybridEntryCiAttributes": [ "name": "String", "serial_number": "String" ]`
result.additionalCommittedItems.identificationAttempts.identifierName	이 추가 CI 식별 시도에 사용되는 식별자 규칙입니다. 데이터 유형: 문자열
result.additionalCommittedItems.identificationAttempts.searchOnTable	이 추가 CI 식별 시도를 위해 검색된 테이블의 이름입니다. 데이터 유형: 문자열
result.additionalCommittedItems.identifierEntrySysId	이 추가 CI를 식별하는 데 사용되는 식별자 규칙의 Sys_id입니다. 주목할만한 가치: 알 수 없음: 이 추가 CI를 식별하지 못했습니다. 자세한 내용은 errors 문서를 참조하십시오. 데이터 유형: 문자열
result.additionalCommittedItems.inputIndices	이 추가 CI에 해당하는 요청 본문 items 배열의 CI 인덱스 값 목록입니다. 데이터 유형: 객체 배열 `"inputIndices": [ { Number } ]`
result.additionalCommittedItems.markers	내부용 마커 값 목록입니다. 데이터 유형: 배열 `"markers": []`
result.additionalCommittedItems.mergedPayloads	이 추가 CI를 처리하는 동안 병합된 CMDB IRE 부분 페이로드[cmdb_ire_partial_payloads] 테이블의 부분 페이로드에 대한 sys_id 값 목록입니다. 데이터 유형: 배열 `"mergedPayloadIds": [ "String" ]`
result.additionalCommittedItems.operation	이 추가 CI에 대해 수행된 작업입니다. 가능한 값: 삭제: 기존 CI가 대상 테이블에서 제거됩니다. 삽입: 추가적인 CI가 대상 테이블에 새 기록으로 삽입됩니다. NO_CHANGE: 추가 CI에 대해서는 작업이 수행되지 않습니다. 업데이트: 대상 테이블의 기존 CI가 업데이트됩니다. UPDATE_WITH_DOWNGRADE: 대상 테이블의 기존 CI가 업데이트되고 해당 클래스가 보다 일반적인 클래스(상위 클래스)로 변경됩니다. UPDATE_WITH_SWITCH: 대상 테이블의 기존 CI가 업데이트되고 해당 클래스가 상위 또는 하위 클래스가 아닌 다른 클래스로 변경됩니다. UPDATE_WITH_UPGRADE: 대상 테이블의 기존 CI가 업데이트되고 해당 클래스가 보다 전문화된 클래스(하위 클래스)로 변경됩니다. 데이터 유형: 문자열
result.additionalCommittedItems.sysId	식별을 통해 이 추가 CI에 대한 Sys_id 찾았습니다. 주목할 만한 값: 알 수 없음 - 이 추가 CI를 식별하지 못했습니다. 자세한 내용은 errors 문서를 참조하십시오. 데이터 유형: 문자열
result.additionalCommittedItems.warnings	이 추가 CI를 처리하는 동안 발생한 경고 목록입니다. 데이터 유형: 객체 배열 `"warnings": [ { "error": "String", "message": "String" } ]`
result.additionalCommittedItems.warnings.error	이 추가 CI를 처리하는 동안 발생한 경고의 유형입니다. 데이터 유형: 문자열
result.additionalCommittedItems.warnings.message	이 추가 CI를 처리하는 동안 경고 메시지가 발생했습니다. 데이터 유형: 문자열
result.additionalCommittedRelations	삽입하거나 업데이트할 요청 본문 relations 목록에 포함되지 않은 종속 관계 CI 목록입니다. 데이터 유형: 객체 배열 `"additionalCommittedRelations": [ { "className": "String", "operation": "String", "markers": [Array], "inputIndices": [Array], "mergedPayloadIds": [Array] } ]`
result.additionalCommittedRelations.className	이 추가 종속 관계 CI의 sys_class_name입니다. 지원되는 값: cmdb_rel_ci: CI 관계 테이블입니다. 데이터 유형: 문자열
result.additionalCommittedRelations.errorCount	이 추가 종속 관계 CI를 처리하는 동안 발생한 오류 수입니다. 데이터 유형: 숫자
result.additionalCommittedRelations.errors	이 추가 종속 관계 CI를 처리하는 동안 발생한 오류 목록입니다. 데이터 유형: 객체 배열 `"errors": [ { "error": "String", "message": "String" } ]`
result.additionalCommittedRelations.errors.error	이 추가 종속 관계 CI를 처리하는 동안 발생한 오류 유형입니다. 데이터 유형: 문자열
result.additionalCommittedRelations.errors.message	이 추가 종속 관계 CI를 처리하는 동안 오류 메시지가 발생했습니다. 데이터 유형: 문자열
result.additionalCommittedRelations.inputIndices	이 추가 종속 관계 CI에 해당하는 요청 본문 relations 배열의 종속 관계 CI 객체에 대한 인덱스 값 목록입니다. 데이터 유형: 배열 `"inputIndices": [ Number ]`
result.additionalCommittedRelations.markers	내부용 마커 값 목록입니다. 데이터 유형: 배열 `"markers": []`
result.additionalCommittedRelations.mergedPayloadIds	이 추가 종속 관계 CI를 처리하는 동안 병합된 CMDB IRE 부분 페이로드 [cmdb_ire_partial_payloads] 테이블의 부분 페이로드에 대한 sys_id 값 목록입니다. 데이터 유형: 배열 `"mergedPayloadIds": [ "String" ]`
result.additionalCommittedRelations.operation	이 추가 종속 관계 CI에 대해 수행된 작업입니다. 가능한 값: 삽입: 종속 관계 CI가 대상 테이블에 새 기록으로 삽입됩니다. INSERT_AS_INCOMPLETE: 종속 관계 CI에 오류가 있었고 CMDB IRE 미완료 페이로드 [cmdb_ire_incomplete_payloads] 테이블에 삽입되었습니다. INSERT_AS_PARTIAL: 종속 관계 CI에 오류가 있었고 CMDB IRE cmdb_ire_partial_payloads 페이로드 테이블에 삽입됩니다. NO_CHANGE: 종속 관계 CI에 대해 수행된 작업이 없습니다. 업데이트: 대상 테이블의 기존 종속 관계 CI가 업데이트됩니다. 데이터 유형: 문자열
결과.항목	요청 본문 items 배열에 포함된 CI 목록입니다. 데이터 유형: 객체 배열 `"items": [ { "additionalRelatedItems": [Array], "className": "String", "duplicateLookupIndices": {Object}, "errorCount": Number, "errors": [Array], "identificationAttempts": [Array], "identifierEntrySysId": "String", "info": [Array], "inputIndices": [Array], "markers": [Array], "mergedPayloadIds": [Array], "operation": "String", "relatedItems": [Array], "relatedSysIds": [Array], "sysId": "String", "warnings": [Array] } ]`
result.items.additionalRelatedItems	CMDB IRE 부분 페이로드 [cmdb_ire_partial_payloads] 테이블의 관련 CI(테이블 조회 CI) 목록입니다. 데이터 유형: 객체 배열 `"additionalRelatedItems": [ { "className": "String", "inputIndices": [Array], "markers": [Array], "mergedPayloadIds": [Array], "sysId": "String" } ]`
result.items.additionalRelatedItems.className	관련 항목의 sys_class_name입니다. 데이터 유형: 문자열
result.items.additionalRelatedItems.inputIndices	이 관련 항목에 해당하는 요청 본문 items 배열의 CI 인덱스 값 목록입니다. 데이터 유형: 배열 `"inputIndices": [ Number ]`
result.items.additionalRelatedItems.markers	내부용 마커 값 목록입니다. 데이터 유형: 배열 `"markers": []`
result.items.additionalRelatedItems.mergedPayloadIds	이 관련 항목을 처리하는 동안 병합된 CMDB IRE 부분 페이로드[cmdb_ire_partial_payloads] 테이블의 부분 페이로드에 대한 sys_id 값 목록입니다. 데이터 유형: 배열 `"mergedPayloadIds": [ "String" ]`
result.items.additionalRelatedItems.sysId	이 관련 CI의 Sys_id입니다. 데이터 유형: 문자열
result.items.className	이 CI의 Sys_class_name입니다. 데이터 유형: 문자열
result.items.duplicateLookupIndices	동일한 관련 CI를 참조하는 배열 요소에 대한 items.lookup 인덱스 값 배열을 포함하는 객체입니다. 배열 이름은 지정된 관련 CI를 참조하는 요청 본문 items.lookup 배열의 첫 번째 요소를 나타냅니다. 해당 값은 동일한 관련 CI를 참조하는 동일한 배열의 추가 요소 집합입니다. 데이터 유형: 객체 다음 예는 배열의 두 번째 요소가 items.lookup 해당 배열의 이후 요소와 동일한 관련 CI를 참조하는 경우를 보여줍니다. `"duplicateLookupIndices": [ "2": [Array] ]`
result.items.errorCount	이 CI를 처리하는 동안 발생한 오류 수입니다. 데이터 유형: 숫자
결과.항목.오류	이 CI를 처리하는 동안 발생한 오류 목록입니다. 데이터 유형: 객체 배열 `"errors": [ { "error": "String", "message": "String" } ]`
결과.항목.오류.오류	이 CI를 처리하는 동안 발생한 오류의 유형입니다. 데이터 유형: 문자열
결과.항목.오류.메시지	이 CI를 처리하는 동안 오류 메시지가 발생했습니다. 데이터 유형: 문자열
결과.항목.식별시도	이 CI를 식별하려고 시도한 목록입니다. 데이터 유형: 객체 배열 `"identificationAttempts": [ { "attemptResult": "String", "attributes": [Array], "hybridEntryCiAttributes": [Array], "identiferName": "String", "searchOnTable": [Array] } ]`
결과.항목.식별시도.시도결과	이 CI 식별 시도의 결과입니다. 가능한 값: 일치: 식별에 성공했습니다. 식별자 규칙 테이블에서 지정된 속성과 정확히 일치하는 고유한 CI를 찾았습니다. MULTI_MATCH: 오류로 인해 식별에 실패했습니다. 지정된 속성과 일치할 때 식별자 규칙 테이블에서 중복 CI가 발견되었습니다. NO_MATCH: 식별에 실패했습니다. 식별자 규칙 테이블에서 지정된 속성과 일치하는 CI를 찾을 수 없습니다. 건너뜀: 식별을 시도하지 않았습니다. 이 식별자 규칙 테이블 검색에 필요한 속성이 제공되지 않아 규칙이 적용되지 않았습니다. 데이터 유형: 문자열
result.items.identificationAttempts.attributes	이 CI 식별 시도 중에 사용된 CI 식별자 항목 속성의 목록입니다. 데이터 유형: 배열 속성 이름과 유형은 다음과 같이 요청 본문 데이터와 사용 중인 식별자에 따라 다릅니다. `"attributes": [ "serial_number": "String", "serial_number_type": "String", ]`
result.items.identificationAttempts.hybridEntryCiAttributes	이 CI 식별 시도 중에 사용된 CI 식별자 항목 속성의 목록입니다. 데이터 유형: 배열 속성 이름과 유형은 다음과 같이 요청 본문 데이터와 사용 중인 식별자에 따라 다릅니다. `"hybridEntryCiAttributes": [ "name": "String", "serial_number": "String" ]`
result.items.identificationAttempts.identifierName	이 CI 식별 시도에 사용되는 식별자 규칙입니다. 데이터 유형: 문자열
result.items.identificationAttempts.searchOnTable	이 CI 식별 시도를 위해 검색된 테이블의 이름입니다. 데이터 유형: 문자열
result.items.identifierEntrySysId	이 CI를 식별하는 데 사용되는 식별자 규칙의 Sys_id입니다. 주목할만한 가치: 알 수 없음: 이 CI를 식별하지 못했습니다. 자세한 내용은 errors 문서를 참조하십시오. 데이터 유형: 문자열
result.items.info	항목 처리에 대한 추가 정보 목록입니다. 데이터 유형: 객체 배열 `"info": [ { "code": "String", "message": "String", "ruleSysId": "String" } ]`
result.items.info.code	건너뛴 재분류 유형입니다. 가능한 값: SKIPPED_CLASS_SWITCH SKIPPED_CLASS_DOWNGRADE SKIPPED_CLASS_UPGRADE
result.items.info.message	재분류를 건너뛰는 이유에 대한 추가 인사이트를 제공하는 메시지입니다. 데이터 유형: 문자열
result.items.info.ruleSysId	일치하는 재분류 제한 규칙의 Sys_id입니다. IRE가 재분류 제한 규칙으로 인해 재분류를 건너뛰는 경우에만 적용할 수 있습니다. 페이로드 또는 전역 플래그로 인해 재분류를 건너뛰면 이 값은 비어 있습니다. 데이터 유형: 문자열
result.items.inputIndices	이 CI에 해당하는 요청 본문 items 배열의 CI 인덱스 값 목록입니다. 데이터 유형: 객체 배열 `"inputIndices": [ { Number } ]`
결과.항목.마커	내부용 마커 값 목록입니다. 데이터 유형: 배열 `"markers": []`
result.items.mergedPayloadIds	이 CI를 처리하는 동안 병합된 CMDB IRE Partial Payloads [cmdb_ire_partial_payloads] 테이블의 부분 페이로드에 대한 sys_id 값 목록입니다. 데이터 유형: 배열 `"mergedPayloadIds": [ "String" ]`
결과.항목.운영	이 CI에 대해 수행된 작업입니다. 가능한 값: 삭제: 기존 CI가 대상 테이블에서 제거됩니다. 삽입: CI가 대상 테이블에 새 기록으로 삽입됩니다. NO_CHANGE: CI에 대해 수행되는 작업이 없습니다. 업데이트: 대상 테이블의 기존 CI가 업데이트됩니다. UPDATE_WITH_DOWNGRADE: 대상 테이블의 기존 CI가 업데이트되고 해당 클래스가 보다 일반적인 클래스(상위 클래스)로 변경됩니다. UPDATE_WITH_SWITCH: 대상 테이블의 기존 CI가 업데이트되고 해당 클래스가 상위 또는 하위 클래스가 아닌 다른 클래스로 변경됩니다. UPDATE_WITH_UPGRADE: 대상 테이블의 기존 CI가 업데이트되고 해당 클래스가 보다 전문화된 클래스(하위 클래스)로 변경됩니다. 데이터 유형: 문자열
result.items.relatedItems	요청 본문 items.lookup 배열의 관련 CI(테이블 조회 CI) 목록입니다. 데이터 유형: 객체 배열 `"relatedItems": [ { "className": "String", "inputIndices": [Array], "markers": [Array], "mergedPayloadIds": [Array], "sysId": "String" } ]`
result.items.relatedItems.className	관련 항목의 sys_class_name입니다. 데이터 유형: 문자열
result.items.relatedItems.inputIndices	요청 본문 items 과 items.lookup 이 관련 항목에 해당하는 배열의 CI 및 조회 항목에 대한 인덱스 값 목록입니다. 데이터 유형: 객체 배열 `"inputIndices": [ { "mainIndex": Number, "subIndex": Number } ]`
result.items.relatedItems.inputIndices.mainIndex	관련 항목의 CI 상위에 해당하는 요청 본문 items 배열의 인덱스 값입니다. 데이터 유형: 숫자
result.items.relatedItems.inputIndices.subIndex	관련 항목에 해당하는 요청 본문 items.lookup 배열의 인덱스 값입니다. 데이터 유형: 숫자
result.items.relatedItems.markers	내부용 마커 값 목록입니다. 데이터 유형: 배열 `"markers": []`
result.items.relatedItems.mergedPayloadIds	처리 중에 이 CI에 병합된 CMDB IRE 부분 페이로드[cmdb_ire_partial_payloads] 테이블의 항목에 대한 sys_id 값 목록입니다. 데이터 유형: 배열 `"mergedPayloadIds": [ "String" ]`
result.items.relatedSysIds	요청 본문 items.lookup 배열의 관련 항목(테이블 조회 항목)에 대한 sys_id 값 목록입니다. 데이터 유형: 배열 주목할만한 가치: null: 이 관련 항목에 대해 식별된 sys_id이 없습니다. `"relatedSysIds": [ Number, Number ]`
result.items.sysId	식별을 통해 이 CI에 대한 Sys_id 찾았습니다. 주목할만한 가치: 알 수 없음: 이 CI를 식별하지 못했습니다. 자세한 내용은 errors 문서를 참조하십시오. 데이터 유형: 문자열
결과.항목.경고	이 CI를 처리하는 동안 발생한 경고 목록입니다. 데이터 유형: 객체 배열 `"warnings": [ { "error": "String", "message": "String" } ]`
결과.항목.경고.오류	이 CI를 처리하는 동안 발생한 경고의 유형입니다. 데이터 유형: 문자열
결과.항목.경고.메시지	이 CI를 처리하는 동안 발생한 경고 메시지. 데이터 유형: 문자열
result.logContextId	이 페이로드에 대해 보고된 컨텍스트 ID입니다. 데이터 유형: 문자열
결과.관계	요청 본문 relations 배열의 종속 관계 CI 목록입니다. 데이터 유형: 객체 배열 `"relations": [ { "className": "String", "errorCount": Number, "errors": [Array], "inputIndices": [Array], "markers": [Array], "mergedPayloadIds": [Array], "operation": "String", "warnings": [Array] } ]`
result.relations.className	이 종속 관계 CI의 sys_class_name입니다. 지원되는 값: cmdb_rel_ci: CI 관계 테이블입니다. 데이터 유형: 문자열
result.relations.errorCount	이 종속 관계 CI를 처리하는 동안 발생한 오류 수입니다. 데이터 유형: 숫자
결과.관계.오류	이 종속 관계 CI를 처리하는 동안 발생한 오류 목록입니다. 데이터 유형: 객체 배열 `"errors": [ { "error": "String", "message": "String" } ]`
결과.관계.오류.오류	이 종속 관계 CI를 처리하는 동안 발생한 오류 유형입니다. 데이터 유형: 문자열
result.relations.errors.message	이 종속 관계 CI를 처리하는 동안 오류 메시지가 발생했습니다. 데이터 유형: 문자열
result.relations.inputIndices	이 종속 관계 CI에 해당하는 요청 본문 relations 배열의 종속 관계 CI 객체에 대한 인덱스 값 목록입니다. 데이터 유형: 배열 `"inputIndices": [ Number ]`
결과.관계.마커	내부용 마커 값 목록입니다. 데이터 유형: 배열 `"markers": []`
result.relations.mergedPayloadIds	이 종속 관계 CI를 처리하는 동안 병합된 CMDB IRE 부분 페이로드 [cmdb_ire_partial_payloads] 테이블의 부분 페이로드에 대한 sys_id 값 목록입니다. 데이터 유형: 배열 `"mergedPayloadIds": [ "String" ]`
결과.관계.운영	이 종속 관계 CI에 대해 수행된 운영입니다. 가능한 값: 삽입: 종속 관계 CI가 대상 테이블에 새 기록으로 삽입되었습니다. INSERT_AS_INCOMPLETE: 종속 관계 CI에 오류가 있어 CMDB IRE 미완료 페이로드 [cmdb_ire_incomplete_payloads] 테이블에 삽입되었습니다. INSERT_AS_PARTIAL: 종속 관계 CI에 오류가 있어 CMDB IRE Partial Payloads [cmdb_ire_partial_payloads] 테이블에 삽입되었습니다. NO_CHANGE: 종속 관계 CI에 대해 수행된 운영이 없습니다. 업데이트: 대상 테이블의 기존 종속 관계 CI가 업데이트되었습니다. 데이터 유형: 문자열
결과.관계.경고	이 종속 관계 CI를 처리하는 동안 발생한 경고 목록입니다. 데이터 유형: 객체 배열 `"warnings": [ { "error": "String", "message": "String" } ]`
결과.관계.경고.오류	이 종속 관계 CI를 처리하는 동안 발생한 경고의 유형입니다. 데이터 유형: 문자열
결과.관계.경고.메시지	이 종속 관계 CI를 처리하는 동안 경고 메시지가 발생했습니다. 데이터 유형: 문자열

cURL 요청

Linux 서버(일련 번호 및 네트워크 어댑터 관련 항목 조회 포함)와 IP 스위치가 포함된 페이로드를 제출하며, 이들 사이에는 IP 연결 종속 관계가 있습니다.

curl "https://instance.servicenow.com/api/now/identifyreconcile" \
--request POST \
--header "Accept: application/json" \
--header "Content-Type: application/json" \
--user "username:password" \
--data '{ \
  "items": [{ \
    "className": "cmdb_ci_linux_server", \
    "values": { \
      "sys_class_name": "cmdb_ci_linux_server", \
      "name": "lnux101", \
      "host_name": "lnux101.servicenow.com", \
      "ip_address": "10.11.12.173", \
      "os_name": "Linux Red Hat" \
    }, \
    "lookup": [{ \
      "className": "cmdb_serial_number", \
      "values": { \
        "serial_number": "lnux101", \
        "serial_number_type": "uuid", \
        "valid": "true" \
      } \
    }, { \
      "className": "cmdb_ci_network_adapter", \
      "values": { \
        "name": "eth0", \
        "ip_address": "10.11.12.173", \
        "mac_address": "00:55:51:21:26:2f" \
      } \
    }] \
  }, { \
    "className": "cmdb_ci_ip_switch", \
    "values": { \
      "name": "IP-Switch-1", \
      "serial_number": "Switch23587", \
      "serial_number_type": "uuid" \
    } \
  }], \
  "relations": [{ \
    "parent": 0, \
    "child": 1, \
    "type": "IP Connection::IP Connection" \
  }]
}'

Linux 서버 CI는 하드웨어 규칙을 통해 식별되고 하드웨어 [cmdb_ci_hardware] 테이블에서 해당 이름을 검색하며 Linux 서버 [cmdb_ci_linux_server] 테이블에서 기존 CI에 대한 업데이트로 처리됩니다. IP 스위치는 하드웨어 규칙을 통해 유사하게 식별되고 하드웨어 테이블에서 해당 이름을 검색하고 IP 스위치 [cmdb_ci_ip_switch] 테이블에서 기존 CI를 업데이트합니다. 마지막으로 서버와 스위치 간의 IP 연결 종속 관계가 CI 관계 [cmdb_rel_ci] 테이블에 새 기록으로 삽입됩니다.

{
  "result": {
    "items": [{
      "className": "cmdb_ci_linux_server",
      "operation": "UPDATE",
      "sysId": "539747cac0a801640163e60735fbbf6e",
      "relatedSysIds": [null, null],
      "relatedItems": [{
        "markers": [],
        "inputIndices": [{
          "mainIndex": 0,
          "subIndex": 0
        }],
        "mergedPayloadIds": [],
        "className": "cmdb_serial_number"
      }, {
        "markers": [],
        "inputIndices": [{
          "mainIndex": 0,
          "subIndex": 1
        }],
        "mergedPayloadIds": [],
        "className": "cmdb_ci_network_adapter"
      }],
      "additionalRelatedItems": [],
      "identifierEntrySysId": "556eb250c3400200d8d4bea192d3ae92",
      "identificationAttempts": [{
        "identifierName": "Hardware Rule",
        "attemptResult": "NO_MATCH",
        "attributes": ["serial_number", "serial_number_type"],
        "searchOnTable": "cmdb_serial_number",
        "hybridEntryCiAttributes": []
      }, {
        "identifierName": "Hardware Rule",
        "attemptResult": "SKIPPED",
        "attributes": ["serial_number"],
        "searchOnTable": "cmdb_ci_hardware",
        "hybridEntryCiAttributes": []
      }, {
        "identifierName": "Hardware Rule",
        "attemptResult": "MATCHED",
        "attributes": ["name"],
        "searchOnTable": "cmdb_ci_hardware",
        "hybridEntryCiAttributes": []
      }],
      "markers": [],
      "inputIndices": [0],
      "mergedPayloadIds": [],
      "errorCount": 0
    }, {
      "className": "cmdb_ci_ip_switch",
      "operation": "UPDATE",
      "sysId": "304481257f701200bee45f19befa915b",
      "identifierEntrySysId": "556eb250c3400200d8d4bea192d3ae92",
      "identificationAttempts": [{
        "identifierName": "Hardware Rule",
        "attemptResult": "SKIPPED",
        "attributes": ["serial_number", "serial_number_type"],
        "searchOnTable": "cmdb_serial_number",
        "hybridEntryCiAttributes": []
      }, {
        "identifierName": "Hardware Rule",
        "attemptResult": "NO_MATCH",
        "attributes": ["serial_number"],
        "searchOnTable": "cmdb_ci_hardware",
        "hybridEntryCiAttributes": []
      }, {
        "identifierName": "Hardware Rule",
        "attemptResult": "MATCHED",
        "attributes": ["name"],
        "searchOnTable": "cmdb_ci_hardware",
        "hybridEntryCiAttributes": []
      }],
      "markers": [],
      "inputIndices": [1],
      "mergedPayloadIds": [],
      "errorCount": 0
    }],
    "additionalCommittedItems": [],
    "relations": [{
      "className": "cmdb_rel_ci",
      "operation": "INSERT",
      "markers": [],
      "inputIndices": [0],
      "mergedPayloadIds": [],
      "errorCount": 0
    }],
    "additionalCommittedRelations": []
  }
}

식별 및 조정 - POST /now/identifyreconcile/enhanced

엔드포인트를 식별 및 조정 - POST /now/identifyreconcile/queryEnhanced 사용하여 데이터베이스에 대한 변경 내용을 커밋하지 않고 이 엔드포인트에 페이로드 제출을 시뮬레이션합니다.

이 메서드는 메서드와 식별 및 조정 - POST /now/identifyreconcile 비슷하지만 다음 기능을 추가합니다.

부분 페이로드
- 항목에 경고 또는 오류가 있는 경우 항목 작업이 INSERT_AS_PARTIAL되었는지 또는 INSERT_INCOMPLETE 여부를 나타냅니다.
- 기존 부분 페이로드와 병합된 부분 페이로드의 sys_ids를 반환합니다.
페이로드 중복 제거 기능을 지원합니다.
요약을 생성합니다.

URL 형식

버전이 지정된 URL: /api/now/{api_version}/identifyreconcile/enhanced

기본 URL: /api/now/identifyreconcile/enhanced

주:

사용 가능한 버전은 REST API 탐색기에 지정됩니다. 스크립트 기반 REST API의 경우 스크립트 기반 REST 서비스 양식에 추가 버전 정보가 있습니다.

지원되는 요청 매개변수

표 7. 경로 매개변수
이름	설명
api_version	옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 `v1` 또는 `v2`입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오. 데이터 유형: 문자열

표 8. 쿼리 매개변수
이름	설명
옵션	요청에 적용된 향상된 IRE 옵션을 나타내는 이름-값 쌍의 쉼표로 구분된 목록입니다. 예를 들어, 부분 페이로드, 부분 커밋, 중복 제거 페이로드 및 요약 생성에 대한 기본값을 재정의합니다. 향상된 IRE 옵션: `partial_payloads:false,partial_commits:false,deduplicate_payloads:false,generate_summary:true` 주: 기본적으로 또는 if partial_payloads true로 설정되어 있으며, 이러한 기능은 부분 페이로드 기능에 필수적이므로 false로 설정되더라도 둘 다 partial_commitsdeduplicate_payloads 활성화됩니다. 향상된 IRE 옵션에 대한 자세한 내용은 IRE(식별 및 조정 엔진)를 참조하십시오. 각 이름-값 쌍에 유효한 값은 다음과 같습니다. true: 이 향상된 IRE 옵션을 활성화합니다. false: 이 향상된 IRE 옵션을 비활성화합니다. 데이터 유형: 문자열
sysparm_data_source	CI 정보의 소스입니다. 구성 항목 [cmdb_ci] 테이블의 discovery_source 필드에 대해 정의된 선택 값 중 하나여야 합니다. 데이터 유형: 문자열 기본값: 미완료 페이로드 테이블에 API 페이로드를 삽입합니다.

표 9. 요청 본문 매개변수(XML 또는 JSON)
이름	설명
항목	만들거나 업데이트할 CI 목록입니다. 데이터 유형: 객체 배열 `"items": [ { "className": "String", "internal_id": "String", "lookup": [Array], "related": [Array], "settings": {Object}, "sys_object_source_info": {Object}, "values": {Object} } ]`
items.className	필수 만들거나 업데이트할 CI의 sys_class_name(클래스/테이블 이름)입니다. 이 값은 cmdb_ci_linux_server 또는 cmdb_ci_win_server와 같은 모든 CMDB 테이블이 될 수 있습니다. 데이터 유형: 문자열
items.internal_id	이 페이로드에 있는 이 항목의 고유 식별자입니다. 모든 값이 될 수 있지만 페이로드 내에서 고유해야 합니다. 데이터 유형: 문자열
항목.조회	각 객체가 조회 기반 식별 기록을 설명하는 객체의 배열입니다. 이러한 기록은 구성 항목 [cmdb_ci] 테이블에 대한 참조가 있는 조회 테이블을 기반으로 최상위 구성 항목을 식별하는 데 사용됩니다. 데이터 유형: 객체 배열 `"lookup": [ { "className": "String", "internal_id": "String", "sys_object_source_info": {Object}, "values": {Object} } ]`
items.lookup.className	필수 만들거나 업데이트할 CI의 sys_class_name 또는 클래스/테이블 이름입니다. 이 값은 cmdb_serial_number이나 cmdb_ci_network_adapter 등의 클래스/테이블 또는 비CMDB계층 구조 클래스일 수 CMDB 있습니다. 데이터 유형: 문자열
items.lookup.internal_id	이 페이로드에 있는 이 조회 기록의 고유 식별자입니다. 모든 값이 될 수 있지만 페이로드 내에서 고유해야 합니다. 데이터 유형: 문자열
items.lookup.sys_object_source_info	지정된 데이터 소스에 대한 고유 CI 식별자를 설명하는 객체입니다. 소스마다 동일한 CI에 대해 서로 다른 이름-값 쌍이 있을 수 있습니다. 데이터 유형: 객체 `"sys_object_source_info": { "source_feed": "String", "source_name": "String", "source_native_key": "String", "source_recency_timestamp": "String" }`
items.lookup.sys_object_source_info.source_feed	이 CI를 보내는 피드를 고유하게 식별하는 이름입니다. 소스에 여러 피드가 있을 수 있는 경우 사용합니다. 데이터 유형: 문자열
items.lookup.sys_object_source_info.source_name	CI 정보의 데이터 소스입니다. 이 값은 구성 항목 [cmdb_ci] 테이블의 discovery_source 필드에 대해 정의된 선택 값 중 하나여야 합니다. 데이터 유형: 문자열
items.lookup.sys_object_source_info.source_native_key	CI 소스의 고유 키/ID입니다. 항목에 고유한 모든 문자열이 될 수 있습니다. 데이터 유형: 문자열
items.lookup.sys_object_source_info.source_recency_timestamp	CI를 스캔한 UTC 날짜 및 시간입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD hh:mm:ss
항목.조회.값	이 조회 항목의 필드를 이름/값 쌍으로 설명하는 객체입니다. 여기서 이름은 필드 이름입니다. 데이터 유형: 객체 필드 이름과 유형은 사용자가 선택한 필드에 따라 달라집니다(예: `"values": { "ip_address": "String", "mac_address": "String", "serial_number": "String", "serial_number_type": "String", "valid": "String" }`
항목.관련	식별되는 최상위 CI에 대한 참조가 있는 관련 테이블을 기반으로 각 객체가 만들거나 업데이트할 항목 기록을 설명하는 객체의 배열입니다. 관련 항목 [cmdb_related_entry] 테이블의 규칙은 이 배열에 포함될 수 있는 기록 유형을 정의합니다. 관련 테이블은 구성 항목 [cmdb_ci] 테이블을 확장하거나 확장하지 않을 수 있습니다. 이러한 기록은 구성 항목을 식별하는 데 사용되지 않습니다. 데이터 유형: 객체 배열 `"related": [ { "className": "String", "internal_id": "String", "sys_object_source_info": {Object}, "values": {Object} } ]`
items.related.className	필수 만들거나 업데이트할 관련 항목의 sys_class_name 또는 클래스/테이블 이름입니다. 데이터 유형: 문자열
items.related.internal_id	이 페이로드에 있는 이 관련 항목에 대한 고유 식별자입니다. 모든 값이 될 수 있지만 페이로드 내에서 고유해야 합니다. 데이터 유형: 문자열
items.related.sys_object_source_info	지정된 데이터 소스에 대한 고유 CI 식별자를 설명하는 객체입니다. 소스마다 동일한 CI에 대해 서로 다른 이름-값 쌍이 있을 수 있습니다. 데이터 유형: 객체 `"sys_object_source_info": { "source_feed": "String", "source_name": "String", "source_native_key": "String", "source_recency_timestamp": "String" }`
items.related.sys_object_source_info.source_feed	이 관련 항목을 보내는 피드를 고유하게 식별하는 이름입니다. 소스에 여러 피드가 있을 수 있는 경우 사용합니다. 데이터 유형: 문자열
items.related.sys_object_source_info.source_name	관련 항목 정보의 데이터 소스입니다. 이 값은 구성 항목 [cmdb_ci] 테이블의 discovery_source 필드에 대해 정의된 선택 값 중 하나여야 합니다. 데이터 유형: 문자열
items.related.sys_object_source_info.source_native_key	관련 항목에 대한 소스의 고유 키/ID입니다. 항목에 고유한 모든 문자열이 될 수 있습니다. 데이터 유형: 문자열
items.related.sys_object_source_info.source_recency_timestamp	관련 항목을 스캔한 UTC 날짜 및 시간입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD hh:mm:ss
항목.관련.값	이 관련 항목에 대해 작성하거나 업데이트할 필드를 이름/값 쌍으로 설명하는 객체입니다. 여기서 이름은 필드 이름입니다. 참조 필드의 경우 값은 참조된 sys_id여야 합니다. 데이터 유형: 객체 필드 이름과 유형은 사용자가 선택한 필드에 따라 달라집니다(예: `"values": { "host_name": "String", "ip_address": "String", "name": "String", "os_name": "String", "sys_class_name": "String" }`
항목.설정	허용되는 업데이트 유형을 정의하는 매개변수를 포함하는 객체입니다. 데이터 유형: 객체 `"settings": { "skipReclassificationRestrictionRules": Boolean, "updateWithoutDowngrade": Boolean, "updateWithoutSwitch": Boolean, "updateWithoutUpgrade": Boolean }`
items.settings.skipReclassificationRestrictionRules	IRE가 페이로드 항목의 클래스와 일치하는 재분류 제한 규칙 실행을 건너뛰어야 하는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. true: 규칙 실행을 건너뜁니다. false: 규칙을 실행합니다. 기본값: false
items.settings.updateWithoutDowngrade	이 CI에 대해 업데이트와 다운그레이드가 모두 허용되는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. 예: 항목을 업데이트하지만 다운그레이드는 허용되지 않습니다. 아니오: 항목 업데이트와 다운그레이드가 모두 허용됩니다. 데이터 유형: 부울 기본값: false
items.settings.updateWithoutSwitch	이 CI를 업데이트할 수 있고 클래스를 전환할 수 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. 예: 항목을 업데이트하지만 클래스 전환은 허용되지 않습니다. 아니오: 항목 업데이트와 클래스 전환이 모두 허용됩니다. 데이터 유형: 부울 기본값: false
items.settings.updateWithoutUpgrade	이 CI에 대해 업데이트와 업그레이드가 모두 허용되는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. 예: 항목을 업데이트하지만 업그레이드는 허용되지 않습니다. 아니오: 항목 업데이트와 업그레이드가 모두 허용됩니다. 데이터 유형: 부울 기본값: false
items.sys_object_source_info	고유 CI 식별자를 설명하는 객체입니다. 데이터 유형: 객체 `"sys_object_source_info": { "source_feed": "String", "source_name": "String", "source_native_key": "String", "source_recency_timestamp": "String" }`
items.sys_object_source_info.source_feed	이 CI를 보내는 피드를 고유하게 식별하는 이름입니다. 소스에 여러 피드가 있을 수 있는 경우 사용합니다. 데이터 유형: 문자열
items.sys_object_source_info.source_name	CI 정보의 데이터 소스입니다. 이 값은 구성 항목 [cmdb_ci] 테이블의 discovery_source 필드에 대해 정의된 선택 값 중 하나여야 합니다. 데이터 유형: 문자열
items.sys_object_source_info.source_native_key	CI 소스의 고유 키/ID입니다. 항목에 고유한 모든 문자열이 될 수 있습니다. 데이터 유형: 문자열
items.sys_object_source_info.source_recency_timestamp	CI를 스캔한 UTC 날짜 및 시간입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD hh:mm:ss
항목.값	이 CI에 대해 작성하거나 업데이트할 필드를 이름/값 쌍으로 설명하는 객체입니다(여기서 이름은 필드 이름). 참조 필드의 경우 값은 참조된 sys_id여야 합니다. 데이터 유형: 객체 필드 이름과 유형은 사용자가 선택한 필드에 따라 달라집니다(예: `"values": { "host_name": "String", "ip_address": "String", "name": "String", "os_name": "String", "sys_class_name": "String" }`
참조 항목	페이로드의 두 항목 간 참조 목록입니다. 각 참조 항목의 값은 클래스에 정의된 IRE 규칙을 사용하여 CI를 식별하기 전에 채워집니다. 데이터 유형: 객체 배열 `"referenceItems": [ { "referenced": "String", "referencedBy": "String", "referenceField": "String" } ]`
referenceItems.referenced	internal_id 다른 항목에서 참조하는 항목에 대해 정의되어 있습니다. 데이터 유형: 문자열
referenceItems.referencedBy	internal_id 다른 항목을 참조하는 항목에 대해 정의되어 있습니다. 데이터 유형: 문자열
referenceItems.referenceField	항목의 클래스/테이블에 있는 참조 필드의 이름입니다 referencedBy . 데이터 유형: 문자열
관계	페이로드에 정의된 두 항목 간의 관계 목록입니다. 이 배열의 객체는 다음 두 가지 형식 중 하나를 사용할 수 있습니다. 이 객체는 페이로드 items 배열의 항목 인덱스를 나타내는 값과 함께 이름-값 쌍을 사용하여 parentchild 두 최상위 항목 간의 관계를 정의할 수 있습니다. 이 객체는 키/값 쌍을 child_id 사용하여 parent_id 최상위 항목, 관련 항목 또는 조회 항목을 포함하여 두 항목 간의 관계를 정의할 수 있으며, 값은 해당 항목에 대해 정의된 값을 나타낼 internal_id 수 있습니다. 데이터 유형: 객체 배열 `"relations": [ { "child": Number, "parent": Number, "sys_rel_source_info": {Object}, "type": "String" } ]` `"relations": [ { "child_id": "String", "parent_id": "String", "sys_rel_source_info": {Object}, "type": "String" } ]`
관계.하위	관계의 하위 항목을 나타내는 배열에 있는 items CI 객체의 정수 인덱스입니다. 데이터 유형: 숫자
relations.child_id	internal_id 관계에 있는 하위 항목의 객체입니다. 데이터 유형: 문자열
relations.parent	관계의 상위를 나타내는 배열에 있는 items CI 객체의 정수 인덱스입니다. 데이터 유형: 숫자
relations.parent_id	internal_id 관계의 상위 항목입니다. 데이터 유형: 문자열
relations.sys_rel_source_info	관계에 대한 검색 소스 정보입니다. 비의존성 관계의 경우 이 정보는 관계 소스 [sys_rel_source] 테이블에 있습니다. 데이터 유형: 객체 `"sys_rel_source_info": { "source_name": "String", "source_feed": "String" }`
relations.sys_rel_source_info.source_name	검색 소스 이름입니다. 기본값: API 메서드 매개변수에 전달된 디스커버리 소스입니다.
relations.sys_rel_source_info.source_feed	검색 소스 내의 하위 검색/검사에 해당하는 모든 문자열입니다. 기본값: 테이블에서 기록을 생성할 때 source_feed 열에 "알 수 없음"sys_rel_source 저장됩니다.
관계.유형	상위 항목과 하위 항목 간에 존재하는 관계의 유형입니다. CI 관계 유형 [cmdb_rel_type] 테이블의 이름 필드 값이어야 합니다. 데이터 유형: 문자열

헤더

표 10. 요청 헤더
머리글	설명
수용	응답 본문의 데이터 형식입니다. application/json만 지원합니다.
콘텐츠-형식	요청 본문의 데이터 형식입니다. application/json만 지원합니다.

표 11. 응답 헤더
머리글	설명
안 함

상태 코드

이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하십시오.

표 12. 상태 코드
상태 코드	설명
200	성공입니다. 요청이 성공적으로 처리되었습니다.
401	권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다.
500	내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 오류 메시지 상세 정보 "청크 [...]는 유효한 항목이 아닙니다"는 쿼리 매개변수가 options 올바른 이름-값 쌍 형식이 아님을 나타냅니다. 예를 들어 `partial` 매개변수를 options 지정하면 메시지 상세 정보에 "청크 [부분]은 유효한 항목이 아닙니다"가 포함된 500 상태 코드가 생성됩니다.

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


이름	설명
결과	쿼리에 의해 생성된 결과 목록입니다. 데이터 유형: 배열 `"result": [ "additionalCommittedItems": [Array], "additionalCommittedRelations": [Array], "items": [Array], "relations": [Array] ]`
result.additionalCommittedItems	삽입하거나 업데이트할 요청 본문 items 배열에 포함되지 않은 CI 목록입니다. 데이터 유형: 객체 배열 `"additionalCommittedItems": [ { "className": "String", "errorCount": Number, "identificationAttempts": [Array], "inputIndices": [Array], "markers": [Array], "mergedPayloads": [Array], "operation": "String", "sysId": "String" } ]`
result.additionalCommittedItems.className	이 추가 CI의 sys_class_name입니다. 데이터 유형: 문자열
result.additionalCommittedItems.errorCount	이 추가 CI를 처리하는 동안 발생한 오류 수입니다. 데이터 유형: 숫자
result.additionalCommittedItems.errors	이 추가 CI를 처리하는 동안 발생한 오류 목록입니다. 데이터 유형: 객체 배열 `"errors": [ { "error": "String", "message": "String" } ]`
result.additionalCommittedItems.errors.error	이 추가 CI를 처리하는 동안 발생한 오류 유형입니다. 데이터 유형: 문자열
result.additionalCommittedItems.errors.message	이 추가 CI를 처리하는 동안 오류 메시지가 발생했습니다. 데이터 유형: 문자열
result.additionalCommittedItems.identificationAttempts	이 추가 CI를 식별하기 위해 수행한 시도 목록입니다. 데이터 유형: 객체 배열 `"identificationAttempts": [ { "attemptResult": "String", "attributes": [Array], "hybridEntryCiAttributes": [Array], "identiferName": "String", "searchOnTable": [Array] } ]`
result.additionalCommittedItems.identificationAttempts.attemptResult	이 추가 CI 식별 시도의 결과입니다. 가능한 값: 일치: 식별에 성공했습니다. 식별자 규칙 테이블에서 지정된 속성과 정확히 일치하는 고유한 CI를 찾았습니다. MULTI_MATCH: 오류로 인해 식별에 실패했습니다. 지정된 속성과 일치할 때 식별자 규칙 테이블에서 중복 CI가 발견되었습니다. NO_MATCH: 식별에 실패했습니다. 식별자 규칙 테이블에서 지정된 속성과 일치하는 CI를 찾을 수 없습니다. 건너뜀: 식별을 시도하지 않았습니다. 이 식별자 규칙 테이블 검색에 필요한 속성이 제공되지 않아 규칙이 적용되지 않았습니다. 데이터 유형: 문자열
result.additionalCommittedItems.identificationAttempts.attributes	이 추가 CI 식별 시도 중에 사용되는 CI 식별자 항목 속성의 배열입니다. 데이터 유형: 배열 속성 이름과 유형은 다음과 같이 요청 본문 데이터와 사용 중인 식별자에 따라 다릅니다. `"attributes": [ "serial_number": "String", "serial_number_type": "String" ]`
result.additionalCommittedItems.identificationAttempts.hybridEntryCiAttributes	이 추가 CI 식별 시도 중에 사용된 CI 식별자 항목 속성의 목록입니다. 데이터 유형: 배열 속성 이름과 유형은 다음과 같이 요청 본문 데이터와 사용 중인 식별자에 따라 다릅니다. `"hybridEntryCiAttributes": [ "name": "String", "serial_number": "String" ]`
result.additionalCommittedItems.identificationAttempts.identifierName	이 추가 CI 식별 시도에 사용되는 식별자 규칙입니다. 데이터 유형: 문자열
result.additionalCommittedItems.identificationAttempts.searchOnTable	이 추가 CI 식별 시도를 위해 검색된 테이블의 이름입니다. 데이터 유형: 문자열
result.additionalCommittedItems.identifierEntrySysId	이 추가 CI를 식별하는 데 사용되는 식별자 규칙의 Sys_id입니다. 주목할만한 가치: 알 수 없음: 이 추가 CI를 식별하지 못했습니다. 자세한 내용은 errors 문서를 참조하십시오. 데이터 유형: 문자열
result.additionalCommittedItems.inputIndices	이 추가 CI에 해당하는 요청 본문 items 배열의 CI 인덱스 값 목록입니다. 데이터 유형: 객체 배열 `"inputIndices": [ { Number } ]`
result.additionalCommittedItems.markers	내부용 마커 값 목록입니다. 데이터 유형: 배열 `"markers": []`
result.additionalCommittedItems.mergedPayloads	이 추가 CI를 처리하는 동안 병합된 CMDB IRE 부분 페이로드[cmdb_ire_partial_payloads] 테이블의 부분 페이로드에 대한 sys_id 값 목록입니다. 데이터 유형: 배열 `"mergedPayloadIds": [ "String" ]`
result.additionalCommittedItems.operation	이 추가 CI에 대해 수행된 작업입니다. 가능한 값: 삭제: 기존 CI가 대상 테이블에서 제거됩니다. 삽입: 추가적인 CI가 대상 테이블에 새 기록으로 삽입됩니다. NO_CHANGE: 추가 CI에 대해서는 작업이 수행되지 않습니다. 업데이트: 대상 테이블의 기존 CI가 업데이트됩니다. UPDATE_WITH_DOWNGRADE: 대상 테이블의 기존 CI가 업데이트되고 해당 클래스가 보다 일반적인 클래스(상위 클래스)로 변경됩니다. UPDATE_WITH_SWITCH: 대상 테이블의 기존 CI가 업데이트되고 해당 클래스가 상위 또는 하위 클래스가 아닌 다른 클래스로 변경됩니다. UPDATE_WITH_UPGRADE: 대상 테이블의 기존 CI가 업데이트되고 해당 클래스가 보다 전문화된 클래스(하위 클래스)로 변경됩니다. 데이터 유형: 문자열
result.additionalCommittedItems.sysId	식별을 통해 이 추가 CI에 대한 Sys_id 찾았습니다. 주목할 만한 값: 알 수 없음 - 이 추가 CI를 식별하지 못했습니다. 자세한 내용은 errors 문서를 참조하십시오. 데이터 유형: 문자열
result.additionalCommittedItems.warnings	이 추가 CI를 처리하는 동안 발생한 경고 목록입니다. 데이터 유형: 객체 배열 `"warnings": [ { "error": "String", "message": "String" } ]`
result.additionalCommittedItems.warnings.error	이 추가 CI를 처리하는 동안 발생한 경고의 유형입니다. 데이터 유형: 문자열
result.additionalCommittedItems.warnings.message	이 추가 CI를 처리하는 동안 경고 메시지가 발생했습니다. 데이터 유형: 문자열
result.additionalCommittedRelations	삽입하거나 업데이트할 요청 본문 relations 목록에 포함되지 않은 종속 관계 CI 목록입니다. 데이터 유형: 객체 배열 `"additionalCommittedRelations": [ { "className": "String", "operation": "String", "markers": [Array], "inputIndices": [Array], "mergedPayloadIds": [Array] } ]`
result.additionalCommittedRelations.className	이 추가 종속 관계 CI의 sys_class_name입니다. 지원되는 값: cmdb_rel_ci: CI 관계 테이블입니다. 데이터 유형: 문자열
result.additionalCommittedRelations.errorCount	이 추가 종속 관계 CI를 처리하는 동안 발생한 오류 수입니다. 데이터 유형: 숫자
result.additionalCommittedRelations.errors	이 추가 종속 관계 CI를 처리하는 동안 발생한 오류 목록입니다. 데이터 유형: 객체 배열 `"errors": [ { "error": "String", "message": "String" } ]`
result.additionalCommittedRelations.errors.error	이 추가 종속 관계 CI를 처리하는 동안 발생한 오류 유형입니다. 데이터 유형: 문자열
result.additionalCommittedRelations.errors.message	이 추가 종속 관계 CI를 처리하는 동안 오류 메시지가 발생했습니다. 데이터 유형: 문자열
result.additionalCommittedRelations.inputIndices	이 추가 종속 관계 CI에 해당하는 요청 본문 relations 배열의 종속 관계 CI 객체에 대한 인덱스 값 목록입니다. 데이터 유형: 배열 `"inputIndices": [ Number ]`
result.additionalCommittedRelations.markers	내부용 마커 값 목록입니다. 데이터 유형: 배열 `"markers": []`
result.additionalCommittedRelations.mergedPayloadIds	이 추가 종속 관계 CI를 처리하는 동안 병합된 CMDB IRE 부분 페이로드 [cmdb_ire_partial_payloads] 테이블의 부분 페이로드에 대한 sys_id 값 목록입니다. 데이터 유형: 배열 `"mergedPayloadIds": [ "String" ]`
result.additionalCommittedRelations.operation	이 추가 종속 관계 CI에 대해 수행된 작업입니다. 가능한 값: 삽입: 종속 관계 CI가 대상 테이블에 새 기록으로 삽입됩니다. INSERT_AS_INCOMPLETE: 종속 관계 CI에 오류가 있었고 CMDB IRE 미완료 페이로드 [cmdb_ire_incomplete_payloads] 테이블에 삽입되었습니다. INSERT_AS_PARTIAL: 종속 관계 CI에 오류가 있었고 CMDB IRE cmdb_ire_partial_payloads 페이로드 테이블에 삽입됩니다. NO_CHANGE: 종속 관계 CI에 대해 수행된 작업이 없습니다. 업데이트: 대상 테이블의 기존 종속 관계 CI가 업데이트됩니다. 데이터 유형: 문자열
결과.항목	요청 본문 items 배열에 포함된 CI 목록입니다. 데이터 유형: 객체 배열 `"items": [ { "additionalRelatedItems": [Array], "className": "String", "duplicateLookupIndices": {Object}, "errorCount": Number, "errors": [Array], "identificationAttempts": [Array], "identifierEntrySysId": "String", "info": [Array], "inputIndices": [Array], "markers": [Array], "mergedPayloadIds": [Array], "operation": "String", "relatedItems": [Array], "relatedSysIds": [Array], "sysId": "String", "warnings": [Array] } ]`
result.items.additionalRelatedItems	CMDB IRE 부분 페이로드 [cmdb_ire_partial_payloads] 테이블의 관련 CI(테이블 조회 CI) 목록입니다. 데이터 유형: 객체 배열 `"additionalRelatedItems": [ { "className": "String", "inputIndices": [Array], "markers": [Array], "mergedPayloadIds": [Array], "sysId": "String" } ]`
result.items.additionalRelatedItems.className	관련 항목의 sys_class_name입니다. 데이터 유형: 문자열
result.items.additionalRelatedItems.inputIndices	이 관련 항목에 해당하는 요청 본문 items 배열의 CI 인덱스 값 목록입니다. 데이터 유형: 배열 `"inputIndices": [ Number ]`
result.items.additionalRelatedItems.markers	내부용 마커 값 목록입니다. 데이터 유형: 배열 `"markers": []`
result.items.additionalRelatedItems.mergedPayloadIds	이 관련 항목을 처리하는 동안 병합된 CMDB IRE 부분 페이로드[cmdb_ire_partial_payloads] 테이블의 부분 페이로드에 대한 sys_id 값 목록입니다. 데이터 유형: 배열 `"mergedPayloadIds": [ "String" ]`
result.items.additionalRelatedItems.sysId	이 관련 CI의 Sys_id입니다. 데이터 유형: 문자열
result.items.className	이 CI의 Sys_class_name입니다. 데이터 유형: 문자열
result.items.duplicateLookupIndices	동일한 관련 CI를 참조하는 배열 요소에 대한 items.lookup 인덱스 값 배열을 포함하는 객체입니다. 배열 이름은 지정된 관련 CI를 참조하는 요청 본문 items.lookup 배열의 첫 번째 요소를 나타냅니다. 해당 값은 동일한 관련 CI를 참조하는 동일한 배열의 추가 요소 집합입니다. 데이터 유형: 객체 다음 예는 배열의 두 번째 요소가 items.lookup 해당 배열의 이후 요소와 동일한 관련 CI를 참조하는 경우를 보여줍니다. `"duplicateLookupIndices": [ "2": [Array] ]`
result.items.errorCount	이 CI를 처리하는 동안 발생한 오류 수입니다. 데이터 유형: 숫자
결과.항목.오류	이 CI를 처리하는 동안 발생한 오류 목록입니다. 데이터 유형: 객체 배열 `"errors": [ { "error": "String", "message": "String" } ]`
결과.항목.오류.오류	이 CI를 처리하는 동안 발생한 오류의 유형입니다. 데이터 유형: 문자열
결과.항목.오류.메시지	이 CI를 처리하는 동안 오류 메시지가 발생했습니다. 데이터 유형: 문자열
결과.항목.식별시도	이 CI를 식별하려고 시도한 목록입니다. 데이터 유형: 객체 배열 `"identificationAttempts": [ { "attemptResult": "String", "attributes": [Array], "hybridEntryCiAttributes": [Array], "identiferName": "String", "searchOnTable": [Array] } ]`
결과.항목.식별시도.시도결과	이 CI 식별 시도의 결과입니다. 가능한 값: 일치: 식별에 성공했습니다. 식별자 규칙 테이블에서 지정된 속성과 정확히 일치하는 고유한 CI를 찾았습니다. MULTI_MATCH: 오류로 인해 식별에 실패했습니다. 지정된 속성과 일치할 때 식별자 규칙 테이블에서 중복 CI가 발견되었습니다. NO_MATCH: 식별에 실패했습니다. 식별자 규칙 테이블에서 지정된 속성과 일치하는 CI를 찾을 수 없습니다. 건너뜀: 식별을 시도하지 않았습니다. 이 식별자 규칙 테이블 검색에 필요한 속성이 제공되지 않아 규칙이 적용되지 않았습니다. 데이터 유형: 문자열
result.items.identificationAttempts.attributes	이 CI 식별 시도 중에 사용된 CI 식별자 항목 속성의 목록입니다. 데이터 유형: 배열 속성 이름과 유형은 다음과 같이 요청 본문 데이터와 사용 중인 식별자에 따라 다릅니다. `"attributes": [ "serial_number": "String", "serial_number_type": "String", ]`
result.items.identificationAttempts.hybridEntryCiAttributes	이 CI 식별 시도 중에 사용된 CI 식별자 항목 속성의 목록입니다. 데이터 유형: 배열 속성 이름과 유형은 다음과 같이 요청 본문 데이터와 사용 중인 식별자에 따라 다릅니다. `"hybridEntryCiAttributes": [ "name": "String", "serial_number": "String" ]`
result.items.identificationAttempts.identifierName	이 CI 식별 시도에 사용되는 식별자 규칙입니다. 데이터 유형: 문자열
result.items.identificationAttempts.searchOnTable	이 CI 식별 시도를 위해 검색된 테이블의 이름입니다. 데이터 유형: 문자열
result.items.identifierEntrySysId	이 CI를 식별하는 데 사용되는 식별자 규칙의 Sys_id입니다. 주목할만한 가치: 알 수 없음: 이 CI를 식별하지 못했습니다. 자세한 내용은 errors 문서를 참조하십시오. 데이터 유형: 문자열
result.items.info	항목 처리에 대한 추가 정보 목록입니다. 데이터 유형: 객체 배열 `"info": [ { "code": "String", "message": "String", "ruleSysId": "String" } ]`
result.items.info.code	건너뛴 재분류 유형입니다. 가능한 값: SKIPPED_CLASS_SWITCH SKIPPED_CLASS_DOWNGRADE SKIPPED_CLASS_UPGRADE
result.items.info.message	재분류를 건너뛰는 이유에 대한 추가 인사이트를 제공하는 메시지입니다. 데이터 유형: 문자열
result.items.info.ruleSysId	일치하는 재분류 제한 규칙의 Sys_id입니다. IRE가 재분류 제한 규칙으로 인해 재분류를 건너뛰는 경우에만 적용할 수 있습니다. 페이로드 또는 전역 플래그로 인해 재분류를 건너뛰면 이 값은 비어 있습니다. 데이터 유형: 문자열
result.items.inputIndices	이 CI에 해당하는 요청 본문 items 배열의 CI 인덱스 값 목록입니다. 데이터 유형: 객체 배열 `"inputIndices": [ { Number } ]`
결과.항목.마커	내부용 마커 값 목록입니다. 데이터 유형: 배열 `"markers": []`
result.items.mergedPayloadIds	이 CI를 처리하는 동안 병합된 CMDB IRE Partial Payloads [cmdb_ire_partial_payloads] 테이블의 부분 페이로드에 대한 sys_id 값 목록입니다. 데이터 유형: 배열 `"mergedPayloadIds": [ "String" ]`
결과.항목.운영	이 CI에 대해 수행된 작업입니다. 가능한 값: 삭제: 기존 CI가 대상 테이블에서 제거됩니다. 삽입: CI가 대상 테이블에 새 기록으로 삽입됩니다. NO_CHANGE: CI에 대해 수행되는 작업이 없습니다. 업데이트: 대상 테이블의 기존 CI가 업데이트됩니다. UPDATE_WITH_DOWNGRADE: 대상 테이블의 기존 CI가 업데이트되고 해당 클래스가 보다 일반적인 클래스(상위 클래스)로 변경됩니다. UPDATE_WITH_SWITCH: 대상 테이블의 기존 CI가 업데이트되고 해당 클래스가 상위 또는 하위 클래스가 아닌 다른 클래스로 변경됩니다. UPDATE_WITH_UPGRADE: 대상 테이블의 기존 CI가 업데이트되고 해당 클래스가 보다 전문화된 클래스(하위 클래스)로 변경됩니다. 데이터 유형: 문자열
result.items.relatedItems	요청 본문 items.lookup 배열의 관련 CI(테이블 조회 CI) 목록입니다. 데이터 유형: 객체 배열 `"relatedItems": [ { "className": "String", "inputIndices": [Array], "markers": [Array], "mergedPayloadIds": [Array], "sysId": "String" } ]`
result.items.relatedItems.className	관련 항목의 sys_class_name입니다. 데이터 유형: 문자열
result.items.relatedItems.inputIndices	요청 본문 items 과 items.lookup 이 관련 항목에 해당하는 배열의 CI 및 조회 항목에 대한 인덱스 값 목록입니다. 데이터 유형: 객체 배열 `"inputIndices": [ { "mainIndex": Number, "subIndex": Number } ]`
result.items.relatedItems.inputIndices.mainIndex	관련 항목의 CI 상위에 해당하는 요청 본문 items 배열의 인덱스 값입니다. 데이터 유형: 숫자
result.items.relatedItems.inputIndices.subIndex	관련 항목에 해당하는 요청 본문 items.lookup 배열의 인덱스 값입니다. 데이터 유형: 숫자
result.items.relatedItems.markers	내부용 마커 값 목록입니다. 데이터 유형: 배열 `"markers": []`
result.items.relatedItems.mergedPayloadIds	처리 중에 이 CI에 병합된 CMDB IRE 부분 페이로드[cmdb_ire_partial_payloads] 테이블의 항목에 대한 sys_id 값 목록입니다. 데이터 유형: 배열 `"mergedPayloadIds": [ "String" ]`
result.items.relatedSysIds	요청 본문 items.lookup 배열의 관련 항목(테이블 조회 항목)에 대한 sys_id 값 목록입니다. 데이터 유형: 배열 주목할만한 가치: null: 이 관련 항목에 대해 식별된 sys_id이 없습니다. `"relatedSysIds": [ Number, Number ]`
result.items.sysId	식별을 통해 이 CI에 대한 Sys_id 찾았습니다. 주목할만한 가치: 알 수 없음: 이 CI를 식별하지 못했습니다. 자세한 내용은 errors 문서를 참조하십시오. 데이터 유형: 문자열
결과.항목.경고	이 CI를 처리하는 동안 발생한 경고 목록입니다. 데이터 유형: 객체 배열 `"warnings": [ { "error": "String", "message": "String" } ]`
결과.항목.경고.오류	이 CI를 처리하는 동안 발생한 경고의 유형입니다. 데이터 유형: 문자열
결과.항목.경고.메시지	이 CI를 처리하는 동안 발생한 경고 메시지. 데이터 유형: 문자열
result.logContextId	이 페이로드에 대해 보고된 컨텍스트 ID입니다. 데이터 유형: 문자열
결과.관계	요청 본문 relations 배열의 종속 관계 CI 목록입니다. 데이터 유형: 객체 배열 `"relations": [ { "className": "String", "errorCount": Number, "errors": [Array], "inputIndices": [Array], "markers": [Array], "mergedPayloadIds": [Array], "operation": "String", "warnings": [Array] } ]`
result.relations.className	이 종속 관계 CI의 sys_class_name입니다. 지원되는 값: cmdb_rel_ci: CI 관계 테이블입니다. 데이터 유형: 문자열
result.relations.errorCount	이 종속 관계 CI를 처리하는 동안 발생한 오류 수입니다. 데이터 유형: 숫자
결과.관계.오류	이 종속 관계 CI를 처리하는 동안 발생한 오류 목록입니다. 데이터 유형: 객체 배열 `"errors": [ { "error": "String", "message": "String" } ]`
결과.관계.오류.오류	이 종속 관계 CI를 처리하는 동안 발생한 오류 유형입니다. 데이터 유형: 문자열
result.relations.errors.message	이 종속 관계 CI를 처리하는 동안 오류 메시지가 발생했습니다. 데이터 유형: 문자열
result.relations.inputIndices	이 종속 관계 CI에 해당하는 요청 본문 relations 배열의 종속 관계 CI 객체에 대한 인덱스 값 목록입니다. 데이터 유형: 배열 `"inputIndices": [ Number ]`
결과.관계.마커	내부용 마커 값 목록입니다. 데이터 유형: 배열 `"markers": []`
result.relations.mergedPayloadIds	이 종속 관계 CI를 처리하는 동안 병합된 CMDB IRE 부분 페이로드 [cmdb_ire_partial_payloads] 테이블의 부분 페이로드에 대한 sys_id 값 목록입니다. 데이터 유형: 배열 `"mergedPayloadIds": [ "String" ]`
결과.관계.운영	이 종속 관계 CI에 대해 수행된 운영입니다. 가능한 값: 삽입: 종속 관계 CI가 대상 테이블에 새 기록으로 삽입되었습니다. INSERT_AS_INCOMPLETE: 종속 관계 CI에 오류가 있어 CMDB IRE 미완료 페이로드 [cmdb_ire_incomplete_payloads] 테이블에 삽입되었습니다. INSERT_AS_PARTIAL: 종속 관계 CI에 오류가 있어 CMDB IRE Partial Payloads [cmdb_ire_partial_payloads] 테이블에 삽입되었습니다. NO_CHANGE: 종속 관계 CI에 대해 수행된 운영이 없습니다. 업데이트: 대상 테이블의 기존 종속 관계 CI가 업데이트되었습니다. 데이터 유형: 문자열
결과.관계.경고	이 종속 관계 CI를 처리하는 동안 발생한 경고 목록입니다. 데이터 유형: 객체 배열 `"warnings": [ { "error": "String", "message": "String" } ]`
결과.관계.경고.오류	이 종속 관계 CI를 처리하는 동안 발생한 경고의 유형입니다. 데이터 유형: 문자열
결과.관계.경고.메시지	이 종속 관계 CI를 처리하는 동안 경고 메시지가 발생했습니다. 데이터 유형: 문자열

cURL 요청

컴퓨터 CI에 대한 부분 페이로드를 제출합니다.

curl "https://instance.servicenow.com/api/now/identifyreconcile/enhanced" \
--request POST \
--header "Accept: application/json" \
--header "Content-Type: application/json" \
--user "username":"password" \
--data '{ \
  "items" : [ \
    { \
      "className" : "cmdb_ci_computer", \
      "sys_object_source_info" : { \
        "source_name" : "ServiceNow", \
        "source_native_key" : "ncomputer3367" \
      }, \
      "values" : { \
        "cpu_core_count" : "6", \
        "ram" : "8192", \
        "manufacturer" : "DELL", \
        "company" : "My Company" \
      } \
    } \
  ] \
}'

응답은 페이로드가 CMDB IRE Partial Payloads [cmdb_ire_partial_payloads] 테이블에 삽입되었음을 보여줍니다.

{
  "result": {
    "items": [{
      "className": "cmdb_ci_computer",
      "operation": "INSERT_AS_PARTIAL",
      "sysId": "Unknown",
      "partialSysIds": ["1aec79151bb45010593876a61a4bcb28"],
      "identifierEntrySysId": "Unknown",
      "errors": [],
      "warnings": [{
        "error": "MISSING_MATCHING_ATTRIBUTES",
        "message": "In payload missing minimum set of input values for criterion (matching) attributes from identify rule for table [cmdb_ci_hardware]. Add these input values in payload item '{\"className\":\"cmdb_ci_computer\",\"values\":{\"discovery_source\":\"ServiceNow\",\"company\":\"My Company\",\"cpu_core_count\":\"6\",\"ram\":\"8192\",\"manufacturer\":\"DELL\"},\"sys_object_source_info\":{\"source_name\":\"ServiceNow\",\"source_native_key\":\"ncomputer3367\"},\"settings\":{},\"sys_ire_info\":{\"ire_received_time\":\"2020-05-14 20:14:51\"}}'"
      }],
      "identificationAttempts": [{
        "info": "sys_object_source NO_MATCH",
        "identifierName": "",
        "attemptResult": "NO_MATCH",
        "attributes": [],
        "hybridEntryCiAttributes": []
      }, {
        "identifierName": "Hardware Rule",
        "attemptResult": "SKIPPED",
        "attributes": ["serial_number", "serial_number_type"],
        "searchOnTable": "cmdb_serial_number",
        "hybridEntryCiAttributes": []
      }, {
        "identifierName": "Hardware Rule",
        "attemptResult": "SKIPPED",
        "attributes": ["serial_number"],
        "searchOnTable": "cmdb_ci_hardware",
        "hybridEntryCiAttributes": []
      }, {
        "identifierName": "Hardware Rule",
        "attemptResult": "SKIPPED",
        "attributes": ["name"],
        "searchOnTable": "cmdb_ci_hardware",
        "hybridEntryCiAttributes": []
      }, {
        "identifierName": "Hardware Rule",
        "attemptResult": "SKIPPED",
        "attributes": ["mac_address", "name"],
        "searchOnTable": "cmdb_ci_network_adapter",
        "hybridEntryCiAttributes": []
      }],
      "errorCount": 0,
      "markers": [],
      "warningCount": 1,
      "mergedPayloadIds": ["7ddcb9551bb45010593876a61a4bcb08"],
      "inputIndices": [0]
    }],
    "additionalCommittedItems": [],
    "relations": [],
    "additionalCommittedRelations": []
  }
}

요약 생성 향상된 IRE 옵션이 활성화된 상태에서 컴퓨터 CI에 대한 설명을 완료하는 두 번째 부분 페이로드를 제출합니다.

curl "https://instance.servicenow.com/api/now/identifyreconcile/enhanced?options=generate_summary:true" \
--request POST \
--header "Accept: application/json" \
--header "Content-Type: application/json" \
--user "username":"password" \
--data '{ \
}'

응답은 컴퓨터 CI가 삽입되었음을 보여주고 수행된 작업의 요약을 표시합니다.

{
  "result": {
    "relations": [],
    "hasError": false,
    "additionalCommittedItems": [],
    "hasWarning": false,
    "items": [
      {
        "relatedSysIds": [
          "735c79151bb45010593876a61a4bcb67"
        ],
        "identifierEntrySysId": "Unknown",
        "sysId": "ff5c79151bb45010593876a61a4bcb64",
        "errorCount": 0,
        "markers": [],
        "className": "cmdb_ci_computer",
        "inputIndices": [
          0
        ],
        "operation": "INSERT",
        "relatedItems": [
          {
            "operation": "INSERT",
            "warningCount": 0,
            "errors": [],
            "sysId": "735c79151bb45010593876a61a4bcb67",
            "className": "cmdb_ci_network_adapter",
            "errorCount": 0,
            "markers": [],
            "inputIndices": [
              {
                "subIndex": 0,
                "mainIndex": 0
              }
            ],
            "mergedPayloadIds": []
          }
        ],
        "mergedPayloadIds": [
          "fe4c39151bb45010593876a61a4bcbd3"
        ],
        "identificationAttempts": [
          {
            "info": "sys_object_source NO_MATCH",
            "attemptResult": "NO_MATCH",
            "identifierName": "",
            "attributes": [],
            "hybridEntryCiAttributes": []
          },
          {
            "attemptResult": "SKIPPED",
            "identifierName": "Hardware Rule",
            "attributes": [
              "serial_number",
              "serial_number_type"
            ],
            "hybridEntryCiAttributes": [],
            "searchOnTable": "cmdb_serial_number"
          },
          {
            "attemptResult": "SKIPPED",
            "identifierName": "Hardware Rule",
            "attributes": [
              "serial_number"
            ],
            "hybridEntryCiAttributes": [],
            "searchOnTable": "cmdb_ci_hardware"
          },
          {
            "attemptResult": "SKIPPED",
            "identifierName": "Hardware Rule",
            "attributes": [
              "name"
            ],
            "hybridEntryCiAttributes": [],
            "searchOnTable": "cmdb_ci_hardware"
          },
          {
            "attemptResult": "NO_MATCH",
            "identifierName": "Hardware Rule",
            "attributes": [
              "mac_address",
              "name"
            ],
            "hybridEntryCiAttributes": [],
            "searchOnTable": "cmdb_ci_network_adapter"
          }
        ],
        "warningCount": 0
      }
    ],
    "additionalCommittedRelations": [],
    "summary": {
      "cmdb_ci_network_adapter": {
        "mergedPartialPayloads": 0,
        "inserted": 1,
        "partial": 0,
        "warnings": 0,
        "incomplete": 0,
        "additionalInserted": 0,
        "unchanged": 0,
        "skipped": 0,
        "updated": 0,
        "errors": 0
      },
      "cmdb_ci_computer": {
        "mergedPartialPayloads": 1,
        "inserted": 1,
        "partial": 0,
        "warnings": 0,
        "incomplete": 0,
        "additionalInserted": 0,
        "unchanged": 0,
        "skipped": 0,
        "updated": 0,
        "errors": 0
      }
    }
  }
}

식별 및 조정 - POST /now/identifyreconcile/query

데이터베이스에서 CMDB 작업을 커밋하지 않고 지정된 페이로드(요청 본문)로 수행할 작업(삽입/업데이트)을 결정합니다.

이 엔드포인트를 사용하여 엔드포인트에 대한 페이로드(요청 본문) 제출을 시뮬레이션합니다.식별 및 조정 - POST /now/identifyreconcile

URL 형식

버전이 지정된 URL: /api/now/{api_version}/identifyreconcile/query

기본 URL: /api/now/identifyreconcile/query

주:

사용 가능한 버전은 REST API 탐색기에 지정됩니다. 스크립트 기반 REST API의 경우 스크립트 기반 REST 서비스 양식에 추가 버전 정보가 있습니다.

지원되는 요청 매개변수

표 13. 경로 매개변수
이름	설명
api_version	옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 `v1` 또는 `v2`입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오. 데이터 유형: 문자열

표 14. 쿼리 매개변수
이름	설명
sysparm_data_source	CI 정보의 소스입니다. 구성 항목 [cmdb_ci] 테이블의 discovery_source 필드에 대해 정의된 선택 값 중 하나여야 합니다. 데이터 유형: 문자열 기본값: 미완료 페이로드 테이블에 API 페이로드를 삽입합니다.

표 15. 요청 본문 매개변수(XML 또는 JSON)
이름	설명
항목	만들거나 업데이트할 CI 목록입니다. 데이터 유형: 객체 배열 `"items": [ { "className": "String", "internal_id": "String", "lookup": [Array], "related": [Array], "settings": {Object}, "sys_object_source_info": {Object}, "values": {Object} } ]`
items.className	필수 만들거나 업데이트할 CI의 sys_class_name(클래스/테이블 이름)입니다. 이 값은 cmdb_ci_linux_server 또는 cmdb_ci_win_server와 같은 모든 CMDB 테이블이 될 수 있습니다. 데이터 유형: 문자열
items.internal_id	이 페이로드에 있는 이 항목의 고유 식별자입니다. 모든 값이 될 수 있지만 페이로드 내에서 고유해야 합니다. 데이터 유형: 문자열
항목.조회	각 객체가 조회 기반 식별 기록을 설명하는 객체의 배열입니다. 이러한 기록은 구성 항목 [cmdb_ci] 테이블에 대한 참조가 있는 조회 테이블을 기반으로 최상위 구성 항목을 식별하는 데 사용됩니다. 데이터 유형: 객체 배열 `"lookup": [ { "className": "String", "internal_id": "String", "sys_object_source_info": {Object}, "values": {Object} } ]`
items.lookup.className	필수 만들거나 업데이트할 CI의 sys_class_name 또는 클래스/테이블 이름입니다. 이 값은 cmdb_serial_number이나 cmdb_ci_network_adapter 등의 클래스/테이블 또는 비CMDB계층 구조 클래스일 수 CMDB 있습니다. 데이터 유형: 문자열
items.lookup.internal_id	이 페이로드에 있는 이 조회 기록의 고유 식별자입니다. 모든 값이 될 수 있지만 페이로드 내에서 고유해야 합니다. 데이터 유형: 문자열
items.lookup.sys_object_source_info	지정된 데이터 소스에 대한 고유 CI 식별자를 설명하는 객체입니다. 소스마다 동일한 CI에 대해 서로 다른 이름-값 쌍이 있을 수 있습니다. 데이터 유형: 객체 `"sys_object_source_info": { "source_feed": "String", "source_name": "String", "source_native_key": "String", "source_recency_timestamp": "String" }`
items.lookup.sys_object_source_info.source_feed	이 CI를 보내는 피드를 고유하게 식별하는 이름입니다. 소스에 여러 피드가 있을 수 있는 경우 사용합니다. 데이터 유형: 문자열
items.lookup.sys_object_source_info.source_name	CI 정보의 데이터 소스입니다. 이 값은 구성 항목 [cmdb_ci] 테이블의 discovery_source 필드에 대해 정의된 선택 값 중 하나여야 합니다. 데이터 유형: 문자열
items.lookup.sys_object_source_info.source_native_key	CI 소스의 고유 키/ID입니다. 항목에 고유한 모든 문자열이 될 수 있습니다. 데이터 유형: 문자열
items.lookup.sys_object_source_info.source_recency_timestamp	CI를 스캔한 UTC 날짜 및 시간입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD hh:mm:ss
항목.조회.값	이 조회 항목의 필드를 이름/값 쌍으로 설명하는 객체입니다. 여기서 이름은 필드 이름입니다. 데이터 유형: 객체 필드 이름과 유형은 사용자가 선택한 필드에 따라 달라집니다(예: `"values": { "ip_address": "String", "mac_address": "String", "serial_number": "String", "serial_number_type": "String", "valid": "String" }`
항목.관련	식별되는 최상위 CI에 대한 참조가 있는 관련 테이블을 기반으로 각 객체가 만들거나 업데이트할 항목 기록을 설명하는 객체의 배열입니다. 관련 항목 [cmdb_related_entry] 테이블의 규칙은 이 배열에 포함될 수 있는 기록 유형을 정의합니다. 관련 테이블은 구성 항목 [cmdb_ci] 테이블을 확장하거나 확장하지 않을 수 있습니다. 이러한 기록은 구성 항목을 식별하는 데 사용되지 않습니다. 데이터 유형: 객체 배열 `"related": [ { "className": "String", "internal_id": "String", "sys_object_source_info": {Object}, "values": {Object} } ]`
items.related.className	필수 만들거나 업데이트할 관련 항목의 sys_class_name 또는 클래스/테이블 이름입니다. 데이터 유형: 문자열
items.related.internal_id	이 페이로드에 있는 이 관련 항목에 대한 고유 식별자입니다. 모든 값이 될 수 있지만 페이로드 내에서 고유해야 합니다. 데이터 유형: 문자열
items.related.sys_object_source_info	지정된 데이터 소스에 대한 고유 CI 식별자를 설명하는 객체입니다. 소스마다 동일한 CI에 대해 서로 다른 이름-값 쌍이 있을 수 있습니다. 데이터 유형: 객체 `"sys_object_source_info": { "source_feed": "String", "source_name": "String", "source_native_key": "String", "source_recency_timestamp": "String" }`
items.related.sys_object_source_info.source_feed	이 관련 항목을 보내는 피드를 고유하게 식별하는 이름입니다. 소스에 여러 피드가 있을 수 있는 경우 사용합니다. 데이터 유형: 문자열
items.related.sys_object_source_info.source_name	관련 항목 정보의 데이터 소스입니다. 이 값은 구성 항목 [cmdb_ci] 테이블의 discovery_source 필드에 대해 정의된 선택 값 중 하나여야 합니다. 데이터 유형: 문자열
items.related.sys_object_source_info.source_native_key	관련 항목에 대한 소스의 고유 키/ID입니다. 항목에 고유한 모든 문자열이 될 수 있습니다. 데이터 유형: 문자열
items.related.sys_object_source_info.source_recency_timestamp	관련 항목을 스캔한 UTC 날짜 및 시간입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD hh:mm:ss
항목.관련.값	이 관련 항목에 대해 작성하거나 업데이트할 필드를 이름/값 쌍으로 설명하는 객체입니다. 여기서 이름은 필드 이름입니다. 참조 필드의 경우 값은 참조된 sys_id여야 합니다. 데이터 유형: 객체 필드 이름과 유형은 사용자가 선택한 필드에 따라 달라집니다(예: `"values": { "host_name": "String", "ip_address": "String", "name": "String", "os_name": "String", "sys_class_name": "String" }`
항목.설정	허용되는 업데이트 유형을 정의하는 매개변수를 포함하는 객체입니다. 데이터 유형: 객체 `"settings": { "skipReclassificationRestrictionRules": Boolean, "updateWithoutDowngrade": Boolean, "updateWithoutSwitch": Boolean, "updateWithoutUpgrade": Boolean }`
items.settings.skipReclassificationRestrictionRules	IRE가 페이로드 항목의 클래스와 일치하는 재분류 제한 규칙 실행을 건너뛰어야 하는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. true: 규칙 실행을 건너뜁니다. false: 규칙을 실행합니다. 기본값: false
items.settings.updateWithoutDowngrade	이 CI에 대해 업데이트와 다운그레이드가 모두 허용되는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. 예: 항목을 업데이트하지만 다운그레이드는 허용되지 않습니다. 아니오: 항목 업데이트와 다운그레이드가 모두 허용됩니다. 데이터 유형: 부울 기본값: false
items.settings.updateWithoutSwitch	이 CI를 업데이트할 수 있고 클래스를 전환할 수 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. 예: 항목을 업데이트하지만 클래스 전환은 허용되지 않습니다. 아니오: 항목 업데이트와 클래스 전환이 모두 허용됩니다. 데이터 유형: 부울 기본값: false
items.settings.updateWithoutUpgrade	이 CI에 대해 업데이트와 업그레이드가 모두 허용되는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. 예: 항목을 업데이트하지만 업그레이드는 허용되지 않습니다. 아니오: 항목 업데이트와 업그레이드가 모두 허용됩니다. 데이터 유형: 부울 기본값: false
items.sys_object_source_info	고유 CI 식별자를 설명하는 객체입니다. 데이터 유형: 객체 `"sys_object_source_info": { "source_feed": "String", "source_name": "String", "source_native_key": "String", "source_recency_timestamp": "String" }`
items.sys_object_source_info.source_feed	이 CI를 보내는 피드를 고유하게 식별하는 이름입니다. 소스에 여러 피드가 있을 수 있는 경우 사용합니다. 데이터 유형: 문자열
items.sys_object_source_info.source_name	CI 정보의 데이터 소스입니다. 이 값은 구성 항목 [cmdb_ci] 테이블의 discovery_source 필드에 대해 정의된 선택 값 중 하나여야 합니다. 데이터 유형: 문자열
items.sys_object_source_info.source_native_key	CI 소스의 고유 키/ID입니다. 항목에 고유한 모든 문자열이 될 수 있습니다. 데이터 유형: 문자열
items.sys_object_source_info.source_recency_timestamp	CI를 스캔한 UTC 날짜 및 시간입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD hh:mm:ss
항목.값	이 CI에 대해 작성하거나 업데이트할 필드를 이름/값 쌍으로 설명하는 객체입니다(여기서 이름은 필드 이름). 참조 필드의 경우 값은 참조된 sys_id여야 합니다. 데이터 유형: 객체 필드 이름과 유형은 사용자가 선택한 필드에 따라 달라집니다(예: `"values": { "host_name": "String", "ip_address": "String", "name": "String", "os_name": "String", "sys_class_name": "String" }`
참조 항목	페이로드의 두 항목 간 참조 목록입니다. 각 참조 항목의 값은 클래스에 정의된 IRE 규칙을 사용하여 CI를 식별하기 전에 채워집니다. 데이터 유형: 객체 배열 `"referenceItems": [ { "referenced": "String", "referencedBy": "String", "referenceField": "String" } ]`
referenceItems.referenced	internal_id 다른 항목에서 참조하는 항목에 대해 정의되어 있습니다. 데이터 유형: 문자열
referenceItems.referencedBy	internal_id 다른 항목을 참조하는 항목에 대해 정의되어 있습니다. 데이터 유형: 문자열
referenceItems.referenceField	항목의 클래스/테이블에 있는 참조 필드의 이름입니다 referencedBy . 데이터 유형: 문자열
관계	페이로드에 정의된 두 항목 간의 관계 목록입니다. 이 배열의 객체는 다음 두 가지 형식 중 하나를 사용할 수 있습니다. 이 객체는 페이로드 items 배열의 항목 인덱스를 나타내는 값과 함께 이름-값 쌍을 사용하여 parentchild 두 최상위 항목 간의 관계를 정의할 수 있습니다. 이 객체는 키/값 쌍을 child_id 사용하여 parent_id 최상위 항목, 관련 항목 또는 조회 항목을 포함하여 두 항목 간의 관계를 정의할 수 있으며, 값은 해당 항목에 대해 정의된 값을 나타낼 internal_id 수 있습니다. 데이터 유형: 객체 배열 `"relations": [ { "child": Number, "parent": Number, "sys_rel_source_info": {Object}, "type": "String" } ]` `"relations": [ { "child_id": "String", "parent_id": "String", "sys_rel_source_info": {Object}, "type": "String" } ]`
관계.하위	관계의 하위 항목을 나타내는 배열에 있는 items CI 객체의 정수 인덱스입니다. 데이터 유형: 숫자
relations.child_id	internal_id 관계에 있는 하위 항목의 객체입니다. 데이터 유형: 문자열
relations.parent	관계의 상위를 나타내는 배열에 있는 items CI 객체의 정수 인덱스입니다. 데이터 유형: 숫자
relations.parent_id	internal_id 관계의 상위 항목입니다. 데이터 유형: 문자열
relations.sys_rel_source_info	관계에 대한 검색 소스 정보입니다. 비의존성 관계의 경우 이 정보는 관계 소스 [sys_rel_source] 테이블에 있습니다. 데이터 유형: 객체 `"sys_rel_source_info": { "source_name": "String", "source_feed": "String" }`
relations.sys_rel_source_info.source_name	검색 소스 이름입니다. 기본값: API 메서드 매개변수에 전달된 디스커버리 소스입니다.
relations.sys_rel_source_info.source_feed	검색 소스 내의 하위 검색/검사에 해당하는 모든 문자열입니다. 기본값: 테이블에서 기록을 생성할 때 source_feed 열에 "알 수 없음"sys_rel_source 저장됩니다.
관계.유형	상위 항목과 하위 항목 간에 존재하는 관계의 유형입니다. CI 관계 유형 [cmdb_rel_type] 테이블의 이름 필드 값이어야 합니다. 데이터 유형: 문자열

헤더

표 16. 요청 헤더
머리글	설명
수용	응답 본문의 데이터 형식입니다. application/json만 지원합니다.
콘텐츠-형식	요청 본문의 데이터 형식입니다. application/json만 지원합니다.

표 17. 응답 헤더
머리글	설명
안 함

상태 코드

이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하십시오.

표 18. 상태 코드
상태 코드	설명
200	성공입니다. 요청이 성공적으로 처리되었습니다.
401	권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다.
500	내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다.

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


이름	설명
결과	쿼리에 의해 생성된 결과 목록입니다. 데이터 유형: 배열 `"result": [ "additionalCommittedItems": [Array], "additionalCommittedRelations": [Array], "items": [Array], "relations": [Array] ]`
result.additionalCommittedItems	삽입하거나 업데이트할 요청 본문 items 배열에 포함되지 않은 CI 목록입니다. 데이터 유형: 객체 배열 `"additionalCommittedItems": [ { "className": "String", "errorCount": Number, "identificationAttempts": [Array], "inputIndices": [Array], "markers": [Array], "mergedPayloads": [Array], "operation": "String", "sysId": "String" } ]`
result.additionalCommittedItems.className	이 추가 CI의 sys_class_name입니다. 데이터 유형: 문자열
result.additionalCommittedItems.errorCount	이 추가 CI를 처리하는 동안 발생한 오류 수입니다. 데이터 유형: 숫자
result.additionalCommittedItems.errors	이 추가 CI를 처리하는 동안 발생한 오류 목록입니다. 데이터 유형: 객체 배열 `"errors": [ { "error": "String", "message": "String" } ]`
result.additionalCommittedItems.errors.error	이 추가 CI를 처리하는 동안 발생한 오류 유형입니다. 데이터 유형: 문자열
result.additionalCommittedItems.errors.message	이 추가 CI를 처리하는 동안 오류 메시지가 발생했습니다. 데이터 유형: 문자열
result.additionalCommittedItems.identificationAttempts	이 추가 CI를 식별하기 위해 수행한 시도 목록입니다. 데이터 유형: 객체 배열 `"identificationAttempts": [ { "attemptResult": "String", "attributes": [Array], "hybridEntryCiAttributes": [Array], "identiferName": "String", "searchOnTable": [Array] } ]`
result.additionalCommittedItems.identificationAttempts.attemptResult	이 추가 CI 식별 시도의 결과입니다. 가능한 값: 일치: 식별에 성공했습니다. 식별자 규칙 테이블에서 지정된 속성과 정확히 일치하는 고유한 CI를 찾았습니다. MULTI_MATCH: 오류로 인해 식별에 실패했습니다. 지정된 속성과 일치할 때 식별자 규칙 테이블에서 중복 CI가 발견되었습니다. NO_MATCH: 식별에 실패했습니다. 식별자 규칙 테이블에서 지정된 속성과 일치하는 CI를 찾을 수 없습니다. 건너뜀: 식별을 시도하지 않았습니다. 이 식별자 규칙 테이블 검색에 필요한 속성이 제공되지 않아 규칙이 적용되지 않았습니다. 데이터 유형: 문자열
result.additionalCommittedItems.identificationAttempts.attributes	이 추가 CI 식별 시도 중에 사용되는 CI 식별자 항목 속성의 배열입니다. 데이터 유형: 배열 속성 이름과 유형은 다음과 같이 요청 본문 데이터와 사용 중인 식별자에 따라 다릅니다. `"attributes": [ "serial_number": "String", "serial_number_type": "String" ]`
result.additionalCommittedItems.identificationAttempts.hybridEntryCiAttributes	이 추가 CI 식별 시도 중에 사용된 CI 식별자 항목 속성의 목록입니다. 데이터 유형: 배열 속성 이름과 유형은 다음과 같이 요청 본문 데이터와 사용 중인 식별자에 따라 다릅니다. `"hybridEntryCiAttributes": [ "name": "String", "serial_number": "String" ]`
result.additionalCommittedItems.identificationAttempts.identifierName	이 추가 CI 식별 시도에 사용되는 식별자 규칙입니다. 데이터 유형: 문자열
result.additionalCommittedItems.identificationAttempts.searchOnTable	이 추가 CI 식별 시도를 위해 검색된 테이블의 이름입니다. 데이터 유형: 문자열
result.additionalCommittedItems.identifierEntrySysId	이 추가 CI를 식별하는 데 사용되는 식별자 규칙의 Sys_id입니다. 주목할만한 가치: 알 수 없음: 이 추가 CI를 식별하지 못했습니다. 자세한 내용은 errors 문서를 참조하십시오. 데이터 유형: 문자열
result.additionalCommittedItems.inputIndices	이 추가 CI에 해당하는 요청 본문 items 배열의 CI 인덱스 값 목록입니다. 데이터 유형: 객체 배열 `"inputIndices": [ { Number } ]`
result.additionalCommittedItems.markers	내부용 마커 값 목록입니다. 데이터 유형: 배열 `"markers": []`
result.additionalCommittedItems.mergedPayloads	이 추가 CI를 처리하는 동안 병합된 CMDB IRE 부분 페이로드[cmdb_ire_partial_payloads] 테이블의 부분 페이로드에 대한 sys_id 값 목록입니다. 데이터 유형: 배열 `"mergedPayloadIds": [ "String" ]`
result.additionalCommittedItems.operation	이 추가 CI에 대해 수행된 작업입니다. 가능한 값: 삭제: 기존 CI가 대상 테이블에서 제거됩니다. 삽입: 추가적인 CI가 대상 테이블에 새 기록으로 삽입됩니다. NO_CHANGE: 추가 CI에 대해서는 작업이 수행되지 않습니다. 업데이트: 대상 테이블의 기존 CI가 업데이트됩니다. UPDATE_WITH_DOWNGRADE: 대상 테이블의 기존 CI가 업데이트되고 해당 클래스가 보다 일반적인 클래스(상위 클래스)로 변경됩니다. UPDATE_WITH_SWITCH: 대상 테이블의 기존 CI가 업데이트되고 해당 클래스가 상위 또는 하위 클래스가 아닌 다른 클래스로 변경됩니다. UPDATE_WITH_UPGRADE: 대상 테이블의 기존 CI가 업데이트되고 해당 클래스가 보다 전문화된 클래스(하위 클래스)로 변경됩니다. 데이터 유형: 문자열
result.additionalCommittedItems.sysId	식별을 통해 이 추가 CI에 대한 Sys_id 찾았습니다. 주목할 만한 값: 알 수 없음 - 이 추가 CI를 식별하지 못했습니다. 자세한 내용은 errors 문서를 참조하십시오. 데이터 유형: 문자열
result.additionalCommittedItems.warnings	이 추가 CI를 처리하는 동안 발생한 경고 목록입니다. 데이터 유형: 객체 배열 `"warnings": [ { "error": "String", "message": "String" } ]`
result.additionalCommittedItems.warnings.error	이 추가 CI를 처리하는 동안 발생한 경고의 유형입니다. 데이터 유형: 문자열
result.additionalCommittedItems.warnings.message	이 추가 CI를 처리하는 동안 경고 메시지가 발생했습니다. 데이터 유형: 문자열
result.additionalCommittedRelations	삽입하거나 업데이트할 요청 본문 relations 목록에 포함되지 않은 종속 관계 CI 목록입니다. 데이터 유형: 객체 배열 `"additionalCommittedRelations": [ { "className": "String", "operation": "String", "markers": [Array], "inputIndices": [Array], "mergedPayloadIds": [Array] } ]`
result.additionalCommittedRelations.className	이 추가 종속 관계 CI의 sys_class_name입니다. 지원되는 값: cmdb_rel_ci: CI 관계 테이블입니다. 데이터 유형: 문자열
result.additionalCommittedRelations.errorCount	이 추가 종속 관계 CI를 처리하는 동안 발생한 오류 수입니다. 데이터 유형: 숫자
result.additionalCommittedRelations.errors	이 추가 종속 관계 CI를 처리하는 동안 발생한 오류 목록입니다. 데이터 유형: 객체 배열 `"errors": [ { "error": "String", "message": "String" } ]`
result.additionalCommittedRelations.errors.error	이 추가 종속 관계 CI를 처리하는 동안 발생한 오류 유형입니다. 데이터 유형: 문자열
result.additionalCommittedRelations.errors.message	이 추가 종속 관계 CI를 처리하는 동안 오류 메시지가 발생했습니다. 데이터 유형: 문자열
result.additionalCommittedRelations.inputIndices	이 추가 종속 관계 CI에 해당하는 요청 본문 relations 배열의 종속 관계 CI 객체에 대한 인덱스 값 목록입니다. 데이터 유형: 배열 `"inputIndices": [ Number ]`
result.additionalCommittedRelations.markers	내부용 마커 값 목록입니다. 데이터 유형: 배열 `"markers": []`
result.additionalCommittedRelations.mergedPayloadIds	이 추가 종속 관계 CI를 처리하는 동안 병합된 CMDB IRE 부분 페이로드 [cmdb_ire_partial_payloads] 테이블의 부분 페이로드에 대한 sys_id 값 목록입니다. 데이터 유형: 배열 `"mergedPayloadIds": [ "String" ]`
result.additionalCommittedRelations.operation	이 추가 종속 관계 CI에 대해 수행된 작업입니다. 가능한 값: 삽입: 종속 관계 CI가 대상 테이블에 새 기록으로 삽입됩니다. INSERT_AS_INCOMPLETE: 종속 관계 CI에 오류가 있었고 CMDB IRE 미완료 페이로드 [cmdb_ire_incomplete_payloads] 테이블에 삽입되었습니다. INSERT_AS_PARTIAL: 종속 관계 CI에 오류가 있었고 CMDB IRE cmdb_ire_partial_payloads 페이로드 테이블에 삽입됩니다. NO_CHANGE: 종속 관계 CI에 대해 수행된 작업이 없습니다. 업데이트: 대상 테이블의 기존 종속 관계 CI가 업데이트됩니다. 데이터 유형: 문자열
결과.항목	요청 본문 items 배열에 포함된 CI 목록입니다. 데이터 유형: 객체 배열 `"items": [ { "additionalRelatedItems": [Array], "className": "String", "duplicateLookupIndices": {Object}, "errorCount": Number, "errors": [Array], "identificationAttempts": [Array], "identifierEntrySysId": "String", "info": [Array], "inputIndices": [Array], "markers": [Array], "mergedPayloadIds": [Array], "operation": "String", "relatedItems": [Array], "relatedSysIds": [Array], "sysId": "String", "warnings": [Array] } ]`
result.items.additionalRelatedItems	CMDB IRE 부분 페이로드 [cmdb_ire_partial_payloads] 테이블의 관련 CI(테이블 조회 CI) 목록입니다. 데이터 유형: 객체 배열 `"additionalRelatedItems": [ { "className": "String", "inputIndices": [Array], "markers": [Array], "mergedPayloadIds": [Array], "sysId": "String" } ]`
result.items.additionalRelatedItems.className	관련 항목의 sys_class_name입니다. 데이터 유형: 문자열
result.items.additionalRelatedItems.inputIndices	이 관련 항목에 해당하는 요청 본문 items 배열의 CI 인덱스 값 목록입니다. 데이터 유형: 배열 `"inputIndices": [ Number ]`
result.items.additionalRelatedItems.markers	내부용 마커 값 목록입니다. 데이터 유형: 배열 `"markers": []`
result.items.additionalRelatedItems.mergedPayloadIds	이 관련 항목을 처리하는 동안 병합된 CMDB IRE 부분 페이로드[cmdb_ire_partial_payloads] 테이블의 부분 페이로드에 대한 sys_id 값 목록입니다. 데이터 유형: 배열 `"mergedPayloadIds": [ "String" ]`
result.items.additionalRelatedItems.sysId	이 관련 CI의 Sys_id입니다. 데이터 유형: 문자열
result.items.className	이 CI의 Sys_class_name입니다. 데이터 유형: 문자열
result.items.duplicateLookupIndices	동일한 관련 CI를 참조하는 배열 요소에 대한 items.lookup 인덱스 값 배열을 포함하는 객체입니다. 배열 이름은 지정된 관련 CI를 참조하는 요청 본문 items.lookup 배열의 첫 번째 요소를 나타냅니다. 해당 값은 동일한 관련 CI를 참조하는 동일한 배열의 추가 요소 집합입니다. 데이터 유형: 객체 다음 예는 배열의 두 번째 요소가 items.lookup 해당 배열의 이후 요소와 동일한 관련 CI를 참조하는 경우를 보여줍니다. `"duplicateLookupIndices": [ "2": [Array] ]`
result.items.errorCount	이 CI를 처리하는 동안 발생한 오류 수입니다. 데이터 유형: 숫자
결과.항목.오류	이 CI를 처리하는 동안 발생한 오류 목록입니다. 데이터 유형: 객체 배열 `"errors": [ { "error": "String", "message": "String" } ]`
결과.항목.오류.오류	이 CI를 처리하는 동안 발생한 오류의 유형입니다. 데이터 유형: 문자열
결과.항목.오류.메시지	이 CI를 처리하는 동안 오류 메시지가 발생했습니다. 데이터 유형: 문자열
결과.항목.식별시도	이 CI를 식별하려고 시도한 목록입니다. 데이터 유형: 객체 배열 `"identificationAttempts": [ { "attemptResult": "String", "attributes": [Array], "hybridEntryCiAttributes": [Array], "identiferName": "String", "searchOnTable": [Array] } ]`
결과.항목.식별시도.시도결과	이 CI 식별 시도의 결과입니다. 가능한 값: 일치: 식별에 성공했습니다. 식별자 규칙 테이블에서 지정된 속성과 정확히 일치하는 고유한 CI를 찾았습니다. MULTI_MATCH: 오류로 인해 식별에 실패했습니다. 지정된 속성과 일치할 때 식별자 규칙 테이블에서 중복 CI가 발견되었습니다. NO_MATCH: 식별에 실패했습니다. 식별자 규칙 테이블에서 지정된 속성과 일치하는 CI를 찾을 수 없습니다. 건너뜀: 식별을 시도하지 않았습니다. 이 식별자 규칙 테이블 검색에 필요한 속성이 제공되지 않아 규칙이 적용되지 않았습니다. 데이터 유형: 문자열
result.items.identificationAttempts.attributes	이 CI 식별 시도 중에 사용된 CI 식별자 항목 속성의 목록입니다. 데이터 유형: 배열 속성 이름과 유형은 다음과 같이 요청 본문 데이터와 사용 중인 식별자에 따라 다릅니다. `"attributes": [ "serial_number": "String", "serial_number_type": "String", ]`
result.items.identificationAttempts.hybridEntryCiAttributes	이 CI 식별 시도 중에 사용된 CI 식별자 항목 속성의 목록입니다. 데이터 유형: 배열 속성 이름과 유형은 다음과 같이 요청 본문 데이터와 사용 중인 식별자에 따라 다릅니다. `"hybridEntryCiAttributes": [ "name": "String", "serial_number": "String" ]`
result.items.identificationAttempts.identifierName	이 CI 식별 시도에 사용되는 식별자 규칙입니다. 데이터 유형: 문자열
result.items.identificationAttempts.searchOnTable	이 CI 식별 시도를 위해 검색된 테이블의 이름입니다. 데이터 유형: 문자열
result.items.identifierEntrySysId	이 CI를 식별하는 데 사용되는 식별자 규칙의 Sys_id입니다. 주목할만한 가치: 알 수 없음: 이 CI를 식별하지 못했습니다. 자세한 내용은 errors 문서를 참조하십시오. 데이터 유형: 문자열
result.items.info	항목 처리에 대한 추가 정보 목록입니다. 데이터 유형: 객체 배열 `"info": [ { "code": "String", "message": "String", "ruleSysId": "String" } ]`
result.items.info.code	건너뛴 재분류 유형입니다. 가능한 값: SKIPPED_CLASS_SWITCH SKIPPED_CLASS_DOWNGRADE SKIPPED_CLASS_UPGRADE
result.items.info.message	재분류를 건너뛰는 이유에 대한 추가 인사이트를 제공하는 메시지입니다. 데이터 유형: 문자열
result.items.info.ruleSysId	일치하는 재분류 제한 규칙의 Sys_id입니다. IRE가 재분류 제한 규칙으로 인해 재분류를 건너뛰는 경우에만 적용할 수 있습니다. 페이로드 또는 전역 플래그로 인해 재분류를 건너뛰면 이 값은 비어 있습니다. 데이터 유형: 문자열
result.items.inputIndices	이 CI에 해당하는 요청 본문 items 배열의 CI 인덱스 값 목록입니다. 데이터 유형: 객체 배열 `"inputIndices": [ { Number } ]`
결과.항목.마커	내부용 마커 값 목록입니다. 데이터 유형: 배열 `"markers": []`
result.items.mergedPayloadIds	이 CI를 처리하는 동안 병합된 CMDB IRE Partial Payloads [cmdb_ire_partial_payloads] 테이블의 부분 페이로드에 대한 sys_id 값 목록입니다. 데이터 유형: 배열 `"mergedPayloadIds": [ "String" ]`
결과.항목.운영	이 CI에 대해 수행된 작업입니다. 가능한 값: 삭제: 기존 CI가 대상 테이블에서 제거됩니다. 삽입: CI가 대상 테이블에 새 기록으로 삽입됩니다. NO_CHANGE: CI에 대해 수행되는 작업이 없습니다. 업데이트: 대상 테이블의 기존 CI가 업데이트됩니다. UPDATE_WITH_DOWNGRADE: 대상 테이블의 기존 CI가 업데이트되고 해당 클래스가 보다 일반적인 클래스(상위 클래스)로 변경됩니다. UPDATE_WITH_SWITCH: 대상 테이블의 기존 CI가 업데이트되고 해당 클래스가 상위 또는 하위 클래스가 아닌 다른 클래스로 변경됩니다. UPDATE_WITH_UPGRADE: 대상 테이블의 기존 CI가 업데이트되고 해당 클래스가 보다 전문화된 클래스(하위 클래스)로 변경됩니다. 데이터 유형: 문자열
result.items.relatedItems	요청 본문 items.lookup 배열의 관련 CI(테이블 조회 CI) 목록입니다. 데이터 유형: 객체 배열 `"relatedItems": [ { "className": "String", "inputIndices": [Array], "markers": [Array], "mergedPayloadIds": [Array], "sysId": "String" } ]`
result.items.relatedItems.className	관련 항목의 sys_class_name입니다. 데이터 유형: 문자열
result.items.relatedItems.inputIndices	요청 본문 items 과 items.lookup 이 관련 항목에 해당하는 배열의 CI 및 조회 항목에 대한 인덱스 값 목록입니다. 데이터 유형: 객체 배열 `"inputIndices": [ { "mainIndex": Number, "subIndex": Number } ]`
result.items.relatedItems.inputIndices.mainIndex	관련 항목의 CI 상위에 해당하는 요청 본문 items 배열의 인덱스 값입니다. 데이터 유형: 숫자
result.items.relatedItems.inputIndices.subIndex	관련 항목에 해당하는 요청 본문 items.lookup 배열의 인덱스 값입니다. 데이터 유형: 숫자
result.items.relatedItems.markers	내부용 마커 값 목록입니다. 데이터 유형: 배열 `"markers": []`
result.items.relatedItems.mergedPayloadIds	처리 중에 이 CI에 병합된 CMDB IRE 부분 페이로드[cmdb_ire_partial_payloads] 테이블의 항목에 대한 sys_id 값 목록입니다. 데이터 유형: 배열 `"mergedPayloadIds": [ "String" ]`
result.items.relatedSysIds	요청 본문 items.lookup 배열의 관련 항목(테이블 조회 항목)에 대한 sys_id 값 목록입니다. 데이터 유형: 배열 주목할만한 가치: null: 이 관련 항목에 대해 식별된 sys_id이 없습니다. `"relatedSysIds": [ Number, Number ]`
result.items.sysId	식별을 통해 이 CI에 대한 Sys_id 찾았습니다. 주목할만한 가치: 알 수 없음: 이 CI를 식별하지 못했습니다. 자세한 내용은 errors 문서를 참조하십시오. 데이터 유형: 문자열
결과.항목.경고	이 CI를 처리하는 동안 발생한 경고 목록입니다. 데이터 유형: 객체 배열 `"warnings": [ { "error": "String", "message": "String" } ]`
결과.항목.경고.오류	이 CI를 처리하는 동안 발생한 경고의 유형입니다. 데이터 유형: 문자열
결과.항목.경고.메시지	이 CI를 처리하는 동안 발생한 경고 메시지. 데이터 유형: 문자열
result.logContextId	이 페이로드에 대해 보고된 컨텍스트 ID입니다. 데이터 유형: 문자열
결과.관계	요청 본문 relations 배열의 종속 관계 CI 목록입니다. 데이터 유형: 객체 배열 `"relations": [ { "className": "String", "errorCount": Number, "errors": [Array], "inputIndices": [Array], "markers": [Array], "mergedPayloadIds": [Array], "operation": "String", "warnings": [Array] } ]`
result.relations.className	이 종속 관계 CI의 sys_class_name입니다. 지원되는 값: cmdb_rel_ci: CI 관계 테이블입니다. 데이터 유형: 문자열
result.relations.errorCount	이 종속 관계 CI를 처리하는 동안 발생한 오류 수입니다. 데이터 유형: 숫자
결과.관계.오류	이 종속 관계 CI를 처리하는 동안 발생한 오류 목록입니다. 데이터 유형: 객체 배열 `"errors": [ { "error": "String", "message": "String" } ]`
결과.관계.오류.오류	이 종속 관계 CI를 처리하는 동안 발생한 오류 유형입니다. 데이터 유형: 문자열
result.relations.errors.message	이 종속 관계 CI를 처리하는 동안 오류 메시지가 발생했습니다. 데이터 유형: 문자열
result.relations.inputIndices	이 종속 관계 CI에 해당하는 요청 본문 relations 배열의 종속 관계 CI 객체에 대한 인덱스 값 목록입니다. 데이터 유형: 배열 `"inputIndices": [ Number ]`
결과.관계.마커	내부용 마커 값 목록입니다. 데이터 유형: 배열 `"markers": []`
result.relations.mergedPayloadIds	이 종속 관계 CI를 처리하는 동안 병합된 CMDB IRE 부분 페이로드 [cmdb_ire_partial_payloads] 테이블의 부분 페이로드에 대한 sys_id 값 목록입니다. 데이터 유형: 배열 `"mergedPayloadIds": [ "String" ]`
결과.관계.운영	이 종속 관계 CI에 대해 수행된 운영입니다. 가능한 값: 삽입: 종속 관계 CI가 대상 테이블에 새 기록으로 삽입되었습니다. INSERT_AS_INCOMPLETE: 종속 관계 CI에 오류가 있어 CMDB IRE 미완료 페이로드 [cmdb_ire_incomplete_payloads] 테이블에 삽입되었습니다. INSERT_AS_PARTIAL: 종속 관계 CI에 오류가 있어 CMDB IRE Partial Payloads [cmdb_ire_partial_payloads] 테이블에 삽입되었습니다. NO_CHANGE: 종속 관계 CI에 대해 수행된 운영이 없습니다. 업데이트: 대상 테이블의 기존 종속 관계 CI가 업데이트되었습니다. 데이터 유형: 문자열
결과.관계.경고	이 종속 관계 CI를 처리하는 동안 발생한 경고 목록입니다. 데이터 유형: 객체 배열 `"warnings": [ { "error": "String", "message": "String" } ]`
결과.관계.경고.오류	이 종속 관계 CI를 처리하는 동안 발생한 경고의 유형입니다. 데이터 유형: 문자열
결과.관계.경고.메시지	이 종속 관계 CI를 처리하는 동안 경고 메시지가 발생했습니다. 데이터 유형: 문자열

cURL 요청

Linux 서버(일련 번호 및 네트워크 어댑터 관련 항목 조회 포함)와 IP 스위치가 포함된 페이로드의 제출을 시뮬레이션합니다(이들 사이의 IP 연결 관계).

curl "https://instance.servicenow.com/api/now/identifyreconcile/query" \
--request POST \
--header "Accept: application/json" \
--header "Content-Type: application/json" \
--user "username":"password" \
--data '{ \
  "items": [{ \
    "className": "cmdb_ci_linux_server", \
    "values": { \
      "sys_class_name": "cmdb_ci_linux_server", \
      "name": "lnux101", \
      "host_name": "lnux101.servicenow.com", \
      "ip_address": "10.11.12.173", \
      "os_name": "Linux Red Hat" \
    }, \
    "lookup": [{ \
      "className": "cmdb_serial_number", \
      "values": { \
        "serial_number": "lnux101", \
        "serial_number_type": "uuid", \
        "valid": "true" \
      } \
    }, { \
      "className": "cmdb_ci_network_adapter", \
      "values": { \
        "name": "eth0", \
        "ip_address": "10.11.12.173", \
        "mac_address": "00:55:51:21:26:2f" \
      } \
    }] \
  }, { \
    "className": "cmdb_ci_ip_switch", \
    "values": { \
      "name": "IP-Switch-1", \
      "serial_number": "Switch23587", \
      "serial_number_type": "uuid" \
    } \
  }], \
  "relations": [{ \
    "parent": 0, \
    "child": 1, \
    "type": "IP Connection::IP Connection" \
  }] \
}'

Linux 서버 CI는 하드웨어 규칙을 통해 식별되고 하드웨어 [cmdb_ci_hardware] 테이블에서 해당 이름을 검색하며 Linux 서버 [cmdb_ci_linux_server] 테이블에서 기존 CI에 대한 업데이트로 처리됩니다. IP 스위치는 하드웨어 규칙을 통해 유사하게 식별되고 하드웨어 테이블에서 해당 이름을 검색하고 IP 스위치 [cmdb_ci_ip_switch] 테이블에서 기존 CI를 업데이트합니다. 마지막으로 서버와 스위치 간의 IP 연결 관계가 CI 관계 [cmdb_rel_ci] 테이블에 새 기록으로 삽입됩니다.

{
  "result": {
    "relations": [
      {
        "operation": "INSERT",
        "mergedPayloadIds": [],
        "className": "cmdb_rel_ci",
        "errorCount": 0,
        "markers": [],
        "inputIndices": [
          0
        ]
      }
    ],
    "items": [
      {
        "relatedSysIds": [
          null,
          null
        ],
        "identifierEntrySysId": "556eb250c3400200d8d4bea192d3ae92",
        "sysId": "539747cac0a801640163e60735fbbf6e",
        "errorCount": 0,
        "markers": [],
        "identificationAttempts": [
          {
            "attemptResult": "NO_MATCH",
            "identifierName": "Hardware Rule",
            "attributes": [
              "serial_number",
              "serial_number_type"
            ],
            "hybridEntryCiAttributes": [],
            "searchOnTable": "cmdb_serial_number"
          },
          {
            "attemptResult": "SKIPPED",
            "identifierName": "Hardware Rule",
            "attributes": [
              "serial_number"
            ],
            "hybridEntryCiAttributes": [],
            "searchOnTable": "cmdb_ci_hardware"
          },
          {
            "attemptResult": "MATCHED",
            "identifierName": "Hardware Rule",
            "attributes": [
              "name"
            ],
            "hybridEntryCiAttributes": [],
            "searchOnTable": "cmdb_ci_hardware"
          }
        ],
        "inputIndices": [
          0
        ],
        "additionalRelatedItems": [],
        "operation": "UPDATE",
        "relatedItems": [
          {
            "markers": [],
            "mergedPayloadIds": [],
            "inputIndices": [
              {
                "subIndex": 0,
                "mainIndex": 0
              }
            ],
            "className": "cmdb_serial_number"
          },
          {
            "markers": [],
            "mergedPayloadIds": [],
            "inputIndices": [
              {
                "subIndex": 1,
                "mainIndex": 0
              }
            ],
            "className": "cmdb_ci_network_adapter"
          }
        ],
        "mergedPayloadIds": [],
        "className": "cmdb_ci_linux_server"
      },
      {
        "operation": "UPDATE",
        "identifierEntrySysId": "556eb250c3400200d8d4bea192d3ae92",
        "mergedPayloadIds": [],
        "sysId": "304481257f701200bee45f19befa915b",
        "identificationAttempts": [
          {
            "attemptResult": "SKIPPED",
            "identifierName": "Hardware Rule",
            "attributes": [
              "serial_number",
              "serial_number_type"
            ],
            "hybridEntryCiAttributes": [],
            "searchOnTable": "cmdb_serial_number"
          },
          {
            "attemptResult": "NO_MATCH",
            "identifierName": "Hardware Rule",
            "attributes": [
              "serial_number"
            ],
            "hybridEntryCiAttributes": [],
            "searchOnTable": "cmdb_ci_hardware"
          },
          {
            "attemptResult": "MATCHED",
            "identifierName": "Hardware Rule",
            "attributes": [
              "name"
            ],
            "hybridEntryCiAttributes": [],
            "searchOnTable": "cmdb_ci_hardware"
          }
        ],
        "errorCount": 0,
        "markers": [],
        "className": "cmdb_ci_ip_switch",
        "inputIndices": [
          1
        ]
      }
    ],
    "additionalCommittedRelations": [],
    "additionalCommittedItems": []
  }
}

식별 및 조정 - POST /now/identifyreconcile/queryEnhanced

데이터베이스에서 CMDB 작업을 커밋하지 않고 지정된 페이로드(요청 본문)로 수행할 작업(삽입/업데이트)을 결정합니다.

이 엔드포인트를 사용하여 엔드포인트에 대한 페이로드(요청 본문) 제출을 시뮬레이션합니다.식별 및 조정 - POST /now/identifyreconcile/enhanced

이 메서드는 메서드와 식별 및 조정 - POST /now/identifyreconcile/query 비슷하지만 다음 기능을 추가합니다.

부분 페이로드
- 항목에 경고 또는 오류가 있는 경우 항목 작업이 INSERT_AS_PARTIAL되었는지 또는 INSERT_INCOMPLETE 여부를 나타냅니다.
- 기존 부분 페이로드와 병합된 부분 페이로드의 sys_ids를 반환합니다.
페이로드 중복 제거 기능을 지원합니다.
요약을 생성합니다.

URL 형식

버전이 지정된 URL: /api/now/{api_version}/identifyreconcile/queryEnhanced

기본 URL: /api/now/identifyreconcile/queryEnhanced

주:

사용 가능한 버전은 REST API 탐색기에 지정됩니다. 스크립트 기반 REST API의 경우 스크립트 기반 REST 서비스 양식에 추가 버전 정보가 있습니다.

지원되는 요청 매개변수

표 19. 경로 매개변수
이름	설명
api_version	옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 `v1` 또는 `v2`입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오. 데이터 유형: 문자열

표 20. 쿼리 매개변수
이름	설명
옵션	요청에 적용된 향상된 IRE 옵션을 나타내는 이름-값 쌍의 쉼표로 구분된 목록입니다. 예를 들어, 부분 페이로드, 부분 커밋, 중복 제거 페이로드 및 요약 생성에 대한 기본값을 재정의합니다. 향상된 IRE 옵션: `partial_payloads:false,partial_commits:false,deduplicate_payloads:false,generate_summary:true` 주: 기본적으로 또는 if partial_payloads true로 설정되어 있으며, 이러한 기능은 부분 페이로드 기능에 필수적이므로 false로 설정되더라도 둘 다 partial_commitsdeduplicate_payloads 활성화됩니다. 향상된 IRE 옵션에 대한 자세한 내용은 IRE(식별 및 조정 엔진)를 참조하십시오. 각 이름-값 쌍에 유효한 값은 다음과 같습니다. true: 이 향상된 IRE 옵션을 활성화합니다. false: 이 향상된 IRE 옵션을 비활성화합니다. 데이터 유형: 문자열
sysparm_data_source	CI 정보의 소스입니다. 구성 항목 [cmdb_ci] 테이블의 discovery_source 필드에 대해 정의된 선택 값 중 하나여야 합니다. 데이터 유형: 문자열 기본값: 미완료 페이로드 테이블에 API 페이로드를 삽입합니다.

표 21. 요청 본문 매개변수(XML 또는 JSON)
이름	설명
항목	만들거나 업데이트할 CI 목록입니다. 데이터 유형: 객체 배열 `"items": [ { "className": "String", "internal_id": "String", "lookup": [Array], "related": [Array], "settings": {Object}, "sys_object_source_info": {Object}, "values": {Object} } ]`
items.className	필수 만들거나 업데이트할 CI의 sys_class_name(클래스/테이블 이름)입니다. 이 값은 cmdb_ci_linux_server 또는 cmdb_ci_win_server와 같은 모든 CMDB 테이블이 될 수 있습니다. 데이터 유형: 문자열
items.internal_id	이 페이로드에 있는 이 항목의 고유 식별자입니다. 모든 값이 될 수 있지만 페이로드 내에서 고유해야 합니다. 데이터 유형: 문자열
항목.조회	각 객체가 조회 기반 식별 기록을 설명하는 객체의 배열입니다. 이러한 기록은 구성 항목 [cmdb_ci] 테이블에 대한 참조가 있는 조회 테이블을 기반으로 최상위 구성 항목을 식별하는 데 사용됩니다. 데이터 유형: 객체 배열 `"lookup": [ { "className": "String", "internal_id": "String", "sys_object_source_info": {Object}, "values": {Object} } ]`
items.lookup.className	필수 만들거나 업데이트할 CI의 sys_class_name 또는 클래스/테이블 이름입니다. 이 값은 cmdb_serial_number이나 cmdb_ci_network_adapter 등의 클래스/테이블 또는 비CMDB계층 구조 클래스일 수 CMDB 있습니다. 데이터 유형: 문자열
items.lookup.internal_id	이 페이로드에 있는 이 조회 기록의 고유 식별자입니다. 모든 값이 될 수 있지만 페이로드 내에서 고유해야 합니다. 데이터 유형: 문자열
items.lookup.sys_object_source_info	지정된 데이터 소스에 대한 고유 CI 식별자를 설명하는 객체입니다. 소스마다 동일한 CI에 대해 서로 다른 이름-값 쌍이 있을 수 있습니다. 데이터 유형: 객체 `"sys_object_source_info": { "source_feed": "String", "source_name": "String", "source_native_key": "String", "source_recency_timestamp": "String" }`
items.lookup.sys_object_source_info.source_feed	이 CI를 보내는 피드를 고유하게 식별하는 이름입니다. 소스에 여러 피드가 있을 수 있는 경우 사용합니다. 데이터 유형: 문자열
items.lookup.sys_object_source_info.source_name	CI 정보의 데이터 소스입니다. 이 값은 구성 항목 [cmdb_ci] 테이블의 discovery_source 필드에 대해 정의된 선택 값 중 하나여야 합니다. 데이터 유형: 문자열
items.lookup.sys_object_source_info.source_native_key	CI 소스의 고유 키/ID입니다. 항목에 고유한 모든 문자열이 될 수 있습니다. 데이터 유형: 문자열
items.lookup.sys_object_source_info.source_recency_timestamp	CI를 스캔한 UTC 날짜 및 시간입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD hh:mm:ss
항목.조회.값	이 조회 항목의 필드를 이름/값 쌍으로 설명하는 객체입니다. 여기서 이름은 필드 이름입니다. 데이터 유형: 객체 필드 이름과 유형은 사용자가 선택한 필드에 따라 달라집니다(예: `"values": { "ip_address": "String", "mac_address": "String", "serial_number": "String", "serial_number_type": "String", "valid": "String" }`
항목.관련	식별되는 최상위 CI에 대한 참조가 있는 관련 테이블을 기반으로 각 객체가 만들거나 업데이트할 항목 기록을 설명하는 객체의 배열입니다. 관련 항목 [cmdb_related_entry] 테이블의 규칙은 이 배열에 포함될 수 있는 기록 유형을 정의합니다. 관련 테이블은 구성 항목 [cmdb_ci] 테이블을 확장하거나 확장하지 않을 수 있습니다. 이러한 기록은 구성 항목을 식별하는 데 사용되지 않습니다. 데이터 유형: 객체 배열 `"related": [ { "className": "String", "internal_id": "String", "sys_object_source_info": {Object}, "values": {Object} } ]`
items.related.className	필수 만들거나 업데이트할 관련 항목의 sys_class_name 또는 클래스/테이블 이름입니다. 데이터 유형: 문자열
items.related.internal_id	이 페이로드에 있는 이 관련 항목에 대한 고유 식별자입니다. 모든 값이 될 수 있지만 페이로드 내에서 고유해야 합니다. 데이터 유형: 문자열
items.related.sys_object_source_info	지정된 데이터 소스에 대한 고유 CI 식별자를 설명하는 객체입니다. 소스마다 동일한 CI에 대해 서로 다른 이름-값 쌍이 있을 수 있습니다. 데이터 유형: 객체 `"sys_object_source_info": { "source_feed": "String", "source_name": "String", "source_native_key": "String", "source_recency_timestamp": "String" }`
items.related.sys_object_source_info.source_feed	이 관련 항목을 보내는 피드를 고유하게 식별하는 이름입니다. 소스에 여러 피드가 있을 수 있는 경우 사용합니다. 데이터 유형: 문자열
items.related.sys_object_source_info.source_name	관련 항목 정보의 데이터 소스입니다. 이 값은 구성 항목 [cmdb_ci] 테이블의 discovery_source 필드에 대해 정의된 선택 값 중 하나여야 합니다. 데이터 유형: 문자열
items.related.sys_object_source_info.source_native_key	관련 항목에 대한 소스의 고유 키/ID입니다. 항목에 고유한 모든 문자열이 될 수 있습니다. 데이터 유형: 문자열
items.related.sys_object_source_info.source_recency_timestamp	관련 항목을 스캔한 UTC 날짜 및 시간입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD hh:mm:ss
항목.관련.값	이 관련 항목에 대해 작성하거나 업데이트할 필드를 이름/값 쌍으로 설명하는 객체입니다. 여기서 이름은 필드 이름입니다. 참조 필드의 경우 값은 참조된 sys_id여야 합니다. 데이터 유형: 객체 필드 이름과 유형은 사용자가 선택한 필드에 따라 달라집니다(예: `"values": { "host_name": "String", "ip_address": "String", "name": "String", "os_name": "String", "sys_class_name": "String" }`
항목.설정	허용되는 업데이트 유형을 정의하는 매개변수를 포함하는 객체입니다. 데이터 유형: 객체 `"settings": { "skipReclassificationRestrictionRules": Boolean, "updateWithoutDowngrade": Boolean, "updateWithoutSwitch": Boolean, "updateWithoutUpgrade": Boolean }`
items.settings.skipReclassificationRestrictionRules	IRE가 페이로드 항목의 클래스와 일치하는 재분류 제한 규칙 실행을 건너뛰어야 하는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. true: 규칙 실행을 건너뜁니다. false: 규칙을 실행합니다. 기본값: false
items.settings.updateWithoutDowngrade	이 CI에 대해 업데이트와 다운그레이드가 모두 허용되는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. 예: 항목을 업데이트하지만 다운그레이드는 허용되지 않습니다. 아니오: 항목 업데이트와 다운그레이드가 모두 허용됩니다. 데이터 유형: 부울 기본값: false
items.settings.updateWithoutSwitch	이 CI를 업데이트할 수 있고 클래스를 전환할 수 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. 예: 항목을 업데이트하지만 클래스 전환은 허용되지 않습니다. 아니오: 항목 업데이트와 클래스 전환이 모두 허용됩니다. 데이터 유형: 부울 기본값: false
items.settings.updateWithoutUpgrade	이 CI에 대해 업데이트와 업그레이드가 모두 허용되는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. 예: 항목을 업데이트하지만 업그레이드는 허용되지 않습니다. 아니오: 항목 업데이트와 업그레이드가 모두 허용됩니다. 데이터 유형: 부울 기본값: false
items.sys_object_source_info	고유 CI 식별자를 설명하는 객체입니다. 데이터 유형: 객체 `"sys_object_source_info": { "source_feed": "String", "source_name": "String", "source_native_key": "String", "source_recency_timestamp": "String" }`
items.sys_object_source_info.source_feed	이 CI를 보내는 피드를 고유하게 식별하는 이름입니다. 소스에 여러 피드가 있을 수 있는 경우 사용합니다. 데이터 유형: 문자열
items.sys_object_source_info.source_name	CI 정보의 데이터 소스입니다. 이 값은 구성 항목 [cmdb_ci] 테이블의 discovery_source 필드에 대해 정의된 선택 값 중 하나여야 합니다. 데이터 유형: 문자열
items.sys_object_source_info.source_native_key	CI 소스의 고유 키/ID입니다. 항목에 고유한 모든 문자열이 될 수 있습니다. 데이터 유형: 문자열
items.sys_object_source_info.source_recency_timestamp	CI를 스캔한 UTC 날짜 및 시간입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD hh:mm:ss
항목.값	이 CI에 대해 작성하거나 업데이트할 필드를 이름/값 쌍으로 설명하는 객체입니다(여기서 이름은 필드 이름). 참조 필드의 경우 값은 참조된 sys_id여야 합니다. 데이터 유형: 객체 필드 이름과 유형은 사용자가 선택한 필드에 따라 달라집니다(예: `"values": { "host_name": "String", "ip_address": "String", "name": "String", "os_name": "String", "sys_class_name": "String" }`
참조 항목	페이로드의 두 항목 간 참조 목록입니다. 각 참조 항목의 값은 클래스에 정의된 IRE 규칙을 사용하여 CI를 식별하기 전에 채워집니다. 데이터 유형: 객체 배열 `"referenceItems": [ { "referenced": "String", "referencedBy": "String", "referenceField": "String" } ]`
referenceItems.referenced	internal_id 다른 항목에서 참조하는 항목에 대해 정의되어 있습니다. 데이터 유형: 문자열
referenceItems.referencedBy	internal_id 다른 항목을 참조하는 항목에 대해 정의되어 있습니다. 데이터 유형: 문자열
referenceItems.referenceField	항목의 클래스/테이블에 있는 참조 필드의 이름입니다 referencedBy . 데이터 유형: 문자열
관계	페이로드에 정의된 두 항목 간의 관계 목록입니다. 이 배열의 객체는 다음 두 가지 형식 중 하나를 사용할 수 있습니다. 이 객체는 페이로드 items 배열의 항목 인덱스를 나타내는 값과 함께 이름-값 쌍을 사용하여 parentchild 두 최상위 항목 간의 관계를 정의할 수 있습니다. 이 객체는 키/값 쌍을 child_id 사용하여 parent_id 최상위 항목, 관련 항목 또는 조회 항목을 포함하여 두 항목 간의 관계를 정의할 수 있으며, 값은 해당 항목에 대해 정의된 값을 나타낼 internal_id 수 있습니다. 데이터 유형: 객체 배열 `"relations": [ { "child": Number, "parent": Number, "sys_rel_source_info": {Object}, "type": "String" } ]` `"relations": [ { "child_id": "String", "parent_id": "String", "sys_rel_source_info": {Object}, "type": "String" } ]`
관계.하위	관계의 하위 항목을 나타내는 배열에 있는 items CI 객체의 정수 인덱스입니다. 데이터 유형: 숫자
relations.child_id	internal_id 관계에 있는 하위 항목의 객체입니다. 데이터 유형: 문자열
relations.parent	관계의 상위를 나타내는 배열에 있는 items CI 객체의 정수 인덱스입니다. 데이터 유형: 숫자
relations.parent_id	internal_id 관계의 상위 항목입니다. 데이터 유형: 문자열
relations.sys_rel_source_info	관계에 대한 검색 소스 정보입니다. 비의존성 관계의 경우 이 정보는 관계 소스 [sys_rel_source] 테이블에 있습니다. 데이터 유형: 객체 `"sys_rel_source_info": { "source_name": "String", "source_feed": "String" }`
relations.sys_rel_source_info.source_name	검색 소스 이름입니다. 기본값: API 메서드 매개변수에 전달된 디스커버리 소스입니다.
relations.sys_rel_source_info.source_feed	검색 소스 내의 하위 검색/검사에 해당하는 모든 문자열입니다. 기본값: 테이블에서 기록을 생성할 때 source_feed 열에 "알 수 없음"sys_rel_source 저장됩니다.
관계.유형	상위 항목과 하위 항목 간에 존재하는 관계의 유형입니다. CI 관계 유형 [cmdb_rel_type] 테이블의 이름 필드 값이어야 합니다. 데이터 유형: 문자열

헤더

표 22. 요청 헤더
머리글	설명
수용	응답 본문의 데이터 형식입니다. application/json만 지원합니다.
콘텐츠-형식	요청 본문의 데이터 형식입니다. application/json만 지원합니다.

표 23. 응답 헤더
머리글	설명
안 함

상태 코드

이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하십시오.

표 24. 상태 코드
상태 코드	설명
200	성공입니다. 요청이 성공적으로 처리되었습니다.
401	권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다.
500	내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 오류 메시지 상세 정보 "청크 [...]는 유효한 항목이 아닙니다"는 쿼리 매개변수가 options 올바른 이름-값 쌍 형식이 아님을 나타냅니다. 예를 들어 `partial` 매개변수를 options 지정하면 메시지 상세 정보에 "청크 [부분]은 유효한 항목이 아닙니다"가 포함된 500 상태 코드가 생성됩니다.

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


이름	설명
결과	쿼리에 의해 생성된 결과 목록입니다. 데이터 유형: 배열 `"result": [ "additionalCommittedItems": [Array], "additionalCommittedRelations": [Array], "items": [Array], "relations": [Array] ]`
result.additionalCommittedItems	삽입하거나 업데이트할 요청 본문 items 배열에 포함되지 않은 CI 목록입니다. 데이터 유형: 객체 배열 `"additionalCommittedItems": [ { "className": "String", "errorCount": Number, "identificationAttempts": [Array], "inputIndices": [Array], "markers": [Array], "mergedPayloads": [Array], "operation": "String", "sysId": "String" } ]`
result.additionalCommittedItems.className	이 추가 CI의 sys_class_name입니다. 데이터 유형: 문자열
result.additionalCommittedItems.errorCount	이 추가 CI를 처리하는 동안 발생한 오류 수입니다. 데이터 유형: 숫자
result.additionalCommittedItems.errors	이 추가 CI를 처리하는 동안 발생한 오류 목록입니다. 데이터 유형: 객체 배열 `"errors": [ { "error": "String", "message": "String" } ]`
result.additionalCommittedItems.errors.error	이 추가 CI를 처리하는 동안 발생한 오류 유형입니다. 데이터 유형: 문자열
result.additionalCommittedItems.errors.message	이 추가 CI를 처리하는 동안 오류 메시지가 발생했습니다. 데이터 유형: 문자열
result.additionalCommittedItems.identificationAttempts	이 추가 CI를 식별하기 위해 수행한 시도 목록입니다. 데이터 유형: 객체 배열 `"identificationAttempts": [ { "attemptResult": "String", "attributes": [Array], "hybridEntryCiAttributes": [Array], "identiferName": "String", "searchOnTable": [Array] } ]`
result.additionalCommittedItems.identificationAttempts.attemptResult	이 추가 CI 식별 시도의 결과입니다. 가능한 값: 일치: 식별에 성공했습니다. 식별자 규칙 테이블에서 지정된 속성과 정확히 일치하는 고유한 CI를 찾았습니다. MULTI_MATCH: 오류로 인해 식별에 실패했습니다. 지정된 속성과 일치할 때 식별자 규칙 테이블에서 중복 CI가 발견되었습니다. NO_MATCH: 식별에 실패했습니다. 식별자 규칙 테이블에서 지정된 속성과 일치하는 CI를 찾을 수 없습니다. 건너뜀: 식별을 시도하지 않았습니다. 이 식별자 규칙 테이블 검색에 필요한 속성이 제공되지 않아 규칙이 적용되지 않았습니다. 데이터 유형: 문자열
result.additionalCommittedItems.identificationAttempts.attributes	이 추가 CI 식별 시도 중에 사용되는 CI 식별자 항목 속성의 배열입니다. 데이터 유형: 배열 속성 이름과 유형은 다음과 같이 요청 본문 데이터와 사용 중인 식별자에 따라 다릅니다. `"attributes": [ "serial_number": "String", "serial_number_type": "String" ]`
result.additionalCommittedItems.identificationAttempts.hybridEntryCiAttributes	이 추가 CI 식별 시도 중에 사용된 CI 식별자 항목 속성의 목록입니다. 데이터 유형: 배열 속성 이름과 유형은 다음과 같이 요청 본문 데이터와 사용 중인 식별자에 따라 다릅니다. `"hybridEntryCiAttributes": [ "name": "String", "serial_number": "String" ]`
result.additionalCommittedItems.identificationAttempts.identifierName	이 추가 CI 식별 시도에 사용되는 식별자 규칙입니다. 데이터 유형: 문자열
result.additionalCommittedItems.identificationAttempts.searchOnTable	이 추가 CI 식별 시도를 위해 검색된 테이블의 이름입니다. 데이터 유형: 문자열
result.additionalCommittedItems.identifierEntrySysId	이 추가 CI를 식별하는 데 사용되는 식별자 규칙의 Sys_id입니다. 주목할만한 가치: 알 수 없음: 이 추가 CI를 식별하지 못했습니다. 자세한 내용은 errors 문서를 참조하십시오. 데이터 유형: 문자열
result.additionalCommittedItems.inputIndices	이 추가 CI에 해당하는 요청 본문 items 배열의 CI 인덱스 값 목록입니다. 데이터 유형: 객체 배열 `"inputIndices": [ { Number } ]`
result.additionalCommittedItems.markers	내부용 마커 값 목록입니다. 데이터 유형: 배열 `"markers": []`
result.additionalCommittedItems.mergedPayloads	이 추가 CI를 처리하는 동안 병합된 CMDB IRE 부분 페이로드[cmdb_ire_partial_payloads] 테이블의 부분 페이로드에 대한 sys_id 값 목록입니다. 데이터 유형: 배열 `"mergedPayloadIds": [ "String" ]`
result.additionalCommittedItems.operation	이 추가 CI에 대해 수행된 작업입니다. 가능한 값: 삭제: 기존 CI가 대상 테이블에서 제거됩니다. 삽입: 추가적인 CI가 대상 테이블에 새 기록으로 삽입됩니다. NO_CHANGE: 추가 CI에 대해서는 작업이 수행되지 않습니다. 업데이트: 대상 테이블의 기존 CI가 업데이트됩니다. UPDATE_WITH_DOWNGRADE: 대상 테이블의 기존 CI가 업데이트되고 해당 클래스가 보다 일반적인 클래스(상위 클래스)로 변경됩니다. UPDATE_WITH_SWITCH: 대상 테이블의 기존 CI가 업데이트되고 해당 클래스가 상위 또는 하위 클래스가 아닌 다른 클래스로 변경됩니다. UPDATE_WITH_UPGRADE: 대상 테이블의 기존 CI가 업데이트되고 해당 클래스가 보다 전문화된 클래스(하위 클래스)로 변경됩니다. 데이터 유형: 문자열
result.additionalCommittedItems.sysId	식별을 통해 이 추가 CI에 대한 Sys_id 찾았습니다. 주목할 만한 값: 알 수 없음 - 이 추가 CI를 식별하지 못했습니다. 자세한 내용은 errors 문서를 참조하십시오. 데이터 유형: 문자열
result.additionalCommittedItems.warnings	이 추가 CI를 처리하는 동안 발생한 경고 목록입니다. 데이터 유형: 객체 배열 `"warnings": [ { "error": "String", "message": "String" } ]`
result.additionalCommittedItems.warnings.error	이 추가 CI를 처리하는 동안 발생한 경고의 유형입니다. 데이터 유형: 문자열
result.additionalCommittedItems.warnings.message	이 추가 CI를 처리하는 동안 경고 메시지가 발생했습니다. 데이터 유형: 문자열
result.additionalCommittedRelations	삽입하거나 업데이트할 요청 본문 relations 목록에 포함되지 않은 종속 관계 CI 목록입니다. 데이터 유형: 객체 배열 `"additionalCommittedRelations": [ { "className": "String", "operation": "String", "markers": [Array], "inputIndices": [Array], "mergedPayloadIds": [Array] } ]`
result.additionalCommittedRelations.className	이 추가 종속 관계 CI의 sys_class_name입니다. 지원되는 값: cmdb_rel_ci: CI 관계 테이블입니다. 데이터 유형: 문자열
result.additionalCommittedRelations.errorCount	이 추가 종속 관계 CI를 처리하는 동안 발생한 오류 수입니다. 데이터 유형: 숫자
result.additionalCommittedRelations.errors	이 추가 종속 관계 CI를 처리하는 동안 발생한 오류 목록입니다. 데이터 유형: 객체 배열 `"errors": [ { "error": "String", "message": "String" } ]`
result.additionalCommittedRelations.errors.error	이 추가 종속 관계 CI를 처리하는 동안 발생한 오류 유형입니다. 데이터 유형: 문자열
result.additionalCommittedRelations.errors.message	이 추가 종속 관계 CI를 처리하는 동안 오류 메시지가 발생했습니다. 데이터 유형: 문자열
result.additionalCommittedRelations.inputIndices	이 추가 종속 관계 CI에 해당하는 요청 본문 relations 배열의 종속 관계 CI 객체에 대한 인덱스 값 목록입니다. 데이터 유형: 배열 `"inputIndices": [ Number ]`
result.additionalCommittedRelations.markers	내부용 마커 값 목록입니다. 데이터 유형: 배열 `"markers": []`
result.additionalCommittedRelations.mergedPayloadIds	이 추가 종속 관계 CI를 처리하는 동안 병합된 CMDB IRE 부분 페이로드 [cmdb_ire_partial_payloads] 테이블의 부분 페이로드에 대한 sys_id 값 목록입니다. 데이터 유형: 배열 `"mergedPayloadIds": [ "String" ]`
result.additionalCommittedRelations.operation	이 추가 종속 관계 CI에 대해 수행된 작업입니다. 가능한 값: 삽입: 종속 관계 CI가 대상 테이블에 새 기록으로 삽입됩니다. INSERT_AS_INCOMPLETE: 종속 관계 CI에 오류가 있었고 CMDB IRE 미완료 페이로드 [cmdb_ire_incomplete_payloads] 테이블에 삽입되었습니다. INSERT_AS_PARTIAL: 종속 관계 CI에 오류가 있었고 CMDB IRE cmdb_ire_partial_payloads 페이로드 테이블에 삽입됩니다. NO_CHANGE: 종속 관계 CI에 대해 수행된 작업이 없습니다. 업데이트: 대상 테이블의 기존 종속 관계 CI가 업데이트됩니다. 데이터 유형: 문자열
결과.항목	요청 본문 items 배열에 포함된 CI 목록입니다. 데이터 유형: 객체 배열 `"items": [ { "additionalRelatedItems": [Array], "className": "String", "duplicateLookupIndices": {Object}, "errorCount": Number, "errors": [Array], "identificationAttempts": [Array], "identifierEntrySysId": "String", "info": [Array], "inputIndices": [Array], "markers": [Array], "mergedPayloadIds": [Array], "operation": "String", "relatedItems": [Array], "relatedSysIds": [Array], "sysId": "String", "warnings": [Array] } ]`
result.items.additionalRelatedItems	CMDB IRE 부분 페이로드 [cmdb_ire_partial_payloads] 테이블의 관련 CI(테이블 조회 CI) 목록입니다. 데이터 유형: 객체 배열 `"additionalRelatedItems": [ { "className": "String", "inputIndices": [Array], "markers": [Array], "mergedPayloadIds": [Array], "sysId": "String" } ]`
result.items.additionalRelatedItems.className	관련 항목의 sys_class_name입니다. 데이터 유형: 문자열
result.items.additionalRelatedItems.inputIndices	이 관련 항목에 해당하는 요청 본문 items 배열의 CI 인덱스 값 목록입니다. 데이터 유형: 배열 `"inputIndices": [ Number ]`
result.items.additionalRelatedItems.markers	내부용 마커 값 목록입니다. 데이터 유형: 배열 `"markers": []`
result.items.additionalRelatedItems.mergedPayloadIds	이 관련 항목을 처리하는 동안 병합된 CMDB IRE 부분 페이로드[cmdb_ire_partial_payloads] 테이블의 부분 페이로드에 대한 sys_id 값 목록입니다. 데이터 유형: 배열 `"mergedPayloadIds": [ "String" ]`
result.items.additionalRelatedItems.sysId	이 관련 CI의 Sys_id입니다. 데이터 유형: 문자열
result.items.className	이 CI의 Sys_class_name입니다. 데이터 유형: 문자열
result.items.duplicateLookupIndices	동일한 관련 CI를 참조하는 배열 요소에 대한 items.lookup 인덱스 값 배열을 포함하는 객체입니다. 배열 이름은 지정된 관련 CI를 참조하는 요청 본문 items.lookup 배열의 첫 번째 요소를 나타냅니다. 해당 값은 동일한 관련 CI를 참조하는 동일한 배열의 추가 요소 집합입니다. 데이터 유형: 객체 다음 예는 배열의 두 번째 요소가 items.lookup 해당 배열의 이후 요소와 동일한 관련 CI를 참조하는 경우를 보여줍니다. `"duplicateLookupIndices": [ "2": [Array] ]`
result.items.errorCount	이 CI를 처리하는 동안 발생한 오류 수입니다. 데이터 유형: 숫자
결과.항목.오류	이 CI를 처리하는 동안 발생한 오류 목록입니다. 데이터 유형: 객체 배열 `"errors": [ { "error": "String", "message": "String" } ]`
결과.항목.오류.오류	이 CI를 처리하는 동안 발생한 오류의 유형입니다. 데이터 유형: 문자열
결과.항목.오류.메시지	이 CI를 처리하는 동안 오류 메시지가 발생했습니다. 데이터 유형: 문자열
결과.항목.식별시도	이 CI를 식별하려고 시도한 목록입니다. 데이터 유형: 객체 배열 `"identificationAttempts": [ { "attemptResult": "String", "attributes": [Array], "hybridEntryCiAttributes": [Array], "identiferName": "String", "searchOnTable": [Array] } ]`
결과.항목.식별시도.시도결과	이 CI 식별 시도의 결과입니다. 가능한 값: 일치: 식별에 성공했습니다. 식별자 규칙 테이블에서 지정된 속성과 정확히 일치하는 고유한 CI를 찾았습니다. MULTI_MATCH: 오류로 인해 식별에 실패했습니다. 지정된 속성과 일치할 때 식별자 규칙 테이블에서 중복 CI가 발견되었습니다. NO_MATCH: 식별에 실패했습니다. 식별자 규칙 테이블에서 지정된 속성과 일치하는 CI를 찾을 수 없습니다. 건너뜀: 식별을 시도하지 않았습니다. 이 식별자 규칙 테이블 검색에 필요한 속성이 제공되지 않아 규칙이 적용되지 않았습니다. 데이터 유형: 문자열
result.items.identificationAttempts.attributes	이 CI 식별 시도 중에 사용된 CI 식별자 항목 속성의 목록입니다. 데이터 유형: 배열 속성 이름과 유형은 다음과 같이 요청 본문 데이터와 사용 중인 식별자에 따라 다릅니다. `"attributes": [ "serial_number": "String", "serial_number_type": "String", ]`
result.items.identificationAttempts.hybridEntryCiAttributes	이 CI 식별 시도 중에 사용된 CI 식별자 항목 속성의 목록입니다. 데이터 유형: 배열 속성 이름과 유형은 다음과 같이 요청 본문 데이터와 사용 중인 식별자에 따라 다릅니다. `"hybridEntryCiAttributes": [ "name": "String", "serial_number": "String" ]`
result.items.identificationAttempts.identifierName	이 CI 식별 시도에 사용되는 식별자 규칙입니다. 데이터 유형: 문자열
result.items.identificationAttempts.searchOnTable	이 CI 식별 시도를 위해 검색된 테이블의 이름입니다. 데이터 유형: 문자열
result.items.identifierEntrySysId	이 CI를 식별하는 데 사용되는 식별자 규칙의 Sys_id입니다. 주목할만한 가치: 알 수 없음: 이 CI를 식별하지 못했습니다. 자세한 내용은 errors 문서를 참조하십시오. 데이터 유형: 문자열
result.items.info	항목 처리에 대한 추가 정보 목록입니다. 데이터 유형: 객체 배열 `"info": [ { "code": "String", "message": "String", "ruleSysId": "String" } ]`
result.items.info.code	건너뛴 재분류 유형입니다. 가능한 값: SKIPPED_CLASS_SWITCH SKIPPED_CLASS_DOWNGRADE SKIPPED_CLASS_UPGRADE
result.items.info.message	재분류를 건너뛰는 이유에 대한 추가 인사이트를 제공하는 메시지입니다. 데이터 유형: 문자열
result.items.info.ruleSysId	일치하는 재분류 제한 규칙의 Sys_id입니다. IRE가 재분류 제한 규칙으로 인해 재분류를 건너뛰는 경우에만 적용할 수 있습니다. 페이로드 또는 전역 플래그로 인해 재분류를 건너뛰면 이 값은 비어 있습니다. 데이터 유형: 문자열
result.items.inputIndices	이 CI에 해당하는 요청 본문 items 배열의 CI 인덱스 값 목록입니다. 데이터 유형: 객체 배열 `"inputIndices": [ { Number } ]`
결과.항목.마커	내부용 마커 값 목록입니다. 데이터 유형: 배열 `"markers": []`
result.items.mergedPayloadIds	이 CI를 처리하는 동안 병합된 CMDB IRE Partial Payloads [cmdb_ire_partial_payloads] 테이블의 부분 페이로드에 대한 sys_id 값 목록입니다. 데이터 유형: 배열 `"mergedPayloadIds": [ "String" ]`
결과.항목.운영	이 CI에 대해 수행된 작업입니다. 가능한 값: 삭제: 기존 CI가 대상 테이블에서 제거됩니다. 삽입: CI가 대상 테이블에 새 기록으로 삽입됩니다. NO_CHANGE: CI에 대해 수행되는 작업이 없습니다. 업데이트: 대상 테이블의 기존 CI가 업데이트됩니다. UPDATE_WITH_DOWNGRADE: 대상 테이블의 기존 CI가 업데이트되고 해당 클래스가 보다 일반적인 클래스(상위 클래스)로 변경됩니다. UPDATE_WITH_SWITCH: 대상 테이블의 기존 CI가 업데이트되고 해당 클래스가 상위 또는 하위 클래스가 아닌 다른 클래스로 변경됩니다. UPDATE_WITH_UPGRADE: 대상 테이블의 기존 CI가 업데이트되고 해당 클래스가 보다 전문화된 클래스(하위 클래스)로 변경됩니다. 데이터 유형: 문자열
result.items.relatedItems	요청 본문 items.lookup 배열의 관련 CI(테이블 조회 CI) 목록입니다. 데이터 유형: 객체 배열 `"relatedItems": [ { "className": "String", "inputIndices": [Array], "markers": [Array], "mergedPayloadIds": [Array], "sysId": "String" } ]`
result.items.relatedItems.className	관련 항목의 sys_class_name입니다. 데이터 유형: 문자열
result.items.relatedItems.inputIndices	요청 본문 items 과 items.lookup 이 관련 항목에 해당하는 배열의 CI 및 조회 항목에 대한 인덱스 값 목록입니다. 데이터 유형: 객체 배열 `"inputIndices": [ { "mainIndex": Number, "subIndex": Number } ]`
result.items.relatedItems.inputIndices.mainIndex	관련 항목의 CI 상위에 해당하는 요청 본문 items 배열의 인덱스 값입니다. 데이터 유형: 숫자
result.items.relatedItems.inputIndices.subIndex	관련 항목에 해당하는 요청 본문 items.lookup 배열의 인덱스 값입니다. 데이터 유형: 숫자
result.items.relatedItems.markers	내부용 마커 값 목록입니다. 데이터 유형: 배열 `"markers": []`
result.items.relatedItems.mergedPayloadIds	처리 중에 이 CI에 병합된 CMDB IRE 부분 페이로드[cmdb_ire_partial_payloads] 테이블의 항목에 대한 sys_id 값 목록입니다. 데이터 유형: 배열 `"mergedPayloadIds": [ "String" ]`
result.items.relatedSysIds	요청 본문 items.lookup 배열의 관련 항목(테이블 조회 항목)에 대한 sys_id 값 목록입니다. 데이터 유형: 배열 주목할만한 가치: null: 이 관련 항목에 대해 식별된 sys_id이 없습니다. `"relatedSysIds": [ Number, Number ]`
result.items.sysId	식별을 통해 이 CI에 대한 Sys_id 찾았습니다. 주목할만한 가치: 알 수 없음: 이 CI를 식별하지 못했습니다. 자세한 내용은 errors 문서를 참조하십시오. 데이터 유형: 문자열
결과.항목.경고	이 CI를 처리하는 동안 발생한 경고 목록입니다. 데이터 유형: 객체 배열 `"warnings": [ { "error": "String", "message": "String" } ]`
결과.항목.경고.오류	이 CI를 처리하는 동안 발생한 경고의 유형입니다. 데이터 유형: 문자열
결과.항목.경고.메시지	이 CI를 처리하는 동안 발생한 경고 메시지. 데이터 유형: 문자열
result.logContextId	이 페이로드에 대해 보고된 컨텍스트 ID입니다. 데이터 유형: 문자열
결과.관계	요청 본문 relations 배열의 종속 관계 CI 목록입니다. 데이터 유형: 객체 배열 `"relations": [ { "className": "String", "errorCount": Number, "errors": [Array], "inputIndices": [Array], "markers": [Array], "mergedPayloadIds": [Array], "operation": "String", "warnings": [Array] } ]`
result.relations.className	이 종속 관계 CI의 sys_class_name입니다. 지원되는 값: cmdb_rel_ci: CI 관계 테이블입니다. 데이터 유형: 문자열
result.relations.errorCount	이 종속 관계 CI를 처리하는 동안 발생한 오류 수입니다. 데이터 유형: 숫자
결과.관계.오류	이 종속 관계 CI를 처리하는 동안 발생한 오류 목록입니다. 데이터 유형: 객체 배열 `"errors": [ { "error": "String", "message": "String" } ]`
결과.관계.오류.오류	이 종속 관계 CI를 처리하는 동안 발생한 오류 유형입니다. 데이터 유형: 문자열
result.relations.errors.message	이 종속 관계 CI를 처리하는 동안 오류 메시지가 발생했습니다. 데이터 유형: 문자열
result.relations.inputIndices	이 종속 관계 CI에 해당하는 요청 본문 relations 배열의 종속 관계 CI 객체에 대한 인덱스 값 목록입니다. 데이터 유형: 배열 `"inputIndices": [ Number ]`
결과.관계.마커	내부용 마커 값 목록입니다. 데이터 유형: 배열 `"markers": []`
result.relations.mergedPayloadIds	이 종속 관계 CI를 처리하는 동안 병합된 CMDB IRE 부분 페이로드 [cmdb_ire_partial_payloads] 테이블의 부분 페이로드에 대한 sys_id 값 목록입니다. 데이터 유형: 배열 `"mergedPayloadIds": [ "String" ]`
결과.관계.운영	이 종속 관계 CI에 대해 수행된 운영입니다. 가능한 값: 삽입: 종속 관계 CI가 대상 테이블에 새 기록으로 삽입되었습니다. INSERT_AS_INCOMPLETE: 종속 관계 CI에 오류가 있어 CMDB IRE 미완료 페이로드 [cmdb_ire_incomplete_payloads] 테이블에 삽입되었습니다. INSERT_AS_PARTIAL: 종속 관계 CI에 오류가 있어 CMDB IRE Partial Payloads [cmdb_ire_partial_payloads] 테이블에 삽입되었습니다. NO_CHANGE: 종속 관계 CI에 대해 수행된 운영이 없습니다. 업데이트: 대상 테이블의 기존 종속 관계 CI가 업데이트되었습니다. 데이터 유형: 문자열
결과.관계.경고	이 종속 관계 CI를 처리하는 동안 발생한 경고 목록입니다. 데이터 유형: 객체 배열 `"warnings": [ { "error": "String", "message": "String" } ]`
결과.관계.경고.오류	이 종속 관계 CI를 처리하는 동안 발생한 경고의 유형입니다. 데이터 유형: 문자열
결과.관계.경고.메시지	이 종속 관계 CI를 처리하는 동안 경고 메시지가 발생했습니다. 데이터 유형: 문자열

cURL 요청

컴퓨터 CI에 대한 부분 페이로드 제출을 시뮬레이션합니다.

curl "https://instance.servicenow.com/api/now/identifyreconcile/queryEnhanced" \
--request POST \
--header "Accept: application/json" \
--header "Content-Type: application/json" \
--user "username":"password" \
--data '{ \
  "items" : [ \
    { \
      "className" : "cmdb_ci_computer", \
      "sys_object_source_info" : { \
        "source_name" : "ServiceNow", \
        "source_native_key" : "ncomputer3367" \
      }, \
      "values" : { \
        "cpu_core_count" : "6", \
        "ram" : "8192", \
        "manufacturer" : "DELL", \
        "company" : "My Company" \
      } \
    } \
  ] \
}'

응답은 페이로드가 CMDB IRE Partial Payloads [cmdb_ire_partial_payloads] 테이블에 삽입될 것임을 보여줍니다.

{
  "result": {
    "relations": [],
    "items": [
      {
        "identifierEntrySysId": "Unknown",
        "partialSysIds": [
          "1aec79151bb45010593876a61a4bcb28"
        ],
        "sysId": "Unknown",
        "errorCount": 0,
        "markers": [],
        "className": "cmdb_ci_computer",
        "inputIndices": [
          0
        ],
        "operation": "INSERT_AS_PARTIAL",
        "errors": [],
        "identificationAttempts": [
          {
            "info": "sys_object_source NO_MATCH",
            "attemptResult": "NO_MATCH",
            "identifierName": "",
            "attributes": [],
            "hybridEntryCiAttributes": []
          },
          {
            "attemptResult": "SKIPPED",
            "identifierName": "Hardware Rule",
            "attributes": [
              "serial_number",
              "serial_number_type"
            ],
            "hybridEntryCiAttributes": [],
            "searchOnTable": "cmdb_serial_number"
          },
          {
            "attemptResult": "SKIPPED",
            "identifierName": "Hardware Rule",
            "attributes": [
              "serial_number"
            ],
            "hybridEntryCiAttributes": [],
            "searchOnTable": "cmdb_ci_hardware"
          },
          {
            "attemptResult": "SKIPPED",
            "identifierName": "Hardware Rule",
            "attributes": [
              "name"
            ],
            "hybridEntryCiAttributes": [],
            "searchOnTable": "cmdb_ci_hardware"
          },
          {
            "attemptResult": "SKIPPED",
            "identifierName": "Hardware Rule",
            "attributes": [
              "mac_address",
              "name"
            ],
            "hybridEntryCiAttributes": [],
            "searchOnTable": "cmdb_ci_network_adapter"
          }
        ],
        "warningCount": 1,
        "warnings": [
          {
            "message": "In payload missing minimum set of input values for criterion (matching) attributes from identify rule for table [cmdb_ci_hardware]. Add these input values in payload item '{\"className\":\"cmdb_ci_computer\",\"values\":{\"discovery_source\":\"ServiceNow\",\"company\":\"My Company\",\"cpu_core_count\":\"6\",\"ram\":\"8192\",\"manufacturer\":\"DELL\"},\"sys_object_source_info\":{\"source_name\":\"ServiceNow\",\"source_native_key\":\"ncomputer3367\"},\"settings\":{},\"sys_ire_info\":{\"ire_received_time\":\"2020-05-14 20:14:51\"}}'",
            "error": "MISSING_MATCHING_ATTRIBUTES"
          }
        ],
        "mergedPayloadIds": [
          "7ddcb9551bb45010593876a61a4bcb08"
        ]
      }
    ],
    "additionalCommittedRelations": [],
    "additionalCommittedItems": []
  }
}

요약 생성 향상된 IRE 옵션을 활성화한 상태에서 컴퓨터 CI에 대한 설명을 완료하는 두 번째 부분 페이로드의 제출을 시뮬레이션합니다.

curl "https://instance.servicenow.com/api/now/identifyreconcile/queryEnhanced?options=generate_summary:true" \
--request POST \
--header "Accept: application/json" \
--header "Content-Type: application/json" \
--user "username:password" \
--data '{ \
}'

응답은 컴퓨터 CI가 삽입될 것임을 보여주고 수행될 작업의 요약을 표시합니다.

{
  "result": {
    "relations": [],
    "hasError": false,
    "additionalCommittedItems": [],
    "hasWarning": false,
    "items": [
      {
        "relatedSysIds": [
          "735c79151bb45010593876a61a4bcb67"
        ],
        "identifierEntrySysId": "Unknown",
        "sysId": "ff5c79151bb45010593876a61a4bcb64",
        "errorCount": 0,
        "markers": [],
        "className": "cmdb_ci_computer",
        "inputIndices": [
          0
        ],
        "operation": "INSERT",
        "relatedItems": [
          {
            "operation": "INSERT",
            "warningCount": 0,
            "errors": [],
            "sysId": "735c79151bb45010593876a61a4bcb67",
            "className": "cmdb_ci_network_adapter",
            "errorCount": 0,
            "markers": [],
            "inputIndices": [
              {
                "subIndex": 0,
                "mainIndex": 0
              }
            ],
            "mergedPayloadIds": []
          }
        ],
        "mergedPayloadIds": [
          "fe4c39151bb45010593876a61a4bcbd3"
        ],
        "identificationAttempts": [
          {
            "info": "sys_object_source NO_MATCH",
            "attemptResult": "NO_MATCH",
            "identifierName": "",
            "attributes": [],
            "hybridEntryCiAttributes": []
          },
          {
            "attemptResult": "SKIPPED",
            "identifierName": "Hardware Rule",
            "attributes": [
              "serial_number",
              "serial_number_type"
            ],
            "hybridEntryCiAttributes": [],
            "searchOnTable": "cmdb_serial_number"
          },
          {
            "attemptResult": "SKIPPED",
            "identifierName": "Hardware Rule",
            "attributes": [
              "serial_number"
            ],
            "hybridEntryCiAttributes": [],
            "searchOnTable": "cmdb_ci_hardware"
          },
          {
            "attemptResult": "SKIPPED",
            "identifierName": "Hardware Rule",
            "attributes": [
              "name"
            ],
            "hybridEntryCiAttributes": [],
            "searchOnTable": "cmdb_ci_hardware"
          },
          {
            "attemptResult": "NO_MATCH",
            "identifierName": "Hardware Rule",
            "attributes": [
              "mac_address",
              "name"
            ],
            "hybridEntryCiAttributes": [],
            "searchOnTable": "cmdb_ci_network_adapter"
          }
        ],
        "warningCount": 0
      }
    ],
    "additionalCommittedRelations": [],
    "summary": {
      "cmdb_ci_network_adapter": {
        "mergedPartialPayloads": 0,
        "inserted": 1,
        "partial": 0,
        "warnings": 0,
        "incomplete": 0,
        "additionalInserted": 0,
        "unchanged": 0,
        "skipped": 0,
        "updated": 0,
        "errors": 0
      },
      "cmdb_ci_computer": {
        "mergedPartialPayloads": 1,
        "inserted": 1,
        "partial": 0,
        "warnings": 0,
        "incomplete": 0,
        "additionalInserted": 0,
        "unchanged": 0,
        "skipped": 0,
        "updated": 0,
        "errors": 0
      }
    }
  }
}