식별 및 조정 API

릴리스 버전: Xanadu

업데이트 날짜 2024년 08월 01일

읽기181분

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

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

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

식별 및 조정 - POST /now/identifyreconcile

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

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

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

URL 형식

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

기본 URL: /api/now/identifyreconcile

지원되는 요청 매개변수

표 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	이 페이로드의 이 항목에 대한 고유 식별자입니다. 모든 값이 될 수 있지만 페이로드 내에서 고유해야 합니다. 데이터 유형: 문자열
items.lookup	각 개체가 조회 기반 식별 기록을 설명하는 개체의 배열입니다. 이러한 기록은 구성 항목 [cmdb_ci] 테이블에 대한 참조가 있는 조회 테이블을 기반으로 최상위 구성 항목을 식별하는 데 사용됩니다. 데이터 형식: 배열 off Objects `"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.소스_피드	이 CI를 전송하는 피드를 식별하는 이름입니다. 소스에 여러 피드가 있을 수 있는 경우에 사용합니다. 데이터 유형: 문자열
items.lookup.sys_object_source_info.소스_이름	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
items.lookup.values	이 조회 항목의 필드를 이름/값 쌍으로 설명하는 객체입니다. 여기서 이름은 필드 이름입니다. 데이터 유형: 객체 필드 이름과 유형은 다음과 같이 사용자가 선택한 필드에 따라 달라집니다. `"values": { "ip_address": "String", "mac_address": "String", "serial_number": "String", "serial_number_type": "String", "valid": "String" }`
items.related	식별 중인 최상위 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.소스_피드	이 관련 항목을 보내는 피드를 고유하게 식별하는 이름입니다. 소스에 여러 피드가 있을 수 있는 경우에 사용합니다. 데이터 유형: 문자열
items.related.sys_object_source_info.소스_이름	관련 항목 정보의 데이터 소스입니다. 이 값은 구성 항목 [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
items.related.values	이 관련 항목에 대해 만들거나 업데이트할 필드를 이름/값 쌍으로 설명하는 객체입니다. 여기서 이름은 필드 이름입니다. 참조 필드의 경우 해당 값은 참조 필드여야 sys_id. 데이터 유형: 객체 필드 이름과 유형은 다음과 같이 사용자가 선택한 필드에 따라 달라집니다. `"values": { "host_name": "String", "ip_address": "String", "name": "String", "os_name": "String", "sys_class_name": "String" }`
items.settings	허용되는 업데이트 유형을 정의하는 매개변수를 포함하는 객체입니다. 데이터 유형: 객체 `"settings": { "skipReclassificationRestrictionRules": Boolean, "updateWithoutDowngrade": Boolean, "updateWithoutSwitch": Boolean, "updateWithoutUpgrade": Boolean }`
items.settings.skipReclassificationRestrictionRules	IRE가 페이로드 항목의 클래스와 일치하는 재분류 제한 규칙의 실행을 건너뛰어야 하는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. true: 규칙 실행을 건너뜁니다. false: 규칙을 실행합니다. 기본값: false
items.settings.updateWithoutDowngrade	이 CI에 대해 업데이트 및 다운그레이드가 모두 허용되는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. true: 항목을 업데이트하지만 다운그레이드는 허용되지 않습니다. false: 항목 업데이트와 다운그레이드가 모두 허용됩니다. 데이터 유형: 부울 기본값: false
items.settings.updateWithoutSwitch	이 CI를 업데이트하고 클래스를 전환할 수 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. true: 항목을 업데이트하지만 클래스 전환은 허용되지 않습니다. false: 항목 업데이트와 클래스 전환이 모두 허용됩니다. 데이터 유형: 부울 기본값: false
items.settings.updateWithoutUpgrade	이 CI에 대해 업데이트와 업그레이드가 모두 허용되는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. true: 항목을 업데이트하지만 업그레이드는 허용되지 않습니다. false: 항목 업데이트와 업그레이드가 모두 허용됩니다. 데이터 유형: 부울 기본값: 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.소스_피드	이 CI를 전송하는 피드를 식별하는 이름입니다. 소스에 여러 피드가 있을 수 있는 경우에 사용합니다. 데이터 유형: 문자열
items.sys_object_source_info.소스_이름	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
items.values	이 CI에 대해 만들거나 업데이트할 필드를 이름/값 쌍으로 설명하는 객체입니다. 여기서 이름은 필드 이름입니다. 참조 필드의 경우 해당 값은 참조 필드여야 sys_id. 데이터 유형: 객체 필드 이름과 유형은 다음과 같이 사용자가 선택한 필드에 따라 달라집니다. `"values": { "host_name": "String", "ip_address": "String", "name": "String", "os_name": "String", "sys_class_name": "String" }`
referenceItems (참조 항목)	페이로드의 두 항목 간 참조 목록입니다. 데이터 형식: 객체 배열 `"referenceItems": [ { "referenced": "String", "referencedBy": "String", "referenceField": "String" } ]`
referenceItems.referenced	internal_id 다른 항목에서 참조하는 항목에 대해 정의된 값입니다. 데이터 유형: 문자열
referenceItems.referencedBy	internal_id 다른 항목을 참조하는 항목에 대해 정의됩니다. 데이터 유형: 문자열
referenceItems.referenceField	항목의 클래스/테이블에 있는 참조 필드의 referencedBy 이름입니다. 데이터 유형: 문자열
관계	페이로드에 정의된 두 항목 간의 관계 목록입니다. 이 배열의 객체는 다음 두 형식 중 하나를 사용할 수 있습니다. 객체는 페이로드 items 배열의 항목 인덱스를 나타내는 값과 함께 및 child 이름-값 쌍을 사용하여 parent 두 개의 최상위 항목(전용) 간의 관계를 정의할 수 있습니다. 개체는 최상위 항목, 관련 항목 또는 조회 항목, 사용 parent_id 항목 및 child_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 관계의 하위 항목입니다. 데이터 유형: 문자열
관계.상위	관계의 상위를 나타내는 배열에 있는 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.소스_이름	검색 소스 이름입니다. 기본값: API 메서드 매개변수에 전달된 검색 소스입니다.
relations.sys_rel_source_info.소스_피드	검색 소스 내에서 하위 검색/검사에 해당하는 문자열입니다. 기본값: '알 수 없음'은 sys_rel_source 테이블에서 기록을 만들 때 source_feed 열에 저장됩니다.
관계.유형	상위 항목과 하위 항목 간에 존재하는 관계의 유형입니다. 이 값은 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를 처리하는 동안 발생한 오류 수입니다. 데이터 유형: 숫자
결과.additionalCommittedItems.errors	이 추가 CI를 처리하는 동안 발생한 오류 목록입니다. 데이터 형식: 객체 배열 `"errors": [ { "error": "String", "message": "String" } ]`
결과.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 식별 시도의 결과입니다. 가능한 값: MATCHED: 식별에 성공했습니다. 식별자 규칙 테이블에서 지정된 속성과 정확히 일치하는 고유 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에 대해 수행된 작업입니다. 가능한 값: DELETE: 기존 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" } ]`
결과.추가적으로커밋된항목.경고.오류	이 추가 CI를 처리하는 동안 발생한 경고의 유형입니다. 데이터 유형: 문자열
결과.추가적으로 커밋된 항목.경고.메시지	이 추가 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" } ]`
결과.추가적으로커밋된관계.오류.오류	이 추가 종속 관계 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에 대해 수행된 작업입니다. 가능한 값: INSERT: 종속 관계 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] ]`
결과.항목.오류 카운트	이 CI를 처리하는 동안 발생한 오류 수입니다. 데이터 유형: 숫자
결과.항목.오류	이 CI를 처리하는 동안 발생한 오류 목록입니다. 데이터 형식: 객체 배열 `"errors": [ { "error": "String", "message": "String" } ]`
결과.항목.오류.오류	이 CI를 처리하는 동안 발생한 오류의 유형입니다. 데이터 유형: 문자열
결과.항목.오류.메시지	이 CI를 처리하는 동안 발생한 오류 메시지입니다. 데이터 유형: 문자열
result.items.identificationAttempts	이 CI를 식별하기 위한 시도 목록입니다. 데이터 형식: 객체 배열 `"identificationAttempts": [ { "attemptResult": "String", "attributes": [Array], "hybridEntryCiAttributes": [Array], "identiferName": "String", "searchOnTable": [Array] } ]`
result.items.identificationAttempts.attemptResult	이 CI 식별 시도의 결과입니다. 가능한 값: MATCHED: 식별에 성공했습니다. 식별자 규칙 테이블에서 지정된 속성과 정확히 일치하는 고유 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.ruleSysId	일치하는 재분류 제한 규칙의 Sys_id입니다. IRE가 재분류 제한 규칙으로 인해 재분류를 건너뛰는 경우에만 적용할 수 있습니다. 페이로드 또는 전역 플래그로 인해 재분류를 건너뛰면 이 값이 비어 있습니다. 데이터 유형: 문자열
result.items.inputIndices	이 CI에 해당하는 요청 본문 items 배열의 CI 인덱스 값 목록입니다. 데이터 형식: 객체 배열 `"inputIndices": [ { Number } ]`
result.items.markers	내부용 마커 값 목록입니다. 데이터 유형: 배열 `"markers": []`
result.items.mergedPayloadIds	이 CI를 처리하는 동안 병합된 CMDB IRE 부분 페이로드[cmdb_ire_partial_payloads] 테이블의 부분 페이로드에 대한 sys_id 값 목록입니다. 데이터 유형: 배열 `"mergedPayloadIds": [ "String" ]`
result.items.operation	이 CI에 대해 수행된 작업입니다. 가능한 값: DELETE: 기존 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	CI에 대한 인덱스 값의 목록이며 요청 본문 itemsitems.lookup 의 항목과 이 관련 항목에 해당하는 배열을 조회합니다. 데이터 형식: 객체 배열 `"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.log컨텍스트 ID	이 페이로드에 대해 보고된 컨텍스트 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 관계 테이블. 데이터 유형: 문자열
결과.관계.오류 카운트	이 종속 관계 CI를 처리하는 동안 발생한 오류 수입니다. 데이터 유형: 숫자
결과.관계.오류	이 종속 관계 CI를 처리하는 동안 발생한 오류 목록입니다. 데이터 형식: 객체 배열 `"errors": [ { "error": "String", "message": "String" } ]`
결과.관계.오류.오류	이 종속 관계 CI를 처리하는 동안 발생한 오류의 유형입니다. 데이터 유형: 문자열
결과.관계.오류.메시지	이 종속 관계 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에 대해 수행된 작업입니다. 가능한 값: INSERT: 종속 관계 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가 업데이트되었습니다. 데이터 유형: 문자열
결과.관계.경고	이 종속 관계 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

지원되는 요청 매개변수

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

표 8. 쿼리 매개변수
이름	설명
옵션	요청에 적용된 향상된 IRE 옵션을 나타내는 이름-값 쌍의 쉼표로 구분된 목록입니다. 예를 들어, 부분 페이로드, 부분 커밋, 중복 페이로드 및 요약 강화된 IRE 옵션의 기본값을 재정의하려면 다음을 수행합니다. `partial_payloads : 아니오, partial_commits : 아니오, deduplicate_payloads : 아니오, generate_summary : 예` 주: 기본적으로 또는 true로 설정된 경우 partial_payloads false로 설정된 경우에도 이러한 기능은 부분 페이로드 기능에 필수적이므로 둘 다 partial_commits 활성화 deduplicate_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	이 페이로드의 이 항목에 대한 고유 식별자입니다. 모든 값이 될 수 있지만 페이로드 내에서 고유해야 합니다. 데이터 유형: 문자열
items.lookup	각 개체가 조회 기반 식별 기록을 설명하는 개체의 배열입니다. 이러한 기록은 구성 항목 [cmdb_ci] 테이블에 대한 참조가 있는 조회 테이블을 기반으로 최상위 구성 항목을 식별하는 데 사용됩니다. 데이터 형식: 배열 off Objects `"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.소스_피드	이 CI를 전송하는 피드를 식별하는 이름입니다. 소스에 여러 피드가 있을 수 있는 경우에 사용합니다. 데이터 유형: 문자열
items.lookup.sys_object_source_info.소스_이름	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
items.lookup.values	이 조회 항목의 필드를 이름/값 쌍으로 설명하는 객체입니다. 여기서 이름은 필드 이름입니다. 데이터 유형: 객체 필드 이름과 유형은 다음과 같이 사용자가 선택한 필드에 따라 달라집니다. `"values": { "ip_address": "String", "mac_address": "String", "serial_number": "String", "serial_number_type": "String", "valid": "String" }`
items.related	식별 중인 최상위 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.소스_피드	이 관련 항목을 보내는 피드를 고유하게 식별하는 이름입니다. 소스에 여러 피드가 있을 수 있는 경우에 사용합니다. 데이터 유형: 문자열
items.related.sys_object_source_info.소스_이름	관련 항목 정보의 데이터 소스입니다. 이 값은 구성 항목 [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
items.related.values	이 관련 항목에 대해 만들거나 업데이트할 필드를 이름/값 쌍으로 설명하는 객체입니다. 여기서 이름은 필드 이름입니다. 참조 필드의 경우 해당 값은 참조 필드여야 sys_id. 데이터 유형: 객체 필드 이름과 유형은 다음과 같이 사용자가 선택한 필드에 따라 달라집니다. `"values": { "host_name": "String", "ip_address": "String", "name": "String", "os_name": "String", "sys_class_name": "String" }`
items.settings	허용되는 업데이트 유형을 정의하는 매개변수를 포함하는 객체입니다. 데이터 유형: 객체 `"settings": { "skipReclassificationRestrictionRules": Boolean, "updateWithoutDowngrade": Boolean, "updateWithoutSwitch": Boolean, "updateWithoutUpgrade": Boolean }`
items.settings.skipReclassificationRestrictionRules	IRE가 페이로드 항목의 클래스와 일치하는 재분류 제한 규칙의 실행을 건너뛰어야 하는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. true: 규칙 실행을 건너뜁니다. false: 규칙을 실행합니다. 기본값: false
items.settings.updateWithoutDowngrade	이 CI에 대해 업데이트 및 다운그레이드가 모두 허용되는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. true: 항목을 업데이트하지만 다운그레이드는 허용되지 않습니다. false: 항목 업데이트와 다운그레이드가 모두 허용됩니다. 데이터 유형: 부울 기본값: false
items.settings.updateWithoutSwitch	이 CI를 업데이트하고 클래스를 전환할 수 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. true: 항목을 업데이트하지만 클래스 전환은 허용되지 않습니다. false: 항목 업데이트와 클래스 전환이 모두 허용됩니다. 데이터 유형: 부울 기본값: false
items.settings.updateWithoutUpgrade	이 CI에 대해 업데이트와 업그레이드가 모두 허용되는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. true: 항목을 업데이트하지만 업그레이드는 허용되지 않습니다. false: 항목 업데이트와 업그레이드가 모두 허용됩니다. 데이터 유형: 부울 기본값: 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.소스_피드	이 CI를 전송하는 피드를 식별하는 이름입니다. 소스에 여러 피드가 있을 수 있는 경우에 사용합니다. 데이터 유형: 문자열
items.sys_object_source_info.소스_이름	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
items.values	이 CI에 대해 만들거나 업데이트할 필드를 이름/값 쌍으로 설명하는 객체입니다. 여기서 이름은 필드 이름입니다. 참조 필드의 경우 해당 값은 참조 필드여야 sys_id. 데이터 유형: 객체 필드 이름과 유형은 다음과 같이 사용자가 선택한 필드에 따라 달라집니다. `"values": { "host_name": "String", "ip_address": "String", "name": "String", "os_name": "String", "sys_class_name": "String" }`
referenceItems (참조 항목)	페이로드의 두 항목 간 참조 목록입니다. 데이터 형식: 객체 배열 `"referenceItems": [ { "referenced": "String", "referencedBy": "String", "referenceField": "String" } ]`
referenceItems.referenced	internal_id 다른 항목에서 참조하는 항목에 대해 정의된 값입니다. 데이터 유형: 문자열
referenceItems.referencedBy	internal_id 다른 항목을 참조하는 항목에 대해 정의됩니다. 데이터 유형: 문자열
referenceItems.referenceField	항목의 클래스/테이블에 있는 참조 필드의 referencedBy 이름입니다. 데이터 유형: 문자열
관계	페이로드에 정의된 두 항목 간의 관계 목록입니다. 이 배열의 객체는 다음 두 형식 중 하나를 사용할 수 있습니다. 객체는 페이로드 items 배열의 항목 인덱스를 나타내는 값과 함께 및 child 이름-값 쌍을 사용하여 parent 두 개의 최상위 항목(전용) 간의 관계를 정의할 수 있습니다. 개체는 최상위 항목, 관련 항목 또는 조회 항목, 사용 parent_id 항목 및 child_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 관계의 하위 항목입니다. 데이터 유형: 문자열
관계.상위	관계의 상위를 나타내는 배열에 있는 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.소스_이름	검색 소스 이름입니다. 기본값: API 메서드 매개변수에 전달된 검색 소스입니다.
relations.sys_rel_source_info.소스_피드	검색 소스 내에서 하위 검색/검사에 해당하는 문자열입니다. 기본값: '알 수 없음'은 sys_rel_source 테이블에서 기록을 만들 때 source_feed 열에 저장됩니다.
관계.유형	상위 항목과 하위 항목 간에 존재하는 관계의 유형입니다. 이 값은 CI 관계 유형 [cmdb_rel_type] 테이블의 이름 필드 값이어야 합니다. 데이터 유형: 문자열

헤더

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

표 11. 응답 헤더
헤더	설명
없음

상태 코드

다음 상태 코드는 이 HTTP 작업에 적용됩니다. REST API에서 사용할 수 있는 상태 코드 목록은 REST API HTTP 응답 코드를 참조하세요.

표 12. 상태 코드
상태 코드	설명
200	성공입니다. 요청이 성공적으로 처리되었습니다.
401	승인되지 않았습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다.
500	내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 오류 메시지 detail "Chunk [...] is not a valid entry"는 쿼리 매개 변수가 올바른 이름-값 쌍 형식이 아님을 options 나타냅니다. 예를 들어 `partial` 매개 변수를 지정 options 하면 메시지 세부 정보에 "Chunk [partial] is not a valid entry"가 포함된 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를 처리하는 동안 발생한 오류 수입니다. 데이터 유형: 숫자
결과.additionalCommittedItems.errors	이 추가 CI를 처리하는 동안 발생한 오류 목록입니다. 데이터 형식: 객체 배열 `"errors": [ { "error": "String", "message": "String" } ]`
결과.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 식별 시도의 결과입니다. 가능한 값: MATCHED: 식별에 성공했습니다. 식별자 규칙 테이블에서 지정된 속성과 정확히 일치하는 고유 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에 대해 수행된 작업입니다. 가능한 값: DELETE: 기존 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" } ]`
결과.추가적으로커밋된항목.경고.오류	이 추가 CI를 처리하는 동안 발생한 경고의 유형입니다. 데이터 유형: 문자열
결과.추가적으로 커밋된 항목.경고.메시지	이 추가 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" } ]`
결과.추가적으로커밋된관계.오류.오류	이 추가 종속 관계 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에 대해 수행된 작업입니다. 가능한 값: INSERT: 종속 관계 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] ]`
결과.항목.오류 카운트	이 CI를 처리하는 동안 발생한 오류 수입니다. 데이터 유형: 숫자
결과.항목.오류	이 CI를 처리하는 동안 발생한 오류 목록입니다. 데이터 형식: 객체 배열 `"errors": [ { "error": "String", "message": "String" } ]`
결과.항목.오류.오류	이 CI를 처리하는 동안 발생한 오류의 유형입니다. 데이터 유형: 문자열
결과.항목.오류.메시지	이 CI를 처리하는 동안 발생한 오류 메시지입니다. 데이터 유형: 문자열
result.items.identificationAttempts	이 CI를 식별하기 위한 시도 목록입니다. 데이터 형식: 객체 배열 `"identificationAttempts": [ { "attemptResult": "String", "attributes": [Array], "hybridEntryCiAttributes": [Array], "identiferName": "String", "searchOnTable": [Array] } ]`
result.items.identificationAttempts.attemptResult	이 CI 식별 시도의 결과입니다. 가능한 값: MATCHED: 식별에 성공했습니다. 식별자 규칙 테이블에서 지정된 속성과 정확히 일치하는 고유 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.ruleSysId	일치하는 재분류 제한 규칙의 Sys_id입니다. IRE가 재분류 제한 규칙으로 인해 재분류를 건너뛰는 경우에만 적용할 수 있습니다. 페이로드 또는 전역 플래그로 인해 재분류를 건너뛰면 이 값이 비어 있습니다. 데이터 유형: 문자열
result.items.inputIndices	이 CI에 해당하는 요청 본문 items 배열의 CI 인덱스 값 목록입니다. 데이터 형식: 객체 배열 `"inputIndices": [ { Number } ]`
result.items.markers	내부용 마커 값 목록입니다. 데이터 유형: 배열 `"markers": []`
result.items.mergedPayloadIds	이 CI를 처리하는 동안 병합된 CMDB IRE 부분 페이로드[cmdb_ire_partial_payloads] 테이블의 부분 페이로드에 대한 sys_id 값 목록입니다. 데이터 유형: 배열 `"mergedPayloadIds": [ "String" ]`
result.items.operation	이 CI에 대해 수행된 작업입니다. 가능한 값: DELETE: 기존 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	CI에 대한 인덱스 값의 목록이며 요청 본문 itemsitems.lookup 의 항목과 이 관련 항목에 해당하는 배열을 조회합니다. 데이터 형식: 객체 배열 `"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.log컨텍스트 ID	이 페이로드에 대해 보고된 컨텍스트 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 관계 테이블. 데이터 유형: 문자열
결과.관계.오류 카운트	이 종속 관계 CI를 처리하는 동안 발생한 오류 수입니다. 데이터 유형: 숫자
결과.관계.오류	이 종속 관계 CI를 처리하는 동안 발생한 오류 목록입니다. 데이터 형식: 객체 배열 `"errors": [ { "error": "String", "message": "String" } ]`
결과.관계.오류.오류	이 종속 관계 CI를 처리하는 동안 발생한 오류의 유형입니다. 데이터 유형: 문자열
결과.관계.오류.메시지	이 종속 관계 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에 대해 수행된 작업입니다. 가능한 값: INSERT: 종속 관계 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가 업데이트되었습니다. 데이터 유형: 문자열
결과.관계.경고	이 종속 관계 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 부분 페이로드[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

지원되는 요청 매개변수

표 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	이 페이로드의 이 항목에 대한 고유 식별자입니다. 모든 값이 될 수 있지만 페이로드 내에서 고유해야 합니다. 데이터 유형: 문자열
items.lookup	각 개체가 조회 기반 식별 기록을 설명하는 개체의 배열입니다. 이러한 기록은 구성 항목 [cmdb_ci] 테이블에 대한 참조가 있는 조회 테이블을 기반으로 최상위 구성 항목을 식별하는 데 사용됩니다. 데이터 형식: 배열 off Objects `"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.소스_피드	이 CI를 전송하는 피드를 식별하는 이름입니다. 소스에 여러 피드가 있을 수 있는 경우에 사용합니다. 데이터 유형: 문자열
items.lookup.sys_object_source_info.소스_이름	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
items.lookup.values	이 조회 항목의 필드를 이름/값 쌍으로 설명하는 객체입니다. 여기서 이름은 필드 이름입니다. 데이터 유형: 객체 필드 이름과 유형은 다음과 같이 사용자가 선택한 필드에 따라 달라집니다. `"values": { "ip_address": "String", "mac_address": "String", "serial_number": "String", "serial_number_type": "String", "valid": "String" }`
items.related	식별 중인 최상위 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.소스_피드	이 관련 항목을 보내는 피드를 고유하게 식별하는 이름입니다. 소스에 여러 피드가 있을 수 있는 경우에 사용합니다. 데이터 유형: 문자열
items.related.sys_object_source_info.소스_이름	관련 항목 정보의 데이터 소스입니다. 이 값은 구성 항목 [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
items.related.values	이 관련 항목에 대해 만들거나 업데이트할 필드를 이름/값 쌍으로 설명하는 객체입니다. 여기서 이름은 필드 이름입니다. 참조 필드의 경우 해당 값은 참조 필드여야 sys_id. 데이터 유형: 객체 필드 이름과 유형은 다음과 같이 사용자가 선택한 필드에 따라 달라집니다. `"values": { "host_name": "String", "ip_address": "String", "name": "String", "os_name": "String", "sys_class_name": "String" }`
items.settings	허용되는 업데이트 유형을 정의하는 매개변수를 포함하는 객체입니다. 데이터 유형: 객체 `"settings": { "skipReclassificationRestrictionRules": Boolean, "updateWithoutDowngrade": Boolean, "updateWithoutSwitch": Boolean, "updateWithoutUpgrade": Boolean }`
items.settings.skipReclassificationRestrictionRules	IRE가 페이로드 항목의 클래스와 일치하는 재분류 제한 규칙의 실행을 건너뛰어야 하는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. true: 규칙 실행을 건너뜁니다. false: 규칙을 실행합니다. 기본값: false
items.settings.updateWithoutDowngrade	이 CI에 대해 업데이트 및 다운그레이드가 모두 허용되는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. true: 항목을 업데이트하지만 다운그레이드는 허용되지 않습니다. false: 항목 업데이트와 다운그레이드가 모두 허용됩니다. 데이터 유형: 부울 기본값: false
items.settings.updateWithoutSwitch	이 CI를 업데이트하고 클래스를 전환할 수 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. true: 항목을 업데이트하지만 클래스 전환은 허용되지 않습니다. false: 항목 업데이트와 클래스 전환이 모두 허용됩니다. 데이터 유형: 부울 기본값: false
items.settings.updateWithoutUpgrade	이 CI에 대해 업데이트와 업그레이드가 모두 허용되는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. true: 항목을 업데이트하지만 업그레이드는 허용되지 않습니다. false: 항목 업데이트와 업그레이드가 모두 허용됩니다. 데이터 유형: 부울 기본값: 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.소스_피드	이 CI를 전송하는 피드를 식별하는 이름입니다. 소스에 여러 피드가 있을 수 있는 경우에 사용합니다. 데이터 유형: 문자열
items.sys_object_source_info.소스_이름	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
items.values	이 CI에 대해 만들거나 업데이트할 필드를 이름/값 쌍으로 설명하는 객체입니다. 여기서 이름은 필드 이름입니다. 참조 필드의 경우 해당 값은 참조 필드여야 sys_id. 데이터 유형: 객체 필드 이름과 유형은 다음과 같이 사용자가 선택한 필드에 따라 달라집니다. `"values": { "host_name": "String", "ip_address": "String", "name": "String", "os_name": "String", "sys_class_name": "String" }`
referenceItems (참조 항목)	페이로드의 두 항목 간 참조 목록입니다. 데이터 형식: 객체 배열 `"referenceItems": [ { "referenced": "String", "referencedBy": "String", "referenceField": "String" } ]`
referenceItems.referenced	internal_id 다른 항목에서 참조하는 항목에 대해 정의된 값입니다. 데이터 유형: 문자열
referenceItems.referencedBy	internal_id 다른 항목을 참조하는 항목에 대해 정의됩니다. 데이터 유형: 문자열
referenceItems.referenceField	항목의 클래스/테이블에 있는 참조 필드의 referencedBy 이름입니다. 데이터 유형: 문자열
관계	페이로드에 정의된 두 항목 간의 관계 목록입니다. 이 배열의 객체는 다음 두 형식 중 하나를 사용할 수 있습니다. 객체는 페이로드 items 배열의 항목 인덱스를 나타내는 값과 함께 및 child 이름-값 쌍을 사용하여 parent 두 개의 최상위 항목(전용) 간의 관계를 정의할 수 있습니다. 개체는 최상위 항목, 관련 항목 또는 조회 항목, 사용 parent_id 항목 및 child_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 관계의 하위 항목입니다. 데이터 유형: 문자열
관계.상위	관계의 상위를 나타내는 배열에 있는 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.소스_이름	검색 소스 이름입니다. 기본값: API 메서드 매개변수에 전달된 검색 소스입니다.
relations.sys_rel_source_info.소스_피드	검색 소스 내에서 하위 검색/검사에 해당하는 문자열입니다. 기본값: '알 수 없음'은 sys_rel_source 테이블에서 기록을 만들 때 source_feed 열에 저장됩니다.
관계.유형	상위 항목과 하위 항목 간에 존재하는 관계의 유형입니다. 이 값은 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를 처리하는 동안 발생한 오류 수입니다. 데이터 유형: 숫자
결과.additionalCommittedItems.errors	이 추가 CI를 처리하는 동안 발생한 오류 목록입니다. 데이터 형식: 객체 배열 `"errors": [ { "error": "String", "message": "String" } ]`
결과.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 식별 시도의 결과입니다. 가능한 값: MATCHED: 식별에 성공했습니다. 식별자 규칙 테이블에서 지정된 속성과 정확히 일치하는 고유 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에 대해 수행된 작업입니다. 가능한 값: DELETE: 기존 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" } ]`
결과.추가적으로커밋된항목.경고.오류	이 추가 CI를 처리하는 동안 발생한 경고의 유형입니다. 데이터 유형: 문자열
결과.추가적으로 커밋된 항목.경고.메시지	이 추가 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" } ]`
결과.추가적으로커밋된관계.오류.오류	이 추가 종속 관계 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에 대해 수행된 작업입니다. 가능한 값: INSERT: 종속 관계 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] ]`
결과.항목.오류 카운트	이 CI를 처리하는 동안 발생한 오류 수입니다. 데이터 유형: 숫자
결과.항목.오류	이 CI를 처리하는 동안 발생한 오류 목록입니다. 데이터 형식: 객체 배열 `"errors": [ { "error": "String", "message": "String" } ]`
결과.항목.오류.오류	이 CI를 처리하는 동안 발생한 오류의 유형입니다. 데이터 유형: 문자열
결과.항목.오류.메시지	이 CI를 처리하는 동안 발생한 오류 메시지입니다. 데이터 유형: 문자열
result.items.identificationAttempts	이 CI를 식별하기 위한 시도 목록입니다. 데이터 형식: 객체 배열 `"identificationAttempts": [ { "attemptResult": "String", "attributes": [Array], "hybridEntryCiAttributes": [Array], "identiferName": "String", "searchOnTable": [Array] } ]`
result.items.identificationAttempts.attemptResult	이 CI 식별 시도의 결과입니다. 가능한 값: MATCHED: 식별에 성공했습니다. 식별자 규칙 테이블에서 지정된 속성과 정확히 일치하는 고유 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.ruleSysId	일치하는 재분류 제한 규칙의 Sys_id입니다. IRE가 재분류 제한 규칙으로 인해 재분류를 건너뛰는 경우에만 적용할 수 있습니다. 페이로드 또는 전역 플래그로 인해 재분류를 건너뛰면 이 값이 비어 있습니다. 데이터 유형: 문자열
result.items.inputIndices	이 CI에 해당하는 요청 본문 items 배열의 CI 인덱스 값 목록입니다. 데이터 형식: 객체 배열 `"inputIndices": [ { Number } ]`
result.items.markers	내부용 마커 값 목록입니다. 데이터 유형: 배열 `"markers": []`
result.items.mergedPayloadIds	이 CI를 처리하는 동안 병합된 CMDB IRE 부분 페이로드[cmdb_ire_partial_payloads] 테이블의 부분 페이로드에 대한 sys_id 값 목록입니다. 데이터 유형: 배열 `"mergedPayloadIds": [ "String" ]`
result.items.operation	이 CI에 대해 수행된 작업입니다. 가능한 값: DELETE: 기존 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	CI에 대한 인덱스 값의 목록이며 요청 본문 itemsitems.lookup 의 항목과 이 관련 항목에 해당하는 배열을 조회합니다. 데이터 형식: 객체 배열 `"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.log컨텍스트 ID	이 페이로드에 대해 보고된 컨텍스트 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 관계 테이블. 데이터 유형: 문자열
결과.관계.오류 카운트	이 종속 관계 CI를 처리하는 동안 발생한 오류 수입니다. 데이터 유형: 숫자
결과.관계.오류	이 종속 관계 CI를 처리하는 동안 발생한 오류 목록입니다. 데이터 형식: 객체 배열 `"errors": [ { "error": "String", "message": "String" } ]`
결과.관계.오류.오류	이 종속 관계 CI를 처리하는 동안 발생한 오류의 유형입니다. 데이터 유형: 문자열
결과.관계.오류.메시지	이 종속 관계 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에 대해 수행된 작업입니다. 가능한 값: INSERT: 종속 관계 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가 업데이트되었습니다. 데이터 유형: 문자열
결과.관계.경고	이 종속 관계 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

지원되는 요청 매개변수

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

표 20. 쿼리 매개변수
이름	설명
옵션	요청에 적용된 향상된 IRE 옵션을 나타내는 이름-값 쌍의 쉼표로 구분된 목록입니다. 예를 들어, 부분 페이로드, 부분 커밋, 중복 페이로드 및 요약 강화된 IRE 옵션의 기본값을 재정의하려면 다음을 수행합니다. `partial_payloads : 아니오, partial_commits : 아니오, deduplicate_payloads : 아니오, generate_summary : 예` 주: 기본적으로 또는 true로 설정된 경우 partial_payloads false로 설정된 경우에도 이러한 기능은 부분 페이로드 기능에 필수적이므로 둘 다 partial_commits 활성화 deduplicate_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	이 페이로드의 이 항목에 대한 고유 식별자입니다. 모든 값이 될 수 있지만 페이로드 내에서 고유해야 합니다. 데이터 유형: 문자열
items.lookup	각 개체가 조회 기반 식별 기록을 설명하는 개체의 배열입니다. 이러한 기록은 구성 항목 [cmdb_ci] 테이블에 대한 참조가 있는 조회 테이블을 기반으로 최상위 구성 항목을 식별하는 데 사용됩니다. 데이터 형식: 배열 off Objects `"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.소스_피드	이 CI를 전송하는 피드를 식별하는 이름입니다. 소스에 여러 피드가 있을 수 있는 경우에 사용합니다. 데이터 유형: 문자열
items.lookup.sys_object_source_info.소스_이름	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
items.lookup.values	이 조회 항목의 필드를 이름/값 쌍으로 설명하는 객체입니다. 여기서 이름은 필드 이름입니다. 데이터 유형: 객체 필드 이름과 유형은 다음과 같이 사용자가 선택한 필드에 따라 달라집니다. `"values": { "ip_address": "String", "mac_address": "String", "serial_number": "String", "serial_number_type": "String", "valid": "String" }`
items.related	식별 중인 최상위 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.소스_피드	이 관련 항목을 보내는 피드를 고유하게 식별하는 이름입니다. 소스에 여러 피드가 있을 수 있는 경우에 사용합니다. 데이터 유형: 문자열
items.related.sys_object_source_info.소스_이름	관련 항목 정보의 데이터 소스입니다. 이 값은 구성 항목 [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
items.related.values	이 관련 항목에 대해 만들거나 업데이트할 필드를 이름/값 쌍으로 설명하는 객체입니다. 여기서 이름은 필드 이름입니다. 참조 필드의 경우 해당 값은 참조 필드여야 sys_id. 데이터 유형: 객체 필드 이름과 유형은 다음과 같이 사용자가 선택한 필드에 따라 달라집니다. `"values": { "host_name": "String", "ip_address": "String", "name": "String", "os_name": "String", "sys_class_name": "String" }`
items.settings	허용되는 업데이트 유형을 정의하는 매개변수를 포함하는 객체입니다. 데이터 유형: 객체 `"settings": { "skipReclassificationRestrictionRules": Boolean, "updateWithoutDowngrade": Boolean, "updateWithoutSwitch": Boolean, "updateWithoutUpgrade": Boolean }`
items.settings.skipReclassificationRestrictionRules	IRE가 페이로드 항목의 클래스와 일치하는 재분류 제한 규칙의 실행을 건너뛰어야 하는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. true: 규칙 실행을 건너뜁니다. false: 규칙을 실행합니다. 기본값: false
items.settings.updateWithoutDowngrade	이 CI에 대해 업데이트 및 다운그레이드가 모두 허용되는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. true: 항목을 업데이트하지만 다운그레이드는 허용되지 않습니다. false: 항목 업데이트와 다운그레이드가 모두 허용됩니다. 데이터 유형: 부울 기본값: false
items.settings.updateWithoutSwitch	이 CI를 업데이트하고 클래스를 전환할 수 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. true: 항목을 업데이트하지만 클래스 전환은 허용되지 않습니다. false: 항목 업데이트와 클래스 전환이 모두 허용됩니다. 데이터 유형: 부울 기본값: false
items.settings.updateWithoutUpgrade	이 CI에 대해 업데이트와 업그레이드가 모두 허용되는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. true: 항목을 업데이트하지만 업그레이드는 허용되지 않습니다. false: 항목 업데이트와 업그레이드가 모두 허용됩니다. 데이터 유형: 부울 기본값: 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.소스_피드	이 CI를 전송하는 피드를 식별하는 이름입니다. 소스에 여러 피드가 있을 수 있는 경우에 사용합니다. 데이터 유형: 문자열
items.sys_object_source_info.소스_이름	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
items.values	이 CI에 대해 만들거나 업데이트할 필드를 이름/값 쌍으로 설명하는 객체입니다. 여기서 이름은 필드 이름입니다. 참조 필드의 경우 해당 값은 참조 필드여야 sys_id. 데이터 유형: 객체 필드 이름과 유형은 다음과 같이 사용자가 선택한 필드에 따라 달라집니다. `"values": { "host_name": "String", "ip_address": "String", "name": "String", "os_name": "String", "sys_class_name": "String" }`
referenceItems (참조 항목)	페이로드의 두 항목 간 참조 목록입니다. 데이터 형식: 객체 배열 `"referenceItems": [ { "referenced": "String", "referencedBy": "String", "referenceField": "String" } ]`
referenceItems.referenced	internal_id 다른 항목에서 참조하는 항목에 대해 정의된 값입니다. 데이터 유형: 문자열
referenceItems.referencedBy	internal_id 다른 항목을 참조하는 항목에 대해 정의됩니다. 데이터 유형: 문자열
referenceItems.referenceField	항목의 클래스/테이블에 있는 참조 필드의 referencedBy 이름입니다. 데이터 유형: 문자열
관계	페이로드에 정의된 두 항목 간의 관계 목록입니다. 이 배열의 객체는 다음 두 형식 중 하나를 사용할 수 있습니다. 객체는 페이로드 items 배열의 항목 인덱스를 나타내는 값과 함께 및 child 이름-값 쌍을 사용하여 parent 두 개의 최상위 항목(전용) 간의 관계를 정의할 수 있습니다. 개체는 최상위 항목, 관련 항목 또는 조회 항목, 사용 parent_id 항목 및 child_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 관계의 하위 항목입니다. 데이터 유형: 문자열
관계.상위	관계의 상위를 나타내는 배열에 있는 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.소스_이름	검색 소스 이름입니다. 기본값: API 메서드 매개변수에 전달된 검색 소스입니다.
relations.sys_rel_source_info.소스_피드	검색 소스 내에서 하위 검색/검사에 해당하는 문자열입니다. 기본값: '알 수 없음'은 sys_rel_source 테이블에서 기록을 만들 때 source_feed 열에 저장됩니다.
관계.유형	상위 항목과 하위 항목 간에 존재하는 관계의 유형입니다. 이 값은 CI 관계 유형 [cmdb_rel_type] 테이블의 이름 필드 값이어야 합니다. 데이터 유형: 문자열

헤더

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

표 23. 응답 헤더
헤더	설명
없음

상태 코드

다음 상태 코드는 이 HTTP 작업에 적용됩니다. REST API에서 사용할 수 있는 상태 코드 목록은 REST API HTTP 응답 코드를 참조하세요.

표 24. 상태 코드
상태 코드	설명
200	성공입니다. 요청이 성공적으로 처리되었습니다.
401	승인되지 않았습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다.
500	내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 오류 메시지 detail "Chunk [...] is not a valid entry"는 쿼리 매개 변수가 올바른 이름-값 쌍 형식이 아님을 options 나타냅니다. 예를 들어 `partial` 매개 변수를 지정 options 하면 메시지 세부 정보에 "Chunk [partial] is not a valid entry"가 포함된 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를 처리하는 동안 발생한 오류 수입니다. 데이터 유형: 숫자
결과.additionalCommittedItems.errors	이 추가 CI를 처리하는 동안 발생한 오류 목록입니다. 데이터 형식: 객체 배열 `"errors": [ { "error": "String", "message": "String" } ]`
결과.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 식별 시도의 결과입니다. 가능한 값: MATCHED: 식별에 성공했습니다. 식별자 규칙 테이블에서 지정된 속성과 정확히 일치하는 고유 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에 대해 수행된 작업입니다. 가능한 값: DELETE: 기존 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" } ]`
결과.추가적으로커밋된항목.경고.오류	이 추가 CI를 처리하는 동안 발생한 경고의 유형입니다. 데이터 유형: 문자열
결과.추가적으로 커밋된 항목.경고.메시지	이 추가 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" } ]`
결과.추가적으로커밋된관계.오류.오류	이 추가 종속 관계 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에 대해 수행된 작업입니다. 가능한 값: INSERT: 종속 관계 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] ]`
결과.항목.오류 카운트	이 CI를 처리하는 동안 발생한 오류 수입니다. 데이터 유형: 숫자
결과.항목.오류	이 CI를 처리하는 동안 발생한 오류 목록입니다. 데이터 형식: 객체 배열 `"errors": [ { "error": "String", "message": "String" } ]`
결과.항목.오류.오류	이 CI를 처리하는 동안 발생한 오류의 유형입니다. 데이터 유형: 문자열
결과.항목.오류.메시지	이 CI를 처리하는 동안 발생한 오류 메시지입니다. 데이터 유형: 문자열
result.items.identificationAttempts	이 CI를 식별하기 위한 시도 목록입니다. 데이터 형식: 객체 배열 `"identificationAttempts": [ { "attemptResult": "String", "attributes": [Array], "hybridEntryCiAttributes": [Array], "identiferName": "String", "searchOnTable": [Array] } ]`
result.items.identificationAttempts.attemptResult	이 CI 식별 시도의 결과입니다. 가능한 값: MATCHED: 식별에 성공했습니다. 식별자 규칙 테이블에서 지정된 속성과 정확히 일치하는 고유 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.ruleSysId	일치하는 재분류 제한 규칙의 Sys_id입니다. IRE가 재분류 제한 규칙으로 인해 재분류를 건너뛰는 경우에만 적용할 수 있습니다. 페이로드 또는 전역 플래그로 인해 재분류를 건너뛰면 이 값이 비어 있습니다. 데이터 유형: 문자열
result.items.inputIndices	이 CI에 해당하는 요청 본문 items 배열의 CI 인덱스 값 목록입니다. 데이터 형식: 객체 배열 `"inputIndices": [ { Number } ]`
result.items.markers	내부용 마커 값 목록입니다. 데이터 유형: 배열 `"markers": []`
result.items.mergedPayloadIds	이 CI를 처리하는 동안 병합된 CMDB IRE 부분 페이로드[cmdb_ire_partial_payloads] 테이블의 부분 페이로드에 대한 sys_id 값 목록입니다. 데이터 유형: 배열 `"mergedPayloadIds": [ "String" ]`
result.items.operation	이 CI에 대해 수행된 작업입니다. 가능한 값: DELETE: 기존 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	CI에 대한 인덱스 값의 목록이며 요청 본문 itemsitems.lookup 의 항목과 이 관련 항목에 해당하는 배열을 조회합니다. 데이터 형식: 객체 배열 `"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.log컨텍스트 ID	이 페이로드에 대해 보고된 컨텍스트 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 관계 테이블. 데이터 유형: 문자열
결과.관계.오류 카운트	이 종속 관계 CI를 처리하는 동안 발생한 오류 수입니다. 데이터 유형: 숫자
결과.관계.오류	이 종속 관계 CI를 처리하는 동안 발생한 오류 목록입니다. 데이터 형식: 객체 배열 `"errors": [ { "error": "String", "message": "String" } ]`
결과.관계.오류.오류	이 종속 관계 CI를 처리하는 동안 발생한 오류의 유형입니다. 데이터 유형: 문자열
결과.관계.오류.메시지	이 종속 관계 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에 대해 수행된 작업입니다. 가능한 값: INSERT: 종속 관계 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가 업데이트되었습니다. 데이터 유형: 문자열
결과.관계.경고	이 종속 관계 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 부분 페이로드[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
      }
    }
  }
}