---
sourceDocument: Xanadu API リファレンス
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - ja-JP

ft:publication_title :

    - Xanadu API リファレンス

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# 識別および調整 API

# 識別および調整 API {#ariaid-title1}

* リリースバージョン: Xanadu
* 
* 更新日 2024年08月01日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：197分

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

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

IRE の詳細については、「 [識別および調整エンジン (IRE)」](https://www.servicenow.com/docs/access?context=ire&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US)を参照してください。

## 識別および調整 - POST /now/identifyreconcile {#ariaid-title2}

指定されたペイロード (要求本文) に識別および調整ルールを適用して、CMDB の構成アイテム (CI) を挿入または更新します。CMDB を直接更新する代わりに、この API を使用します。
[識別および調整 - POST /now/identifyreconcile/query](https://servicenow-prod.fluidtopics.net/LqdqEqmIzhmfkClmZZVO7Q#identifyreconcile-POST-query "データベース内の CMDB の操作をコミットせずに指定されたペイロード (要求の本文) で実行する操作 (挿入か更新か) を決定します。") エンドポイントを使用して、データベースへの変更をコミットせずに、このエンドポイントへのペイロードの送信をシミュレートします。

拡張 IRE オプションを指定する必要がある場合は、代わりに [識別および調整 - POST /now/identifyreconcile/enhanced](https://servicenow-prod.fluidtopics.net/LqdqEqmIzhmfkClmZZVO7Q#identifyreconcile-POST-enhanced "指定されたペイロード (要求本文) に識別および調整ルールを適用して、CMDB の構成アイテム (CI) を挿入または更新します。CMDB を直接更新する代わりに、この API を使用します。") エンドポイントを使用します。拡張 IRE オプションの詳細については、「 [識別および調整エンジン (IRE)」](https://www.servicenow.com/docs/access?context=ire&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US)を参照してください。

### URL 形式

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

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

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

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

| 名前 | 説明 |
|-|-|
| api_version | オプションアクセスするエンドポイントのバージョン。たとえば、<kbd class="ph userinput">v1</kbd> や <kbd class="ph userinput">v2</kbd>。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 |
[表 : 1. パスパラメーター]

{#identifyreconcile-POST__entry__6}

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

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

| 名前 | 説明 |
|-|-|
| アイテム | 作成または更新する CI のリスト。 データタイプ：オブジェクトのアレイ "items": [ { "className": "String", "internal_id": "String", "lookup": [Array], "related": [Array], "settings": {Object}, "sys_object_source_info": {Object}, "values": {Object} } ] |
| items.className | 必須です。作成または更新する CI の sys_class_name (クラス/テーブル名)。この値は、cmdb_ci_linux_server や cmdb_ci_win_server などの任意の CMDB テーブルにすることができます。 データタイプ：文字列 |
| items.internal_id | このペイロードのこのアイテムの一意の識別子。任意の値にすることができますが、ペイロード内で一意である必要があります。 データタイプ：文字列 |
| items.lookup | 各オブジェクトがルックアップベースの識別レコードを説明するオブジェクトのアレイ。これらのレコードは、構成アイテム \[cmdb_ci\] テーブルへの参照を含むルックアップテーブルに基づいて最上位レベルの構成アイテムを識別するために使用されます。 データタイプ:アレイオフオブジェクト "lookup": [ { "className": "String", "internal_id": "String", "sys_object_source_info": {Object}, "values": {Object} } ] |
| items.lookup.className | 必須です。作成または更新する CI の sys_class_name またはクラス/テーブル名。この値は、cmdb_serial_number や cmdb_ci_network_adapter などの任意の CMDB クラス/テーブルまたは非 CMDB 階層クラスにすることができます。 データタイプ：文字列 |
| items.lookup.internal_id | このペイロードのこのルックアップレコードの一意の識別子。任意の値にすることができますが、ペイロード内で一意である必要があります。 データタイプ：文字列 |
| items.lookup.sys_object_source_info | 指定されたデータソースの一意の CI 識別子を記述するオブジェクト。同じ CI でもソースが異なると、名前と値のペアが異なる場合があります。 データタイプ：オブジェクト "sys_object_source_info": { "source_feed": "String", "source_name": "String", "source_native_key": "String", "source_recency_timestamp": "String" } |
| items.lookup.sys_object_source_info.source_feed | この CI を送信するフィードを一意に識別する名前。ソースが複数のフィードを持つことができる場合に使用します。 データタイプ：文字列 |
| items.lookup.sys_object_source_info.source_name | CI 情報のデータソース。この値は、構成アイテム \[cmdb_ci\] テーブルの discovery_source フィールドに定義された選択値の 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 値を表します。 {#identifyreconcile-POST__ul_s1s_phb_nlb} データタイプ：オブジェクトのアレイ "relations": [ { "child": Number, "parent": Number, "sys_rel_source_info": {Object}, "type": "String" } ] "relations": [ { "child_id": "String", "parent_id": "String", "sys_rel_source_info": {Object}, "type": "String" } ] |
| 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\] テーブルからの名前フィールド値である必要があります。 データタイプ：文字列 |
[表 : 3. 要求本文パラメーター (XML または JSON)]

### ヘッダー

次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。
{#identifyreconcile-POST__entry__102}{#identifyreconcile-POST__accept-JSON-only-entry-RESTAPI}{#identifyreconcile-POST__content_type-JSON-only-entry-RESTAPI}

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

{#identifyreconcile-POST__entry__108}

| ヘッダー | 説明 |
|-|-|
| なし |   |
[表 : 5. 応答ヘッダー]

### ステータスコード

この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。
{#identifyreconcile-POST__entry__112}{#identifyreconcile-POST__entry-200-status-code}{#identifyreconcile-POST__entry-401-status-code}{#identifyreconcile-POST__entry-500-status-code}

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

### 応答本文のパラメーター (JSON または XML)

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

| 名前 | 説明 |
|-|-|
| 結果 | クエリによって生成された結果のリスト。 データタイプ：アレイ "result": [ "additionalCommittedItems": [Array], "additionalCommittedRelations": [Array], "items": [Array], "relations": [Array] ] |
| result.additionalCommittedItems | 要求本文に含まれていない CI のリスト 挿入または更新するアレイ items 。 データタイプ：オブジェクトのアレイ "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：識別は試行されませんでした。この識別子ルールテーブルの検索に必要な属性が指定されなかったため、ルールは適用されませんでした。 {#identifyreconcile-POST__ul_axc_bxx_glb} データタイプ：文字列 |
| 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」を参照してください。 {#identifyreconcile-POST__ul_hlk_gyx_glb} データタイプ：文字列 |
| result.additionalCommittedItems.inputIndices | この追加 CI に対応する要求本文 items アレイからの CI のインデックス値のリスト。 データタイプ：オブジェクトのアレイ "inputIndices": [ { Number } ] |
| result.additionalCommittedItems.markers | 内部使用のマーカー値のリスト。 データタイプ：アレイ "markers": [] |
| result.additionalCommittedItems.mergedPayloads | この追加 CI の処理中に結合された CMDB IRE 部分のペイロード \[cmdb_ire_partial_payloads\] テーブルの部分的ペイロードのsys_id値のリスト。 データタイプ：アレイ "mergedPayloadIds": [ "String" ] |
| result.additionalCommittedItems.operation | この追加の CI に対して実行された操作。 可能な値： * DELETE：既存の CI がターゲットテーブルから削除されます。 * INSERT：追加の CI が新しいレコードとしてターゲットテーブルに挿入されます。 * NO_CHANGE：追加の CI に対して実行された操作はありません。 * UPDATE：ターゲットテーブルの既存の CI が更新されます。 * UPDATE_WITH_DOWNGRADE：ターゲットテーブル内の既存の CI が更新され、そのクラスがより汎用的なクラス (先祖クラス) に変更されます。 * UPDATE_WITH_SWITCH：ターゲットテーブル内の既存の CI が更新され、そのクラスが先祖クラスまたは子孫クラスではない別のクラスに変更されます。 * UPDATE_WITH_UPGRADE：ターゲットテーブル内の既存の CI が更新され、そのクラスがより特化されたクラス (子孫クラス) に変更されます。 {#identifyreconcile-POST__ul_dwt_qwx_glb} データタイプ：文字列 |
| result.additionalCommittedItems.sysId | 識別によって検出されたこの追加の CI の sys_id。 重要な値: 不明:この追加の CI の識別に失敗しました。詳細については、「errors」を参照してください。 データタイプ：文字列 |
| result.additionalCommittedItems.warnings | この追加 CI の処理中に発生した警告のリスト。 データタイプ：オブジェクトのアレイ "warnings": [ { "error": "String", "message": "String" } ] |
| result.additionalCommittedItems.warnings.error | この追加の CI の処理中に発生した警告のタイプ。 データタイプ：文字列 |
| result.additionalCommittedItems.warnings.message | この追加の CI の処理中に発生した警告メッセージ。 データタイプ：文字列 |
| result.additionalCommittedRelations | 挿入または更新する要求本文 relations リストに含まれていない依存関係 CI のリスト。 データタイプ：オブジェクトのアレイ "additionalCommittedRelations": [ { "className": "String", "operation": "String", "markers": [Array], "inputIndices": [Array], "mergedPayloadIds": [Array] } ] |
| result.additionalCommittedRelations.className | この追加の依存関係 CI の sys_class_name。 サポートされている値のみ： * cmdb_rel_ci：CI 関係テーブル。 {#identifyreconcile-POST__ul_bsb_pxx_glb} データタイプ：文字列 |
| result.additionalCommittedRelations.errorCount | この追加の依存関係 CI の処理中に発生したエラーの数。 データタイプ：数値 |
| result.additionalCommittedRelations.errors | この追加の依存関係 CI の処理中に発生したエラーのリスト。 データタイプ：オブジェクトのアレイ "errors": [ { "error": "String", "message": "String" } ] |
| result.additionalCommittedRelations.errors.error | この追加の依存関係 CI の処理中に発生したエラーのタイプ。 データタイプ：文字列 |
| result.additionalCommittedRelations.errors.message | この追加の依存関係 CI の処理中にエラーが発生したエラーメッセージ。 データタイプ：文字列 |
| result.additionalCommittedRelations.inputIndices | この追加の依存関係 CI に対応する要求本文 relations アレイ内の依存関係 CI オブジェクトのインデックス値のリスト。 データタイプ：アレイ "inputIndices": [ Number ] |
| result.additionalCommittedRelations.markers | 内部使用のマーカー値のリスト。 データタイプ：アレイ "markers": [] |
| result.additionalCommittedRelations.mergedPayloadIds | この追加の依存関係 CI の処理中に結合された、CMDB IRE 部分のペイロード \[cmdb_ire_partial_payloads\] テーブルの部分的ペイロードのsys_id値のリスト。 データタイプ：アレイ "mergedPayloadIds": [ "String" ] |
| result.additionalCommittedRelations.operation | この追加の依存関係 CI に対して実行される操作。 可能な値： * 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 が更新されます。 {#identifyreconcile-POST__ul_ltk_vxx_glb} データタイプ：文字列 |
| 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：識別は試行されませんでした。この識別子ルールテーブルの検索に必要な属性が指定されなかったため、ルールは適用されませんでした。 {#identifyreconcile-POST__ul_gmw_qn5_flb} データタイプ：文字列 |
| 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」を参照してください。 {#identifyreconcile-POST__ul_lzk_rvb_glb} データタイプ：文字列 |
| result.items.info | アイテムの処理に関する追加情報のリスト。 データタイプ：オブジェクトのアレイ "info": [ { "code": "String", "message": "String", "ruleSysId": "String" } ] |
| result.items.info.code | スキップされた再分類タイプ。 可能な値： * SKIPPED_CLASS_SWITCH * SKIPPED_CLASS_DOWNGRADE * SKIPPED_CLASS_UPGRADE {#identifyreconcile-POST__ul_pb2_dxp_snb} |
| result.items.info.message | 再分類をスキップする理由に関する追加のインサイトを提供するメッセージ。 データタイプ：文字列 |
| result.items.info.ruleSysId | 一致した再分類制限ルールの sys_id。再分類制限ルールのために IRE が再分類をスキップする場合にのみ適用されます。ペイロードまたはグローバルフラグのために再分類がスキップされた場合、この値は空になります。 データタイプ：文字列 |
| result.items.inputIndices | この CI に対応する要求本文 items アレイからの CI のインデックス値のリスト。 データタイプ：オブジェクトのアレイ "inputIndices": [ { Number } ] |
| 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 が更新され、そのクラスがより特化されたクラス (子孫クラス) に変更されます。 {#identifyreconcile-POST__ul_jhl_gg5_flb} データタイプ：文字列 |
| result.items.relatedItems | 要求本文 items.lookup アレイからの関連 CI (テーブルルックアップ CI) のリスト。 データタイプ：オブジェクトのアレイ "relatedItems": [ { "className": "String", "inputIndices": [Array], "markers": [Array], "mergedPayloadIds": [Array], "sysId": "String" } ] |
| result.items.relatedItems.className | 関連アイテムの sys_class_name。 データタイプ：文字列 |
| result.items.relatedItems.inputIndices | この関連アイテムに対応する要求本文 items および items.lookup アレイからの CI およびルックアップアイテムのインデックス値のリスト。 データタイプ：オブジェクトのアレイ "inputIndices": [ { "mainIndex": Number, "subIndex": Number } ] |
| result.items.relatedItems.inputIndices.mainIndex | 関連アイテムの CI の親に対応する要求本文 items アレイからのインデックス値。 データタイプ：数値 |
| result.items.relatedItems.inputIndices.subIndex | 関連アイテムに対応する要求本文 items.lookup アレイからのインデックス値。 データタイプ：数値 |
| result.items.relatedItems.markers | 内部使用のマーカー値のリスト。 データタイプ：アレイ "markers": [] |
| result.items.relatedItems.mergedPayloadIds | 処理中にこの CI に結合された CMDB IRE 部分のペイロード \[cmdb_ire_partial_payloads\] テーブル内のエントリのsys_id値のリスト。 データタイプ：アレイ "mergedPayloadIds": [ "String" ] |
| result.items.relatedSysIds | 要求本文 items.lookup アレイの関連アイテム (テーブルルックアップアイテム) のsys_id値のリスト。 データタイプ：アレイ 注目すべき値： * null：この関連アイテムの識別された sys_id がありませんでした。 {#identifyreconcile-POST__ul_zs5_f1y_glb} "relatedSysIds": [ Number, Number ] |
| result.items.sysId | 識別によってこの CI に対して見つかったSys_id。 注目すべき値： * Unknown：この CI の識別に失敗しました。詳細については、「errors」を参照してください。 {#identifyreconcile-POST__ul_zz5_5vb_glb} データタイプ：文字列 |
| 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 関係テーブル。 {#identifyreconcile-POST__ul_ilx_d1v_flb} データタイプ：文字列 |
| 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 が更新されました。 {#identifyreconcile-POST__ul_qd5_kg5_flb} データタイプ：文字列 |
| 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 {#ariaid-title3}

指定されたペイロード (要求本文) に識別および調整ルールを適用して、CMDB の構成アイテム (CI) を挿入または更新します。CMDB を直接更新する代わりに、この API を使用します。
[識別および調整 - POST /now/identifyreconcile/queryEnhanced](https://servicenow-prod.fluidtopics.net/LqdqEqmIzhmfkClmZZVO7Q#identifyreconcile-POST-queryenhanced "データベース内の CMDB の操作をコミットせずに指定されたペイロード (要求の本文) で実行する操作 (挿入か更新か) を決定します。") エンドポイントを使用して、データベースへの変更をコミットせずに、このエンドポイントへのペイロードの送信をシミュレートします。  
このメソッドは [識別および調整 - POST /now/identifyreconcile](https://servicenow-prod.fluidtopics.net/LqdqEqmIzhmfkClmZZVO7Q#identifyreconcile-POST "指定されたペイロード (要求本文) に識別および調整ルールを適用して、CMDB の構成アイテム (CI) を挿入または更新します。CMDB を直接更新する代わりに、この API を使用します。") メソッドに似ていますが、次の機能も追加されます。

* 部分的ペイロード
  * アイテムに警告またはエラーがある場合は、アイテムの操作が INSERT_AS_PARTIAL か INSERT_INCOMPLETE かを示します。
  * 既存の部分的ペイロードと結合された部分的ペイロードの sys_id を返します。
  {#identifyreconcile-POST-enhanced__ul_x4s_nvk_xlb}
* ペイロードの重複排除機能をサポートします。
* サマリを生成します。
{#identifyreconcile-POST-enhanced__ul_scj_jvk_xlb}

### URL 形式

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

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

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

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

| 名前 | 説明 |
|-|-|
| api_version | オプションアクセスするエンドポイントのバージョン。たとえば、<kbd class="ph userinput">v1</kbd> や <kbd class="ph userinput">v2</kbd>。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 |
[表 : 7. パスパラメーター]

{#identifyreconcile-POST-enhanced__entry__6}

| 名前 | 説明 |
|-|-|
| 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)」](https://www.servicenow.com/docs/access?context=ire&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US)を参照してください。 名前と値の各ペアの有効な値： * true：この拡張 IRE オプションを有効にします。 * false：この拡張 IRE オプションを無効にします。 {#identifyreconcile-POST-enhanced__ul_wc3_mpn_rlb} データタイプ：文字列 |
| sysparm_data_source | CI 情報のソース。これは、構成アイテム \[cmdb_ci\] テーブルの discovery_source フィールドに定義された選択値の 1 つである必要があります。 データタイプ：文字列 デフォルト：API ペイロードを不完全なペイロードテーブルに挿入します。 |
[表 : 8. クエリパラメーター]

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

| 名前 | 説明 |
|-|-|
| アイテム | 作成または更新する CI のリスト。 データタイプ：オブジェクトのアレイ "items": [ { "className": "String", "internal_id": "String", "lookup": [Array], "related": [Array], "settings": {Object}, "sys_object_source_info": {Object}, "values": {Object} } ] |
| items.className | 必須です。作成または更新する CI の sys_class_name (クラス/テーブル名)。この値は、cmdb_ci_linux_server や cmdb_ci_win_server などの任意の CMDB テーブルにすることができます。 データタイプ：文字列 |
| items.internal_id | このペイロードのこのアイテムの一意の識別子。任意の値にすることができますが、ペイロード内で一意である必要があります。 データタイプ：文字列 |
| items.lookup | 各オブジェクトがルックアップベースの識別レコードを説明するオブジェクトのアレイ。これらのレコードは、構成アイテム \[cmdb_ci\] テーブルへの参照を含むルックアップテーブルに基づいて最上位レベルの構成アイテムを識別するために使用されます。 データタイプ:アレイオフオブジェクト "lookup": [ { "className": "String", "internal_id": "String", "sys_object_source_info": {Object}, "values": {Object} } ] |
| items.lookup.className | 必須です。作成または更新する CI の sys_class_name またはクラス/テーブル名。この値は、cmdb_serial_number や cmdb_ci_network_adapter などの任意の CMDB クラス/テーブルまたは非 CMDB 階層クラスにすることができます。 データタイプ：文字列 |
| items.lookup.internal_id | このペイロードのこのルックアップレコードの一意の識別子。任意の値にすることができますが、ペイロード内で一意である必要があります。 データタイプ：文字列 |
| items.lookup.sys_object_source_info | 指定されたデータソースの一意の CI 識別子を記述するオブジェクト。同じ CI でもソースが異なると、名前と値のペアが異なる場合があります。 データタイプ：オブジェクト "sys_object_source_info": { "source_feed": "String", "source_name": "String", "source_native_key": "String", "source_recency_timestamp": "String" } |
| items.lookup.sys_object_source_info.source_feed | この CI を送信するフィードを一意に識別する名前。ソースが複数のフィードを持つことができる場合に使用します。 データタイプ：文字列 |
| items.lookup.sys_object_source_info.source_name | CI 情報のデータソース。この値は、構成アイテム \[cmdb_ci\] テーブルの discovery_source フィールドに定義された選択値の 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 値を表します。 {#identifyreconcile-POST-enhanced__ul_s1s_phb_nlb} データタイプ：オブジェクトのアレイ "relations": [ { "child": Number, "parent": Number, "sys_rel_source_info": {Object}, "type": "String" } ] "relations": [ { "child_id": "String", "parent_id": "String", "sys_rel_source_info": {Object}, "type": "String" } ] |
| 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\] テーブルからの名前フィールド値である必要があります。 データタイプ：文字列 |
[表 : 9. 要求本文パラメーター (XML または JSON)]

{#identifyreconcile-POST-enhanced__table_idz_wyn_rlb}

### ヘッダー

次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。
{#identifyreconcile-POST-enhanced__entry__104}{#identifyreconcile-POST-enhanced__accept-JSON-only-entry-RESTAPI}{#identifyreconcile-POST-enhanced__content_type-JSON-only-entry-RESTAPI}

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

{#identifyreconcile-POST-enhanced__entry__110}

| ヘッダー | 説明 |
|-|-|
| なし |   |
[表 : 11. 応答ヘッダー]

### ステータスコード

この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。
{#identifyreconcile-POST-enhanced__entry__114}{#identifyreconcile-POST-enhanced__entry-200-status-code}{#identifyreconcile-POST-enhanced__entry-401-status-code}

| ステータスコード | 説明 |
|-|-|
| 200 | 成功。要求が正常に処理されました。 |
| 401 | 権限がありません。ユーザー資格情報が間違っているか、渡されていません。 |
| 500 | 内部サーバーエラー。要求の処理中に予期しないエラーが発生しました。 エラーメッセージの詳細「チャンク \[...\] は有効なエントリーではありません (Chunk \[...\] is not a valid entry)」は、options クエリパラメーターが正しい名前と値のペア形式でないことを示しています。 たとえば、`部分的`な options パラメーターを指定すると、メッセージの詳細に「チャンク \[部分的\] は有効なエントリではありません (Chunk \[partial\] is not a valid entry)」というメッセージと 500 ステータスコードが生成されます。 |
[表 : 12. ステータスコード]

### 応答本文のパラメーター (JSON または XML)

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

| 名前 | 説明 |
|-|-|
| 結果 | クエリによって生成された結果のリスト。 データタイプ：アレイ "result": [ "additionalCommittedItems": [Array], "additionalCommittedRelations": [Array], "items": [Array], "relations": [Array] ] |
| result.additionalCommittedItems | 要求本文に含まれていない CI のリスト 挿入または更新するアレイ items 。 データタイプ：オブジェクトのアレイ "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：識別は試行されませんでした。この識別子ルールテーブルの検索に必要な属性が指定されなかったため、ルールは適用されませんでした。 {#identifyreconcile-POST-enhanced__ul_axc_bxx_glb} データタイプ：文字列 |
| 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」を参照してください。 {#identifyreconcile-POST-enhanced__ul_hlk_gyx_glb} データタイプ：文字列 |
| result.additionalCommittedItems.inputIndices | この追加 CI に対応する要求本文 items アレイからの CI のインデックス値のリスト。 データタイプ：オブジェクトのアレイ "inputIndices": [ { Number } ] |
| result.additionalCommittedItems.markers | 内部使用のマーカー値のリスト。 データタイプ：アレイ "markers": [] |
| result.additionalCommittedItems.mergedPayloads | この追加 CI の処理中に結合された CMDB IRE 部分のペイロード \[cmdb_ire_partial_payloads\] テーブルの部分的ペイロードのsys_id値のリスト。 データタイプ：アレイ "mergedPayloadIds": [ "String" ] |
| result.additionalCommittedItems.operation | この追加の CI に対して実行された操作。 可能な値： * DELETE：既存の CI がターゲットテーブルから削除されます。 * INSERT：追加の CI が新しいレコードとしてターゲットテーブルに挿入されます。 * NO_CHANGE：追加の CI に対して実行された操作はありません。 * UPDATE：ターゲットテーブルの既存の CI が更新されます。 * UPDATE_WITH_DOWNGRADE：ターゲットテーブル内の既存の CI が更新され、そのクラスがより汎用的なクラス (先祖クラス) に変更されます。 * UPDATE_WITH_SWITCH：ターゲットテーブル内の既存の CI が更新され、そのクラスが先祖クラスまたは子孫クラスではない別のクラスに変更されます。 * UPDATE_WITH_UPGRADE：ターゲットテーブル内の既存の CI が更新され、そのクラスがより特化されたクラス (子孫クラス) に変更されます。 {#identifyreconcile-POST-enhanced__ul_dwt_qwx_glb} データタイプ：文字列 |
| result.additionalCommittedItems.sysId | 識別によって検出されたこの追加の CI の sys_id。 重要な値: 不明:この追加の CI の識別に失敗しました。詳細については、「errors」を参照してください。 データタイプ：文字列 |
| result.additionalCommittedItems.warnings | この追加 CI の処理中に発生した警告のリスト。 データタイプ：オブジェクトのアレイ "warnings": [ { "error": "String", "message": "String" } ] |
| result.additionalCommittedItems.warnings.error | この追加の CI の処理中に発生した警告のタイプ。 データタイプ：文字列 |
| result.additionalCommittedItems.warnings.message | この追加の CI の処理中に発生した警告メッセージ。 データタイプ：文字列 |
| result.additionalCommittedRelations | 挿入または更新する要求本文 relations リストに含まれていない依存関係 CI のリスト。 データタイプ：オブジェクトのアレイ "additionalCommittedRelations": [ { "className": "String", "operation": "String", "markers": [Array], "inputIndices": [Array], "mergedPayloadIds": [Array] } ] |
| result.additionalCommittedRelations.className | この追加の依存関係 CI の sys_class_name。 サポートされている値のみ： * cmdb_rel_ci：CI 関係テーブル。 {#identifyreconcile-POST-enhanced__ul_bsb_pxx_glb} データタイプ：文字列 |
| result.additionalCommittedRelations.errorCount | この追加の依存関係 CI の処理中に発生したエラーの数。 データタイプ：数値 |
| result.additionalCommittedRelations.errors | この追加の依存関係 CI の処理中に発生したエラーのリスト。 データタイプ：オブジェクトのアレイ "errors": [ { "error": "String", "message": "String" } ] |
| result.additionalCommittedRelations.errors.error | この追加の依存関係 CI の処理中に発生したエラーのタイプ。 データタイプ：文字列 |
| result.additionalCommittedRelations.errors.message | この追加の依存関係 CI の処理中にエラーが発生したエラーメッセージ。 データタイプ：文字列 |
| result.additionalCommittedRelations.inputIndices | この追加の依存関係 CI に対応する要求本文 relations アレイ内の依存関係 CI オブジェクトのインデックス値のリスト。 データタイプ：アレイ "inputIndices": [ Number ] |
| result.additionalCommittedRelations.markers | 内部使用のマーカー値のリスト。 データタイプ：アレイ "markers": [] |
| result.additionalCommittedRelations.mergedPayloadIds | この追加の依存関係 CI の処理中に結合された、CMDB IRE 部分のペイロード \[cmdb_ire_partial_payloads\] テーブルの部分的ペイロードのsys_id値のリスト。 データタイプ：アレイ "mergedPayloadIds": [ "String" ] |
| result.additionalCommittedRelations.operation | この追加の依存関係 CI に対して実行される操作。 可能な値： * 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 が更新されます。 {#identifyreconcile-POST-enhanced__ul_ltk_vxx_glb} データタイプ：文字列 |
| 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：識別は試行されませんでした。この識別子ルールテーブルの検索に必要な属性が指定されなかったため、ルールは適用されませんでした。 {#identifyreconcile-POST-enhanced__ul_gmw_qn5_flb} データタイプ：文字列 |
| 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」を参照してください。 {#identifyreconcile-POST-enhanced__ul_lzk_rvb_glb} データタイプ：文字列 |
| result.items.info | アイテムの処理に関する追加情報のリスト。 データタイプ：オブジェクトのアレイ "info": [ { "code": "String", "message": "String", "ruleSysId": "String" } ] |
| result.items.info.code | スキップされた再分類タイプ。 可能な値： * SKIPPED_CLASS_SWITCH * SKIPPED_CLASS_DOWNGRADE * SKIPPED_CLASS_UPGRADE {#identifyreconcile-POST-enhanced__ul_pb2_dxp_snb} |
| result.items.info.message | 再分類をスキップする理由に関する追加のインサイトを提供するメッセージ。 データタイプ：文字列 |
| result.items.info.ruleSysId | 一致した再分類制限ルールの sys_id。再分類制限ルールのために IRE が再分類をスキップする場合にのみ適用されます。ペイロードまたはグローバルフラグのために再分類がスキップされた場合、この値は空になります。 データタイプ：文字列 |
| result.items.inputIndices | この CI に対応する要求本文 items アレイからの CI のインデックス値のリスト。 データタイプ：オブジェクトのアレイ "inputIndices": [ { Number } ] |
| 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 が更新され、そのクラスがより特化されたクラス (子孫クラス) に変更されます。 {#identifyreconcile-POST-enhanced__ul_jhl_gg5_flb} データタイプ：文字列 |
| result.items.relatedItems | 要求本文 items.lookup アレイからの関連 CI (テーブルルックアップ CI) のリスト。 データタイプ：オブジェクトのアレイ "relatedItems": [ { "className": "String", "inputIndices": [Array], "markers": [Array], "mergedPayloadIds": [Array], "sysId": "String" } ] |
| result.items.relatedItems.className | 関連アイテムの sys_class_name。 データタイプ：文字列 |
| result.items.relatedItems.inputIndices | この関連アイテムに対応する要求本文 items および items.lookup アレイからの CI およびルックアップアイテムのインデックス値のリスト。 データタイプ：オブジェクトのアレイ "inputIndices": [ { "mainIndex": Number, "subIndex": Number } ] |
| result.items.relatedItems.inputIndices.mainIndex | 関連アイテムの CI の親に対応する要求本文 items アレイからのインデックス値。 データタイプ：数値 |
| result.items.relatedItems.inputIndices.subIndex | 関連アイテムに対応する要求本文 items.lookup アレイからのインデックス値。 データタイプ：数値 |
| result.items.relatedItems.markers | 内部使用のマーカー値のリスト。 データタイプ：アレイ "markers": [] |
| result.items.relatedItems.mergedPayloadIds | 処理中にこの CI に結合された CMDB IRE 部分のペイロード \[cmdb_ire_partial_payloads\] テーブル内のエントリのsys_id値のリスト。 データタイプ：アレイ "mergedPayloadIds": [ "String" ] |
| result.items.relatedSysIds | 要求本文 items.lookup アレイの関連アイテム (テーブルルックアップアイテム) のsys_id値のリスト。 データタイプ：アレイ 注目すべき値： * null：この関連アイテムの識別された sys_id がありませんでした。 {#identifyreconcile-POST-enhanced__ul_zs5_f1y_glb} "relatedSysIds": [ Number, Number ] |
| result.items.sysId | 識別によってこの CI に対して見つかったSys_id。 注目すべき値： * Unknown：この CI の識別に失敗しました。詳細については、「errors」を参照してください。 {#identifyreconcile-POST-enhanced__ul_zz5_5vb_glb} データタイプ：文字列 |
| 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 関係テーブル。 {#identifyreconcile-POST-enhanced__ul_ilx_d1v_flb} データタイプ：文字列 |
| 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 が更新されました。 {#identifyreconcile-POST-enhanced__ul_qd5_kg5_flb} データタイプ：文字列 |
| result.relations.warnings | この依存関係 CI の処理中に発生した警告のリスト。 データタイプ：オブジェクトのアレイ "warnings": [ { "error": "String", "message": "String" } ] |
| result.relations.warnings.error | この依存関係 CI の処理中に発生した警告のタイプ。 データタイプ：文字列 |
| result.relations.warnings.message | この依存関係 CI の処理中に警告メッセージが表示されました。 データタイプ：文字列 |
[ ]

{#identifyreconcile-POST-enhanced__table_mr2_yyn_rlb}  

### cURL 要求

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

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

応答は、ペイロードが CMDB IRE 部分のペイロード \[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 {#ariaid-title4}

データベース内の CMDB の操作をコミットせずに指定されたペイロード (要求の本文) で実行する操作 (挿入か更新か) を決定します。
このエンドポイントを使用して、[識別および調整 - POST /now/identifyreconcile](https://servicenow-prod.fluidtopics.net/LqdqEqmIzhmfkClmZZVO7Q#identifyreconcile-POST "指定されたペイロード (要求本文) に識別および調整ルールを適用して、CMDB の構成アイテム (CI) を挿入または更新します。CMDB を直接更新する代わりに、この API を使用します。") エンドポイントへのペイロード (要求本文) の送信をシミュレートします。

拡張 IRE オプションを指定する必要がある場合は、代わりに [識別および調整 - POST /now/identifyreconcile/enhanced](https://servicenow-prod.fluidtopics.net/LqdqEqmIzhmfkClmZZVO7Q#identifyreconcile-POST-enhanced "指定されたペイロード (要求本文) に識別および調整ルールを適用して、CMDB の構成アイテム (CI) を挿入または更新します。CMDB を直接更新する代わりに、この API を使用します。") エンドポイントを使用します。拡張 IRE オプションの詳細については、「 [識別および調整エンジン (IRE)」](https://www.servicenow.com/docs/access?context=ire&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US)を参照してください。

### URL 形式

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

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

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

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

| 名前 | 説明 |
|-|-|
| api_version | オプションアクセスするエンドポイントのバージョン。たとえば、<kbd class="ph userinput">v1</kbd> や <kbd class="ph userinput">v2</kbd>。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 |
[表 : 13. パスパラメーター]

{#identifyreconcile-POST-query__entry__6}

| 名前 | 説明 |
|-|-|
| sysparm_data_source | CI 情報のソース。これは、構成アイテム \[cmdb_ci\] テーブルの discovery_source フィールドに定義された選択値の 1 つである必要があります。 データタイプ：文字列 デフォルト：API ペイロードを不完全なペイロードテーブルに挿入します。 |
[表 : 14. クエリパラメーター]

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

| 名前 | 説明 |
|-|-|
| アイテム | 作成または更新する CI のリスト。 データタイプ：オブジェクトのアレイ "items": [ { "className": "String", "internal_id": "String", "lookup": [Array], "related": [Array], "settings": {Object}, "sys_object_source_info": {Object}, "values": {Object} } ] |
| items.className | 必須です。作成または更新する CI の sys_class_name (クラス/テーブル名)。この値は、cmdb_ci_linux_server や cmdb_ci_win_server などの任意の CMDB テーブルにすることができます。 データタイプ：文字列 |
| items.internal_id | このペイロードのこのアイテムの一意の識別子。任意の値にすることができますが、ペイロード内で一意である必要があります。 データタイプ：文字列 |
| items.lookup | 各オブジェクトがルックアップベースの識別レコードを説明するオブジェクトのアレイ。これらのレコードは、構成アイテム \[cmdb_ci\] テーブルへの参照を含むルックアップテーブルに基づいて最上位レベルの構成アイテムを識別するために使用されます。 データタイプ:アレイオフオブジェクト "lookup": [ { "className": "String", "internal_id": "String", "sys_object_source_info": {Object}, "values": {Object} } ] |
| items.lookup.className | 必須です。作成または更新する CI の sys_class_name またはクラス/テーブル名。この値は、cmdb_serial_number や cmdb_ci_network_adapter などの任意の CMDB クラス/テーブルまたは非 CMDB 階層クラスにすることができます。 データタイプ：文字列 |
| items.lookup.internal_id | このペイロードのこのルックアップレコードの一意の識別子。任意の値にすることができますが、ペイロード内で一意である必要があります。 データタイプ：文字列 |
| items.lookup.sys_object_source_info | 指定されたデータソースの一意の CI 識別子を記述するオブジェクト。同じ CI でもソースが異なると、名前と値のペアが異なる場合があります。 データタイプ：オブジェクト "sys_object_source_info": { "source_feed": "String", "source_name": "String", "source_native_key": "String", "source_recency_timestamp": "String" } |
| items.lookup.sys_object_source_info.source_feed | この CI を送信するフィードを一意に識別する名前。ソースが複数のフィードを持つことができる場合に使用します。 データタイプ：文字列 |
| items.lookup.sys_object_source_info.source_name | CI 情報のデータソース。この値は、構成アイテム \[cmdb_ci\] テーブルの discovery_source フィールドに定義された選択値の 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 値を表します。 {#identifyreconcile-POST-query__ul_s1s_phb_nlb} データタイプ：オブジェクトのアレイ "relations": [ { "child": Number, "parent": Number, "sys_rel_source_info": {Object}, "type": "String" } ] "relations": [ { "child_id": "String", "parent_id": "String", "sys_rel_source_info": {Object}, "type": "String" } ] |
| 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\] テーブルからの名前フィールド値である必要があります。 データタイプ：文字列 |
[表 : 15. 要求本文パラメーター (XML または JSON)]

### ヘッダー

次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。
{#identifyreconcile-POST-query__entry__102}{#identifyreconcile-POST-query__accept-JSON-only-entry-RESTAPI}{#identifyreconcile-POST-query__content_type-JSON-only-entry-RESTAPI}

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

{#identifyreconcile-POST-query__entry__108}

| ヘッダー | 説明 |
|-|-|
| なし |   |
[表 : 17. 応答ヘッダー]

### ステータスコード

この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。
{#identifyreconcile-POST-query__entry__112}{#identifyreconcile-POST-query__entry-200-status-code}{#identifyreconcile-POST-query__entry-401-status-code}{#identifyreconcile-POST-query__entry-500-status-code}

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

### 応答本文のパラメーター (JSON または XML)

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

| 名前 | 説明 |
|-|-|
| 結果 | クエリによって生成された結果のリスト。 データタイプ：アレイ "result": [ "additionalCommittedItems": [Array], "additionalCommittedRelations": [Array], "items": [Array], "relations": [Array] ] |
| result.additionalCommittedItems | 要求本文に含まれていない CI のリスト 挿入または更新するアレイ items 。 データタイプ：オブジェクトのアレイ "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：識別は試行されませんでした。この識別子ルールテーブルの検索に必要な属性が指定されなかったため、ルールは適用されませんでした。 {#identifyreconcile-POST-query__ul_axc_bxx_glb} データタイプ：文字列 |
| 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」を参照してください。 {#identifyreconcile-POST-query__ul_hlk_gyx_glb} データタイプ：文字列 |
| result.additionalCommittedItems.inputIndices | この追加 CI に対応する要求本文 items アレイからの CI のインデックス値のリスト。 データタイプ：オブジェクトのアレイ "inputIndices": [ { Number } ] |
| result.additionalCommittedItems.markers | 内部使用のマーカー値のリスト。 データタイプ：アレイ "markers": [] |
| result.additionalCommittedItems.mergedPayloads | この追加 CI の処理中に結合された CMDB IRE 部分のペイロード \[cmdb_ire_partial_payloads\] テーブルの部分的ペイロードのsys_id値のリスト。 データタイプ：アレイ "mergedPayloadIds": [ "String" ] |
| result.additionalCommittedItems.operation | この追加の CI に対して実行された操作。 可能な値： * DELETE：既存の CI がターゲットテーブルから削除されます。 * INSERT：追加の CI が新しいレコードとしてターゲットテーブルに挿入されます。 * NO_CHANGE：追加の CI に対して実行された操作はありません。 * UPDATE：ターゲットテーブルの既存の CI が更新されます。 * UPDATE_WITH_DOWNGRADE：ターゲットテーブル内の既存の CI が更新され、そのクラスがより汎用的なクラス (先祖クラス) に変更されます。 * UPDATE_WITH_SWITCH：ターゲットテーブル内の既存の CI が更新され、そのクラスが先祖クラスまたは子孫クラスではない別のクラスに変更されます。 * UPDATE_WITH_UPGRADE：ターゲットテーブル内の既存の CI が更新され、そのクラスがより特化されたクラス (子孫クラス) に変更されます。 {#identifyreconcile-POST-query__ul_dwt_qwx_glb} データタイプ：文字列 |
| result.additionalCommittedItems.sysId | 識別によって検出されたこの追加の CI の sys_id。 重要な値: 不明:この追加の CI の識別に失敗しました。詳細については、「errors」を参照してください。 データタイプ：文字列 |
| result.additionalCommittedItems.warnings | この追加 CI の処理中に発生した警告のリスト。 データタイプ：オブジェクトのアレイ "warnings": [ { "error": "String", "message": "String" } ] |
| result.additionalCommittedItems.warnings.error | この追加の CI の処理中に発生した警告のタイプ。 データタイプ：文字列 |
| result.additionalCommittedItems.warnings.message | この追加の CI の処理中に発生した警告メッセージ。 データタイプ：文字列 |
| result.additionalCommittedRelations | 挿入または更新する要求本文 relations リストに含まれていない依存関係 CI のリスト。 データタイプ：オブジェクトのアレイ "additionalCommittedRelations": [ { "className": "String", "operation": "String", "markers": [Array], "inputIndices": [Array], "mergedPayloadIds": [Array] } ] |
| result.additionalCommittedRelations.className | この追加の依存関係 CI の sys_class_name。 サポートされている値のみ： * cmdb_rel_ci：CI 関係テーブル。 {#identifyreconcile-POST-query__ul_bsb_pxx_glb} データタイプ：文字列 |
| result.additionalCommittedRelations.errorCount | この追加の依存関係 CI の処理中に発生したエラーの数。 データタイプ：数値 |
| result.additionalCommittedRelations.errors | この追加の依存関係 CI の処理中に発生したエラーのリスト。 データタイプ：オブジェクトのアレイ "errors": [ { "error": "String", "message": "String" } ] |
| result.additionalCommittedRelations.errors.error | この追加の依存関係 CI の処理中に発生したエラーのタイプ。 データタイプ：文字列 |
| result.additionalCommittedRelations.errors.message | この追加の依存関係 CI の処理中にエラーが発生したエラーメッセージ。 データタイプ：文字列 |
| result.additionalCommittedRelations.inputIndices | この追加の依存関係 CI に対応する要求本文 relations アレイ内の依存関係 CI オブジェクトのインデックス値のリスト。 データタイプ：アレイ "inputIndices": [ Number ] |
| result.additionalCommittedRelations.markers | 内部使用のマーカー値のリスト。 データタイプ：アレイ "markers": [] |
| result.additionalCommittedRelations.mergedPayloadIds | この追加の依存関係 CI の処理中に結合された、CMDB IRE 部分のペイロード \[cmdb_ire_partial_payloads\] テーブルの部分的ペイロードのsys_id値のリスト。 データタイプ：アレイ "mergedPayloadIds": [ "String" ] |
| result.additionalCommittedRelations.operation | この追加の依存関係 CI に対して実行される操作。 可能な値： * 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 が更新されます。 {#identifyreconcile-POST-query__ul_ltk_vxx_glb} データタイプ：文字列 |
| 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：識別は試行されませんでした。この識別子ルールテーブルの検索に必要な属性が指定されなかったため、ルールは適用されませんでした。 {#identifyreconcile-POST-query__ul_gmw_qn5_flb} データタイプ：文字列 |
| 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」を参照してください。 {#identifyreconcile-POST-query__ul_lzk_rvb_glb} データタイプ：文字列 |
| result.items.info | アイテムの処理に関する追加情報のリスト。 データタイプ：オブジェクトのアレイ "info": [ { "code": "String", "message": "String", "ruleSysId": "String" } ] |
| result.items.info.code | スキップされた再分類タイプ。 可能な値： * SKIPPED_CLASS_SWITCH * SKIPPED_CLASS_DOWNGRADE * SKIPPED_CLASS_UPGRADE {#identifyreconcile-POST-query__ul_pb2_dxp_snb} |
| result.items.info.message | 再分類をスキップする理由に関する追加のインサイトを提供するメッセージ。 データタイプ：文字列 |
| result.items.info.ruleSysId | 一致した再分類制限ルールの sys_id。再分類制限ルールのために IRE が再分類をスキップする場合にのみ適用されます。ペイロードまたはグローバルフラグのために再分類がスキップされた場合、この値は空になります。 データタイプ：文字列 |
| result.items.inputIndices | この CI に対応する要求本文 items アレイからの CI のインデックス値のリスト。 データタイプ：オブジェクトのアレイ "inputIndices": [ { Number } ] |
| 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 が更新され、そのクラスがより特化されたクラス (子孫クラス) に変更されます。 {#identifyreconcile-POST-query__ul_jhl_gg5_flb} データタイプ：文字列 |
| result.items.relatedItems | 要求本文 items.lookup アレイからの関連 CI (テーブルルックアップ CI) のリスト。 データタイプ：オブジェクトのアレイ "relatedItems": [ { "className": "String", "inputIndices": [Array], "markers": [Array], "mergedPayloadIds": [Array], "sysId": "String" } ] |
| result.items.relatedItems.className | 関連アイテムの sys_class_name。 データタイプ：文字列 |
| result.items.relatedItems.inputIndices | この関連アイテムに対応する要求本文 items および items.lookup アレイからの CI およびルックアップアイテムのインデックス値のリスト。 データタイプ：オブジェクトのアレイ "inputIndices": [ { "mainIndex": Number, "subIndex": Number } ] |
| result.items.relatedItems.inputIndices.mainIndex | 関連アイテムの CI の親に対応する要求本文 items アレイからのインデックス値。 データタイプ：数値 |
| result.items.relatedItems.inputIndices.subIndex | 関連アイテムに対応する要求本文 items.lookup アレイからのインデックス値。 データタイプ：数値 |
| result.items.relatedItems.markers | 内部使用のマーカー値のリスト。 データタイプ：アレイ "markers": [] |
| result.items.relatedItems.mergedPayloadIds | 処理中にこの CI に結合された CMDB IRE 部分のペイロード \[cmdb_ire_partial_payloads\] テーブル内のエントリのsys_id値のリスト。 データタイプ：アレイ "mergedPayloadIds": [ "String" ] |
| result.items.relatedSysIds | 要求本文 items.lookup アレイの関連アイテム (テーブルルックアップアイテム) のsys_id値のリスト。 データタイプ：アレイ 注目すべき値： * null：この関連アイテムの識別された sys_id がありませんでした。 {#identifyreconcile-POST-query__ul_zs5_f1y_glb} "relatedSysIds": [ Number, Number ] |
| result.items.sysId | 識別によってこの CI に対して見つかったSys_id。 注目すべき値： * Unknown：この CI の識別に失敗しました。詳細については、「errors」を参照してください。 {#identifyreconcile-POST-query__ul_zz5_5vb_glb} データタイプ：文字列 |
| 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 関係テーブル。 {#identifyreconcile-POST-query__ul_ilx_d1v_flb} データタイプ：文字列 |
| 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 が更新されました。 {#identifyreconcile-POST-query__ul_qd5_kg5_flb} データタイプ：文字列 |
| 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 {#ariaid-title5}

データベース内の CMDB の操作をコミットせずに指定されたペイロード (要求の本文) で実行する操作 (挿入か更新か) を決定します。
このエンドポイントを使用して、[識別および調整 - POST /now/identifyreconcile/enhanced](https://servicenow-prod.fluidtopics.net/LqdqEqmIzhmfkClmZZVO7Q#identifyreconcile-POST-enhanced "指定されたペイロード (要求本文) に識別および調整ルールを適用して、CMDB の構成アイテム (CI) を挿入または更新します。CMDB を直接更新する代わりに、この API を使用します。") エンドポイントへのペイロード (要求本文) の送信をシミュレートします。  
このメソッドは [識別および調整 - POST /now/identifyreconcile/query](https://servicenow-prod.fluidtopics.net/LqdqEqmIzhmfkClmZZVO7Q#identifyreconcile-POST-query "データベース内の CMDB の操作をコミットせずに指定されたペイロード (要求の本文) で実行する操作 (挿入か更新か) を決定します。") メソッドに似ていますが、次の機能も追加されます。

* 部分的ペイロード
  * アイテムに警告またはエラーがある場合は、アイテムの操作が INSERT_AS_PARTIAL か INSERT_INCOMPLETE かを示します。
  * 既存の部分的ペイロードと結合された部分的ペイロードの sys_id を返します。
  {#identifyreconcile-POST-queryenhanced__ul_x4s_nvk_xlb}
* ペイロードの重複排除機能をサポートします。
* サマリを生成します。
{#identifyreconcile-POST-queryenhanced__ul_scj_jvk_xlb}

### URL 形式

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

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

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

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

| 名前 | 説明 |
|-|-|
| api_version | オプションアクセスするエンドポイントのバージョン。たとえば、<kbd class="ph userinput">v1</kbd> や <kbd class="ph userinput">v2</kbd>。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 |
[表 : 19. パスパラメーター]

{#identifyreconcile-POST-queryenhanced__entry__6}

| 名前 | 説明 |
|-|-|
| 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)」](https://www.servicenow.com/docs/access?context=ire&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US)を参照してください。 名前と値の各ペアの有効な値： * true：この拡張 IRE オプションを有効にします。 * false：この拡張 IRE オプションを無効にします。 {#identifyreconcile-POST-queryenhanced__ul_wc3_mpn_rlb} データタイプ：文字列 |
| sysparm_data_source | CI 情報のソース。これは、構成アイテム \[cmdb_ci\] テーブルの discovery_source フィールドに定義された選択値の 1 つである必要があります。 データタイプ：文字列 デフォルト：API ペイロードを不完全なペイロードテーブルに挿入します。 |
[表 : 20. クエリパラメーター]

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

| 名前 | 説明 |
|-|-|
| アイテム | 作成または更新する CI のリスト。 データタイプ：オブジェクトのアレイ "items": [ { "className": "String", "internal_id": "String", "lookup": [Array], "related": [Array], "settings": {Object}, "sys_object_source_info": {Object}, "values": {Object} } ] |
| items.className | 必須です。作成または更新する CI の sys_class_name (クラス/テーブル名)。この値は、cmdb_ci_linux_server や cmdb_ci_win_server などの任意の CMDB テーブルにすることができます。 データタイプ：文字列 |
| items.internal_id | このペイロードのこのアイテムの一意の識別子。任意の値にすることができますが、ペイロード内で一意である必要があります。 データタイプ：文字列 |
| items.lookup | 各オブジェクトがルックアップベースの識別レコードを説明するオブジェクトのアレイ。これらのレコードは、構成アイテム \[cmdb_ci\] テーブルへの参照を含むルックアップテーブルに基づいて最上位レベルの構成アイテムを識別するために使用されます。 データタイプ:アレイオフオブジェクト "lookup": [ { "className": "String", "internal_id": "String", "sys_object_source_info": {Object}, "values": {Object} } ] |
| items.lookup.className | 必須です。作成または更新する CI の sys_class_name またはクラス/テーブル名。この値は、cmdb_serial_number や cmdb_ci_network_adapter などの任意の CMDB クラス/テーブルまたは非 CMDB 階層クラスにすることができます。 データタイプ：文字列 |
| items.lookup.internal_id | このペイロードのこのルックアップレコードの一意の識別子。任意の値にすることができますが、ペイロード内で一意である必要があります。 データタイプ：文字列 |
| items.lookup.sys_object_source_info | 指定されたデータソースの一意の CI 識別子を記述するオブジェクト。同じ CI でもソースが異なると、名前と値のペアが異なる場合があります。 データタイプ：オブジェクト "sys_object_source_info": { "source_feed": "String", "source_name": "String", "source_native_key": "String", "source_recency_timestamp": "String" } |
| items.lookup.sys_object_source_info.source_feed | この CI を送信するフィードを一意に識別する名前。ソースが複数のフィードを持つことができる場合に使用します。 データタイプ：文字列 |
| items.lookup.sys_object_source_info.source_name | CI 情報のデータソース。この値は、構成アイテム \[cmdb_ci\] テーブルの discovery_source フィールドに定義された選択値の 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 値を表します。 {#identifyreconcile-POST-queryenhanced__ul_s1s_phb_nlb} データタイプ：オブジェクトのアレイ "relations": [ { "child": Number, "parent": Number, "sys_rel_source_info": {Object}, "type": "String" } ] "relations": [ { "child_id": "String", "parent_id": "String", "sys_rel_source_info": {Object}, "type": "String" } ] |
| 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\] テーブルからの名前フィールド値である必要があります。 データタイプ：文字列 |
[表 : 21. 要求本文パラメーター (XML または JSON)]

{#identifyreconcile-POST-queryenhanced__table_c2c_bzn_rlb}

### ヘッダー

次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。
{#identifyreconcile-POST-queryenhanced__entry__104}{#identifyreconcile-POST-queryenhanced__accept-JSON-only-entry-RESTAPI}{#identifyreconcile-POST-queryenhanced__content_type-JSON-only-entry-RESTAPI}

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

{#identifyreconcile-POST-queryenhanced__entry__110}

| ヘッダー | 説明 |
|-|-|
| なし |   |
[表 : 23. 応答ヘッダー]

### ステータスコード

この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。
{#identifyreconcile-POST-queryenhanced__entry__114}{#identifyreconcile-POST-queryenhanced__entry-200-status-code}{#identifyreconcile-POST-queryenhanced__entry-401-status-code}

| ステータスコード | 説明 |
|-|-|
| 200 | 成功。要求が正常に処理されました。 |
| 401 | 権限がありません。ユーザー資格情報が間違っているか、渡されていません。 |
| 500 | 内部サーバーエラー。要求の処理中に予期しないエラーが発生しました。 エラーメッセージの詳細「チャンク \[...\] は有効なエントリーではありません (Chunk \[...\] is not a valid entry)」は、options クエリパラメーターが正しい名前と値のペア形式でないことを示しています。 たとえば、`部分的`な options パラメーターを指定すると、メッセージの詳細に「チャンク \[部分的\] は有効なエントリではありません (Chunk \[partial\] is not a valid entry)」というメッセージと 500 ステータスコードが生成されます。 |
[表 : 24. ステータスコード]

### 応答本文のパラメーター (JSON または XML)

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

| 名前 | 説明 |
|-|-|
| 結果 | クエリによって生成された結果のリスト。 データタイプ：アレイ "result": [ "additionalCommittedItems": [Array], "additionalCommittedRelations": [Array], "items": [Array], "relations": [Array] ] |
| result.additionalCommittedItems | 要求本文に含まれていない CI のリスト 挿入または更新するアレイ items 。 データタイプ：オブジェクトのアレイ "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：識別は試行されませんでした。この識別子ルールテーブルの検索に必要な属性が指定されなかったため、ルールは適用されませんでした。 {#identifyreconcile-POST-queryenhanced__ul_axc_bxx_glb} データタイプ：文字列 |
| 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」を参照してください。 {#identifyreconcile-POST-queryenhanced__ul_hlk_gyx_glb} データタイプ：文字列 |
| result.additionalCommittedItems.inputIndices | この追加 CI に対応する要求本文 items アレイからの CI のインデックス値のリスト。 データタイプ：オブジェクトのアレイ "inputIndices": [ { Number } ] |
| result.additionalCommittedItems.markers | 内部使用のマーカー値のリスト。 データタイプ：アレイ "markers": [] |
| result.additionalCommittedItems.mergedPayloads | この追加 CI の処理中に結合された CMDB IRE 部分のペイロード \[cmdb_ire_partial_payloads\] テーブルの部分的ペイロードのsys_id値のリスト。 データタイプ：アレイ "mergedPayloadIds": [ "String" ] |
| result.additionalCommittedItems.operation | この追加の CI に対して実行された操作。 可能な値： * DELETE：既存の CI がターゲットテーブルから削除されます。 * INSERT：追加の CI が新しいレコードとしてターゲットテーブルに挿入されます。 * NO_CHANGE：追加の CI に対して実行された操作はありません。 * UPDATE：ターゲットテーブルの既存の CI が更新されます。 * UPDATE_WITH_DOWNGRADE：ターゲットテーブル内の既存の CI が更新され、そのクラスがより汎用的なクラス (先祖クラス) に変更されます。 * UPDATE_WITH_SWITCH：ターゲットテーブル内の既存の CI が更新され、そのクラスが先祖クラスまたは子孫クラスではない別のクラスに変更されます。 * UPDATE_WITH_UPGRADE：ターゲットテーブル内の既存の CI が更新され、そのクラスがより特化されたクラス (子孫クラス) に変更されます。 {#identifyreconcile-POST-queryenhanced__ul_dwt_qwx_glb} データタイプ：文字列 |
| result.additionalCommittedItems.sysId | 識別によって検出されたこの追加の CI の sys_id。 重要な値: 不明:この追加の CI の識別に失敗しました。詳細については、「errors」を参照してください。 データタイプ：文字列 |
| result.additionalCommittedItems.warnings | この追加 CI の処理中に発生した警告のリスト。 データタイプ：オブジェクトのアレイ "warnings": [ { "error": "String", "message": "String" } ] |
| result.additionalCommittedItems.warnings.error | この追加の CI の処理中に発生した警告のタイプ。 データタイプ：文字列 |
| result.additionalCommittedItems.warnings.message | この追加の CI の処理中に発生した警告メッセージ。 データタイプ：文字列 |
| result.additionalCommittedRelations | 挿入または更新する要求本文 relations リストに含まれていない依存関係 CI のリスト。 データタイプ：オブジェクトのアレイ "additionalCommittedRelations": [ { "className": "String", "operation": "String", "markers": [Array], "inputIndices": [Array], "mergedPayloadIds": [Array] } ] |
| result.additionalCommittedRelations.className | この追加の依存関係 CI の sys_class_name。 サポートされている値のみ： * cmdb_rel_ci：CI 関係テーブル。 {#identifyreconcile-POST-queryenhanced__ul_bsb_pxx_glb} データタイプ：文字列 |
| result.additionalCommittedRelations.errorCount | この追加の依存関係 CI の処理中に発生したエラーの数。 データタイプ：数値 |
| result.additionalCommittedRelations.errors | この追加の依存関係 CI の処理中に発生したエラーのリスト。 データタイプ：オブジェクトのアレイ "errors": [ { "error": "String", "message": "String" } ] |
| result.additionalCommittedRelations.errors.error | この追加の依存関係 CI の処理中に発生したエラーのタイプ。 データタイプ：文字列 |
| result.additionalCommittedRelations.errors.message | この追加の依存関係 CI の処理中にエラーが発生したエラーメッセージ。 データタイプ：文字列 |
| result.additionalCommittedRelations.inputIndices | この追加の依存関係 CI に対応する要求本文 relations アレイ内の依存関係 CI オブジェクトのインデックス値のリスト。 データタイプ：アレイ "inputIndices": [ Number ] |
| result.additionalCommittedRelations.markers | 内部使用のマーカー値のリスト。 データタイプ：アレイ "markers": [] |
| result.additionalCommittedRelations.mergedPayloadIds | この追加の依存関係 CI の処理中に結合された、CMDB IRE 部分のペイロード \[cmdb_ire_partial_payloads\] テーブルの部分的ペイロードのsys_id値のリスト。 データタイプ：アレイ "mergedPayloadIds": [ "String" ] |
| result.additionalCommittedRelations.operation | この追加の依存関係 CI に対して実行される操作。 可能な値： * 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 が更新されます。 {#identifyreconcile-POST-queryenhanced__ul_ltk_vxx_glb} データタイプ：文字列 |
| 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：識別は試行されませんでした。この識別子ルールテーブルの検索に必要な属性が指定されなかったため、ルールは適用されませんでした。 {#identifyreconcile-POST-queryenhanced__ul_gmw_qn5_flb} データタイプ：文字列 |
| 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」を参照してください。 {#identifyreconcile-POST-queryenhanced__ul_lzk_rvb_glb} データタイプ：文字列 |
| result.items.info | アイテムの処理に関する追加情報のリスト。 データタイプ：オブジェクトのアレイ "info": [ { "code": "String", "message": "String", "ruleSysId": "String" } ] |
| result.items.info.code | スキップされた再分類タイプ。 可能な値： * SKIPPED_CLASS_SWITCH * SKIPPED_CLASS_DOWNGRADE * SKIPPED_CLASS_UPGRADE {#identifyreconcile-POST-queryenhanced__ul_pb2_dxp_snb} |
| result.items.info.message | 再分類をスキップする理由に関する追加のインサイトを提供するメッセージ。 データタイプ：文字列 |
| result.items.info.ruleSysId | 一致した再分類制限ルールの sys_id。再分類制限ルールのために IRE が再分類をスキップする場合にのみ適用されます。ペイロードまたはグローバルフラグのために再分類がスキップされた場合、この値は空になります。 データタイプ：文字列 |
| result.items.inputIndices | この CI に対応する要求本文 items アレイからの CI のインデックス値のリスト。 データタイプ：オブジェクトのアレイ "inputIndices": [ { Number } ] |
| 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 が更新され、そのクラスがより特化されたクラス (子孫クラス) に変更されます。 {#identifyreconcile-POST-queryenhanced__ul_jhl_gg5_flb} データタイプ：文字列 |
| result.items.relatedItems | 要求本文 items.lookup アレイからの関連 CI (テーブルルックアップ CI) のリスト。 データタイプ：オブジェクトのアレイ "relatedItems": [ { "className": "String", "inputIndices": [Array], "markers": [Array], "mergedPayloadIds": [Array], "sysId": "String" } ] |
| result.items.relatedItems.className | 関連アイテムの sys_class_name。 データタイプ：文字列 |
| result.items.relatedItems.inputIndices | この関連アイテムに対応する要求本文 items および items.lookup アレイからの CI およびルックアップアイテムのインデックス値のリスト。 データタイプ：オブジェクトのアレイ "inputIndices": [ { "mainIndex": Number, "subIndex": Number } ] |
| result.items.relatedItems.inputIndices.mainIndex | 関連アイテムの CI の親に対応する要求本文 items アレイからのインデックス値。 データタイプ：数値 |
| result.items.relatedItems.inputIndices.subIndex | 関連アイテムに対応する要求本文 items.lookup アレイからのインデックス値。 データタイプ：数値 |
| result.items.relatedItems.markers | 内部使用のマーカー値のリスト。 データタイプ：アレイ "markers": [] |
| result.items.relatedItems.mergedPayloadIds | 処理中にこの CI に結合された CMDB IRE 部分のペイロード \[cmdb_ire_partial_payloads\] テーブル内のエントリのsys_id値のリスト。 データタイプ：アレイ "mergedPayloadIds": [ "String" ] |
| result.items.relatedSysIds | 要求本文 items.lookup アレイの関連アイテム (テーブルルックアップアイテム) のsys_id値のリスト。 データタイプ：アレイ 注目すべき値： * null：この関連アイテムの識別された sys_id がありませんでした。 {#identifyreconcile-POST-queryenhanced__ul_zs5_f1y_glb} "relatedSysIds": [ Number, Number ] |
| result.items.sysId | 識別によってこの CI に対して見つかったSys_id。 注目すべき値： * Unknown：この CI の識別に失敗しました。詳細については、「errors」を参照してください。 {#identifyreconcile-POST-queryenhanced__ul_zz5_5vb_glb} データタイプ：文字列 |
| 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 関係テーブル。 {#identifyreconcile-POST-queryenhanced__ul_ilx_d1v_flb} データタイプ：文字列 |
| 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 が更新されました。 {#identifyreconcile-POST-queryenhanced__ul_qd5_kg5_flb} データタイプ：文字列 |
| result.relations.warnings | この依存関係 CI の処理中に発生した警告のリスト。 データタイプ：オブジェクトのアレイ "warnings": [ { "error": "String", "message": "String" } ] |
| result.relations.warnings.error | この依存関係 CI の処理中に発生した警告のタイプ。 データタイプ：文字列 |
| result.relations.warnings.message | この依存関係 CI の処理中に警告メッセージが表示されました。 データタイプ：文字列 |
[ ]

{#identifyreconcile-POST-queryenhanced__table_gy4_yyn_rlb}  

### cURL 要求

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

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

応答は、ペイロードが CMDB IRE 部分のペイロード \[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
          }
        }
      }
    }