식별 및 조정 API

  • 릴리스 버전: Zurich
  • 업데이트 날짜 2025년 07월 31일
  • 소요 시간: 181분

    • 식별 및 조정 API는 IRE(식별 및 조정 엔진)를 사용하여 중복 CI(구성 항목) 생성을 최소화하고 구성 관리 데이터베이스(CMDB).

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

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

    식별 및 조정 - POST /now/identifyreconcile

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

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

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

    URL 형식

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

    기본 URL: /api/now/identifyreconcile

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

    지원되는 요청 매개변수

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

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

    데이터 유형: 문자열

    기본값: 미완료 페이로드 테이블에 API 페이로드를 삽입합니다.
    표 3. 요청 본문 매개변수(XML 또는 JSON)
    이름 설명
    항목 만들거나 업데이트할 CI 목록입니다.

    데이터 유형: 객체 배열

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

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

    데이터 유형: 문자열
    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_adapterCMDB와 같은 클래스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}
  }
]
    항목.관련.클래스 이름 필수 작성하거나 업데이트할 관련 항목의 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
    items.values 이 CI에 대해 작성하거나 업데이트할 필드를 이름/값 쌍으로 설명하는 객체입니다. 여기서 이름은 필드 이름입니다. 참조 필드의 경우 값은 참조된 sys_id이어야 합니다.

    데이터 유형: 객체

    필드 이름과 유형은 다음과 같이 사용자가 선택한 필드에 따라 달라집니다.

    "values": {
  "host_name": "String",
  "ip_address": "String",
  "name": "String",
  "os_name": "String",
  "sys_class_name": "String"
}
    참조 항목 페이로드의 두 항목 간 참조 목록입니다. 각 참조 항목의 값은 클래스에 정의된 IRE 규칙을 사용하여 CI를 식별하기 전에 채워집니다.

    데이터 유형: 객체 배열

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

    데이터 유형: 문자열
    referenceItems.referencedBy internal_id 다른 항목을 참조하는 항목에 대해 정의됩니다.

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

    데이터 유형: 문자열
    관계 페이로드에 정의된 두 항목 간의 관계 목록입니다.
    이 배열의 객체는 다음 두 가지 형식 중 하나를 사용할 수 있습니다.
    • 이 객체는 페이로드 items 배열의 항목 인덱스를 나타내는 값을 사용하여 parent 두 개의 최상위 항목(전용)과 child 이름-값 쌍 간의 관계를 정의할 수 있습니다.
    • 개체는 키/값 쌍을 사용하여 parent_idchild_id 최상위 수준, 관련 항목 또는 조회 항목을 포함하여 두 항목 간의 관계를 정의할 수 있으며, 값은 해당 항목에 대해 정의된 값을 나타냅니다 internal_id .

    데이터 유형: 객체 배열

    "relations": [
  {
    "child": Number,
    "parent": Number,
    "sys_rel_source_info": {Object},
    "type": "String"
  }
]
    "relations": [
  {
    "child_id": "String",
    "parent_id": "String",
    "sys_rel_source_info": {Object},
    "type": "String"
  }
]
    관계.하위 관계에서 하위 항목을 나타내는 배열에 있는 items CI 객체의 정수 인덱스입니다.

    데이터 유형: 숫자
    relations.child_id 관계에 있는 하위 항목의 항목 internal_id 입니다.

    데이터 유형: 문자열
    관계.parent 관계의 상위를 나타내는 배열에 있는 items CI 객체의 정수 인덱스입니다.

    데이터 유형: 숫자
    relations.parent_id internal_id 관계의 상위 항목입니다.

    데이터 유형: 문자열
    relations.sys_rel_source_info 관계에 대한 검색 소스 정보입니다. 비의존성 관계의 경우 이 정보는 관계 소스[sys_rel_source] 테이블에 있습니다.

    데이터 유형: 객체

    "sys_rel_source_info": { 
  "source_name": "String", 
  "source_feed": "String" 
}
    relations.sys_rel_source_info.source_name 검색 소스 이름입니다.

    기본값: API 메서드 매개변수에 전달된 검색 소스입니다.
    relations.sys_rel_source_info.source_feed 디스커버리 소스 내의 하위 디스커버리/검사에 해당하는 모든 문자열입니다.

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

    데이터 유형: 문자열

    헤더

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

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

    상태 코드

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

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

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

    이름 설명
    결과 쿼리에서 생성된 결과 목록입니다.

    데이터 유형: 배열

    "result": [
  "additionalCommittedItems": [Array],
  "additionalCommittedRelations": [Array],
  "items": [Array],
  "relations": [Array]
]
    result.additionalCommittedItems 삽입하거나 업데이트할 요청 본문 items 배열에 포함되지 않은 CI 목록입니다.

    데이터 유형: 객체 배열

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

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

    데이터 유형: 숫자
    result.additionalCommittedItems.errors 이 추가 CI를 처리하는 동안 발생한 오류 목록입니다.

    데이터 유형: 객체 배열

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

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

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

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

    데이터 유형: 배열

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

    "attributes": [
  "serial_number": "String",
  "serial_number_type": "String"
]
    result.additionalCommittedItems.identificationAttempts.hybridEntryCiAttributes 이 추가 CI 식별 시도 중에 사용된 CI 식별자 항목 속성 목록입니다.

    데이터 유형: 배열

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

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

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

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

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

    데이터 유형: 객체 배열

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

    데이터 유형: 배열

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

    데이터 유형: 배열

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

    데이터 유형: 문자열
    result.additionalCommittedItems.sysId ID를 통해 이 추가 CI에 대한 Sys_id 찾을 수 있습니다.

    주목할 만한 값: 알 수 없음 - 이 추가 CI를 식별하지 못했습니다. 자세한 내용은 errors 문서를 참조하십시오.

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

    데이터 유형: 객체 배열

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    result.additionalCommittedItems.warnings.error 이 추가 CI를 처리하는 동안 발생한 경고 유형입니다.

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

    데이터 유형: 문자열
    result.additionalCommittedRelations 삽입하거나 업데이트할 요청 본문 relations 목록에 포함되지 않은 종속 관계 CI 목록입니다.

    데이터 유형: 객체 배열

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

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

    데이터 유형: 숫자
    결과.additionalCommittedRelations.errors 이 추가 종속 관계 CI를 처리하는 동안 발생한 오류 목록입니다.

    데이터 유형: 객체 배열

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

    데이터 유형: 문자열
    결과.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 Partial Payloads [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입니다.

    데이터 유형: 문자열
    결과.items.className 이 CI의 Sys_class_name입니다.

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

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

    데이터 유형: 객체

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

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

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

    데이터 유형: 객체 배열

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

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

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

    데이터 유형: 문자열
    결과.항목.식별시도.속성 이 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.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 CI의 인덱스 값 목록과 요청 본문 items 의 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
]
    결과.항목.sysId ID를 통해 이 CI에 대한 Sys_id 찾을 수 있습니다.
    주목할 만한 값:
    • 알 수 없음: 이 CI를 식별하지 못했습니다. 자세한 내용은 errors 문서를 참조하십시오.

    데이터 유형: 문자열
    결과.항목.경고 이 CI를 처리하는 동안 발생한 경고 목록입니다.

    데이터 유형: 객체 배열

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

    데이터 유형: 문자열
    결과.항목.경고.메시지 이 CI를 처리하는 동안 경고 메시지가 발생했습니다.

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

    데이터 유형: 문자열
    결과.관계 요청 본문 relations 배열의 종속 관계 CI 목록입니다.

    데이터 유형: 객체 배열

    "relations": [
  {
    "className": "String",
    "errorCount": Number,
    "errors": [Array],
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloadIds": [Array],
    "operation": "String",
    "warnings": [Array]
  }
]
    결과.관계.클래스 이름 이 종속 관계 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 Partial Payloads [cmdb_ire_partial_payloads] 테이블에 삽입되었습니다.
    • NO_CHANGE: 종속 관계 CI에 대해 작업이 수행되지 않았습니다.
    • 업데이트: 대상 테이블의 기존 종속 관계 CI가 업데이트되었습니다.

    데이터 유형: 문자열
    결과.관계.경고 이 종속 관계 CI를 처리하는 동안 발생한 경고 목록입니다.

    데이터 유형: 객체 배열

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

    데이터 유형: 문자열
    결과.관계.경고.메시지 이 종속 관계 CI를 처리하는 동안 경고 메시지가 발생했습니다.

    데이터 유형: 문자열

    cURL 요청

    IP 연결 종속 관계가 있는 Linux 서버(일련 번호 및 네트워크 어댑터 관련 항목 조회 포함) 및 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

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

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

    지원되는 요청 매개변수

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

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

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

    partial_payloads:false,partial_commits:false,deduplicate_payloads:false,generate_summary:true
    주:
    기본적으로 또는 true로 설정된 경우 partial_payloads 이러한 기능은 부분 페이로드 기능에 필수적이므로 false로 설정되어 있더라도 모두 partial_commitsdeduplicate_payloads 활성화됩니다.

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

    각 이름-값 쌍의 유효한 값:
    • true: 이 향상된 IRE 옵션을 활성화합니다.
    • false: 이 향상된 IRE 옵션을 비활성화합니다.

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

    데이터 유형: 문자열

    기본값: 미완료 페이로드 테이블에 API 페이로드를 삽입합니다.
    표 9. 요청 본문 매개변수(XML 또는 JSON)
    이름 설명
    항목 만들거나 업데이트할 CI 목록입니다.

    데이터 유형: 객체 배열

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

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

    데이터 유형: 문자열
    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_adapterCMDB와 같은 클래스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}
  }
]
    항목.관련.클래스 이름 필수 작성하거나 업데이트할 관련 항목의 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
    items.values 이 CI에 대해 작성하거나 업데이트할 필드를 이름/값 쌍으로 설명하는 객체입니다. 여기서 이름은 필드 이름입니다. 참조 필드의 경우 값은 참조된 sys_id이어야 합니다.

    데이터 유형: 객체

    필드 이름과 유형은 다음과 같이 사용자가 선택한 필드에 따라 달라집니다.

    "values": {
  "host_name": "String",
  "ip_address": "String",
  "name": "String",
  "os_name": "String",
  "sys_class_name": "String"
}
    참조 항목 페이로드의 두 항목 간 참조 목록입니다. 각 참조 항목의 값은 클래스에 정의된 IRE 규칙을 사용하여 CI를 식별하기 전에 채워집니다.

    데이터 유형: 객체 배열

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

    데이터 유형: 문자열
    referenceItems.referencedBy internal_id 다른 항목을 참조하는 항목에 대해 정의됩니다.

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

    데이터 유형: 문자열
    관계 페이로드에 정의된 두 항목 간의 관계 목록입니다.
    이 배열의 객체는 다음 두 가지 형식 중 하나를 사용할 수 있습니다.
    • 이 객체는 페이로드 items 배열의 항목 인덱스를 나타내는 값을 사용하여 parent 두 개의 최상위 항목(전용)과 child 이름-값 쌍 간의 관계를 정의할 수 있습니다.
    • 개체는 키/값 쌍을 사용하여 parent_idchild_id 최상위 수준, 관련 항목 또는 조회 항목을 포함하여 두 항목 간의 관계를 정의할 수 있으며, 값은 해당 항목에 대해 정의된 값을 나타냅니다 internal_id .

    데이터 유형: 객체 배열

    "relations": [
  {
    "child": Number,
    "parent": Number,
    "sys_rel_source_info": {Object},
    "type": "String"
  }
]
    "relations": [
  {
    "child_id": "String",
    "parent_id": "String",
    "sys_rel_source_info": {Object},
    "type": "String"
  }
]
    관계.하위 관계에서 하위 항목을 나타내는 배열에 있는 items CI 객체의 정수 인덱스입니다.

    데이터 유형: 숫자
    relations.child_id 관계에 있는 하위 항목의 항목 internal_id 입니다.

    데이터 유형: 문자열
    관계.parent 관계의 상위를 나타내는 배열에 있는 items CI 객체의 정수 인덱스입니다.

    데이터 유형: 숫자
    relations.parent_id internal_id 관계의 상위 항목입니다.

    데이터 유형: 문자열
    relations.sys_rel_source_info 관계에 대한 검색 소스 정보입니다. 비의존성 관계의 경우 이 정보는 관계 소스[sys_rel_source] 테이블에 있습니다.

    데이터 유형: 객체

    "sys_rel_source_info": { 
  "source_name": "String", 
  "source_feed": "String" 
}
    relations.sys_rel_source_info.source_name 검색 소스 이름입니다.

    기본값: API 메서드 매개변수에 전달된 검색 소스입니다.
    relations.sys_rel_source_info.source_feed 디스커버리 소스 내의 하위 디스커버리/검사에 해당하는 모든 문자열입니다.

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

    데이터 유형: 문자열

    헤더

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

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

    상태 코드

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

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

    오류 메시지 세부 정보 "Chunk [...] is not a valid entry"는 쿼리 매개변수가 options 올바른 이름-값 쌍 형식이 아님을 나타냅니다.

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

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

    이름 설명
    결과 쿼리에서 생성된 결과 목록입니다.

    데이터 유형: 배열

    "result": [
  "additionalCommittedItems": [Array],
  "additionalCommittedRelations": [Array],
  "items": [Array],
  "relations": [Array]
]
    result.additionalCommittedItems 삽입하거나 업데이트할 요청 본문 items 배열에 포함되지 않은 CI 목록입니다.

    데이터 유형: 객체 배열

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

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

    데이터 유형: 숫자
    result.additionalCommittedItems.errors 이 추가 CI를 처리하는 동안 발생한 오류 목록입니다.

    데이터 유형: 객체 배열

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

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

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

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

    데이터 유형: 배열

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

    "attributes": [
  "serial_number": "String",
  "serial_number_type": "String"
]
    result.additionalCommittedItems.identificationAttempts.hybridEntryCiAttributes 이 추가 CI 식별 시도 중에 사용된 CI 식별자 항목 속성 목록입니다.

    데이터 유형: 배열

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

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

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

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

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

    데이터 유형: 객체 배열

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

    데이터 유형: 배열

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

    데이터 유형: 배열

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

    데이터 유형: 문자열
    result.additionalCommittedItems.sysId ID를 통해 이 추가 CI에 대한 Sys_id 찾을 수 있습니다.

    주목할 만한 값: 알 수 없음 - 이 추가 CI를 식별하지 못했습니다. 자세한 내용은 errors 문서를 참조하십시오.

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

    데이터 유형: 객체 배열

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    result.additionalCommittedItems.warnings.error 이 추가 CI를 처리하는 동안 발생한 경고 유형입니다.

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

    데이터 유형: 문자열
    result.additionalCommittedRelations 삽입하거나 업데이트할 요청 본문 relations 목록에 포함되지 않은 종속 관계 CI 목록입니다.

    데이터 유형: 객체 배열

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

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

    데이터 유형: 숫자
    결과.additionalCommittedRelations.errors 이 추가 종속 관계 CI를 처리하는 동안 발생한 오류 목록입니다.

    데이터 유형: 객체 배열

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

    데이터 유형: 문자열
    결과.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 Partial Payloads [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입니다.

    데이터 유형: 문자열
    결과.items.className 이 CI의 Sys_class_name입니다.

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

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

    데이터 유형: 객체

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

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

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

    데이터 유형: 객체 배열

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

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

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

    데이터 유형: 문자열
    결과.항목.식별시도.속성 이 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.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 CI의 인덱스 값 목록과 요청 본문 items 의 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
]
    결과.항목.sysId ID를 통해 이 CI에 대한 Sys_id 찾을 수 있습니다.
    주목할 만한 값:
    • 알 수 없음: 이 CI를 식별하지 못했습니다. 자세한 내용은 errors 문서를 참조하십시오.

    데이터 유형: 문자열
    결과.항목.경고 이 CI를 처리하는 동안 발생한 경고 목록입니다.

    데이터 유형: 객체 배열

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

    데이터 유형: 문자열
    결과.항목.경고.메시지 이 CI를 처리하는 동안 경고 메시지가 발생했습니다.

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

    데이터 유형: 문자열
    결과.관계 요청 본문 relations 배열의 종속 관계 CI 목록입니다.

    데이터 유형: 객체 배열

    "relations": [
  {
    "className": "String",
    "errorCount": Number,
    "errors": [Array],
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloadIds": [Array],
    "operation": "String",
    "warnings": [Array]
  }
]
    결과.관계.클래스 이름 이 종속 관계 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 Partial Payloads [cmdb_ire_partial_payloads] 테이블에 삽입되었습니다.
    • NO_CHANGE: 종속 관계 CI에 대해 작업이 수행되지 않았습니다.
    • 업데이트: 대상 테이블의 기존 종속 관계 CI가 업데이트되었습니다.

    데이터 유형: 문자열
    결과.관계.경고 이 종속 관계 CI를 처리하는 동안 발생한 경고 목록입니다.

    데이터 유형: 객체 배열

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

    데이터 유형: 문자열
    결과.관계.경고.메시지 이 종속 관계 CI를 처리하는 동안 경고 메시지가 발생했습니다.

    데이터 유형: 문자열

    cURL 요청

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

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

    응답은 페이로드가 CMDB IRE 부분 페이로드 [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

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

    지원되는 요청 매개변수

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

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

    데이터 유형: 문자열

    기본값: 미완료 페이로드 테이블에 API 페이로드를 삽입합니다.
    표 15. 요청 본문 매개변수(XML 또는 JSON)
    이름 설명
    항목 만들거나 업데이트할 CI 목록입니다.

    데이터 유형: 객체 배열

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

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

    데이터 유형: 문자열
    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_adapterCMDB와 같은 클래스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}
  }
]
    항목.관련.클래스 이름 필수 작성하거나 업데이트할 관련 항목의 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
    items.values 이 CI에 대해 작성하거나 업데이트할 필드를 이름/값 쌍으로 설명하는 객체입니다. 여기서 이름은 필드 이름입니다. 참조 필드의 경우 값은 참조된 sys_id이어야 합니다.

    데이터 유형: 객체

    필드 이름과 유형은 다음과 같이 사용자가 선택한 필드에 따라 달라집니다.

    "values": {
  "host_name": "String",
  "ip_address": "String",
  "name": "String",
  "os_name": "String",
  "sys_class_name": "String"
}
    참조 항목 페이로드의 두 항목 간 참조 목록입니다. 각 참조 항목의 값은 클래스에 정의된 IRE 규칙을 사용하여 CI를 식별하기 전에 채워집니다.

    데이터 유형: 객체 배열

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

    데이터 유형: 문자열
    referenceItems.referencedBy internal_id 다른 항목을 참조하는 항목에 대해 정의됩니다.

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

    데이터 유형: 문자열
    관계 페이로드에 정의된 두 항목 간의 관계 목록입니다.
    이 배열의 객체는 다음 두 가지 형식 중 하나를 사용할 수 있습니다.
    • 이 객체는 페이로드 items 배열의 항목 인덱스를 나타내는 값을 사용하여 parent 두 개의 최상위 항목(전용)과 child 이름-값 쌍 간의 관계를 정의할 수 있습니다.
    • 개체는 키/값 쌍을 사용하여 parent_idchild_id 최상위 수준, 관련 항목 또는 조회 항목을 포함하여 두 항목 간의 관계를 정의할 수 있으며, 값은 해당 항목에 대해 정의된 값을 나타냅니다 internal_id .

    데이터 유형: 객체 배열

    "relations": [
  {
    "child": Number,
    "parent": Number,
    "sys_rel_source_info": {Object},
    "type": "String"
  }
]
    "relations": [
  {
    "child_id": "String",
    "parent_id": "String",
    "sys_rel_source_info": {Object},
    "type": "String"
  }
]
    관계.하위 관계에서 하위 항목을 나타내는 배열에 있는 items CI 객체의 정수 인덱스입니다.

    데이터 유형: 숫자
    relations.child_id 관계에 있는 하위 항목의 항목 internal_id 입니다.

    데이터 유형: 문자열
    관계.parent 관계의 상위를 나타내는 배열에 있는 items CI 객체의 정수 인덱스입니다.

    데이터 유형: 숫자
    relations.parent_id internal_id 관계의 상위 항목입니다.

    데이터 유형: 문자열
    relations.sys_rel_source_info 관계에 대한 검색 소스 정보입니다. 비의존성 관계의 경우 이 정보는 관계 소스[sys_rel_source] 테이블에 있습니다.

    데이터 유형: 객체

    "sys_rel_source_info": { 
  "source_name": "String", 
  "source_feed": "String" 
}
    relations.sys_rel_source_info.source_name 검색 소스 이름입니다.

    기본값: API 메서드 매개변수에 전달된 검색 소스입니다.
    relations.sys_rel_source_info.source_feed 디스커버리 소스 내의 하위 디스커버리/검사에 해당하는 모든 문자열입니다.

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

    데이터 유형: 문자열

    헤더

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

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

    상태 코드

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

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

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

    이름 설명
    결과 쿼리에서 생성된 결과 목록입니다.

    데이터 유형: 배열

    "result": [
  "additionalCommittedItems": [Array],
  "additionalCommittedRelations": [Array],
  "items": [Array],
  "relations": [Array]
]
    result.additionalCommittedItems 삽입하거나 업데이트할 요청 본문 items 배열에 포함되지 않은 CI 목록입니다.

    데이터 유형: 객체 배열

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

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

    데이터 유형: 숫자
    result.additionalCommittedItems.errors 이 추가 CI를 처리하는 동안 발생한 오류 목록입니다.

    데이터 유형: 객체 배열

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

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

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

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

    데이터 유형: 배열

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

    "attributes": [
  "serial_number": "String",
  "serial_number_type": "String"
]
    result.additionalCommittedItems.identificationAttempts.hybridEntryCiAttributes 이 추가 CI 식별 시도 중에 사용된 CI 식별자 항목 속성 목록입니다.

    데이터 유형: 배열

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

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

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

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

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

    데이터 유형: 객체 배열

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

    데이터 유형: 배열

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

    데이터 유형: 배열

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

    데이터 유형: 문자열
    result.additionalCommittedItems.sysId ID를 통해 이 추가 CI에 대한 Sys_id 찾을 수 있습니다.

    주목할 만한 값: 알 수 없음 - 이 추가 CI를 식별하지 못했습니다. 자세한 내용은 errors 문서를 참조하십시오.

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

    데이터 유형: 객체 배열

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    result.additionalCommittedItems.warnings.error 이 추가 CI를 처리하는 동안 발생한 경고 유형입니다.

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

    데이터 유형: 문자열
    result.additionalCommittedRelations 삽입하거나 업데이트할 요청 본문 relations 목록에 포함되지 않은 종속 관계 CI 목록입니다.

    데이터 유형: 객체 배열

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

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

    데이터 유형: 숫자
    결과.additionalCommittedRelations.errors 이 추가 종속 관계 CI를 처리하는 동안 발생한 오류 목록입니다.

    데이터 유형: 객체 배열

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

    데이터 유형: 문자열
    결과.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 Partial Payloads [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입니다.

    데이터 유형: 문자열
    결과.items.className 이 CI의 Sys_class_name입니다.

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

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

    데이터 유형: 객체

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

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

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

    데이터 유형: 객체 배열

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

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

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

    데이터 유형: 문자열
    결과.항목.식별시도.속성 이 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.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 CI의 인덱스 값 목록과 요청 본문 items 의 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
]
    결과.항목.sysId ID를 통해 이 CI에 대한 Sys_id 찾을 수 있습니다.
    주목할 만한 값:
    • 알 수 없음: 이 CI를 식별하지 못했습니다. 자세한 내용은 errors 문서를 참조하십시오.

    데이터 유형: 문자열
    결과.항목.경고 이 CI를 처리하는 동안 발생한 경고 목록입니다.

    데이터 유형: 객체 배열

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

    데이터 유형: 문자열
    결과.항목.경고.메시지 이 CI를 처리하는 동안 경고 메시지가 발생했습니다.

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

    데이터 유형: 문자열
    결과.관계 요청 본문 relations 배열의 종속 관계 CI 목록입니다.

    데이터 유형: 객체 배열

    "relations": [
  {
    "className": "String",
    "errorCount": Number,
    "errors": [Array],
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloadIds": [Array],
    "operation": "String",
    "warnings": [Array]
  }
]
    결과.관계.클래스 이름 이 종속 관계 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 Partial Payloads [cmdb_ire_partial_payloads] 테이블에 삽입되었습니다.
    • NO_CHANGE: 종속 관계 CI에 대해 작업이 수행되지 않았습니다.
    • 업데이트: 대상 테이블의 기존 종속 관계 CI가 업데이트되었습니다.

    데이터 유형: 문자열
    결과.관계.경고 이 종속 관계 CI를 처리하는 동안 발생한 경고 목록입니다.

    데이터 유형: 객체 배열

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

    데이터 유형: 문자열
    결과.관계.경고.메시지 이 종속 관계 CI를 처리하는 동안 경고 메시지가 발생했습니다.

    데이터 유형: 문자열

    cURL 요청

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

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

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

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

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

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

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

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

    URL 형식

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

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

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

    지원되는 요청 매개변수

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

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

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

    partial_payloads:false,partial_commits:false,deduplicate_payloads:false,generate_summary:true
    주:
    기본적으로 또는 true로 설정된 경우 partial_payloads 이러한 기능은 부분 페이로드 기능에 필수적이므로 false로 설정되어 있더라도 모두 partial_commitsdeduplicate_payloads 활성화됩니다.

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

    각 이름-값 쌍의 유효한 값:
    • true: 이 향상된 IRE 옵션을 활성화합니다.
    • false: 이 향상된 IRE 옵션을 비활성화합니다.

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

    데이터 유형: 문자열

    기본값: 미완료 페이로드 테이블에 API 페이로드를 삽입합니다.
    표 21. 요청 본문 매개변수(XML 또는 JSON)
    이름 설명
    항목 만들거나 업데이트할 CI 목록입니다.

    데이터 유형: 객체 배열

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

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

    데이터 유형: 문자열
    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_adapterCMDB와 같은 클래스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}
  }
]
    항목.관련.클래스 이름 필수 작성하거나 업데이트할 관련 항목의 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
    items.values 이 CI에 대해 작성하거나 업데이트할 필드를 이름/값 쌍으로 설명하는 객체입니다. 여기서 이름은 필드 이름입니다. 참조 필드의 경우 값은 참조된 sys_id이어야 합니다.

    데이터 유형: 객체

    필드 이름과 유형은 다음과 같이 사용자가 선택한 필드에 따라 달라집니다.

    "values": {
  "host_name": "String",
  "ip_address": "String",
  "name": "String",
  "os_name": "String",
  "sys_class_name": "String"
}
    참조 항목 페이로드의 두 항목 간 참조 목록입니다. 각 참조 항목의 값은 클래스에 정의된 IRE 규칙을 사용하여 CI를 식별하기 전에 채워집니다.

    데이터 유형: 객체 배열

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

    데이터 유형: 문자열
    referenceItems.referencedBy internal_id 다른 항목을 참조하는 항목에 대해 정의됩니다.

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

    데이터 유형: 문자열
    관계 페이로드에 정의된 두 항목 간의 관계 목록입니다.
    이 배열의 객체는 다음 두 가지 형식 중 하나를 사용할 수 있습니다.
    • 이 객체는 페이로드 items 배열의 항목 인덱스를 나타내는 값을 사용하여 parent 두 개의 최상위 항목(전용)과 child 이름-값 쌍 간의 관계를 정의할 수 있습니다.
    • 개체는 키/값 쌍을 사용하여 parent_idchild_id 최상위 수준, 관련 항목 또는 조회 항목을 포함하여 두 항목 간의 관계를 정의할 수 있으며, 값은 해당 항목에 대해 정의된 값을 나타냅니다 internal_id .

    데이터 유형: 객체 배열

    "relations": [
  {
    "child": Number,
    "parent": Number,
    "sys_rel_source_info": {Object},
    "type": "String"
  }
]
    "relations": [
  {
    "child_id": "String",
    "parent_id": "String",
    "sys_rel_source_info": {Object},
    "type": "String"
  }
]
    관계.하위 관계에서 하위 항목을 나타내는 배열에 있는 items CI 객체의 정수 인덱스입니다.

    데이터 유형: 숫자
    relations.child_id 관계에 있는 하위 항목의 항목 internal_id 입니다.

    데이터 유형: 문자열
    관계.parent 관계의 상위를 나타내는 배열에 있는 items CI 객체의 정수 인덱스입니다.

    데이터 유형: 숫자
    relations.parent_id internal_id 관계의 상위 항목입니다.

    데이터 유형: 문자열
    relations.sys_rel_source_info 관계에 대한 검색 소스 정보입니다. 비의존성 관계의 경우 이 정보는 관계 소스[sys_rel_source] 테이블에 있습니다.

    데이터 유형: 객체

    "sys_rel_source_info": { 
  "source_name": "String", 
  "source_feed": "String" 
}
    relations.sys_rel_source_info.source_name 검색 소스 이름입니다.

    기본값: API 메서드 매개변수에 전달된 검색 소스입니다.
    relations.sys_rel_source_info.source_feed 디스커버리 소스 내의 하위 디스커버리/검사에 해당하는 모든 문자열입니다.

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

    데이터 유형: 문자열

    헤더

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

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

    상태 코드

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

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

    오류 메시지 세부 정보 "Chunk [...] is not a valid entry"는 쿼리 매개변수가 options 올바른 이름-값 쌍 형식이 아님을 나타냅니다.

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

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

    이름 설명
    결과 쿼리에서 생성된 결과 목록입니다.

    데이터 유형: 배열

    "result": [
  "additionalCommittedItems": [Array],
  "additionalCommittedRelations": [Array],
  "items": [Array],
  "relations": [Array]
]
    result.additionalCommittedItems 삽입하거나 업데이트할 요청 본문 items 배열에 포함되지 않은 CI 목록입니다.

    데이터 유형: 객체 배열

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

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

    데이터 유형: 숫자
    result.additionalCommittedItems.errors 이 추가 CI를 처리하는 동안 발생한 오류 목록입니다.

    데이터 유형: 객체 배열

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

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

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

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

    데이터 유형: 배열

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

    "attributes": [
  "serial_number": "String",
  "serial_number_type": "String"
]
    result.additionalCommittedItems.identificationAttempts.hybridEntryCiAttributes 이 추가 CI 식별 시도 중에 사용된 CI 식별자 항목 속성 목록입니다.

    데이터 유형: 배열

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

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

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

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

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

    데이터 유형: 객체 배열

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

    데이터 유형: 배열

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

    데이터 유형: 배열

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

    데이터 유형: 문자열
    result.additionalCommittedItems.sysId ID를 통해 이 추가 CI에 대한 Sys_id 찾을 수 있습니다.

    주목할 만한 값: 알 수 없음 - 이 추가 CI를 식별하지 못했습니다. 자세한 내용은 errors 문서를 참조하십시오.

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

    데이터 유형: 객체 배열

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    result.additionalCommittedItems.warnings.error 이 추가 CI를 처리하는 동안 발생한 경고 유형입니다.

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

    데이터 유형: 문자열
    result.additionalCommittedRelations 삽입하거나 업데이트할 요청 본문 relations 목록에 포함되지 않은 종속 관계 CI 목록입니다.

    데이터 유형: 객체 배열

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

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

    데이터 유형: 숫자
    결과.additionalCommittedRelations.errors 이 추가 종속 관계 CI를 처리하는 동안 발생한 오류 목록입니다.

    데이터 유형: 객체 배열

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

    데이터 유형: 문자열
    결과.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 Partial Payloads [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입니다.

    데이터 유형: 문자열
    결과.items.className 이 CI의 Sys_class_name입니다.

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

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

    데이터 유형: 객체

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

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

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

    데이터 유형: 객체 배열

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

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

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

    데이터 유형: 문자열
    결과.항목.식별시도.속성 이 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.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 CI의 인덱스 값 목록과 요청 본문 items 의 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
]
    결과.항목.sysId ID를 통해 이 CI에 대한 Sys_id 찾을 수 있습니다.
    주목할 만한 값:
    • 알 수 없음: 이 CI를 식별하지 못했습니다. 자세한 내용은 errors 문서를 참조하십시오.

    데이터 유형: 문자열
    결과.항목.경고 이 CI를 처리하는 동안 발생한 경고 목록입니다.

    데이터 유형: 객체 배열

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

    데이터 유형: 문자열
    결과.항목.경고.메시지 이 CI를 처리하는 동안 경고 메시지가 발생했습니다.

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

    데이터 유형: 문자열
    결과.관계 요청 본문 relations 배열의 종속 관계 CI 목록입니다.

    데이터 유형: 객체 배열

    "relations": [
  {
    "className": "String",
    "errorCount": Number,
    "errors": [Array],
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloadIds": [Array],
    "operation": "String",
    "warnings": [Array]
  }
]
    결과.관계.클래스 이름 이 종속 관계 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 Partial Payloads [cmdb_ire_partial_payloads] 테이블에 삽입되었습니다.
    • NO_CHANGE: 종속 관계 CI에 대해 작업이 수행되지 않았습니다.
    • 업데이트: 대상 테이블의 기존 종속 관계 CI가 업데이트되었습니다.

    데이터 유형: 문자열
    결과.관계.경고 이 종속 관계 CI를 처리하는 동안 발생한 경고 목록입니다.

    데이터 유형: 객체 배열

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

    데이터 유형: 문자열
    결과.관계.경고.메시지 이 종속 관계 CI를 처리하는 동안 경고 메시지가 발생했습니다.

    데이터 유형: 문자열

    cURL 요청

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

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

    응답은 페이로드가 CMDB IRE 부분 페이로드 [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
      }
    }
  }
}