---
sourceDocument: オーストラリア API リファレンス
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/api-reference

 Release :

    - australia

ft:locale :

    - ja-JP

ft:publication_title :

    - オーストラリア API リファレンス

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# 識別および調整 API

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

* リリースバージョン: Australia
* 
* 更新日 2026年03月12日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：198分

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

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

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

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

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

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

### URL 形式

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

デフォルト URL: /api/now/identifyreconcile  
注:  
使用可能なバージョン [は、REST API エクスプローラー](https://servicenow-prod.fluidtopics.net/5V9lEGssZWUBc2ao1C_~Fg "このチュートリアルでは、REST API エクスプローラーを使用して、 ServiceNow REST API をテストします。")で指定されます。スクリプト済み REST API の場合、\[ [スクリプト済み REST サービス\] フォーム](I8AGM_146DeZDBTS~H_J8g "スクリプト化された REST API 機能を使用すると、アプリケーション開発者はカスタム Web サービス API をビルドできます。")に追加のバージョン情報があります。

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

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

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

{#identifyreconcile-POST__entry__6}

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

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

| 名前 | 説明 |
|-|-|
| アイテム | 作成または更新する CI のリスト。 データタイプ：オブジェクトのアレイ "items": [ { "className": "String", "internal_id": "String", "lookup": [Array], "related": [Array], "settings": {Object}, "sys_object_source_info": {Object}, "values": {Object} } ] |
| items.className | 必須です。作成または更新する CI のsys_class_name (クラス/テーブル名)。この値は、cmdb_ci_linux_server や cmdb_ci_win_server などの任意の CMDB テーブルにすることができます。 データタイプ：文字列 |
| items.internal_id | このペイロード内のこのアイテムの一意の識別子。任意の値にすることができますが、ペイロード内で一意である必要があります。 データタイプ：文字列 |
| 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_オブジェクト_ソース_情報 | 指定されたデータソースの一意の CI ID を記述するオブジェクト。ソースが異なれば、同じ CI に対して名前と値のペアが異なる場合があります。 データタイプ: オブジェクト "sys_object_source_info": { "source_feed": "String", "source_name": "String", "source_native_key": "String", "source_recency_timestamp": "String" } |
| items.lookup.sys_object_source_info.source_feed | この CI を送信するフィードを一意に識別する名前。ソースに複数のフィードを含めることができる場合に使用します。 データタイプ：文字列 |
| items.lookup.sys_object_source_info.source_name | CI 情報のデータソース。この値は、構成アイテム \[cmdb_ci\] テーブルの \[discovery_source\] フィールドに定義されている選択値のいずれかである必要があります。 データタイプ：文字列 |
| items.lookup.sys_object_source_info.source_native_key | CI のソースからの一意のキー/ID。アイテムに固有の任意の文字列を指定できます。 データタイプ：文字列 |
| items.lookup.sys_object_source_info.source_recency_timestamp | CI がスキャンされた UTC 日時。 データタイプ：文字列 形式:YYYY-MM-DD hh:mm:ss |
| 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_オブジェクト_ソース_情報 | 指定されたデータソースの一意の CI ID を記述するオブジェクト。ソースが異なれば、同じ CI に対して名前と値のペアが異なる場合があります。 データタイプ: オブジェクト "sys_object_source_info": { "source_feed": "String", "source_name": "String", "source_native_key": "String", "source_recency_timestamp": "String" } |
| items.related.sys_object_source_info.source_feed | この関連アイテムを送信するフィードを一意に識別する名前。ソースに複数のフィードを含めることができる場合に使用します。 データタイプ：文字列 |
| items.related.sys_object_source_info.source_name | 関連アイテム情報のデータソース。この値は、構成アイテム \[cmdb_ci\] テーブルの \[discovery_source\] フィールドに定義されている選択値のいずれかである必要があります。 データタイプ：文字列 |
| items.related.sys_object_source_info.source_native_key | 関連アイテムのソースからの一意のキー/ID。アイテムに固有の任意の文字列を指定できます。 データタイプ：文字列 |
| items.related.sys_object_source_info.source_recency_timestamp | 関連アイテムがスキャンされた UTC 日時。 データタイプ：文字列 形式:YYYY-MM-DD hh:mm:ss |
| 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_オブジェクト_ソース_情報 | 一意の CI ID を記述するオブジェクト。 データタイプ: オブジェクト "sys_object_source_info": { "source_feed": "String", "source_name": "String", "source_native_key": "String", "source_recency_timestamp": "String" } |
| items.sys_object_source_info.source_feed | この CI を送信するフィードを一意に識別する名前。ソースに複数のフィードを含めることができる場合に使用します。 データタイプ：文字列 |
| items.sys_object_source_info.source_name | CI 情報のデータソース。この値は、構成アイテム \[cmdb_ci\] テーブルの \[discovery_source\] フィールドに定義されている選択値のいずれかである必要があります。 データタイプ：文字列 |
| items.sys_object_source_info.source_native_key | CI のソースからの一意のキー/ID。アイテムに固有の任意の文字列を指定できます。 データタイプ：文字列 |
| items.sys_object_source_info.source_recency_timestamp | CI がスキャンされた UTC 日時。 データタイプ：文字列 形式:YYYY-MM-DD hh:mm:ss |
| items.values | この CI に対して名前/値のペアとして作成または更新するフィールドを記述するオブジェクト (名前はフィールド名)。参照フィールドの場合、値は参照sys_idである必要があります。 データタイプ: オブジェクト フィールドの名前とタイプは、次のようなユーザーが選択したフィールドによって異なります。 "values": { "host_name": "String", "ip_address": "String", "name": "String", "os_name": "String", "sys_class_name": "String" } |
| referenceItem | ペイロード内の 2 つのアイテム間の参照のリスト。各参照アイテムの値は、クラスで定義された IRE ルールを使用して CI を識別する前に入力されます。 データタイプ：オブジェクトのアレイ "referenceItems": [ { "referenced": "String", "referencedBy": "String", "referenceField": "String" } ] |
| referenceItems.referenced | 別のアイテムによって参照されているアイテムに対して定義された internal_id 。 データタイプ：文字列 |
| referenceItems.referencedBy | 別のアイテムを参照するアイテムに対して定義された internal_id 。 データタイプ：文字列 |
| referenceItems.referenceField | referencedByアイテムのクラス/テーブル内の参照フィールドの名前。 データタイプ：文字列 |
| 関連 | ペイロードで定義されている 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」は、テーブルでレコードを作成するときに \[source_feed\] 列に保存されsys_rel_source。 |
| relations.type | 親アイテムと子アイテムの間に存在する関係のタイプ。これは、CI 関係性タイプ \[cmdb_rel_type\] テーブルの名前フィールド値である必要があります。 データタイプ：文字列 |
[表 : 3. 要求本文パラメーター (XML または JSON)]

### ヘッダー

次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "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/lLW_uT5I5_l1aD8yR4Jt9A "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 | クエリによって生成された結果のリスト。 データタイプ：アレイ "result": [ "additionalCommittedItems": [Array], "additionalCommittedRelations": [Array], "items": [Array], "relations": [Array] ] |
| result.additionalCommittedItems | 挿入または更新するアレイ items 要求本文に含まれていない CI のリスト。 データタイプ：オブジェクトのアレイ "additionalCommittedItems": [ { "className": "String", "errorCount": Number, "identificationAttempts": [Array], "inputIndices": [Array], "markers": [Array], "mergedPayloads": [Array], "operation": "String", "sysId": "String" } ] |
| result.additionalCommittedItems.className | この追加 CI のsys_class_name。 データタイプ：文字列 |
| result.additionalCommittedItems.errorCount | この追加 CI の処理中に発生したエラーの数。 データタイプ：数値 |
| result.additionalCommittedItems.errors | この追加 CI の処理中に発生したエラーのリスト。 データタイプ：オブジェクトのアレイ "errors": [ { "error": "String", "message": "String" } ] |
| result.additionalCommittedItems.errors.error | この追加 CI の処理中に発生したエラーのタイプ。 データタイプ：文字列 |
| result.additionalCommittedItems.errors.message | この追加 CI の処理中にエラーメッセージが発生しました。 データタイプ：文字列 |
| result.additionalCommittedItems.identificationAttempts | この追加の CI を識別するために行われた試行のリスト。 データタイプ：オブジェクトのアレイ "identificationAttempts": [ { "attemptResult": "String", "attributes": [Array], "hybridEntryCiAttributes": [Array], "identiferName": "String", "searchOnTable": [Array] } ] |
| result.additionalCommittedItems.identificationAttempts.attemptResult | この追加の CI 識別試行の結果。 可能な値： * 一致:識別に成功しました。識別子ルールテーブルで、指定された属性と完全に一致する一意の CI が見つかりました。 * MULTI_MATCH:エラーで識別に失敗しました。指定された属性と照合したときに、識別子ルールテーブルで重複 CI が見つかりました。 * NO_MATCH:識別に失敗しました。指定された属性に一致する識別子ルールテーブルに CI が見つかりませんでした。 * スキップ:識別は試行されませんでした。この識別子ルールテーブル検索に必要な属性が指定されていないため、ルールは適用されませんでした。 {#identifyreconcile-POST__ul_axc_bxx_glb} データタイプ：文字列 |
| result.additionalCommittedItems.identificationAttempts.attributes | この追加の CI 識別試行中に使用される CI 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。 注目すべき値: * 不明:この追加の CI の識別に失敗しました。詳細については、「errors」を参照してください。 {#identifyreconcile-POST__ul_hlk_gyx_glb} データタイプ：文字列 |
| result.additionalCommittedItems.inputIndices | この追加 CI に対応する要求本文 items アレイの CI のインデックス値のリスト。 データタイプ：オブジェクトのアレイ "inputIndices": [ { Number } ] |
| result.additionalCommittedItems.markers | 内部使用のためのマーカー値のリスト。 データタイプ：アレイ "markers": [] |
| result.additionalCommittedItems.mergedPayloads | この追加 CI の処理中に結合された CMDB IRE 部分的ペイロード \[cmdb_ire_partial_payloads\] テーブルの部分的ペイロードのsys_id値のリスト。 データタイプ：アレイ "mergedPayloadIds": [ "String" ] |
| result.additionalCommittedItems.operation | この追加 CI に対して実行された操作。 可能な値： * 削除:既存の CI がターゲットテーブルから削除されます。 * INSERT:追加の CI が新しいレコードとしてターゲットテーブルに挿入されます。 * NO_CHANGE:追加の CI に対して操作は実行されません。 * 更新:ターゲットテーブルの既存の CI が更新されます。 * UPDATE_WITH_DOWNGRADE:ターゲットテーブルの既存の CI が更新され、そのクラスがより汎用的なクラス (先祖クラス) に変更されます。 * UPDATE_WITH_SWITCH:ターゲットテーブルの既存の CI が更新され、そのクラスが先祖または子孫クラスではない別のクラスに変更されます。 * UPDATE_WITH_UPGRADE:ターゲットテーブルの既存の CI が更新され、そのクラスがより特殊なクラス (子孫クラス) に変更されます。 {#identifyreconcile-POST__ul_dwt_qwx_glb} データタイプ：文字列 |
| result.additionalCommittedItems.sysId | 識別によってこの追加 CI のSys_idが見つかりました。 注目の値: 不明:この追加の CI の識別に失敗しました。詳細については、「errors」を参照してください。 データタイプ：文字列 |
| result.additionalCommittedItems.warnings | この追加 CI の処理中に発生した警告のリスト。 データタイプ：オブジェクトのアレイ "warnings": [ { "error": "String", "message": "String" } ] |
| result.additionalCommittedItems.warnings.error | この追加 CI の処理中に発生した警告のタイプ。 データタイプ：文字列 |
| result.additionalCommittedItems.warnings.message | この追加 CI の処理中に警告メッセージが表示されました。 データタイプ：文字列 |
| result.additionalCommittedRelations | 要求本文に含まれていない依存関係 CI のリスト 挿入または更新する relations リスト。 データタイプ：オブジェクトのアレイ "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 に対して操作は実行されません。 * 更新:ターゲットテーブルの既存の依存関係 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 識別試行の結果。 可能な値： * 一致:識別に成功しました。識別子ルールテーブルで、指定された属性と完全に一致する一意の CI が見つかりました。 * MULTI_MATCH:エラーで識別に失敗しました。指定された属性と照合したときに、識別子ルールテーブルで重複 CI が見つかりました。 * NO_MATCH:識別に失敗しました。指定された属性に一致する識別子ルールテーブルに CI が見つかりませんでした。 * スキップ:識別は試行されませんでした。この識別子ルールテーブル検索に必要な属性が指定されていないため、ルールは適用されませんでした。 {#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。 注目すべき値: * 不明:この 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 に対して実行された操作。 可能な値： * 削除:既存の CI がターゲットテーブルから削除されます。 * INSERT:CI は新しいレコードとしてターゲットテーブルに挿入されます。 * NO_CHANGE:CI に対して操作は実行されません。 * 更新:ターゲットテーブルの既存の CI が更新されます。 * UPDATE_WITH_DOWNGRADE:ターゲットテーブルの既存の CI が更新され、そのクラスがより汎用的なクラス (先祖クラス) に変更されます。 * UPDATE_WITH_SWITCH:ターゲットテーブルの既存の CI が更新され、そのクラスが先祖または子孫クラスではない別のクラスに変更されます。 * UPDATE_WITH_UPGRADE:ターゲットテーブルの既存の CI が更新され、そのクラスがより特殊なクラス (子孫クラス) に変更されます。 {#identifyreconcile-POST__ul_jhl_gg5_flb} データタイプ：文字列 |
| result.items.relatedItems | 要求本文 items.lookup アレイからの関連 CI のリスト (テーブル検索 CI)。 データタイプ：オブジェクトのアレイ "relatedItems": [ { "className": "String", "inputIndices": [Array], "markers": [Array], "mergedPayloadIds": [Array], "sysId": "String" } ] |
| result.items.relatedItems.className | 関連アイテムのsys_class_name。 データタイプ：文字列 |
| result.items.relatedItems.inputIndices | この関連アイテムに対応する要求本文の items と items.lookup アレイからの CI およびルックアップアイテムのインデックス値のリスト。 データタイプ：オブジェクトのアレイ "inputIndices": [ { "mainIndex": Number, "subIndex": Number } ] |
| result.items.relatedItems.inputIndices.mainIndex | 関連アイテムの CI 親に対応する要求本文 items アレイのインデックス値。 データタイプ：数値 |
| result.items.relatedItems.inputIndices.subIndex | 関連アイテムに対応する要求本文 items.lookup アレイのインデックス値。 データタイプ：数値 |
| result.items.relatedItems.markers | 内部使用のためのマーカー値のリスト。 データタイプ：アレイ "markers": [] |
| result.items.relatedItems.mergedPayloadIds | 処理中にこの CI に結合された CMDB IRE 部分のペイロード \[cmdb_ire_partial_payloads\] テーブルのエントリーのsys_id値のリスト。 データタイプ：アレイ "mergedPayloadIds": [ "String" ] |
| result.items.relatedSysIds | 要求本文 items.lookup アレイからの関連アイテム (テーブルルックアップアイテム) のsys_id値のリスト。 データタイプ：アレイ 注目すべき値: * null:この関連アイテムのsys_idが特定されませんでした。 {#identifyreconcile-POST__ul_zs5_f1y_glb} "relatedSysIds": [ Number, Number ] |
| result.items.sysId | 識別によってこの CI のSys_idが見つかりました。 注目すべき値: * 不明:この CI の識別に失敗しました。詳細については、「errors」を参照してください。 {#identifyreconcile-POST__ul_zz5_5vb_glb} データタイプ：文字列 |
| 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 に対して操作は実行されませんでした。 * 更新:ターゲットテーブルの既存の依存関係 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 要求

Linux サーバー (シリアル番号とネットワークアダプターの関連アイテムのルックアップを含む) と IP スイッチを含むペイロードを、それらの間に IP 接続依存関係がある状態で送信します。

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

Linux サーバー CI は、ハードウェア \[cmdb_ci_hardware\] テーブルでその名前を検索するハードウェアルールによって識別され、Linux サーバー \[cmdb_ci_linux_server\] テーブルの既存の CI の更新として処理されます。同様に、IP スイッチはハードウェアルールによって識別され、ハードウェアテーブルでその名前を検索し、IP スイッチ \[cmdb_ci_ip_switch\] テーブルで既存の CI を更新します。最後に、サーバーとスイッチの間の IP 接続依存関係が新しいレコードとして CI 関係 \[cmdb_rel_ci\] テーブルに挿入されます。

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

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

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

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

### URL 形式

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

デフォルト URL: /api/now/identifyreconcile/enhanced  
注:  
使用可能なバージョン [は、REST API エクスプローラー](https://servicenow-prod.fluidtopics.net/5V9lEGssZWUBc2ao1C_~Fg "このチュートリアルでは、REST API エクスプローラーを使用して、 ServiceNow REST API をテストします。")で指定されます。スクリプト済み REST API の場合、\[ [スクリプト済み REST サービス\] フォーム](I8AGM_146DeZDBTS~H_J8g "スクリプト化された REST API 機能を使用すると、アプリケーション開発者はカスタム Web サービス API をビルドできます。")に追加のバージョン情報があります。

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

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

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

{#identifyreconcile-POST-enhanced__entry__6}

| 名前 | 説明 |
|-|-|
| オプション | 要求に適用される拡張 IRE オプションを表す名前と値のペアのカンマ区切りリスト。 たとえば、部分的ペイロード、部分コミット、重複排除ペイロード、およびサマリーの生成のデフォルト値を上書きするには 拡張 IRE オプション: `partial_payloads:false,partial_commits:false,deduplicate_payloads:false,generate_summary:true` 注: デフォルトでは、または partial_payloads が true に設定されている場合、部分的ペイロード機能に不可欠な機能であるため、false に設定されていても、 partial_commits と deduplicate_payloads の両方が有効になります。 拡張 IRE オプションの詳細については、「 [識別および調整エンジン (IRE)](https://www.servicenow.com/docs/access?context=ire&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US)」を参照してください。 名前と値のペアごとに有効な値: * true:この拡張 IRE オプションを有効にします。 * false:この拡張 IRE オプションを無効にします。 {#identifyreconcile-POST-enhanced__ul_wc3_mpn_rlb} データタイプ：文字列 |
| sysparm_data_source | CI 情報のソース。これは、構成アイテム \[cmdb_ci\] テーブルの \[discovery_source\] フィールドに定義された選択値のいずれかである必要があります。 データタイプ：文字列 デフォルト:不完全ペイロードテーブルに API ペイロードを挿入します。 |
[表 : 8. クエリパラメーター]

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

| 名前 | 説明 |
|-|-|
| アイテム | 作成または更新する CI のリスト。 データタイプ：オブジェクトのアレイ "items": [ { "className": "String", "internal_id": "String", "lookup": [Array], "related": [Array], "settings": {Object}, "sys_object_source_info": {Object}, "values": {Object} } ] |
| items.className | 必須です。作成または更新する CI のsys_class_name (クラス/テーブル名)。この値は、cmdb_ci_linux_server や cmdb_ci_win_server などの任意の CMDB テーブルにすることができます。 データタイプ：文字列 |
| items.internal_id | このペイロード内のこのアイテムの一意の識別子。任意の値にすることができますが、ペイロード内で一意である必要があります。 データタイプ：文字列 |
| 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_オブジェクト_ソース_情報 | 指定されたデータソースの一意の CI ID を記述するオブジェクト。ソースが異なれば、同じ CI に対して名前と値のペアが異なる場合があります。 データタイプ: オブジェクト "sys_object_source_info": { "source_feed": "String", "source_name": "String", "source_native_key": "String", "source_recency_timestamp": "String" } |
| items.lookup.sys_object_source_info.source_feed | この CI を送信するフィードを一意に識別する名前。ソースに複数のフィードを含めることができる場合に使用します。 データタイプ：文字列 |
| items.lookup.sys_object_source_info.source_name | CI 情報のデータソース。この値は、構成アイテム \[cmdb_ci\] テーブルの \[discovery_source\] フィールドに定義されている選択値のいずれかである必要があります。 データタイプ：文字列 |
| items.lookup.sys_object_source_info.source_native_key | CI のソースからの一意のキー/ID。アイテムに固有の任意の文字列を指定できます。 データタイプ：文字列 |
| items.lookup.sys_object_source_info.source_recency_timestamp | CI がスキャンされた UTC 日時。 データタイプ：文字列 形式:YYYY-MM-DD hh:mm:ss |
| 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_オブジェクト_ソース_情報 | 指定されたデータソースの一意の CI ID を記述するオブジェクト。ソースが異なれば、同じ CI に対して名前と値のペアが異なる場合があります。 データタイプ: オブジェクト "sys_object_source_info": { "source_feed": "String", "source_name": "String", "source_native_key": "String", "source_recency_timestamp": "String" } |
| items.related.sys_object_source_info.source_feed | この関連アイテムを送信するフィードを一意に識別する名前。ソースに複数のフィードを含めることができる場合に使用します。 データタイプ：文字列 |
| items.related.sys_object_source_info.source_name | 関連アイテム情報のデータソース。この値は、構成アイテム \[cmdb_ci\] テーブルの \[discovery_source\] フィールドに定義されている選択値のいずれかである必要があります。 データタイプ：文字列 |
| items.related.sys_object_source_info.source_native_key | 関連アイテムのソースからの一意のキー/ID。アイテムに固有の任意の文字列を指定できます。 データタイプ：文字列 |
| items.related.sys_object_source_info.source_recency_timestamp | 関連アイテムがスキャンされた UTC 日時。 データタイプ：文字列 形式:YYYY-MM-DD hh:mm:ss |
| 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_オブジェクト_ソース_情報 | 一意の CI ID を記述するオブジェクト。 データタイプ: オブジェクト "sys_object_source_info": { "source_feed": "String", "source_name": "String", "source_native_key": "String", "source_recency_timestamp": "String" } |
| items.sys_object_source_info.source_feed | この CI を送信するフィードを一意に識別する名前。ソースに複数のフィードを含めることができる場合に使用します。 データタイプ：文字列 |
| items.sys_object_source_info.source_name | CI 情報のデータソース。この値は、構成アイテム \[cmdb_ci\] テーブルの \[discovery_source\] フィールドに定義されている選択値のいずれかである必要があります。 データタイプ：文字列 |
| items.sys_object_source_info.source_native_key | CI のソースからの一意のキー/ID。アイテムに固有の任意の文字列を指定できます。 データタイプ：文字列 |
| items.sys_object_source_info.source_recency_timestamp | CI がスキャンされた UTC 日時。 データタイプ：文字列 形式:YYYY-MM-DD hh:mm:ss |
| items.values | この CI に対して名前/値のペアとして作成または更新するフィールドを記述するオブジェクト (名前はフィールド名)。参照フィールドの場合、値は参照sys_idである必要があります。 データタイプ: オブジェクト フィールドの名前とタイプは、次のようなユーザーが選択したフィールドによって異なります。 "values": { "host_name": "String", "ip_address": "String", "name": "String", "os_name": "String", "sys_class_name": "String" } |
| referenceItem | ペイロード内の 2 つのアイテム間の参照のリスト。各参照アイテムの値は、クラスで定義された IRE ルールを使用して CI を識別する前に入力されます。 データタイプ：オブジェクトのアレイ "referenceItems": [ { "referenced": "String", "referencedBy": "String", "referenceField": "String" } ] |
| referenceItems.referenced | 別のアイテムによって参照されているアイテムに対して定義された internal_id 。 データタイプ：文字列 |
| referenceItems.referencedBy | 別のアイテムを参照するアイテムに対して定義された internal_id 。 データタイプ：文字列 |
| referenceItems.referenceField | referencedByアイテムのクラス/テーブル内の参照フィールドの名前。 データタイプ：文字列 |
| 関連 | ペイロードで定義されている 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」は、テーブルでレコードを作成するときに \[source_feed\] 列に保存されsys_rel_source。 |
| 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/lLW_uT5I5_l1aD8yR4Jt9A "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/lLW_uT5I5_l1aD8yR4Jt9A "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 | 内部サーバーエラー要求の処理中に予期しないエラーが発生しました。 エラーメッセージの詳細「チャンク \[...\] は有効なエントリではありません」は、 options クエリパラメーターが正しい名前と値のペアの形式でないことを示します。 たとえば、 options パラメーターに `partial` を指定すると、メッセージの詳細に「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 | クエリによって生成された結果のリスト。 データタイプ：アレイ "result": [ "additionalCommittedItems": [Array], "additionalCommittedRelations": [Array], "items": [Array], "relations": [Array] ] |
| result.additionalCommittedItems | 挿入または更新するアレイ items 要求本文に含まれていない CI のリスト。 データタイプ：オブジェクトのアレイ "additionalCommittedItems": [ { "className": "String", "errorCount": Number, "identificationAttempts": [Array], "inputIndices": [Array], "markers": [Array], "mergedPayloads": [Array], "operation": "String", "sysId": "String" } ] |
| result.additionalCommittedItems.className | この追加 CI のsys_class_name。 データタイプ：文字列 |
| result.additionalCommittedItems.errorCount | この追加 CI の処理中に発生したエラーの数。 データタイプ：数値 |
| result.additionalCommittedItems.errors | この追加 CI の処理中に発生したエラーのリスト。 データタイプ：オブジェクトのアレイ "errors": [ { "error": "String", "message": "String" } ] |
| result.additionalCommittedItems.errors.error | この追加 CI の処理中に発生したエラーのタイプ。 データタイプ：文字列 |
| result.additionalCommittedItems.errors.message | この追加 CI の処理中にエラーメッセージが発生しました。 データタイプ：文字列 |
| result.additionalCommittedItems.identificationAttempts | この追加の CI を識別するために行われた試行のリスト。 データタイプ：オブジェクトのアレイ "identificationAttempts": [ { "attemptResult": "String", "attributes": [Array], "hybridEntryCiAttributes": [Array], "identiferName": "String", "searchOnTable": [Array] } ] |
| result.additionalCommittedItems.identificationAttempts.attemptResult | この追加の CI 識別試行の結果。 可能な値： * 一致:識別に成功しました。識別子ルールテーブルで、指定された属性と完全に一致する一意の CI が見つかりました。 * MULTI_MATCH:エラーで識別に失敗しました。指定された属性と照合したときに、識別子ルールテーブルで重複 CI が見つかりました。 * NO_MATCH:識別に失敗しました。指定された属性に一致する識別子ルールテーブルに CI が見つかりませんでした。 * スキップ:識別は試行されませんでした。この識別子ルールテーブル検索に必要な属性が指定されていないため、ルールは適用されませんでした。 {#identifyreconcile-POST-enhanced__ul_axc_bxx_glb} データタイプ：文字列 |
| result.additionalCommittedItems.identificationAttempts.attributes | この追加の CI 識別試行中に使用される CI 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。 注目すべき値: * 不明:この追加の CI の識別に失敗しました。詳細については、「errors」を参照してください。 {#identifyreconcile-POST-enhanced__ul_hlk_gyx_glb} データタイプ：文字列 |
| result.additionalCommittedItems.inputIndices | この追加 CI に対応する要求本文 items アレイの CI のインデックス値のリスト。 データタイプ：オブジェクトのアレイ "inputIndices": [ { Number } ] |
| result.additionalCommittedItems.markers | 内部使用のためのマーカー値のリスト。 データタイプ：アレイ "markers": [] |
| result.additionalCommittedItems.mergedPayloads | この追加 CI の処理中に結合された CMDB IRE 部分的ペイロード \[cmdb_ire_partial_payloads\] テーブルの部分的ペイロードのsys_id値のリスト。 データタイプ：アレイ "mergedPayloadIds": [ "String" ] |
| result.additionalCommittedItems.operation | この追加 CI に対して実行された操作。 可能な値： * 削除:既存の CI がターゲットテーブルから削除されます。 * INSERT:追加の CI が新しいレコードとしてターゲットテーブルに挿入されます。 * NO_CHANGE:追加の CI に対して操作は実行されません。 * 更新:ターゲットテーブルの既存の CI が更新されます。 * UPDATE_WITH_DOWNGRADE:ターゲットテーブルの既存の CI が更新され、そのクラスがより汎用的なクラス (先祖クラス) に変更されます。 * UPDATE_WITH_SWITCH:ターゲットテーブルの既存の CI が更新され、そのクラスが先祖または子孫クラスではない別のクラスに変更されます。 * UPDATE_WITH_UPGRADE:ターゲットテーブルの既存の CI が更新され、そのクラスがより特殊なクラス (子孫クラス) に変更されます。 {#identifyreconcile-POST-enhanced__ul_dwt_qwx_glb} データタイプ：文字列 |
| result.additionalCommittedItems.sysId | 識別によってこの追加 CI のSys_idが見つかりました。 注目の値: 不明:この追加の CI の識別に失敗しました。詳細については、「errors」を参照してください。 データタイプ：文字列 |
| result.additionalCommittedItems.warnings | この追加 CI の処理中に発生した警告のリスト。 データタイプ：オブジェクトのアレイ "warnings": [ { "error": "String", "message": "String" } ] |
| result.additionalCommittedItems.warnings.error | この追加 CI の処理中に発生した警告のタイプ。 データタイプ：文字列 |
| result.additionalCommittedItems.warnings.message | この追加 CI の処理中に警告メッセージが表示されました。 データタイプ：文字列 |
| result.additionalCommittedRelations | 要求本文に含まれていない依存関係 CI のリスト 挿入または更新する relations リスト。 データタイプ：オブジェクトのアレイ "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 に対して操作は実行されません。 * 更新:ターゲットテーブルの既存の依存関係 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 識別試行の結果。 可能な値： * 一致:識別に成功しました。識別子ルールテーブルで、指定された属性と完全に一致する一意の CI が見つかりました。 * MULTI_MATCH:エラーで識別に失敗しました。指定された属性と照合したときに、識別子ルールテーブルで重複 CI が見つかりました。 * NO_MATCH:識別に失敗しました。指定された属性に一致する識別子ルールテーブルに CI が見つかりませんでした。 * スキップ:識別は試行されませんでした。この識別子ルールテーブル検索に必要な属性が指定されていないため、ルールは適用されませんでした。 {#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。 注目すべき値: * 不明:この 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 に対して実行された操作。 可能な値： * 削除:既存の CI がターゲットテーブルから削除されます。 * INSERT:CI は新しいレコードとしてターゲットテーブルに挿入されます。 * NO_CHANGE:CI に対して操作は実行されません。 * 更新:ターゲットテーブルの既存の CI が更新されます。 * UPDATE_WITH_DOWNGRADE:ターゲットテーブルの既存の CI が更新され、そのクラスがより汎用的なクラス (先祖クラス) に変更されます。 * UPDATE_WITH_SWITCH:ターゲットテーブルの既存の CI が更新され、そのクラスが先祖または子孫クラスではない別のクラスに変更されます。 * UPDATE_WITH_UPGRADE:ターゲットテーブルの既存の CI が更新され、そのクラスがより特殊なクラス (子孫クラス) に変更されます。 {#identifyreconcile-POST-enhanced__ul_jhl_gg5_flb} データタイプ：文字列 |
| result.items.relatedItems | 要求本文 items.lookup アレイからの関連 CI のリスト (テーブル検索 CI)。 データタイプ：オブジェクトのアレイ "relatedItems": [ { "className": "String", "inputIndices": [Array], "markers": [Array], "mergedPayloadIds": [Array], "sysId": "String" } ] |
| result.items.relatedItems.className | 関連アイテムのsys_class_name。 データタイプ：文字列 |
| result.items.relatedItems.inputIndices | この関連アイテムに対応する要求本文の items と items.lookup アレイからの CI およびルックアップアイテムのインデックス値のリスト。 データタイプ：オブジェクトのアレイ "inputIndices": [ { "mainIndex": Number, "subIndex": Number } ] |
| result.items.relatedItems.inputIndices.mainIndex | 関連アイテムの CI 親に対応する要求本文 items アレイのインデックス値。 データタイプ：数値 |
| result.items.relatedItems.inputIndices.subIndex | 関連アイテムに対応する要求本文 items.lookup アレイのインデックス値。 データタイプ：数値 |
| result.items.relatedItems.markers | 内部使用のためのマーカー値のリスト。 データタイプ：アレイ "markers": [] |
| result.items.relatedItems.mergedPayloadIds | 処理中にこの CI に結合された CMDB IRE 部分のペイロード \[cmdb_ire_partial_payloads\] テーブルのエントリーのsys_id値のリスト。 データタイプ：アレイ "mergedPayloadIds": [ "String" ] |
| result.items.relatedSysIds | 要求本文 items.lookup アレイからの関連アイテム (テーブルルックアップアイテム) のsys_id値のリスト。 データタイプ：アレイ 注目すべき値: * null:この関連アイテムのsys_idが特定されませんでした。 {#identifyreconcile-POST-enhanced__ul_zs5_f1y_glb} "relatedSysIds": [ Number, Number ] |
| result.items.sysId | 識別によってこの CI のSys_idが見つかりました。 注目すべき値: * 不明:この CI の識別に失敗しました。詳細については、「errors」を参照してください。 {#identifyreconcile-POST-enhanced__ul_zz5_5vb_glb} データタイプ：文字列 |
| 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 に対して操作は実行されませんでした。 * 更新:ターゲットテーブルの既存の依存関係 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/XJfczTQBXIsvyDojhKueBA#identifyreconcile-POST "指定されたペイロード (要求本文) に識別および調整ルールを適用して、構成アイテム (CI) を CMDB に挿入または更新します。CMDBを直接更新する代わりに、この API を使用します。") エンドポイントへのペイロード (要求本文) の送信をシミュレートします。

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

### URL 形式

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

デフォルト URL: /api/now/identifyreconcile/query  
注:  
使用可能なバージョン [は、REST API エクスプローラー](https://servicenow-prod.fluidtopics.net/5V9lEGssZWUBc2ao1C_~Fg "このチュートリアルでは、REST API エクスプローラーを使用して、 ServiceNow REST API をテストします。")で指定されます。スクリプト済み REST API の場合、\[ [スクリプト済み REST サービス\] フォーム](I8AGM_146DeZDBTS~H_J8g "スクリプト化された REST API 機能を使用すると、アプリケーション開発者はカスタム Web サービス API をビルドできます。")に追加のバージョン情報があります。

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

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

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

{#identifyreconcile-POST-query__entry__6}

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

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

| 名前 | 説明 |
|-|-|
| アイテム | 作成または更新する CI のリスト。 データタイプ：オブジェクトのアレイ "items": [ { "className": "String", "internal_id": "String", "lookup": [Array], "related": [Array], "settings": {Object}, "sys_object_source_info": {Object}, "values": {Object} } ] |
| items.className | 必須です。作成または更新する CI のsys_class_name (クラス/テーブル名)。この値は、cmdb_ci_linux_server や cmdb_ci_win_server などの任意の CMDB テーブルにすることができます。 データタイプ：文字列 |
| items.internal_id | このペイロード内のこのアイテムの一意の識別子。任意の値にすることができますが、ペイロード内で一意である必要があります。 データタイプ：文字列 |
| 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_オブジェクト_ソース_情報 | 指定されたデータソースの一意の CI ID を記述するオブジェクト。ソースが異なれば、同じ CI に対して名前と値のペアが異なる場合があります。 データタイプ: オブジェクト "sys_object_source_info": { "source_feed": "String", "source_name": "String", "source_native_key": "String", "source_recency_timestamp": "String" } |
| items.lookup.sys_object_source_info.source_feed | この CI を送信するフィードを一意に識別する名前。ソースに複数のフィードを含めることができる場合に使用します。 データタイプ：文字列 |
| items.lookup.sys_object_source_info.source_name | CI 情報のデータソース。この値は、構成アイテム \[cmdb_ci\] テーブルの \[discovery_source\] フィールドに定義されている選択値のいずれかである必要があります。 データタイプ：文字列 |
| items.lookup.sys_object_source_info.source_native_key | CI のソースからの一意のキー/ID。アイテムに固有の任意の文字列を指定できます。 データタイプ：文字列 |
| items.lookup.sys_object_source_info.source_recency_timestamp | CI がスキャンされた UTC 日時。 データタイプ：文字列 形式:YYYY-MM-DD hh:mm:ss |
| 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_オブジェクト_ソース_情報 | 指定されたデータソースの一意の CI ID を記述するオブジェクト。ソースが異なれば、同じ CI に対して名前と値のペアが異なる場合があります。 データタイプ: オブジェクト "sys_object_source_info": { "source_feed": "String", "source_name": "String", "source_native_key": "String", "source_recency_timestamp": "String" } |
| items.related.sys_object_source_info.source_feed | この関連アイテムを送信するフィードを一意に識別する名前。ソースに複数のフィードを含めることができる場合に使用します。 データタイプ：文字列 |
| items.related.sys_object_source_info.source_name | 関連アイテム情報のデータソース。この値は、構成アイテム \[cmdb_ci\] テーブルの \[discovery_source\] フィールドに定義されている選択値のいずれかである必要があります。 データタイプ：文字列 |
| items.related.sys_object_source_info.source_native_key | 関連アイテムのソースからの一意のキー/ID。アイテムに固有の任意の文字列を指定できます。 データタイプ：文字列 |
| items.related.sys_object_source_info.source_recency_timestamp | 関連アイテムがスキャンされた UTC 日時。 データタイプ：文字列 形式:YYYY-MM-DD hh:mm:ss |
| 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_オブジェクト_ソース_情報 | 一意の CI ID を記述するオブジェクト。 データタイプ: オブジェクト "sys_object_source_info": { "source_feed": "String", "source_name": "String", "source_native_key": "String", "source_recency_timestamp": "String" } |
| items.sys_object_source_info.source_feed | この CI を送信するフィードを一意に識別する名前。ソースに複数のフィードを含めることができる場合に使用します。 データタイプ：文字列 |
| items.sys_object_source_info.source_name | CI 情報のデータソース。この値は、構成アイテム \[cmdb_ci\] テーブルの \[discovery_source\] フィールドに定義されている選択値のいずれかである必要があります。 データタイプ：文字列 |
| items.sys_object_source_info.source_native_key | CI のソースからの一意のキー/ID。アイテムに固有の任意の文字列を指定できます。 データタイプ：文字列 |
| items.sys_object_source_info.source_recency_timestamp | CI がスキャンされた UTC 日時。 データタイプ：文字列 形式:YYYY-MM-DD hh:mm:ss |
| items.values | この CI に対して名前/値のペアとして作成または更新するフィールドを記述するオブジェクト (名前はフィールド名)。参照フィールドの場合、値は参照sys_idである必要があります。 データタイプ: オブジェクト フィールドの名前とタイプは、次のようなユーザーが選択したフィールドによって異なります。 "values": { "host_name": "String", "ip_address": "String", "name": "String", "os_name": "String", "sys_class_name": "String" } |
| referenceItem | ペイロード内の 2 つのアイテム間の参照のリスト。各参照アイテムの値は、クラスで定義された IRE ルールを使用して CI を識別する前に入力されます。 データタイプ：オブジェクトのアレイ "referenceItems": [ { "referenced": "String", "referencedBy": "String", "referenceField": "String" } ] |
| referenceItems.referenced | 別のアイテムによって参照されているアイテムに対して定義された internal_id 。 データタイプ：文字列 |
| referenceItems.referencedBy | 別のアイテムを参照するアイテムに対して定義された internal_id 。 データタイプ：文字列 |
| referenceItems.referenceField | referencedByアイテムのクラス/テーブル内の参照フィールドの名前。 データタイプ：文字列 |
| 関連 | ペイロードで定義されている 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」は、テーブルでレコードを作成するときに \[source_feed\] 列に保存されsys_rel_source。 |
| relations.type | 親アイテムと子アイテムの間に存在する関係のタイプ。これは、CI 関係性タイプ \[cmdb_rel_type\] テーブルの名前フィールド値である必要があります。 データタイプ：文字列 |
[表 : 15. 要求本文パラメーター (XML または JSON)]

### ヘッダー

次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "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/lLW_uT5I5_l1aD8yR4Jt9A "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 | クエリによって生成された結果のリスト。 データタイプ：アレイ "result": [ "additionalCommittedItems": [Array], "additionalCommittedRelations": [Array], "items": [Array], "relations": [Array] ] |
| result.additionalCommittedItems | 挿入または更新するアレイ items 要求本文に含まれていない CI のリスト。 データタイプ：オブジェクトのアレイ "additionalCommittedItems": [ { "className": "String", "errorCount": Number, "identificationAttempts": [Array], "inputIndices": [Array], "markers": [Array], "mergedPayloads": [Array], "operation": "String", "sysId": "String" } ] |
| result.additionalCommittedItems.className | この追加 CI のsys_class_name。 データタイプ：文字列 |
| result.additionalCommittedItems.errorCount | この追加 CI の処理中に発生したエラーの数。 データタイプ：数値 |
| result.additionalCommittedItems.errors | この追加 CI の処理中に発生したエラーのリスト。 データタイプ：オブジェクトのアレイ "errors": [ { "error": "String", "message": "String" } ] |
| result.additionalCommittedItems.errors.error | この追加 CI の処理中に発生したエラーのタイプ。 データタイプ：文字列 |
| result.additionalCommittedItems.errors.message | この追加 CI の処理中にエラーメッセージが発生しました。 データタイプ：文字列 |
| result.additionalCommittedItems.identificationAttempts | この追加の CI を識別するために行われた試行のリスト。 データタイプ：オブジェクトのアレイ "identificationAttempts": [ { "attemptResult": "String", "attributes": [Array], "hybridEntryCiAttributes": [Array], "identiferName": "String", "searchOnTable": [Array] } ] |
| result.additionalCommittedItems.identificationAttempts.attemptResult | この追加の CI 識別試行の結果。 可能な値： * 一致:識別に成功しました。識別子ルールテーブルで、指定された属性と完全に一致する一意の CI が見つかりました。 * MULTI_MATCH:エラーで識別に失敗しました。指定された属性と照合したときに、識別子ルールテーブルで重複 CI が見つかりました。 * NO_MATCH:識別に失敗しました。指定された属性に一致する識別子ルールテーブルに CI が見つかりませんでした。 * スキップ:識別は試行されませんでした。この識別子ルールテーブル検索に必要な属性が指定されていないため、ルールは適用されませんでした。 {#identifyreconcile-POST-query__ul_axc_bxx_glb} データタイプ：文字列 |
| result.additionalCommittedItems.identificationAttempts.attributes | この追加の CI 識別試行中に使用される CI 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。 注目すべき値: * 不明:この追加の CI の識別に失敗しました。詳細については、「errors」を参照してください。 {#identifyreconcile-POST-query__ul_hlk_gyx_glb} データタイプ：文字列 |
| result.additionalCommittedItems.inputIndices | この追加 CI に対応する要求本文 items アレイの CI のインデックス値のリスト。 データタイプ：オブジェクトのアレイ "inputIndices": [ { Number } ] |
| result.additionalCommittedItems.markers | 内部使用のためのマーカー値のリスト。 データタイプ：アレイ "markers": [] |
| result.additionalCommittedItems.mergedPayloads | この追加 CI の処理中に結合された CMDB IRE 部分的ペイロード \[cmdb_ire_partial_payloads\] テーブルの部分的ペイロードのsys_id値のリスト。 データタイプ：アレイ "mergedPayloadIds": [ "String" ] |
| result.additionalCommittedItems.operation | この追加 CI に対して実行された操作。 可能な値： * 削除:既存の CI がターゲットテーブルから削除されます。 * INSERT:追加の CI が新しいレコードとしてターゲットテーブルに挿入されます。 * NO_CHANGE:追加の CI に対して操作は実行されません。 * 更新:ターゲットテーブルの既存の CI が更新されます。 * UPDATE_WITH_DOWNGRADE:ターゲットテーブルの既存の CI が更新され、そのクラスがより汎用的なクラス (先祖クラス) に変更されます。 * UPDATE_WITH_SWITCH:ターゲットテーブルの既存の CI が更新され、そのクラスが先祖または子孫クラスではない別のクラスに変更されます。 * UPDATE_WITH_UPGRADE:ターゲットテーブルの既存の CI が更新され、そのクラスがより特殊なクラス (子孫クラス) に変更されます。 {#identifyreconcile-POST-query__ul_dwt_qwx_glb} データタイプ：文字列 |
| result.additionalCommittedItems.sysId | 識別によってこの追加 CI のSys_idが見つかりました。 注目の値: 不明:この追加の CI の識別に失敗しました。詳細については、「errors」を参照してください。 データタイプ：文字列 |
| result.additionalCommittedItems.warnings | この追加 CI の処理中に発生した警告のリスト。 データタイプ：オブジェクトのアレイ "warnings": [ { "error": "String", "message": "String" } ] |
| result.additionalCommittedItems.warnings.error | この追加 CI の処理中に発生した警告のタイプ。 データタイプ：文字列 |
| result.additionalCommittedItems.warnings.message | この追加 CI の処理中に警告メッセージが表示されました。 データタイプ：文字列 |
| result.additionalCommittedRelations | 要求本文に含まれていない依存関係 CI のリスト 挿入または更新する relations リスト。 データタイプ：オブジェクトのアレイ "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 に対して操作は実行されません。 * 更新:ターゲットテーブルの既存の依存関係 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 識別試行の結果。 可能な値： * 一致:識別に成功しました。識別子ルールテーブルで、指定された属性と完全に一致する一意の CI が見つかりました。 * MULTI_MATCH:エラーで識別に失敗しました。指定された属性と照合したときに、識別子ルールテーブルで重複 CI が見つかりました。 * NO_MATCH:識別に失敗しました。指定された属性に一致する識別子ルールテーブルに CI が見つかりませんでした。 * スキップ:識別は試行されませんでした。この識別子ルールテーブル検索に必要な属性が指定されていないため、ルールは適用されませんでした。 {#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。 注目すべき値: * 不明:この 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 に対して実行された操作。 可能な値： * 削除:既存の CI がターゲットテーブルから削除されます。 * INSERT:CI は新しいレコードとしてターゲットテーブルに挿入されます。 * NO_CHANGE:CI に対して操作は実行されません。 * 更新:ターゲットテーブルの既存の CI が更新されます。 * UPDATE_WITH_DOWNGRADE:ターゲットテーブルの既存の CI が更新され、そのクラスがより汎用的なクラス (先祖クラス) に変更されます。 * UPDATE_WITH_SWITCH:ターゲットテーブルの既存の CI が更新され、そのクラスが先祖または子孫クラスではない別のクラスに変更されます。 * UPDATE_WITH_UPGRADE:ターゲットテーブルの既存の CI が更新され、そのクラスがより特殊なクラス (子孫クラス) に変更されます。 {#identifyreconcile-POST-query__ul_jhl_gg5_flb} データタイプ：文字列 |
| result.items.relatedItems | 要求本文 items.lookup アレイからの関連 CI のリスト (テーブル検索 CI)。 データタイプ：オブジェクトのアレイ "relatedItems": [ { "className": "String", "inputIndices": [Array], "markers": [Array], "mergedPayloadIds": [Array], "sysId": "String" } ] |
| result.items.relatedItems.className | 関連アイテムのsys_class_name。 データタイプ：文字列 |
| result.items.relatedItems.inputIndices | この関連アイテムに対応する要求本文の items と items.lookup アレイからの CI およびルックアップアイテムのインデックス値のリスト。 データタイプ：オブジェクトのアレイ "inputIndices": [ { "mainIndex": Number, "subIndex": Number } ] |
| result.items.relatedItems.inputIndices.mainIndex | 関連アイテムの CI 親に対応する要求本文 items アレイのインデックス値。 データタイプ：数値 |
| result.items.relatedItems.inputIndices.subIndex | 関連アイテムに対応する要求本文 items.lookup アレイのインデックス値。 データタイプ：数値 |
| result.items.relatedItems.markers | 内部使用のためのマーカー値のリスト。 データタイプ：アレイ "markers": [] |
| result.items.relatedItems.mergedPayloadIds | 処理中にこの CI に結合された CMDB IRE 部分のペイロード \[cmdb_ire_partial_payloads\] テーブルのエントリーのsys_id値のリスト。 データタイプ：アレイ "mergedPayloadIds": [ "String" ] |
| result.items.relatedSysIds | 要求本文 items.lookup アレイからの関連アイテム (テーブルルックアップアイテム) のsys_id値のリスト。 データタイプ：アレイ 注目すべき値: * null:この関連アイテムのsys_idが特定されませんでした。 {#identifyreconcile-POST-query__ul_zs5_f1y_glb} "relatedSysIds": [ Number, Number ] |
| result.items.sysId | 識別によってこの CI のSys_idが見つかりました。 注目すべき値: * 不明:この CI の識別に失敗しました。詳細については、「errors」を参照してください。 {#identifyreconcile-POST-query__ul_zz5_5vb_glb} データタイプ：文字列 |
| 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 に対して操作は実行されませんでした。 * 更新:ターゲットテーブルの既存の依存関係 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 要求

Linux サーバー (シリアル番号とネットワークアダプターの関連アイテムのルックアップを含む) と IP スイッチを含むペイロードの送信を、それら間の IP 接続関係とともにシミュレートします。

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

Linux サーバー CI は、ハードウェア \[cmdb_ci_hardware\] テーブルでその名前を検索するハードウェアルールによって識別され、Linux サーバー \[cmdb_ci_linux_server\] テーブルの既存の CI の更新として処理されます。同様に、IP スイッチはハードウェアルールによって識別され、ハードウェアテーブルでその名前を検索し、IP スイッチ \[cmdb_ci_ip_switch\] テーブルで既存の CI を更新します。最後に、サーバーとスイッチの間の IP 接続関係が新しいレコードとして CI 関係 \[cmdb_rel_ci\] テーブルに挿入されます。

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

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

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

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

### URL 形式

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

デフォルト URL: /api/now/identifyreconcile/queryEnhanced  
注:  
使用可能なバージョン [は、REST API エクスプローラー](https://servicenow-prod.fluidtopics.net/5V9lEGssZWUBc2ao1C_~Fg "このチュートリアルでは、REST API エクスプローラーを使用して、 ServiceNow REST API をテストします。")で指定されます。スクリプト済み REST API の場合、\[ [スクリプト済み REST サービス\] フォーム](I8AGM_146DeZDBTS~H_J8g "スクリプト化された REST API 機能を使用すると、アプリケーション開発者はカスタム Web サービス API をビルドできます。")に追加のバージョン情報があります。

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

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

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

{#identifyreconcile-POST-queryenhanced__entry__6}

| 名前 | 説明 |
|-|-|
| オプション | 要求に適用される拡張 IRE オプションを表す名前と値のペアのカンマ区切りリスト。 たとえば、部分的ペイロード、部分コミット、重複排除ペイロード、およびサマリーの生成のデフォルト値を上書きするには 拡張 IRE オプション: `partial_payloads:false,partial_commits:false,deduplicate_payloads:false,generate_summary:true` 注: デフォルトでは、または partial_payloads が true に設定されている場合、部分的ペイロード機能に不可欠な機能であるため、false に設定されていても、 partial_commits と deduplicate_payloads の両方が有効になります。 拡張 IRE オプションの詳細については、「 [識別および調整エンジン (IRE)](https://www.servicenow.com/docs/access?context=ire&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US)」を参照してください。 名前と値のペアごとに有効な値: * true:この拡張 IRE オプションを有効にします。 * false:この拡張 IRE オプションを無効にします。 {#identifyreconcile-POST-queryenhanced__ul_wc3_mpn_rlb} データタイプ：文字列 |
| sysparm_data_source | CI 情報のソース。これは、構成アイテム \[cmdb_ci\] テーブルの \[discovery_source\] フィールドに定義された選択値のいずれかである必要があります。 データタイプ：文字列 デフォルト:不完全ペイロードテーブルに API ペイロードを挿入します。 |
[表 : 20. クエリパラメーター]

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

| 名前 | 説明 |
|-|-|
| アイテム | 作成または更新する CI のリスト。 データタイプ：オブジェクトのアレイ "items": [ { "className": "String", "internal_id": "String", "lookup": [Array], "related": [Array], "settings": {Object}, "sys_object_source_info": {Object}, "values": {Object} } ] |
| items.className | 必須です。作成または更新する CI のsys_class_name (クラス/テーブル名)。この値は、cmdb_ci_linux_server や cmdb_ci_win_server などの任意の CMDB テーブルにすることができます。 データタイプ：文字列 |
| items.internal_id | このペイロード内のこのアイテムの一意の識別子。任意の値にすることができますが、ペイロード内で一意である必要があります。 データタイプ：文字列 |
| 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_オブジェクト_ソース_情報 | 指定されたデータソースの一意の CI ID を記述するオブジェクト。ソースが異なれば、同じ CI に対して名前と値のペアが異なる場合があります。 データタイプ: オブジェクト "sys_object_source_info": { "source_feed": "String", "source_name": "String", "source_native_key": "String", "source_recency_timestamp": "String" } |
| items.lookup.sys_object_source_info.source_feed | この CI を送信するフィードを一意に識別する名前。ソースに複数のフィードを含めることができる場合に使用します。 データタイプ：文字列 |
| items.lookup.sys_object_source_info.source_name | CI 情報のデータソース。この値は、構成アイテム \[cmdb_ci\] テーブルの \[discovery_source\] フィールドに定義されている選択値のいずれかである必要があります。 データタイプ：文字列 |
| items.lookup.sys_object_source_info.source_native_key | CI のソースからの一意のキー/ID。アイテムに固有の任意の文字列を指定できます。 データタイプ：文字列 |
| items.lookup.sys_object_source_info.source_recency_timestamp | CI がスキャンされた UTC 日時。 データタイプ：文字列 形式:YYYY-MM-DD hh:mm:ss |
| 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_オブジェクト_ソース_情報 | 指定されたデータソースの一意の CI ID を記述するオブジェクト。ソースが異なれば、同じ CI に対して名前と値のペアが異なる場合があります。 データタイプ: オブジェクト "sys_object_source_info": { "source_feed": "String", "source_name": "String", "source_native_key": "String", "source_recency_timestamp": "String" } |
| items.related.sys_object_source_info.source_feed | この関連アイテムを送信するフィードを一意に識別する名前。ソースに複数のフィードを含めることができる場合に使用します。 データタイプ：文字列 |
| items.related.sys_object_source_info.source_name | 関連アイテム情報のデータソース。この値は、構成アイテム \[cmdb_ci\] テーブルの \[discovery_source\] フィールドに定義されている選択値のいずれかである必要があります。 データタイプ：文字列 |
| items.related.sys_object_source_info.source_native_key | 関連アイテムのソースからの一意のキー/ID。アイテムに固有の任意の文字列を指定できます。 データタイプ：文字列 |
| items.related.sys_object_source_info.source_recency_timestamp | 関連アイテムがスキャンされた UTC 日時。 データタイプ：文字列 形式:YYYY-MM-DD hh:mm:ss |
| 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_オブジェクト_ソース_情報 | 一意の CI ID を記述するオブジェクト。 データタイプ: オブジェクト "sys_object_source_info": { "source_feed": "String", "source_name": "String", "source_native_key": "String", "source_recency_timestamp": "String" } |
| items.sys_object_source_info.source_feed | この CI を送信するフィードを一意に識別する名前。ソースに複数のフィードを含めることができる場合に使用します。 データタイプ：文字列 |
| items.sys_object_source_info.source_name | CI 情報のデータソース。この値は、構成アイテム \[cmdb_ci\] テーブルの \[discovery_source\] フィールドに定義されている選択値のいずれかである必要があります。 データタイプ：文字列 |
| items.sys_object_source_info.source_native_key | CI のソースからの一意のキー/ID。アイテムに固有の任意の文字列を指定できます。 データタイプ：文字列 |
| items.sys_object_source_info.source_recency_timestamp | CI がスキャンされた UTC 日時。 データタイプ：文字列 形式:YYYY-MM-DD hh:mm:ss |
| items.values | この CI に対して名前/値のペアとして作成または更新するフィールドを記述するオブジェクト (名前はフィールド名)。参照フィールドの場合、値は参照sys_idである必要があります。 データタイプ: オブジェクト フィールドの名前とタイプは、次のようなユーザーが選択したフィールドによって異なります。 "values": { "host_name": "String", "ip_address": "String", "name": "String", "os_name": "String", "sys_class_name": "String" } |
| referenceItem | ペイロード内の 2 つのアイテム間の参照のリスト。各参照アイテムの値は、クラスで定義された IRE ルールを使用して CI を識別する前に入力されます。 データタイプ：オブジェクトのアレイ "referenceItems": [ { "referenced": "String", "referencedBy": "String", "referenceField": "String" } ] |
| referenceItems.referenced | 別のアイテムによって参照されているアイテムに対して定義された internal_id 。 データタイプ：文字列 |
| referenceItems.referencedBy | 別のアイテムを参照するアイテムに対して定義された internal_id 。 データタイプ：文字列 |
| referenceItems.referenceField | referencedByアイテムのクラス/テーブル内の参照フィールドの名前。 データタイプ：文字列 |
| 関連 | ペイロードで定義されている 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」は、テーブルでレコードを作成するときに \[source_feed\] 列に保存されsys_rel_source。 |
| 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/lLW_uT5I5_l1aD8yR4Jt9A "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/lLW_uT5I5_l1aD8yR4Jt9A "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 | 内部サーバーエラー要求の処理中に予期しないエラーが発生しました。 エラーメッセージの詳細「チャンク \[...\] は有効なエントリではありません」は、 options クエリパラメーターが正しい名前と値のペアの形式でないことを示します。 たとえば、 options パラメーターに `partial` を指定すると、メッセージの詳細に「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 | クエリによって生成された結果のリスト。 データタイプ：アレイ "result": [ "additionalCommittedItems": [Array], "additionalCommittedRelations": [Array], "items": [Array], "relations": [Array] ] |
| result.additionalCommittedItems | 挿入または更新するアレイ items 要求本文に含まれていない CI のリスト。 データタイプ：オブジェクトのアレイ "additionalCommittedItems": [ { "className": "String", "errorCount": Number, "identificationAttempts": [Array], "inputIndices": [Array], "markers": [Array], "mergedPayloads": [Array], "operation": "String", "sysId": "String" } ] |
| result.additionalCommittedItems.className | この追加 CI のsys_class_name。 データタイプ：文字列 |
| result.additionalCommittedItems.errorCount | この追加 CI の処理中に発生したエラーの数。 データタイプ：数値 |
| result.additionalCommittedItems.errors | この追加 CI の処理中に発生したエラーのリスト。 データタイプ：オブジェクトのアレイ "errors": [ { "error": "String", "message": "String" } ] |
| result.additionalCommittedItems.errors.error | この追加 CI の処理中に発生したエラーのタイプ。 データタイプ：文字列 |
| result.additionalCommittedItems.errors.message | この追加 CI の処理中にエラーメッセージが発生しました。 データタイプ：文字列 |
| result.additionalCommittedItems.identificationAttempts | この追加の CI を識別するために行われた試行のリスト。 データタイプ：オブジェクトのアレイ "identificationAttempts": [ { "attemptResult": "String", "attributes": [Array], "hybridEntryCiAttributes": [Array], "identiferName": "String", "searchOnTable": [Array] } ] |
| result.additionalCommittedItems.identificationAttempts.attemptResult | この追加の CI 識別試行の結果。 可能な値： * 一致:識別に成功しました。識別子ルールテーブルで、指定された属性と完全に一致する一意の CI が見つかりました。 * MULTI_MATCH:エラーで識別に失敗しました。指定された属性と照合したときに、識別子ルールテーブルで重複 CI が見つかりました。 * NO_MATCH:識別に失敗しました。指定された属性に一致する識別子ルールテーブルに CI が見つかりませんでした。 * スキップ:識別は試行されませんでした。この識別子ルールテーブル検索に必要な属性が指定されていないため、ルールは適用されませんでした。 {#identifyreconcile-POST-queryenhanced__ul_axc_bxx_glb} データタイプ：文字列 |
| result.additionalCommittedItems.identificationAttempts.attributes | この追加の CI 識別試行中に使用される CI 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。 注目すべき値: * 不明:この追加の CI の識別に失敗しました。詳細については、「errors」を参照してください。 {#identifyreconcile-POST-queryenhanced__ul_hlk_gyx_glb} データタイプ：文字列 |
| result.additionalCommittedItems.inputIndices | この追加 CI に対応する要求本文 items アレイの CI のインデックス値のリスト。 データタイプ：オブジェクトのアレイ "inputIndices": [ { Number } ] |
| result.additionalCommittedItems.markers | 内部使用のためのマーカー値のリスト。 データタイプ：アレイ "markers": [] |
| result.additionalCommittedItems.mergedPayloads | この追加 CI の処理中に結合された CMDB IRE 部分的ペイロード \[cmdb_ire_partial_payloads\] テーブルの部分的ペイロードのsys_id値のリスト。 データタイプ：アレイ "mergedPayloadIds": [ "String" ] |
| result.additionalCommittedItems.operation | この追加 CI に対して実行された操作。 可能な値： * 削除:既存の CI がターゲットテーブルから削除されます。 * INSERT:追加の CI が新しいレコードとしてターゲットテーブルに挿入されます。 * NO_CHANGE:追加の CI に対して操作は実行されません。 * 更新:ターゲットテーブルの既存の CI が更新されます。 * UPDATE_WITH_DOWNGRADE:ターゲットテーブルの既存の CI が更新され、そのクラスがより汎用的なクラス (先祖クラス) に変更されます。 * UPDATE_WITH_SWITCH:ターゲットテーブルの既存の CI が更新され、そのクラスが先祖または子孫クラスではない別のクラスに変更されます。 * UPDATE_WITH_UPGRADE:ターゲットテーブルの既存の CI が更新され、そのクラスがより特殊なクラス (子孫クラス) に変更されます。 {#identifyreconcile-POST-queryenhanced__ul_dwt_qwx_glb} データタイプ：文字列 |
| result.additionalCommittedItems.sysId | 識別によってこの追加 CI のSys_idが見つかりました。 注目の値: 不明:この追加の CI の識別に失敗しました。詳細については、「errors」を参照してください。 データタイプ：文字列 |
| result.additionalCommittedItems.warnings | この追加 CI の処理中に発生した警告のリスト。 データタイプ：オブジェクトのアレイ "warnings": [ { "error": "String", "message": "String" } ] |
| result.additionalCommittedItems.warnings.error | この追加 CI の処理中に発生した警告のタイプ。 データタイプ：文字列 |
| result.additionalCommittedItems.warnings.message | この追加 CI の処理中に警告メッセージが表示されました。 データタイプ：文字列 |
| result.additionalCommittedRelations | 要求本文に含まれていない依存関係 CI のリスト 挿入または更新する relations リスト。 データタイプ：オブジェクトのアレイ "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 に対して操作は実行されません。 * 更新:ターゲットテーブルの既存の依存関係 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 識別試行の結果。 可能な値： * 一致:識別に成功しました。識別子ルールテーブルで、指定された属性と完全に一致する一意の CI が見つかりました。 * MULTI_MATCH:エラーで識別に失敗しました。指定された属性と照合したときに、識別子ルールテーブルで重複 CI が見つかりました。 * NO_MATCH:識別に失敗しました。指定された属性に一致する識別子ルールテーブルに CI が見つかりませんでした。 * スキップ:識別は試行されませんでした。この識別子ルールテーブル検索に必要な属性が指定されていないため、ルールは適用されませんでした。 {#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。 注目すべき値: * 不明:この 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 に対して実行された操作。 可能な値： * 削除:既存の CI がターゲットテーブルから削除されます。 * INSERT:CI は新しいレコードとしてターゲットテーブルに挿入されます。 * NO_CHANGE:CI に対して操作は実行されません。 * 更新:ターゲットテーブルの既存の CI が更新されます。 * UPDATE_WITH_DOWNGRADE:ターゲットテーブルの既存の CI が更新され、そのクラスがより汎用的なクラス (先祖クラス) に変更されます。 * UPDATE_WITH_SWITCH:ターゲットテーブルの既存の CI が更新され、そのクラスが先祖または子孫クラスではない別のクラスに変更されます。 * UPDATE_WITH_UPGRADE:ターゲットテーブルの既存の CI が更新され、そのクラスがより特殊なクラス (子孫クラス) に変更されます。 {#identifyreconcile-POST-queryenhanced__ul_jhl_gg5_flb} データタイプ：文字列 |
| result.items.relatedItems | 要求本文 items.lookup アレイからの関連 CI のリスト (テーブル検索 CI)。 データタイプ：オブジェクトのアレイ "relatedItems": [ { "className": "String", "inputIndices": [Array], "markers": [Array], "mergedPayloadIds": [Array], "sysId": "String" } ] |
| result.items.relatedItems.className | 関連アイテムのsys_class_name。 データタイプ：文字列 |
| result.items.relatedItems.inputIndices | この関連アイテムに対応する要求本文の items と items.lookup アレイからの CI およびルックアップアイテムのインデックス値のリスト。 データタイプ：オブジェクトのアレイ "inputIndices": [ { "mainIndex": Number, "subIndex": Number } ] |
| result.items.relatedItems.inputIndices.mainIndex | 関連アイテムの CI 親に対応する要求本文 items アレイのインデックス値。 データタイプ：数値 |
| result.items.relatedItems.inputIndices.subIndex | 関連アイテムに対応する要求本文 items.lookup アレイのインデックス値。 データタイプ：数値 |
| result.items.relatedItems.markers | 内部使用のためのマーカー値のリスト。 データタイプ：アレイ "markers": [] |
| result.items.relatedItems.mergedPayloadIds | 処理中にこの CI に結合された CMDB IRE 部分のペイロード \[cmdb_ire_partial_payloads\] テーブルのエントリーのsys_id値のリスト。 データタイプ：アレイ "mergedPayloadIds": [ "String" ] |
| result.items.relatedSysIds | 要求本文 items.lookup アレイからの関連アイテム (テーブルルックアップアイテム) のsys_id値のリスト。 データタイプ：アレイ 注目すべき値: * null:この関連アイテムのsys_idが特定されませんでした。 {#identifyreconcile-POST-queryenhanced__ul_zs5_f1y_glb} "relatedSysIds": [ Number, Number ] |
| result.items.sysId | 識別によってこの CI のSys_idが見つかりました。 注目すべき値: * 不明:この CI の識別に失敗しました。詳細については、「errors」を参照してください。 {#identifyreconcile-POST-queryenhanced__ul_zz5_5vb_glb} データタイプ：文字列 |
| 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 に対して操作は実行されませんでした。 * 更新:ターゲットテーブルの既存の依存関係 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
          }
        }
      }
    }