識別および調整 API

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間：198分

    • 識別および調整 API は、識別および調整エンジン (IRE) を使用して、重複する構成アイテム (CI) の作成を最小限に抑え、構成管理データベース (CMDB) の更新時に許可されたソースからの情報のみを受け入れることで CI 属性を調整するエンドポイントを提供します。

    ユーザーがこの API を使用するには、itil または asset ロールが必要です。

    IRE の詳細については、「 識別および調整エンジン (IRE)」を参照してください。

    識別および調整 - POST /now/identifyreconcile

    指定されたペイロード (要求本文) に識別および調整ルールを適用して、CMDB の構成アイテム (CI) を挿入または更新します。CMDB を直接更新する代わりに、この API を使用します。

    識別および調整 - POST /now/identifyreconcile/query エンドポイントを使用して、データベースへの変更をコミットせずに、このエンドポイントへのペイロードの送信をシミュレートします。

    拡張 IRE オプションを指定する必要がある場合は、代わりに 識別および調整 - POST /now/identifyreconcile/enhanced エンドポイントを使用します。拡張 IRE オプションの詳細については、「 識別および調整エンジン (IRE)」を参照してください。

    URL 形式

    バージョニングされた URL：/api/now/{api_version}/identifyreconcile

    デフォルトの URL：/api/now/identifyreconcile

    注:
    利用可能なバージョンは、 REST API エクスプローラーで指定されます。スクリプト済み REST API の場合、[ スクリプト済み REST サービス] フォームに追加のバージョン情報があります。

    サポートされている要求パラメーター

    表 : 1. パスパラメーター
    名前 説明
    api_version オプションアクセスするエンドポイントのバージョン。たとえば、v1 や v2 などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。

    データタイプ：文字列
    表 : 2. クエリパラメーター
    名前 説明
    sysparm_data_source CI 情報のソース。これは、構成アイテム [cmdb_ci] テーブルの discovery_source フィールドに定義された選択値の 1 つである必要があります。

    データタイプ：文字列

    デフォルト：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] テーブルへの参照を含むルックアップテーブルに基づいて最上位レベルの構成アイテムを識別するために使用されます。

    データタイプ: Array off Objects

    "lookup": [
  {
    "className": "String",
    "internal_id": "String",
    "sys_object_source_info": {Object},
    "values": {Object}
  }
]
    items.lookup.className 必須です。作成または更新する CI の sys_class_name またはクラス/テーブル名。この値は、cmdb_serial_number や cmdb_ci_network_adapter などの任意の CMDB クラス/テーブルまたは非 CMDB 階層クラスにすることができます。

    データタイプ：文字列
    items.lookup.internal_id このペイロードのこのルックアップレコードの一意の識別子。任意の値にすることができますが、ペイロード内で一意である必要があります。

    データタイプ：文字列
    items.lookup.sys_object_source_info 指定されたデータソースの一意の CI 識別子を記述するオブジェクト。同じ CI でもソースが異なると、名前と値のペアが異なる場合があります。

    データタイプ：オブジェクト

    "sys_object_source_info": {
  "source_feed": "String",
  "source_name": "String",  
  "source_native_key": "String",
  "source_recency_timestamp": "String"
}
    items.lookup.sys_object_source_info.source_feed この CI を送信するフィードを一意に識別する名前。ソースが複数のフィードを持つことができる場合に使用します。

    データタイプ：文字列
    items.lookup.sys_object_source_info.source_name CI 情報のデータソース。この値は、構成アイテム [cmdb_ci] テーブルの discovery_source フィールドに定義された選択値の 1 つである必要があります。

    データタイプ：文字列
    items.lookup.sys_object_source_info.source_native_key CI のソースからの一意のキー/ID。アイテムに固有の任意の文字列にすることができます。

    データタイプ：文字列
    items.lookup.sys_object_source_info.source_recency_timestamp CI がスキャンされた UTC 日時。

    データタイプ：文字列

    形式：YYYY-MM-DD hh:mm:ss
    items.lookup.values このルックアップアイテムのフィールドを名前/値のペアとして記述するオブジェクト。名前はフィールド名です。

    データタイプ：オブジェクト

    フィールド名とタイプは、次のようにユーザーが選択したフィールドによって異なります。

    "values": {
  "ip_address": "String",
  "mac_address": "String",
  "serial_number": "String",
  "serial_number_type": "String",
  "valid": "String"
}
    items.related 識別される最上位レベル CI への参照を持つ関連テーブルに基づいて、各オブジェクトが作成または更新するアイテムレコードを説明するオブジェクトのアレイ。関連エントリ [cmdb_related_entry] テーブルのルールは、このアレイに含めることができるレコードのタイプを定義します。

    関連するテーブルは、構成アイテム [cmdb_ci] テーブルを拡張する場合もあれば拡張しない場合もあります。これらのレコードは、構成アイテムの識別には使用されません。

    データタイプ：オブジェクトのアレイ

    "related": [
  {
    "className": "String",
    "internal_id": "String",
    "sys_object_source_info": {Object},
    "values": {Object}
  }
]
    items.related.className 必須です。作成または更新する関連アイテムの sys_class_name またはクラス/テーブル名。

    データタイプ：文字列
    items.related.internal_id このペイロードのこの関連アイテムの一意の識別子。任意の値にすることができますが、ペイロード内で一意である必要があります。

    データタイプ：文字列
    items.related.sys_object_source_info 指定されたデータソースの一意の CI 識別子を記述するオブジェクト。同じ CI でもソースが異なると、名前と値のペアが異なる場合があります。

    データタイプ：オブジェクト

    "sys_object_source_info": {
  "source_feed": "String",
  "source_name": "String",  
  "source_native_key": "String",
  "source_recency_timestamp": "String"
}
    items.related.sys_object_source_info.source_feed この関連アイテムを送信するフィードを一意に識別する名前。ソースが複数のフィードを持つことができる場合に使用します。

    データタイプ：文字列
    items.related.sys_object_source_info.source_name 関連アイテム情報のデータソース。この値は、構成アイテム [cmdb_ci] テーブルの discovery_source フィールドに定義された選択値の 1 つである必要があります。

    データタイプ：文字列
    items.related.sys_object_source_info.source_native_key 関連アイテムのソースからの一意のキー/ID。アイテムに固有の任意の文字列にすることができます。

    データタイプ：文字列
    items.related.sys_object_source_info.source_recency_timestamp 関連アイテムがスキャンされた UTC 日時。

    データタイプ：文字列

    形式：YYYY-MM-DD hh:mm:ss
    items.related.values この関連アイテム用に名前/値のペアとして作成または更新するフィールドを説明するオブジェクト。名前はフィールド名です。参照フィールドの場合、値は参照される sys_id である必要があります。

    データタイプ：オブジェクト

    フィールド名とタイプは、次のようにユーザーが選択したフィールドによって異なります。

    "values": {
  "host_name": "String",
  "ip_address": "String",
  "name": "String",
  "os_name": "String",
  "sys_class_name": "String"
}
    items.settings 許可される更新のタイプを定義するパラメーターが含まれるオブジェクト。

    データタイプ：オブジェクト

    "settings": {
  "skipReclassificationRestrictionRules": Boolean,
  "updateWithoutDowngrade": Boolean,
  "updateWithoutSwitch": Boolean,
  "updateWithoutUpgrade": Boolean
}
    items.settings.skipReclassificationRestrictionRules IRE がペイロードアイテムのクラスに一致する再分類制限ルールの実行をスキップすべきかどうかを示すフラグ。
    有効な値：
    • true：ルールの実行をスキップします。
    • false：ルールを実行します。

    デフォルト値：false
    items.settings.updateWithoutDowngrade この CI に対して更新とダウングレードの両方を許可するかどうかを示すフラグ。
    有効な値：
    • true：アイテムを更新しますが、ダウングレードは許可されません。
    • false：アイテムの更新とダウングレードの両方が許可されます。

    データタイプ：ブール

    デフォルト値：false
    items.settings.updateWithoutSwitch この CI を更新してクラスを切り替えることができるかどうかを示すフラグ。
    有効な値：
    • true：アイテムを更新しますが、クラスの切り替えは許可されません。
    • false：アイテムの更新とクラスの切り替えの両方が許可されます。

    データタイプ：ブール

    デフォルト値：false
    items.settings.updateWithoutUpgrade この CI に対して更新とアップグレードの両方を許可するかどうかを示すフラグ。
    有効な値：
    • true：アイテムを更新しますが、アップグレードは許可されません。
    • false：アイテムの更新とアップグレードの両方が許可されます。

    データタイプ：ブール

    デフォルト値：false
    items.sys_object_source_info 一意の CI 識別子を記述するオブジェクト。

    データタイプ：オブジェクト

    "sys_object_source_info": {
  "source_feed": "String",
  "source_name": "String",  
  "source_native_key": "String",
  "source_recency_timestamp": "String"
}
    items.sys_object_source_info.source_feed この CI を送信するフィードを一意に識別する名前。ソースが複数のフィードを持つことができる場合に使用します。

    データタイプ：文字列
    items.sys_object_source_info.source_name CI 情報のデータソース。この値は、構成アイテム [cmdb_ci] テーブルの discovery_source フィールドに定義された選択値の 1 つである必要があります。

    データタイプ：文字列
    items.sys_object_source_info.source_native_key CI のソースからの一意のキー/ID。アイテムに固有の任意の文字列にすることができます。

    データタイプ：文字列
    items.sys_object_source_info.source_recency_timestamp CI がスキャンされた UTC 日時。

    データタイプ：文字列

    形式：YYYY-MM-DD hh:mm:ss
    items.values この CI 用に名前/値のペアとして作成または更新するフィールドを説明するオブジェクト。名前はフィールド名です。参照フィールドの場合、値は参照される sys_id である必要があります。

    データタイプ：オブジェクト

    フィールド名とタイプは、次のようにユーザーが選択したフィールドによって異なります。

    "values": {
  "host_name": "String",
  "ip_address": "String",
  "name": "String",
  "os_name": "String",
  "sys_class_name": "String"
}
    referenceItems ペイロード内の 2 つのアイテム間の参照のリスト。

    データタイプ：オブジェクトのアレイ

    "referenceItems": [
  {
    "referenced": "String",
    "referencedBy": "String",
    "referenceField": "String"
  }
]
    referenceItems.referenced 別のアイテムによって参照されているアイテムに対して定義された internal_id。

    データタイプ：文字列
    referenceItems.referencedBy 別のアイテムを参照するアイテムに対して定義された internal_id。

    データタイプ：文字列
    referenceItems.referenceField referencedBy アイテムのクラス/テーブル内の参照フィールドの名前。

    データタイプ：文字列
    relations ペイロードで定義された 2 つのアイテム間の関係のリスト。
    このアレイ内のオブジェクトは、2 つの形式のいずれかを使用できます。
    • オブジェクトは、parent および child の名前と値のペアを使用して 2 つのトップレベルアイテム (のみ) の間の関係を定義できます。この値はペイロード items アレイのアイテムインデックスを表します。
    • オブジェクトは、parent_id および child_id のキー/値のペアを使用して、最上位レベルのアイテム、関連するアイテム、ルックアップアイテムを含む任意の 2 つのアイテム間の関係を定義できます。この値は、それらのアイテムに対して定義された internal_id 値を表します。

    データタイプ：オブジェクトのアレイ

    "relations": [
  {
    "child": Number,
    "parent": Number,
    "sys_rel_source_info": {Object},
    "type": "String"
  }
]
    "relations": [
  {
    "child_id": "String",
    "parent_id": "String",
    "sys_rel_source_info": {Object},
    "type": "String"
  }
]
    relations.child 関係内の子を表す items アレイ内の CI オブジェクトの整数インデックス。

    データタイプ：数値
    relations.child_id 関係内の子アイテムの internal_id。

    データタイプ：文字列
    relations.parent 関係内の親を表す items アレイ内の CI オブジェクトの整数インデックス。

    データタイプ：数値
    relations.parent_id 関係内の親アイテムの internal_id。

    データタイプ：文字列
    relations.sys_rel_source_info 関係の検出ソース情報。非依存関係の場合、この情報は関係ソース [sys_rel_source] テーブルにあります。

    データタイプ：オブジェクト

    "sys_rel_source_info": { 
  "source_name": "String", 
  "source_feed": "String" 
}
    relations.sys_rel_source_info.source_name 検出ソース名。

    デフォルト：API メソッドパラメーターで渡される検出ソース。
    relations.sys_rel_source_info.source_feed 検出ソース内のサブ検出/スキャンである文字列。

    デフォルト値：「UNKNOWN」は、sys_rel_source テーブルにレコードを作成するときに source_feed 列に格納されます。
    relations.type 親アイテムと子アイテムの間に存在する関係のタイプ。これは、CI 関係タイプ [cmdb_rel_type] テーブルからの名前フィールド値である必要があります。

    データタイプ：文字列

    ヘッダー

    次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 サポートされている REST API ヘッダー」を参照してください。

    表 : 4. 要求ヘッダー
    ヘッダー 説明
    承認 応答本文のデータフォーマット。application/json のみをサポートします。
    Content-Type 要求本文のデータ形式。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 が識別子ルールテーブルで見つかりませんでした。
    • SKIPPED：識別は試行されませんでした。この識別子ルールテーブルの検索に必要な属性が指定されなかったため、ルールは適用されませんでした。

    データタイプ：文字列
    result.additionalCommittedItems.identificationAttempts.attributes この追加の CI の識別の試行中に使用される CI ID エントリ属性のアレイ。

    データタイプ：アレイ

    属性の名前とタイプは、次のような使用される要求本文データと識別子によって異なります。

    "attributes": [
  "serial_number": "String",
  "serial_number_type": "String"
]
    result.additionalCommittedItems.identificationAttempts.hybridEntryCiAttributes この追加の CI 識別試行中に使用された CI ID エントリー属性のリスト。

    データタイプ：アレイ

    属性の名前とタイプは、次のような使用される要求本文データと識別子によって異なります。

    "hybridEntryCiAttributes": [
  "name": "String",
  "serial_number": "String"
]
    result.additionalCommittedItems.identificationAttempts.identifierName この追加の CI 識別の試行に使用される識別子ルール。

    データタイプ：文字列
    result.additionalCommittedItems.identificationAttempts.searchOnTable この追加の CI 識別の試行で検索されたテーブルの名前。

    データタイプ：文字列
    result.additionalCommittedItems.identifierEntrySysId この追加の CI を識別するために使用される識別子ルールの sys_id。
    注目すべき値：
    • Unknown：この追加の CI の識別に失敗しました。詳細については、「errors」を参照してください。

    データタイプ：文字列
    result.additionalCommittedItems.inputIndices この追加の CI に対応する要求本文 items アレイの CI のインデックス値のリスト。

    データタイプ：オブジェクトのアレイ

    "inputIndices": [
  {
    Number
  }
]
    result.additionalCommittedItems.markers 内部使用のためのマーカー値のリスト。

    データタイプ：アレイ

    "markers": []
    result.additionalCommittedItems.mergedPayloads この追加 CI の処理中に結合された CMDB IRE 部分的ペイロード [cmdb_ire_partial_payloads] テーブルの部分的ペイロードのsys_id値のリスト。

    データタイプ：アレイ

    "mergedPayloadIds": [
  "String"
]
    result.additionalCommittedItems.operation この追加の CI に対して実行された操作。
    可能な値：
    • DELETE：既存の CI がターゲットテーブルから削除されます。
    • INSERT：追加の CI が新しいレコードとしてターゲットテーブルに挿入されます。
    • NO_CHANGE：追加の CI に対して実行された操作はありません。
    • UPDATE：ターゲットテーブルの既存の CI が更新されます。
    • UPDATE_WITH_DOWNGRADE：ターゲットテーブル内の既存の CI が更新され、そのクラスがより汎用的なクラス (先祖クラス) に変更されます。
    • UPDATE_WITH_SWITCH：ターゲットテーブル内の既存の CI が更新され、そのクラスが先祖クラスまたは子孫クラスではない別のクラスに変更されます。
    • UPDATE_WITH_UPGRADE：ターゲットテーブル内の既存の CI が更新され、そのクラスがより特化されたクラス (子孫クラス) に変更されます。

    データタイプ：文字列
    result.additionalCommittedItems.sysId 識別によって検出されたこの追加の CI の sys_id。

    注目値: 不明:この追加の CI の識別に失敗しました。詳細については、「errors」を参照してください。

    データタイプ：文字列
    result.additionalCommittedItems.warnings この追加の CI の処理中に発生した警告のリスト。

    データタイプ：オブジェクトのアレイ

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    result.additionalCommittedItems.warnings.error この追加の CI の処理中に発生した警告のタイプ。

    データタイプ：文字列
    result.additionalCommittedItems.warnings.message この追加の CI の処理中に発生した警告メッセージ。

    データタイプ：文字列
    result.additionalCommittedRelations 要求本文に含まれていない依存関係性 CI のリスト 挿入または更新する relations リスト。

    データタイプ：オブジェクトのアレイ

    "additionalCommittedRelations": [
  {
    "className": "String",
    "operation": "String",
    "markers": [Array],
    "inputIndices": [Array],
    "mergedPayloadIds": [Array]
  }
]
    result.additionalCommittedRelations.className この追加の依存関係 CI の sys_class_name。
    サポートされている値のみ：
    • cmdb_rel_ci：CI 関係テーブル。

    データタイプ：文字列
    result.additionalCommittedRelations.errorCount この追加の依存関係 CI の処理中に発生したエラーの数。

    データタイプ：数値
    result.additionalCommittedRelations.errors この追加の依存関係性 CI の処理中に発生したエラーのリスト。

    データタイプ：オブジェクトのアレイ

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    result.additionalCommittedRelations.errors.error この追加の依存関係性 CI の処理中に発生したエラーのタイプ。

    データタイプ：文字列
    result.additionalCommittedRelations.errors.message この追加の依存関係性 CI の処理中に発生したエラーメッセージ。

    データタイプ：文字列
    result.additionalCommittedRelations.inputIndices この追加の依存関係性 CI に対応する要求本文 relations アレイ内の依存関係性 CI オブジェクトのインデックス値のリスト。

    データタイプ：アレイ

    "inputIndices": [
  Number
]
    result.additionalCommittedRelations.markers 内部使用のためのマーカー値のリスト。

    データタイプ：アレイ

    "markers": []
    result.additionalCommittedRelations.mergedPayloadIds この追加の依存関係性 CI の処理中に結合された、CMDB IRE 部分的ペイロード [cmdb_ire_partial_payloads] テーブルの部分的ペイロードのsys_id値のリスト。

    データタイプ：アレイ

    "mergedPayloadIds": [
  "String"
]
    result.additionalCommittedRelations.operation この追加の依存関係性 CI に対して実行される操作。
    可能な値：
    • INSERT：依存関係 CI が新しいレコードとしてターゲットテーブルに挿入されます。
    • INSERT_AS_INCOMPLETE：依存関係 CI にエラーがあり、CMDB IRE 不完全ペイロード [cmdb_ire_incomplete_payloads] テーブルに挿入されます。
    • INSERT_AS_PARTIAL：依存関係 CI にエラーがあり、CMDB IRE 部分的ペイロード [cmdb_ire_partial_payloads] テーブルに挿入されます。
    • NO_CHANGE：依存関係 CI に対して実行された操作はありません。
    • UPDATE：ターゲットテーブルの既存の依存関係 CI が更新されます。

    データタイプ：文字列
    result.items 要求本文 items アレイに含まれる CI のリスト。

    データタイプ：オブジェクトのアレイ

    "items": [
  {
    "additionalRelatedItems": [Array],
    "className": "String",
    "duplicateLookupIndices": {Object},
    "errorCount": Number,
    "errors": [Array],
    "identificationAttempts": [Array],
    "identifierEntrySysId": "String",
    "info": [Array],
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloadIds": [Array],
    "operation": "String",
    "relatedItems": [Array],
    "relatedSysIds": [Array],
    "sysId": "String",
    "warnings": [Array]
  }
]
    result.items.additionalRelatedItems CMDB IRE 部分ペイロード [cmdb_ire_partial_payloads] テーブルからの関連 CI (テーブルルックアップ CI) のリスト。

    データタイプ：オブジェクトのアレイ

    "additionalRelatedItems": [
  {
    "className": "String",
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloadIds": [Array],
    "sysId": "String"
  }
]
    result.items.additionalRelatedItems.className 関連アイテムの sys_class_name。

    データタイプ：文字列
    result.items.additionalRelatedItems.inputIndices この関連アイテムに対応する要求本文 items アレイの CI のインデックス値のリスト。

    データタイプ：アレイ

    "inputIndices": [
    Number
]
    result.items.additionalRelatedItems.markers 内部使用のためのマーカー値のリスト。

    データタイプ：アレイ

    "markers": []
    result.items.additionalRelatedItems.mergedPayloadIds この関連アイテムの処理中に結合された、CMDB IRE 部分ペイロード [cmdb_ire_partial_payloads] テーブルの部分的ペイロードのsys_id値のリスト。

    データタイプ：アレイ

    "mergedPayloadIds": [
  "String"
]
    result.items.additionalRelatedItems.sysId この関連 CI のSys_id。

    データタイプ：文字列
    result.items.className この CI のSys_class_name。

    データタイプ：文字列
    result.items.duplicateLookupIndices 同じ関連 CI を参照する items.lookup アレイ要素のインデックス値のアレイを含むオブジェクト。

    アレイ名は、指定された関連 CI を参照する要求本文 items.lookup アレイの最初の要素を示します。その値は、同じ関連 CI を参照する同じアレイの追加要素のセットです。

    データタイプ：オブジェクト

    この例は、 items.lookup アレイの 2 番目の要素が、そのアレイの後続の要素と同じ関連 CI を参照するケースを示しています。

    "duplicateLookupIndices": [
  "2": [Array]
]
    result.items.errorCount この CI の処理中に発生したエラーの数。

    データタイプ：数値
    result.items.errors この CI の処理中に発生したエラーのリスト。

    データタイプ：オブジェクトのアレイ

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    result.items.errors.error この CI の処理中に発生したエラーのタイプ。

    データタイプ：文字列
    result.items.errors.message この CI の処理中に発生したエラーメッセージ。

    データタイプ：文字列
    result.items.identificationAttempts この CI を識別するための試行のリスト。
    データタイプ：オブジェクトのアレイ
    "identificationAttempts": [
  {
    "attemptResult": "String",
    "attributes": [Array],
    "hybridEntryCiAttributes": [Array],
    "identiferName": "String",
    "searchOnTable": [Array]
  }
]
    result.items.identificationAttempts.attemptResult この CI 識別試行の結果。
    可能な値：
    • MATCHED：識別に成功しました。指定された属性と完全に一致する一意の CI が識別子ルールテーブルで見つかりました。
    • MULTI_MATCH：エラーのため識別に失敗しました。指定された属性に対して照合しているときに、識別子ルールテーブルに重複する CI が見つかりました。
    • NO_MATCH：識別に失敗しました。指定された属性と一致する CI が識別子ルールテーブルで見つかりませんでした。
    • SKIPPED：識別は試行されませんでした。この識別子ルールテーブルの検索に必要な属性が指定されなかったため、ルールは適用されませんでした。

    データタイプ：文字列
    result.items.identificationAttempts.attributes この CI 識別試行中に使用された CI ID エントリー属性のリスト。

    データタイプ：アレイ

    属性の名前とタイプは、次のような使用される要求本文データと識別子によって異なります。

    "attributes": [
  "serial_number": "String",
  "serial_number_type": "String",
]
    result.items.identificationAttempts.hybridEntryCiAttributes この CI 識別試行中に使用された CI ID エントリー属性のリスト。

    データタイプ：アレイ

    属性の名前とタイプは、次のような使用される要求本文データと識別子によって異なります。

    "hybridEntryCiAttributes": [
  "name": "String",
  "serial_number": "String"
]
    result.items.identificationAttempts.identifierName この CI の識別試行に使用される識別子ルール。

    データタイプ：文字列
    result.items.identificationAttempts.searchOnTable この CI 識別試行のために検索されたテーブルの名前。

    データタイプ：文字列
    result.items.identifierEntrySysId この CI を識別するために使用される識別子ルールのSys_id。
    注目すべき値：
    • Unknown：この CI の識別に失敗しました。詳細については、「errors」を参照してください。

    データタイプ：文字列
    result.items.info アイテムの処理に関する追加情報のリスト。

    データタイプ：オブジェクトのアレイ

    "info": [
  {
    "code": "String",
    "message": "String",
    "ruleSysId": "String"
  }
]
    result.items.info.code スキップされた再分類タイプ。
    可能な値：
    • SKIPPED_CLASS_SWITCH
    • SKIPPED_CLASS_DOWNGRADE
    • SKIPPED_CLASS_UPGRADE
    result.items.info.message 再分類をスキップする理由に関する追加のインサイトを提供するメッセージ。

    データタイプ：文字列
    result.items.info.ruleSysId 一致した再分類制限ルールの sys_id。再分類制限ルールのために IRE が再分類をスキップする場合にのみ適用されます。ペイロードまたはグローバルフラグのために再分類がスキップされた場合、この値は空になります。

    データタイプ：文字列
    result.items.inputIndices この CI に対応する要求本文 items アレイの CI のインデックス値のリスト。

    データタイプ：オブジェクトのアレイ

    "inputIndices": [
  {
    Number
  }
]
    result.items.markers 内部使用のためのマーカー値のリスト。

    データタイプ：アレイ

    "markers": []
    result.items.mergedPayloadIds この CI の処理中に結合された CMDB IRE 部分的ペイロード [cmdb_ire_partial_payloads] テーブルの部分的ペイロードのsys_id値のリスト。

    データタイプ：アレイ

    "mergedPayloadIds": [
  "String"
]
    result.items.operation この CI に対して実行される操作。
    可能な値：
    • DELETE：既存の CI がターゲットテーブルから削除されます。
    • INSERT：CI が新しいレコードとしてターゲットテーブルに挿入されます。
    • NO_CHANGE：CI に対して実行された操作はありません。
    • UPDATE：ターゲットテーブルの既存の 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 アレイからのインデックス値。

    データタイプ：数値
    result.items.relatedItems.markers 内部使用のためのマーカー値のリスト。

    データタイプ：アレイ

    "markers": []
    result.items.relatedItems.mergedPayloadIds 処理中にこの CI に結合された CMDB IRE 部分ペイロード [cmdb_ire_partial_payloads] テーブルのエントリのsys_id値のリスト。

    データタイプ：アレイ

    "mergedPayloadIds": [
  "String"
]
    result.items.relatedSysIds 要求本文 items.lookup アレイの関連アイテム (テーブルルックアップアイテム) のsys_id値のリスト。

    データタイプ：アレイ

    注目すべき値：
    • null：この関連アイテムの識別された sys_id がありませんでした。
    "relatedSysIds": [
    Number,
    Number
]
    result.items.sysId 識別により、この CI に対してSys_idが見つかりました。
    注目すべき値：
    • Unknown：この CI の識別に失敗しました。詳細については、「errors」を参照してください。

    データタイプ：文字列
    result.items.warnings この CI の処理中に発生した警告のリスト。

    データタイプ：オブジェクトのアレイ

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    result.items.warnings.error この CI の処理中に発生した警告のタイプ。

    データタイプ：文字列
    result.items.warnings.message この CI の処理中に発生した警告メッセージ。

    データタイプ：文字列
    result.logContextId このペイロードに対してレポートされたコンテキスト ID。

    データタイプ：文字列
    result.relations 要求本文 relations アレイの依存関係性 CI のリスト。

    データタイプ：オブジェクトのアレイ

    "relations": [
  {
    "className": "String",
    "errorCount": Number,
    "errors": [Array],
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloadIds": [Array],
    "operation": "String",
    "warnings": [Array]
  }
]
    result.relations.className この依存関係 CI の sys_class_name。
    サポートされている値のみ：
    • cmdb_rel_ci：CI 関係テーブル。

    データタイプ：文字列
    result.relations.errorCount この依存関係性 CI の処理中に発生したエラーの数。

    データタイプ：数値
    result.relations.errors この依存関係性 CI の処理中に発生したエラーのリスト。

    データタイプ：オブジェクトのアレイ

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    result.relations.errors.error この依存関係性 CI の処理中に発生したエラーのタイプ。

    データタイプ：文字列
    result.relations.errors.message この依存関係 CI の処理中に発生したエラーメッセージ。

    データタイプ：文字列
    result.relations.inputIndices この依存関係性 CI に対応する要求本文 relations アレイ内の依存関係性 CI オブジェクトのインデックス値のリスト。

    データタイプ：アレイ

    "inputIndices": [
  Number
]
    result.relations.markers 内部使用のためのマーカー値のリスト。

    データタイプ：アレイ

    "markers": []
    result.relations.mergedPayloadIds この依存関係性 CI の処理中に結合された CMDB IRE 部分ペイロード [cmdb_ire_partial_payloads] テーブルの部分的ペイロードのsys_id値のリスト。

    データタイプ：アレイ

    "mergedPayloadIds": [
  "String"
]
    result.relations.operation この依存関係性 CI に対して実行される操作。
    可能な値：
    • INSERT：依存関係 CI が新しいレコードとしてターゲットテーブルに挿入されました。
    • INSERT_AS_INCOMPLETE：依存関係 CI にエラーがあり、CMDB IRE 不完全ペイロード [cmdb_ire_incomplete_payloads] テーブルに挿入されました。
    • INSERT_AS_PARTIAL：依存関係 CI にエラーがあり、CMDB IRE 部分的ペイロード [cmdb_ire_partial_payloads] テーブルに挿入されました。
    • NO_CHANGE：依存関係 CI に対して実行された操作はありません。
    • UPDATE：ターゲットテーブルの既存の依存関係 CI が更新されました。

    データタイプ：文字列
    result.relations.warnings この依存関係性 CI の処理中に発生した警告のリスト。

    データタイプ：オブジェクトのアレイ

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    result.relations.warnings.error この依存関係性 CI の処理中に発生した警告のタイプ。

    データタイプ：文字列
    result.relations.warnings.message この依存関係性 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

    指定されたペイロード (要求本文) に識別および調整ルールを適用して、CMDB の構成アイテム (CI) を挿入または更新します。CMDB を直接更新する代わりに、この API を使用します。

    識別および調整 - POST /now/identifyreconcile/queryEnhanced エンドポイントを使用して、データベースへの変更をコミットせずに、このエンドポイントへのペイロードの送信をシミュレートします。

    このメソッドは 識別および調整 - POST /now/identifyreconcile メソッドに似ていますが、次の機能も追加されます。
    • 部分的ペイロード
      • アイテムに警告またはエラーがある場合は、アイテムの操作が INSERT_AS_PARTIAL か INSERT_INCOMPLETE かを示します。
      • 既存の部分的ペイロードと結合された部分的ペイロードの sys_id を返します。
    • ペイロードの重複排除機能をサポートします。
    • サマリを生成します。

    URL 形式

    バージョニングされた URL：/api/now/{api_version}/identifyreconcile/enhanced

    デフォルトの URL：/api/now/identifyreconcile/enhanced

    注:
    利用可能なバージョンは、 REST API エクスプローラーで指定されます。スクリプト済み REST API の場合、[ スクリプト済み REST サービス] フォームに追加のバージョン情報があります。

    サポートされている要求パラメーター

    表 : 7. パスパラメーター
    名前 説明
    api_version オプションアクセスするエンドポイントのバージョン。たとえば、v1 や v2 などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。

    データタイプ：文字列
    表 : 8. クエリパラメーター
    名前 説明
    options 要求に適用される拡張 IRE オプションを表す名前と値のペアのカンマ区切りリスト。

    例として、部分的ペイロードと部分的コメントのデフォルト値を上書きし、ペイロードを重複排除し、拡張 IRE オプションのサマリーを生成するには、次のコマンドを実行します。

    partial_payloads:false,partial_commits:false,deduplicate_payloads:false,generate_summary:true
    注:
    デフォルトでは、または partial_payloads が true に設定されている場合は、partial_commits と deduplicate_payloads の両方が (これらが false に設定されている場合でも) 有効になります。これらの機能は、部分的ペイロード機能に不可欠であるためです。

    拡張 IRE オプションの詳細については、「 識別および調整エンジン (IRE)」を参照してください。

    名前と値の各ペアの有効な値：
    • true：この拡張 IRE オプションを有効にします。
    • false：この拡張 IRE オプションを無効にします。

    データタイプ：文字列
    sysparm_data_source CI 情報のソース。これは、構成アイテム [cmdb_ci] テーブルの discovery_source フィールドに定義された選択値の 1 つである必要があります。

    データタイプ：文字列

    デフォルト：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] テーブルへの参照を含むルックアップテーブルに基づいて最上位レベルの構成アイテムを識別するために使用されます。

    データタイプ: Array off Objects

    "lookup": [
  {
    "className": "String",
    "internal_id": "String",
    "sys_object_source_info": {Object},
    "values": {Object}
  }
]
    items.lookup.className 必須です。作成または更新する CI の sys_class_name またはクラス/テーブル名。この値は、cmdb_serial_number や cmdb_ci_network_adapter などの任意の CMDB クラス/テーブルまたは非 CMDB 階層クラスにすることができます。

    データタイプ：文字列
    items.lookup.internal_id このペイロードのこのルックアップレコードの一意の識別子。任意の値にすることができますが、ペイロード内で一意である必要があります。

    データタイプ：文字列
    items.lookup.sys_object_source_info 指定されたデータソースの一意の CI 識別子を記述するオブジェクト。同じ CI でもソースが異なると、名前と値のペアが異なる場合があります。

    データタイプ：オブジェクト

    "sys_object_source_info": {
  "source_feed": "String",
  "source_name": "String",  
  "source_native_key": "String",
  "source_recency_timestamp": "String"
}
    items.lookup.sys_object_source_info.source_feed この CI を送信するフィードを一意に識別する名前。ソースが複数のフィードを持つことができる場合に使用します。

    データタイプ：文字列
    items.lookup.sys_object_source_info.source_name CI 情報のデータソース。この値は、構成アイテム [cmdb_ci] テーブルの discovery_source フィールドに定義された選択値の 1 つである必要があります。

    データタイプ：文字列
    items.lookup.sys_object_source_info.source_native_key CI のソースからの一意のキー/ID。アイテムに固有の任意の文字列にすることができます。

    データタイプ：文字列
    items.lookup.sys_object_source_info.source_recency_timestamp CI がスキャンされた UTC 日時。

    データタイプ：文字列

    形式：YYYY-MM-DD hh:mm:ss
    items.lookup.values このルックアップアイテムのフィールドを名前/値のペアとして記述するオブジェクト。名前はフィールド名です。

    データタイプ：オブジェクト

    フィールド名とタイプは、次のようにユーザーが選択したフィールドによって異なります。

    "values": {
  "ip_address": "String",
  "mac_address": "String",
  "serial_number": "String",
  "serial_number_type": "String",
  "valid": "String"
}
    items.related 識別される最上位レベル CI への参照を持つ関連テーブルに基づいて、各オブジェクトが作成または更新するアイテムレコードを説明するオブジェクトのアレイ。関連エントリ [cmdb_related_entry] テーブルのルールは、このアレイに含めることができるレコードのタイプを定義します。

    関連するテーブルは、構成アイテム [cmdb_ci] テーブルを拡張する場合もあれば拡張しない場合もあります。これらのレコードは、構成アイテムの識別には使用されません。

    データタイプ：オブジェクトのアレイ

    "related": [
  {
    "className": "String",
    "internal_id": "String",
    "sys_object_source_info": {Object},
    "values": {Object}
  }
]
    items.related.className 必須です。作成または更新する関連アイテムの sys_class_name またはクラス/テーブル名。

    データタイプ：文字列
    items.related.internal_id このペイロードのこの関連アイテムの一意の識別子。任意の値にすることができますが、ペイロード内で一意である必要があります。

    データタイプ：文字列
    items.related.sys_object_source_info 指定されたデータソースの一意の CI 識別子を記述するオブジェクト。同じ CI でもソースが異なると、名前と値のペアが異なる場合があります。

    データタイプ：オブジェクト

    "sys_object_source_info": {
  "source_feed": "String",
  "source_name": "String",  
  "source_native_key": "String",
  "source_recency_timestamp": "String"
}
    items.related.sys_object_source_info.source_feed この関連アイテムを送信するフィードを一意に識別する名前。ソースが複数のフィードを持つことができる場合に使用します。

    データタイプ：文字列
    items.related.sys_object_source_info.source_name 関連アイテム情報のデータソース。この値は、構成アイテム [cmdb_ci] テーブルの discovery_source フィールドに定義された選択値の 1 つである必要があります。

    データタイプ：文字列
    items.related.sys_object_source_info.source_native_key 関連アイテムのソースからの一意のキー/ID。アイテムに固有の任意の文字列にすることができます。

    データタイプ：文字列
    items.related.sys_object_source_info.source_recency_timestamp 関連アイテムがスキャンされた UTC 日時。

    データタイプ：文字列

    形式：YYYY-MM-DD hh:mm:ss
    items.related.values この関連アイテム用に名前/値のペアとして作成または更新するフィールドを説明するオブジェクト。名前はフィールド名です。参照フィールドの場合、値は参照される sys_id である必要があります。

    データタイプ：オブジェクト

    フィールド名とタイプは、次のようにユーザーが選択したフィールドによって異なります。

    "values": {
  "host_name": "String",
  "ip_address": "String",
  "name": "String",
  "os_name": "String",
  "sys_class_name": "String"
}
    items.settings 許可される更新のタイプを定義するパラメーターが含まれるオブジェクト。

    データタイプ：オブジェクト

    "settings": {
  "skipReclassificationRestrictionRules": Boolean,
  "updateWithoutDowngrade": Boolean,
  "updateWithoutSwitch": Boolean,
  "updateWithoutUpgrade": Boolean
}
    items.settings.skipReclassificationRestrictionRules IRE がペイロードアイテムのクラスに一致する再分類制限ルールの実行をスキップすべきかどうかを示すフラグ。
    有効な値：
    • true：ルールの実行をスキップします。
    • false：ルールを実行します。

    デフォルト値：false
    items.settings.updateWithoutDowngrade この CI に対して更新とダウングレードの両方を許可するかどうかを示すフラグ。
    有効な値：
    • true：アイテムを更新しますが、ダウングレードは許可されません。
    • false：アイテムの更新とダウングレードの両方が許可されます。

    データタイプ：ブール

    デフォルト値：false
    items.settings.updateWithoutSwitch この CI を更新してクラスを切り替えることができるかどうかを示すフラグ。
    有効な値：
    • true：アイテムを更新しますが、クラスの切り替えは許可されません。
    • false：アイテムの更新とクラスの切り替えの両方が許可されます。

    データタイプ：ブール

    デフォルト値：false
    items.settings.updateWithoutUpgrade この CI に対して更新とアップグレードの両方を許可するかどうかを示すフラグ。
    有効な値：
    • true：アイテムを更新しますが、アップグレードは許可されません。
    • false：アイテムの更新とアップグレードの両方が許可されます。

    データタイプ：ブール

    デフォルト値：false
    items.sys_object_source_info 一意の CI 識別子を記述するオブジェクト。

    データタイプ：オブジェクト

    "sys_object_source_info": {
  "source_feed": "String",
  "source_name": "String",  
  "source_native_key": "String",
  "source_recency_timestamp": "String"
}
    items.sys_object_source_info.source_feed この CI を送信するフィードを一意に識別する名前。ソースが複数のフィードを持つことができる場合に使用します。

    データタイプ：文字列
    items.sys_object_source_info.source_name CI 情報のデータソース。この値は、構成アイテム [cmdb_ci] テーブルの discovery_source フィールドに定義された選択値の 1 つである必要があります。

    データタイプ：文字列
    items.sys_object_source_info.source_native_key CI のソースからの一意のキー/ID。アイテムに固有の任意の文字列にすることができます。

    データタイプ：文字列
    items.sys_object_source_info.source_recency_timestamp CI がスキャンされた UTC 日時。

    データタイプ：文字列

    形式：YYYY-MM-DD hh:mm:ss
    items.values この CI 用に名前/値のペアとして作成または更新するフィールドを説明するオブジェクト。名前はフィールド名です。参照フィールドの場合、値は参照される sys_id である必要があります。

    データタイプ：オブジェクト

    フィールド名とタイプは、次のようにユーザーが選択したフィールドによって異なります。

    "values": {
  "host_name": "String",
  "ip_address": "String",
  "name": "String",
  "os_name": "String",
  "sys_class_name": "String"
}
    referenceItems ペイロード内の 2 つのアイテム間の参照のリスト。

    データタイプ：オブジェクトのアレイ

    "referenceItems": [
  {
    "referenced": "String",
    "referencedBy": "String",
    "referenceField": "String"
  }
]
    referenceItems.referenced 別のアイテムによって参照されているアイテムに対して定義された internal_id。

    データタイプ：文字列
    referenceItems.referencedBy 別のアイテムを参照するアイテムに対して定義された internal_id。

    データタイプ：文字列
    referenceItems.referenceField referencedBy アイテムのクラス/テーブル内の参照フィールドの名前。

    データタイプ：文字列
    relations ペイロードで定義された 2 つのアイテム間の関係のリスト。
    このアレイ内のオブジェクトは、2 つの形式のいずれかを使用できます。
    • オブジェクトは、parent および child の名前と値のペアを使用して 2 つのトップレベルアイテム (のみ) の間の関係を定義できます。この値はペイロード items アレイのアイテムインデックスを表します。
    • オブジェクトは、parent_id および child_id のキー/値のペアを使用して、最上位レベルのアイテム、関連するアイテム、ルックアップアイテムを含む任意の 2 つのアイテム間の関係を定義できます。この値は、それらのアイテムに対して定義された internal_id 値を表します。

    データタイプ：オブジェクトのアレイ

    "relations": [
  {
    "child": Number,
    "parent": Number,
    "sys_rel_source_info": {Object},
    "type": "String"
  }
]
    "relations": [
  {
    "child_id": "String",
    "parent_id": "String",
    "sys_rel_source_info": {Object},
    "type": "String"
  }
]
    relations.child 関係内の子を表す items アレイ内の CI オブジェクトの整数インデックス。

    データタイプ：数値
    relations.child_id 関係内の子アイテムの internal_id。

    データタイプ：文字列
    relations.parent 関係内の親を表す items アレイ内の CI オブジェクトの整数インデックス。

    データタイプ：数値
    relations.parent_id 関係内の親アイテムの internal_id。

    データタイプ：文字列
    relations.sys_rel_source_info 関係の検出ソース情報。非依存関係の場合、この情報は関係ソース [sys_rel_source] テーブルにあります。

    データタイプ：オブジェクト

    "sys_rel_source_info": { 
  "source_name": "String", 
  "source_feed": "String" 
}
    relations.sys_rel_source_info.source_name 検出ソース名。

    デフォルト：API メソッドパラメーターで渡される検出ソース。
    relations.sys_rel_source_info.source_feed 検出ソース内のサブ検出/スキャンである文字列。

    デフォルト値：「UNKNOWN」は、sys_rel_source テーブルにレコードを作成するときに source_feed 列に格納されます。
    relations.type 親アイテムと子アイテムの間に存在する関係のタイプ。これは、CI 関係タイプ [cmdb_rel_type] テーブルからの名前フィールド値である必要があります。

    データタイプ：文字列

    ヘッダー

    次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 サポートされている REST API ヘッダー」を参照してください。

    表 : 10. 要求ヘッダー
    ヘッダー 説明
    承認 応答本文のデータフォーマット。application/json のみをサポートします。
    Content-Type 要求本文のデータ形式。application/json のみをサポートします。
    表 : 11. 応答ヘッダー
    ヘッダー 説明
    なし

    ステータスコード

    この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 REST API HTTP 応答コード」を参照してください。

    表 : 12. ステータスコード
    ステータスコード 説明
    200 成功。要求が正常に処理されました。
    401 権限がありません。ユーザー資格情報が間違っているか、渡されていません。
    500 内部サーバーエラー。要求の処理中に予期しないエラーが発生しました。

    エラーメッセージの詳細「チャンク […] は有効なエントリーではありません (Chunk […] is not a valid entry)」は、options クエリパラメーターが正しい名前と値のペア形式でないことを示しています。

    たとえば、部分的な 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 が識別子ルールテーブルで見つかりませんでした。
    • SKIPPED：識別は試行されませんでした。この識別子ルールテーブルの検索に必要な属性が指定されなかったため、ルールは適用されませんでした。

    データタイプ：文字列
    result.additionalCommittedItems.identificationAttempts.attributes この追加の CI の識別の試行中に使用される CI ID エントリ属性のアレイ。

    データタイプ：アレイ

    属性の名前とタイプは、次のような使用される要求本文データと識別子によって異なります。

    "attributes": [
  "serial_number": "String",
  "serial_number_type": "String"
]
    result.additionalCommittedItems.identificationAttempts.hybridEntryCiAttributes この追加の CI 識別試行中に使用された CI ID エントリー属性のリスト。

    データタイプ：アレイ

    属性の名前とタイプは、次のような使用される要求本文データと識別子によって異なります。

    "hybridEntryCiAttributes": [
  "name": "String",
  "serial_number": "String"
]
    result.additionalCommittedItems.identificationAttempts.identifierName この追加の CI 識別の試行に使用される識別子ルール。

    データタイプ：文字列
    result.additionalCommittedItems.identificationAttempts.searchOnTable この追加の CI 識別の試行で検索されたテーブルの名前。

    データタイプ：文字列
    result.additionalCommittedItems.identifierEntrySysId この追加の CI を識別するために使用される識別子ルールの sys_id。
    注目すべき値：
    • Unknown：この追加の CI の識別に失敗しました。詳細については、「errors」を参照してください。

    データタイプ：文字列
    result.additionalCommittedItems.inputIndices この追加の CI に対応する要求本文 items アレイの CI のインデックス値のリスト。

    データタイプ：オブジェクトのアレイ

    "inputIndices": [
  {
    Number
  }
]
    result.additionalCommittedItems.markers 内部使用のためのマーカー値のリスト。

    データタイプ：アレイ

    "markers": []
    result.additionalCommittedItems.mergedPayloads この追加 CI の処理中に結合された CMDB IRE 部分的ペイロード [cmdb_ire_partial_payloads] テーブルの部分的ペイロードのsys_id値のリスト。

    データタイプ：アレイ

    "mergedPayloadIds": [
  "String"
]
    result.additionalCommittedItems.operation この追加の CI に対して実行された操作。
    可能な値：
    • DELETE：既存の CI がターゲットテーブルから削除されます。
    • INSERT：追加の CI が新しいレコードとしてターゲットテーブルに挿入されます。
    • NO_CHANGE：追加の CI に対して実行された操作はありません。
    • UPDATE：ターゲットテーブルの既存の CI が更新されます。
    • UPDATE_WITH_DOWNGRADE：ターゲットテーブル内の既存の CI が更新され、そのクラスがより汎用的なクラス (先祖クラス) に変更されます。
    • UPDATE_WITH_SWITCH：ターゲットテーブル内の既存の CI が更新され、そのクラスが先祖クラスまたは子孫クラスではない別のクラスに変更されます。
    • UPDATE_WITH_UPGRADE：ターゲットテーブル内の既存の CI が更新され、そのクラスがより特化されたクラス (子孫クラス) に変更されます。

    データタイプ：文字列
    result.additionalCommittedItems.sysId 識別によって検出されたこの追加の CI の sys_id。

    注目値: 不明:この追加の CI の識別に失敗しました。詳細については、「errors」を参照してください。

    データタイプ：文字列
    result.additionalCommittedItems.warnings この追加の CI の処理中に発生した警告のリスト。

    データタイプ：オブジェクトのアレイ

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    result.additionalCommittedItems.warnings.error この追加の CI の処理中に発生した警告のタイプ。

    データタイプ：文字列
    result.additionalCommittedItems.warnings.message この追加の CI の処理中に発生した警告メッセージ。

    データタイプ：文字列
    result.additionalCommittedRelations 要求本文に含まれていない依存関係性 CI のリスト 挿入または更新する relations リスト。

    データタイプ：オブジェクトのアレイ

    "additionalCommittedRelations": [
  {
    "className": "String",
    "operation": "String",
    "markers": [Array],
    "inputIndices": [Array],
    "mergedPayloadIds": [Array]
  }
]
    result.additionalCommittedRelations.className この追加の依存関係 CI の sys_class_name。
    サポートされている値のみ：
    • cmdb_rel_ci：CI 関係テーブル。

    データタイプ：文字列
    result.additionalCommittedRelations.errorCount この追加の依存関係 CI の処理中に発生したエラーの数。

    データタイプ：数値
    result.additionalCommittedRelations.errors この追加の依存関係性 CI の処理中に発生したエラーのリスト。

    データタイプ：オブジェクトのアレイ

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    result.additionalCommittedRelations.errors.error この追加の依存関係性 CI の処理中に発生したエラーのタイプ。

    データタイプ：文字列
    result.additionalCommittedRelations.errors.message この追加の依存関係性 CI の処理中に発生したエラーメッセージ。

    データタイプ：文字列
    result.additionalCommittedRelations.inputIndices この追加の依存関係性 CI に対応する要求本文 relations アレイ内の依存関係性 CI オブジェクトのインデックス値のリスト。

    データタイプ：アレイ

    "inputIndices": [
  Number
]
    result.additionalCommittedRelations.markers 内部使用のためのマーカー値のリスト。

    データタイプ：アレイ

    "markers": []
    result.additionalCommittedRelations.mergedPayloadIds この追加の依存関係性 CI の処理中に結合された、CMDB IRE 部分的ペイロード [cmdb_ire_partial_payloads] テーブルの部分的ペイロードのsys_id値のリスト。

    データタイプ：アレイ

    "mergedPayloadIds": [
  "String"
]
    result.additionalCommittedRelations.operation この追加の依存関係性 CI に対して実行される操作。
    可能な値：
    • INSERT：依存関係 CI が新しいレコードとしてターゲットテーブルに挿入されます。
    • INSERT_AS_INCOMPLETE：依存関係 CI にエラーがあり、CMDB IRE 不完全ペイロード [cmdb_ire_incomplete_payloads] テーブルに挿入されます。
    • INSERT_AS_PARTIAL：依存関係 CI にエラーがあり、CMDB IRE 部分的ペイロード [cmdb_ire_partial_payloads] テーブルに挿入されます。
    • NO_CHANGE：依存関係 CI に対して実行された操作はありません。
    • UPDATE：ターゲットテーブルの既存の依存関係 CI が更新されます。

    データタイプ：文字列
    result.items 要求本文 items アレイに含まれる CI のリスト。

    データタイプ：オブジェクトのアレイ

    "items": [
  {
    "additionalRelatedItems": [Array],
    "className": "String",
    "duplicateLookupIndices": {Object},
    "errorCount": Number,
    "errors": [Array],
    "identificationAttempts": [Array],
    "identifierEntrySysId": "String",
    "info": [Array],
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloadIds": [Array],
    "operation": "String",
    "relatedItems": [Array],
    "relatedSysIds": [Array],
    "sysId": "String",
    "warnings": [Array]
  }
]
    result.items.additionalRelatedItems CMDB IRE 部分ペイロード [cmdb_ire_partial_payloads] テーブルからの関連 CI (テーブルルックアップ CI) のリスト。

    データタイプ：オブジェクトのアレイ

    "additionalRelatedItems": [
  {
    "className": "String",
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloadIds": [Array],
    "sysId": "String"
  }
]
    result.items.additionalRelatedItems.className 関連アイテムの sys_class_name。

    データタイプ：文字列
    result.items.additionalRelatedItems.inputIndices この関連アイテムに対応する要求本文 items アレイの CI のインデックス値のリスト。

    データタイプ：アレイ

    "inputIndices": [
    Number
]
    result.items.additionalRelatedItems.markers 内部使用のためのマーカー値のリスト。

    データタイプ：アレイ

    "markers": []
    result.items.additionalRelatedItems.mergedPayloadIds この関連アイテムの処理中に結合された、CMDB IRE 部分ペイロード [cmdb_ire_partial_payloads] テーブルの部分的ペイロードのsys_id値のリスト。

    データタイプ：アレイ

    "mergedPayloadIds": [
  "String"
]
    result.items.additionalRelatedItems.sysId この関連 CI のSys_id。

    データタイプ：文字列
    result.items.className この CI のSys_class_name。

    データタイプ：文字列
    result.items.duplicateLookupIndices 同じ関連 CI を参照する items.lookup アレイ要素のインデックス値のアレイを含むオブジェクト。

    アレイ名は、指定された関連 CI を参照する要求本文 items.lookup アレイの最初の要素を示します。その値は、同じ関連 CI を参照する同じアレイの追加要素のセットです。

    データタイプ：オブジェクト

    この例は、 items.lookup アレイの 2 番目の要素が、そのアレイの後続の要素と同じ関連 CI を参照するケースを示しています。

    "duplicateLookupIndices": [
  "2": [Array]
]
    result.items.errorCount この CI の処理中に発生したエラーの数。

    データタイプ：数値
    result.items.errors この CI の処理中に発生したエラーのリスト。

    データタイプ：オブジェクトのアレイ

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    result.items.errors.error この CI の処理中に発生したエラーのタイプ。

    データタイプ：文字列
    result.items.errors.message この CI の処理中に発生したエラーメッセージ。

    データタイプ：文字列
    result.items.identificationAttempts この CI を識別するための試行のリスト。
    データタイプ：オブジェクトのアレイ
    "identificationAttempts": [
  {
    "attemptResult": "String",
    "attributes": [Array],
    "hybridEntryCiAttributes": [Array],
    "identiferName": "String",
    "searchOnTable": [Array]
  }
]
    result.items.identificationAttempts.attemptResult この CI 識別試行の結果。
    可能な値：
    • MATCHED：識別に成功しました。指定された属性と完全に一致する一意の CI が識別子ルールテーブルで見つかりました。
    • MULTI_MATCH：エラーのため識別に失敗しました。指定された属性に対して照合しているときに、識別子ルールテーブルに重複する CI が見つかりました。
    • NO_MATCH：識別に失敗しました。指定された属性と一致する CI が識別子ルールテーブルで見つかりませんでした。
    • SKIPPED：識別は試行されませんでした。この識別子ルールテーブルの検索に必要な属性が指定されなかったため、ルールは適用されませんでした。

    データタイプ：文字列
    result.items.identificationAttempts.attributes この CI 識別試行中に使用された CI ID エントリー属性のリスト。

    データタイプ：アレイ

    属性の名前とタイプは、次のような使用される要求本文データと識別子によって異なります。

    "attributes": [
  "serial_number": "String",
  "serial_number_type": "String",
]
    result.items.identificationAttempts.hybridEntryCiAttributes この CI 識別試行中に使用された CI ID エントリー属性のリスト。

    データタイプ：アレイ

    属性の名前とタイプは、次のような使用される要求本文データと識別子によって異なります。

    "hybridEntryCiAttributes": [
  "name": "String",
  "serial_number": "String"
]
    result.items.identificationAttempts.identifierName この CI の識別試行に使用される識別子ルール。

    データタイプ：文字列
    result.items.identificationAttempts.searchOnTable この CI 識別試行のために検索されたテーブルの名前。

    データタイプ：文字列
    result.items.identifierEntrySysId この CI を識別するために使用される識別子ルールのSys_id。
    注目すべき値：
    • Unknown：この CI の識別に失敗しました。詳細については、「errors」を参照してください。

    データタイプ：文字列
    result.items.info アイテムの処理に関する追加情報のリスト。

    データタイプ：オブジェクトのアレイ

    "info": [
  {
    "code": "String",
    "message": "String",
    "ruleSysId": "String"
  }
]
    result.items.info.code スキップされた再分類タイプ。
    可能な値：
    • SKIPPED_CLASS_SWITCH
    • SKIPPED_CLASS_DOWNGRADE
    • SKIPPED_CLASS_UPGRADE
    result.items.info.message 再分類をスキップする理由に関する追加のインサイトを提供するメッセージ。

    データタイプ：文字列
    result.items.info.ruleSysId 一致した再分類制限ルールの sys_id。再分類制限ルールのために IRE が再分類をスキップする場合にのみ適用されます。ペイロードまたはグローバルフラグのために再分類がスキップされた場合、この値は空になります。

    データタイプ：文字列
    result.items.inputIndices この CI に対応する要求本文 items アレイの CI のインデックス値のリスト。

    データタイプ：オブジェクトのアレイ

    "inputIndices": [
  {
    Number
  }
]
    result.items.markers 内部使用のためのマーカー値のリスト。

    データタイプ：アレイ

    "markers": []
    result.items.mergedPayloadIds この CI の処理中に結合された CMDB IRE 部分的ペイロード [cmdb_ire_partial_payloads] テーブルの部分的ペイロードのsys_id値のリスト。

    データタイプ：アレイ

    "mergedPayloadIds": [
  "String"
]
    result.items.operation この CI に対して実行される操作。
    可能な値：
    • DELETE：既存の CI がターゲットテーブルから削除されます。
    • INSERT：CI が新しいレコードとしてターゲットテーブルに挿入されます。
    • NO_CHANGE：CI に対して実行された操作はありません。
    • UPDATE：ターゲットテーブルの既存の 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 アレイからのインデックス値。

    データタイプ：数値
    result.items.relatedItems.markers 内部使用のためのマーカー値のリスト。

    データタイプ：アレイ

    "markers": []
    result.items.relatedItems.mergedPayloadIds 処理中にこの CI に結合された CMDB IRE 部分ペイロード [cmdb_ire_partial_payloads] テーブルのエントリのsys_id値のリスト。

    データタイプ：アレイ

    "mergedPayloadIds": [
  "String"
]
    result.items.relatedSysIds 要求本文 items.lookup アレイの関連アイテム (テーブルルックアップアイテム) のsys_id値のリスト。

    データタイプ：アレイ

    注目すべき値：
    • null：この関連アイテムの識別された sys_id がありませんでした。
    "relatedSysIds": [
    Number,
    Number
]
    result.items.sysId 識別により、この CI に対してSys_idが見つかりました。
    注目すべき値：
    • Unknown：この CI の識別に失敗しました。詳細については、「errors」を参照してください。

    データタイプ：文字列
    result.items.warnings この CI の処理中に発生した警告のリスト。

    データタイプ：オブジェクトのアレイ

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    result.items.warnings.error この CI の処理中に発生した警告のタイプ。

    データタイプ：文字列
    result.items.warnings.message この CI の処理中に発生した警告メッセージ。

    データタイプ：文字列
    result.logContextId このペイロードに対してレポートされたコンテキスト ID。

    データタイプ：文字列
    result.relations 要求本文 relations アレイの依存関係性 CI のリスト。

    データタイプ：オブジェクトのアレイ

    "relations": [
  {
    "className": "String",
    "errorCount": Number,
    "errors": [Array],
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloadIds": [Array],
    "operation": "String",
    "warnings": [Array]
  }
]
    result.relations.className この依存関係 CI の sys_class_name。
    サポートされている値のみ：
    • cmdb_rel_ci：CI 関係テーブル。

    データタイプ：文字列
    result.relations.errorCount この依存関係性 CI の処理中に発生したエラーの数。

    データタイプ：数値
    result.relations.errors この依存関係性 CI の処理中に発生したエラーのリスト。

    データタイプ：オブジェクトのアレイ

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    result.relations.errors.error この依存関係性 CI の処理中に発生したエラーのタイプ。

    データタイプ：文字列
    result.relations.errors.message この依存関係 CI の処理中に発生したエラーメッセージ。

    データタイプ：文字列
    result.relations.inputIndices この依存関係性 CI に対応する要求本文 relations アレイ内の依存関係性 CI オブジェクトのインデックス値のリスト。

    データタイプ：アレイ

    "inputIndices": [
  Number
]
    result.relations.markers 内部使用のためのマーカー値のリスト。

    データタイプ：アレイ

    "markers": []
    result.relations.mergedPayloadIds この依存関係性 CI の処理中に結合された CMDB IRE 部分ペイロード [cmdb_ire_partial_payloads] テーブルの部分的ペイロードのsys_id値のリスト。

    データタイプ：アレイ

    "mergedPayloadIds": [
  "String"
]
    result.relations.operation この依存関係性 CI に対して実行される操作。
    可能な値：
    • INSERT：依存関係 CI が新しいレコードとしてターゲットテーブルに挿入されました。
    • INSERT_AS_INCOMPLETE：依存関係 CI にエラーがあり、CMDB IRE 不完全ペイロード [cmdb_ire_incomplete_payloads] テーブルに挿入されました。
    • INSERT_AS_PARTIAL：依存関係 CI にエラーがあり、CMDB IRE 部分的ペイロード [cmdb_ire_partial_payloads] テーブルに挿入されました。
    • NO_CHANGE：依存関係 CI に対して実行された操作はありません。
    • UPDATE：ターゲットテーブルの既存の依存関係 CI が更新されました。

    データタイプ：文字列
    result.relations.warnings この依存関係性 CI の処理中に発生した警告のリスト。

    データタイプ：オブジェクトのアレイ

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    result.relations.warnings.error この依存関係性 CI の処理中に発生した警告のタイプ。

    データタイプ：文字列
    result.relations.warnings.message この依存関係性 CI の処理中に発生した警告メッセージ。

    データタイプ：文字列

    cURL 要求

    コンピューター CI の部分的ペイロードを送信します。

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

    応答は、ペイロードが CMDB IRE 部分のペイロード [cmdb_ire_partial_payloads] テーブルに挿入されたことを示します。

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

    サマリ生成の拡張 IRE オプションを有効にして、コンピューター CI の説明を完了する 2 番目の部分的ペイロードを送信します。

    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 エンドポイントへのペイロード (要求本文) の送信をシミュレートします。

    拡張 IRE オプションを指定する必要がある場合は、代わりに 識別および調整 - POST /now/identifyreconcile/enhanced エンドポイントを使用します。拡張 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 フィールドに定義された選択値の 1 つである必要があります。

    データタイプ：文字列

    デフォルト：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] テーブルへの参照を含むルックアップテーブルに基づいて最上位レベルの構成アイテムを識別するために使用されます。

    データタイプ: Array off Objects

    "lookup": [
  {
    "className": "String",
    "internal_id": "String",
    "sys_object_source_info": {Object},
    "values": {Object}
  }
]
    items.lookup.className 必須です。作成または更新する CI の sys_class_name またはクラス/テーブル名。この値は、cmdb_serial_number や cmdb_ci_network_adapter などの任意の CMDB クラス/テーブルまたは非 CMDB 階層クラスにすることができます。

    データタイプ：文字列
    items.lookup.internal_id このペイロードのこのルックアップレコードの一意の識別子。任意の値にすることができますが、ペイロード内で一意である必要があります。

    データタイプ：文字列
    items.lookup.sys_object_source_info 指定されたデータソースの一意の CI 識別子を記述するオブジェクト。同じ CI でもソースが異なると、名前と値のペアが異なる場合があります。

    データタイプ：オブジェクト

    "sys_object_source_info": {
  "source_feed": "String",
  "source_name": "String",  
  "source_native_key": "String",
  "source_recency_timestamp": "String"
}
    items.lookup.sys_object_source_info.source_feed この CI を送信するフィードを一意に識別する名前。ソースが複数のフィードを持つことができる場合に使用します。

    データタイプ：文字列
    items.lookup.sys_object_source_info.source_name CI 情報のデータソース。この値は、構成アイテム [cmdb_ci] テーブルの discovery_source フィールドに定義された選択値の 1 つである必要があります。

    データタイプ：文字列
    items.lookup.sys_object_source_info.source_native_key CI のソースからの一意のキー/ID。アイテムに固有の任意の文字列にすることができます。

    データタイプ：文字列
    items.lookup.sys_object_source_info.source_recency_timestamp CI がスキャンされた UTC 日時。

    データタイプ：文字列

    形式：YYYY-MM-DD hh:mm:ss
    items.lookup.values このルックアップアイテムのフィールドを名前/値のペアとして記述するオブジェクト。名前はフィールド名です。

    データタイプ：オブジェクト

    フィールド名とタイプは、次のようにユーザーが選択したフィールドによって異なります。

    "values": {
  "ip_address": "String",
  "mac_address": "String",
  "serial_number": "String",
  "serial_number_type": "String",
  "valid": "String"
}
    items.related 識別される最上位レベル CI への参照を持つ関連テーブルに基づいて、各オブジェクトが作成または更新するアイテムレコードを説明するオブジェクトのアレイ。関連エントリ [cmdb_related_entry] テーブルのルールは、このアレイに含めることができるレコードのタイプを定義します。

    関連するテーブルは、構成アイテム [cmdb_ci] テーブルを拡張する場合もあれば拡張しない場合もあります。これらのレコードは、構成アイテムの識別には使用されません。

    データタイプ：オブジェクトのアレイ

    "related": [
  {
    "className": "String",
    "internal_id": "String",
    "sys_object_source_info": {Object},
    "values": {Object}
  }
]
    items.related.className 必須です。作成または更新する関連アイテムの sys_class_name またはクラス/テーブル名。

    データタイプ：文字列
    items.related.internal_id このペイロードのこの関連アイテムの一意の識別子。任意の値にすることができますが、ペイロード内で一意である必要があります。

    データタイプ：文字列
    items.related.sys_object_source_info 指定されたデータソースの一意の CI 識別子を記述するオブジェクト。同じ CI でもソースが異なると、名前と値のペアが異なる場合があります。

    データタイプ：オブジェクト

    "sys_object_source_info": {
  "source_feed": "String",
  "source_name": "String",  
  "source_native_key": "String",
  "source_recency_timestamp": "String"
}
    items.related.sys_object_source_info.source_feed この関連アイテムを送信するフィードを一意に識別する名前。ソースが複数のフィードを持つことができる場合に使用します。

    データタイプ：文字列
    items.related.sys_object_source_info.source_name 関連アイテム情報のデータソース。この値は、構成アイテム [cmdb_ci] テーブルの discovery_source フィールドに定義された選択値の 1 つである必要があります。

    データタイプ：文字列
    items.related.sys_object_source_info.source_native_key 関連アイテムのソースからの一意のキー/ID。アイテムに固有の任意の文字列にすることができます。

    データタイプ：文字列
    items.related.sys_object_source_info.source_recency_timestamp 関連アイテムがスキャンされた UTC 日時。

    データタイプ：文字列

    形式：YYYY-MM-DD hh:mm:ss
    items.related.values この関連アイテム用に名前/値のペアとして作成または更新するフィールドを説明するオブジェクト。名前はフィールド名です。参照フィールドの場合、値は参照される sys_id である必要があります。

    データタイプ：オブジェクト

    フィールド名とタイプは、次のようにユーザーが選択したフィールドによって異なります。

    "values": {
  "host_name": "String",
  "ip_address": "String",
  "name": "String",
  "os_name": "String",
  "sys_class_name": "String"
}
    items.settings 許可される更新のタイプを定義するパラメーターが含まれるオブジェクト。

    データタイプ：オブジェクト

    "settings": {
  "skipReclassificationRestrictionRules": Boolean,
  "updateWithoutDowngrade": Boolean,
  "updateWithoutSwitch": Boolean,
  "updateWithoutUpgrade": Boolean
}
    items.settings.skipReclassificationRestrictionRules IRE がペイロードアイテムのクラスに一致する再分類制限ルールの実行をスキップすべきかどうかを示すフラグ。
    有効な値：
    • true：ルールの実行をスキップします。
    • false：ルールを実行します。

    デフォルト値：false
    items.settings.updateWithoutDowngrade この CI に対して更新とダウングレードの両方を許可するかどうかを示すフラグ。
    有効な値：
    • true：アイテムを更新しますが、ダウングレードは許可されません。
    • false：アイテムの更新とダウングレードの両方が許可されます。

    データタイプ：ブール

    デフォルト値：false
    items.settings.updateWithoutSwitch この CI を更新してクラスを切り替えることができるかどうかを示すフラグ。
    有効な値：
    • true：アイテムを更新しますが、クラスの切り替えは許可されません。
    • false：アイテムの更新とクラスの切り替えの両方が許可されます。

    データタイプ：ブール

    デフォルト値：false
    items.settings.updateWithoutUpgrade この CI に対して更新とアップグレードの両方を許可するかどうかを示すフラグ。
    有効な値：
    • true：アイテムを更新しますが、アップグレードは許可されません。
    • false：アイテムの更新とアップグレードの両方が許可されます。

    データタイプ：ブール

    デフォルト値：false
    items.sys_object_source_info 一意の CI 識別子を記述するオブジェクト。

    データタイプ：オブジェクト

    "sys_object_source_info": {
  "source_feed": "String",
  "source_name": "String",  
  "source_native_key": "String",
  "source_recency_timestamp": "String"
}
    items.sys_object_source_info.source_feed この CI を送信するフィードを一意に識別する名前。ソースが複数のフィードを持つことができる場合に使用します。

    データタイプ：文字列
    items.sys_object_source_info.source_name CI 情報のデータソース。この値は、構成アイテム [cmdb_ci] テーブルの discovery_source フィールドに定義された選択値の 1 つである必要があります。

    データタイプ：文字列
    items.sys_object_source_info.source_native_key CI のソースからの一意のキー/ID。アイテムに固有の任意の文字列にすることができます。

    データタイプ：文字列
    items.sys_object_source_info.source_recency_timestamp CI がスキャンされた UTC 日時。

    データタイプ：文字列

    形式：YYYY-MM-DD hh:mm:ss
    items.values この CI 用に名前/値のペアとして作成または更新するフィールドを説明するオブジェクト。名前はフィールド名です。参照フィールドの場合、値は参照される sys_id である必要があります。

    データタイプ：オブジェクト

    フィールド名とタイプは、次のようにユーザーが選択したフィールドによって異なります。

    "values": {
  "host_name": "String",
  "ip_address": "String",
  "name": "String",
  "os_name": "String",
  "sys_class_name": "String"
}
    referenceItems ペイロード内の 2 つのアイテム間の参照のリスト。

    データタイプ：オブジェクトのアレイ

    "referenceItems": [
  {
    "referenced": "String",
    "referencedBy": "String",
    "referenceField": "String"
  }
]
    referenceItems.referenced 別のアイテムによって参照されているアイテムに対して定義された internal_id。

    データタイプ：文字列
    referenceItems.referencedBy 別のアイテムを参照するアイテムに対して定義された internal_id。

    データタイプ：文字列
    referenceItems.referenceField referencedBy アイテムのクラス/テーブル内の参照フィールドの名前。

    データタイプ：文字列
    relations ペイロードで定義された 2 つのアイテム間の関係のリスト。
    このアレイ内のオブジェクトは、2 つの形式のいずれかを使用できます。
    • オブジェクトは、parent および child の名前と値のペアを使用して 2 つのトップレベルアイテム (のみ) の間の関係を定義できます。この値はペイロード items アレイのアイテムインデックスを表します。
    • オブジェクトは、parent_id および child_id のキー/値のペアを使用して、最上位レベルのアイテム、関連するアイテム、ルックアップアイテムを含む任意の 2 つのアイテム間の関係を定義できます。この値は、それらのアイテムに対して定義された internal_id 値を表します。

    データタイプ：オブジェクトのアレイ

    "relations": [
  {
    "child": Number,
    "parent": Number,
    "sys_rel_source_info": {Object},
    "type": "String"
  }
]
    "relations": [
  {
    "child_id": "String",
    "parent_id": "String",
    "sys_rel_source_info": {Object},
    "type": "String"
  }
]
    relations.child 関係内の子を表す items アレイ内の CI オブジェクトの整数インデックス。

    データタイプ：数値
    relations.child_id 関係内の子アイテムの internal_id。

    データタイプ：文字列
    relations.parent 関係内の親を表す items アレイ内の CI オブジェクトの整数インデックス。

    データタイプ：数値
    relations.parent_id 関係内の親アイテムの internal_id。

    データタイプ：文字列
    relations.sys_rel_source_info 関係の検出ソース情報。非依存関係の場合、この情報は関係ソース [sys_rel_source] テーブルにあります。

    データタイプ：オブジェクト

    "sys_rel_source_info": { 
  "source_name": "String", 
  "source_feed": "String" 
}
    relations.sys_rel_source_info.source_name 検出ソース名。

    デフォルト：API メソッドパラメーターで渡される検出ソース。
    relations.sys_rel_source_info.source_feed 検出ソース内のサブ検出/スキャンである文字列。

    デフォルト値：「UNKNOWN」は、sys_rel_source テーブルにレコードを作成するときに source_feed 列に格納されます。
    relations.type 親アイテムと子アイテムの間に存在する関係のタイプ。これは、CI 関係タイプ [cmdb_rel_type] テーブルからの名前フィールド値である必要があります。

    データタイプ：文字列

    ヘッダー

    次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 サポートされている REST API ヘッダー」を参照してください。

    表 : 16. 要求ヘッダー
    ヘッダー 説明
    承認 応答本文のデータフォーマット。application/json のみをサポートします。
    Content-Type 要求本文のデータ形式。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 が識別子ルールテーブルで見つかりませんでした。
    • SKIPPED：識別は試行されませんでした。この識別子ルールテーブルの検索に必要な属性が指定されなかったため、ルールは適用されませんでした。

    データタイプ：文字列
    result.additionalCommittedItems.identificationAttempts.attributes この追加の CI の識別の試行中に使用される CI ID エントリ属性のアレイ。

    データタイプ：アレイ

    属性の名前とタイプは、次のような使用される要求本文データと識別子によって異なります。

    "attributes": [
  "serial_number": "String",
  "serial_number_type": "String"
]
    result.additionalCommittedItems.identificationAttempts.hybridEntryCiAttributes この追加の CI 識別試行中に使用された CI ID エントリー属性のリスト。

    データタイプ：アレイ

    属性の名前とタイプは、次のような使用される要求本文データと識別子によって異なります。

    "hybridEntryCiAttributes": [
  "name": "String",
  "serial_number": "String"
]
    result.additionalCommittedItems.identificationAttempts.identifierName この追加の CI 識別の試行に使用される識別子ルール。

    データタイプ：文字列
    result.additionalCommittedItems.identificationAttempts.searchOnTable この追加の CI 識別の試行で検索されたテーブルの名前。

    データタイプ：文字列
    result.additionalCommittedItems.identifierEntrySysId この追加の CI を識別するために使用される識別子ルールの sys_id。
    注目すべき値：
    • Unknown：この追加の CI の識別に失敗しました。詳細については、「errors」を参照してください。

    データタイプ：文字列
    result.additionalCommittedItems.inputIndices この追加の CI に対応する要求本文 items アレイの CI のインデックス値のリスト。

    データタイプ：オブジェクトのアレイ

    "inputIndices": [
  {
    Number
  }
]
    result.additionalCommittedItems.markers 内部使用のためのマーカー値のリスト。

    データタイプ：アレイ

    "markers": []
    result.additionalCommittedItems.mergedPayloads この追加 CI の処理中に結合された CMDB IRE 部分的ペイロード [cmdb_ire_partial_payloads] テーブルの部分的ペイロードのsys_id値のリスト。

    データタイプ：アレイ

    "mergedPayloadIds": [
  "String"
]
    result.additionalCommittedItems.operation この追加の CI に対して実行された操作。
    可能な値：
    • DELETE：既存の CI がターゲットテーブルから削除されます。
    • INSERT：追加の CI が新しいレコードとしてターゲットテーブルに挿入されます。
    • NO_CHANGE：追加の CI に対して実行された操作はありません。
    • UPDATE：ターゲットテーブルの既存の CI が更新されます。
    • UPDATE_WITH_DOWNGRADE：ターゲットテーブル内の既存の CI が更新され、そのクラスがより汎用的なクラス (先祖クラス) に変更されます。
    • UPDATE_WITH_SWITCH：ターゲットテーブル内の既存の CI が更新され、そのクラスが先祖クラスまたは子孫クラスではない別のクラスに変更されます。
    • UPDATE_WITH_UPGRADE：ターゲットテーブル内の既存の CI が更新され、そのクラスがより特化されたクラス (子孫クラス) に変更されます。

    データタイプ：文字列
    result.additionalCommittedItems.sysId 識別によって検出されたこの追加の CI の sys_id。

    注目値: 不明:この追加の CI の識別に失敗しました。詳細については、「errors」を参照してください。

    データタイプ：文字列
    result.additionalCommittedItems.warnings この追加の CI の処理中に発生した警告のリスト。

    データタイプ：オブジェクトのアレイ

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    result.additionalCommittedItems.warnings.error この追加の CI の処理中に発生した警告のタイプ。

    データタイプ：文字列
    result.additionalCommittedItems.warnings.message この追加の CI の処理中に発生した警告メッセージ。

    データタイプ：文字列
    result.additionalCommittedRelations 要求本文に含まれていない依存関係性 CI のリスト 挿入または更新する relations リスト。

    データタイプ：オブジェクトのアレイ

    "additionalCommittedRelations": [
  {
    "className": "String",
    "operation": "String",
    "markers": [Array],
    "inputIndices": [Array],
    "mergedPayloadIds": [Array]
  }
]
    result.additionalCommittedRelations.className この追加の依存関係 CI の sys_class_name。
    サポートされている値のみ：
    • cmdb_rel_ci：CI 関係テーブル。

    データタイプ：文字列
    result.additionalCommittedRelations.errorCount この追加の依存関係 CI の処理中に発生したエラーの数。

    データタイプ：数値
    result.additionalCommittedRelations.errors この追加の依存関係性 CI の処理中に発生したエラーのリスト。

    データタイプ：オブジェクトのアレイ

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    result.additionalCommittedRelations.errors.error この追加の依存関係性 CI の処理中に発生したエラーのタイプ。

    データタイプ：文字列
    result.additionalCommittedRelations.errors.message この追加の依存関係性 CI の処理中に発生したエラーメッセージ。

    データタイプ：文字列
    result.additionalCommittedRelations.inputIndices この追加の依存関係性 CI に対応する要求本文 relations アレイ内の依存関係性 CI オブジェクトのインデックス値のリスト。

    データタイプ：アレイ

    "inputIndices": [
  Number
]
    result.additionalCommittedRelations.markers 内部使用のためのマーカー値のリスト。

    データタイプ：アレイ

    "markers": []
    result.additionalCommittedRelations.mergedPayloadIds この追加の依存関係性 CI の処理中に結合された、CMDB IRE 部分的ペイロード [cmdb_ire_partial_payloads] テーブルの部分的ペイロードのsys_id値のリスト。

    データタイプ：アレイ

    "mergedPayloadIds": [
  "String"
]
    result.additionalCommittedRelations.operation この追加の依存関係性 CI に対して実行される操作。
    可能な値：
    • INSERT：依存関係 CI が新しいレコードとしてターゲットテーブルに挿入されます。
    • INSERT_AS_INCOMPLETE：依存関係 CI にエラーがあり、CMDB IRE 不完全ペイロード [cmdb_ire_incomplete_payloads] テーブルに挿入されます。
    • INSERT_AS_PARTIAL：依存関係 CI にエラーがあり、CMDB IRE 部分的ペイロード [cmdb_ire_partial_payloads] テーブルに挿入されます。
    • NO_CHANGE：依存関係 CI に対して実行された操作はありません。
    • UPDATE：ターゲットテーブルの既存の依存関係 CI が更新されます。

    データタイプ：文字列
    result.items 要求本文 items アレイに含まれる CI のリスト。

    データタイプ：オブジェクトのアレイ

    "items": [
  {
    "additionalRelatedItems": [Array],
    "className": "String",
    "duplicateLookupIndices": {Object},
    "errorCount": Number,
    "errors": [Array],
    "identificationAttempts": [Array],
    "identifierEntrySysId": "String",
    "info": [Array],
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloadIds": [Array],
    "operation": "String",
    "relatedItems": [Array],
    "relatedSysIds": [Array],
    "sysId": "String",
    "warnings": [Array]
  }
]
    result.items.additionalRelatedItems CMDB IRE 部分ペイロード [cmdb_ire_partial_payloads] テーブルからの関連 CI (テーブルルックアップ CI) のリスト。

    データタイプ：オブジェクトのアレイ

    "additionalRelatedItems": [
  {
    "className": "String",
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloadIds": [Array],
    "sysId": "String"
  }
]
    result.items.additionalRelatedItems.className 関連アイテムの sys_class_name。

    データタイプ：文字列
    result.items.additionalRelatedItems.inputIndices この関連アイテムに対応する要求本文 items アレイの CI のインデックス値のリスト。

    データタイプ：アレイ

    "inputIndices": [
    Number
]
    result.items.additionalRelatedItems.markers 内部使用のためのマーカー値のリスト。

    データタイプ：アレイ

    "markers": []
    result.items.additionalRelatedItems.mergedPayloadIds この関連アイテムの処理中に結合された、CMDB IRE 部分ペイロード [cmdb_ire_partial_payloads] テーブルの部分的ペイロードのsys_id値のリスト。

    データタイプ：アレイ

    "mergedPayloadIds": [
  "String"
]
    result.items.additionalRelatedItems.sysId この関連 CI のSys_id。

    データタイプ：文字列
    result.items.className この CI のSys_class_name。

    データタイプ：文字列
    result.items.duplicateLookupIndices 同じ関連 CI を参照する items.lookup アレイ要素のインデックス値のアレイを含むオブジェクト。

    アレイ名は、指定された関連 CI を参照する要求本文 items.lookup アレイの最初の要素を示します。その値は、同じ関連 CI を参照する同じアレイの追加要素のセットです。

    データタイプ：オブジェクト

    この例は、 items.lookup アレイの 2 番目の要素が、そのアレイの後続の要素と同じ関連 CI を参照するケースを示しています。

    "duplicateLookupIndices": [
  "2": [Array]
]
    result.items.errorCount この CI の処理中に発生したエラーの数。

    データタイプ：数値
    result.items.errors この CI の処理中に発生したエラーのリスト。

    データタイプ：オブジェクトのアレイ

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    result.items.errors.error この CI の処理中に発生したエラーのタイプ。

    データタイプ：文字列
    result.items.errors.message この CI の処理中に発生したエラーメッセージ。

    データタイプ：文字列
    result.items.identificationAttempts この CI を識別するための試行のリスト。
    データタイプ：オブジェクトのアレイ
    "identificationAttempts": [
  {
    "attemptResult": "String",
    "attributes": [Array],
    "hybridEntryCiAttributes": [Array],
    "identiferName": "String",
    "searchOnTable": [Array]
  }
]
    result.items.identificationAttempts.attemptResult この CI 識別試行の結果。
    可能な値：
    • MATCHED：識別に成功しました。指定された属性と完全に一致する一意の CI が識別子ルールテーブルで見つかりました。
    • MULTI_MATCH：エラーのため識別に失敗しました。指定された属性に対して照合しているときに、識別子ルールテーブルに重複する CI が見つかりました。
    • NO_MATCH：識別に失敗しました。指定された属性と一致する CI が識別子ルールテーブルで見つかりませんでした。
    • SKIPPED：識別は試行されませんでした。この識別子ルールテーブルの検索に必要な属性が指定されなかったため、ルールは適用されませんでした。

    データタイプ：文字列
    result.items.identificationAttempts.attributes この CI 識別試行中に使用された CI ID エントリー属性のリスト。

    データタイプ：アレイ

    属性の名前とタイプは、次のような使用される要求本文データと識別子によって異なります。

    "attributes": [
  "serial_number": "String",
  "serial_number_type": "String",
]
    result.items.identificationAttempts.hybridEntryCiAttributes この CI 識別試行中に使用された CI ID エントリー属性のリスト。

    データタイプ：アレイ

    属性の名前とタイプは、次のような使用される要求本文データと識別子によって異なります。

    "hybridEntryCiAttributes": [
  "name": "String",
  "serial_number": "String"
]
    result.items.identificationAttempts.identifierName この CI の識別試行に使用される識別子ルール。

    データタイプ：文字列
    result.items.identificationAttempts.searchOnTable この CI 識別試行のために検索されたテーブルの名前。

    データタイプ：文字列
    result.items.identifierEntrySysId この CI を識別するために使用される識別子ルールのSys_id。
    注目すべき値：
    • Unknown：この CI の識別に失敗しました。詳細については、「errors」を参照してください。

    データタイプ：文字列
    result.items.info アイテムの処理に関する追加情報のリスト。

    データタイプ：オブジェクトのアレイ

    "info": [
  {
    "code": "String",
    "message": "String",
    "ruleSysId": "String"
  }
]
    result.items.info.code スキップされた再分類タイプ。
    可能な値：
    • SKIPPED_CLASS_SWITCH
    • SKIPPED_CLASS_DOWNGRADE
    • SKIPPED_CLASS_UPGRADE
    result.items.info.message 再分類をスキップする理由に関する追加のインサイトを提供するメッセージ。

    データタイプ：文字列
    result.items.info.ruleSysId 一致した再分類制限ルールの sys_id。再分類制限ルールのために IRE が再分類をスキップする場合にのみ適用されます。ペイロードまたはグローバルフラグのために再分類がスキップされた場合、この値は空になります。

    データタイプ：文字列
    result.items.inputIndices この CI に対応する要求本文 items アレイの CI のインデックス値のリスト。

    データタイプ：オブジェクトのアレイ

    "inputIndices": [
  {
    Number
  }
]
    result.items.markers 内部使用のためのマーカー値のリスト。

    データタイプ：アレイ

    "markers": []
    result.items.mergedPayloadIds この CI の処理中に結合された CMDB IRE 部分的ペイロード [cmdb_ire_partial_payloads] テーブルの部分的ペイロードのsys_id値のリスト。

    データタイプ：アレイ

    "mergedPayloadIds": [
  "String"
]
    result.items.operation この CI に対して実行される操作。
    可能な値：
    • DELETE：既存の CI がターゲットテーブルから削除されます。
    • INSERT：CI が新しいレコードとしてターゲットテーブルに挿入されます。
    • NO_CHANGE：CI に対して実行された操作はありません。
    • UPDATE：ターゲットテーブルの既存の 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 アレイからのインデックス値。

    データタイプ：数値
    result.items.relatedItems.markers 内部使用のためのマーカー値のリスト。

    データタイプ：アレイ

    "markers": []
    result.items.relatedItems.mergedPayloadIds 処理中にこの CI に結合された CMDB IRE 部分ペイロード [cmdb_ire_partial_payloads] テーブルのエントリのsys_id値のリスト。

    データタイプ：アレイ

    "mergedPayloadIds": [
  "String"
]
    result.items.relatedSysIds 要求本文 items.lookup アレイの関連アイテム (テーブルルックアップアイテム) のsys_id値のリスト。

    データタイプ：アレイ

    注目すべき値：
    • null：この関連アイテムの識別された sys_id がありませんでした。
    "relatedSysIds": [
    Number,
    Number
]
    result.items.sysId 識別により、この CI に対してSys_idが見つかりました。
    注目すべき値：
    • Unknown：この CI の識別に失敗しました。詳細については、「errors」を参照してください。

    データタイプ：文字列
    result.items.warnings この CI の処理中に発生した警告のリスト。

    データタイプ：オブジェクトのアレイ

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    result.items.warnings.error この CI の処理中に発生した警告のタイプ。

    データタイプ：文字列
    result.items.warnings.message この CI の処理中に発生した警告メッセージ。

    データタイプ：文字列
    result.logContextId このペイロードに対してレポートされたコンテキスト ID。

    データタイプ：文字列
    result.relations 要求本文 relations アレイの依存関係性 CI のリスト。

    データタイプ：オブジェクトのアレイ

    "relations": [
  {
    "className": "String",
    "errorCount": Number,
    "errors": [Array],
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloadIds": [Array],
    "operation": "String",
    "warnings": [Array]
  }
]
    result.relations.className この依存関係 CI の sys_class_name。
    サポートされている値のみ：
    • cmdb_rel_ci：CI 関係テーブル。

    データタイプ：文字列
    result.relations.errorCount この依存関係性 CI の処理中に発生したエラーの数。

    データタイプ：数値
    result.relations.errors この依存関係性 CI の処理中に発生したエラーのリスト。

    データタイプ：オブジェクトのアレイ

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    result.relations.errors.error この依存関係性 CI の処理中に発生したエラーのタイプ。

    データタイプ：文字列
    result.relations.errors.message この依存関係 CI の処理中に発生したエラーメッセージ。

    データタイプ：文字列
    result.relations.inputIndices この依存関係性 CI に対応する要求本文 relations アレイ内の依存関係性 CI オブジェクトのインデックス値のリスト。

    データタイプ：アレイ

    "inputIndices": [
  Number
]
    result.relations.markers 内部使用のためのマーカー値のリスト。

    データタイプ：アレイ

    "markers": []
    result.relations.mergedPayloadIds この依存関係性 CI の処理中に結合された CMDB IRE 部分ペイロード [cmdb_ire_partial_payloads] テーブルの部分的ペイロードのsys_id値のリスト。

    データタイプ：アレイ

    "mergedPayloadIds": [
  "String"
]
    result.relations.operation この依存関係性 CI に対して実行される操作。
    可能な値：
    • INSERT：依存関係 CI が新しいレコードとしてターゲットテーブルに挿入されました。
    • INSERT_AS_INCOMPLETE：依存関係 CI にエラーがあり、CMDB IRE 不完全ペイロード [cmdb_ire_incomplete_payloads] テーブルに挿入されました。
    • INSERT_AS_PARTIAL：依存関係 CI にエラーがあり、CMDB IRE 部分的ペイロード [cmdb_ire_partial_payloads] テーブルに挿入されました。
    • NO_CHANGE：依存関係 CI に対して実行された操作はありません。
    • UPDATE：ターゲットテーブルの既存の依存関係 CI が更新されました。

    データタイプ：文字列
    result.relations.warnings この依存関係性 CI の処理中に発生した警告のリスト。

    データタイプ：オブジェクトのアレイ

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    result.relations.warnings.error この依存関係性 CI の処理中に発生した警告のタイプ。

    データタイプ：文字列
    result.relations.warnings.message この依存関係性 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_id を返します。
    • ペイロードの重複排除機能をサポートします。
    • サマリを生成します。

    URL 形式

    バージョニングされた URL：/api/now/{api_version}/identifyreconcile/queryEnhanced

    デフォルトの URL：/api/now/identifyreconcile/queryEnhanced

    注:
    利用可能なバージョンは、 REST API エクスプローラーで指定されます。スクリプト済み REST API の場合、[ スクリプト済み REST サービス] フォームに追加のバージョン情報があります。

    サポートされている要求パラメーター

    表 : 19. パスパラメーター
    名前 説明
    api_version オプションアクセスするエンドポイントのバージョン。たとえば、v1 や v2 などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。

    データタイプ：文字列
    表 : 20. クエリパラメーター
    名前 説明
    options 要求に適用される拡張 IRE オプションを表す名前と値のペアのカンマ区切りリスト。

    例として、部分的ペイロードと部分的コメントのデフォルト値を上書きし、ペイロードを重複排除し、拡張 IRE オプションのサマリーを生成するには、次のコマンドを実行します。

    partial_payloads:false,partial_commits:false,deduplicate_payloads:false,generate_summary:true
    注:
    デフォルトでは、または partial_payloads が true に設定されている場合は、partial_commits と deduplicate_payloads の両方が (これらが false に設定されている場合でも) 有効になります。これらの機能は、部分的ペイロード機能に不可欠であるためです。

    拡張 IRE オプションの詳細については、「 識別および調整エンジン (IRE)」を参照してください。

    名前と値の各ペアの有効な値：
    • true：この拡張 IRE オプションを有効にします。
    • false：この拡張 IRE オプションを無効にします。

    データタイプ：文字列
    sysparm_data_source CI 情報のソース。これは、構成アイテム [cmdb_ci] テーブルの discovery_source フィールドに定義された選択値の 1 つである必要があります。

    データタイプ：文字列

    デフォルト：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] テーブルへの参照を含むルックアップテーブルに基づいて最上位レベルの構成アイテムを識別するために使用されます。

    データタイプ: Array off Objects

    "lookup": [
  {
    "className": "String",
    "internal_id": "String",
    "sys_object_source_info": {Object},
    "values": {Object}
  }
]
    items.lookup.className 必須です。作成または更新する CI の sys_class_name またはクラス/テーブル名。この値は、cmdb_serial_number や cmdb_ci_network_adapter などの任意の CMDB クラス/テーブルまたは非 CMDB 階層クラスにすることができます。

    データタイプ：文字列
    items.lookup.internal_id このペイロードのこのルックアップレコードの一意の識別子。任意の値にすることができますが、ペイロード内で一意である必要があります。

    データタイプ：文字列
    items.lookup.sys_object_source_info 指定されたデータソースの一意の CI 識別子を記述するオブジェクト。同じ CI でもソースが異なると、名前と値のペアが異なる場合があります。

    データタイプ：オブジェクト

    "sys_object_source_info": {
  "source_feed": "String",
  "source_name": "String",  
  "source_native_key": "String",
  "source_recency_timestamp": "String"
}
    items.lookup.sys_object_source_info.source_feed この CI を送信するフィードを一意に識別する名前。ソースが複数のフィードを持つことができる場合に使用します。

    データタイプ：文字列
    items.lookup.sys_object_source_info.source_name CI 情報のデータソース。この値は、構成アイテム [cmdb_ci] テーブルの discovery_source フィールドに定義された選択値の 1 つである必要があります。

    データタイプ：文字列
    items.lookup.sys_object_source_info.source_native_key CI のソースからの一意のキー/ID。アイテムに固有の任意の文字列にすることができます。

    データタイプ：文字列
    items.lookup.sys_object_source_info.source_recency_timestamp CI がスキャンされた UTC 日時。

    データタイプ：文字列

    形式：YYYY-MM-DD hh:mm:ss
    items.lookup.values このルックアップアイテムのフィールドを名前/値のペアとして記述するオブジェクト。名前はフィールド名です。

    データタイプ：オブジェクト

    フィールド名とタイプは、次のようにユーザーが選択したフィールドによって異なります。

    "values": {
  "ip_address": "String",
  "mac_address": "String",
  "serial_number": "String",
  "serial_number_type": "String",
  "valid": "String"
}
    items.related 識別される最上位レベル CI への参照を持つ関連テーブルに基づいて、各オブジェクトが作成または更新するアイテムレコードを説明するオブジェクトのアレイ。関連エントリ [cmdb_related_entry] テーブルのルールは、このアレイに含めることができるレコードのタイプを定義します。

    関連するテーブルは、構成アイテム [cmdb_ci] テーブルを拡張する場合もあれば拡張しない場合もあります。これらのレコードは、構成アイテムの識別には使用されません。

    データタイプ：オブジェクトのアレイ

    "related": [
  {
    "className": "String",
    "internal_id": "String",
    "sys_object_source_info": {Object},
    "values": {Object}
  }
]
    items.related.className 必須です。作成または更新する関連アイテムの sys_class_name またはクラス/テーブル名。

    データタイプ：文字列
    items.related.internal_id このペイロードのこの関連アイテムの一意の識別子。任意の値にすることができますが、ペイロード内で一意である必要があります。

    データタイプ：文字列
    items.related.sys_object_source_info 指定されたデータソースの一意の CI 識別子を記述するオブジェクト。同じ CI でもソースが異なると、名前と値のペアが異なる場合があります。

    データタイプ：オブジェクト

    "sys_object_source_info": {
  "source_feed": "String",
  "source_name": "String",  
  "source_native_key": "String",
  "source_recency_timestamp": "String"
}
    items.related.sys_object_source_info.source_feed この関連アイテムを送信するフィードを一意に識別する名前。ソースが複数のフィードを持つことができる場合に使用します。

    データタイプ：文字列
    items.related.sys_object_source_info.source_name 関連アイテム情報のデータソース。この値は、構成アイテム [cmdb_ci] テーブルの discovery_source フィールドに定義された選択値の 1 つである必要があります。

    データタイプ：文字列
    items.related.sys_object_source_info.source_native_key 関連アイテムのソースからの一意のキー/ID。アイテムに固有の任意の文字列にすることができます。

    データタイプ：文字列
    items.related.sys_object_source_info.source_recency_timestamp 関連アイテムがスキャンされた UTC 日時。

    データタイプ：文字列

    形式：YYYY-MM-DD hh:mm:ss
    items.related.values この関連アイテム用に名前/値のペアとして作成または更新するフィールドを説明するオブジェクト。名前はフィールド名です。参照フィールドの場合、値は参照される sys_id である必要があります。

    データタイプ：オブジェクト

    フィールド名とタイプは、次のようにユーザーが選択したフィールドによって異なります。

    "values": {
  "host_name": "String",
  "ip_address": "String",
  "name": "String",
  "os_name": "String",
  "sys_class_name": "String"
}
    items.settings 許可される更新のタイプを定義するパラメーターが含まれるオブジェクト。

    データタイプ：オブジェクト

    "settings": {
  "skipReclassificationRestrictionRules": Boolean,
  "updateWithoutDowngrade": Boolean,
  "updateWithoutSwitch": Boolean,
  "updateWithoutUpgrade": Boolean
}
    items.settings.skipReclassificationRestrictionRules IRE がペイロードアイテムのクラスに一致する再分類制限ルールの実行をスキップすべきかどうかを示すフラグ。
    有効な値：
    • true：ルールの実行をスキップします。
    • false：ルールを実行します。

    デフォルト値：false
    items.settings.updateWithoutDowngrade この CI に対して更新とダウングレードの両方を許可するかどうかを示すフラグ。
    有効な値：
    • true：アイテムを更新しますが、ダウングレードは許可されません。
    • false：アイテムの更新とダウングレードの両方が許可されます。

    データタイプ：ブール

    デフォルト値：false
    items.settings.updateWithoutSwitch この CI を更新してクラスを切り替えることができるかどうかを示すフラグ。
    有効な値：
    • true：アイテムを更新しますが、クラスの切り替えは許可されません。
    • false：アイテムの更新とクラスの切り替えの両方が許可されます。

    データタイプ：ブール

    デフォルト値：false
    items.settings.updateWithoutUpgrade この CI に対して更新とアップグレードの両方を許可するかどうかを示すフラグ。
    有効な値：
    • true：アイテムを更新しますが、アップグレードは許可されません。
    • false：アイテムの更新とアップグレードの両方が許可されます。

    データタイプ：ブール

    デフォルト値：false
    items.sys_object_source_info 一意の CI 識別子を記述するオブジェクト。

    データタイプ：オブジェクト

    "sys_object_source_info": {
  "source_feed": "String",
  "source_name": "String",  
  "source_native_key": "String",
  "source_recency_timestamp": "String"
}
    items.sys_object_source_info.source_feed この CI を送信するフィードを一意に識別する名前。ソースが複数のフィードを持つことができる場合に使用します。

    データタイプ：文字列
    items.sys_object_source_info.source_name CI 情報のデータソース。この値は、構成アイテム [cmdb_ci] テーブルの discovery_source フィールドに定義された選択値の 1 つである必要があります。

    データタイプ：文字列
    items.sys_object_source_info.source_native_key CI のソースからの一意のキー/ID。アイテムに固有の任意の文字列にすることができます。

    データタイプ：文字列
    items.sys_object_source_info.source_recency_timestamp CI がスキャンされた UTC 日時。

    データタイプ：文字列

    形式：YYYY-MM-DD hh:mm:ss
    items.values この CI 用に名前/値のペアとして作成または更新するフィールドを説明するオブジェクト。名前はフィールド名です。参照フィールドの場合、値は参照される sys_id である必要があります。

    データタイプ：オブジェクト

    フィールド名とタイプは、次のようにユーザーが選択したフィールドによって異なります。

    "values": {
  "host_name": "String",
  "ip_address": "String",
  "name": "String",
  "os_name": "String",
  "sys_class_name": "String"
}
    referenceItems ペイロード内の 2 つのアイテム間の参照のリスト。

    データタイプ：オブジェクトのアレイ

    "referenceItems": [
  {
    "referenced": "String",
    "referencedBy": "String",
    "referenceField": "String"
  }
]
    referenceItems.referenced 別のアイテムによって参照されているアイテムに対して定義された internal_id。

    データタイプ：文字列
    referenceItems.referencedBy 別のアイテムを参照するアイテムに対して定義された internal_id。

    データタイプ：文字列
    referenceItems.referenceField referencedBy アイテムのクラス/テーブル内の参照フィールドの名前。

    データタイプ：文字列
    relations ペイロードで定義された 2 つのアイテム間の関係のリスト。
    このアレイ内のオブジェクトは、2 つの形式のいずれかを使用できます。
    • オブジェクトは、parent および child の名前と値のペアを使用して 2 つのトップレベルアイテム (のみ) の間の関係を定義できます。この値はペイロード items アレイのアイテムインデックスを表します。
    • オブジェクトは、parent_id および child_id のキー/値のペアを使用して、最上位レベルのアイテム、関連するアイテム、ルックアップアイテムを含む任意の 2 つのアイテム間の関係を定義できます。この値は、それらのアイテムに対して定義された internal_id 値を表します。

    データタイプ：オブジェクトのアレイ

    "relations": [
  {
    "child": Number,
    "parent": Number,
    "sys_rel_source_info": {Object},
    "type": "String"
  }
]
    "relations": [
  {
    "child_id": "String",
    "parent_id": "String",
    "sys_rel_source_info": {Object},
    "type": "String"
  }
]
    relations.child 関係内の子を表す items アレイ内の CI オブジェクトの整数インデックス。

    データタイプ：数値
    relations.child_id 関係内の子アイテムの internal_id。

    データタイプ：文字列
    relations.parent 関係内の親を表す items アレイ内の CI オブジェクトの整数インデックス。

    データタイプ：数値
    relations.parent_id 関係内の親アイテムの internal_id。

    データタイプ：文字列
    relations.sys_rel_source_info 関係の検出ソース情報。非依存関係の場合、この情報は関係ソース [sys_rel_source] テーブルにあります。

    データタイプ：オブジェクト

    "sys_rel_source_info": { 
  "source_name": "String", 
  "source_feed": "String" 
}
    relations.sys_rel_source_info.source_name 検出ソース名。

    デフォルト：API メソッドパラメーターで渡される検出ソース。
    relations.sys_rel_source_info.source_feed 検出ソース内のサブ検出/スキャンである文字列。

    デフォルト値：「UNKNOWN」は、sys_rel_source テーブルにレコードを作成するときに source_feed 列に格納されます。
    relations.type 親アイテムと子アイテムの間に存在する関係のタイプ。これは、CI 関係タイプ [cmdb_rel_type] テーブルからの名前フィールド値である必要があります。

    データタイプ：文字列

    ヘッダー

    次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 サポートされている REST API ヘッダー」を参照してください。

    表 : 22. 要求ヘッダー
    ヘッダー 説明
    承認 応答本文のデータフォーマット。application/json のみをサポートします。
    Content-Type 要求本文のデータ形式。application/json のみをサポートします。
    表 : 23. 応答ヘッダー
    ヘッダー 説明
    なし

    ステータスコード

    この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 REST API HTTP 応答コード」を参照してください。

    表 : 24. ステータスコード
    ステータスコード 説明
    200 成功。要求が正常に処理されました。
    401 権限がありません。ユーザー資格情報が間違っているか、渡されていません。
    500 内部サーバーエラー。要求の処理中に予期しないエラーが発生しました。

    エラーメッセージの詳細「チャンク […] は有効なエントリーではありません (Chunk […] is not a valid entry)」は、options クエリパラメーターが正しい名前と値のペア形式でないことを示しています。

    たとえば、部分的な 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 が識別子ルールテーブルで見つかりませんでした。
    • SKIPPED：識別は試行されませんでした。この識別子ルールテーブルの検索に必要な属性が指定されなかったため、ルールは適用されませんでした。

    データタイプ：文字列
    result.additionalCommittedItems.identificationAttempts.attributes この追加の CI の識別の試行中に使用される CI ID エントリ属性のアレイ。

    データタイプ：アレイ

    属性の名前とタイプは、次のような使用される要求本文データと識別子によって異なります。

    "attributes": [
  "serial_number": "String",
  "serial_number_type": "String"
]
    result.additionalCommittedItems.identificationAttempts.hybridEntryCiAttributes この追加の CI 識別試行中に使用された CI ID エントリー属性のリスト。

    データタイプ：アレイ

    属性の名前とタイプは、次のような使用される要求本文データと識別子によって異なります。

    "hybridEntryCiAttributes": [
  "name": "String",
  "serial_number": "String"
]
    result.additionalCommittedItems.identificationAttempts.identifierName この追加の CI 識別の試行に使用される識別子ルール。

    データタイプ：文字列
    result.additionalCommittedItems.identificationAttempts.searchOnTable この追加の CI 識別の試行で検索されたテーブルの名前。

    データタイプ：文字列
    result.additionalCommittedItems.identifierEntrySysId この追加の CI を識別するために使用される識別子ルールの sys_id。
    注目すべき値：
    • Unknown：この追加の CI の識別に失敗しました。詳細については、「errors」を参照してください。

    データタイプ：文字列
    result.additionalCommittedItems.inputIndices この追加の CI に対応する要求本文 items アレイの CI のインデックス値のリスト。

    データタイプ：オブジェクトのアレイ

    "inputIndices": [
  {
    Number
  }
]
    result.additionalCommittedItems.markers 内部使用のためのマーカー値のリスト。

    データタイプ：アレイ

    "markers": []
    result.additionalCommittedItems.mergedPayloads この追加 CI の処理中に結合された CMDB IRE 部分的ペイロード [cmdb_ire_partial_payloads] テーブルの部分的ペイロードのsys_id値のリスト。

    データタイプ：アレイ

    "mergedPayloadIds": [
  "String"
]
    result.additionalCommittedItems.operation この追加の CI に対して実行された操作。
    可能な値：
    • DELETE：既存の CI がターゲットテーブルから削除されます。
    • INSERT：追加の CI が新しいレコードとしてターゲットテーブルに挿入されます。
    • NO_CHANGE：追加の CI に対して実行された操作はありません。
    • UPDATE：ターゲットテーブルの既存の CI が更新されます。
    • UPDATE_WITH_DOWNGRADE：ターゲットテーブル内の既存の CI が更新され、そのクラスがより汎用的なクラス (先祖クラス) に変更されます。
    • UPDATE_WITH_SWITCH：ターゲットテーブル内の既存の CI が更新され、そのクラスが先祖クラスまたは子孫クラスではない別のクラスに変更されます。
    • UPDATE_WITH_UPGRADE：ターゲットテーブル内の既存の CI が更新され、そのクラスがより特化されたクラス (子孫クラス) に変更されます。

    データタイプ：文字列
    result.additionalCommittedItems.sysId 識別によって検出されたこの追加の CI の sys_id。

    注目値: 不明:この追加の CI の識別に失敗しました。詳細については、「errors」を参照してください。

    データタイプ：文字列
    result.additionalCommittedItems.warnings この追加の CI の処理中に発生した警告のリスト。

    データタイプ：オブジェクトのアレイ

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    result.additionalCommittedItems.warnings.error この追加の CI の処理中に発生した警告のタイプ。

    データタイプ：文字列
    result.additionalCommittedItems.warnings.message この追加の CI の処理中に発生した警告メッセージ。

    データタイプ：文字列
    result.additionalCommittedRelations 要求本文に含まれていない依存関係性 CI のリスト 挿入または更新する relations リスト。

    データタイプ：オブジェクトのアレイ

    "additionalCommittedRelations": [
  {
    "className": "String",
    "operation": "String",
    "markers": [Array],
    "inputIndices": [Array],
    "mergedPayloadIds": [Array]
  }
]
    result.additionalCommittedRelations.className この追加の依存関係 CI の sys_class_name。
    サポートされている値のみ：
    • cmdb_rel_ci：CI 関係テーブル。

    データタイプ：文字列
    result.additionalCommittedRelations.errorCount この追加の依存関係 CI の処理中に発生したエラーの数。

    データタイプ：数値
    result.additionalCommittedRelations.errors この追加の依存関係性 CI の処理中に発生したエラーのリスト。

    データタイプ：オブジェクトのアレイ

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    result.additionalCommittedRelations.errors.error この追加の依存関係性 CI の処理中に発生したエラーのタイプ。

    データタイプ：文字列
    result.additionalCommittedRelations.errors.message この追加の依存関係性 CI の処理中に発生したエラーメッセージ。

    データタイプ：文字列
    result.additionalCommittedRelations.inputIndices この追加の依存関係性 CI に対応する要求本文 relations アレイ内の依存関係性 CI オブジェクトのインデックス値のリスト。

    データタイプ：アレイ

    "inputIndices": [
  Number
]
    result.additionalCommittedRelations.markers 内部使用のためのマーカー値のリスト。

    データタイプ：アレイ

    "markers": []
    result.additionalCommittedRelations.mergedPayloadIds この追加の依存関係性 CI の処理中に結合された、CMDB IRE 部分的ペイロード [cmdb_ire_partial_payloads] テーブルの部分的ペイロードのsys_id値のリスト。

    データタイプ：アレイ

    "mergedPayloadIds": [
  "String"
]
    result.additionalCommittedRelations.operation この追加の依存関係性 CI に対して実行される操作。
    可能な値：
    • INSERT：依存関係 CI が新しいレコードとしてターゲットテーブルに挿入されます。
    • INSERT_AS_INCOMPLETE：依存関係 CI にエラーがあり、CMDB IRE 不完全ペイロード [cmdb_ire_incomplete_payloads] テーブルに挿入されます。
    • INSERT_AS_PARTIAL：依存関係 CI にエラーがあり、CMDB IRE 部分的ペイロード [cmdb_ire_partial_payloads] テーブルに挿入されます。
    • NO_CHANGE：依存関係 CI に対して実行された操作はありません。
    • UPDATE：ターゲットテーブルの既存の依存関係 CI が更新されます。

    データタイプ：文字列
    result.items 要求本文 items アレイに含まれる CI のリスト。

    データタイプ：オブジェクトのアレイ

    "items": [
  {
    "additionalRelatedItems": [Array],
    "className": "String",
    "duplicateLookupIndices": {Object},
    "errorCount": Number,
    "errors": [Array],
    "identificationAttempts": [Array],
    "identifierEntrySysId": "String",
    "info": [Array],
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloadIds": [Array],
    "operation": "String",
    "relatedItems": [Array],
    "relatedSysIds": [Array],
    "sysId": "String",
    "warnings": [Array]
  }
]
    result.items.additionalRelatedItems CMDB IRE 部分ペイロード [cmdb_ire_partial_payloads] テーブルからの関連 CI (テーブルルックアップ CI) のリスト。

    データタイプ：オブジェクトのアレイ

    "additionalRelatedItems": [
  {
    "className": "String",
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloadIds": [Array],
    "sysId": "String"
  }
]
    result.items.additionalRelatedItems.className 関連アイテムの sys_class_name。

    データタイプ：文字列
    result.items.additionalRelatedItems.inputIndices この関連アイテムに対応する要求本文 items アレイの CI のインデックス値のリスト。

    データタイプ：アレイ

    "inputIndices": [
    Number
]
    result.items.additionalRelatedItems.markers 内部使用のためのマーカー値のリスト。

    データタイプ：アレイ

    "markers": []
    result.items.additionalRelatedItems.mergedPayloadIds この関連アイテムの処理中に結合された、CMDB IRE 部分ペイロード [cmdb_ire_partial_payloads] テーブルの部分的ペイロードのsys_id値のリスト。

    データタイプ：アレイ

    "mergedPayloadIds": [
  "String"
]
    result.items.additionalRelatedItems.sysId この関連 CI のSys_id。

    データタイプ：文字列
    result.items.className この CI のSys_class_name。

    データタイプ：文字列
    result.items.duplicateLookupIndices 同じ関連 CI を参照する items.lookup アレイ要素のインデックス値のアレイを含むオブジェクト。

    アレイ名は、指定された関連 CI を参照する要求本文 items.lookup アレイの最初の要素を示します。その値は、同じ関連 CI を参照する同じアレイの追加要素のセットです。

    データタイプ：オブジェクト

    この例は、 items.lookup アレイの 2 番目の要素が、そのアレイの後続の要素と同じ関連 CI を参照するケースを示しています。

    "duplicateLookupIndices": [
  "2": [Array]
]
    result.items.errorCount この CI の処理中に発生したエラーの数。

    データタイプ：数値
    result.items.errors この CI の処理中に発生したエラーのリスト。

    データタイプ：オブジェクトのアレイ

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    result.items.errors.error この CI の処理中に発生したエラーのタイプ。

    データタイプ：文字列
    result.items.errors.message この CI の処理中に発生したエラーメッセージ。

    データタイプ：文字列
    result.items.identificationAttempts この CI を識別するための試行のリスト。
    データタイプ：オブジェクトのアレイ
    "identificationAttempts": [
  {
    "attemptResult": "String",
    "attributes": [Array],
    "hybridEntryCiAttributes": [Array],
    "identiferName": "String",
    "searchOnTable": [Array]
  }
]
    result.items.identificationAttempts.attemptResult この CI 識別試行の結果。
    可能な値：
    • MATCHED：識別に成功しました。指定された属性と完全に一致する一意の CI が識別子ルールテーブルで見つかりました。
    • MULTI_MATCH：エラーのため識別に失敗しました。指定された属性に対して照合しているときに、識別子ルールテーブルに重複する CI が見つかりました。
    • NO_MATCH：識別に失敗しました。指定された属性と一致する CI が識別子ルールテーブルで見つかりませんでした。
    • SKIPPED：識別は試行されませんでした。この識別子ルールテーブルの検索に必要な属性が指定されなかったため、ルールは適用されませんでした。

    データタイプ：文字列
    result.items.identificationAttempts.attributes この CI 識別試行中に使用された CI ID エントリー属性のリスト。

    データタイプ：アレイ

    属性の名前とタイプは、次のような使用される要求本文データと識別子によって異なります。

    "attributes": [
  "serial_number": "String",
  "serial_number_type": "String",
]
    result.items.identificationAttempts.hybridEntryCiAttributes この CI 識別試行中に使用された CI ID エントリー属性のリスト。

    データタイプ：アレイ

    属性の名前とタイプは、次のような使用される要求本文データと識別子によって異なります。

    "hybridEntryCiAttributes": [
  "name": "String",
  "serial_number": "String"
]
    result.items.identificationAttempts.identifierName この CI の識別試行に使用される識別子ルール。

    データタイプ：文字列
    result.items.identificationAttempts.searchOnTable この CI 識別試行のために検索されたテーブルの名前。

    データタイプ：文字列
    result.items.identifierEntrySysId この CI を識別するために使用される識別子ルールのSys_id。
    注目すべき値：
    • Unknown：この CI の識別に失敗しました。詳細については、「errors」を参照してください。

    データタイプ：文字列
    result.items.info アイテムの処理に関する追加情報のリスト。

    データタイプ：オブジェクトのアレイ

    "info": [
  {
    "code": "String",
    "message": "String",
    "ruleSysId": "String"
  }
]
    result.items.info.code スキップされた再分類タイプ。
    可能な値：
    • SKIPPED_CLASS_SWITCH
    • SKIPPED_CLASS_DOWNGRADE
    • SKIPPED_CLASS_UPGRADE
    result.items.info.message 再分類をスキップする理由に関する追加のインサイトを提供するメッセージ。

    データタイプ：文字列
    result.items.info.ruleSysId 一致した再分類制限ルールの sys_id。再分類制限ルールのために IRE が再分類をスキップする場合にのみ適用されます。ペイロードまたはグローバルフラグのために再分類がスキップされた場合、この値は空になります。

    データタイプ：文字列
    result.items.inputIndices この CI に対応する要求本文 items アレイの CI のインデックス値のリスト。

    データタイプ：オブジェクトのアレイ

    "inputIndices": [
  {
    Number
  }
]
    result.items.markers 内部使用のためのマーカー値のリスト。

    データタイプ：アレイ

    "markers": []
    result.items.mergedPayloadIds この CI の処理中に結合された CMDB IRE 部分的ペイロード [cmdb_ire_partial_payloads] テーブルの部分的ペイロードのsys_id値のリスト。

    データタイプ：アレイ

    "mergedPayloadIds": [
  "String"
]
    result.items.operation この CI に対して実行される操作。
    可能な値：
    • DELETE：既存の CI がターゲットテーブルから削除されます。
    • INSERT：CI が新しいレコードとしてターゲットテーブルに挿入されます。
    • NO_CHANGE：CI に対して実行された操作はありません。
    • UPDATE：ターゲットテーブルの既存の 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 アレイからのインデックス値。

    データタイプ：数値
    result.items.relatedItems.markers 内部使用のためのマーカー値のリスト。

    データタイプ：アレイ

    "markers": []
    result.items.relatedItems.mergedPayloadIds 処理中にこの CI に結合された CMDB IRE 部分ペイロード [cmdb_ire_partial_payloads] テーブルのエントリのsys_id値のリスト。

    データタイプ：アレイ

    "mergedPayloadIds": [
  "String"
]
    result.items.relatedSysIds 要求本文 items.lookup アレイの関連アイテム (テーブルルックアップアイテム) のsys_id値のリスト。

    データタイプ：アレイ

    注目すべき値：
    • null：この関連アイテムの識別された sys_id がありませんでした。
    "relatedSysIds": [
    Number,
    Number
]
    result.items.sysId 識別により、この CI に対してSys_idが見つかりました。
    注目すべき値：
    • Unknown：この CI の識別に失敗しました。詳細については、「errors」を参照してください。

    データタイプ：文字列
    result.items.warnings この CI の処理中に発生した警告のリスト。

    データタイプ：オブジェクトのアレイ

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    result.items.warnings.error この CI の処理中に発生した警告のタイプ。

    データタイプ：文字列
    result.items.warnings.message この CI の処理中に発生した警告メッセージ。

    データタイプ：文字列
    result.logContextId このペイロードに対してレポートされたコンテキスト ID。

    データタイプ：文字列
    result.relations 要求本文 relations アレイの依存関係性 CI のリスト。

    データタイプ：オブジェクトのアレイ

    "relations": [
  {
    "className": "String",
    "errorCount": Number,
    "errors": [Array],
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloadIds": [Array],
    "operation": "String",
    "warnings": [Array]
  }
]
    result.relations.className この依存関係 CI の sys_class_name。
    サポートされている値のみ：
    • cmdb_rel_ci：CI 関係テーブル。

    データタイプ：文字列
    result.relations.errorCount この依存関係性 CI の処理中に発生したエラーの数。

    データタイプ：数値
    result.relations.errors この依存関係性 CI の処理中に発生したエラーのリスト。

    データタイプ：オブジェクトのアレイ

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    result.relations.errors.error この依存関係性 CI の処理中に発生したエラーのタイプ。

    データタイプ：文字列
    result.relations.errors.message この依存関係 CI の処理中に発生したエラーメッセージ。

    データタイプ：文字列
    result.relations.inputIndices この依存関係性 CI に対応する要求本文 relations アレイ内の依存関係性 CI オブジェクトのインデックス値のリスト。

    データタイプ：アレイ

    "inputIndices": [
  Number
]
    result.relations.markers 内部使用のためのマーカー値のリスト。

    データタイプ：アレイ

    "markers": []
    result.relations.mergedPayloadIds この依存関係性 CI の処理中に結合された CMDB IRE 部分ペイロード [cmdb_ire_partial_payloads] テーブルの部分的ペイロードのsys_id値のリスト。

    データタイプ：アレイ

    "mergedPayloadIds": [
  "String"
]
    result.relations.operation この依存関係性 CI に対して実行される操作。
    可能な値：
    • INSERT：依存関係 CI が新しいレコードとしてターゲットテーブルに挿入されました。
    • INSERT_AS_INCOMPLETE：依存関係 CI にエラーがあり、CMDB IRE 不完全ペイロード [cmdb_ire_incomplete_payloads] テーブルに挿入されました。
    • INSERT_AS_PARTIAL：依存関係 CI にエラーがあり、CMDB IRE 部分的ペイロード [cmdb_ire_partial_payloads] テーブルに挿入されました。
    • NO_CHANGE：依存関係 CI に対して実行された操作はありません。
    • UPDATE：ターゲットテーブルの既存の依存関係 CI が更新されました。

    データタイプ：文字列
    result.relations.warnings この依存関係性 CI の処理中に発生した警告のリスト。

    データタイプ：オブジェクトのアレイ

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    result.relations.warnings.error この依存関係性 CI の処理中に発生した警告のタイプ。

    データタイプ：文字列
    result.relations.warnings.message この依存関係性 CI の処理中に発生した警告メッセージ。

    データタイプ：文字列

    cURL 要求

    コンピューター CI の部分的ペイロードの送信をシミュレートします。

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

    応答は、ペイロードが CMDB IRE 部分のペイロード [cmdb_ire_partial_payloads] テーブルに挿入されることを示します。

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

    サマリ生成の拡張 IRE オプションを有効にして、コンピューター CI の説明を完了する 2 番目の部分的ペイロードの送信をシミュレートします。

    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
      }
    }
  }
}