---
sourceDocument: 호주 API 참조
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/api-reference

 Release :

    - australia

ft:locale :

    - ko-KR

ft:publication_title :

    - 호주 API 참조

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# 식별 및 조정 API

# 식별 및 조정 API {#ariaid-title1}

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

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

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

IRE에 대한 자세한 내용은 [IRE(식별 및 조정 엔진)](https://www.servicenow.com/docs/access?context=ire&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US)를 참조하십시오.

## 식별 및 조정 - POST /now/identifyreconcile {#ariaid-title2}

지정된 페이로드(요청 본문)에 식별 및 조정 규칙을 적용하여 CI CMDB (구성 항목)를 삽입하거나 업데이트합니다. 직접 업데이트 CMDB 하는 대신 이 API를 사용합니다.
엔드포인트를 [식별 및 조정 - POST /now/identifyreconcile/query](https://servicenow-prod.fluidtopics.net/yIGus2a7Es7YdDrXFirzvg#identifyreconcile-POST-query "데이터베이스에서 CMDB 작업을 커밋하지 않고 지정된 페이로드(요청 본문)로 수행할 작업(삽입/업데이트)을 결정합니다.") 사용하여 데이터베이스에 대한 변경 내용을 커밋하지 않고 이 엔드포인트에 페이로드 제출을 시뮬레이션합니다.

향상된 IRE 옵션을 지정해야 하는 경우 엔드포인트를 [식별 및 조정 - POST /now/identifyreconcile/enhanced](https://servicenow-prod.fluidtopics.net/yIGus2a7Es7YdDrXFirzvg#identifyreconcile-POST-enhanced "지정된 페이로드(요청 본문)에 식별 및 조정 규칙을 적용하여 CI CMDB (구성 항목)를 삽입하거나 업데이트합니다. 직접 업데이트 CMDB 하는 대신 이 API를 사용합니다.") 대신 사용합니다. 향상된 IRE 옵션에 대한 자세한 내용은 [IRE(식별 및 조정 엔진)](https://www.servicenow.com/docs/access?context=ire&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US)를 참조하십시오.

### URL 형식

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

기본 URL: /api/now/identifyreconcile  
주:  
사용 가능한 버전은 [REST API 탐색기에](https://servicenow-prod.fluidtopics.net/arCv9b3UPYvLylUnDh9RpQ "이 튜토리얼에서는 REST API 탐색기를 사용하여 REST API를 테스트합니다 ServiceNow .") 지정됩니다. 스크립트 기반 REST API의 경우 [스크립트 기반 REST 서비스 양식](https://servicenow-prod.fluidtopics.net/vfCIdYdXpX8Ltk8_R7WfkA "스크립팅된 REST API 기능을 사용하면 애플리케이션 개발자가 사용자 지정 웹 서비스 API를 빌드할 수 있습니다.")에 추가 버전 정보가 있습니다.

### 지원되는 요청 매개변수

{#identifyreconcile-POST__entry__2}{#identifyreconcile-POST__version-not_optional-RESTAPI}

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

{#identifyreconcile-POST__entry__6}

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

{#identifyreconcile-POST__entry__10}{#identifyreconcile-POST__input_rel_sys_rel_source_info-row-IRE}{#identifyreconcile-POST__input-relations-sys_rel_source_info-source_name-row-IRE}{#identifyreconcile-POST__input-relations-sys_rel_source_info-source_feed-row-IRE}

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

### 헤더

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#identifyreconcile-POST__entry__102}{#identifyreconcile-POST__accept-JSON-only-entry-RESTAPI}{#identifyreconcile-POST__content_type-JSON-only-entry-RESTAPI}

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

{#identifyreconcile-POST__entry__108}

| 머리글 | 설명 |
|-|-|
| 안 함 |   |
[표 5. 응답 헤더]

### 상태 코드

이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#identifyreconcile-POST__entry__112}{#identifyreconcile-POST__entry-200-status-code}{#identifyreconcile-POST__entry-401-status-code}{#identifyreconcile-POST__entry-500-status-code}

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

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

{#identifyreconcile-POST__entry__120}{#identifyreconcile-POST__items_info-entry-IRE}{#identifyreconcile-POST__items_info_code-entry-IRE}{#identifyreconcile-POST__items_info_message-entry-IRE}{#identifyreconcile-POST__items_info_ruleSysId-entry-IRE}

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

지정된 페이로드(요청 본문)에 식별 및 조정 규칙을 적용하여 CI CMDB (구성 항목)를 삽입하거나 업데이트합니다. 직접 업데이트 CMDB 하는 대신 이 API를 사용합니다.
엔드포인트를 [식별 및 조정 - POST /now/identifyreconcile/queryEnhanced](https://servicenow-prod.fluidtopics.net/yIGus2a7Es7YdDrXFirzvg#identifyreconcile-POST-queryenhanced "데이터베이스에서 CMDB 작업을 커밋하지 않고 지정된 페이로드(요청 본문)로 수행할 작업(삽입/업데이트)을 결정합니다.") 사용하여 데이터베이스에 대한 변경 내용을 커밋하지 않고 이 엔드포인트에 페이로드 제출을 시뮬레이션합니다.  
이 메서드는 메서드와 [식별 및 조정 - POST /now/identifyreconcile](https://servicenow-prod.fluidtopics.net/yIGus2a7Es7YdDrXFirzvg#identifyreconcile-POST "지정된 페이로드(요청 본문)에 식별 및 조정 규칙을 적용하여 CI CMDB (구성 항목)를 삽입하거나 업데이트합니다. 직접 업데이트 CMDB 하는 대신 이 API를 사용합니다.") 비슷하지만 다음 기능을 추가합니다.

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

### URL 형식

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

기본 URL: /api/now/identifyreconcile/enhanced  
주:  
사용 가능한 버전은 [REST API 탐색기에](https://servicenow-prod.fluidtopics.net/arCv9b3UPYvLylUnDh9RpQ "이 튜토리얼에서는 REST API 탐색기를 사용하여 REST API를 테스트합니다 ServiceNow .") 지정됩니다. 스크립트 기반 REST API의 경우 [스크립트 기반 REST 서비스 양식](https://servicenow-prod.fluidtopics.net/vfCIdYdXpX8Ltk8_R7WfkA "스크립팅된 REST API 기능을 사용하면 애플리케이션 개발자가 사용자 지정 웹 서비스 API를 빌드할 수 있습니다.")에 추가 버전 정보가 있습니다.

### 지원되는 요청 매개변수

{#identifyreconcile-POST-enhanced__entry__2}{#identifyreconcile-POST-enhanced__version-not_optional-RESTAPI}

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

{#identifyreconcile-POST-enhanced__entry__6}

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

{#identifyreconcile-POST-enhanced__table_idz_wyn_rlb__entry__2}{#identifyreconcile-POST-enhanced__input_rel_sys_rel_source_info-row-IRE}{#identifyreconcile-POST-enhanced__input-relations-sys_rel_source_info-source_name-row-IRE}{#identifyreconcile-POST-enhanced__input-relations-sys_rel_source_info-source_feed-row-IRE}

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

{#identifyreconcile-POST-enhanced__table_idz_wyn_rlb}

### 헤더

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#identifyreconcile-POST-enhanced__entry__104}{#identifyreconcile-POST-enhanced__accept-JSON-only-entry-RESTAPI}{#identifyreconcile-POST-enhanced__content_type-JSON-only-entry-RESTAPI}

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

{#identifyreconcile-POST-enhanced__entry__110}

| 머리글 | 설명 |
|-|-|
| 안 함 |   |
[표 11. 응답 헤더]

### 상태 코드

이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#identifyreconcile-POST-enhanced__entry__114}{#identifyreconcile-POST-enhanced__entry-200-status-code}{#identifyreconcile-POST-enhanced__entry-401-status-code}

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

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

{#identifyreconcile-POST-enhanced__table_mr2_yyn_rlb__entry__2}{#identifyreconcile-POST-enhanced__items_info-entry-IRE}{#identifyreconcile-POST-enhanced__items_info_code-entry-IRE}{#identifyreconcile-POST-enhanced__items_info_message-entry-IRE}{#identifyreconcile-POST-enhanced__items_info_ruleSysId-entry-IRE}

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

{#identifyreconcile-POST-enhanced__table_mr2_yyn_rlb}  

### cURL 요청

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

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

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

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

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

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

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

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

## 식별 및 조정 - POST /now/identifyreconcile/query {#ariaid-title4}

데이터베이스에서 CMDB 작업을 커밋하지 않고 지정된 페이로드(요청 본문)로 수행할 작업(삽입/업데이트)을 결정합니다.
이 엔드포인트를 사용하여 엔드포인트에 대한 페이로드(요청 본문) 제출을 시뮬레이션합니다.[식별 및 조정 - POST /now/identifyreconcile](https://servicenow-prod.fluidtopics.net/yIGus2a7Es7YdDrXFirzvg#identifyreconcile-POST "지정된 페이로드(요청 본문)에 식별 및 조정 규칙을 적용하여 CI CMDB (구성 항목)를 삽입하거나 업데이트합니다. 직접 업데이트 CMDB 하는 대신 이 API를 사용합니다.")

향상된 IRE 옵션을 지정해야 하는 경우 엔드포인트를 [식별 및 조정 - POST /now/identifyreconcile/enhanced](https://servicenow-prod.fluidtopics.net/yIGus2a7Es7YdDrXFirzvg#identifyreconcile-POST-enhanced "지정된 페이로드(요청 본문)에 식별 및 조정 규칙을 적용하여 CI CMDB (구성 항목)를 삽입하거나 업데이트합니다. 직접 업데이트 CMDB 하는 대신 이 API를 사용합니다.") 대신 사용합니다. 향상된 IRE 옵션에 대한 자세한 내용은 [IRE(식별 및 조정 엔진)](https://www.servicenow.com/docs/access?context=ire&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US)를 참조하십시오.

### URL 형식

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

기본 URL: /api/now/identifyreconcile/query  
주:  
사용 가능한 버전은 [REST API 탐색기에](https://servicenow-prod.fluidtopics.net/arCv9b3UPYvLylUnDh9RpQ "이 튜토리얼에서는 REST API 탐색기를 사용하여 REST API를 테스트합니다 ServiceNow .") 지정됩니다. 스크립트 기반 REST API의 경우 [스크립트 기반 REST 서비스 양식](https://servicenow-prod.fluidtopics.net/vfCIdYdXpX8Ltk8_R7WfkA "스크립팅된 REST API 기능을 사용하면 애플리케이션 개발자가 사용자 지정 웹 서비스 API를 빌드할 수 있습니다.")에 추가 버전 정보가 있습니다.

### 지원되는 요청 매개변수

{#identifyreconcile-POST-query__entry__2}{#identifyreconcile-POST-query__version-not_optional-RESTAPI}

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

{#identifyreconcile-POST-query__entry__6}

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

{#identifyreconcile-POST-query__entry__10}{#identifyreconcile-POST-query__input_rel_sys_rel_source_info-row-IRE}{#identifyreconcile-POST-query__input-relations-sys_rel_source_info-source_name-row-IRE}{#identifyreconcile-POST-query__input-relations-sys_rel_source_info-source_feed-row-IRE}

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

### 헤더

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#identifyreconcile-POST-query__entry__102}{#identifyreconcile-POST-query__accept-JSON-only-entry-RESTAPI}{#identifyreconcile-POST-query__content_type-JSON-only-entry-RESTAPI}

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

{#identifyreconcile-POST-query__entry__108}

| 머리글 | 설명 |
|-|-|
| 안 함 |   |
[표 17. 응답 헤더]

### 상태 코드

이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#identifyreconcile-POST-query__entry__112}{#identifyreconcile-POST-query__entry-200-status-code}{#identifyreconcile-POST-query__entry-401-status-code}{#identifyreconcile-POST-query__entry-500-status-code}

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

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

{#identifyreconcile-POST-query__entry__120}{#identifyreconcile-POST-query__items_info-entry-IRE}{#identifyreconcile-POST-query__items_info_code-entry-IRE}{#identifyreconcile-POST-query__items_info_message-entry-IRE}{#identifyreconcile-POST-query__items_info_ruleSysId-entry-IRE}

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

데이터베이스에서 CMDB 작업을 커밋하지 않고 지정된 페이로드(요청 본문)로 수행할 작업(삽입/업데이트)을 결정합니다.
이 엔드포인트를 사용하여 엔드포인트에 대한 페이로드(요청 본문) 제출을 시뮬레이션합니다.[식별 및 조정 - POST /now/identifyreconcile/enhanced](https://servicenow-prod.fluidtopics.net/yIGus2a7Es7YdDrXFirzvg#identifyreconcile-POST-enhanced "지정된 페이로드(요청 본문)에 식별 및 조정 규칙을 적용하여 CI CMDB (구성 항목)를 삽입하거나 업데이트합니다. 직접 업데이트 CMDB 하는 대신 이 API를 사용합니다.")  
이 메서드는 메서드와 [식별 및 조정 - POST /now/identifyreconcile/query](https://servicenow-prod.fluidtopics.net/yIGus2a7Es7YdDrXFirzvg#identifyreconcile-POST-query "데이터베이스에서 CMDB 작업을 커밋하지 않고 지정된 페이로드(요청 본문)로 수행할 작업(삽입/업데이트)을 결정합니다.") 비슷하지만 다음 기능을 추가합니다.

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

### URL 형식

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

기본 URL: /api/now/identifyreconcile/queryEnhanced  
주:  
사용 가능한 버전은 [REST API 탐색기에](https://servicenow-prod.fluidtopics.net/arCv9b3UPYvLylUnDh9RpQ "이 튜토리얼에서는 REST API 탐색기를 사용하여 REST API를 테스트합니다 ServiceNow .") 지정됩니다. 스크립트 기반 REST API의 경우 [스크립트 기반 REST 서비스 양식](https://servicenow-prod.fluidtopics.net/vfCIdYdXpX8Ltk8_R7WfkA "스크립팅된 REST API 기능을 사용하면 애플리케이션 개발자가 사용자 지정 웹 서비스 API를 빌드할 수 있습니다.")에 추가 버전 정보가 있습니다.

### 지원되는 요청 매개변수

{#identifyreconcile-POST-queryenhanced__entry__2}{#identifyreconcile-POST-queryenhanced__version-not_optional-RESTAPI}

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

{#identifyreconcile-POST-queryenhanced__entry__6}

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

{#identifyreconcile-POST-queryenhanced__table_c2c_bzn_rlb__entry__2}{#identifyreconcile-POST-queryenhanced__input_rel_sys_rel_source_info-row-IRE}{#identifyreconcile-POST-queryenhanced__input-relations-sys_rel_source_info-source_name-row-IRE}{#identifyreconcile-POST-queryenhanced__input-relations-sys_rel_source_info-source_feed-row-IRE}

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

{#identifyreconcile-POST-queryenhanced__table_c2c_bzn_rlb}

### 헤더

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#identifyreconcile-POST-queryenhanced__entry__104}{#identifyreconcile-POST-queryenhanced__accept-JSON-only-entry-RESTAPI}{#identifyreconcile-POST-queryenhanced__content_type-JSON-only-entry-RESTAPI}

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

{#identifyreconcile-POST-queryenhanced__entry__110}

| 머리글 | 설명 |
|-|-|
| 안 함 |   |
[표 23. 응답 헤더]

### 상태 코드

이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#identifyreconcile-POST-queryenhanced__entry__114}{#identifyreconcile-POST-queryenhanced__entry-200-status-code}{#identifyreconcile-POST-queryenhanced__entry-401-status-code}

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

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

{#identifyreconcile-POST-queryenhanced__table_gy4_yyn_rlb__entry__2}{#identifyreconcile-POST-queryenhanced__items_info-entry-IRE}{#identifyreconcile-POST-queryenhanced__items_info_code-entry-IRE}{#identifyreconcile-POST-queryenhanced__items_info_message-entry-IRE}{#identifyreconcile-POST-queryenhanced__items_info_ruleSysId-entry-IRE}

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

{#identifyreconcile-POST-queryenhanced__table_gy4_yyn_rlb}  

### cURL 요청

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

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

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

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

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

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

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

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