식별 및 조정 API

  • 릴리스 버전: Washingtondc
  • 업데이트 날짜 2024년 02월 01일
  • 읽기182분

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

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

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

    식별 및 조정 - POST /now/identifyreconcile

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

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

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

    URL 형식

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

    기본 URL: / api/now/identifyreconcile

    지원되는 요청 매개변수

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

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

    데이터 유형: 문자열

    기본값: API 페이로드를 불완전한 페이로드 테이블에 삽입합니다.
    표 3. 요청 본문 매개변수(XML 또는 JSON)
    이름 설명
    항목 각 개체가 만들거나 업데이트할 CI를 설명하는 개체의 배열입니다.

    데이터 유형: 배열

    "items": [
  {
    "className": "String",
    "internal_id": "String",
    "lookup": [Array],
    "related": [Array],
    "settings": {Object},
    "sys_object_source_info": {Object},
    "values": {Object}
  }
]
    items.className 필수 작성하거나 업데이트할 CI의 sys_class_name(클래스/테이블 이름)입니다. 이 값은 cmdb_ci_linux_server 또는 cmdb_ci_win_server와 같은 모든 CMDB 테이블이 될 수 있습니다.

    데이터 유형: 문자열
    items.internal_id 이 페이로드에 있는 이 항목의 고유 식별자입니다. 모든 값이 될 수 있지만 페이로드 내에서 고유해야 합니다.

    데이터 유형: 문자열
    items.lookup 각 객체가 조회 기반 식별 기록을 설명하는 객체의 배열입니다. 이러한 기록은 구성 항목 [cmdb_ci] 테이블에 대한 참조가 있는 조회 테이블을 기반으로 최상위 구성 항목을 식별하는 데 사용됩니다.

    데이터 유형: 배열

    "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에 대해 업데이트와 다운그레이드가 모두 허용되는지 여부를 나타냅니다.
    유효한 값은 다음과 같습니다.
    • true: 항목을 업데이트하지만 다운그레이드가 허용되지 않습니다.
    • false: 항목 업데이트와 다운그레이드가 모두 허용됩니다.

    데이터 유형: 부울

    기본값: false
    items.settings.updateWithoutSwitch 이 CI를 업데이트하고 클래스를 전환할 수 있는지 여부를 나타냅니다.
    유효한 값은 다음과 같습니다.
    • true: 항목을 업데이트하지만 클래스 전환이 허용되지 않습니다.
    • false: 항목 업데이트와 클래스 전환이 모두 허용됩니다.

    데이터 유형: 부울

    기본값: false
    items.settings.updateWithoutUpgrade 이 CI에 대해 업데이트와 업그레이드가 모두 허용되는지 여부를 나타냅니다.
    유효한 값은 다음과 같습니다.
    • true: 항목을 업데이트하지만 업그레이드가 허용되지 않습니다.
    • false: 항목 업데이트와 업그레이드가 모두 허용됩니다.

    데이터 유형: 부울

    기본값: false
    items.sys_object_source_info 고유 CI 식별자를 설명하는 객체입니다.

    데이터 유형: 객체

    "sys_object_source_info": {
  "source_feed": "String",
  "source_name": "String",  
  "source_native_key": "String",
  "source_recency_timestamp": "String"
}
    items.sys_object_source_info.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"
}
    참조 항목 각 객체가 페이로드의 두 항목 간 참조를 설명하는 객체의 배열입니다.

    데이터 유형: 배열

    "referenceItems": [
  {
    "referenced": "String",
    "referencedBy": "String",
    "referenceField": "String"
  }
]
    참조 항목.참조 internal_id 다른 항목에서 참조하는 항목에 대해 정의되었습니다.

    데이터 유형: 문자열
    참조 항목.참조된 사람 internal_id 다른 항목을 참조하는 항목에 대해 정의되었습니다.

    데이터 유형: 문자열
    referenceItems.referenceField 항목의 클래스/테이블에 있는 referencedBy 참조 필드의 이름입니다.

    데이터 유형: 문자열
    관계 각 객체가 페이로드에 정의된 두 항목 간의 관계를 설명하는 객체의 배열입니다.
    이 배열의 객체는 다음 두 가지 형식 중 하나를 사용할 수 있습니다.
    • 이 객체는 payload items 배열의 항목 인덱스를 나타내는 값을 사용하여 두 최상위 항목(전용) parentchild 및 이름-값 쌍 간의 관계를 정의할 수 있습니다.
    • 객체는 두 항목(최상위 항목, 관련 항목 또는 조회 항목 사용 parent_id ) 및 child_id 키/값 쌍을 포함하여 이러한 항목에 대해 정의된 값을 나타내는 internal_id 값으로 두 항목 간의 관계를 정의할 수 있습니다.

    데이터 유형: 배열

    "relations": [
  {
    "child": Number,
    "parent": Number,
    "sys_rel_source_info": {Object},
    "type": "String"
  }
]
    "relations": [
  {
    "child_id": "String",
    "parent_id": "String",
    "sys_rel_source_info": {Object},
    "type": "String"
  }
]
    relations.child 관계의 하위 항목을 나타내는 배열 내 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 검색 소스 내의 하위 검색/검사에 해당하는 모든 문자열입니다.

    기본값: '알 수 없음'은 sys_rel_source 테이블에서 기록을 작성할 때 source_feed 열에 저장됩니다.
    relations.type 상위 항목과 하위 항목 간에 존재하는 관계 유형입니다. 이는 CI 관계 유형 [cmdb_rel_type] 테이블의 이름 필드 값이어야 합니다.

    데이터 유형: 문자열

    헤더

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

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

    상태 코드

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

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

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

    이름 설명
    결과 쿼리에서 생성된 결과의 배열입니다.

    데이터 유형: 배열

    "result": [
  "additionalCommittedItems": [Array],
  "additionalCommittedRelations": [Array],
  "items": [Array],
  "relations": [Array]
]
    result.additionalCommittedItems 각 개체가 삽입 또는 업데이트할 요청 본문 items 배열에 포함되지 않은 CI를 설명하는 객체의 배열입니다.

    데이터 유형: 배열

    "additionalCommittedItems": [
  {
    "className": "String",
    "errorCount": Number,
    "identificationAttempts": [Array],
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloads": [Array],
    "operation": "String",
    "sysId": "String"
  }
]
    result.additionalCommittedItems.className 이 추가 CI의 sys_class_name입니다.

    데이터 유형: 문자열
    result.additionalCommittedItems.errorCount 이 추가 CI를 처리하는 동안 발생한 오류 수입니다.

    데이터 유형: 숫자
    result.additionalCommittedItems.errors 각 객체가 이 추가 CI를 처리하는 동안 발생한 오류를 설명하는 객체의 배열입니다.

    데이터 유형: 배열

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    결과.추가커밋항목.오류.오류 이 추가 CI를 처리하는 동안 발생한 오류의 유형입니다.

    데이터 유형: 문자열
    result.additionalCommittedItems.errors.message 이 추가 CI를 처리하는 동안 발생한 오류 메시지입니다.

    데이터 유형: 문자열
    result.additionalCommittedItems.identificationAttempts 각 객체가 이 추가 CI를 식별하기 위한 시도를 설명하는 객체의 배열입니다.
    데이터 유형: 배열
    "identificationAttempts": [
  {
    "attemptResult": "String",
    "attributes": [Array],
    "hybridEntryCiAttributes": [Array],
    "identiferName": "String",
    "searchOnTable": [Array]
  }
]
    result.additionalCommittedItems.identificationAttempts.attemptResult 이 추가적인 CI 식별 시도의 결과입니다.
    가능한 값:
    • 일치: 식별에 성공했습니다. 지정된 속성과 정확히 일치하는 고유한 CI가 식별자 규칙 테이블에서 발견되었습니다.
    • MULTI_MATCH: 오류로 인해 식별에 실패했습니다. 지정된 속성과 일치할 때 식별자 규칙 테이블에서 중복 CI가 발견되었습니다.
    • NO_MATCH: 식별에 실패했습니다. 지정된 속성과 일치하는 식별자 규칙 테이블에서 CI를 찾을 수 없습니다.
    • 건너뜀: 식별을 시도하지 않았습니다. 이 식별자 규칙 테이블 검색에 필요한 속성이 제공되지 않았으므로 규칙이 적용되지 않았습니다.

    데이터 유형: 문자열
    result.additionalCommittedItems.identificationAttempts.attributes 이러한 추가적인 CI 식별 시도 중 사용되는 CI 식별자 항목 속성의 배열입니다.

    데이터 유형: 배열

    속성 이름과 유형은 요청 본문 데이터와 사용 중인 식별자(예: )에 따라 달라집니다.

    "attributes": [
  "serial_number": "String",
  "serial_number_type": "String",
]
    result.additionalCommittedItems.identificationAttempts.hybridEntryCiAttributes 이러한 추가적인 CI 식별 시도 중 사용되는 CI 식별자 항목 속성의 배열입니다.

    데이터 유형: 배열

    속성 이름과 유형은 요청 본문 데이터와 사용 중인 식별자(예: )에 따라 달라집니다.

    "hybridEntryCiAttributes": [
  "name": "String",
  "serial_number": "String"
]
    result.additionalCommittedItems.identificationAttempts.identifierName 이 추가적인 CI 식별 시도에 사용되는 식별자 규칙입니다.

    데이터 유형: 문자열
    result.additionalCommittedItems.identificationAttempts.searchOnTable 이 추가 CI 식별 시도를 검색하는 테이블의 이름입니다.

    데이터 유형: 문자열
    result.additionalCommittedItems.identifierEntrySysId 이 추가 CI를 식별하는 데 사용되는 식별자 규칙의 sys_id입니다.
    주목할 만한 가치:
    • 알 수 없음: 이 추가 CI를 식별하지 못했습니다. 자세한 내용은 errors 문서를 참조하십시오.

    데이터 유형: 문자열
    result.additionalCommittedItems.inputIndices 이 추가 CI에 해당하는 요청 본문 items 배열의 CI에 대한 인덱스 값 배열입니다.

    데이터 유형: 배열

    "inputIndices": [
  {
    Number
  }
]
    result.additionalCommittedItems.markers 내부에서 사용할 마커 값의 배열입니다.

    데이터 유형: 배열

    "markers": []
    result.additionalCommittedItems.mergedPayloads 이 추가 CI를 처리하는 동안 병합된 CMDB IRE 부분 페이로드 [cmdb_ire_partial_payloads] 테이블의 부분 페이로드에 대한 sys_id 값의 배열입니다.

    데이터 유형: 배열

    "mergedPayloadIds": [
  "String"
]
    result.additionalCommittedItems.operation 이 추가 CI에 대해 수행된 작업입니다.
    가능한 값:
    • 삭제: 기존 CI가 대상 테이블에서 제거됩니다.
    • 삽입: 추가 CI가 대상 테이블에 새 레코드로 삽입됩니다.
    • NO_CHANGE: 추가 CI에 대해서는 작업이 수행되지 않습니다.
    • 업데이트: 대상 테이블의 기존 CI가 업데이트됩니다.
    • UPDATE_WITH_DOWNGRADE: 대상 테이블의 기존 CI가 업데이트되고 해당 클래스가 보다 일반적인 클래스(상위 클래스)로 변경됩니다.
    • UPDATE_WITH_SWITCH: 대상 테이블의 기존 CI가 업데이트되고 해당 클래스가 상위 또는 하위 클래스가 아닌 다른 클래스로 변경됩니다.
    • UPDATE_WITH_UPGRADE: 대상 테이블의 기존 CI가 업데이트되고 해당 클래스가 보다 전문화된 클래스(하위 클래스)로 변경됩니다.

    데이터 유형: 문자열
    result.additionalCommittedItems.sysId 식별을 통해 이 추가 CI에 대해 찾은 sys_id입니다.
    주목할 만한 가치:
    • 알 수 없음: 이 추가 CI를 식별하지 못했습니다. 자세한 내용은 errors 문서를 참조하십시오.

    데이터 유형: 문자열
    result.additionalCommittedItems.warnings 각 객체가 이 추가 CI를 처리하는 동안 발생한 경고를 설명하는 객체의 배열입니다.

    데이터 유형: 배열

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    결과.추가커밋항목.경고.오류 이 추가 CI를 처리하는 동안 발생한 경고의 유형입니다.

    데이터 유형: 문자열
    result.additionalCommittedItems.warnings.message 이 추가 CI를 처리하는 동안 발생한 경고 메시지입니다.

    데이터 유형: 문자열
    result.additionalCommittedRelations 각 개체가 종속 관계를 설명하는 객체의 배열입니다. 삽입 또는 업데이트할 요청 본문 relations 목록에 포함되지 않은 CI입니다.

    데이터 유형: 배열

    "additionalCommittedRelations": [
  {
    "className": "String",
    "operation": "String",
    "markers": [Array],
    "inputIndices": [Array],
    "mergedPayloadIds": [Array]
  }
]
    result.additionalCommittedRelations.className 이 추가 종속 관계 CI의 sys_class_name입니다.
    지원되는 값만:
    • cmdb_rel_ci: CI 관계 테이블입니다.

    데이터 유형: 문자열
    result.additionalCommittedRelations.errorCount 이 추가 종속 관계 CI를 처리하는 동안 발생한 오류 수입니다.

    데이터 유형: 숫자
    result.additionalCommittedRelations.errors 각 객체가 이 추가 종속 관계 CI를 처리하는 동안 발생한 오류를 설명하는 객체의 배열입니다.

    데이터 유형: 배열

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    result.additionalCommittedRelations.errors.error 이 추가 종속 관계 CI를 처리하는 동안 발생한 오류의 유형입니다.

    데이터 유형: 문자열
    result.additionalCommittedRelations.errors.message 이 추가 종속 관계 CI를 처리하는 동안 발생한 오류 메시지입니다.

    데이터 유형: 문자열
    result.additionalCommittedRelations.inputIndices 이 추가 종속 관계 CI에 해당하는 요청 본문 relations 배열의 종속 관계 CI 객체에 대한 인덱스 값 배열입니다.

    데이터 유형: 배열

    "inputIndices": [
  Number
]
    result.additionalCommittedRelations.markers 내부에서 사용할 마커 값의 배열입니다.

    데이터 유형: 배열

    "markers": []
    result.additionalCommittedRelations.mergedPayloadIds 이 추가 종속 관계 CI를 처리하는 동안 병합된 CMDB IRE 부분 페이로드 [cmdb_ire_partial_payloads] 테이블의 부분 페이로드에 대한 sys_id 값의 배열입니다.

    데이터 유형: 배열

    "mergedPayloadIds": [
  "String"
]
    result.additionalCommittedRelations.operation 이 추가 종속 관계 CI에 대해 수행된 운영입니다.
    가능한 값:
    • 삽입: 종속 관계 CI가 대상 테이블에 새 기록으로 삽입됩니다.
    • INSERT_AS_INCOMPLETE: 종속 관계 CI에 오류가 있어 CMDB IRE 불완전한 페이로드 [cmdb_ire_incomplete_payloads] 테이블에 삽입됩니다.
    • INSERT_AS_PARTIAL: 종속 관계 CI에 오류가 있어 CMDB IRE 부분 페이로드 [cmdb_ire_partial_payloads] 테이블에 삽입됩니다.
    • NO_CHANGE: 종속 관계 CI에 대한 작업이 수행되지 않습니다.
    • 업데이트: 대상 테이블의 기존 종속 관계 CI가 업데이트됩니다.

    데이터 유형: 문자열
    결과.항목 각 객체가 요청 본문 items 배열에 포함된 CI를 설명하는 객체의 배열입니다.

    데이터 유형: 배열

    "items": [
  {
    "additionalRelatedItems": [Array],
    "className": "String",
    "duplicateLookupIndices": {Object},
    "errorCount": Number,
    "errors": [Array],
    "identificationAttempts": [Array],
    "identifierEntrySysId": "String",
    "info": [Array],
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloadIds": [Array],
    "operation": "String",
    "relatedItems": [Array],
    "relatedSysIds": [Array],
    "sysId": "String",
    "warnings": [Array]
  }
]
    result.items.additionalRelatedItems 각 객체가 CMDB IRE cmdb_ire_partial_payloads] 테이블의 관련 CI(테이블 조회 CI)를 설명하는 객체의 배열입니다.

    데이터 유형: 배열

    "additionalRelatedItems": [
  {
    "className": "String",
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloadIds": [Array],
    "sysId": "String"
  }
]
    result.items.additionalRelatedItems.className 관련 항목의 sys_class_name입니다.

    데이터 유형: 문자열
    result.items.additionalRelatedItems.inputIndices 이 관련 항목에 해당하는 요청 본문 items 배열의 CI에 대한 인덱스 값 배열입니다.

    데이터 유형: 배열

    "inputIndices": [
    Number
]
    result.items.additionalRelatedItems.markers 내부에서 사용할 마커 값의 배열입니다.

    데이터 유형: 배열

    "markers": []
    result.items.additionalRelatedItems.mergedPayloadIds 이 관련 항목을 처리하는 동안 병합된 CMDB IRE 부분 페이로드 [cmdb_ire_partial_payloads] 테이블의 부분 페이로드에 대한 sys_id 값의 배열입니다.

    데이터 유형: 배열

    "mergedPayloadIds": [
  "String"
]
    result.items.additionalRelatedItems.sysId 이 관련 CI의 sys_id입니다.

    데이터 유형: 문자열
    result.items.className 이 CI의 sys_class_name입니다.

    데이터 유형: 문자열
    result.items.duplicateLookupIndices 동일한 관련 CI를 참조하는 배열 요소의 인덱스 값 items.lookup 배열을 포함하는 객체입니다.

    배열 이름은 지정된 관련 CI를 참조하는 요청 본문 items.lookup 배열의 첫 번째 요소를 나타냅니다. 해당 값은 동일한 관련 CI를 참조하는 동일한 배열의 추가 요소 세트입니다.

    데이터 유형: 객체

    이 예는 배열의 두 번째 요소가 items.lookup 해당 배열의 이후 요소와 동일한 관련 CI를 참조하는 경우를 보여줍니다.

    "duplicateLookupIndices": [
  "2": [Array]
]
    result.items.errorCount 이 CI를 처리하는 동안 발생한 오류 수입니다.

    데이터 유형: 숫자
    결과.항목.오류 각 객체가 이 CI를 처리하는 동안 발생한 오류를 설명하는 객체의 배열입니다.

    데이터 유형: 배열

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    결과.항목.오류.오류 이 CI를 처리하는 동안 발생한 오류의 유형입니다.

    데이터 유형: 문자열
    결과.항목.오류.메시지 이 CI를 처리하는 동안 발생한 오류 메시지입니다.

    데이터 유형: 문자열
    result.items.identificationAttempts 각 객체가 이 CI를 식별하려는 시도를 설명하는 객체의 배열입니다.
    데이터 유형: 배열
    "identificationAttempts": [
  {
    "attemptResult": "String",
    "attributes": [Array],
    "hybridEntryCiAttributes": [Array],
    "identiferName": "String",
    "searchOnTable": [Array]
  }
]
    result.items.identificationAttempts.attemptResult 이 CI 식별 시도의 결과입니다.
    가능한 값:
    • 일치: 식별에 성공했습니다. 지정된 속성과 정확히 일치하는 고유한 CI가 식별자 규칙 테이블에서 발견되었습니다.
    • MULTI_MATCH: 오류로 인해 식별에 실패했습니다. 지정된 속성과 일치할 때 식별자 규칙 테이블에서 중복 CI가 발견되었습니다.
    • NO_MATCH: 식별에 실패했습니다. 지정된 속성과 일치하는 식별자 규칙 테이블에서 CI를 찾을 수 없습니다.
    • 건너뜀: 식별을 시도하지 않았습니다. 이 식별자 규칙 테이블 검색에 필요한 속성이 제공되지 않았으므로 규칙이 적용되지 않았습니다.

    데이터 유형: 문자열
    result.items.identificationAttempts.attributes 이 CI 식별 시도 동안 사용되는 CI 식별자 항목 속성의 배열입니다.

    데이터 유형: 배열

    속성 이름과 유형은 요청 본문 데이터와 사용 중인 식별자(예: )에 따라 달라집니다.

    "attributes": [
  "serial_number": "String",
  "serial_number_type": "String",
]
    result.items.identificationAttempts.hybridEntryCiAttributes 이 CI 식별 시도 동안 사용되는 CI 식별자 항목 속성의 배열입니다.

    데이터 유형: 배열

    속성 이름과 유형은 요청 본문 데이터와 사용 중인 식별자(예: )에 따라 달라집니다.

    "hybridEntryCiAttributes": [
  "name": "String",
  "serial_number": "String"
]
    result.items.identificationAttempts.identifierName 이 CI 식별 시도에 사용되는 식별자 규칙입니다.

    데이터 유형: 문자열
    result.items.identificationAttempts.searchOnTable 이 CI 식별 시도를 검색한 테이블의 이름입니다.

    데이터 유형: 문자열
    result.items.identifierEntrySysId 이 CI를 식별하는 데 사용되는 식별자 규칙의 sys_id입니다.
    주목할 만한 가치:
    • 알 수 없음: 이 CI를 식별하지 못했습니다. 자세한 내용은 errors 문서를 참조하십시오.

    데이터 유형: 문자열
    result.items.info 항목 처리에 대한 추가 정보가 들어 있는 객체의 목록입니다.

    데이터 유형: 배열

    "info": [
  {
    "code": "String",
    "message": "String",
    "ruleSysId": "String"
  }
]
    결과.항목.정보.코드 건너뛴 재분류 유형입니다.
    가능한 값:
    • SKIPPED_CLASS_SWITCH
    • SKIPPED_CLASS_DOWNGRADE
    • SKIPPED_CLASS_UPGRADE
    result.items.info.message 재분류를 건너뛰는 이유에 대한 추가 통찰력을 제공하는 메시지입니다.

    데이터 유형: 문자열
    result.items.info.ruleSysId 일치하는 재분류 제한 규칙의 Sys_id입니다. 재분류 제한 규칙으로 인해 IRE가 재분류를 건너뛸 때만 적용할 수 있습니다. 페이로드 또는 전역 플래그로 인해 재분류를 건너뛸 경우 이 값은 비어 있습니다.

    데이터 유형: 문자열
    result.items.inputIndices 이 CI에 해당하는 요청 본문 items 배열의 CI에 대한 인덱스 값 배열입니다.

    데이터 유형: 배열

    "inputIndices": [
  {
    Number
  }
]
    결과.항목.마커 내부에서 사용할 마커 값의 배열입니다.

    데이터 유형: 배열

    "markers": []
    result.items.mergedPayloadIds 이 CI를 처리하는 동안 병합된 CMDB IRE cmdb_ire_partial_payloads(부분 페이로드) 테이블의 부분 페이로드에 대한 sys_id 값의 배열입니다.

    데이터 유형: 배열

    "mergedPayloadIds": [
  "String"
]
    결과.항목.운영 이 CI에 대해 수행된 작업입니다.
    가능한 값:
    • 삭제: 기존 CI가 대상 테이블에서 제거됩니다.
    • 삽입: CI가 대상 테이블에 새 기록으로 삽입됩니다.
    • NO_CHANGE: CI에 대해 작업이 수행되지 않습니다.
    • 업데이트: 대상 테이블의 기존 CI가 업데이트됩니다.
    • UPDATE_WITH_DOWNGRADE: 대상 테이블의 기존 CI가 업데이트되고 해당 클래스가 보다 일반적인 클래스(상위 클래스)로 변경됩니다.
    • UPDATE_WITH_SWITCH: 대상 테이블의 기존 CI가 업데이트되고 해당 클래스가 상위 또는 하위 클래스가 아닌 다른 클래스로 변경됩니다.
    • UPDATE_WITH_UPGRADE: 대상 테이블의 기존 CI가 업데이트되고 해당 클래스가 보다 전문화된 클래스(하위 클래스)로 변경됩니다.

    데이터 유형: 문자열
    result.items.relatedItems 각 객체가 요청 본문 items.lookup 배열에서 관련 CI(테이블 조회 CI)를 설명하는 객체의 배열입니다.

    데이터 유형: 배열

    "relatedItems": [
  {
    "className": "String",
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloadIds": [Array],
    "sysId": "String"
  }
]
    result.items.relatedItems.className 관련 항목의 sys_class_name입니다.

    데이터 유형: 문자열
    result.items.relatedItems.inputIndices 요청 본문 items 의 CI 및 조회 항목과 이 관련 항목에 해당하는 배열의 인덱스 값 배열입니다 items.lookup .

    데이터 유형: 배열

    "inputIndices": [
  {
    "mainIndex": Number,
    "subIndex": Number
  }
]
    result.items.relatedItems.inputIndices.mainIndex 관련 항목의 CI 상위에 해당하는 요청 본문 items 배열의 인덱스 값입니다.

    데이터 유형: 숫자
    result.items.relatedItems.inputIndices.subIndex 관련 항목에 해당하는 요청 본문 items.lookup 배열의 인덱스 값입니다.

    데이터 유형: 숫자
    결과.항목.관련항목.마커 내부에서 사용할 마커 값의 배열입니다.

    데이터 유형: 배열

    "markers": []
    result.items.relatedItems.mergedPayloadIds 처리 중에 이 CI에 병합된 CMDB IRE 부분 페이로드 [cmdb_ire_partial_payloads] 테이블의 항목에 대한 sys_id 값의 배열입니다.

    데이터 유형: 배열

    "mergedPayloadIds": [
  "String"
]
    result.items.relatedSysIds 요청 본문 items.lookup 배열에서 관련 항목(테이블 조회 항목)에 대한 sys_id 값의 배열입니다.

    데이터 유형: 배열

    주목할 만한 가치:
    • null: 이 관련 항목에 대해 식별된 sys_id 없습니다.
    "relatedSysIds": [
    Number,
    Number
]
    result.items.sysId 식별을 통해 이 CI에 대해 찾은 sys_id입니다.
    주목할 만한 가치:
    • 알 수 없음: 이 CI를 식별하지 못했습니다. 자세한 내용은 errors 문서를 참조하십시오.

    데이터 유형: 문자열
    결과.항목.경고 각 객체가 이 CI를 처리하는 동안 발생한 경고를 설명하는 객체의 배열입니다.

    데이터 유형: 배열

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    결과.항목.경고.오류 이 CI를 처리하는 동안 발생한 경고 유형입니다.

    데이터 유형: 문자열
    result.items.warnings.message 이 CI를 처리하는 동안 발생한 경고 메시지입니다.

    데이터 유형: 문자열
    결과.logContextId 이 페이로드에 대해 보고된 컨텍스트 ID입니다.

    데이터 유형: 문자열
    결과.관계 각 객체가 요청 본문 relations 배열에서 종속 관계 CI를 설명하는 객체의 배열입니다.

    데이터 유형: 배열

    "relations": [
  {
    "className": "String",
    "errorCount": Number,
    "errors": [Array],
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloadIds": [Array],
    "operation": "String",
    "warnings": [Array]
  }
]
    result.relations.className 이 종속 관계 CI의 sys_class_name입니다.
    지원되는 값만:
    • cmdb_rel_ci: CI 관계 테이블입니다.

    데이터 유형: 문자열
    result.relations.errorCount 이 종속 관계 CI를 처리하는 동안 발생한 오류 수입니다.

    데이터 유형: 숫자
    결과.관계.오류 각 객체가 이 종속 관계 CI를 처리하는 동안 발생한 오류를 설명하는 객체의 배열입니다.

    데이터 유형: 배열

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    결과.관계.오류.오류 이 종속 관계 CI를 처리하는 동안 발생한 오류의 유형입니다.

    데이터 유형: 문자열
    결과.관계.오류.메시지 이 종속 관계 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 부분 페이로드 [cmdb_ire_partial_payloads] 테이블에 삽입되었습니다.
    • NO_CHANGE: 종속 관계 CI에 대해 작업이 수행되지 않았습니다.
    • 업데이트: 대상 테이블의 기존 종속 관계 CI가 업데이트되었습니다.

    데이터 유형: 문자열
    결과.관계.경고 각 객체가 이 종속 관계 CI를 처리하는 동안 발생한 경고를 설명하는 객체의 배열입니다.

    데이터 유형: 배열

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    결과.관계.경고.오류 이 종속 관계 CI를 처리하는 동안 발생한 경고의 유형입니다.

    데이터 유형: 문자열
    result.relations.warnings.message 이 종속 관계 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

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

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

    이 메서드는 메서드와 식별 및 조정 - POST /now/identifyreconcile 비슷하지만 다음과 같은 기능을 추가합니다.
    • 부분 페이로드
      • 경고 또는 오류가 있는 항목의 경우 항목 작업이 INSERT_AS_PARTIAL인지 INSERT_INCOMPLETE인지를 나타냅니다.
      • 기존 부분 페이로드와 병합된 부분 페이로드의 sys_ids 반환합니다.
    • 페이로드 중복 제거 기능을 지원합니다.
    • 요약을 생성합니다.

    URL 형식

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

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

    지원되는 요청 매개변수

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

    데이터 유형: 문자열
    표 8. 쿼리 매개변수
    이름 설명
    옵션 요청에 적용된 고급 IRE 옵션을 나타내는 이름-값 쌍의 쉼표로 구분된 목록입니다.

    예를 들어, 부분 페이로드, 부분 커밋, 중복 제거 및 요약 생성 고급 IRE 옵션의 기본값을 재정의하려면 다음을 수행합니다.

    partial_payloads:거짓,partial_commits:거짓,deduplicate_payloads:거짓,generate_summary:참
    주:
    기본적으로 또는 가 true로 설정된 경우 partial_payloads , partial_commits 두 deduplicate_payloads 및 는 false로 설정된 경우에도 부분 페이로드 기능에 필수적이므로 활성화됩니다.

    향상된 IRE 옵션에 대한 자세한 내용은 IRE(식별 및 조정 엔진)를 참조하세요.

    각 이름-값 쌍의 유효한 값은 다음과 같습니다.
    • true: 이 향상된 IRE 옵션을 사용하도록 설정합니다.
    • false: 이 향상된 IRE 옵션을 사용하지 않도록 설정합니다.

    데이터 유형: 문자열
    sysparm_data_source CI 정보의 소스를 식별합니다. 이 값은 구성 항목 [cmdb_ci] 테이블의 discovery_source 필드에 대해 정의된 선택 값 중 하나여야 합니다.

    데이터 유형: 문자열

    기본값: API 페이로드를 불완전한 페이로드 테이블에 삽입합니다.
    표 9. 요청 본문 매개변수(XML 또는 JSON)
    이름 설명
    항목 각 개체가 만들거나 업데이트할 CI를 설명하는 개체의 배열입니다.

    데이터 유형: 배열

    "items": [
  {
    "className": "String",
    "internal_id": "String",
    "lookup": [Array],
    "related": [Array],
    "settings": {Object},
    "sys_object_source_info": {Object},
    "values": {Object}
  }
]
    items.className 필수 작성하거나 업데이트할 CI의 sys_class_name(클래스/테이블 이름)입니다. 이 값은 cmdb_ci_linux_server 또는 cmdb_ci_win_server와 같은 모든 CMDB 테이블이 될 수 있습니다.

    데이터 유형: 문자열
    items.internal_id 이 페이로드에 있는 이 항목의 고유 식별자입니다. 모든 값이 될 수 있지만 페이로드 내에서 고유해야 합니다.

    데이터 유형: 문자열
    items.lookup 각 객체가 조회 기반 식별 기록을 설명하는 객체의 배열입니다. 이러한 기록은 구성 항목 [cmdb_ci] 테이블에 대한 참조가 있는 조회 테이블을 기반으로 최상위 구성 항목을 식별하는 데 사용됩니다.

    데이터 유형: 배열

    "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에 대해 업데이트와 다운그레이드가 모두 허용되는지 여부를 나타냅니다.
    유효한 값은 다음과 같습니다.
    • true: 항목을 업데이트하지만 다운그레이드가 허용되지 않습니다.
    • false: 항목 업데이트와 다운그레이드가 모두 허용됩니다.

    데이터 유형: 부울

    기본값: false
    items.settings.updateWithoutSwitch 이 CI를 업데이트하고 클래스를 전환할 수 있는지 여부를 나타냅니다.
    유효한 값은 다음과 같습니다.
    • true: 항목을 업데이트하지만 클래스 전환이 허용되지 않습니다.
    • false: 항목 업데이트와 클래스 전환이 모두 허용됩니다.

    데이터 유형: 부울

    기본값: false
    items.settings.updateWithoutUpgrade 이 CI에 대해 업데이트와 업그레이드가 모두 허용되는지 여부를 나타냅니다.
    유효한 값은 다음과 같습니다.
    • true: 항목을 업데이트하지만 업그레이드가 허용되지 않습니다.
    • false: 항목 업데이트와 업그레이드가 모두 허용됩니다.

    데이터 유형: 부울

    기본값: false
    items.sys_object_source_info 고유 CI 식별자를 설명하는 객체입니다.

    데이터 유형: 객체

    "sys_object_source_info": {
  "source_feed": "String",
  "source_name": "String",  
  "source_native_key": "String",
  "source_recency_timestamp": "String"
}
    items.sys_object_source_info.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"
}
    참조 항목 각 객체가 페이로드의 두 항목 간 참조를 설명하는 객체의 배열입니다.

    데이터 유형: 배열

    "referenceItems": [
  {
    "referenced": "String",
    "referencedBy": "String",
    "referenceField": "String"
  }
]
    참조 항목.참조 internal_id 다른 항목에서 참조하는 항목에 대해 정의되었습니다.

    데이터 유형: 문자열
    참조 항목.참조된 사람 internal_id 다른 항목을 참조하는 항목에 대해 정의되었습니다.

    데이터 유형: 문자열
    referenceItems.referenceField 항목의 클래스/테이블에 있는 referencedBy 참조 필드의 이름입니다.

    데이터 유형: 문자열
    관계 각 객체가 페이로드에 정의된 두 항목 간의 관계를 설명하는 객체의 배열입니다.
    이 배열의 객체는 다음 두 가지 형식 중 하나를 사용할 수 있습니다.
    • 이 객체는 payload items 배열의 항목 인덱스를 나타내는 값을 사용하여 두 최상위 항목(전용) parentchild 및 이름-값 쌍 간의 관계를 정의할 수 있습니다.
    • 객체는 두 항목(최상위 항목, 관련 항목 또는 조회 항목 사용 parent_id ) 및 child_id 키/값 쌍을 포함하여 이러한 항목에 대해 정의된 값을 나타내는 internal_id 값으로 두 항목 간의 관계를 정의할 수 있습니다.

    데이터 유형: 배열

    "relations": [
  {
    "child": Number,
    "parent": Number,
    "sys_rel_source_info": {Object},
    "type": "String"
  }
]
    "relations": [
  {
    "child_id": "String",
    "parent_id": "String",
    "sys_rel_source_info": {Object},
    "type": "String"
  }
]
    relations.child 관계의 하위 항목을 나타내는 배열 내 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 검색 소스 내의 하위 검색/검사에 해당하는 모든 문자열입니다.

    기본값: '알 수 없음'은 sys_rel_source 테이블에서 기록을 작성할 때 source_feed 열에 저장됩니다.
    relations.type 상위 항목과 하위 항목 간에 존재하는 관계 유형입니다. 이는 CI 관계 유형 [cmdb_rel_type] 테이블의 이름 필드 값이어야 합니다.

    데이터 유형: 문자열

    헤더

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

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

    상태 코드

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

    표 12. 상태 코드
    상태 코드 설명
    200 성공입니다. 요청이 성공적으로 처리되었습니다.
    401 승인되지 않았습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다.
    500 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다.

    오류 메시지 세부 정보 "청크 [...] 이(가) 유효한 항목이 아닙니다"는 쿼리 매개 변수가 올바른 이름-값 쌍 형식이 아님을 options 나타냅니다.

    예를 들어 partial 매개 변수를 지정하면 options 메시지 세부 정보에 "Chunk [partial] is not a valid entry"와 함께 500 상태 코드가 생성됩니다.

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

    이름 설명
    결과 쿼리에서 생성된 결과의 배열입니다.

    데이터 유형: 배열

    "result": [
  "additionalCommittedItems": [Array],
  "additionalCommittedRelations": [Array],
  "items": [Array],
  "relations": [Array]
]
    result.additionalCommittedItems 각 개체가 삽입 또는 업데이트할 요청 본문 items 배열에 포함되지 않은 CI를 설명하는 객체의 배열입니다.

    데이터 유형: 배열

    "additionalCommittedItems": [
  {
    "className": "String",
    "errorCount": Number,
    "identificationAttempts": [Array],
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloads": [Array],
    "operation": "String",
    "sysId": "String"
  }
]
    result.additionalCommittedItems.className 이 추가 CI의 sys_class_name입니다.

    데이터 유형: 문자열
    result.additionalCommittedItems.errorCount 이 추가 CI를 처리하는 동안 발생한 오류 수입니다.

    데이터 유형: 숫자
    result.additionalCommittedItems.errors 각 객체가 이 추가 CI를 처리하는 동안 발생한 오류를 설명하는 객체의 배열입니다.

    데이터 유형: 배열

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    결과.추가커밋항목.오류.오류 이 추가 CI를 처리하는 동안 발생한 오류의 유형입니다.

    데이터 유형: 문자열
    result.additionalCommittedItems.errors.message 이 추가 CI를 처리하는 동안 발생한 오류 메시지입니다.

    데이터 유형: 문자열
    result.additionalCommittedItems.identificationAttempts 각 객체가 이 추가 CI를 식별하기 위한 시도를 설명하는 객체의 배열입니다.
    데이터 유형: 배열
    "identificationAttempts": [
  {
    "attemptResult": "String",
    "attributes": [Array],
    "hybridEntryCiAttributes": [Array],
    "identiferName": "String",
    "searchOnTable": [Array]
  }
]
    result.additionalCommittedItems.identificationAttempts.attemptResult 이 추가적인 CI 식별 시도의 결과입니다.
    가능한 값:
    • 일치: 식별에 성공했습니다. 지정된 속성과 정확히 일치하는 고유한 CI가 식별자 규칙 테이블에서 발견되었습니다.
    • MULTI_MATCH: 오류로 인해 식별에 실패했습니다. 지정된 속성과 일치할 때 식별자 규칙 테이블에서 중복 CI가 발견되었습니다.
    • NO_MATCH: 식별에 실패했습니다. 지정된 속성과 일치하는 식별자 규칙 테이블에서 CI를 찾을 수 없습니다.
    • 건너뜀: 식별을 시도하지 않았습니다. 이 식별자 규칙 테이블 검색에 필요한 속성이 제공되지 않았으므로 규칙이 적용되지 않았습니다.

    데이터 유형: 문자열
    result.additionalCommittedItems.identificationAttempts.attributes 이러한 추가적인 CI 식별 시도 중 사용되는 CI 식별자 항목 속성의 배열입니다.

    데이터 유형: 배열

    속성 이름과 유형은 요청 본문 데이터와 사용 중인 식별자(예: )에 따라 달라집니다.

    "attributes": [
  "serial_number": "String",
  "serial_number_type": "String",
]
    result.additionalCommittedItems.identificationAttempts.hybridEntryCiAttributes 이러한 추가적인 CI 식별 시도 중 사용되는 CI 식별자 항목 속성의 배열입니다.

    데이터 유형: 배열

    속성 이름과 유형은 요청 본문 데이터와 사용 중인 식별자(예: )에 따라 달라집니다.

    "hybridEntryCiAttributes": [
  "name": "String",
  "serial_number": "String"
]
    result.additionalCommittedItems.identificationAttempts.identifierName 이 추가적인 CI 식별 시도에 사용되는 식별자 규칙입니다.

    데이터 유형: 문자열
    result.additionalCommittedItems.identificationAttempts.searchOnTable 이 추가 CI 식별 시도를 검색하는 테이블의 이름입니다.

    데이터 유형: 문자열
    result.additionalCommittedItems.identifierEntrySysId 이 추가 CI를 식별하는 데 사용되는 식별자 규칙의 sys_id입니다.
    주목할 만한 가치:
    • 알 수 없음: 이 추가 CI를 식별하지 못했습니다. 자세한 내용은 errors 문서를 참조하십시오.

    데이터 유형: 문자열
    result.additionalCommittedItems.inputIndices 이 추가 CI에 해당하는 요청 본문 items 배열의 CI에 대한 인덱스 값 배열입니다.

    데이터 유형: 배열

    "inputIndices": [
  {
    Number
  }
]
    result.additionalCommittedItems.markers 내부에서 사용할 마커 값의 배열입니다.

    데이터 유형: 배열

    "markers": []
    result.additionalCommittedItems.mergedPayloads 이 추가 CI를 처리하는 동안 병합된 CMDB IRE 부분 페이로드 [cmdb_ire_partial_payloads] 테이블의 부분 페이로드에 대한 sys_id 값의 배열입니다.

    데이터 유형: 배열

    "mergedPayloadIds": [
  "String"
]
    result.additionalCommittedItems.operation 이 추가 CI에 대해 수행된 작업입니다.
    가능한 값:
    • 삭제: 기존 CI가 대상 테이블에서 제거됩니다.
    • 삽입: 추가 CI가 대상 테이블에 새 레코드로 삽입됩니다.
    • NO_CHANGE: 추가 CI에 대해서는 작업이 수행되지 않습니다.
    • 업데이트: 대상 테이블의 기존 CI가 업데이트됩니다.
    • UPDATE_WITH_DOWNGRADE: 대상 테이블의 기존 CI가 업데이트되고 해당 클래스가 보다 일반적인 클래스(상위 클래스)로 변경됩니다.
    • UPDATE_WITH_SWITCH: 대상 테이블의 기존 CI가 업데이트되고 해당 클래스가 상위 또는 하위 클래스가 아닌 다른 클래스로 변경됩니다.
    • UPDATE_WITH_UPGRADE: 대상 테이블의 기존 CI가 업데이트되고 해당 클래스가 보다 전문화된 클래스(하위 클래스)로 변경됩니다.

    데이터 유형: 문자열
    result.additionalCommittedItems.sysId 식별을 통해 이 추가 CI에 대해 찾은 sys_id입니다.
    주목할 만한 가치:
    • 알 수 없음: 이 추가 CI를 식별하지 못했습니다. 자세한 내용은 errors 문서를 참조하십시오.

    데이터 유형: 문자열
    result.additionalCommittedItems.warnings 각 객체가 이 추가 CI를 처리하는 동안 발생한 경고를 설명하는 객체의 배열입니다.

    데이터 유형: 배열

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    결과.추가커밋항목.경고.오류 이 추가 CI를 처리하는 동안 발생한 경고의 유형입니다.

    데이터 유형: 문자열
    result.additionalCommittedItems.warnings.message 이 추가 CI를 처리하는 동안 발생한 경고 메시지입니다.

    데이터 유형: 문자열
    result.additionalCommittedRelations 각 개체가 종속 관계를 설명하는 객체의 배열입니다. 삽입 또는 업데이트할 요청 본문 relations 목록에 포함되지 않은 CI입니다.

    데이터 유형: 배열

    "additionalCommittedRelations": [
  {
    "className": "String",
    "operation": "String",
    "markers": [Array],
    "inputIndices": [Array],
    "mergedPayloadIds": [Array]
  }
]
    result.additionalCommittedRelations.className 이 추가 종속 관계 CI의 sys_class_name입니다.
    지원되는 값만:
    • cmdb_rel_ci: CI 관계 테이블입니다.

    데이터 유형: 문자열
    result.additionalCommittedRelations.errorCount 이 추가 종속 관계 CI를 처리하는 동안 발생한 오류 수입니다.

    데이터 유형: 숫자
    result.additionalCommittedRelations.errors 각 객체가 이 추가 종속 관계 CI를 처리하는 동안 발생한 오류를 설명하는 객체의 배열입니다.

    데이터 유형: 배열

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    result.additionalCommittedRelations.errors.error 이 추가 종속 관계 CI를 처리하는 동안 발생한 오류의 유형입니다.

    데이터 유형: 문자열
    result.additionalCommittedRelations.errors.message 이 추가 종속 관계 CI를 처리하는 동안 발생한 오류 메시지입니다.

    데이터 유형: 문자열
    result.additionalCommittedRelations.inputIndices 이 추가 종속 관계 CI에 해당하는 요청 본문 relations 배열의 종속 관계 CI 객체에 대한 인덱스 값 배열입니다.

    데이터 유형: 배열

    "inputIndices": [
  Number
]
    result.additionalCommittedRelations.markers 내부에서 사용할 마커 값의 배열입니다.

    데이터 유형: 배열

    "markers": []
    result.additionalCommittedRelations.mergedPayloadIds 이 추가 종속 관계 CI를 처리하는 동안 병합된 CMDB IRE 부분 페이로드 [cmdb_ire_partial_payloads] 테이블의 부분 페이로드에 대한 sys_id 값의 배열입니다.

    데이터 유형: 배열

    "mergedPayloadIds": [
  "String"
]
    result.additionalCommittedRelations.operation 이 추가 종속 관계 CI에 대해 수행된 운영입니다.
    가능한 값:
    • 삽입: 종속 관계 CI가 대상 테이블에 새 기록으로 삽입됩니다.
    • INSERT_AS_INCOMPLETE: 종속 관계 CI에 오류가 있어 CMDB IRE 불완전한 페이로드 [cmdb_ire_incomplete_payloads] 테이블에 삽입됩니다.
    • INSERT_AS_PARTIAL: 종속 관계 CI에 오류가 있어 CMDB IRE 부분 페이로드 [cmdb_ire_partial_payloads] 테이블에 삽입됩니다.
    • NO_CHANGE: 종속 관계 CI에 대한 작업이 수행되지 않습니다.
    • 업데이트: 대상 테이블의 기존 종속 관계 CI가 업데이트됩니다.

    데이터 유형: 문자열
    결과.항목 각 객체가 요청 본문 items 배열에 포함된 CI를 설명하는 객체의 배열입니다.

    데이터 유형: 배열

    "items": [
  {
    "additionalRelatedItems": [Array],
    "className": "String",
    "duplicateLookupIndices": {Object},
    "errorCount": Number,
    "errors": [Array],
    "identificationAttempts": [Array],
    "identifierEntrySysId": "String",
    "info": [Array],
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloadIds": [Array],
    "operation": "String",
    "relatedItems": [Array],
    "relatedSysIds": [Array],
    "sysId": "String",
    "warnings": [Array]
  }
]
    result.items.additionalRelatedItems 각 객체가 CMDB IRE cmdb_ire_partial_payloads] 테이블의 관련 CI(테이블 조회 CI)를 설명하는 객체의 배열입니다.

    데이터 유형: 배열

    "additionalRelatedItems": [
  {
    "className": "String",
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloadIds": [Array],
    "sysId": "String"
  }
]
    result.items.additionalRelatedItems.className 관련 항목의 sys_class_name입니다.

    데이터 유형: 문자열
    result.items.additionalRelatedItems.inputIndices 이 관련 항목에 해당하는 요청 본문 items 배열의 CI에 대한 인덱스 값 배열입니다.

    데이터 유형: 배열

    "inputIndices": [
    Number
]
    result.items.additionalRelatedItems.markers 내부에서 사용할 마커 값의 배열입니다.

    데이터 유형: 배열

    "markers": []
    result.items.additionalRelatedItems.mergedPayloadIds 이 관련 항목을 처리하는 동안 병합된 CMDB IRE 부분 페이로드 [cmdb_ire_partial_payloads] 테이블의 부분 페이로드에 대한 sys_id 값의 배열입니다.

    데이터 유형: 배열

    "mergedPayloadIds": [
  "String"
]
    result.items.additionalRelatedItems.sysId 이 관련 CI의 sys_id입니다.

    데이터 유형: 문자열
    result.items.className 이 CI의 sys_class_name입니다.

    데이터 유형: 문자열
    result.items.duplicateLookupIndices 동일한 관련 CI를 참조하는 배열 요소의 인덱스 값 items.lookup 배열을 포함하는 객체입니다.

    배열 이름은 지정된 관련 CI를 참조하는 요청 본문 items.lookup 배열의 첫 번째 요소를 나타냅니다. 해당 값은 동일한 관련 CI를 참조하는 동일한 배열의 추가 요소 세트입니다.

    데이터 유형: 객체

    이 예는 배열의 두 번째 요소가 items.lookup 해당 배열의 이후 요소와 동일한 관련 CI를 참조하는 경우를 보여줍니다.

    "duplicateLookupIndices": [
  "2": [Array]
]
    result.items.errorCount 이 CI를 처리하는 동안 발생한 오류 수입니다.

    데이터 유형: 숫자
    결과.항목.오류 각 객체가 이 CI를 처리하는 동안 발생한 오류를 설명하는 객체의 배열입니다.

    데이터 유형: 배열

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    결과.항목.오류.오류 이 CI를 처리하는 동안 발생한 오류의 유형입니다.

    데이터 유형: 문자열
    결과.항목.오류.메시지 이 CI를 처리하는 동안 발생한 오류 메시지입니다.

    데이터 유형: 문자열
    result.items.identificationAttempts 각 객체가 이 CI를 식별하려는 시도를 설명하는 객체의 배열입니다.
    데이터 유형: 배열
    "identificationAttempts": [
  {
    "attemptResult": "String",
    "attributes": [Array],
    "hybridEntryCiAttributes": [Array],
    "identiferName": "String",
    "searchOnTable": [Array]
  }
]
    result.items.identificationAttempts.attemptResult 이 CI 식별 시도의 결과입니다.
    가능한 값:
    • 일치: 식별에 성공했습니다. 지정된 속성과 정확히 일치하는 고유한 CI가 식별자 규칙 테이블에서 발견되었습니다.
    • MULTI_MATCH: 오류로 인해 식별에 실패했습니다. 지정된 속성과 일치할 때 식별자 규칙 테이블에서 중복 CI가 발견되었습니다.
    • NO_MATCH: 식별에 실패했습니다. 지정된 속성과 일치하는 식별자 규칙 테이블에서 CI를 찾을 수 없습니다.
    • 건너뜀: 식별을 시도하지 않았습니다. 이 식별자 규칙 테이블 검색에 필요한 속성이 제공되지 않았으므로 규칙이 적용되지 않았습니다.

    데이터 유형: 문자열
    result.items.identificationAttempts.attributes 이 CI 식별 시도 동안 사용되는 CI 식별자 항목 속성의 배열입니다.

    데이터 유형: 배열

    속성 이름과 유형은 요청 본문 데이터와 사용 중인 식별자(예: )에 따라 달라집니다.

    "attributes": [
  "serial_number": "String",
  "serial_number_type": "String",
]
    result.items.identificationAttempts.hybridEntryCiAttributes 이 CI 식별 시도 동안 사용되는 CI 식별자 항목 속성의 배열입니다.

    데이터 유형: 배열

    속성 이름과 유형은 요청 본문 데이터와 사용 중인 식별자(예: )에 따라 달라집니다.

    "hybridEntryCiAttributes": [
  "name": "String",
  "serial_number": "String"
]
    result.items.identificationAttempts.identifierName 이 CI 식별 시도에 사용되는 식별자 규칙입니다.

    데이터 유형: 문자열
    result.items.identificationAttempts.searchOnTable 이 CI 식별 시도를 검색한 테이블의 이름입니다.

    데이터 유형: 문자열
    result.items.identifierEntrySysId 이 CI를 식별하는 데 사용되는 식별자 규칙의 sys_id입니다.
    주목할 만한 가치:
    • 알 수 없음: 이 CI를 식별하지 못했습니다. 자세한 내용은 errors 문서를 참조하십시오.

    데이터 유형: 문자열
    result.items.info 항목 처리에 대한 추가 정보가 들어 있는 객체의 목록입니다.

    데이터 유형: 배열

    "info": [
  {
    "code": "String",
    "message": "String",
    "ruleSysId": "String"
  }
]
    결과.항목.정보.코드 건너뛴 재분류 유형입니다.
    가능한 값:
    • SKIPPED_CLASS_SWITCH
    • SKIPPED_CLASS_DOWNGRADE
    • SKIPPED_CLASS_UPGRADE
    result.items.info.message 재분류를 건너뛰는 이유에 대한 추가 통찰력을 제공하는 메시지입니다.

    데이터 유형: 문자열
    result.items.info.ruleSysId 일치하는 재분류 제한 규칙의 Sys_id입니다. 재분류 제한 규칙으로 인해 IRE가 재분류를 건너뛸 때만 적용할 수 있습니다. 페이로드 또는 전역 플래그로 인해 재분류를 건너뛸 경우 이 값은 비어 있습니다.

    데이터 유형: 문자열
    result.items.inputIndices 이 CI에 해당하는 요청 본문 items 배열의 CI에 대한 인덱스 값 배열입니다.

    데이터 유형: 배열

    "inputIndices": [
  {
    Number
  }
]
    결과.항목.마커 내부에서 사용할 마커 값의 배열입니다.

    데이터 유형: 배열

    "markers": []
    result.items.mergedPayloadIds 이 CI를 처리하는 동안 병합된 CMDB IRE cmdb_ire_partial_payloads(부분 페이로드) 테이블의 부분 페이로드에 대한 sys_id 값의 배열입니다.

    데이터 유형: 배열

    "mergedPayloadIds": [
  "String"
]
    결과.항목.운영 이 CI에 대해 수행된 작업입니다.
    가능한 값:
    • 삭제: 기존 CI가 대상 테이블에서 제거됩니다.
    • 삽입: CI가 대상 테이블에 새 기록으로 삽입됩니다.
    • NO_CHANGE: CI에 대해 작업이 수행되지 않습니다.
    • 업데이트: 대상 테이블의 기존 CI가 업데이트됩니다.
    • UPDATE_WITH_DOWNGRADE: 대상 테이블의 기존 CI가 업데이트되고 해당 클래스가 보다 일반적인 클래스(상위 클래스)로 변경됩니다.
    • UPDATE_WITH_SWITCH: 대상 테이블의 기존 CI가 업데이트되고 해당 클래스가 상위 또는 하위 클래스가 아닌 다른 클래스로 변경됩니다.
    • UPDATE_WITH_UPGRADE: 대상 테이블의 기존 CI가 업데이트되고 해당 클래스가 보다 전문화된 클래스(하위 클래스)로 변경됩니다.

    데이터 유형: 문자열
    result.items.relatedItems 각 객체가 요청 본문 items.lookup 배열에서 관련 CI(테이블 조회 CI)를 설명하는 객체의 배열입니다.

    데이터 유형: 배열

    "relatedItems": [
  {
    "className": "String",
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloadIds": [Array],
    "sysId": "String"
  }
]
    result.items.relatedItems.className 관련 항목의 sys_class_name입니다.

    데이터 유형: 문자열
    result.items.relatedItems.inputIndices 요청 본문 items 의 CI 및 조회 항목과 이 관련 항목에 해당하는 배열의 인덱스 값 배열입니다 items.lookup .

    데이터 유형: 배열

    "inputIndices": [
  {
    "mainIndex": Number,
    "subIndex": Number
  }
]
    result.items.relatedItems.inputIndices.mainIndex 관련 항목의 CI 상위에 해당하는 요청 본문 items 배열의 인덱스 값입니다.

    데이터 유형: 숫자
    result.items.relatedItems.inputIndices.subIndex 관련 항목에 해당하는 요청 본문 items.lookup 배열의 인덱스 값입니다.

    데이터 유형: 숫자
    결과.항목.관련항목.마커 내부에서 사용할 마커 값의 배열입니다.

    데이터 유형: 배열

    "markers": []
    result.items.relatedItems.mergedPayloadIds 처리 중에 이 CI에 병합된 CMDB IRE 부분 페이로드 [cmdb_ire_partial_payloads] 테이블의 항목에 대한 sys_id 값의 배열입니다.

    데이터 유형: 배열

    "mergedPayloadIds": [
  "String"
]
    result.items.relatedSysIds 요청 본문 items.lookup 배열에서 관련 항목(테이블 조회 항목)에 대한 sys_id 값의 배열입니다.

    데이터 유형: 배열

    주목할 만한 가치:
    • null: 이 관련 항목에 대해 식별된 sys_id 없습니다.
    "relatedSysIds": [
    Number,
    Number
]
    result.items.sysId 식별을 통해 이 CI에 대해 찾은 sys_id입니다.
    주목할 만한 가치:
    • 알 수 없음: 이 CI를 식별하지 못했습니다. 자세한 내용은 errors 문서를 참조하십시오.

    데이터 유형: 문자열
    결과.항목.경고 각 객체가 이 CI를 처리하는 동안 발생한 경고를 설명하는 객체의 배열입니다.

    데이터 유형: 배열

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    결과.항목.경고.오류 이 CI를 처리하는 동안 발생한 경고 유형입니다.

    데이터 유형: 문자열
    result.items.warnings.message 이 CI를 처리하는 동안 발생한 경고 메시지입니다.

    데이터 유형: 문자열
    결과.logContextId 이 페이로드에 대해 보고된 컨텍스트 ID입니다.

    데이터 유형: 문자열
    결과.관계 각 객체가 요청 본문 relations 배열에서 종속 관계 CI를 설명하는 객체의 배열입니다.

    데이터 유형: 배열

    "relations": [
  {
    "className": "String",
    "errorCount": Number,
    "errors": [Array],
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloadIds": [Array],
    "operation": "String",
    "warnings": [Array]
  }
]
    result.relations.className 이 종속 관계 CI의 sys_class_name입니다.
    지원되는 값만:
    • cmdb_rel_ci: CI 관계 테이블입니다.

    데이터 유형: 문자열
    result.relations.errorCount 이 종속 관계 CI를 처리하는 동안 발생한 오류 수입니다.

    데이터 유형: 숫자
    결과.관계.오류 각 객체가 이 종속 관계 CI를 처리하는 동안 발생한 오류를 설명하는 객체의 배열입니다.

    데이터 유형: 배열

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    결과.관계.오류.오류 이 종속 관계 CI를 처리하는 동안 발생한 오류의 유형입니다.

    데이터 유형: 문자열
    결과.관계.오류.메시지 이 종속 관계 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 부분 페이로드 [cmdb_ire_partial_payloads] 테이블에 삽입되었습니다.
    • NO_CHANGE: 종속 관계 CI에 대해 작업이 수행되지 않았습니다.
    • 업데이트: 대상 테이블의 기존 종속 관계 CI가 업데이트되었습니다.

    데이터 유형: 문자열
    결과.관계.경고 각 객체가 이 종속 관계 CI를 처리하는 동안 발생한 경고를 설명하는 객체의 배열입니다.

    데이터 유형: 배열

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    결과.관계.경고.오류 이 종속 관계 CI를 처리하는 동안 발생한 경고의 유형입니다.

    데이터 유형: 문자열
    result.relations.warnings.message 이 종속 관계 CI를 처리하는 동안 발생한 경고 메시지입니다.

    데이터 유형: 문자열

    cURL 요청

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

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

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

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

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

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

    응답은 컴퓨터 CI가 삽입되었음을 나타내고 수행된 작업에 대한 요약을 표시합니다.

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

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

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

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

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

    URL 형식

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

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

    지원되는 요청 매개변수

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

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

    데이터 유형: 문자열

    기본값: API 페이로드를 불완전한 페이로드 테이블에 삽입합니다.
    표 15. 요청 본문 매개변수(XML 또는 JSON)
    이름 설명
    항목 각 개체가 만들거나 업데이트할 CI를 설명하는 개체의 배열입니다.

    데이터 유형: 배열

    "items": [
  {
    "className": "String",
    "internal_id": "String",
    "lookup": [Array],
    "related": [Array],
    "settings": {Object},
    "sys_object_source_info": {Object},
    "values": {Object}
  }
]
    items.className 필수 작성하거나 업데이트할 CI의 sys_class_name(클래스/테이블 이름)입니다. 이 값은 cmdb_ci_linux_server 또는 cmdb_ci_win_server와 같은 모든 CMDB 테이블이 될 수 있습니다.

    데이터 유형: 문자열
    items.internal_id 이 페이로드에 있는 이 항목의 고유 식별자입니다. 모든 값이 될 수 있지만 페이로드 내에서 고유해야 합니다.

    데이터 유형: 문자열
    items.lookup 각 객체가 조회 기반 식별 기록을 설명하는 객체의 배열입니다. 이러한 기록은 구성 항목 [cmdb_ci] 테이블에 대한 참조가 있는 조회 테이블을 기반으로 최상위 구성 항목을 식별하는 데 사용됩니다.

    데이터 유형: 배열

    "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에 대해 업데이트와 다운그레이드가 모두 허용되는지 여부를 나타냅니다.
    유효한 값은 다음과 같습니다.
    • true: 항목을 업데이트하지만 다운그레이드가 허용되지 않습니다.
    • false: 항목 업데이트와 다운그레이드가 모두 허용됩니다.

    데이터 유형: 부울

    기본값: false
    items.settings.updateWithoutSwitch 이 CI를 업데이트하고 클래스를 전환할 수 있는지 여부를 나타냅니다.
    유효한 값은 다음과 같습니다.
    • true: 항목을 업데이트하지만 클래스 전환이 허용되지 않습니다.
    • false: 항목 업데이트와 클래스 전환이 모두 허용됩니다.

    데이터 유형: 부울

    기본값: false
    items.settings.updateWithoutUpgrade 이 CI에 대해 업데이트와 업그레이드가 모두 허용되는지 여부를 나타냅니다.
    유효한 값은 다음과 같습니다.
    • true: 항목을 업데이트하지만 업그레이드가 허용되지 않습니다.
    • false: 항목 업데이트와 업그레이드가 모두 허용됩니다.

    데이터 유형: 부울

    기본값: false
    items.sys_object_source_info 고유 CI 식별자를 설명하는 객체입니다.

    데이터 유형: 객체

    "sys_object_source_info": {
  "source_feed": "String",
  "source_name": "String",  
  "source_native_key": "String",
  "source_recency_timestamp": "String"
}
    items.sys_object_source_info.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"
}
    참조 항목 각 객체가 페이로드의 두 항목 간 참조를 설명하는 객체의 배열입니다.

    데이터 유형: 배열

    "referenceItems": [
  {
    "referenced": "String",
    "referencedBy": "String",
    "referenceField": "String"
  }
]
    참조 항목.참조 internal_id 다른 항목에서 참조하는 항목에 대해 정의되었습니다.

    데이터 유형: 문자열
    참조 항목.참조된 사람 internal_id 다른 항목을 참조하는 항목에 대해 정의되었습니다.

    데이터 유형: 문자열
    referenceItems.referenceField 항목의 클래스/테이블에 있는 referencedBy 참조 필드의 이름입니다.

    데이터 유형: 문자열
    관계 각 객체가 페이로드에 정의된 두 항목 간의 관계를 설명하는 객체의 배열입니다.
    이 배열의 객체는 다음 두 가지 형식 중 하나를 사용할 수 있습니다.
    • 이 객체는 payload items 배열의 항목 인덱스를 나타내는 값을 사용하여 두 최상위 항목(전용) parentchild 및 이름-값 쌍 간의 관계를 정의할 수 있습니다.
    • 객체는 두 항목(최상위 항목, 관련 항목 또는 조회 항목 사용 parent_id ) 및 child_id 키/값 쌍을 포함하여 이러한 항목에 대해 정의된 값을 나타내는 internal_id 값으로 두 항목 간의 관계를 정의할 수 있습니다.

    데이터 유형: 배열

    "relations": [
  {
    "child": Number,
    "parent": Number,
    "sys_rel_source_info": {Object},
    "type": "String"
  }
]
    "relations": [
  {
    "child_id": "String",
    "parent_id": "String",
    "sys_rel_source_info": {Object},
    "type": "String"
  }
]
    relations.child 관계의 하위 항목을 나타내는 배열 내 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 검색 소스 내의 하위 검색/검사에 해당하는 모든 문자열입니다.

    기본값: '알 수 없음'은 sys_rel_source 테이블에서 기록을 작성할 때 source_feed 열에 저장됩니다.
    relations.type 상위 항목과 하위 항목 간에 존재하는 관계 유형입니다. 이는 CI 관계 유형 [cmdb_rel_type] 테이블의 이름 필드 값이어야 합니다.

    데이터 유형: 문자열

    헤더

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

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

    상태 코드

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

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

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

    이름 설명
    결과 쿼리에서 생성된 결과의 배열입니다.

    데이터 유형: 배열

    "result": [
  "additionalCommittedItems": [Array],
  "additionalCommittedRelations": [Array],
  "items": [Array],
  "relations": [Array]
]
    result.additionalCommittedItems 각 개체가 삽입 또는 업데이트할 요청 본문 items 배열에 포함되지 않은 CI를 설명하는 객체의 배열입니다.

    데이터 유형: 배열

    "additionalCommittedItems": [
  {
    "className": "String",
    "errorCount": Number,
    "identificationAttempts": [Array],
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloads": [Array],
    "operation": "String",
    "sysId": "String"
  }
]
    result.additionalCommittedItems.className 이 추가 CI의 sys_class_name입니다.

    데이터 유형: 문자열
    result.additionalCommittedItems.errorCount 이 추가 CI를 처리하는 동안 발생한 오류 수입니다.

    데이터 유형: 숫자
    result.additionalCommittedItems.errors 각 객체가 이 추가 CI를 처리하는 동안 발생한 오류를 설명하는 객체의 배열입니다.

    데이터 유형: 배열

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    결과.추가커밋항목.오류.오류 이 추가 CI를 처리하는 동안 발생한 오류의 유형입니다.

    데이터 유형: 문자열
    result.additionalCommittedItems.errors.message 이 추가 CI를 처리하는 동안 발생한 오류 메시지입니다.

    데이터 유형: 문자열
    result.additionalCommittedItems.identificationAttempts 각 객체가 이 추가 CI를 식별하기 위한 시도를 설명하는 객체의 배열입니다.
    데이터 유형: 배열
    "identificationAttempts": [
  {
    "attemptResult": "String",
    "attributes": [Array],
    "hybridEntryCiAttributes": [Array],
    "identiferName": "String",
    "searchOnTable": [Array]
  }
]
    result.additionalCommittedItems.identificationAttempts.attemptResult 이 추가적인 CI 식별 시도의 결과입니다.
    가능한 값:
    • 일치: 식별에 성공했습니다. 지정된 속성과 정확히 일치하는 고유한 CI가 식별자 규칙 테이블에서 발견되었습니다.
    • MULTI_MATCH: 오류로 인해 식별에 실패했습니다. 지정된 속성과 일치할 때 식별자 규칙 테이블에서 중복 CI가 발견되었습니다.
    • NO_MATCH: 식별에 실패했습니다. 지정된 속성과 일치하는 식별자 규칙 테이블에서 CI를 찾을 수 없습니다.
    • 건너뜀: 식별을 시도하지 않았습니다. 이 식별자 규칙 테이블 검색에 필요한 속성이 제공되지 않았으므로 규칙이 적용되지 않았습니다.

    데이터 유형: 문자열
    result.additionalCommittedItems.identificationAttempts.attributes 이러한 추가적인 CI 식별 시도 중 사용되는 CI 식별자 항목 속성의 배열입니다.

    데이터 유형: 배열

    속성 이름과 유형은 요청 본문 데이터와 사용 중인 식별자(예: )에 따라 달라집니다.

    "attributes": [
  "serial_number": "String",
  "serial_number_type": "String",
]
    result.additionalCommittedItems.identificationAttempts.hybridEntryCiAttributes 이러한 추가적인 CI 식별 시도 중 사용되는 CI 식별자 항목 속성의 배열입니다.

    데이터 유형: 배열

    속성 이름과 유형은 요청 본문 데이터와 사용 중인 식별자(예: )에 따라 달라집니다.

    "hybridEntryCiAttributes": [
  "name": "String",
  "serial_number": "String"
]
    result.additionalCommittedItems.identificationAttempts.identifierName 이 추가적인 CI 식별 시도에 사용되는 식별자 규칙입니다.

    데이터 유형: 문자열
    result.additionalCommittedItems.identificationAttempts.searchOnTable 이 추가 CI 식별 시도를 검색하는 테이블의 이름입니다.

    데이터 유형: 문자열
    result.additionalCommittedItems.identifierEntrySysId 이 추가 CI를 식별하는 데 사용되는 식별자 규칙의 sys_id입니다.
    주목할 만한 가치:
    • 알 수 없음: 이 추가 CI를 식별하지 못했습니다. 자세한 내용은 errors 문서를 참조하십시오.

    데이터 유형: 문자열
    result.additionalCommittedItems.inputIndices 이 추가 CI에 해당하는 요청 본문 items 배열의 CI에 대한 인덱스 값 배열입니다.

    데이터 유형: 배열

    "inputIndices": [
  {
    Number
  }
]
    result.additionalCommittedItems.markers 내부에서 사용할 마커 값의 배열입니다.

    데이터 유형: 배열

    "markers": []
    result.additionalCommittedItems.mergedPayloads 이 추가 CI를 처리하는 동안 병합된 CMDB IRE 부분 페이로드 [cmdb_ire_partial_payloads] 테이블의 부분 페이로드에 대한 sys_id 값의 배열입니다.

    데이터 유형: 배열

    "mergedPayloadIds": [
  "String"
]
    result.additionalCommittedItems.operation 이 추가 CI에 대해 수행된 작업입니다.
    가능한 값:
    • 삭제: 기존 CI가 대상 테이블에서 제거됩니다.
    • 삽입: 추가 CI가 대상 테이블에 새 레코드로 삽입됩니다.
    • NO_CHANGE: 추가 CI에 대해서는 작업이 수행되지 않습니다.
    • 업데이트: 대상 테이블의 기존 CI가 업데이트됩니다.
    • UPDATE_WITH_DOWNGRADE: 대상 테이블의 기존 CI가 업데이트되고 해당 클래스가 보다 일반적인 클래스(상위 클래스)로 변경됩니다.
    • UPDATE_WITH_SWITCH: 대상 테이블의 기존 CI가 업데이트되고 해당 클래스가 상위 또는 하위 클래스가 아닌 다른 클래스로 변경됩니다.
    • UPDATE_WITH_UPGRADE: 대상 테이블의 기존 CI가 업데이트되고 해당 클래스가 보다 전문화된 클래스(하위 클래스)로 변경됩니다.

    데이터 유형: 문자열
    result.additionalCommittedItems.sysId 식별을 통해 이 추가 CI에 대해 찾은 sys_id입니다.
    주목할 만한 가치:
    • 알 수 없음: 이 추가 CI를 식별하지 못했습니다. 자세한 내용은 errors 문서를 참조하십시오.

    데이터 유형: 문자열
    result.additionalCommittedItems.warnings 각 객체가 이 추가 CI를 처리하는 동안 발생한 경고를 설명하는 객체의 배열입니다.

    데이터 유형: 배열

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    결과.추가커밋항목.경고.오류 이 추가 CI를 처리하는 동안 발생한 경고의 유형입니다.

    데이터 유형: 문자열
    result.additionalCommittedItems.warnings.message 이 추가 CI를 처리하는 동안 발생한 경고 메시지입니다.

    데이터 유형: 문자열
    result.additionalCommittedRelations 각 개체가 종속 관계를 설명하는 객체의 배열입니다. 삽입 또는 업데이트할 요청 본문 relations 목록에 포함되지 않은 CI입니다.

    데이터 유형: 배열

    "additionalCommittedRelations": [
  {
    "className": "String",
    "operation": "String",
    "markers": [Array],
    "inputIndices": [Array],
    "mergedPayloadIds": [Array]
  }
]
    result.additionalCommittedRelations.className 이 추가 종속 관계 CI의 sys_class_name입니다.
    지원되는 값만:
    • cmdb_rel_ci: CI 관계 테이블입니다.

    데이터 유형: 문자열
    result.additionalCommittedRelations.errorCount 이 추가 종속 관계 CI를 처리하는 동안 발생한 오류 수입니다.

    데이터 유형: 숫자
    result.additionalCommittedRelations.errors 각 객체가 이 추가 종속 관계 CI를 처리하는 동안 발생한 오류를 설명하는 객체의 배열입니다.

    데이터 유형: 배열

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    result.additionalCommittedRelations.errors.error 이 추가 종속 관계 CI를 처리하는 동안 발생한 오류의 유형입니다.

    데이터 유형: 문자열
    result.additionalCommittedRelations.errors.message 이 추가 종속 관계 CI를 처리하는 동안 발생한 오류 메시지입니다.

    데이터 유형: 문자열
    result.additionalCommittedRelations.inputIndices 이 추가 종속 관계 CI에 해당하는 요청 본문 relations 배열의 종속 관계 CI 객체에 대한 인덱스 값 배열입니다.

    데이터 유형: 배열

    "inputIndices": [
  Number
]
    result.additionalCommittedRelations.markers 내부에서 사용할 마커 값의 배열입니다.

    데이터 유형: 배열

    "markers": []
    result.additionalCommittedRelations.mergedPayloadIds 이 추가 종속 관계 CI를 처리하는 동안 병합된 CMDB IRE 부분 페이로드 [cmdb_ire_partial_payloads] 테이블의 부분 페이로드에 대한 sys_id 값의 배열입니다.

    데이터 유형: 배열

    "mergedPayloadIds": [
  "String"
]
    result.additionalCommittedRelations.operation 이 추가 종속 관계 CI에 대해 수행된 운영입니다.
    가능한 값:
    • 삽입: 종속 관계 CI가 대상 테이블에 새 기록으로 삽입됩니다.
    • INSERT_AS_INCOMPLETE: 종속 관계 CI에 오류가 있어 CMDB IRE 불완전한 페이로드 [cmdb_ire_incomplete_payloads] 테이블에 삽입됩니다.
    • INSERT_AS_PARTIAL: 종속 관계 CI에 오류가 있어 CMDB IRE 부분 페이로드 [cmdb_ire_partial_payloads] 테이블에 삽입됩니다.
    • NO_CHANGE: 종속 관계 CI에 대한 작업이 수행되지 않습니다.
    • 업데이트: 대상 테이블의 기존 종속 관계 CI가 업데이트됩니다.

    데이터 유형: 문자열
    결과.항목 각 객체가 요청 본문 items 배열에 포함된 CI를 설명하는 객체의 배열입니다.

    데이터 유형: 배열

    "items": [
  {
    "additionalRelatedItems": [Array],
    "className": "String",
    "duplicateLookupIndices": {Object},
    "errorCount": Number,
    "errors": [Array],
    "identificationAttempts": [Array],
    "identifierEntrySysId": "String",
    "info": [Array],
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloadIds": [Array],
    "operation": "String",
    "relatedItems": [Array],
    "relatedSysIds": [Array],
    "sysId": "String",
    "warnings": [Array]
  }
]
    result.items.additionalRelatedItems 각 객체가 CMDB IRE cmdb_ire_partial_payloads] 테이블의 관련 CI(테이블 조회 CI)를 설명하는 객체의 배열입니다.

    데이터 유형: 배열

    "additionalRelatedItems": [
  {
    "className": "String",
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloadIds": [Array],
    "sysId": "String"
  }
]
    result.items.additionalRelatedItems.className 관련 항목의 sys_class_name입니다.

    데이터 유형: 문자열
    result.items.additionalRelatedItems.inputIndices 이 관련 항목에 해당하는 요청 본문 items 배열의 CI에 대한 인덱스 값 배열입니다.

    데이터 유형: 배열

    "inputIndices": [
    Number
]
    result.items.additionalRelatedItems.markers 내부에서 사용할 마커 값의 배열입니다.

    데이터 유형: 배열

    "markers": []
    result.items.additionalRelatedItems.mergedPayloadIds 이 관련 항목을 처리하는 동안 병합된 CMDB IRE 부분 페이로드 [cmdb_ire_partial_payloads] 테이블의 부분 페이로드에 대한 sys_id 값의 배열입니다.

    데이터 유형: 배열

    "mergedPayloadIds": [
  "String"
]
    result.items.additionalRelatedItems.sysId 이 관련 CI의 sys_id입니다.

    데이터 유형: 문자열
    result.items.className 이 CI의 sys_class_name입니다.

    데이터 유형: 문자열
    result.items.duplicateLookupIndices 동일한 관련 CI를 참조하는 배열 요소의 인덱스 값 items.lookup 배열을 포함하는 객체입니다.

    배열 이름은 지정된 관련 CI를 참조하는 요청 본문 items.lookup 배열의 첫 번째 요소를 나타냅니다. 해당 값은 동일한 관련 CI를 참조하는 동일한 배열의 추가 요소 세트입니다.

    데이터 유형: 객체

    이 예는 배열의 두 번째 요소가 items.lookup 해당 배열의 이후 요소와 동일한 관련 CI를 참조하는 경우를 보여줍니다.

    "duplicateLookupIndices": [
  "2": [Array]
]
    result.items.errorCount 이 CI를 처리하는 동안 발생한 오류 수입니다.

    데이터 유형: 숫자
    결과.항목.오류 각 객체가 이 CI를 처리하는 동안 발생한 오류를 설명하는 객체의 배열입니다.

    데이터 유형: 배열

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    결과.항목.오류.오류 이 CI를 처리하는 동안 발생한 오류의 유형입니다.

    데이터 유형: 문자열
    결과.항목.오류.메시지 이 CI를 처리하는 동안 발생한 오류 메시지입니다.

    데이터 유형: 문자열
    result.items.identificationAttempts 각 객체가 이 CI를 식별하려는 시도를 설명하는 객체의 배열입니다.
    데이터 유형: 배열
    "identificationAttempts": [
  {
    "attemptResult": "String",
    "attributes": [Array],
    "hybridEntryCiAttributes": [Array],
    "identiferName": "String",
    "searchOnTable": [Array]
  }
]
    result.items.identificationAttempts.attemptResult 이 CI 식별 시도의 결과입니다.
    가능한 값:
    • 일치: 식별에 성공했습니다. 지정된 속성과 정확히 일치하는 고유한 CI가 식별자 규칙 테이블에서 발견되었습니다.
    • MULTI_MATCH: 오류로 인해 식별에 실패했습니다. 지정된 속성과 일치할 때 식별자 규칙 테이블에서 중복 CI가 발견되었습니다.
    • NO_MATCH: 식별에 실패했습니다. 지정된 속성과 일치하는 식별자 규칙 테이블에서 CI를 찾을 수 없습니다.
    • 건너뜀: 식별을 시도하지 않았습니다. 이 식별자 규칙 테이블 검색에 필요한 속성이 제공되지 않았으므로 규칙이 적용되지 않았습니다.

    데이터 유형: 문자열
    result.items.identificationAttempts.attributes 이 CI 식별 시도 동안 사용되는 CI 식별자 항목 속성의 배열입니다.

    데이터 유형: 배열

    속성 이름과 유형은 요청 본문 데이터와 사용 중인 식별자(예: )에 따라 달라집니다.

    "attributes": [
  "serial_number": "String",
  "serial_number_type": "String",
]
    result.items.identificationAttempts.hybridEntryCiAttributes 이 CI 식별 시도 동안 사용되는 CI 식별자 항목 속성의 배열입니다.

    데이터 유형: 배열

    속성 이름과 유형은 요청 본문 데이터와 사용 중인 식별자(예: )에 따라 달라집니다.

    "hybridEntryCiAttributes": [
  "name": "String",
  "serial_number": "String"
]
    result.items.identificationAttempts.identifierName 이 CI 식별 시도에 사용되는 식별자 규칙입니다.

    데이터 유형: 문자열
    result.items.identificationAttempts.searchOnTable 이 CI 식별 시도를 검색한 테이블의 이름입니다.

    데이터 유형: 문자열
    result.items.identifierEntrySysId 이 CI를 식별하는 데 사용되는 식별자 규칙의 sys_id입니다.
    주목할 만한 가치:
    • 알 수 없음: 이 CI를 식별하지 못했습니다. 자세한 내용은 errors 문서를 참조하십시오.

    데이터 유형: 문자열
    result.items.info 항목 처리에 대한 추가 정보가 들어 있는 객체의 목록입니다.

    데이터 유형: 배열

    "info": [
  {
    "code": "String",
    "message": "String",
    "ruleSysId": "String"
  }
]
    결과.항목.정보.코드 건너뛴 재분류 유형입니다.
    가능한 값:
    • SKIPPED_CLASS_SWITCH
    • SKIPPED_CLASS_DOWNGRADE
    • SKIPPED_CLASS_UPGRADE
    result.items.info.message 재분류를 건너뛰는 이유에 대한 추가 통찰력을 제공하는 메시지입니다.

    데이터 유형: 문자열
    result.items.info.ruleSysId 일치하는 재분류 제한 규칙의 Sys_id입니다. 재분류 제한 규칙으로 인해 IRE가 재분류를 건너뛸 때만 적용할 수 있습니다. 페이로드 또는 전역 플래그로 인해 재분류를 건너뛸 경우 이 값은 비어 있습니다.

    데이터 유형: 문자열
    result.items.inputIndices 이 CI에 해당하는 요청 본문 items 배열의 CI에 대한 인덱스 값 배열입니다.

    데이터 유형: 배열

    "inputIndices": [
  {
    Number
  }
]
    결과.항목.마커 내부에서 사용할 마커 값의 배열입니다.

    데이터 유형: 배열

    "markers": []
    result.items.mergedPayloadIds 이 CI를 처리하는 동안 병합된 CMDB IRE cmdb_ire_partial_payloads(부분 페이로드) 테이블의 부분 페이로드에 대한 sys_id 값의 배열입니다.

    데이터 유형: 배열

    "mergedPayloadIds": [
  "String"
]
    결과.항목.운영 이 CI에 대해 수행된 작업입니다.
    가능한 값:
    • 삭제: 기존 CI가 대상 테이블에서 제거됩니다.
    • 삽입: CI가 대상 테이블에 새 기록으로 삽입됩니다.
    • NO_CHANGE: CI에 대해 작업이 수행되지 않습니다.
    • 업데이트: 대상 테이블의 기존 CI가 업데이트됩니다.
    • UPDATE_WITH_DOWNGRADE: 대상 테이블의 기존 CI가 업데이트되고 해당 클래스가 보다 일반적인 클래스(상위 클래스)로 변경됩니다.
    • UPDATE_WITH_SWITCH: 대상 테이블의 기존 CI가 업데이트되고 해당 클래스가 상위 또는 하위 클래스가 아닌 다른 클래스로 변경됩니다.
    • UPDATE_WITH_UPGRADE: 대상 테이블의 기존 CI가 업데이트되고 해당 클래스가 보다 전문화된 클래스(하위 클래스)로 변경됩니다.

    데이터 유형: 문자열
    result.items.relatedItems 각 객체가 요청 본문 items.lookup 배열에서 관련 CI(테이블 조회 CI)를 설명하는 객체의 배열입니다.

    데이터 유형: 배열

    "relatedItems": [
  {
    "className": "String",
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloadIds": [Array],
    "sysId": "String"
  }
]
    result.items.relatedItems.className 관련 항목의 sys_class_name입니다.

    데이터 유형: 문자열
    result.items.relatedItems.inputIndices 요청 본문 items 의 CI 및 조회 항목과 이 관련 항목에 해당하는 배열의 인덱스 값 배열입니다 items.lookup .

    데이터 유형: 배열

    "inputIndices": [
  {
    "mainIndex": Number,
    "subIndex": Number
  }
]
    result.items.relatedItems.inputIndices.mainIndex 관련 항목의 CI 상위에 해당하는 요청 본문 items 배열의 인덱스 값입니다.

    데이터 유형: 숫자
    result.items.relatedItems.inputIndices.subIndex 관련 항목에 해당하는 요청 본문 items.lookup 배열의 인덱스 값입니다.

    데이터 유형: 숫자
    결과.항목.관련항목.마커 내부에서 사용할 마커 값의 배열입니다.

    데이터 유형: 배열

    "markers": []
    result.items.relatedItems.mergedPayloadIds 처리 중에 이 CI에 병합된 CMDB IRE 부분 페이로드 [cmdb_ire_partial_payloads] 테이블의 항목에 대한 sys_id 값의 배열입니다.

    데이터 유형: 배열

    "mergedPayloadIds": [
  "String"
]
    result.items.relatedSysIds 요청 본문 items.lookup 배열에서 관련 항목(테이블 조회 항목)에 대한 sys_id 값의 배열입니다.

    데이터 유형: 배열

    주목할 만한 가치:
    • null: 이 관련 항목에 대해 식별된 sys_id 없습니다.
    "relatedSysIds": [
    Number,
    Number
]
    result.items.sysId 식별을 통해 이 CI에 대해 찾은 sys_id입니다.
    주목할 만한 가치:
    • 알 수 없음: 이 CI를 식별하지 못했습니다. 자세한 내용은 errors 문서를 참조하십시오.

    데이터 유형: 문자열
    결과.항목.경고 각 객체가 이 CI를 처리하는 동안 발생한 경고를 설명하는 객체의 배열입니다.

    데이터 유형: 배열

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    결과.항목.경고.오류 이 CI를 처리하는 동안 발생한 경고 유형입니다.

    데이터 유형: 문자열
    result.items.warnings.message 이 CI를 처리하는 동안 발생한 경고 메시지입니다.

    데이터 유형: 문자열
    결과.logContextId 이 페이로드에 대해 보고된 컨텍스트 ID입니다.

    데이터 유형: 문자열
    결과.관계 각 객체가 요청 본문 relations 배열에서 종속 관계 CI를 설명하는 객체의 배열입니다.

    데이터 유형: 배열

    "relations": [
  {
    "className": "String",
    "errorCount": Number,
    "errors": [Array],
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloadIds": [Array],
    "operation": "String",
    "warnings": [Array]
  }
]
    result.relations.className 이 종속 관계 CI의 sys_class_name입니다.
    지원되는 값만:
    • cmdb_rel_ci: CI 관계 테이블입니다.

    데이터 유형: 문자열
    result.relations.errorCount 이 종속 관계 CI를 처리하는 동안 발생한 오류 수입니다.

    데이터 유형: 숫자
    결과.관계.오류 각 객체가 이 종속 관계 CI를 처리하는 동안 발생한 오류를 설명하는 객체의 배열입니다.

    데이터 유형: 배열

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    결과.관계.오류.오류 이 종속 관계 CI를 처리하는 동안 발생한 오류의 유형입니다.

    데이터 유형: 문자열
    결과.관계.오류.메시지 이 종속 관계 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 부분 페이로드 [cmdb_ire_partial_payloads] 테이블에 삽입되었습니다.
    • NO_CHANGE: 종속 관계 CI에 대해 작업이 수행되지 않았습니다.
    • 업데이트: 대상 테이블의 기존 종속 관계 CI가 업데이트되었습니다.

    데이터 유형: 문자열
    결과.관계.경고 각 객체가 이 종속 관계 CI를 처리하는 동안 발생한 경고를 설명하는 객체의 배열입니다.

    데이터 유형: 배열

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    결과.관계.경고.오류 이 종속 관계 CI를 처리하는 동안 발생한 경고의 유형입니다.

    데이터 유형: 문자열
    result.relations.warnings.message 이 종속 관계 CI를 처리하는 동안 발생한 경고 메시지입니다.

    데이터 유형: 문자열

    cURL 요청

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

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

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

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

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

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

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

    이 메서드는 메서드와 식별 및 조정 - POST /now/identifyreconcile/query 비슷하지만 다음과 같은 기능을 추가합니다.
    • 부분 페이로드
      • 경고 또는 오류가 있는 항목의 경우 항목 작업이 INSERT_AS_PARTIAL인지 INSERT_INCOMPLETE인지를 나타냅니다.
      • 기존 부분 페이로드와 병합된 부분 페이로드의 sys_ids 반환합니다.
    • 페이로드 중복 제거 기능을 지원합니다.
    • 요약을 생성합니다.

    URL 형식

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

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

    지원되는 요청 매개변수

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

    데이터 유형: 문자열
    표 20. 쿼리 매개변수
    이름 설명
    옵션 요청에 적용된 고급 IRE 옵션을 나타내는 이름-값 쌍의 쉼표로 구분된 목록입니다.

    예를 들어, 부분 페이로드, 부분 커밋, 중복 제거 및 요약 생성 고급 IRE 옵션의 기본값을 재정의하려면 다음을 수행합니다.

    partial_payloads:거짓,partial_commits:거짓,deduplicate_payloads:거짓,generate_summary:참
    주:
    기본적으로 또는 가 true로 설정된 경우 partial_payloads , partial_commits 두 deduplicate_payloads 및 는 false로 설정된 경우에도 부분 페이로드 기능에 필수적이므로 활성화됩니다.

    향상된 IRE 옵션에 대한 자세한 내용은 IRE(식별 및 조정 엔진)를 참조하세요.

    각 이름-값 쌍의 유효한 값은 다음과 같습니다.
    • true: 이 향상된 IRE 옵션을 사용하도록 설정합니다.
    • false: 이 향상된 IRE 옵션을 사용하지 않도록 설정합니다.

    데이터 유형: 문자열
    sysparm_data_source CI 정보의 소스를 식별합니다. 이 값은 구성 항목 [cmdb_ci] 테이블의 discovery_source 필드에 대해 정의된 선택 값 중 하나여야 합니다.

    데이터 유형: 문자열

    기본값: API 페이로드를 불완전한 페이로드 테이블에 삽입합니다.
    표 21. 요청 본문 매개변수(XML 또는 JSON)
    이름 설명
    항목 각 개체가 만들거나 업데이트할 CI를 설명하는 개체의 배열입니다.

    데이터 유형: 배열

    "items": [
  {
    "className": "String",
    "internal_id": "String",
    "lookup": [Array],
    "related": [Array],
    "settings": {Object},
    "sys_object_source_info": {Object},
    "values": {Object}
  }
]
    items.className 필수 작성하거나 업데이트할 CI의 sys_class_name(클래스/테이블 이름)입니다. 이 값은 cmdb_ci_linux_server 또는 cmdb_ci_win_server와 같은 모든 CMDB 테이블이 될 수 있습니다.

    데이터 유형: 문자열
    items.internal_id 이 페이로드에 있는 이 항목의 고유 식별자입니다. 모든 값이 될 수 있지만 페이로드 내에서 고유해야 합니다.

    데이터 유형: 문자열
    items.lookup 각 객체가 조회 기반 식별 기록을 설명하는 객체의 배열입니다. 이러한 기록은 구성 항목 [cmdb_ci] 테이블에 대한 참조가 있는 조회 테이블을 기반으로 최상위 구성 항목을 식별하는 데 사용됩니다.

    데이터 유형: 배열

    "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에 대해 업데이트와 다운그레이드가 모두 허용되는지 여부를 나타냅니다.
    유효한 값은 다음과 같습니다.
    • true: 항목을 업데이트하지만 다운그레이드가 허용되지 않습니다.
    • false: 항목 업데이트와 다운그레이드가 모두 허용됩니다.

    데이터 유형: 부울

    기본값: false
    items.settings.updateWithoutSwitch 이 CI를 업데이트하고 클래스를 전환할 수 있는지 여부를 나타냅니다.
    유효한 값은 다음과 같습니다.
    • true: 항목을 업데이트하지만 클래스 전환이 허용되지 않습니다.
    • false: 항목 업데이트와 클래스 전환이 모두 허용됩니다.

    데이터 유형: 부울

    기본값: false
    items.settings.updateWithoutUpgrade 이 CI에 대해 업데이트와 업그레이드가 모두 허용되는지 여부를 나타냅니다.
    유효한 값은 다음과 같습니다.
    • true: 항목을 업데이트하지만 업그레이드가 허용되지 않습니다.
    • false: 항목 업데이트와 업그레이드가 모두 허용됩니다.

    데이터 유형: 부울

    기본값: false
    items.sys_object_source_info 고유 CI 식별자를 설명하는 객체입니다.

    데이터 유형: 객체

    "sys_object_source_info": {
  "source_feed": "String",
  "source_name": "String",  
  "source_native_key": "String",
  "source_recency_timestamp": "String"
}
    items.sys_object_source_info.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"
}
    참조 항목 각 객체가 페이로드의 두 항목 간 참조를 설명하는 객체의 배열입니다.

    데이터 유형: 배열

    "referenceItems": [
  {
    "referenced": "String",
    "referencedBy": "String",
    "referenceField": "String"
  }
]
    참조 항목.참조 internal_id 다른 항목에서 참조하는 항목에 대해 정의되었습니다.

    데이터 유형: 문자열
    참조 항목.참조된 사람 internal_id 다른 항목을 참조하는 항목에 대해 정의되었습니다.

    데이터 유형: 문자열
    referenceItems.referenceField 항목의 클래스/테이블에 있는 referencedBy 참조 필드의 이름입니다.

    데이터 유형: 문자열
    관계 각 객체가 페이로드에 정의된 두 항목 간의 관계를 설명하는 객체의 배열입니다.
    이 배열의 객체는 다음 두 가지 형식 중 하나를 사용할 수 있습니다.
    • 이 객체는 payload items 배열의 항목 인덱스를 나타내는 값을 사용하여 두 최상위 항목(전용) parentchild 및 이름-값 쌍 간의 관계를 정의할 수 있습니다.
    • 객체는 두 항목(최상위 항목, 관련 항목 또는 조회 항목 사용 parent_id ) 및 child_id 키/값 쌍을 포함하여 이러한 항목에 대해 정의된 값을 나타내는 internal_id 값으로 두 항목 간의 관계를 정의할 수 있습니다.

    데이터 유형: 배열

    "relations": [
  {
    "child": Number,
    "parent": Number,
    "sys_rel_source_info": {Object},
    "type": "String"
  }
]
    "relations": [
  {
    "child_id": "String",
    "parent_id": "String",
    "sys_rel_source_info": {Object},
    "type": "String"
  }
]
    relations.child 관계의 하위 항목을 나타내는 배열 내 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 검색 소스 내의 하위 검색/검사에 해당하는 모든 문자열입니다.

    기본값: '알 수 없음'은 sys_rel_source 테이블에서 기록을 작성할 때 source_feed 열에 저장됩니다.
    relations.type 상위 항목과 하위 항목 간에 존재하는 관계 유형입니다. 이는 CI 관계 유형 [cmdb_rel_type] 테이블의 이름 필드 값이어야 합니다.

    데이터 유형: 문자열

    헤더

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

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

    상태 코드

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

    표 24. 상태 코드
    상태 코드 설명
    200 성공입니다. 요청이 성공적으로 처리되었습니다.
    401 승인되지 않았습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다.
    500 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다.

    오류 메시지 세부 정보 "청크 [...] 이(가) 유효한 항목이 아닙니다"는 쿼리 매개 변수가 올바른 이름-값 쌍 형식이 아님을 options 나타냅니다.

    예를 들어 partial 매개 변수를 지정하면 options 메시지 세부 정보에 "Chunk [partial] is not a valid entry"와 함께 500 상태 코드가 생성됩니다.

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

    이름 설명
    결과 쿼리에서 생성된 결과의 배열입니다.

    데이터 유형: 배열

    "result": [
  "additionalCommittedItems": [Array],
  "additionalCommittedRelations": [Array],
  "items": [Array],
  "relations": [Array]
]
    result.additionalCommittedItems 각 개체가 삽입 또는 업데이트할 요청 본문 items 배열에 포함되지 않은 CI를 설명하는 객체의 배열입니다.

    데이터 유형: 배열

    "additionalCommittedItems": [
  {
    "className": "String",
    "errorCount": Number,
    "identificationAttempts": [Array],
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloads": [Array],
    "operation": "String",
    "sysId": "String"
  }
]
    result.additionalCommittedItems.className 이 추가 CI의 sys_class_name입니다.

    데이터 유형: 문자열
    result.additionalCommittedItems.errorCount 이 추가 CI를 처리하는 동안 발생한 오류 수입니다.

    데이터 유형: 숫자
    result.additionalCommittedItems.errors 각 객체가 이 추가 CI를 처리하는 동안 발생한 오류를 설명하는 객체의 배열입니다.

    데이터 유형: 배열

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    결과.추가커밋항목.오류.오류 이 추가 CI를 처리하는 동안 발생한 오류의 유형입니다.

    데이터 유형: 문자열
    result.additionalCommittedItems.errors.message 이 추가 CI를 처리하는 동안 발생한 오류 메시지입니다.

    데이터 유형: 문자열
    result.additionalCommittedItems.identificationAttempts 각 객체가 이 추가 CI를 식별하기 위한 시도를 설명하는 객체의 배열입니다.
    데이터 유형: 배열
    "identificationAttempts": [
  {
    "attemptResult": "String",
    "attributes": [Array],
    "hybridEntryCiAttributes": [Array],
    "identiferName": "String",
    "searchOnTable": [Array]
  }
]
    result.additionalCommittedItems.identificationAttempts.attemptResult 이 추가적인 CI 식별 시도의 결과입니다.
    가능한 값:
    • 일치: 식별에 성공했습니다. 지정된 속성과 정확히 일치하는 고유한 CI가 식별자 규칙 테이블에서 발견되었습니다.
    • MULTI_MATCH: 오류로 인해 식별에 실패했습니다. 지정된 속성과 일치할 때 식별자 규칙 테이블에서 중복 CI가 발견되었습니다.
    • NO_MATCH: 식별에 실패했습니다. 지정된 속성과 일치하는 식별자 규칙 테이블에서 CI를 찾을 수 없습니다.
    • 건너뜀: 식별을 시도하지 않았습니다. 이 식별자 규칙 테이블 검색에 필요한 속성이 제공되지 않았으므로 규칙이 적용되지 않았습니다.

    데이터 유형: 문자열
    result.additionalCommittedItems.identificationAttempts.attributes 이러한 추가적인 CI 식별 시도 중 사용되는 CI 식별자 항목 속성의 배열입니다.

    데이터 유형: 배열

    속성 이름과 유형은 요청 본문 데이터와 사용 중인 식별자(예: )에 따라 달라집니다.

    "attributes": [
  "serial_number": "String",
  "serial_number_type": "String",
]
    result.additionalCommittedItems.identificationAttempts.hybridEntryCiAttributes 이러한 추가적인 CI 식별 시도 중 사용되는 CI 식별자 항목 속성의 배열입니다.

    데이터 유형: 배열

    속성 이름과 유형은 요청 본문 데이터와 사용 중인 식별자(예: )에 따라 달라집니다.

    "hybridEntryCiAttributes": [
  "name": "String",
  "serial_number": "String"
]
    result.additionalCommittedItems.identificationAttempts.identifierName 이 추가적인 CI 식별 시도에 사용되는 식별자 규칙입니다.

    데이터 유형: 문자열
    result.additionalCommittedItems.identificationAttempts.searchOnTable 이 추가 CI 식별 시도를 검색하는 테이블의 이름입니다.

    데이터 유형: 문자열
    result.additionalCommittedItems.identifierEntrySysId 이 추가 CI를 식별하는 데 사용되는 식별자 규칙의 sys_id입니다.
    주목할 만한 가치:
    • 알 수 없음: 이 추가 CI를 식별하지 못했습니다. 자세한 내용은 errors 문서를 참조하십시오.

    데이터 유형: 문자열
    result.additionalCommittedItems.inputIndices 이 추가 CI에 해당하는 요청 본문 items 배열의 CI에 대한 인덱스 값 배열입니다.

    데이터 유형: 배열

    "inputIndices": [
  {
    Number
  }
]
    result.additionalCommittedItems.markers 내부에서 사용할 마커 값의 배열입니다.

    데이터 유형: 배열

    "markers": []
    result.additionalCommittedItems.mergedPayloads 이 추가 CI를 처리하는 동안 병합된 CMDB IRE 부분 페이로드 [cmdb_ire_partial_payloads] 테이블의 부분 페이로드에 대한 sys_id 값의 배열입니다.

    데이터 유형: 배열

    "mergedPayloadIds": [
  "String"
]
    result.additionalCommittedItems.operation 이 추가 CI에 대해 수행된 작업입니다.
    가능한 값:
    • 삭제: 기존 CI가 대상 테이블에서 제거됩니다.
    • 삽입: 추가 CI가 대상 테이블에 새 레코드로 삽입됩니다.
    • NO_CHANGE: 추가 CI에 대해서는 작업이 수행되지 않습니다.
    • 업데이트: 대상 테이블의 기존 CI가 업데이트됩니다.
    • UPDATE_WITH_DOWNGRADE: 대상 테이블의 기존 CI가 업데이트되고 해당 클래스가 보다 일반적인 클래스(상위 클래스)로 변경됩니다.
    • UPDATE_WITH_SWITCH: 대상 테이블의 기존 CI가 업데이트되고 해당 클래스가 상위 또는 하위 클래스가 아닌 다른 클래스로 변경됩니다.
    • UPDATE_WITH_UPGRADE: 대상 테이블의 기존 CI가 업데이트되고 해당 클래스가 보다 전문화된 클래스(하위 클래스)로 변경됩니다.

    데이터 유형: 문자열
    result.additionalCommittedItems.sysId 식별을 통해 이 추가 CI에 대해 찾은 sys_id입니다.
    주목할 만한 가치:
    • 알 수 없음: 이 추가 CI를 식별하지 못했습니다. 자세한 내용은 errors 문서를 참조하십시오.

    데이터 유형: 문자열
    result.additionalCommittedItems.warnings 각 객체가 이 추가 CI를 처리하는 동안 발생한 경고를 설명하는 객체의 배열입니다.

    데이터 유형: 배열

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    결과.추가커밋항목.경고.오류 이 추가 CI를 처리하는 동안 발생한 경고의 유형입니다.

    데이터 유형: 문자열
    result.additionalCommittedItems.warnings.message 이 추가 CI를 처리하는 동안 발생한 경고 메시지입니다.

    데이터 유형: 문자열
    result.additionalCommittedRelations 각 개체가 종속 관계를 설명하는 객체의 배열입니다. 삽입 또는 업데이트할 요청 본문 relations 목록에 포함되지 않은 CI입니다.

    데이터 유형: 배열

    "additionalCommittedRelations": [
  {
    "className": "String",
    "operation": "String",
    "markers": [Array],
    "inputIndices": [Array],
    "mergedPayloadIds": [Array]
  }
]
    result.additionalCommittedRelations.className 이 추가 종속 관계 CI의 sys_class_name입니다.
    지원되는 값만:
    • cmdb_rel_ci: CI 관계 테이블입니다.

    데이터 유형: 문자열
    result.additionalCommittedRelations.errorCount 이 추가 종속 관계 CI를 처리하는 동안 발생한 오류 수입니다.

    데이터 유형: 숫자
    result.additionalCommittedRelations.errors 각 객체가 이 추가 종속 관계 CI를 처리하는 동안 발생한 오류를 설명하는 객체의 배열입니다.

    데이터 유형: 배열

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    result.additionalCommittedRelations.errors.error 이 추가 종속 관계 CI를 처리하는 동안 발생한 오류의 유형입니다.

    데이터 유형: 문자열
    result.additionalCommittedRelations.errors.message 이 추가 종속 관계 CI를 처리하는 동안 발생한 오류 메시지입니다.

    데이터 유형: 문자열
    result.additionalCommittedRelations.inputIndices 이 추가 종속 관계 CI에 해당하는 요청 본문 relations 배열의 종속 관계 CI 객체에 대한 인덱스 값 배열입니다.

    데이터 유형: 배열

    "inputIndices": [
  Number
]
    result.additionalCommittedRelations.markers 내부에서 사용할 마커 값의 배열입니다.

    데이터 유형: 배열

    "markers": []
    result.additionalCommittedRelations.mergedPayloadIds 이 추가 종속 관계 CI를 처리하는 동안 병합된 CMDB IRE 부분 페이로드 [cmdb_ire_partial_payloads] 테이블의 부분 페이로드에 대한 sys_id 값의 배열입니다.

    데이터 유형: 배열

    "mergedPayloadIds": [
  "String"
]
    result.additionalCommittedRelations.operation 이 추가 종속 관계 CI에 대해 수행된 운영입니다.
    가능한 값:
    • 삽입: 종속 관계 CI가 대상 테이블에 새 기록으로 삽입됩니다.
    • INSERT_AS_INCOMPLETE: 종속 관계 CI에 오류가 있어 CMDB IRE 불완전한 페이로드 [cmdb_ire_incomplete_payloads] 테이블에 삽입됩니다.
    • INSERT_AS_PARTIAL: 종속 관계 CI에 오류가 있어 CMDB IRE 부분 페이로드 [cmdb_ire_partial_payloads] 테이블에 삽입됩니다.
    • NO_CHANGE: 종속 관계 CI에 대한 작업이 수행되지 않습니다.
    • 업데이트: 대상 테이블의 기존 종속 관계 CI가 업데이트됩니다.

    데이터 유형: 문자열
    결과.항목 각 객체가 요청 본문 items 배열에 포함된 CI를 설명하는 객체의 배열입니다.

    데이터 유형: 배열

    "items": [
  {
    "additionalRelatedItems": [Array],
    "className": "String",
    "duplicateLookupIndices": {Object},
    "errorCount": Number,
    "errors": [Array],
    "identificationAttempts": [Array],
    "identifierEntrySysId": "String",
    "info": [Array],
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloadIds": [Array],
    "operation": "String",
    "relatedItems": [Array],
    "relatedSysIds": [Array],
    "sysId": "String",
    "warnings": [Array]
  }
]
    result.items.additionalRelatedItems 각 객체가 CMDB IRE cmdb_ire_partial_payloads] 테이블의 관련 CI(테이블 조회 CI)를 설명하는 객체의 배열입니다.

    데이터 유형: 배열

    "additionalRelatedItems": [
  {
    "className": "String",
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloadIds": [Array],
    "sysId": "String"
  }
]
    result.items.additionalRelatedItems.className 관련 항목의 sys_class_name입니다.

    데이터 유형: 문자열
    result.items.additionalRelatedItems.inputIndices 이 관련 항목에 해당하는 요청 본문 items 배열의 CI에 대한 인덱스 값 배열입니다.

    데이터 유형: 배열

    "inputIndices": [
    Number
]
    result.items.additionalRelatedItems.markers 내부에서 사용할 마커 값의 배열입니다.

    데이터 유형: 배열

    "markers": []
    result.items.additionalRelatedItems.mergedPayloadIds 이 관련 항목을 처리하는 동안 병합된 CMDB IRE 부분 페이로드 [cmdb_ire_partial_payloads] 테이블의 부분 페이로드에 대한 sys_id 값의 배열입니다.

    데이터 유형: 배열

    "mergedPayloadIds": [
  "String"
]
    result.items.additionalRelatedItems.sysId 이 관련 CI의 sys_id입니다.

    데이터 유형: 문자열
    result.items.className 이 CI의 sys_class_name입니다.

    데이터 유형: 문자열
    result.items.duplicateLookupIndices 동일한 관련 CI를 참조하는 배열 요소의 인덱스 값 items.lookup 배열을 포함하는 객체입니다.

    배열 이름은 지정된 관련 CI를 참조하는 요청 본문 items.lookup 배열의 첫 번째 요소를 나타냅니다. 해당 값은 동일한 관련 CI를 참조하는 동일한 배열의 추가 요소 세트입니다.

    데이터 유형: 객체

    이 예는 배열의 두 번째 요소가 items.lookup 해당 배열의 이후 요소와 동일한 관련 CI를 참조하는 경우를 보여줍니다.

    "duplicateLookupIndices": [
  "2": [Array]
]
    result.items.errorCount 이 CI를 처리하는 동안 발생한 오류 수입니다.

    데이터 유형: 숫자
    결과.항목.오류 각 객체가 이 CI를 처리하는 동안 발생한 오류를 설명하는 객체의 배열입니다.

    데이터 유형: 배열

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    결과.항목.오류.오류 이 CI를 처리하는 동안 발생한 오류의 유형입니다.

    데이터 유형: 문자열
    결과.항목.오류.메시지 이 CI를 처리하는 동안 발생한 오류 메시지입니다.

    데이터 유형: 문자열
    result.items.identificationAttempts 각 객체가 이 CI를 식별하려는 시도를 설명하는 객체의 배열입니다.
    데이터 유형: 배열
    "identificationAttempts": [
  {
    "attemptResult": "String",
    "attributes": [Array],
    "hybridEntryCiAttributes": [Array],
    "identiferName": "String",
    "searchOnTable": [Array]
  }
]
    result.items.identificationAttempts.attemptResult 이 CI 식별 시도의 결과입니다.
    가능한 값:
    • 일치: 식별에 성공했습니다. 지정된 속성과 정확히 일치하는 고유한 CI가 식별자 규칙 테이블에서 발견되었습니다.
    • MULTI_MATCH: 오류로 인해 식별에 실패했습니다. 지정된 속성과 일치할 때 식별자 규칙 테이블에서 중복 CI가 발견되었습니다.
    • NO_MATCH: 식별에 실패했습니다. 지정된 속성과 일치하는 식별자 규칙 테이블에서 CI를 찾을 수 없습니다.
    • 건너뜀: 식별을 시도하지 않았습니다. 이 식별자 규칙 테이블 검색에 필요한 속성이 제공되지 않았으므로 규칙이 적용되지 않았습니다.

    데이터 유형: 문자열
    result.items.identificationAttempts.attributes 이 CI 식별 시도 동안 사용되는 CI 식별자 항목 속성의 배열입니다.

    데이터 유형: 배열

    속성 이름과 유형은 요청 본문 데이터와 사용 중인 식별자(예: )에 따라 달라집니다.

    "attributes": [
  "serial_number": "String",
  "serial_number_type": "String",
]
    result.items.identificationAttempts.hybridEntryCiAttributes 이 CI 식별 시도 동안 사용되는 CI 식별자 항목 속성의 배열입니다.

    데이터 유형: 배열

    속성 이름과 유형은 요청 본문 데이터와 사용 중인 식별자(예: )에 따라 달라집니다.

    "hybridEntryCiAttributes": [
  "name": "String",
  "serial_number": "String"
]
    result.items.identificationAttempts.identifierName 이 CI 식별 시도에 사용되는 식별자 규칙입니다.

    데이터 유형: 문자열
    result.items.identificationAttempts.searchOnTable 이 CI 식별 시도를 검색한 테이블의 이름입니다.

    데이터 유형: 문자열
    result.items.identifierEntrySysId 이 CI를 식별하는 데 사용되는 식별자 규칙의 sys_id입니다.
    주목할 만한 가치:
    • 알 수 없음: 이 CI를 식별하지 못했습니다. 자세한 내용은 errors 문서를 참조하십시오.

    데이터 유형: 문자열
    result.items.info 항목 처리에 대한 추가 정보가 들어 있는 객체의 목록입니다.

    데이터 유형: 배열

    "info": [
  {
    "code": "String",
    "message": "String",
    "ruleSysId": "String"
  }
]
    결과.항목.정보.코드 건너뛴 재분류 유형입니다.
    가능한 값:
    • SKIPPED_CLASS_SWITCH
    • SKIPPED_CLASS_DOWNGRADE
    • SKIPPED_CLASS_UPGRADE
    result.items.info.message 재분류를 건너뛰는 이유에 대한 추가 통찰력을 제공하는 메시지입니다.

    데이터 유형: 문자열
    result.items.info.ruleSysId 일치하는 재분류 제한 규칙의 Sys_id입니다. 재분류 제한 규칙으로 인해 IRE가 재분류를 건너뛸 때만 적용할 수 있습니다. 페이로드 또는 전역 플래그로 인해 재분류를 건너뛸 경우 이 값은 비어 있습니다.

    데이터 유형: 문자열
    result.items.inputIndices 이 CI에 해당하는 요청 본문 items 배열의 CI에 대한 인덱스 값 배열입니다.

    데이터 유형: 배열

    "inputIndices": [
  {
    Number
  }
]
    결과.항목.마커 내부에서 사용할 마커 값의 배열입니다.

    데이터 유형: 배열

    "markers": []
    result.items.mergedPayloadIds 이 CI를 처리하는 동안 병합된 CMDB IRE cmdb_ire_partial_payloads(부분 페이로드) 테이블의 부분 페이로드에 대한 sys_id 값의 배열입니다.

    데이터 유형: 배열

    "mergedPayloadIds": [
  "String"
]
    결과.항목.운영 이 CI에 대해 수행된 작업입니다.
    가능한 값:
    • 삭제: 기존 CI가 대상 테이블에서 제거됩니다.
    • 삽입: CI가 대상 테이블에 새 기록으로 삽입됩니다.
    • NO_CHANGE: CI에 대해 작업이 수행되지 않습니다.
    • 업데이트: 대상 테이블의 기존 CI가 업데이트됩니다.
    • UPDATE_WITH_DOWNGRADE: 대상 테이블의 기존 CI가 업데이트되고 해당 클래스가 보다 일반적인 클래스(상위 클래스)로 변경됩니다.
    • UPDATE_WITH_SWITCH: 대상 테이블의 기존 CI가 업데이트되고 해당 클래스가 상위 또는 하위 클래스가 아닌 다른 클래스로 변경됩니다.
    • UPDATE_WITH_UPGRADE: 대상 테이블의 기존 CI가 업데이트되고 해당 클래스가 보다 전문화된 클래스(하위 클래스)로 변경됩니다.

    데이터 유형: 문자열
    result.items.relatedItems 각 객체가 요청 본문 items.lookup 배열에서 관련 CI(테이블 조회 CI)를 설명하는 객체의 배열입니다.

    데이터 유형: 배열

    "relatedItems": [
  {
    "className": "String",
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloadIds": [Array],
    "sysId": "String"
  }
]
    result.items.relatedItems.className 관련 항목의 sys_class_name입니다.

    데이터 유형: 문자열
    result.items.relatedItems.inputIndices 요청 본문 items 의 CI 및 조회 항목과 이 관련 항목에 해당하는 배열의 인덱스 값 배열입니다 items.lookup .

    데이터 유형: 배열

    "inputIndices": [
  {
    "mainIndex": Number,
    "subIndex": Number
  }
]
    result.items.relatedItems.inputIndices.mainIndex 관련 항목의 CI 상위에 해당하는 요청 본문 items 배열의 인덱스 값입니다.

    데이터 유형: 숫자
    result.items.relatedItems.inputIndices.subIndex 관련 항목에 해당하는 요청 본문 items.lookup 배열의 인덱스 값입니다.

    데이터 유형: 숫자
    결과.항목.관련항목.마커 내부에서 사용할 마커 값의 배열입니다.

    데이터 유형: 배열

    "markers": []
    result.items.relatedItems.mergedPayloadIds 처리 중에 이 CI에 병합된 CMDB IRE 부분 페이로드 [cmdb_ire_partial_payloads] 테이블의 항목에 대한 sys_id 값의 배열입니다.

    데이터 유형: 배열

    "mergedPayloadIds": [
  "String"
]
    result.items.relatedSysIds 요청 본문 items.lookup 배열에서 관련 항목(테이블 조회 항목)에 대한 sys_id 값의 배열입니다.

    데이터 유형: 배열

    주목할 만한 가치:
    • null: 이 관련 항목에 대해 식별된 sys_id 없습니다.
    "relatedSysIds": [
    Number,
    Number
]
    result.items.sysId 식별을 통해 이 CI에 대해 찾은 sys_id입니다.
    주목할 만한 가치:
    • 알 수 없음: 이 CI를 식별하지 못했습니다. 자세한 내용은 errors 문서를 참조하십시오.

    데이터 유형: 문자열
    결과.항목.경고 각 객체가 이 CI를 처리하는 동안 발생한 경고를 설명하는 객체의 배열입니다.

    데이터 유형: 배열

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    결과.항목.경고.오류 이 CI를 처리하는 동안 발생한 경고 유형입니다.

    데이터 유형: 문자열
    result.items.warnings.message 이 CI를 처리하는 동안 발생한 경고 메시지입니다.

    데이터 유형: 문자열
    결과.logContextId 이 페이로드에 대해 보고된 컨텍스트 ID입니다.

    데이터 유형: 문자열
    결과.관계 각 객체가 요청 본문 relations 배열에서 종속 관계 CI를 설명하는 객체의 배열입니다.

    데이터 유형: 배열

    "relations": [
  {
    "className": "String",
    "errorCount": Number,
    "errors": [Array],
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloadIds": [Array],
    "operation": "String",
    "warnings": [Array]
  }
]
    result.relations.className 이 종속 관계 CI의 sys_class_name입니다.
    지원되는 값만:
    • cmdb_rel_ci: CI 관계 테이블입니다.

    데이터 유형: 문자열
    result.relations.errorCount 이 종속 관계 CI를 처리하는 동안 발생한 오류 수입니다.

    데이터 유형: 숫자
    결과.관계.오류 각 객체가 이 종속 관계 CI를 처리하는 동안 발생한 오류를 설명하는 객체의 배열입니다.

    데이터 유형: 배열

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    결과.관계.오류.오류 이 종속 관계 CI를 처리하는 동안 발생한 오류의 유형입니다.

    데이터 유형: 문자열
    결과.관계.오류.메시지 이 종속 관계 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 부분 페이로드 [cmdb_ire_partial_payloads] 테이블에 삽입되었습니다.
    • NO_CHANGE: 종속 관계 CI에 대해 작업이 수행되지 않았습니다.
    • 업데이트: 대상 테이블의 기존 종속 관계 CI가 업데이트되었습니다.

    데이터 유형: 문자열
    결과.관계.경고 각 객체가 이 종속 관계 CI를 처리하는 동안 발생한 경고를 설명하는 객체의 배열입니다.

    데이터 유형: 배열

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    결과.관계.경고.오류 이 종속 관계 CI를 처리하는 동안 발생한 경고의 유형입니다.

    데이터 유형: 문자열
    result.relations.warnings.message 이 종속 관계 CI를 처리하는 동안 발생한 경고 메시지입니다.

    데이터 유형: 문자열

    cURL 요청

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

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

    응답은 페이로드가 CMDB IRE 부분 페이로드 [cmdb_ire_partial_payloads] 테이블에 삽입됨을 보여줍니다.

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

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

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

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

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