---
sourceDocument: Yokohama-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/api-reference

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# API für Identifizierung und Abgleich

# API für Identifizierung und Abgleich {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 83 Minuten Lesedauer

Die Identifizierung und Abgleich Die API stellt Endpunkte bereit, die die Identifizierungs- und Abgleichsmodul (Ire) verwenden, um die Erstellung doppelter Konfigurationselemente (Configuration Items, CIs) zu minimieren und CI-Attribute abzugleichen, indem beim Aktualisieren von nur Informationen aus autorisierten Quellen akzeptiert werden Configuration Management Database (CMDB).

Anwender müssen über die itil- oder Asset-Rolle verfügen, um diese API zu verwenden.

Weitere Informationen zur Ire finden Sie unter [Identifizierungs- und Abgleichsmodul (Ire)](https://www.servicenow.com/docs/access?context=ire&version=yokohama&pubname=yokohama-servicenow-platform&ft:locale=en-US).

## Identifizierung und Abgleich -- POST /now/identifyreconcile {#ariaid-title2}

Fügt Konfigurationselemente (CIs) in ein oder aktualisiert sie CMDBDurch Anwenden von Identifizierungs- und Abgleichsregeln auf die angegebene Nutzlast (Anforderungstext). Verwenden Sie diese API, anstatt zu aktualisieren CMDBDirekt.
Verwenden Sie [Identifizierung und Abgleich -- POST /now/identifyreconcile/query](https://servicenow-prod.fluidtopics.net/E8DTPygR9cjzehPx32EvxQ#identifyreconcile-POST-query "Bestimmt CMDBVorgang (Einfügen/Aktualisieren), der mit der angegebenen Nutzlast (Anforderungstext) ausgeführt werden soll, ohne die Vorgänge in der Datenbank zu bestätigen.")Endpunkt, um die Übermittlung einer Nutzlast an diesen Endpunkt zu simulieren, ohne Änderungen an der Datenbank zu bestätigen.

Verwenden Sie [Identifizierung und Abgleich -- POST /now/identifyreconcile/Enhanced](https://servicenow-prod.fluidtopics.net/E8DTPygR9cjzehPx32EvxQ#identifyreconcile-POST-enhanced "Fügt Konfigurationselemente (CIs) in ein oder aktualisiert sie CMDBDurch Anwenden von Identifizierungs- und Abgleichsregeln auf die angegebene Nutzlast (Anforderungstext). Verwenden Sie diese API, anstatt zu aktualisieren CMDBDirekt.")Endpunkt stattdessen, wenn Sie erweiterte Ire-Optionen angeben müssen. Weitere Informationen zu erweiterten Ire-Optionen finden Sie unter [Identifizierungs- und Abgleichsmodul (Ire)](https://www.servicenow.com/docs/access?context=ire&version=yokohama&pubname=yokohama-servicenow-platform&ft:locale=en-US).

### URL-Format

Versionierte URL: /api/now/{api_Version}/identifyreconcile

Standard-URL: /api/now/identifyreconcile  
Hinweis:  
Verfügbare Versionen werden in angegeben [REST-API-Explorer](https://servicenow-prod.fluidtopics.net/QZyr9s_~V0xB9fqGOlvJ4A "In diesem Tutorial verwenden Sie den REST API Explorer, um zu testen ServiceNowREST-APIs."). Für geskriptete REST-APIs gibt es zusätzliche Versionsinformationen auf [Geskriptetes REST-Service-Formular](https://servicenow-prod.fluidtopics.net/0V9QfkPsOI5r~YAD7CJWCA "Mit der geskripteten REST-API-Funktion können Anwendungsentwickler anwenderdefinierte Webservice-APIs erstellen.").

### Unterstützte Anforderungsparameter

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

| Name | Beschreibung |
|-|-|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Beispiel: <kbd class="ph userinput">v1 </kbd>Oder <kbd class="ph userinput">v2 </kbd>. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge |
[Tabelle : 1. Pfad-Parameter]

{#identifyreconcile-POST__entry__6}

| Name | Beschreibung |
|-|-|
| Sysparm_Data_Source | Quelle der CI-Informationen. Dies muss einer der Auswahlwerte sein, die für das Feld „Discovery_Source" der Tabelle „Konfigurationselement \[cmdb_ci\] definiert sind. Datentyp: Zeichenfolge Standard: Fügen Sie die API-Nutzlast in die Tabelle „unvollständige Nutzlasten" ein. |
[Tabelle : 2. Abfrageparameter]

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

| Name | Beschreibung |
|-|-|
| items | Liste der CIs, die erstellt oder aktualisiert werden sollen. Datentyp: Array von Objekten "items": [ { "className": "String", "internal_id": "String", "lookup": [Array], "related": [Array], "settings": {Object}, "sys_object_source_info": {Object}, "values": {Object} } ] |
| Elements.className | Erforderlich. Der sys_class_Name (Klassen-/Tabellenname) des zu erstellenden oder zu aktualisierenden CI. Dieser Wert kann beliebig sein CMDBTabelle, z. B. cmdb_ci_linux_server oder cmdb_ci_win_server. Datentyp: Zeichenfolge |
| items.internal_id | Eindeutiger Bezeichner für dieses Element in dieser Nutzlast. Kann ein beliebiger Wert sein, muss jedoch innerhalb der Nutzlast eindeutig sein. Datentyp: Zeichenfolge |
| Elemente.Suche | Array von Objekten, in denen jedes Objekt einen suchbasierten Identifizierungsdatensatz beschreibt. Diese Datensätze werden verwendet, um das Konfigurationselement der obersten Ebene basierend auf einer Suchtabelle zu identifizieren, die einen Verweis auf die Tabelle „Konfigurationselement" \[cmdb_ci\] hat. Datentyp: Array aus Objekten "lookup": [ { "className": "String", "internal_id": "String", "sys_object_source_info": {Object}, "values": {Object} } ] |
| Elements.Suche.className | Erforderlich. Der sys_class_Name oder der Klassen-/Tabellenname des CI, das erstellt oder aktualisiert werden soll. Dieser Wert kann beliebig sein CMDBKlasse/Tabelle, z. B. cmdb_Serial_number oder cmdb_ci_network_adapter, oder eine nicht- CMDBHierarchieklasse. Datentyp: Zeichenfolge |
| items.lookup.internal_id | Eindeutiger Bezeichner für diesen Suchdatensatz in dieser Nutzlast. Kann ein beliebiger Wert sein, muss jedoch innerhalb der Nutzlast eindeutig sein. Datentyp: Zeichenfolge |
| items.lookup.sys_object_source_info | Objekt, das einen eindeutigen CI-Bezeichner für eine angegebene Datenquelle beschreibt. Verschiedene Quellen können verschiedene Name-Wert-Paare für dasselbe CI haben. Datentyp: Objekt "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 | Name, der den Feed eindeutig identifiziert, der dieses CI sendet. Verwenden Sie diese Option, wenn die Quelle mehrere Feeds haben kann. Datentyp: Zeichenfolge |
| items.lookup.sys_object_source_info.source_name | Datenquelle für die CI-Informationen. Dieser Wert muss einer der Auswahlwerte sein, die für das Feld „Discovery_Source" der Tabelle „Konfigurationselement \[cmdb_ci\] definiert sind. Datentyp: Zeichenfolge |
| items.lookup.sys_object_source_info.source_native_key | Eindeutiger Schlüssel/ID aus der Quelle für das CI. Kann eine beliebige Zeichenfolge sein, die für das Element eindeutig ist. Datentyp: Zeichenfolge |
| items.lookup.sys_object_source_info.source_recency_timestamp | UTC-Datum und -Uhrzeit, zu der das CI gescannt wurde. Datentyp: Zeichenfolge Format: JJJJ-MM-TT hh:mm:ss |
| Elements.Suche.Werte | Objekt, das Felder für dieses Suchelement als Name/Wert-Paare beschreibt, wobei der Name der Feldname ist. Datentyp: Objekt Feldnamen und -Typen hängen von den vom Anwender ausgewählten Feldern ab, z. B.: "values": { "ip_address": "String", "mac_address": "String", "serial_number": "String", "serial_number_type": "String", "valid": "String" } |
| Elemente.zugehörig | Array von Objekten, in denen jedes Objekt einen Elementdatensatz beschreibt, der erstellt oder aktualisiert werden soll, basierend auf einer zugehörigen Tabelle, die einen Verweis auf das identifizierte CI der obersten Ebene hat. Regeln in der Tabelle „zugehöriger Eintrag" \[cmdb_related_entry\] definieren, welche Art von Datensätzen in diesem Array sein kann. Die zugehörige Tabelle kann die Konfigurationselementtabelle \[cmdb_ci\] erweitern oder nicht. Diese Datensätze werden nicht zur Identifizierung des Konfigurationselements verwendet. Datentyp: Array von Objekten "related": [ { "className": "String", "internal_id": "String", "sys_object_source_info": {Object}, "values": {Object} } ] |
| Elements.related.className | Erforderlich. Der sys_class_Name oder der Klassen-/Tabellenname des zugehörigen Elements, das erstellt oder aktualisiert werden soll. Datentyp: Zeichenfolge |
| items.related.internal_id | Eindeutiger Bezeichner für dieses zugehörige Element in dieser Nutzlast. Kann ein beliebiger Wert sein, muss jedoch innerhalb der Nutzlast eindeutig sein. Datentyp: Zeichenfolge |
| items.related.sys_object_source_info | Objekt, das einen eindeutigen CI-Bezeichner für eine angegebene Datenquelle beschreibt. Verschiedene Quellen können verschiedene Name-Wert-Paare für dasselbe CI haben. Datentyp: Objekt "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 | Name, der den Feed eindeutig identifiziert, der dieses zugehörige Element sendet. Verwenden Sie diese Option, wenn die Quelle mehrere Feeds haben kann. Datentyp: Zeichenfolge |
| items.related.sys_object_source_info.source_name | Datenquelle für die zugehörigen Elementinformationen. Dieser Wert muss einer der Auswahlwerte sein, die für das Feld „Discovery_Source" der Tabelle „Konfigurationselement \[cmdb_ci\] definiert sind. Datentyp: Zeichenfolge |
| items.related.sys_object_source_info.source_native_key | Eindeutiger Schlüssel/ID aus der Quelle für das zugehörige Element. Kann eine beliebige Zeichenfolge sein, die für das Element eindeutig ist. Datentyp: Zeichenfolge |
| items.related.sys_object_source_info.source_recency_timestamp | UTC-Datum und -Uhrzeit, zu der das zugehörige Element gescannt wurde. Datentyp: Zeichenfolge Format: JJJJ-MM-TT hh:mm:ss |
| Elemente.zugehörige.Werte | Objekt, das Felder beschreibt, die für dieses zugehörige Element als Name/Wert-Paare erstellt oder aktualisiert werden sollen, wobei der Name der Feldname ist. Für ein Referenzfeld muss der Wert die referenzierte sys_ID sein Datentyp: Objekt Feldnamen und -Typen hängen von den vom Anwender ausgewählten Feldern ab, z. B.: "values": { "host_name": "String", "ip_address": "String", "name": "String", "os_name": "String", "sys_class_name": "String" } |
| items.settings | Objekt mit Parametern, die die Arten der zulässigen Updates definieren. Datentyp: Objekt "settings": { "skipReclassificationRestrictionRules": Boolean, "updateWithoutDowngrade": Boolean, "updateWithoutSwitch": Boolean, "updateWithoutUpgrade": Boolean } |
| items.settings.skipReclassificationRestrictionRules | Kennzeichnung, die angibt, ob Ire die Ausführung der Reklassifizierungseinschränkungsregel überspringen soll, die der Klasse für das Nutzlastelement entspricht. Gültige Werte: * Wahr: Ausführung der Regel wird übersprungen. * Falsch: Führen Sie die Regel aus. Standard: Falsch |
| items.settings.updateWithoutDowngrade | Kennzeichnung, die angibt, ob Update und Downgrade für dieses CI zulässig sind. Gültige Werte: * Wahr: Aktualisieren Sie das Element, ein Downgrade ist jedoch nicht zulässig. * Falsch: Sowohl Elementaktualisierung als auch Downgrade sind zulässig. Datentyp: Boolescher Wert Standard: Falsch |
| items.settings.updateWithoutSwitch | Kennzeichnung, die angibt, ob dieses CI aktualisiert und seine Klasse gewechselt werden kann. Gültige Werte: * Wahr: Aktualisieren Sie das Element, aber Klassenwechsel ist nicht zulässig. * Falsch: Sowohl Elementaktualisierung als auch Klassenwechsel sind zulässig. Datentyp: Boolescher Wert Standard: Falsch |
| items.settings.updateWithoutUpgrade | Kennzeichnung, die angibt, ob Aktualisierung und Upgrade für dieses CI zulässig sind. Gültige Werte: * Wahr: Aktualisieren Sie das Element, aber ein Upgrade ist nicht zulässig. * Falsch: Elementaktualisierung und Upgrade sind zulässig. Datentyp: Boolescher Wert Standard: Falsch |
| items.sys_object_source_info | Objekt, das einen eindeutigen CI-Bezeichner beschreibt. Datentyp: Objekt "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 | Name, der den Feed eindeutig identifiziert, der dieses CI sendet. Verwenden Sie diese Option, wenn die Quelle mehrere Feeds haben kann. Datentyp: Zeichenfolge |
| items.sys_object_source_info.source_name | Datenquelle für die CI-Informationen. Dieser Wert muss einer der Auswahlwerte sein, die für das Feld „Discovery_Source" der Tabelle „Konfigurationselement \[cmdb_ci\] definiert sind. Datentyp: Zeichenfolge |
| items.sys_object_source_info.source_native_key | Eindeutiger Schlüssel/ID aus der Quelle für das CI. Kann eine beliebige Zeichenfolge sein, die für das Element eindeutig ist. Datentyp: Zeichenfolge |
| items.sys_object_source_info.source_recency_timestamp | UTC-Datum und -Uhrzeit, zu der das CI gescannt wurde. Datentyp: Zeichenfolge Format: JJJJ-MM-TT hh:mm:ss |
| Elemente.Werte | Objekt, das Felder beschreibt, die für dieses CI erstellt oder aktualisiert werden sollen, als Name/Wert-Paare, wobei der Name der Feldname ist. Für ein Referenzfeld muss der Wert die referenzierte sys_ID sein Datentyp: Objekt Feldnamen und -Typen hängen von den vom Anwender ausgewählten Feldern ab, z. B.: "values": { "host_name": "String", "ip_address": "String", "name": "String", "os_name": "String", "sys_class_name": "String" } |
| ReferenceItems | Liste der Referenzen zwischen zwei Elementen in der Nutzlast. Datentyp: Array von Objekten "referenceItems": [ { "referenced": "String", "referencedBy": "String", "referenceField": "String" } ] |
| ReferenzierenElemente.referenziert | Die internal_idDefiniert für das Element, auf das von einem anderen Element verwiesen wird. Datentyp: Zeichenfolge |
| ReferenceItems.referencedBy | Die internal_idDefiniert für das Element, das auf ein anderes Element verweist. Datentyp: Zeichenfolge |
| ReferenceItems.referenceField | Name des Referenzfelds in der Klasse/Tabelle für referencedByElement. Datentyp: Zeichenfolge |
| Beziehungen | Liste der Beziehungen zwischen zwei in der Nutzlast definierten Elementen. Ein Objekt in diesem Array kann eines der zwei Formate verwenden: * Das Objekt kann eine Beziehung zwischen zwei Elementen der obersten Ebene (nur) mit definieren parentUnd childName-Wert-Paare, deren Werte Elementindizes aus der Nutzlast darstellen itemsArray. * Das Objekt kann eine Beziehung zwischen zwei beliebigen Elementen definieren, einschließlich Elementen der obersten Ebene, zugehörigen Elementen oder Suchelementen parent_idUnd child_idSchlüssel-Wert-Paare, wobei Werte darstellen internal_idWerte, die für diese Elemente definiert sind. {#identifyreconcile-POST__ul_s1s_phb_nlb} Datentyp: Array von Objekten "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 | Ganzzahliger Index des CI-Objekts in itemsArray, das das untergeordnete Element in der Beziehung darstellt. Datentyp: Zahl |
| relations.child_id | Die internal_idDes untergeordneten Elements in der Beziehung. Datentyp: Zeichenfolge |
| Beziehungen.übergeordnet | Ganzzahliger Index des CI-Objekts in itemsArray, das das übergeordnete Element in der Beziehung darstellt. Datentyp: Zahl |
| Relations.parent_ID | Die internal_idDes übergeordneten Elements in der Beziehung. Datentyp: Zeichenfolge |
| relations.sys_rel_source_info | Discovery-Quellinformationen für die Beziehung. Für Beziehungen ohne Abhängigkeit befinden sich diese Informationen in der Tabelle „Beziehungsquellen" \[sys_rel_Source\]. Datentyp: Objekt "sys_rel_source_info": { "source_name": "String", "source_feed": "String" } |
| relations.sys_rel_source_info.source_name | Name der Discovery-Quelle. Standard: Discovery-Quelle im API-Methodenparameter übergeben. |
| relations.sys_rel_source_info.source_feed | Jede Zeichenfolge, die eine untergeordnete Discovery/Scan innerhalb der Discovery-Quelle ist. Standard: „UNBEKANNT" wird in der Spalte „Source_Feed" gespeichert, wenn ein Datensatz in der Tabelle „sys_rel_Source" erstellt wird. |
| Beziehungen.Typ | Typ der Beziehung zwischen den übergeordneten und untergeordneten Elementen. Dies muss ein Namensfeldwert aus der CI-Beziehungstyp-Tabelle \[cmdb_rel_type\] sein. Datentyp: Zeichenfolge |
[Tabelle : 3. Anforderungstext-Parameter (XML oder JSON)]

### Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter [Unterstützte REST-API-Header](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#identifyreconcile-POST__entry__102}{#identifyreconcile-POST__accept-JSON-only-entry-RESTAPI}{#identifyreconcile-POST__content_type-JSON-only-entry-RESTAPI}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Nur unterstützt application/json. |
| Inhaltstyp | Datenformat des Anforderungstexts. Nur unterstützt application/json. |
[Tabelle : 4. Anforderungskopfzeilen.]

{#identifyreconcile-POST__entry__108}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 5. Antwort-Header]

### Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST-API verwendet werden, finden Sie unter [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#identifyreconcile-POST__entry__112}{#identifyreconcile-POST__entry-200-status-code}{#identifyreconcile-POST__entry-401-status-code}{#identifyreconcile-POST__entry-500-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 401 | Nicht autorisiert Die Anwenderanmeldeinformationen sind falsch oder wurden nicht übergeben. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Die Antwort enthält zusätzliche Informationen zum Fehler. |
[Tabelle : 6. Statuscodes]

### Antworttext-Parameter (JSON oder 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}

| Name | Beschreibung |
|-|-|
| Ergebnis | Liste der von der Abfrage erzeugten Ergebnisse. Datentyp: Array "result": [ "additionalCommittedItems": [Array], "additionalCommittedRelations": [Array], "items": [Array], "relations": [Array] ] |
| Ergebnis.ZusätzlichKommittedElemente | Liste der CIs, die nicht im Anforderungstext enthalten sind itemsArray, das eingefügt oder aktualisiert werden soll. Datentyp: Array von Objekten "additionalCommittedItems": [ { "className": "String", "errorCount": Number, "identificationAttempts": [Array], "inputIndices": [Array], "markers": [Array], "mergedPayloads": [Array], "operation": "String", "sysId": "String" } ] |
| Ergebnis.additionalCommittedItems.className | Der sys_class_Name dieses zusätzlichen CI. Datentyp: Zeichenfolge |
| Ergebnis.zusätzlichCommittedItems.Fehleranzahl | Anzahl der Fehler, die bei der Verarbeitung dieses zusätzlichen CI aufgetreten sind. Datentyp: Zahl |
| Ergebnis.ZusätzlichCommittedElemente.Fehler | Liste der Fehler, die bei der Verarbeitung dieses zusätzlichen CI aufgetreten sind. Datentyp: Array von Objekten "errors": [ { "error": "String", "message": "String" } ] |
| Ergebnis.zusätzlichCommittedElemente.Fehler.Fehler | Typ des beim Verarbeiten dieses zusätzlichen CI aufgetretenen Fehlers. Datentyp: Zeichenfolge |
| Ergebnis.ZusätzlichCommittedElemente.Fehler.Nachricht | Beim Verarbeiten dieses zusätzlichen CI ist eine Fehlermeldung aufgetreten. Datentyp: Zeichenfolge |
| Ergebnis.ZusätzlichKommittedElemente.IdentifikationVermutungen | Liste der Versuche, dieses zusätzliche CI zu identifizieren. Datentyp: Array von Objekten "identificationAttempts": [ { "attemptResult": "String", "attributes": [Array], "hybridEntryCiAttributes": [Array], "identiferName": "String", "searchOnTable": [Array] } ] |
| Ergebnis.ZusätzlichCommittedElemente.IdentifikationVersuchen.Versuch.Weiterleiten | Ergebnis dieses zusätzlichen CI-Identifizierungsversuchs. Mögliche Werte: * ÜBEREINSTIMMEND: Identifizierung erfolgreich. In der Bezeichnerregeltabelle wurde ein eindeutiges CI gefunden, das genau mit den angegebenen Attributen übereinstimmte. * MULTI_MATCH: Identifizierung mit Fehler fehlgeschlagen. Doppelte CIs wurden in der Bezeichnerregeltabelle beim Abgleich mit den angegebenen Attributen gefunden. * NO_MATCH: Identifizierung fehlgeschlagen. In der Bezeichnerregeltabelle wurde kein CI gefunden, das den angegebenen Attributen entsprach. * ÜBERSPRUNGEN: Identifizierung nicht versucht. Die für diese Bezeichnerregeltabellensuche erforderlichen Attribute wurden nicht angegeben, daher wurde die Regel nicht angewendet. {#identifyreconcile-POST__ul_axc_bxx_glb} Datentyp: Zeichenfolge |
| Ergebnis.ZusätzlichKommittedElemente.IdentifikationAttempts.Attribute | Array von CI-Bezeichnereintragsattributen, die während dieses zusätzlichen CI-Identifizierungsversuchs verwendet werden. Datentyp: Array Attributnamen und -Typen hängen von den Anforderungstext-Daten und dem verwendeten Bezeichner ab, z. B.: "attributes": [ "serial_number": "String", "serial_number_type": "String" ] |
| Ergebnis.ZusätzlichCommittedItems.identificationAttempts.hybridEintragungCiAttribute | Liste der CI-Bezeichnereintragsattribute, die während dieses zusätzlichen CI-Identifizierungsversuchs verwendet werden. Datentyp: Array Attributnamen und -Typen hängen von den Anforderungstext-Daten und dem verwendeten Bezeichner ab, z. B.: "hybridEntryCiAttributes": [ "name": "String", "serial_number": "String" ] |
| Ergebnis.zusätzlichCommittedItems.identificationAttempts.identifierName | Bezeichnerregel, die für diesen zusätzlichen CI-Identifizierungsversuch verwendet wird. Datentyp: Zeichenfolge |
| result.additionalCommittedItems.identificationAttempts.searchOnTable | Name der Tabelle, die für diesen zusätzlichen CI-Identifizierungsversuch gesucht wurde. Datentyp: Zeichenfolge |
| Ergebnis.ZusätzlichCommittedItems.identifierEintragungSysId | SYS_ID für die Bezeichnerregel, die zur Identifizierung dieses zusätzlichen CI verwendet wird. Bedeutende Werte: * Unbekannt: Identifizierung dieses zusätzlichen CI fehlgeschlagen. Details siehe errors. {#identifyreconcile-POST__ul_hlk_gyx_glb} Datentyp: Zeichenfolge |
| result.additionalCommittedItems.inputIndices | Liste der Indexwerte für CIs aus dem Anforderungstext itemsArray, das diesem zusätzlichen CI entspricht. Datentyp: Array von Objekten "inputIndices": [ { Number } ] |
| Ergebnis.ZusätzlichCommittedElemente.Markierungen | Liste der Markerwerte für die interne Verwendung. Datentyp: Array "markers": [] |
| Ergebnis.zusätzlichCommittedItems.mergedNutzlasten | Liste der sys_ID-Werte für Teilnutzlasten aus der Tabelle „Teilnutzlasten für CMDB-Ire \[cmdb_ire_partial_payloads\]", die während der Verarbeitung dieses zusätzlichen CI zusammengeführt wurden. Datentyp: Array "mergedPayloadIds": [ "String" ] |
| Ergebnis.ZusätzlichCommittedElemente.Vorgang | Vorgang, der für dieses zusätzliche CI ausgeführt wird. Mögliche Werte: * LÖSCHEN: Ein vorhandenes CI wird aus der Zieltabelle entfernt. * EINFÜGEN: Das zusätzliche CI wird als neuer Datensatz in die Zieltabelle eingefügt. * NO_CHANGE: Für das zusätzliche CI wird kein Vorgang ausgeführt. * AKTUALISIEREN: Ein vorhandenes CI in der Zieltabelle wird aktualisiert. * UPDATE_WITH_DOWNGRADE: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine generischere Klasse (Vorgängerklasse) geändert. * UPDATE_WITH_SWITCH: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine andere Klasse geändert, die keine Vorgänger- oder untergeordnete Klasse ist. * UPDATE_WITH_UPGRADE: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine speziellere Klasse (untergeordnete Klasse) geändert. {#identifyreconcile-POST__ul_dwt_qwx_glb} Datentyp: Zeichenfolge |
| Ergebnis.zusätzlichCommittedItems.sysId | SYS_ID für dieses zusätzliche CI durch Identifizierung gefunden. Bedeutende Werte: Unbekannt -- Identifizierung dieses zusätzlichen CI fehlgeschlagen. Details siehe errors. Datentyp: Zeichenfolge |
| Ergebnis.ZusätzlichKommittedElemente.Warnungen | Liste der Warnungen, die bei der Verarbeitung dieses zusätzlichen CI aufgetreten sind. Datentyp: Array von Objekten "warnings": [ { "error": "String", "message": "String" } ] |
| Ergebnis.zusätzlichCommittedElemente.Warnungen.Fehler | Typ der Warnung, die bei der Verarbeitung dieses zusätzlichen CI aufgetreten ist. Datentyp: Zeichenfolge |
| Ergebnis.ZusätzlichCommittedElemente.Warnungen.Nachricht | Warnmeldung beim Verarbeiten dieses zusätzlichen CI aufgetreten. Datentyp: Zeichenfolge |
| Ergebnis.ZusätzlichZusammenarbeitenBeziehungen | Liste der abhängigen Beziehungs-CIs, die nicht im Anforderungstext enthalten sind relationsListe zum Einfügen oder Aktualisieren. Datentyp: Array von Objekten "additionalCommittedRelations": [ { "className": "String", "operation": "String", "markers": [Array], "inputIndices": [Array], "mergedPayloadIds": [Array] } ] |
| Ergebnis.ZusätzlichZusammenarbeitenBeziehungen.className | Der sys_class_Name dieses zusätzlichen abhängigen Beziehungs-CI. Nur unterstützter Wert: * cmdb_rel_ci: Die CI-Beziehungstabelle. {#identifyreconcile-POST__ul_bsb_pxx_glb} Datentyp: Zeichenfolge |
| Ergebnis.ZusätzlichCommittedBeziehungen.Fehleranzahl | Anzahl der Fehler, die bei der Verarbeitung dieses zusätzlichen abhängigen Beziehungs-CI aufgetreten sind. Datentyp: Zahl |
| Ergebnis.ZusätzlichZusammenarbeitenBeziehungen.Fehler | Liste der Fehler, die bei der Verarbeitung dieses zusätzlichen abhängigen Beziehungs-CI aufgetreten sind. Datentyp: Array von Objekten "errors": [ { "error": "String", "message": "String" } ] |
| Ergebnis.ZusätzlichZusammenarbeitenBeziehungen.Fehler.Fehler | Typ des beim Verarbeiten dieses zusätzlichen abhängigen Beziehungs-CI aufgetretenen Fehlers. Datentyp: Zeichenfolge |
| Ergebnis.ZusätzlichCommittedBeziehungen.Fehler.Nachricht | Beim Verarbeiten dieses zusätzlichen abhängigen Beziehungs-CI ist eine Fehlermeldung aufgetreten. Datentyp: Zeichenfolge |
| result.additionalCommittedRelations.inputIndices | Liste der Indexwerte für abhängige Beziehungs-CI-Objekte im Anforderungstext relationsArray, das diesem zusätzlichen abhängigen Beziehungs-CI entspricht. Datentyp: Array "inputIndices": [ Number ] |
| Ergebnis.ZusätzlichZusammenarbeitenBeziehungen.Markierungen | Liste der Markerwerte für die interne Verwendung. Datentyp: Array "markers": [] |
| Ergebnis.ZusätzlichCommittedRelations.mergedPayloadIds | Liste der sys_ID-Werte für Teilnutzlasten aus der Tabelle „Teilnutzlasten für CMDB-Ire \[cmdb_ire_partial_payloads\]", die während der Verarbeitung dieses zusätzlichen abhängigen Beziehungs-CI zusammengeführt wurden. Datentyp: Array "mergedPayloadIds": [ "String" ] |
| Ergebnis.ZusätzlichCommittedBeziehungen.Vorgang | Vorgang, der für dieses zusätzliche abhängige Beziehungs-CI ausgeführt wird. Mögliche Werte: * EINFÜGEN: Das abhängige Beziehungs-CI wird als neuer Datensatz in die Zieltabelle eingefügt. * INSERT_AS_INPLETE: Das abhängige Beziehungs-CI wies Fehler auf und wird in die Tabelle „unvollständige Nutzlasten für CMDB-Ire \[cmdb_ire_incomplete_payloads\] eingefügt. * INSERT_AS_PARTIAL: Das abhängige Beziehungs-CI wies Fehler auf und wird in die Tabelle „partielle Ire-Nutzlasten" \[cmdb_ire_partial_payloads\] eingefügt. * NO_CHANGE: Für das abhängige Beziehungs-CI wird kein Vorgang ausgeführt. * AKTUALISIEREN: Ein vorhandenes abhängiges Beziehungs-CI in der Zieltabelle wird aktualisiert. {#identifyreconcile-POST__ul_ltk_vxx_glb} Datentyp: Zeichenfolge |
| result.items | Liste der CIs, die im Anforderungstext enthalten sind itemsArray. Datentyp: Array von Objekten "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 | Liste der zugehörigen CIs (Tabellensuche-CI) aus der Tabelle „partielle Ire-Nutzlasten" \[cmdb_ire_partial_payloads\]. Datentyp: Array von Objekten "additionalRelatedItems": [ { "className": "String", "inputIndices": [Array], "markers": [Array], "mergedPayloadIds": [Array], "sysId": "String" } ] |
| result.items.additionalRelatedItems.className | Der sys_class_Name des zugehörigen Elements. Datentyp: Zeichenfolge |
| result.items.additionalRelatedItems.inputIndices | Liste der Indexwerte für CIs aus dem Anforderungstext itemsArray, das diesem zugehörigen Element entspricht. Datentyp: Array "inputIndices": [ Number ] |
| result.items.additionalRelatedItems.markers | Liste der Markerwerte für die interne Verwendung. Datentyp: Array "markers": [] |
| result.items.additionalRelatedItems.mergedPayloadIds | Liste der sys_ID-Werte für Teilnutzlasten aus der Tabelle „Teilnutzlasten für CMDB-Ire \[cmdb_ire_partial_payloads\]", die während der Verarbeitung dieses zugehörigen Elements zusammengeführt wurden. Datentyp: Array "mergedPayloadIds": [ "String" ] |
| result.items.additionalRelatedItems.sysId | SYS_ID dieses zugehörigen CI. Datentyp: Zeichenfolge |
| result.items.className | SYS_class_Name dieses CI. Datentyp: Zeichenfolge |
| result.items.duplicateLookupIndices | Objekt mit Arrays von Indexwerten für items.lookupArray-Elemente, die auf dasselbe zugehörige CI verweisen. Der Array-Name gibt das erste Element aus dem Anforderungstext an items.lookupArray, das auf ein bestimmtes zugehöriges CI verweist. Seine Werte sind der Satz zusätzlicher Elemente aus demselben Array, die auf dasselbe zugehörige CI verweisen. Datentyp: Objekt Dieses Beispiel zeigt einen Fall, in dem das zweite Element in angezeigt wird items.lookupArray verweist auf dasselbe zugehörige CI als späteres Element aus diesem Array: "duplicateLookupIndices": [ "2": [Array] ] |
| result.items.errorCount | Anzahl der beim Verarbeiten dieses CI aufgetretenen Fehler. Datentyp: Zahl |
| result.items.errors | Liste der Fehler, die bei der Verarbeitung dieses CI aufgetreten sind. Datentyp: Array von Objekten "errors": [ { "error": "String", "message": "String" } ] |
| result.items.errors.error | Typ des beim Verarbeiten dieses CI aufgetretenen Fehlers. Datentyp: Zeichenfolge |
| result.items.errors.message | Beim Verarbeiten dieses CI ist eine Fehlermeldung aufgetreten. Datentyp: Zeichenfolge |
| result.items.identificationAttempts | Liste der Versuche, dieses CI zu identifizieren. Datentyp: Array von Objekten "identificationAttempts": [ { "attemptResult": "String", "attributes": [Array], "hybridEntryCiAttributes": [Array], "identiferName": "String", "searchOnTable": [Array] } ] |
| result.items.identificationAttempts.attemptResult | Ergebnis dieses CI-Identifizierungsversuchs. Mögliche Werte: * ÜBEREINSTIMMEND: Identifizierung erfolgreich. In der Bezeichnerregeltabelle wurde ein eindeutiges CI gefunden, das genau mit den angegebenen Attributen übereinstimmte. * MULTI_MATCH: Identifizierung mit Fehler fehlgeschlagen. Doppelte CIs wurden in der Bezeichnerregeltabelle beim Abgleich mit den angegebenen Attributen gefunden. * NO_MATCH: Identifizierung fehlgeschlagen. In der Bezeichnerregeltabelle wurde kein CI gefunden, das den angegebenen Attributen entsprach. * ÜBERSPRUNGEN: Identifizierung nicht versucht. Die für diese Bezeichnerregeltabellensuche erforderlichen Attribute wurden nicht angegeben, daher wurde die Regel nicht angewendet. {#identifyreconcile-POST__ul_gmw_qn5_flb} Datentyp: Zeichenfolge |
| result.items.identificationAttempts.attributes | Liste der CI-Bezeichnereintragsattribute, die während dieses CI-Identifizierungsversuchs verwendet wurden. Datentyp: Array Attributnamen und -Typen hängen von den Anforderungstext-Daten und dem verwendeten Bezeichner ab, z. B.: "attributes": [ "serial_number": "String", "serial_number_type": "String", ] |
| result.items.identificationAttempts.hybridEntryCiAttributes | Liste der CI-Bezeichnereintragsattribute, die während dieses CI-Identifizierungsversuchs verwendet wurden. Datentyp: Array Attributnamen und -Typen hängen von den Anforderungstext-Daten und dem verwendeten Bezeichner ab, z. B.: "hybridEntryCiAttributes": [ "name": "String", "serial_number": "String" ] |
| result.items.identificationAttempts.identifierName | Bezeichnerregel, die für diesen CI-Identifizierungsversuch verwendet wird. Datentyp: Zeichenfolge |
| result.items.identificationAttempts.searchOnTable | Name der Tabelle, die für diesen CI-Identifizierungsversuch gesucht wurde. Datentyp: Zeichenfolge |
| result.items.identifierEntrySysId | SYS_ID für die Bezeichnerregel, die zur Identifizierung dieses CI verwendet wird. Bedeutende Werte: * Unbekannt: Identifizierung dieses CI fehlgeschlagen. Details finden Sie unter errors. {#identifyreconcile-POST__ul_lzk_rvb_glb} Datentyp: Zeichenfolge |
| result.items.info | Liste zusätzlicher Informationen zur Verarbeitung des Elements. Datentyp: Array von Objekten "info": [ { "code": "String", "message": "String", "ruleSysId": "String" } ] |
| result.items.info.code | Reklassifizierungstyp, der übersprungen wurde. Mögliche Werte: * ÜBERSPRUNGEN_CLASS_SWITCH * SKIPPED_CLASS_DOWNGRADE * ÜBERSPRUNGEN_CLASS_UPGRADE {#identifyreconcile-POST__ul_pb2_dxp_snb} |
| result.items.info.message | Nachricht, die zusätzliche Einblicke in den Grund für das Überspringen der Neuklassifizierung bietet. Datentyp: Zeichenfolge |
| result.items.info.ruleSysId | SYS_ID der Reklassifizierungseinschränkungsregel, die abgeglichen wurde. Gilt nur, wenn Ire die Neuklassifizierung aufgrund der Reklassifizierungseinschränkungsregel überspringt. Dieser Wert ist leer, wenn die Neuklassifizierung aufgrund einer Nutzlast oder einer globalen Kennzeichnung übersprungen wird. Datentyp: Zeichenfolge |
| result.items.inputIndices | Liste der Indexwerte für CIs aus dem Anforderungstext itemsArray, das diesem CI entspricht. Datentyp: Array von Objekten "inputIndices": [ { Number } ] |
| result.items.markers | Liste der Markerwerte für die interne Verwendung. Datentyp: Array "markers": [] |
| result.items.mergedPayloadIds | Liste der sys_ID-Werte für Teilnutzlasten aus der Tabelle „Teilnutzlasten für CMDB-Ire \[cmdb_ire_partial_payloads\]", die während der Verarbeitung dieses CI zusammengeführt wurden. Datentyp: Array "mergedPayloadIds": [ "String" ] |
| result.items.operation | Für dieses CI ausgeführter Vorgang. Mögliche Werte: * LÖSCHEN: Ein vorhandenes CI wird aus der Zieltabelle entfernt. * EINFÜGEN: Das CI wird als neuer Datensatz in die Zieltabelle eingefügt. * NO_CHANGE: Für das CI wird kein Vorgang ausgeführt. * AKTUALISIEREN: Ein vorhandenes CI in der Zieltabelle wird aktualisiert. * UPDATE_WITH_DOWNGRADE: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine generischere Klasse (Vorgängerklasse) geändert. * UPDATE_WITH_SWITCH: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine andere Klasse geändert, die keine Vorgänger- oder untergeordnete Klasse ist. * UPDATE_WITH_UPGRADE: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine speziellere Klasse (untergeordnete Klasse) geändert. {#identifyreconcile-POST__ul_jhl_gg5_flb} Datentyp: Zeichenfolge |
| result.items.relatedItems | Liste der zugehörigen CIs (Tabellensuche-CI) aus dem Anforderungstext items.lookupArray. Datentyp: Array von Objekten "relatedItems": [ { "className": "String", "inputIndices": [Array], "markers": [Array], "mergedPayloadIds": [Array], "sysId": "String" } ] |
| result.items.relatedItems.className | Der sys_class_Name des zugehörigen Elements. Datentyp: Zeichenfolge |
| result.items.relatedItems.inputIndices | Liste der Indexwerte für CIs und Suchelemente aus dem Anforderungstext itemsUnd items.lookupArrays, die diesem zugehörigen Element entsprechen. Datentyp: Array von Objekten "inputIndices": [ { "mainIndex": Number, "subIndex": Number } ] |
| result.items.relatedItems.inputIndices.mainIndex | Indexwert aus dem Anforderungstext itemsArray, das dem übergeordneten CI des zugehörigen Elements entspricht. Datentyp: Zahl |
| result.items.relatedItems.inputIndices.subIndex | Indexwert aus dem Anforderungstext items.lookupArray, das dem zugehörigen Element entspricht. Datentyp: Zahl |
| result.items.relatedItems.markers | Liste der Markerwerte für die interne Verwendung. Datentyp: Array "markers": [] |
| result.items.relatedItems.mergedPayloadIds | Liste der sys_ID-Werte für Einträge in der Tabelle „teilweise Nutzlasten des CMDB-Ire \[cmdb_ire_partial_payloads\]", die während der Verarbeitung mit diesem CI zusammengeführt wurden. Datentyp: Array "mergedPayloadIds": [ "String" ] |
| result.items.relatedSysIds | Liste der sys_ID-Werte für zugehörige Elemente (Tabellensuchelemente) aus dem Anforderungstext items.lookupArray. Datentyp: Array Bedeutende Werte: * Null: Für dieses zugehörige Element wurde keine sys_ID identifiziert. {#identifyreconcile-POST__ul_zs5_f1y_glb} "relatedSysIds": [ Number, Number ] |
| result.items.sysId | SYS_ID für dieses CI durch Identifizierung gefunden. Bedeutende Werte: * Unbekannt: Identifizierung dieses CI fehlgeschlagen. Details siehe errors. {#identifyreconcile-POST__ul_zz5_5vb_glb} Datentyp: Zeichenfolge |
| result.items.warnings | Liste der Warnungen, die bei der Verarbeitung dieses CI aufgetreten sind. Datentyp: Array von Objekten "warnings": [ { "error": "String", "message": "String" } ] |
| result.items.warnings.error | Typ der Warnung, die bei der Verarbeitung dieses CI aufgetreten ist. Datentyp: Zeichenfolge |
| result.items.warnings.message | Warnmeldung beim Verarbeiten dieses CI aufgetreten. Datentyp: Zeichenfolge |
| Ergebnis.logKontextId | Kontext-ID, die für diese Nutzlast gemeldet wurde. Datentyp: Zeichenfolge |
| Ergebnis.Beziehungen | Liste der abhängigen Beziehungs-CIs aus dem Anforderungstext relationsArray. Datentyp: Array von Objekten "relations": [ { "className": "String", "errorCount": Number, "errors": [Array], "inputIndices": [Array], "markers": [Array], "mergedPayloadIds": [Array], "operation": "String", "warnings": [Array] } ] |
| Ergebnis.Beziehungen.Klassenname | Der sys_class_Name dieses abhängigen Beziehungs-CI. Nur unterstützter Wert: * cmdb_rel_ci: Die CI-Beziehungstabelle. {#identifyreconcile-POST__ul_ilx_d1v_flb} Datentyp: Zeichenfolge |
| Ergebnis.Beziehungen.Fehleranzahl | Anzahl der Fehler, die bei der Verarbeitung dieses abhängigen Beziehungs-CI aufgetreten sind. Datentyp: Zahl |
| Ergebnis.Beziehungen.Fehler | Liste der Fehler, die bei der Verarbeitung dieses abhängigen Beziehungs-CI aufgetreten sind. Datentyp: Array von Objekten "errors": [ { "error": "String", "message": "String" } ] |
| Ergebnis.Beziehungen.Fehler.Fehler | Typ des beim Verarbeiten dieses abhängigen Beziehungs-CI aufgetretenen Fehlers. Datentyp: Zeichenfolge |
| Ergebnis.Beziehungen.Fehler.Nachricht | Fehlermeldung beim Verarbeiten dieses abhängigen Beziehungs-CI aufgetreten. Datentyp: Zeichenfolge |
| result.relations.inputIndices | Liste der Indexwerte für die abhängigen Beziehungs-CI-Objekte im Anforderungstext relationsArray, das diesem abhängigen Beziehungs-CI entspricht. Datentyp: Array "inputIndices": [ Number ] |
| Ergebnis.Beziehungen.Markierungen | Liste der Markerwerte für die interne Verwendung. Datentyp: Array "markers": [] |
| Ergebnis.Beziehungen.mergedPayloadIds | Liste der sys_ID-Werte für Teilnutzlasten aus der Tabelle „Teilnutzlasten für CMDB-Ire \[cmdb_ire_partial_payloads\]", die während der Verarbeitung dieses abhängigen Beziehungs-CI zusammengeführt wurden. Datentyp: Array "mergedPayloadIds": [ "String" ] |
| Ergebnis.Beziehungen.Vorgang | Vorgang, der für dieses abhängige Beziehungs-CI ausgeführt wird. Mögliche Werte: * EINFÜGEN: Das abhängige Beziehungs-CI wurde als neuer Datensatz in die Zieltabelle eingefügt. * INSERT_AS_INPLETE: Das abhängige Beziehungs-CI wies Fehler auf und wurde in die Tabelle „unvollständige Nutzlasten für CMDB-Ire" \[cmdb_ire_incomplete_payloads\] eingefügt. * INSERT_AS_PARTIAL: Das abhängige Beziehungs-CI wies Fehler auf und wurde in die Tabelle „partielle Ire-Nutzlasten" \[cmdb_ire_partial_payloads\] eingefügt. * NO_CHANGE: Für das abhängige Beziehungs-CI wurde kein Vorgang ausgeführt. * UPDATE: Ein vorhandenes abhängiges Beziehungs-CI in der Zieltabelle wurde aktualisiert. {#identifyreconcile-POST__ul_qd5_kg5_flb} Datentyp: Zeichenfolge |
| Ergebnis.Beziehungen.Warnungen | Liste der Warnungen, die bei der Verarbeitung dieses abhängigen Beziehungs-CI aufgetreten sind. Datentyp: Array von Objekten "warnings": [ { "error": "String", "message": "String" } ] |
| Ergebnis.Beziehungen.Warnungen.Fehler | Typ der Warnung, die bei der Verarbeitung dieses abhängigen Beziehungs-CI aufgetreten ist. Datentyp: Zeichenfolge |
| Ergebnis.Beziehungen.Warnungen.Nachricht | Warnmeldung beim Verarbeiten dieses abhängigen Beziehungs-CI aufgetreten. Datentyp: Zeichenfolge |
[ ]

### Curl-Anforderung

Übermitteln Sie eine Nutzlast, die einen Linux-Server (mit Seriennummern und Netzwerkadapter-zugehörigen Elementsuchen) und einen IP-Switch mit einer IP-Verbindungsabhängigen Beziehung zwischen ihnen enthält.

    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" \
      }]
    }'

Das Linux-Server-CI wird über eine Hardwareregelsuche nach seinem Namen in der Tabelle „Hardware" \[cmdb_ci_Hardware\] identifiziert und als Update für ein vorhandenes CI in der Tabelle „Linux-Server" \[cmdb_ci_linux_server\] verarbeitet. Der IP-Switch wird ähnlich über eine Hardwareregel-Suche nach seinem Namen in der Hardwaretabelle identifiziert und aktualisiert ein vorhandenes CI in der Tabelle „IP-Switch" \[cmdb_ci_ip_switch\]. Schließlich wird die von der IP-Verbindung abhängige Beziehung zwischen dem Server und dem Switch als neuer Datensatz in die CI-Beziehungstabelle \[cmdb_rel_ci\] eingefügt.

    {
      "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": []
      }
    }

## Identifizierung und Abgleich -- POST /now/identifyreconcile/Enhanced {#ariaid-title3}

Fügt Konfigurationselemente (CIs) in ein oder aktualisiert sie CMDBDurch Anwenden von Identifizierungs- und Abgleichsregeln auf die angegebene Nutzlast (Anforderungstext). Verwenden Sie diese API, anstatt zu aktualisieren CMDBDirekt.
Verwenden Sie [Identifizierung und Abgleich -- POST /now/identifyreconcile/queryEnhanced](https://servicenow-prod.fluidtopics.net/E8DTPygR9cjzehPx32EvxQ#identifyreconcile-POST-queryenhanced "Bestimmt CMDBVorgang (Einfügen/Aktualisieren), der mit der angegebenen Nutzlast (Anforderungstext) ausgeführt werden soll, ohne die Vorgänge in der Datenbank zu bestätigen.")Endpunkt, um die Übermittlung einer Nutzlast an diesen Endpunkt zu simulieren, ohne Änderungen an der Datenbank zu bestätigen.  
Diese Methode ähnelt der [Identifizierung und Abgleich -- POST /now/identifyreconcile](https://servicenow-prod.fluidtopics.net/E8DTPygR9cjzehPx32EvxQ#identifyreconcile-POST "Fügt Konfigurationselemente (CIs) in ein oder aktualisiert sie CMDBDurch Anwenden von Identifizierungs- und Abgleichsregeln auf die angegebene Nutzlast (Anforderungstext). Verwenden Sie diese API, anstatt zu aktualisieren CMDBDirekt.")Methode, fügt jedoch die folgende Funktionalität hinzu:

* Teilnutzlasten
  * Gibt bei einem Element mit einer Warnung oder einem Fehler an, ob ein Elementvorgang „INSERT_AS_PART" oder „INSERT_UNVOLLSTÄNDIG" ist.
  * Gibt die sys_IDs von Teilnutzlasten zurück, die mit vorhandenen Teilnutzlasten zusammengeführt wurden.
  {#identifyreconcile-POST-enhanced__ul_x4s_nvk_xlb}
* Unterstützt die Deduplizierungsfunktion der Nutzlast.
* Generiert eine Zusammenfassung.
{#identifyreconcile-POST-enhanced__ul_scj_jvk_xlb}

### URL-Format

Versionierte URL: /api/now/{api_Version}/identifyreconcile/Enhanced

Standard-URL: /api/now/identifyreconcile/Enhanced  
Hinweis:  
Verfügbare Versionen werden in angegeben [REST-API-Explorer](https://servicenow-prod.fluidtopics.net/QZyr9s_~V0xB9fqGOlvJ4A "In diesem Tutorial verwenden Sie den REST API Explorer, um zu testen ServiceNowREST-APIs."). Für geskriptete REST-APIs gibt es zusätzliche Versionsinformationen auf [Geskriptetes REST-Service-Formular](https://servicenow-prod.fluidtopics.net/0V9QfkPsOI5r~YAD7CJWCA "Mit der geskripteten REST-API-Funktion können Anwendungsentwickler anwenderdefinierte Webservice-APIs erstellen.").

### Unterstützte Anforderungsparameter

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

| Name | Beschreibung |
|-|-|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Beispiel: <kbd class="ph userinput">v1 </kbd>Oder <kbd class="ph userinput">v2 </kbd>. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge |
[Tabelle : 7. Pfad-Parameter]

{#identifyreconcile-POST-enhanced__entry__6}

| Name | Beschreibung |
|-|-|
| Optionen | Kommagetrennte Liste von Name-Wert-Paaren, die erweiterte Ire-Optionen darstellen, die für die Anforderung angewendet werden. So überschreiben Sie beispielsweise die Standardwerte für die partiellen Nutzlasten, partiellen Commits, deduplizierten Nutzlasten und Generieren der erweiterten Ire-Optionen für die Zusammenfassung: `Partial_Payloads:falsch,Partial_Commits:falsch,deduplicate_Payloads:falsch,generate_summary:wahr` Hinweis: Standardmäßig oder wenn partial_payloadsIst auf „wahr" festgelegt, beides partial_commitsUnd deduplicate_payloadsSind aktiviert, auch wenn sie auf „falsch" festgelegt sind, da diese Funktionen für die Funktionalität von Teilnutzlasten von entscheidender Bedeutung sind. Weitere Informationen zu erweiterten Ire-Optionen finden Sie unter [Identifizierungs- und Abgleichsmodul (Ire)](https://www.servicenow.com/docs/access?context=ire&version=yokohama&pubname=yokohama-servicenow-platform&ft:locale=en-US). Gültige Werte für jedes Name-Wert-Paar: * Wahr: Aktivieren Sie diese erweiterte Ire-Option. * Falsch: Deaktivieren Sie diese erweiterte Ire-Option. {#identifyreconcile-POST-enhanced__ul_wc3_mpn_rlb} Datentyp: Zeichenfolge |
| Sysparm_Data_Source | Quelle der CI-Informationen. Dies muss einer der Auswahlwerte sein, die für das Feld „Discovery_Source" der Tabelle „Konfigurationselement \[cmdb_ci\] definiert sind. Datentyp: Zeichenfolge Standard: Fügen Sie die API-Nutzlast in die Tabelle „unvollständige Nutzlasten" ein. |
[Tabelle : 8. Abfrageparameter]

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

| Name | Beschreibung |
|-|-|
| items | Liste der CIs, die erstellt oder aktualisiert werden sollen. Datentyp: Array von Objekten "items": [ { "className": "String", "internal_id": "String", "lookup": [Array], "related": [Array], "settings": {Object}, "sys_object_source_info": {Object}, "values": {Object} } ] |
| Elements.className | Erforderlich. Der sys_class_Name (Klassen-/Tabellenname) des zu erstellenden oder zu aktualisierenden CI. Dieser Wert kann beliebig sein CMDBTabelle, z. B. cmdb_ci_linux_server oder cmdb_ci_win_server. Datentyp: Zeichenfolge |
| items.internal_id | Eindeutiger Bezeichner für dieses Element in dieser Nutzlast. Kann ein beliebiger Wert sein, muss jedoch innerhalb der Nutzlast eindeutig sein. Datentyp: Zeichenfolge |
| Elemente.Suche | Array von Objekten, in denen jedes Objekt einen suchbasierten Identifizierungsdatensatz beschreibt. Diese Datensätze werden verwendet, um das Konfigurationselement der obersten Ebene basierend auf einer Suchtabelle zu identifizieren, die einen Verweis auf die Tabelle „Konfigurationselement" \[cmdb_ci\] hat. Datentyp: Array aus Objekten "lookup": [ { "className": "String", "internal_id": "String", "sys_object_source_info": {Object}, "values": {Object} } ] |
| Elements.Suche.className | Erforderlich. Der sys_class_Name oder der Klassen-/Tabellenname des CI, das erstellt oder aktualisiert werden soll. Dieser Wert kann beliebig sein CMDBKlasse/Tabelle, z. B. cmdb_Serial_number oder cmdb_ci_network_adapter, oder eine nicht- CMDBHierarchieklasse. Datentyp: Zeichenfolge |
| items.lookup.internal_id | Eindeutiger Bezeichner für diesen Suchdatensatz in dieser Nutzlast. Kann ein beliebiger Wert sein, muss jedoch innerhalb der Nutzlast eindeutig sein. Datentyp: Zeichenfolge |
| items.lookup.sys_object_source_info | Objekt, das einen eindeutigen CI-Bezeichner für eine angegebene Datenquelle beschreibt. Verschiedene Quellen können verschiedene Name-Wert-Paare für dasselbe CI haben. Datentyp: Objekt "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 | Name, der den Feed eindeutig identifiziert, der dieses CI sendet. Verwenden Sie diese Option, wenn die Quelle mehrere Feeds haben kann. Datentyp: Zeichenfolge |
| items.lookup.sys_object_source_info.source_name | Datenquelle für die CI-Informationen. Dieser Wert muss einer der Auswahlwerte sein, die für das Feld „Discovery_Source" der Tabelle „Konfigurationselement \[cmdb_ci\] definiert sind. Datentyp: Zeichenfolge |
| items.lookup.sys_object_source_info.source_native_key | Eindeutiger Schlüssel/ID aus der Quelle für das CI. Kann eine beliebige Zeichenfolge sein, die für das Element eindeutig ist. Datentyp: Zeichenfolge |
| items.lookup.sys_object_source_info.source_recency_timestamp | UTC-Datum und -Uhrzeit, zu der das CI gescannt wurde. Datentyp: Zeichenfolge Format: JJJJ-MM-TT hh:mm:ss |
| Elements.Suche.Werte | Objekt, das Felder für dieses Suchelement als Name/Wert-Paare beschreibt, wobei der Name der Feldname ist. Datentyp: Objekt Feldnamen und -Typen hängen von den vom Anwender ausgewählten Feldern ab, z. B.: "values": { "ip_address": "String", "mac_address": "String", "serial_number": "String", "serial_number_type": "String", "valid": "String" } |
| Elemente.zugehörig | Array von Objekten, in denen jedes Objekt einen Elementdatensatz beschreibt, der erstellt oder aktualisiert werden soll, basierend auf einer zugehörigen Tabelle, die einen Verweis auf das identifizierte CI der obersten Ebene hat. Regeln in der Tabelle „zugehöriger Eintrag" \[cmdb_related_entry\] definieren, welche Art von Datensätzen in diesem Array sein kann. Die zugehörige Tabelle kann die Konfigurationselementtabelle \[cmdb_ci\] erweitern oder nicht. Diese Datensätze werden nicht zur Identifizierung des Konfigurationselements verwendet. Datentyp: Array von Objekten "related": [ { "className": "String", "internal_id": "String", "sys_object_source_info": {Object}, "values": {Object} } ] |
| Elements.related.className | Erforderlich. Der sys_class_Name oder der Klassen-/Tabellenname des zugehörigen Elements, das erstellt oder aktualisiert werden soll. Datentyp: Zeichenfolge |
| items.related.internal_id | Eindeutiger Bezeichner für dieses zugehörige Element in dieser Nutzlast. Kann ein beliebiger Wert sein, muss jedoch innerhalb der Nutzlast eindeutig sein. Datentyp: Zeichenfolge |
| items.related.sys_object_source_info | Objekt, das einen eindeutigen CI-Bezeichner für eine angegebene Datenquelle beschreibt. Verschiedene Quellen können verschiedene Name-Wert-Paare für dasselbe CI haben. Datentyp: Objekt "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 | Name, der den Feed eindeutig identifiziert, der dieses zugehörige Element sendet. Verwenden Sie diese Option, wenn die Quelle mehrere Feeds haben kann. Datentyp: Zeichenfolge |
| items.related.sys_object_source_info.source_name | Datenquelle für die zugehörigen Elementinformationen. Dieser Wert muss einer der Auswahlwerte sein, die für das Feld „Discovery_Source" der Tabelle „Konfigurationselement \[cmdb_ci\] definiert sind. Datentyp: Zeichenfolge |
| items.related.sys_object_source_info.source_native_key | Eindeutiger Schlüssel/ID aus der Quelle für das zugehörige Element. Kann eine beliebige Zeichenfolge sein, die für das Element eindeutig ist. Datentyp: Zeichenfolge |
| items.related.sys_object_source_info.source_recency_timestamp | UTC-Datum und -Uhrzeit, zu der das zugehörige Element gescannt wurde. Datentyp: Zeichenfolge Format: JJJJ-MM-TT hh:mm:ss |
| Elemente.zugehörige.Werte | Objekt, das Felder beschreibt, die für dieses zugehörige Element als Name/Wert-Paare erstellt oder aktualisiert werden sollen, wobei der Name der Feldname ist. Für ein Referenzfeld muss der Wert die referenzierte sys_ID sein Datentyp: Objekt Feldnamen und -Typen hängen von den vom Anwender ausgewählten Feldern ab, z. B.: "values": { "host_name": "String", "ip_address": "String", "name": "String", "os_name": "String", "sys_class_name": "String" } |
| items.settings | Objekt mit Parametern, die die Arten der zulässigen Updates definieren. Datentyp: Objekt "settings": { "skipReclassificationRestrictionRules": Boolean, "updateWithoutDowngrade": Boolean, "updateWithoutSwitch": Boolean, "updateWithoutUpgrade": Boolean } |
| items.settings.skipReclassificationRestrictionRules | Kennzeichnung, die angibt, ob Ire die Ausführung der Reklassifizierungseinschränkungsregel überspringen soll, die der Klasse für das Nutzlastelement entspricht. Gültige Werte: * Wahr: Ausführung der Regel wird übersprungen. * Falsch: Führen Sie die Regel aus. Standard: Falsch |
| items.settings.updateWithoutDowngrade | Kennzeichnung, die angibt, ob Update und Downgrade für dieses CI zulässig sind. Gültige Werte: * Wahr: Aktualisieren Sie das Element, ein Downgrade ist jedoch nicht zulässig. * Falsch: Sowohl Elementaktualisierung als auch Downgrade sind zulässig. Datentyp: Boolescher Wert Standard: Falsch |
| items.settings.updateWithoutSwitch | Kennzeichnung, die angibt, ob dieses CI aktualisiert und seine Klasse gewechselt werden kann. Gültige Werte: * Wahr: Aktualisieren Sie das Element, aber Klassenwechsel ist nicht zulässig. * Falsch: Sowohl Elementaktualisierung als auch Klassenwechsel sind zulässig. Datentyp: Boolescher Wert Standard: Falsch |
| items.settings.updateWithoutUpgrade | Kennzeichnung, die angibt, ob Aktualisierung und Upgrade für dieses CI zulässig sind. Gültige Werte: * Wahr: Aktualisieren Sie das Element, aber ein Upgrade ist nicht zulässig. * Falsch: Elementaktualisierung und Upgrade sind zulässig. Datentyp: Boolescher Wert Standard: Falsch |
| items.sys_object_source_info | Objekt, das einen eindeutigen CI-Bezeichner beschreibt. Datentyp: Objekt "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 | Name, der den Feed eindeutig identifiziert, der dieses CI sendet. Verwenden Sie diese Option, wenn die Quelle mehrere Feeds haben kann. Datentyp: Zeichenfolge |
| items.sys_object_source_info.source_name | Datenquelle für die CI-Informationen. Dieser Wert muss einer der Auswahlwerte sein, die für das Feld „Discovery_Source" der Tabelle „Konfigurationselement \[cmdb_ci\] definiert sind. Datentyp: Zeichenfolge |
| items.sys_object_source_info.source_native_key | Eindeutiger Schlüssel/ID aus der Quelle für das CI. Kann eine beliebige Zeichenfolge sein, die für das Element eindeutig ist. Datentyp: Zeichenfolge |
| items.sys_object_source_info.source_recency_timestamp | UTC-Datum und -Uhrzeit, zu der das CI gescannt wurde. Datentyp: Zeichenfolge Format: JJJJ-MM-TT hh:mm:ss |
| Elemente.Werte | Objekt, das Felder beschreibt, die für dieses CI erstellt oder aktualisiert werden sollen, als Name/Wert-Paare, wobei der Name der Feldname ist. Für ein Referenzfeld muss der Wert die referenzierte sys_ID sein Datentyp: Objekt Feldnamen und -Typen hängen von den vom Anwender ausgewählten Feldern ab, z. B.: "values": { "host_name": "String", "ip_address": "String", "name": "String", "os_name": "String", "sys_class_name": "String" } |
| ReferenceItems | Liste der Referenzen zwischen zwei Elementen in der Nutzlast. Datentyp: Array von Objekten "referenceItems": [ { "referenced": "String", "referencedBy": "String", "referenceField": "String" } ] |
| ReferenzierenElemente.referenziert | Die internal_idDefiniert für das Element, auf das von einem anderen Element verwiesen wird. Datentyp: Zeichenfolge |
| ReferenceItems.referencedBy | Die internal_idDefiniert für das Element, das auf ein anderes Element verweist. Datentyp: Zeichenfolge |
| ReferenceItems.referenceField | Name des Referenzfelds in der Klasse/Tabelle für referencedByElement. Datentyp: Zeichenfolge |
| Beziehungen | Liste der Beziehungen zwischen zwei in der Nutzlast definierten Elementen. Ein Objekt in diesem Array kann eines der zwei Formate verwenden: * Das Objekt kann eine Beziehung zwischen zwei Elementen der obersten Ebene (nur) mit definieren parentUnd childName-Wert-Paare, deren Werte Elementindizes aus der Nutzlast darstellen itemsArray. * Das Objekt kann eine Beziehung zwischen zwei beliebigen Elementen definieren, einschließlich Elementen der obersten Ebene, zugehörigen Elementen oder Suchelementen parent_idUnd child_idSchlüssel-Wert-Paare, wobei Werte darstellen internal_idWerte, die für diese Elemente definiert sind. {#identifyreconcile-POST-enhanced__ul_s1s_phb_nlb} Datentyp: Array von Objekten "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 | Ganzzahliger Index des CI-Objekts in itemsArray, das das untergeordnete Element in der Beziehung darstellt. Datentyp: Zahl |
| relations.child_id | Die internal_idDes untergeordneten Elements in der Beziehung. Datentyp: Zeichenfolge |
| Beziehungen.übergeordnet | Ganzzahliger Index des CI-Objekts in itemsArray, das das übergeordnete Element in der Beziehung darstellt. Datentyp: Zahl |
| Relations.parent_ID | Die internal_idDes übergeordneten Elements in der Beziehung. Datentyp: Zeichenfolge |
| relations.sys_rel_source_info | Discovery-Quellinformationen für die Beziehung. Für Beziehungen ohne Abhängigkeit befinden sich diese Informationen in der Tabelle „Beziehungsquellen" \[sys_rel_Source\]. Datentyp: Objekt "sys_rel_source_info": { "source_name": "String", "source_feed": "String" } |
| relations.sys_rel_source_info.source_name | Name der Discovery-Quelle. Standard: Discovery-Quelle im API-Methodenparameter übergeben. |
| relations.sys_rel_source_info.source_feed | Jede Zeichenfolge, die eine untergeordnete Discovery/Scan innerhalb der Discovery-Quelle ist. Standard: „UNBEKANNT" wird in der Spalte „Source_Feed" gespeichert, wenn ein Datensatz in der Tabelle „sys_rel_Source" erstellt wird. |
| Beziehungen.Typ | Typ der Beziehung zwischen den übergeordneten und untergeordneten Elementen. Dies muss ein Namensfeldwert aus der CI-Beziehungstyp-Tabelle \[cmdb_rel_type\] sein. Datentyp: Zeichenfolge |
[Tabelle : 9. Anforderungstext-Parameter (XML oder JSON)]

{#identifyreconcile-POST-enhanced__table_idz_wyn_rlb}

### Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter [Unterstützte REST-API-Header](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#identifyreconcile-POST-enhanced__entry__104}{#identifyreconcile-POST-enhanced__accept-JSON-only-entry-RESTAPI}{#identifyreconcile-POST-enhanced__content_type-JSON-only-entry-RESTAPI}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Nur unterstützt application/json. |
| Inhaltstyp | Datenformat des Anforderungstexts. Nur unterstützt application/json. |
[Tabelle : 10. Anforderungskopfzeilen.]

{#identifyreconcile-POST-enhanced__entry__110}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 11. Antwort-Header]

### Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST-API verwendet werden, finden Sie unter [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#identifyreconcile-POST-enhanced__entry__114}{#identifyreconcile-POST-enhanced__entry-200-status-code}{#identifyreconcile-POST-enhanced__entry-401-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 401 | Nicht autorisiert Die Anwenderanmeldeinformationen sind falsch oder wurden nicht übergeben. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Fehlermeldungsdetail „Block \[...\] Ist kein gültiger Eintrag" gibt an, dass optionsAbfrageparameter weist nicht das richtige Name-Wert-Paarformat auf. Beispiel: Geben Sie an optionsParameter von `Teilweise `Erstellt einen Statuscode 500 mit „Block \[teilweise\] ist kein gültiger Eintrag" im Nachrichtendetail. |
[Tabelle : 12. Statuscodes]

### Antworttext-Parameter (JSON oder 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}

| Name | Beschreibung |
|-|-|
| Ergebnis | Liste der von der Abfrage erzeugten Ergebnisse. Datentyp: Array "result": [ "additionalCommittedItems": [Array], "additionalCommittedRelations": [Array], "items": [Array], "relations": [Array] ] |
| Ergebnis.ZusätzlichKommittedElemente | Liste der CIs, die nicht im Anforderungstext enthalten sind itemsArray, das eingefügt oder aktualisiert werden soll. Datentyp: Array von Objekten "additionalCommittedItems": [ { "className": "String", "errorCount": Number, "identificationAttempts": [Array], "inputIndices": [Array], "markers": [Array], "mergedPayloads": [Array], "operation": "String", "sysId": "String" } ] |
| Ergebnis.additionalCommittedItems.className | Der sys_class_Name dieses zusätzlichen CI. Datentyp: Zeichenfolge |
| Ergebnis.zusätzlichCommittedItems.Fehleranzahl | Anzahl der Fehler, die bei der Verarbeitung dieses zusätzlichen CI aufgetreten sind. Datentyp: Zahl |
| Ergebnis.ZusätzlichCommittedElemente.Fehler | Liste der Fehler, die bei der Verarbeitung dieses zusätzlichen CI aufgetreten sind. Datentyp: Array von Objekten "errors": [ { "error": "String", "message": "String" } ] |
| Ergebnis.zusätzlichCommittedElemente.Fehler.Fehler | Typ des beim Verarbeiten dieses zusätzlichen CI aufgetretenen Fehlers. Datentyp: Zeichenfolge |
| Ergebnis.ZusätzlichCommittedElemente.Fehler.Nachricht | Beim Verarbeiten dieses zusätzlichen CI ist eine Fehlermeldung aufgetreten. Datentyp: Zeichenfolge |
| Ergebnis.ZusätzlichKommittedElemente.IdentifikationVermutungen | Liste der Versuche, dieses zusätzliche CI zu identifizieren. Datentyp: Array von Objekten "identificationAttempts": [ { "attemptResult": "String", "attributes": [Array], "hybridEntryCiAttributes": [Array], "identiferName": "String", "searchOnTable": [Array] } ] |
| Ergebnis.ZusätzlichCommittedElemente.IdentifikationVersuchen.Versuch.Weiterleiten | Ergebnis dieses zusätzlichen CI-Identifizierungsversuchs. Mögliche Werte: * ÜBEREINSTIMMEND: Identifizierung erfolgreich. In der Bezeichnerregeltabelle wurde ein eindeutiges CI gefunden, das genau mit den angegebenen Attributen übereinstimmte. * MULTI_MATCH: Identifizierung mit Fehler fehlgeschlagen. Doppelte CIs wurden in der Bezeichnerregeltabelle beim Abgleich mit den angegebenen Attributen gefunden. * NO_MATCH: Identifizierung fehlgeschlagen. In der Bezeichnerregeltabelle wurde kein CI gefunden, das den angegebenen Attributen entsprach. * ÜBERSPRUNGEN: Identifizierung nicht versucht. Die für diese Bezeichnerregeltabellensuche erforderlichen Attribute wurden nicht angegeben, daher wurde die Regel nicht angewendet. {#identifyreconcile-POST-enhanced__ul_axc_bxx_glb} Datentyp: Zeichenfolge |
| Ergebnis.ZusätzlichKommittedElemente.IdentifikationAttempts.Attribute | Array von CI-Bezeichnereintragsattributen, die während dieses zusätzlichen CI-Identifizierungsversuchs verwendet werden. Datentyp: Array Attributnamen und -Typen hängen von den Anforderungstext-Daten und dem verwendeten Bezeichner ab, z. B.: "attributes": [ "serial_number": "String", "serial_number_type": "String" ] |
| Ergebnis.ZusätzlichCommittedItems.identificationAttempts.hybridEintragungCiAttribute | Liste der CI-Bezeichnereintragsattribute, die während dieses zusätzlichen CI-Identifizierungsversuchs verwendet werden. Datentyp: Array Attributnamen und -Typen hängen von den Anforderungstext-Daten und dem verwendeten Bezeichner ab, z. B.: "hybridEntryCiAttributes": [ "name": "String", "serial_number": "String" ] |
| Ergebnis.zusätzlichCommittedItems.identificationAttempts.identifierName | Bezeichnerregel, die für diesen zusätzlichen CI-Identifizierungsversuch verwendet wird. Datentyp: Zeichenfolge |
| result.additionalCommittedItems.identificationAttempts.searchOnTable | Name der Tabelle, die für diesen zusätzlichen CI-Identifizierungsversuch gesucht wurde. Datentyp: Zeichenfolge |
| Ergebnis.ZusätzlichCommittedItems.identifierEintragungSysId | SYS_ID für die Bezeichnerregel, die zur Identifizierung dieses zusätzlichen CI verwendet wird. Bedeutende Werte: * Unbekannt: Identifizierung dieses zusätzlichen CI fehlgeschlagen. Details siehe errors. {#identifyreconcile-POST-enhanced__ul_hlk_gyx_glb} Datentyp: Zeichenfolge |
| result.additionalCommittedItems.inputIndices | Liste der Indexwerte für CIs aus dem Anforderungstext itemsArray, das diesem zusätzlichen CI entspricht. Datentyp: Array von Objekten "inputIndices": [ { Number } ] |
| Ergebnis.ZusätzlichCommittedElemente.Markierungen | Liste der Markerwerte für die interne Verwendung. Datentyp: Array "markers": [] |
| Ergebnis.zusätzlichCommittedItems.mergedNutzlasten | Liste der sys_ID-Werte für Teilnutzlasten aus der Tabelle „Teilnutzlasten für CMDB-Ire \[cmdb_ire_partial_payloads\]", die während der Verarbeitung dieses zusätzlichen CI zusammengeführt wurden. Datentyp: Array "mergedPayloadIds": [ "String" ] |
| Ergebnis.ZusätzlichCommittedElemente.Vorgang | Vorgang, der für dieses zusätzliche CI ausgeführt wird. Mögliche Werte: * LÖSCHEN: Ein vorhandenes CI wird aus der Zieltabelle entfernt. * EINFÜGEN: Das zusätzliche CI wird als neuer Datensatz in die Zieltabelle eingefügt. * NO_CHANGE: Für das zusätzliche CI wird kein Vorgang ausgeführt. * AKTUALISIEREN: Ein vorhandenes CI in der Zieltabelle wird aktualisiert. * UPDATE_WITH_DOWNGRADE: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine generischere Klasse (Vorgängerklasse) geändert. * UPDATE_WITH_SWITCH: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine andere Klasse geändert, die keine Vorgänger- oder untergeordnete Klasse ist. * UPDATE_WITH_UPGRADE: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine speziellere Klasse (untergeordnete Klasse) geändert. {#identifyreconcile-POST-enhanced__ul_dwt_qwx_glb} Datentyp: Zeichenfolge |
| Ergebnis.zusätzlichCommittedItems.sysId | SYS_ID für dieses zusätzliche CI durch Identifizierung gefunden. Bedeutende Werte: Unbekannt -- Identifizierung dieses zusätzlichen CI fehlgeschlagen. Details siehe errors. Datentyp: Zeichenfolge |
| Ergebnis.ZusätzlichKommittedElemente.Warnungen | Liste der Warnungen, die bei der Verarbeitung dieses zusätzlichen CI aufgetreten sind. Datentyp: Array von Objekten "warnings": [ { "error": "String", "message": "String" } ] |
| Ergebnis.zusätzlichCommittedElemente.Warnungen.Fehler | Typ der Warnung, die bei der Verarbeitung dieses zusätzlichen CI aufgetreten ist. Datentyp: Zeichenfolge |
| Ergebnis.ZusätzlichCommittedElemente.Warnungen.Nachricht | Warnmeldung beim Verarbeiten dieses zusätzlichen CI aufgetreten. Datentyp: Zeichenfolge |
| Ergebnis.ZusätzlichZusammenarbeitenBeziehungen | Liste der abhängigen Beziehungs-CIs, die nicht im Anforderungstext enthalten sind relationsListe zum Einfügen oder Aktualisieren. Datentyp: Array von Objekten "additionalCommittedRelations": [ { "className": "String", "operation": "String", "markers": [Array], "inputIndices": [Array], "mergedPayloadIds": [Array] } ] |
| Ergebnis.ZusätzlichZusammenarbeitenBeziehungen.className | Der sys_class_Name dieses zusätzlichen abhängigen Beziehungs-CI. Nur unterstützter Wert: * cmdb_rel_ci: Die CI-Beziehungstabelle. {#identifyreconcile-POST-enhanced__ul_bsb_pxx_glb} Datentyp: Zeichenfolge |
| Ergebnis.ZusätzlichCommittedBeziehungen.Fehleranzahl | Anzahl der Fehler, die bei der Verarbeitung dieses zusätzlichen abhängigen Beziehungs-CI aufgetreten sind. Datentyp: Zahl |
| Ergebnis.ZusätzlichZusammenarbeitenBeziehungen.Fehler | Liste der Fehler, die bei der Verarbeitung dieses zusätzlichen abhängigen Beziehungs-CI aufgetreten sind. Datentyp: Array von Objekten "errors": [ { "error": "String", "message": "String" } ] |
| Ergebnis.ZusätzlichZusammenarbeitenBeziehungen.Fehler.Fehler | Typ des beim Verarbeiten dieses zusätzlichen abhängigen Beziehungs-CI aufgetretenen Fehlers. Datentyp: Zeichenfolge |
| Ergebnis.ZusätzlichCommittedBeziehungen.Fehler.Nachricht | Beim Verarbeiten dieses zusätzlichen abhängigen Beziehungs-CI ist eine Fehlermeldung aufgetreten. Datentyp: Zeichenfolge |
| result.additionalCommittedRelations.inputIndices | Liste der Indexwerte für abhängige Beziehungs-CI-Objekte im Anforderungstext relationsArray, das diesem zusätzlichen abhängigen Beziehungs-CI entspricht. Datentyp: Array "inputIndices": [ Number ] |
| Ergebnis.ZusätzlichZusammenarbeitenBeziehungen.Markierungen | Liste der Markerwerte für die interne Verwendung. Datentyp: Array "markers": [] |
| Ergebnis.ZusätzlichCommittedRelations.mergedPayloadIds | Liste der sys_ID-Werte für Teilnutzlasten aus der Tabelle „Teilnutzlasten für CMDB-Ire \[cmdb_ire_partial_payloads\]", die während der Verarbeitung dieses zusätzlichen abhängigen Beziehungs-CI zusammengeführt wurden. Datentyp: Array "mergedPayloadIds": [ "String" ] |
| Ergebnis.ZusätzlichCommittedBeziehungen.Vorgang | Vorgang, der für dieses zusätzliche abhängige Beziehungs-CI ausgeführt wird. Mögliche Werte: * EINFÜGEN: Das abhängige Beziehungs-CI wird als neuer Datensatz in die Zieltabelle eingefügt. * INSERT_AS_INPLETE: Das abhängige Beziehungs-CI wies Fehler auf und wird in die Tabelle „unvollständige Nutzlasten für CMDB-Ire \[cmdb_ire_incomplete_payloads\] eingefügt. * INSERT_AS_PARTIAL: Das abhängige Beziehungs-CI wies Fehler auf und wird in die Tabelle „partielle Ire-Nutzlasten" \[cmdb_ire_partial_payloads\] eingefügt. * NO_CHANGE: Für das abhängige Beziehungs-CI wird kein Vorgang ausgeführt. * AKTUALISIEREN: Ein vorhandenes abhängiges Beziehungs-CI in der Zieltabelle wird aktualisiert. {#identifyreconcile-POST-enhanced__ul_ltk_vxx_glb} Datentyp: Zeichenfolge |
| result.items | Liste der CIs, die im Anforderungstext enthalten sind itemsArray. Datentyp: Array von Objekten "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 | Liste der zugehörigen CIs (Tabellensuche-CI) aus der Tabelle „partielle Ire-Nutzlasten" \[cmdb_ire_partial_payloads\]. Datentyp: Array von Objekten "additionalRelatedItems": [ { "className": "String", "inputIndices": [Array], "markers": [Array], "mergedPayloadIds": [Array], "sysId": "String" } ] |
| result.items.additionalRelatedItems.className | Der sys_class_Name des zugehörigen Elements. Datentyp: Zeichenfolge |
| result.items.additionalRelatedItems.inputIndices | Liste der Indexwerte für CIs aus dem Anforderungstext itemsArray, das diesem zugehörigen Element entspricht. Datentyp: Array "inputIndices": [ Number ] |
| result.items.additionalRelatedItems.markers | Liste der Markerwerte für die interne Verwendung. Datentyp: Array "markers": [] |
| result.items.additionalRelatedItems.mergedPayloadIds | Liste der sys_ID-Werte für Teilnutzlasten aus der Tabelle „Teilnutzlasten für CMDB-Ire \[cmdb_ire_partial_payloads\]", die während der Verarbeitung dieses zugehörigen Elements zusammengeführt wurden. Datentyp: Array "mergedPayloadIds": [ "String" ] |
| result.items.additionalRelatedItems.sysId | SYS_ID dieses zugehörigen CI. Datentyp: Zeichenfolge |
| result.items.className | SYS_class_Name dieses CI. Datentyp: Zeichenfolge |
| result.items.duplicateLookupIndices | Objekt mit Arrays von Indexwerten für items.lookupArray-Elemente, die auf dasselbe zugehörige CI verweisen. Der Array-Name gibt das erste Element aus dem Anforderungstext an items.lookupArray, das auf ein bestimmtes zugehöriges CI verweist. Seine Werte sind der Satz zusätzlicher Elemente aus demselben Array, die auf dasselbe zugehörige CI verweisen. Datentyp: Objekt Dieses Beispiel zeigt einen Fall, in dem das zweite Element in angezeigt wird items.lookupArray verweist auf dasselbe zugehörige CI als späteres Element aus diesem Array: "duplicateLookupIndices": [ "2": [Array] ] |
| result.items.errorCount | Anzahl der beim Verarbeiten dieses CI aufgetretenen Fehler. Datentyp: Zahl |
| result.items.errors | Liste der Fehler, die bei der Verarbeitung dieses CI aufgetreten sind. Datentyp: Array von Objekten "errors": [ { "error": "String", "message": "String" } ] |
| result.items.errors.error | Typ des beim Verarbeiten dieses CI aufgetretenen Fehlers. Datentyp: Zeichenfolge |
| result.items.errors.message | Beim Verarbeiten dieses CI ist eine Fehlermeldung aufgetreten. Datentyp: Zeichenfolge |
| result.items.identificationAttempts | Liste der Versuche, dieses CI zu identifizieren. Datentyp: Array von Objekten "identificationAttempts": [ { "attemptResult": "String", "attributes": [Array], "hybridEntryCiAttributes": [Array], "identiferName": "String", "searchOnTable": [Array] } ] |
| result.items.identificationAttempts.attemptResult | Ergebnis dieses CI-Identifizierungsversuchs. Mögliche Werte: * ÜBEREINSTIMMEND: Identifizierung erfolgreich. In der Bezeichnerregeltabelle wurde ein eindeutiges CI gefunden, das genau mit den angegebenen Attributen übereinstimmte. * MULTI_MATCH: Identifizierung mit Fehler fehlgeschlagen. Doppelte CIs wurden in der Bezeichnerregeltabelle beim Abgleich mit den angegebenen Attributen gefunden. * NO_MATCH: Identifizierung fehlgeschlagen. In der Bezeichnerregeltabelle wurde kein CI gefunden, das den angegebenen Attributen entsprach. * ÜBERSPRUNGEN: Identifizierung nicht versucht. Die für diese Bezeichnerregeltabellensuche erforderlichen Attribute wurden nicht angegeben, daher wurde die Regel nicht angewendet. {#identifyreconcile-POST-enhanced__ul_gmw_qn5_flb} Datentyp: Zeichenfolge |
| result.items.identificationAttempts.attributes | Liste der CI-Bezeichnereintragsattribute, die während dieses CI-Identifizierungsversuchs verwendet wurden. Datentyp: Array Attributnamen und -Typen hängen von den Anforderungstext-Daten und dem verwendeten Bezeichner ab, z. B.: "attributes": [ "serial_number": "String", "serial_number_type": "String", ] |
| result.items.identificationAttempts.hybridEntryCiAttributes | Liste der CI-Bezeichnereintragsattribute, die während dieses CI-Identifizierungsversuchs verwendet wurden. Datentyp: Array Attributnamen und -Typen hängen von den Anforderungstext-Daten und dem verwendeten Bezeichner ab, z. B.: "hybridEntryCiAttributes": [ "name": "String", "serial_number": "String" ] |
| result.items.identificationAttempts.identifierName | Bezeichnerregel, die für diesen CI-Identifizierungsversuch verwendet wird. Datentyp: Zeichenfolge |
| result.items.identificationAttempts.searchOnTable | Name der Tabelle, die für diesen CI-Identifizierungsversuch gesucht wurde. Datentyp: Zeichenfolge |
| result.items.identifierEntrySysId | SYS_ID für die Bezeichnerregel, die zur Identifizierung dieses CI verwendet wird. Bedeutende Werte: * Unbekannt: Identifizierung dieses CI fehlgeschlagen. Details finden Sie unter errors. {#identifyreconcile-POST-enhanced__ul_lzk_rvb_glb} Datentyp: Zeichenfolge |
| result.items.info | Liste zusätzlicher Informationen zur Verarbeitung des Elements. Datentyp: Array von Objekten "info": [ { "code": "String", "message": "String", "ruleSysId": "String" } ] |
| result.items.info.code | Reklassifizierungstyp, der übersprungen wurde. Mögliche Werte: * ÜBERSPRUNGEN_CLASS_SWITCH * SKIPPED_CLASS_DOWNGRADE * ÜBERSPRUNGEN_CLASS_UPGRADE {#identifyreconcile-POST-enhanced__ul_pb2_dxp_snb} |
| result.items.info.message | Nachricht, die zusätzliche Einblicke in den Grund für das Überspringen der Neuklassifizierung bietet. Datentyp: Zeichenfolge |
| result.items.info.ruleSysId | SYS_ID der Reklassifizierungseinschränkungsregel, die abgeglichen wurde. Gilt nur, wenn Ire die Neuklassifizierung aufgrund der Reklassifizierungseinschränkungsregel überspringt. Dieser Wert ist leer, wenn die Neuklassifizierung aufgrund einer Nutzlast oder einer globalen Kennzeichnung übersprungen wird. Datentyp: Zeichenfolge |
| result.items.inputIndices | Liste der Indexwerte für CIs aus dem Anforderungstext itemsArray, das diesem CI entspricht. Datentyp: Array von Objekten "inputIndices": [ { Number } ] |
| result.items.markers | Liste der Markerwerte für die interne Verwendung. Datentyp: Array "markers": [] |
| result.items.mergedPayloadIds | Liste der sys_ID-Werte für Teilnutzlasten aus der Tabelle „Teilnutzlasten für CMDB-Ire \[cmdb_ire_partial_payloads\]", die während der Verarbeitung dieses CI zusammengeführt wurden. Datentyp: Array "mergedPayloadIds": [ "String" ] |
| result.items.operation | Für dieses CI ausgeführter Vorgang. Mögliche Werte: * LÖSCHEN: Ein vorhandenes CI wird aus der Zieltabelle entfernt. * EINFÜGEN: Das CI wird als neuer Datensatz in die Zieltabelle eingefügt. * NO_CHANGE: Für das CI wird kein Vorgang ausgeführt. * AKTUALISIEREN: Ein vorhandenes CI in der Zieltabelle wird aktualisiert. * UPDATE_WITH_DOWNGRADE: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine generischere Klasse (Vorgängerklasse) geändert. * UPDATE_WITH_SWITCH: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine andere Klasse geändert, die keine Vorgänger- oder untergeordnete Klasse ist. * UPDATE_WITH_UPGRADE: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine speziellere Klasse (untergeordnete Klasse) geändert. {#identifyreconcile-POST-enhanced__ul_jhl_gg5_flb} Datentyp: Zeichenfolge |
| result.items.relatedItems | Liste der zugehörigen CIs (Tabellensuche-CI) aus dem Anforderungstext items.lookupArray. Datentyp: Array von Objekten "relatedItems": [ { "className": "String", "inputIndices": [Array], "markers": [Array], "mergedPayloadIds": [Array], "sysId": "String" } ] |
| result.items.relatedItems.className | Der sys_class_Name des zugehörigen Elements. Datentyp: Zeichenfolge |
| result.items.relatedItems.inputIndices | Liste der Indexwerte für CIs und Suchelemente aus dem Anforderungstext itemsUnd items.lookupArrays, die diesem zugehörigen Element entsprechen. Datentyp: Array von Objekten "inputIndices": [ { "mainIndex": Number, "subIndex": Number } ] |
| result.items.relatedItems.inputIndices.mainIndex | Indexwert aus dem Anforderungstext itemsArray, das dem übergeordneten CI des zugehörigen Elements entspricht. Datentyp: Zahl |
| result.items.relatedItems.inputIndices.subIndex | Indexwert aus dem Anforderungstext items.lookupArray, das dem zugehörigen Element entspricht. Datentyp: Zahl |
| result.items.relatedItems.markers | Liste der Markerwerte für die interne Verwendung. Datentyp: Array "markers": [] |
| result.items.relatedItems.mergedPayloadIds | Liste der sys_ID-Werte für Einträge in der Tabelle „teilweise Nutzlasten des CMDB-Ire \[cmdb_ire_partial_payloads\]", die während der Verarbeitung mit diesem CI zusammengeführt wurden. Datentyp: Array "mergedPayloadIds": [ "String" ] |
| result.items.relatedSysIds | Liste der sys_ID-Werte für zugehörige Elemente (Tabellensuchelemente) aus dem Anforderungstext items.lookupArray. Datentyp: Array Bedeutende Werte: * Null: Für dieses zugehörige Element wurde keine sys_ID identifiziert. {#identifyreconcile-POST-enhanced__ul_zs5_f1y_glb} "relatedSysIds": [ Number, Number ] |
| result.items.sysId | SYS_ID für dieses CI durch Identifizierung gefunden. Bedeutende Werte: * Unbekannt: Identifizierung dieses CI fehlgeschlagen. Details siehe errors. {#identifyreconcile-POST-enhanced__ul_zz5_5vb_glb} Datentyp: Zeichenfolge |
| result.items.warnings | Liste der Warnungen, die bei der Verarbeitung dieses CI aufgetreten sind. Datentyp: Array von Objekten "warnings": [ { "error": "String", "message": "String" } ] |
| result.items.warnings.error | Typ der Warnung, die bei der Verarbeitung dieses CI aufgetreten ist. Datentyp: Zeichenfolge |
| result.items.warnings.message | Warnmeldung beim Verarbeiten dieses CI aufgetreten. Datentyp: Zeichenfolge |
| Ergebnis.logKontextId | Kontext-ID, die für diese Nutzlast gemeldet wurde. Datentyp: Zeichenfolge |
| Ergebnis.Beziehungen | Liste der abhängigen Beziehungs-CIs aus dem Anforderungstext relationsArray. Datentyp: Array von Objekten "relations": [ { "className": "String", "errorCount": Number, "errors": [Array], "inputIndices": [Array], "markers": [Array], "mergedPayloadIds": [Array], "operation": "String", "warnings": [Array] } ] |
| Ergebnis.Beziehungen.Klassenname | Der sys_class_Name dieses abhängigen Beziehungs-CI. Nur unterstützter Wert: * cmdb_rel_ci: Die CI-Beziehungstabelle. {#identifyreconcile-POST-enhanced__ul_ilx_d1v_flb} Datentyp: Zeichenfolge |
| Ergebnis.Beziehungen.Fehleranzahl | Anzahl der Fehler, die bei der Verarbeitung dieses abhängigen Beziehungs-CI aufgetreten sind. Datentyp: Zahl |
| Ergebnis.Beziehungen.Fehler | Liste der Fehler, die bei der Verarbeitung dieses abhängigen Beziehungs-CI aufgetreten sind. Datentyp: Array von Objekten "errors": [ { "error": "String", "message": "String" } ] |
| Ergebnis.Beziehungen.Fehler.Fehler | Typ des beim Verarbeiten dieses abhängigen Beziehungs-CI aufgetretenen Fehlers. Datentyp: Zeichenfolge |
| Ergebnis.Beziehungen.Fehler.Nachricht | Fehlermeldung beim Verarbeiten dieses abhängigen Beziehungs-CI aufgetreten. Datentyp: Zeichenfolge |
| result.relations.inputIndices | Liste der Indexwerte für die abhängigen Beziehungs-CI-Objekte im Anforderungstext relationsArray, das diesem abhängigen Beziehungs-CI entspricht. Datentyp: Array "inputIndices": [ Number ] |
| Ergebnis.Beziehungen.Markierungen | Liste der Markerwerte für die interne Verwendung. Datentyp: Array "markers": [] |
| Ergebnis.Beziehungen.mergedPayloadIds | Liste der sys_ID-Werte für Teilnutzlasten aus der Tabelle „Teilnutzlasten für CMDB-Ire \[cmdb_ire_partial_payloads\]", die während der Verarbeitung dieses abhängigen Beziehungs-CI zusammengeführt wurden. Datentyp: Array "mergedPayloadIds": [ "String" ] |
| Ergebnis.Beziehungen.Vorgang | Vorgang, der für dieses abhängige Beziehungs-CI ausgeführt wird. Mögliche Werte: * EINFÜGEN: Das abhängige Beziehungs-CI wurde als neuer Datensatz in die Zieltabelle eingefügt. * INSERT_AS_INPLETE: Das abhängige Beziehungs-CI wies Fehler auf und wurde in die Tabelle „unvollständige Nutzlasten für CMDB-Ire" \[cmdb_ire_incomplete_payloads\] eingefügt. * INSERT_AS_PARTIAL: Das abhängige Beziehungs-CI wies Fehler auf und wurde in die Tabelle „partielle Ire-Nutzlasten" \[cmdb_ire_partial_payloads\] eingefügt. * NO_CHANGE: Für das abhängige Beziehungs-CI wurde kein Vorgang ausgeführt. * UPDATE: Ein vorhandenes abhängiges Beziehungs-CI in der Zieltabelle wurde aktualisiert. {#identifyreconcile-POST-enhanced__ul_qd5_kg5_flb} Datentyp: Zeichenfolge |
| Ergebnis.Beziehungen.Warnungen | Liste der Warnungen, die bei der Verarbeitung dieses abhängigen Beziehungs-CI aufgetreten sind. Datentyp: Array von Objekten "warnings": [ { "error": "String", "message": "String" } ] |
| Ergebnis.Beziehungen.Warnungen.Fehler | Typ der Warnung, die bei der Verarbeitung dieses abhängigen Beziehungs-CI aufgetreten ist. Datentyp: Zeichenfolge |
| Ergebnis.Beziehungen.Warnungen.Nachricht | Warnmeldung beim Verarbeiten dieses abhängigen Beziehungs-CI aufgetreten. Datentyp: Zeichenfolge |
[ ]

{#identifyreconcile-POST-enhanced__table_mr2_yyn_rlb}  

### Curl-Anforderung

Übermitteln Sie eine Teilnutzlast für ein Computer-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" \
          } \
        } \
      ] \
    }'

Die Antwort zeigt an, dass die Nutzlast in die Tabelle „partielle Ire-Nutzlasten" in CMDB \[cmdb_ire_partial_payloads\] eingefügt wurde.

    {
      "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": []
      }
    }

Senden Sie eine zweite Teilnutzlast, die die Beschreibung des Computer-CI vervollständigt, wobei die Option „Erweiterter Ire für Zusammenfassungsgenerierung" aktiviert ist.

    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 '{ \
    }'

Die Antwort zeigt an, dass das Computer-CI eingefügt ist, und zeigt eine Zusammenfassung der ausgeführten Vorgänge an.

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

## Identifizierung und Abgleich -- POST /now/identifyreconcile/query {#ariaid-title4}

Bestimmt CMDBVorgang (Einfügen/Aktualisieren), der mit der angegebenen Nutzlast (Anforderungstext) ausgeführt werden soll, ohne die Vorgänge in der Datenbank zu bestätigen.
Verwenden Sie diesen Endpunkt, um die Übermittlung einer Nutzlast (Anforderungstext) an zu simulieren [Identifizierung und Abgleich -- POST /now/identifyreconcile](https://servicenow-prod.fluidtopics.net/E8DTPygR9cjzehPx32EvxQ#identifyreconcile-POST "Fügt Konfigurationselemente (CIs) in ein oder aktualisiert sie CMDBDurch Anwenden von Identifizierungs- und Abgleichsregeln auf die angegebene Nutzlast (Anforderungstext). Verwenden Sie diese API, anstatt zu aktualisieren CMDBDirekt.")Endpunkt.

Verwenden Sie [Identifizierung und Abgleich -- POST /now/identifyreconcile/Enhanced](https://servicenow-prod.fluidtopics.net/E8DTPygR9cjzehPx32EvxQ#identifyreconcile-POST-enhanced "Fügt Konfigurationselemente (CIs) in ein oder aktualisiert sie CMDBDurch Anwenden von Identifizierungs- und Abgleichsregeln auf die angegebene Nutzlast (Anforderungstext). Verwenden Sie diese API, anstatt zu aktualisieren CMDBDirekt.")Endpunkt stattdessen, wenn Sie erweiterte Ire-Optionen angeben müssen. Weitere Informationen zu erweiterten Ire-Optionen finden Sie unter [Identifizierungs- und Abgleichsmodul (Ire)](https://www.servicenow.com/docs/access?context=ire&version=yokohama&pubname=yokohama-servicenow-platform&ft:locale=en-US).

### URL-Format

Versionierte URL: /api/now/{api_Version}/identifyreconcile/query

Standard-URL: /api/now/identifyreconcile/query  
Hinweis:  
Verfügbare Versionen werden in angegeben [REST-API-Explorer](https://servicenow-prod.fluidtopics.net/QZyr9s_~V0xB9fqGOlvJ4A "In diesem Tutorial verwenden Sie den REST API Explorer, um zu testen ServiceNowREST-APIs."). Für geskriptete REST-APIs gibt es zusätzliche Versionsinformationen auf [Geskriptetes REST-Service-Formular](https://servicenow-prod.fluidtopics.net/0V9QfkPsOI5r~YAD7CJWCA "Mit der geskripteten REST-API-Funktion können Anwendungsentwickler anwenderdefinierte Webservice-APIs erstellen.").

### Unterstützte Anforderungsparameter

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

| Name | Beschreibung |
|-|-|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Beispiel: <kbd class="ph userinput">v1 </kbd>Oder <kbd class="ph userinput">v2 </kbd>. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge |
[Tabelle : 13. Pfad-Parameter]

{#identifyreconcile-POST-query__entry__6}

| Name | Beschreibung |
|-|-|
| Sysparm_Data_Source | Quelle der CI-Informationen. Dies muss einer der Auswahlwerte sein, die für das Feld „Discovery_Source" der Tabelle „Konfigurationselement \[cmdb_ci\] definiert sind. Datentyp: Zeichenfolge Standard: Fügen Sie die API-Nutzlast in die Tabelle „unvollständige Nutzlasten" ein. |
[Tabelle : 14. Abfrageparameter]

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

| Name | Beschreibung |
|-|-|
| items | Liste der CIs, die erstellt oder aktualisiert werden sollen. Datentyp: Array von Objekten "items": [ { "className": "String", "internal_id": "String", "lookup": [Array], "related": [Array], "settings": {Object}, "sys_object_source_info": {Object}, "values": {Object} } ] |
| Elements.className | Erforderlich. Der sys_class_Name (Klassen-/Tabellenname) des zu erstellenden oder zu aktualisierenden CI. Dieser Wert kann beliebig sein CMDBTabelle, z. B. cmdb_ci_linux_server oder cmdb_ci_win_server. Datentyp: Zeichenfolge |
| items.internal_id | Eindeutiger Bezeichner für dieses Element in dieser Nutzlast. Kann ein beliebiger Wert sein, muss jedoch innerhalb der Nutzlast eindeutig sein. Datentyp: Zeichenfolge |
| Elemente.Suche | Array von Objekten, in denen jedes Objekt einen suchbasierten Identifizierungsdatensatz beschreibt. Diese Datensätze werden verwendet, um das Konfigurationselement der obersten Ebene basierend auf einer Suchtabelle zu identifizieren, die einen Verweis auf die Tabelle „Konfigurationselement" \[cmdb_ci\] hat. Datentyp: Array aus Objekten "lookup": [ { "className": "String", "internal_id": "String", "sys_object_source_info": {Object}, "values": {Object} } ] |
| Elements.Suche.className | Erforderlich. Der sys_class_Name oder der Klassen-/Tabellenname des CI, das erstellt oder aktualisiert werden soll. Dieser Wert kann beliebig sein CMDBKlasse/Tabelle, z. B. cmdb_Serial_number oder cmdb_ci_network_adapter, oder eine nicht- CMDBHierarchieklasse. Datentyp: Zeichenfolge |
| items.lookup.internal_id | Eindeutiger Bezeichner für diesen Suchdatensatz in dieser Nutzlast. Kann ein beliebiger Wert sein, muss jedoch innerhalb der Nutzlast eindeutig sein. Datentyp: Zeichenfolge |
| items.lookup.sys_object_source_info | Objekt, das einen eindeutigen CI-Bezeichner für eine angegebene Datenquelle beschreibt. Verschiedene Quellen können verschiedene Name-Wert-Paare für dasselbe CI haben. Datentyp: Objekt "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 | Name, der den Feed eindeutig identifiziert, der dieses CI sendet. Verwenden Sie diese Option, wenn die Quelle mehrere Feeds haben kann. Datentyp: Zeichenfolge |
| items.lookup.sys_object_source_info.source_name | Datenquelle für die CI-Informationen. Dieser Wert muss einer der Auswahlwerte sein, die für das Feld „Discovery_Source" der Tabelle „Konfigurationselement \[cmdb_ci\] definiert sind. Datentyp: Zeichenfolge |
| items.lookup.sys_object_source_info.source_native_key | Eindeutiger Schlüssel/ID aus der Quelle für das CI. Kann eine beliebige Zeichenfolge sein, die für das Element eindeutig ist. Datentyp: Zeichenfolge |
| items.lookup.sys_object_source_info.source_recency_timestamp | UTC-Datum und -Uhrzeit, zu der das CI gescannt wurde. Datentyp: Zeichenfolge Format: JJJJ-MM-TT hh:mm:ss |
| Elements.Suche.Werte | Objekt, das Felder für dieses Suchelement als Name/Wert-Paare beschreibt, wobei der Name der Feldname ist. Datentyp: Objekt Feldnamen und -Typen hängen von den vom Anwender ausgewählten Feldern ab, z. B.: "values": { "ip_address": "String", "mac_address": "String", "serial_number": "String", "serial_number_type": "String", "valid": "String" } |
| Elemente.zugehörig | Array von Objekten, in denen jedes Objekt einen Elementdatensatz beschreibt, der erstellt oder aktualisiert werden soll, basierend auf einer zugehörigen Tabelle, die einen Verweis auf das identifizierte CI der obersten Ebene hat. Regeln in der Tabelle „zugehöriger Eintrag" \[cmdb_related_entry\] definieren, welche Art von Datensätzen in diesem Array sein kann. Die zugehörige Tabelle kann die Konfigurationselementtabelle \[cmdb_ci\] erweitern oder nicht. Diese Datensätze werden nicht zur Identifizierung des Konfigurationselements verwendet. Datentyp: Array von Objekten "related": [ { "className": "String", "internal_id": "String", "sys_object_source_info": {Object}, "values": {Object} } ] |
| Elements.related.className | Erforderlich. Der sys_class_Name oder der Klassen-/Tabellenname des zugehörigen Elements, das erstellt oder aktualisiert werden soll. Datentyp: Zeichenfolge |
| items.related.internal_id | Eindeutiger Bezeichner für dieses zugehörige Element in dieser Nutzlast. Kann ein beliebiger Wert sein, muss jedoch innerhalb der Nutzlast eindeutig sein. Datentyp: Zeichenfolge |
| items.related.sys_object_source_info | Objekt, das einen eindeutigen CI-Bezeichner für eine angegebene Datenquelle beschreibt. Verschiedene Quellen können verschiedene Name-Wert-Paare für dasselbe CI haben. Datentyp: Objekt "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 | Name, der den Feed eindeutig identifiziert, der dieses zugehörige Element sendet. Verwenden Sie diese Option, wenn die Quelle mehrere Feeds haben kann. Datentyp: Zeichenfolge |
| items.related.sys_object_source_info.source_name | Datenquelle für die zugehörigen Elementinformationen. Dieser Wert muss einer der Auswahlwerte sein, die für das Feld „Discovery_Source" der Tabelle „Konfigurationselement \[cmdb_ci\] definiert sind. Datentyp: Zeichenfolge |
| items.related.sys_object_source_info.source_native_key | Eindeutiger Schlüssel/ID aus der Quelle für das zugehörige Element. Kann eine beliebige Zeichenfolge sein, die für das Element eindeutig ist. Datentyp: Zeichenfolge |
| items.related.sys_object_source_info.source_recency_timestamp | UTC-Datum und -Uhrzeit, zu der das zugehörige Element gescannt wurde. Datentyp: Zeichenfolge Format: JJJJ-MM-TT hh:mm:ss |
| Elemente.zugehörige.Werte | Objekt, das Felder beschreibt, die für dieses zugehörige Element als Name/Wert-Paare erstellt oder aktualisiert werden sollen, wobei der Name der Feldname ist. Für ein Referenzfeld muss der Wert die referenzierte sys_ID sein Datentyp: Objekt Feldnamen und -Typen hängen von den vom Anwender ausgewählten Feldern ab, z. B.: "values": { "host_name": "String", "ip_address": "String", "name": "String", "os_name": "String", "sys_class_name": "String" } |
| items.settings | Objekt mit Parametern, die die Arten der zulässigen Updates definieren. Datentyp: Objekt "settings": { "skipReclassificationRestrictionRules": Boolean, "updateWithoutDowngrade": Boolean, "updateWithoutSwitch": Boolean, "updateWithoutUpgrade": Boolean } |
| items.settings.skipReclassificationRestrictionRules | Kennzeichnung, die angibt, ob Ire die Ausführung der Reklassifizierungseinschränkungsregel überspringen soll, die der Klasse für das Nutzlastelement entspricht. Gültige Werte: * Wahr: Ausführung der Regel wird übersprungen. * Falsch: Führen Sie die Regel aus. Standard: Falsch |
| items.settings.updateWithoutDowngrade | Kennzeichnung, die angibt, ob Update und Downgrade für dieses CI zulässig sind. Gültige Werte: * Wahr: Aktualisieren Sie das Element, ein Downgrade ist jedoch nicht zulässig. * Falsch: Sowohl Elementaktualisierung als auch Downgrade sind zulässig. Datentyp: Boolescher Wert Standard: Falsch |
| items.settings.updateWithoutSwitch | Kennzeichnung, die angibt, ob dieses CI aktualisiert und seine Klasse gewechselt werden kann. Gültige Werte: * Wahr: Aktualisieren Sie das Element, aber Klassenwechsel ist nicht zulässig. * Falsch: Sowohl Elementaktualisierung als auch Klassenwechsel sind zulässig. Datentyp: Boolescher Wert Standard: Falsch |
| items.settings.updateWithoutUpgrade | Kennzeichnung, die angibt, ob Aktualisierung und Upgrade für dieses CI zulässig sind. Gültige Werte: * Wahr: Aktualisieren Sie das Element, aber ein Upgrade ist nicht zulässig. * Falsch: Elementaktualisierung und Upgrade sind zulässig. Datentyp: Boolescher Wert Standard: Falsch |
| items.sys_object_source_info | Objekt, das einen eindeutigen CI-Bezeichner beschreibt. Datentyp: Objekt "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 | Name, der den Feed eindeutig identifiziert, der dieses CI sendet. Verwenden Sie diese Option, wenn die Quelle mehrere Feeds haben kann. Datentyp: Zeichenfolge |
| items.sys_object_source_info.source_name | Datenquelle für die CI-Informationen. Dieser Wert muss einer der Auswahlwerte sein, die für das Feld „Discovery_Source" der Tabelle „Konfigurationselement \[cmdb_ci\] definiert sind. Datentyp: Zeichenfolge |
| items.sys_object_source_info.source_native_key | Eindeutiger Schlüssel/ID aus der Quelle für das CI. Kann eine beliebige Zeichenfolge sein, die für das Element eindeutig ist. Datentyp: Zeichenfolge |
| items.sys_object_source_info.source_recency_timestamp | UTC-Datum und -Uhrzeit, zu der das CI gescannt wurde. Datentyp: Zeichenfolge Format: JJJJ-MM-TT hh:mm:ss |
| Elemente.Werte | Objekt, das Felder beschreibt, die für dieses CI erstellt oder aktualisiert werden sollen, als Name/Wert-Paare, wobei der Name der Feldname ist. Für ein Referenzfeld muss der Wert die referenzierte sys_ID sein Datentyp: Objekt Feldnamen und -Typen hängen von den vom Anwender ausgewählten Feldern ab, z. B.: "values": { "host_name": "String", "ip_address": "String", "name": "String", "os_name": "String", "sys_class_name": "String" } |
| ReferenceItems | Liste der Referenzen zwischen zwei Elementen in der Nutzlast. Datentyp: Array von Objekten "referenceItems": [ { "referenced": "String", "referencedBy": "String", "referenceField": "String" } ] |
| ReferenzierenElemente.referenziert | Die internal_idDefiniert für das Element, auf das von einem anderen Element verwiesen wird. Datentyp: Zeichenfolge |
| ReferenceItems.referencedBy | Die internal_idDefiniert für das Element, das auf ein anderes Element verweist. Datentyp: Zeichenfolge |
| ReferenceItems.referenceField | Name des Referenzfelds in der Klasse/Tabelle für referencedByElement. Datentyp: Zeichenfolge |
| Beziehungen | Liste der Beziehungen zwischen zwei in der Nutzlast definierten Elementen. Ein Objekt in diesem Array kann eines der zwei Formate verwenden: * Das Objekt kann eine Beziehung zwischen zwei Elementen der obersten Ebene (nur) mit definieren parentUnd childName-Wert-Paare, deren Werte Elementindizes aus der Nutzlast darstellen itemsArray. * Das Objekt kann eine Beziehung zwischen zwei beliebigen Elementen definieren, einschließlich Elementen der obersten Ebene, zugehörigen Elementen oder Suchelementen parent_idUnd child_idSchlüssel-Wert-Paare, wobei Werte darstellen internal_idWerte, die für diese Elemente definiert sind. {#identifyreconcile-POST-query__ul_s1s_phb_nlb} Datentyp: Array von Objekten "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 | Ganzzahliger Index des CI-Objekts in itemsArray, das das untergeordnete Element in der Beziehung darstellt. Datentyp: Zahl |
| relations.child_id | Die internal_idDes untergeordneten Elements in der Beziehung. Datentyp: Zeichenfolge |
| Beziehungen.übergeordnet | Ganzzahliger Index des CI-Objekts in itemsArray, das das übergeordnete Element in der Beziehung darstellt. Datentyp: Zahl |
| Relations.parent_ID | Die internal_idDes übergeordneten Elements in der Beziehung. Datentyp: Zeichenfolge |
| relations.sys_rel_source_info | Discovery-Quellinformationen für die Beziehung. Für Beziehungen ohne Abhängigkeit befinden sich diese Informationen in der Tabelle „Beziehungsquellen" \[sys_rel_Source\]. Datentyp: Objekt "sys_rel_source_info": { "source_name": "String", "source_feed": "String" } |
| relations.sys_rel_source_info.source_name | Name der Discovery-Quelle. Standard: Discovery-Quelle im API-Methodenparameter übergeben. |
| relations.sys_rel_source_info.source_feed | Jede Zeichenfolge, die eine untergeordnete Discovery/Scan innerhalb der Discovery-Quelle ist. Standard: „UNBEKANNT" wird in der Spalte „Source_Feed" gespeichert, wenn ein Datensatz in der Tabelle „sys_rel_Source" erstellt wird. |
| Beziehungen.Typ | Typ der Beziehung zwischen den übergeordneten und untergeordneten Elementen. Dies muss ein Namensfeldwert aus der CI-Beziehungstyp-Tabelle \[cmdb_rel_type\] sein. Datentyp: Zeichenfolge |
[Tabelle : 15. Anforderungstext-Parameter (XML oder JSON)]

### Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter [Unterstützte REST-API-Header](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#identifyreconcile-POST-query__entry__102}{#identifyreconcile-POST-query__accept-JSON-only-entry-RESTAPI}{#identifyreconcile-POST-query__content_type-JSON-only-entry-RESTAPI}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Nur unterstützt application/json. |
| Inhaltstyp | Datenformat des Anforderungstexts. Nur unterstützt application/json. |
[Tabelle : 16. Anforderungskopfzeilen.]

{#identifyreconcile-POST-query__entry__108}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 17. Antwort-Header]

### Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST-API verwendet werden, finden Sie unter [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#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}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 401 | Nicht autorisiert Die Anwenderanmeldeinformationen sind falsch oder wurden nicht übergeben. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Die Antwort enthält zusätzliche Informationen zum Fehler. |
[Tabelle : 18. Statuscodes]

### Antworttext-Parameter (JSON oder 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}

| Name | Beschreibung |
|-|-|
| Ergebnis | Liste der von der Abfrage erzeugten Ergebnisse. Datentyp: Array "result": [ "additionalCommittedItems": [Array], "additionalCommittedRelations": [Array], "items": [Array], "relations": [Array] ] |
| Ergebnis.ZusätzlichKommittedElemente | Liste der CIs, die nicht im Anforderungstext enthalten sind itemsArray, das eingefügt oder aktualisiert werden soll. Datentyp: Array von Objekten "additionalCommittedItems": [ { "className": "String", "errorCount": Number, "identificationAttempts": [Array], "inputIndices": [Array], "markers": [Array], "mergedPayloads": [Array], "operation": "String", "sysId": "String" } ] |
| Ergebnis.additionalCommittedItems.className | Der sys_class_Name dieses zusätzlichen CI. Datentyp: Zeichenfolge |
| Ergebnis.zusätzlichCommittedItems.Fehleranzahl | Anzahl der Fehler, die bei der Verarbeitung dieses zusätzlichen CI aufgetreten sind. Datentyp: Zahl |
| Ergebnis.ZusätzlichCommittedElemente.Fehler | Liste der Fehler, die bei der Verarbeitung dieses zusätzlichen CI aufgetreten sind. Datentyp: Array von Objekten "errors": [ { "error": "String", "message": "String" } ] |
| Ergebnis.zusätzlichCommittedElemente.Fehler.Fehler | Typ des beim Verarbeiten dieses zusätzlichen CI aufgetretenen Fehlers. Datentyp: Zeichenfolge |
| Ergebnis.ZusätzlichCommittedElemente.Fehler.Nachricht | Beim Verarbeiten dieses zusätzlichen CI ist eine Fehlermeldung aufgetreten. Datentyp: Zeichenfolge |
| Ergebnis.ZusätzlichKommittedElemente.IdentifikationVermutungen | Liste der Versuche, dieses zusätzliche CI zu identifizieren. Datentyp: Array von Objekten "identificationAttempts": [ { "attemptResult": "String", "attributes": [Array], "hybridEntryCiAttributes": [Array], "identiferName": "String", "searchOnTable": [Array] } ] |
| Ergebnis.ZusätzlichCommittedElemente.IdentifikationVersuchen.Versuch.Weiterleiten | Ergebnis dieses zusätzlichen CI-Identifizierungsversuchs. Mögliche Werte: * ÜBEREINSTIMMEND: Identifizierung erfolgreich. In der Bezeichnerregeltabelle wurde ein eindeutiges CI gefunden, das genau mit den angegebenen Attributen übereinstimmte. * MULTI_MATCH: Identifizierung mit Fehler fehlgeschlagen. Doppelte CIs wurden in der Bezeichnerregeltabelle beim Abgleich mit den angegebenen Attributen gefunden. * NO_MATCH: Identifizierung fehlgeschlagen. In der Bezeichnerregeltabelle wurde kein CI gefunden, das den angegebenen Attributen entsprach. * ÜBERSPRUNGEN: Identifizierung nicht versucht. Die für diese Bezeichnerregeltabellensuche erforderlichen Attribute wurden nicht angegeben, daher wurde die Regel nicht angewendet. {#identifyreconcile-POST-query__ul_axc_bxx_glb} Datentyp: Zeichenfolge |
| Ergebnis.ZusätzlichKommittedElemente.IdentifikationAttempts.Attribute | Array von CI-Bezeichnereintragsattributen, die während dieses zusätzlichen CI-Identifizierungsversuchs verwendet werden. Datentyp: Array Attributnamen und -Typen hängen von den Anforderungstext-Daten und dem verwendeten Bezeichner ab, z. B.: "attributes": [ "serial_number": "String", "serial_number_type": "String" ] |
| Ergebnis.ZusätzlichCommittedItems.identificationAttempts.hybridEintragungCiAttribute | Liste der CI-Bezeichnereintragsattribute, die während dieses zusätzlichen CI-Identifizierungsversuchs verwendet werden. Datentyp: Array Attributnamen und -Typen hängen von den Anforderungstext-Daten und dem verwendeten Bezeichner ab, z. B.: "hybridEntryCiAttributes": [ "name": "String", "serial_number": "String" ] |
| Ergebnis.zusätzlichCommittedItems.identificationAttempts.identifierName | Bezeichnerregel, die für diesen zusätzlichen CI-Identifizierungsversuch verwendet wird. Datentyp: Zeichenfolge |
| result.additionalCommittedItems.identificationAttempts.searchOnTable | Name der Tabelle, die für diesen zusätzlichen CI-Identifizierungsversuch gesucht wurde. Datentyp: Zeichenfolge |
| Ergebnis.ZusätzlichCommittedItems.identifierEintragungSysId | SYS_ID für die Bezeichnerregel, die zur Identifizierung dieses zusätzlichen CI verwendet wird. Bedeutende Werte: * Unbekannt: Identifizierung dieses zusätzlichen CI fehlgeschlagen. Details siehe errors. {#identifyreconcile-POST-query__ul_hlk_gyx_glb} Datentyp: Zeichenfolge |
| result.additionalCommittedItems.inputIndices | Liste der Indexwerte für CIs aus dem Anforderungstext itemsArray, das diesem zusätzlichen CI entspricht. Datentyp: Array von Objekten "inputIndices": [ { Number } ] |
| Ergebnis.ZusätzlichCommittedElemente.Markierungen | Liste der Markerwerte für die interne Verwendung. Datentyp: Array "markers": [] |
| Ergebnis.zusätzlichCommittedItems.mergedNutzlasten | Liste der sys_ID-Werte für Teilnutzlasten aus der Tabelle „Teilnutzlasten für CMDB-Ire \[cmdb_ire_partial_payloads\]", die während der Verarbeitung dieses zusätzlichen CI zusammengeführt wurden. Datentyp: Array "mergedPayloadIds": [ "String" ] |
| Ergebnis.ZusätzlichCommittedElemente.Vorgang | Vorgang, der für dieses zusätzliche CI ausgeführt wird. Mögliche Werte: * LÖSCHEN: Ein vorhandenes CI wird aus der Zieltabelle entfernt. * EINFÜGEN: Das zusätzliche CI wird als neuer Datensatz in die Zieltabelle eingefügt. * NO_CHANGE: Für das zusätzliche CI wird kein Vorgang ausgeführt. * AKTUALISIEREN: Ein vorhandenes CI in der Zieltabelle wird aktualisiert. * UPDATE_WITH_DOWNGRADE: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine generischere Klasse (Vorgängerklasse) geändert. * UPDATE_WITH_SWITCH: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine andere Klasse geändert, die keine Vorgänger- oder untergeordnete Klasse ist. * UPDATE_WITH_UPGRADE: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine speziellere Klasse (untergeordnete Klasse) geändert. {#identifyreconcile-POST-query__ul_dwt_qwx_glb} Datentyp: Zeichenfolge |
| Ergebnis.zusätzlichCommittedItems.sysId | SYS_ID für dieses zusätzliche CI durch Identifizierung gefunden. Bedeutende Werte: Unbekannt -- Identifizierung dieses zusätzlichen CI fehlgeschlagen. Details siehe errors. Datentyp: Zeichenfolge |
| Ergebnis.ZusätzlichKommittedElemente.Warnungen | Liste der Warnungen, die bei der Verarbeitung dieses zusätzlichen CI aufgetreten sind. Datentyp: Array von Objekten "warnings": [ { "error": "String", "message": "String" } ] |
| Ergebnis.zusätzlichCommittedElemente.Warnungen.Fehler | Typ der Warnung, die bei der Verarbeitung dieses zusätzlichen CI aufgetreten ist. Datentyp: Zeichenfolge |
| Ergebnis.ZusätzlichCommittedElemente.Warnungen.Nachricht | Warnmeldung beim Verarbeiten dieses zusätzlichen CI aufgetreten. Datentyp: Zeichenfolge |
| Ergebnis.ZusätzlichZusammenarbeitenBeziehungen | Liste der abhängigen Beziehungs-CIs, die nicht im Anforderungstext enthalten sind relationsListe zum Einfügen oder Aktualisieren. Datentyp: Array von Objekten "additionalCommittedRelations": [ { "className": "String", "operation": "String", "markers": [Array], "inputIndices": [Array], "mergedPayloadIds": [Array] } ] |
| Ergebnis.ZusätzlichZusammenarbeitenBeziehungen.className | Der sys_class_Name dieses zusätzlichen abhängigen Beziehungs-CI. Nur unterstützter Wert: * cmdb_rel_ci: Die CI-Beziehungstabelle. {#identifyreconcile-POST-query__ul_bsb_pxx_glb} Datentyp: Zeichenfolge |
| Ergebnis.ZusätzlichCommittedBeziehungen.Fehleranzahl | Anzahl der Fehler, die bei der Verarbeitung dieses zusätzlichen abhängigen Beziehungs-CI aufgetreten sind. Datentyp: Zahl |
| Ergebnis.ZusätzlichZusammenarbeitenBeziehungen.Fehler | Liste der Fehler, die bei der Verarbeitung dieses zusätzlichen abhängigen Beziehungs-CI aufgetreten sind. Datentyp: Array von Objekten "errors": [ { "error": "String", "message": "String" } ] |
| Ergebnis.ZusätzlichZusammenarbeitenBeziehungen.Fehler.Fehler | Typ des beim Verarbeiten dieses zusätzlichen abhängigen Beziehungs-CI aufgetretenen Fehlers. Datentyp: Zeichenfolge |
| Ergebnis.ZusätzlichCommittedBeziehungen.Fehler.Nachricht | Beim Verarbeiten dieses zusätzlichen abhängigen Beziehungs-CI ist eine Fehlermeldung aufgetreten. Datentyp: Zeichenfolge |
| result.additionalCommittedRelations.inputIndices | Liste der Indexwerte für abhängige Beziehungs-CI-Objekte im Anforderungstext relationsArray, das diesem zusätzlichen abhängigen Beziehungs-CI entspricht. Datentyp: Array "inputIndices": [ Number ] |
| Ergebnis.ZusätzlichZusammenarbeitenBeziehungen.Markierungen | Liste der Markerwerte für die interne Verwendung. Datentyp: Array "markers": [] |
| Ergebnis.ZusätzlichCommittedRelations.mergedPayloadIds | Liste der sys_ID-Werte für Teilnutzlasten aus der Tabelle „Teilnutzlasten für CMDB-Ire \[cmdb_ire_partial_payloads\]", die während der Verarbeitung dieses zusätzlichen abhängigen Beziehungs-CI zusammengeführt wurden. Datentyp: Array "mergedPayloadIds": [ "String" ] |
| Ergebnis.ZusätzlichCommittedBeziehungen.Vorgang | Vorgang, der für dieses zusätzliche abhängige Beziehungs-CI ausgeführt wird. Mögliche Werte: * EINFÜGEN: Das abhängige Beziehungs-CI wird als neuer Datensatz in die Zieltabelle eingefügt. * INSERT_AS_INPLETE: Das abhängige Beziehungs-CI wies Fehler auf und wird in die Tabelle „unvollständige Nutzlasten für CMDB-Ire \[cmdb_ire_incomplete_payloads\] eingefügt. * INSERT_AS_PARTIAL: Das abhängige Beziehungs-CI wies Fehler auf und wird in die Tabelle „partielle Ire-Nutzlasten" \[cmdb_ire_partial_payloads\] eingefügt. * NO_CHANGE: Für das abhängige Beziehungs-CI wird kein Vorgang ausgeführt. * AKTUALISIEREN: Ein vorhandenes abhängiges Beziehungs-CI in der Zieltabelle wird aktualisiert. {#identifyreconcile-POST-query__ul_ltk_vxx_glb} Datentyp: Zeichenfolge |
| result.items | Liste der CIs, die im Anforderungstext enthalten sind itemsArray. Datentyp: Array von Objekten "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 | Liste der zugehörigen CIs (Tabellensuche-CI) aus der Tabelle „partielle Ire-Nutzlasten" \[cmdb_ire_partial_payloads\]. Datentyp: Array von Objekten "additionalRelatedItems": [ { "className": "String", "inputIndices": [Array], "markers": [Array], "mergedPayloadIds": [Array], "sysId": "String" } ] |
| result.items.additionalRelatedItems.className | Der sys_class_Name des zugehörigen Elements. Datentyp: Zeichenfolge |
| result.items.additionalRelatedItems.inputIndices | Liste der Indexwerte für CIs aus dem Anforderungstext itemsArray, das diesem zugehörigen Element entspricht. Datentyp: Array "inputIndices": [ Number ] |
| result.items.additionalRelatedItems.markers | Liste der Markerwerte für die interne Verwendung. Datentyp: Array "markers": [] |
| result.items.additionalRelatedItems.mergedPayloadIds | Liste der sys_ID-Werte für Teilnutzlasten aus der Tabelle „Teilnutzlasten für CMDB-Ire \[cmdb_ire_partial_payloads\]", die während der Verarbeitung dieses zugehörigen Elements zusammengeführt wurden. Datentyp: Array "mergedPayloadIds": [ "String" ] |
| result.items.additionalRelatedItems.sysId | SYS_ID dieses zugehörigen CI. Datentyp: Zeichenfolge |
| result.items.className | SYS_class_Name dieses CI. Datentyp: Zeichenfolge |
| result.items.duplicateLookupIndices | Objekt mit Arrays von Indexwerten für items.lookupArray-Elemente, die auf dasselbe zugehörige CI verweisen. Der Array-Name gibt das erste Element aus dem Anforderungstext an items.lookupArray, das auf ein bestimmtes zugehöriges CI verweist. Seine Werte sind der Satz zusätzlicher Elemente aus demselben Array, die auf dasselbe zugehörige CI verweisen. Datentyp: Objekt Dieses Beispiel zeigt einen Fall, in dem das zweite Element in angezeigt wird items.lookupArray verweist auf dasselbe zugehörige CI als späteres Element aus diesem Array: "duplicateLookupIndices": [ "2": [Array] ] |
| result.items.errorCount | Anzahl der beim Verarbeiten dieses CI aufgetretenen Fehler. Datentyp: Zahl |
| result.items.errors | Liste der Fehler, die bei der Verarbeitung dieses CI aufgetreten sind. Datentyp: Array von Objekten "errors": [ { "error": "String", "message": "String" } ] |
| result.items.errors.error | Typ des beim Verarbeiten dieses CI aufgetretenen Fehlers. Datentyp: Zeichenfolge |
| result.items.errors.message | Beim Verarbeiten dieses CI ist eine Fehlermeldung aufgetreten. Datentyp: Zeichenfolge |
| result.items.identificationAttempts | Liste der Versuche, dieses CI zu identifizieren. Datentyp: Array von Objekten "identificationAttempts": [ { "attemptResult": "String", "attributes": [Array], "hybridEntryCiAttributes": [Array], "identiferName": "String", "searchOnTable": [Array] } ] |
| result.items.identificationAttempts.attemptResult | Ergebnis dieses CI-Identifizierungsversuchs. Mögliche Werte: * ÜBEREINSTIMMEND: Identifizierung erfolgreich. In der Bezeichnerregeltabelle wurde ein eindeutiges CI gefunden, das genau mit den angegebenen Attributen übereinstimmte. * MULTI_MATCH: Identifizierung mit Fehler fehlgeschlagen. Doppelte CIs wurden in der Bezeichnerregeltabelle beim Abgleich mit den angegebenen Attributen gefunden. * NO_MATCH: Identifizierung fehlgeschlagen. In der Bezeichnerregeltabelle wurde kein CI gefunden, das den angegebenen Attributen entsprach. * ÜBERSPRUNGEN: Identifizierung nicht versucht. Die für diese Bezeichnerregeltabellensuche erforderlichen Attribute wurden nicht angegeben, daher wurde die Regel nicht angewendet. {#identifyreconcile-POST-query__ul_gmw_qn5_flb} Datentyp: Zeichenfolge |
| result.items.identificationAttempts.attributes | Liste der CI-Bezeichnereintragsattribute, die während dieses CI-Identifizierungsversuchs verwendet wurden. Datentyp: Array Attributnamen und -Typen hängen von den Anforderungstext-Daten und dem verwendeten Bezeichner ab, z. B.: "attributes": [ "serial_number": "String", "serial_number_type": "String", ] |
| result.items.identificationAttempts.hybridEntryCiAttributes | Liste der CI-Bezeichnereintragsattribute, die während dieses CI-Identifizierungsversuchs verwendet wurden. Datentyp: Array Attributnamen und -Typen hängen von den Anforderungstext-Daten und dem verwendeten Bezeichner ab, z. B.: "hybridEntryCiAttributes": [ "name": "String", "serial_number": "String" ] |
| result.items.identificationAttempts.identifierName | Bezeichnerregel, die für diesen CI-Identifizierungsversuch verwendet wird. Datentyp: Zeichenfolge |
| result.items.identificationAttempts.searchOnTable | Name der Tabelle, die für diesen CI-Identifizierungsversuch gesucht wurde. Datentyp: Zeichenfolge |
| result.items.identifierEntrySysId | SYS_ID für die Bezeichnerregel, die zur Identifizierung dieses CI verwendet wird. Bedeutende Werte: * Unbekannt: Identifizierung dieses CI fehlgeschlagen. Details finden Sie unter errors. {#identifyreconcile-POST-query__ul_lzk_rvb_glb} Datentyp: Zeichenfolge |
| result.items.info | Liste zusätzlicher Informationen zur Verarbeitung des Elements. Datentyp: Array von Objekten "info": [ { "code": "String", "message": "String", "ruleSysId": "String" } ] |
| result.items.info.code | Reklassifizierungstyp, der übersprungen wurde. Mögliche Werte: * ÜBERSPRUNGEN_CLASS_SWITCH * SKIPPED_CLASS_DOWNGRADE * ÜBERSPRUNGEN_CLASS_UPGRADE {#identifyreconcile-POST-query__ul_pb2_dxp_snb} |
| result.items.info.message | Nachricht, die zusätzliche Einblicke in den Grund für das Überspringen der Neuklassifizierung bietet. Datentyp: Zeichenfolge |
| result.items.info.ruleSysId | SYS_ID der Reklassifizierungseinschränkungsregel, die abgeglichen wurde. Gilt nur, wenn Ire die Neuklassifizierung aufgrund der Reklassifizierungseinschränkungsregel überspringt. Dieser Wert ist leer, wenn die Neuklassifizierung aufgrund einer Nutzlast oder einer globalen Kennzeichnung übersprungen wird. Datentyp: Zeichenfolge |
| result.items.inputIndices | Liste der Indexwerte für CIs aus dem Anforderungstext itemsArray, das diesem CI entspricht. Datentyp: Array von Objekten "inputIndices": [ { Number } ] |
| result.items.markers | Liste der Markerwerte für die interne Verwendung. Datentyp: Array "markers": [] |
| result.items.mergedPayloadIds | Liste der sys_ID-Werte für Teilnutzlasten aus der Tabelle „Teilnutzlasten für CMDB-Ire \[cmdb_ire_partial_payloads\]", die während der Verarbeitung dieses CI zusammengeführt wurden. Datentyp: Array "mergedPayloadIds": [ "String" ] |
| result.items.operation | Für dieses CI ausgeführter Vorgang. Mögliche Werte: * LÖSCHEN: Ein vorhandenes CI wird aus der Zieltabelle entfernt. * EINFÜGEN: Das CI wird als neuer Datensatz in die Zieltabelle eingefügt. * NO_CHANGE: Für das CI wird kein Vorgang ausgeführt. * AKTUALISIEREN: Ein vorhandenes CI in der Zieltabelle wird aktualisiert. * UPDATE_WITH_DOWNGRADE: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine generischere Klasse (Vorgängerklasse) geändert. * UPDATE_WITH_SWITCH: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine andere Klasse geändert, die keine Vorgänger- oder untergeordnete Klasse ist. * UPDATE_WITH_UPGRADE: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine speziellere Klasse (untergeordnete Klasse) geändert. {#identifyreconcile-POST-query__ul_jhl_gg5_flb} Datentyp: Zeichenfolge |
| result.items.relatedItems | Liste der zugehörigen CIs (Tabellensuche-CI) aus dem Anforderungstext items.lookupArray. Datentyp: Array von Objekten "relatedItems": [ { "className": "String", "inputIndices": [Array], "markers": [Array], "mergedPayloadIds": [Array], "sysId": "String" } ] |
| result.items.relatedItems.className | Der sys_class_Name des zugehörigen Elements. Datentyp: Zeichenfolge |
| result.items.relatedItems.inputIndices | Liste der Indexwerte für CIs und Suchelemente aus dem Anforderungstext itemsUnd items.lookupArrays, die diesem zugehörigen Element entsprechen. Datentyp: Array von Objekten "inputIndices": [ { "mainIndex": Number, "subIndex": Number } ] |
| result.items.relatedItems.inputIndices.mainIndex | Indexwert aus dem Anforderungstext itemsArray, das dem übergeordneten CI des zugehörigen Elements entspricht. Datentyp: Zahl |
| result.items.relatedItems.inputIndices.subIndex | Indexwert aus dem Anforderungstext items.lookupArray, das dem zugehörigen Element entspricht. Datentyp: Zahl |
| result.items.relatedItems.markers | Liste der Markerwerte für die interne Verwendung. Datentyp: Array "markers": [] |
| result.items.relatedItems.mergedPayloadIds | Liste der sys_ID-Werte für Einträge in der Tabelle „teilweise Nutzlasten des CMDB-Ire \[cmdb_ire_partial_payloads\]", die während der Verarbeitung mit diesem CI zusammengeführt wurden. Datentyp: Array "mergedPayloadIds": [ "String" ] |
| result.items.relatedSysIds | Liste der sys_ID-Werte für zugehörige Elemente (Tabellensuchelemente) aus dem Anforderungstext items.lookupArray. Datentyp: Array Bedeutende Werte: * Null: Für dieses zugehörige Element wurde keine sys_ID identifiziert. {#identifyreconcile-POST-query__ul_zs5_f1y_glb} "relatedSysIds": [ Number, Number ] |
| result.items.sysId | SYS_ID für dieses CI durch Identifizierung gefunden. Bedeutende Werte: * Unbekannt: Identifizierung dieses CI fehlgeschlagen. Details siehe errors. {#identifyreconcile-POST-query__ul_zz5_5vb_glb} Datentyp: Zeichenfolge |
| result.items.warnings | Liste der Warnungen, die bei der Verarbeitung dieses CI aufgetreten sind. Datentyp: Array von Objekten "warnings": [ { "error": "String", "message": "String" } ] |
| result.items.warnings.error | Typ der Warnung, die bei der Verarbeitung dieses CI aufgetreten ist. Datentyp: Zeichenfolge |
| result.items.warnings.message | Warnmeldung beim Verarbeiten dieses CI aufgetreten. Datentyp: Zeichenfolge |
| Ergebnis.logKontextId | Kontext-ID, die für diese Nutzlast gemeldet wurde. Datentyp: Zeichenfolge |
| Ergebnis.Beziehungen | Liste der abhängigen Beziehungs-CIs aus dem Anforderungstext relationsArray. Datentyp: Array von Objekten "relations": [ { "className": "String", "errorCount": Number, "errors": [Array], "inputIndices": [Array], "markers": [Array], "mergedPayloadIds": [Array], "operation": "String", "warnings": [Array] } ] |
| Ergebnis.Beziehungen.Klassenname | Der sys_class_Name dieses abhängigen Beziehungs-CI. Nur unterstützter Wert: * cmdb_rel_ci: Die CI-Beziehungstabelle. {#identifyreconcile-POST-query__ul_ilx_d1v_flb} Datentyp: Zeichenfolge |
| Ergebnis.Beziehungen.Fehleranzahl | Anzahl der Fehler, die bei der Verarbeitung dieses abhängigen Beziehungs-CI aufgetreten sind. Datentyp: Zahl |
| Ergebnis.Beziehungen.Fehler | Liste der Fehler, die bei der Verarbeitung dieses abhängigen Beziehungs-CI aufgetreten sind. Datentyp: Array von Objekten "errors": [ { "error": "String", "message": "String" } ] |
| Ergebnis.Beziehungen.Fehler.Fehler | Typ des beim Verarbeiten dieses abhängigen Beziehungs-CI aufgetretenen Fehlers. Datentyp: Zeichenfolge |
| Ergebnis.Beziehungen.Fehler.Nachricht | Fehlermeldung beim Verarbeiten dieses abhängigen Beziehungs-CI aufgetreten. Datentyp: Zeichenfolge |
| result.relations.inputIndices | Liste der Indexwerte für die abhängigen Beziehungs-CI-Objekte im Anforderungstext relationsArray, das diesem abhängigen Beziehungs-CI entspricht. Datentyp: Array "inputIndices": [ Number ] |
| Ergebnis.Beziehungen.Markierungen | Liste der Markerwerte für die interne Verwendung. Datentyp: Array "markers": [] |
| Ergebnis.Beziehungen.mergedPayloadIds | Liste der sys_ID-Werte für Teilnutzlasten aus der Tabelle „Teilnutzlasten für CMDB-Ire \[cmdb_ire_partial_payloads\]", die während der Verarbeitung dieses abhängigen Beziehungs-CI zusammengeführt wurden. Datentyp: Array "mergedPayloadIds": [ "String" ] |
| Ergebnis.Beziehungen.Vorgang | Vorgang, der für dieses abhängige Beziehungs-CI ausgeführt wird. Mögliche Werte: * EINFÜGEN: Das abhängige Beziehungs-CI wurde als neuer Datensatz in die Zieltabelle eingefügt. * INSERT_AS_INPLETE: Das abhängige Beziehungs-CI wies Fehler auf und wurde in die Tabelle „unvollständige Nutzlasten für CMDB-Ire" \[cmdb_ire_incomplete_payloads\] eingefügt. * INSERT_AS_PARTIAL: Das abhängige Beziehungs-CI wies Fehler auf und wurde in die Tabelle „partielle Ire-Nutzlasten" \[cmdb_ire_partial_payloads\] eingefügt. * NO_CHANGE: Für das abhängige Beziehungs-CI wurde kein Vorgang ausgeführt. * UPDATE: Ein vorhandenes abhängiges Beziehungs-CI in der Zieltabelle wurde aktualisiert. {#identifyreconcile-POST-query__ul_qd5_kg5_flb} Datentyp: Zeichenfolge |
| Ergebnis.Beziehungen.Warnungen | Liste der Warnungen, die bei der Verarbeitung dieses abhängigen Beziehungs-CI aufgetreten sind. Datentyp: Array von Objekten "warnings": [ { "error": "String", "message": "String" } ] |
| Ergebnis.Beziehungen.Warnungen.Fehler | Typ der Warnung, die bei der Verarbeitung dieses abhängigen Beziehungs-CI aufgetreten ist. Datentyp: Zeichenfolge |
| Ergebnis.Beziehungen.Warnungen.Nachricht | Warnmeldung beim Verarbeiten dieses abhängigen Beziehungs-CI aufgetreten. Datentyp: Zeichenfolge |
[ ]

### Curl-Anforderung

Simulieren Sie die Übermittlung einer Nutzlast, die einen Linux-Server (mit Seriennummern und Netzwerkadapter-zugehörigen Elementsuchen) und einen IP-Switch mit einer IP-Verbindungsbeziehung zwischen ihnen enthält.

    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" \
      }] \
    }'

Das Linux-Server-CI wird über eine Hardwareregelsuche nach seinem Namen in der Tabelle „Hardware" \[cmdb_ci_Hardware\] identifiziert und als Update für ein vorhandenes CI in der Tabelle „Linux-Server" \[cmdb_ci_linux_server\] verarbeitet. Der IP-Switch wird ähnlich über eine Hardwareregel-Suche nach seinem Namen in der Hardwaretabelle identifiziert und aktualisiert ein vorhandenes CI in der Tabelle „IP-Switch" \[cmdb_ci_ip_switch\]. Schließlich wird die IP-Verbindungsbeziehung zwischen dem Server und dem Switch als neuer Datensatz in die CI-Beziehungstabelle \[cmdb_rel_ci\] eingefügt.

    {
      "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": []
      }
    }

## Identifizierung und Abgleich -- POST /now/identifyreconcile/queryEnhanced {#ariaid-title5}

Bestimmt CMDBVorgang (Einfügen/Aktualisieren), der mit der angegebenen Nutzlast (Anforderungstext) ausgeführt werden soll, ohne die Vorgänge in der Datenbank zu bestätigen.
Verwenden Sie diesen Endpunkt, um die Übermittlung einer Nutzlast (Anforderungstext) an zu simulieren [Identifizierung und Abgleich -- POST /now/identifyreconcile/Enhanced](https://servicenow-prod.fluidtopics.net/E8DTPygR9cjzehPx32EvxQ#identifyreconcile-POST-enhanced "Fügt Konfigurationselemente (CIs) in ein oder aktualisiert sie CMDBDurch Anwenden von Identifizierungs- und Abgleichsregeln auf die angegebene Nutzlast (Anforderungstext). Verwenden Sie diese API, anstatt zu aktualisieren CMDBDirekt.")Endpunkt.  
Diese Methode ähnelt der [Identifizierung und Abgleich -- POST /now/identifyreconcile/query](https://servicenow-prod.fluidtopics.net/E8DTPygR9cjzehPx32EvxQ#identifyreconcile-POST-query "Bestimmt CMDBVorgang (Einfügen/Aktualisieren), der mit der angegebenen Nutzlast (Anforderungstext) ausgeführt werden soll, ohne die Vorgänge in der Datenbank zu bestätigen.")Methode, fügt jedoch die folgende Funktionalität hinzu:

* Teilnutzlasten
  * Gibt bei einem Element mit einer Warnung oder einem Fehler an, ob ein Elementvorgang „INSERT_AS_PART" oder „INSERT_UNVOLLSTÄNDIG" ist.
  * Gibt die sys_IDs von Teilnutzlasten zurück, die mit vorhandenen Teilnutzlasten zusammengeführt wurden.
  {#identifyreconcile-POST-queryenhanced__ul_x4s_nvk_xlb}
* Unterstützt die Deduplizierungsfunktion der Nutzlast.
* Generiert eine Zusammenfassung.
{#identifyreconcile-POST-queryenhanced__ul_scj_jvk_xlb}

### URL-Format

Versionierte URL: /api/now/{api_Version}/identifyreconcile/queryEnhanced

Standard-URL: /api/now/identifyreconcile/queryEnhanced  
Hinweis:  
Verfügbare Versionen werden in angegeben [REST-API-Explorer](https://servicenow-prod.fluidtopics.net/QZyr9s_~V0xB9fqGOlvJ4A "In diesem Tutorial verwenden Sie den REST API Explorer, um zu testen ServiceNowREST-APIs."). Für geskriptete REST-APIs gibt es zusätzliche Versionsinformationen auf [Geskriptetes REST-Service-Formular](https://servicenow-prod.fluidtopics.net/0V9QfkPsOI5r~YAD7CJWCA "Mit der geskripteten REST-API-Funktion können Anwendungsentwickler anwenderdefinierte Webservice-APIs erstellen.").

### Unterstützte Anforderungsparameter

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

| Name | Beschreibung |
|-|-|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Beispiel: <kbd class="ph userinput">v1 </kbd>Oder <kbd class="ph userinput">v2 </kbd>. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge |
[Tabelle : 19. Pfad-Parameter]

{#identifyreconcile-POST-queryenhanced__entry__6}

| Name | Beschreibung |
|-|-|
| Optionen | Kommagetrennte Liste von Name-Wert-Paaren, die erweiterte Ire-Optionen darstellen, die für die Anforderung angewendet werden. So überschreiben Sie beispielsweise die Standardwerte für die partiellen Nutzlasten, partiellen Commits, deduplizierten Nutzlasten und Generieren der erweiterten Ire-Optionen für die Zusammenfassung: `Partial_Payloads:falsch,Partial_Commits:falsch,deduplicate_Payloads:falsch,generate_summary:wahr` Hinweis: Standardmäßig oder wenn partial_payloadsIst auf „wahr" festgelegt, beides partial_commitsUnd deduplicate_payloadsSind aktiviert, auch wenn sie auf „falsch" festgelegt sind, da diese Funktionen für die Funktionalität von Teilnutzlasten von entscheidender Bedeutung sind. Weitere Informationen zu erweiterten Ire-Optionen finden Sie unter [Identifizierungs- und Abgleichsmodul (Ire)](https://www.servicenow.com/docs/access?context=ire&version=yokohama&pubname=yokohama-servicenow-platform&ft:locale=en-US). Gültige Werte für jedes Name-Wert-Paar: * Wahr: Aktivieren Sie diese erweiterte Ire-Option. * Falsch: Deaktivieren Sie diese erweiterte Ire-Option. {#identifyreconcile-POST-queryenhanced__ul_wc3_mpn_rlb} Datentyp: Zeichenfolge |
| Sysparm_Data_Source | Quelle der CI-Informationen. Dies muss einer der Auswahlwerte sein, die für das Feld „Discovery_Source" der Tabelle „Konfigurationselement \[cmdb_ci\] definiert sind. Datentyp: Zeichenfolge Standard: Fügen Sie die API-Nutzlast in die Tabelle „unvollständige Nutzlasten" ein. |
[Tabelle : 20. Abfrageparameter]

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

| Name | Beschreibung |
|-|-|
| items | Liste der CIs, die erstellt oder aktualisiert werden sollen. Datentyp: Array von Objekten "items": [ { "className": "String", "internal_id": "String", "lookup": [Array], "related": [Array], "settings": {Object}, "sys_object_source_info": {Object}, "values": {Object} } ] |
| Elements.className | Erforderlich. Der sys_class_Name (Klassen-/Tabellenname) des zu erstellenden oder zu aktualisierenden CI. Dieser Wert kann beliebig sein CMDBTabelle, z. B. cmdb_ci_linux_server oder cmdb_ci_win_server. Datentyp: Zeichenfolge |
| items.internal_id | Eindeutiger Bezeichner für dieses Element in dieser Nutzlast. Kann ein beliebiger Wert sein, muss jedoch innerhalb der Nutzlast eindeutig sein. Datentyp: Zeichenfolge |
| Elemente.Suche | Array von Objekten, in denen jedes Objekt einen suchbasierten Identifizierungsdatensatz beschreibt. Diese Datensätze werden verwendet, um das Konfigurationselement der obersten Ebene basierend auf einer Suchtabelle zu identifizieren, die einen Verweis auf die Tabelle „Konfigurationselement" \[cmdb_ci\] hat. Datentyp: Array aus Objekten "lookup": [ { "className": "String", "internal_id": "String", "sys_object_source_info": {Object}, "values": {Object} } ] |
| Elements.Suche.className | Erforderlich. Der sys_class_Name oder der Klassen-/Tabellenname des CI, das erstellt oder aktualisiert werden soll. Dieser Wert kann beliebig sein CMDBKlasse/Tabelle, z. B. cmdb_Serial_number oder cmdb_ci_network_adapter, oder eine nicht- CMDBHierarchieklasse. Datentyp: Zeichenfolge |
| items.lookup.internal_id | Eindeutiger Bezeichner für diesen Suchdatensatz in dieser Nutzlast. Kann ein beliebiger Wert sein, muss jedoch innerhalb der Nutzlast eindeutig sein. Datentyp: Zeichenfolge |
| items.lookup.sys_object_source_info | Objekt, das einen eindeutigen CI-Bezeichner für eine angegebene Datenquelle beschreibt. Verschiedene Quellen können verschiedene Name-Wert-Paare für dasselbe CI haben. Datentyp: Objekt "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 | Name, der den Feed eindeutig identifiziert, der dieses CI sendet. Verwenden Sie diese Option, wenn die Quelle mehrere Feeds haben kann. Datentyp: Zeichenfolge |
| items.lookup.sys_object_source_info.source_name | Datenquelle für die CI-Informationen. Dieser Wert muss einer der Auswahlwerte sein, die für das Feld „Discovery_Source" der Tabelle „Konfigurationselement \[cmdb_ci\] definiert sind. Datentyp: Zeichenfolge |
| items.lookup.sys_object_source_info.source_native_key | Eindeutiger Schlüssel/ID aus der Quelle für das CI. Kann eine beliebige Zeichenfolge sein, die für das Element eindeutig ist. Datentyp: Zeichenfolge |
| items.lookup.sys_object_source_info.source_recency_timestamp | UTC-Datum und -Uhrzeit, zu der das CI gescannt wurde. Datentyp: Zeichenfolge Format: JJJJ-MM-TT hh:mm:ss |
| Elements.Suche.Werte | Objekt, das Felder für dieses Suchelement als Name/Wert-Paare beschreibt, wobei der Name der Feldname ist. Datentyp: Objekt Feldnamen und -Typen hängen von den vom Anwender ausgewählten Feldern ab, z. B.: "values": { "ip_address": "String", "mac_address": "String", "serial_number": "String", "serial_number_type": "String", "valid": "String" } |
| Elemente.zugehörig | Array von Objekten, in denen jedes Objekt einen Elementdatensatz beschreibt, der erstellt oder aktualisiert werden soll, basierend auf einer zugehörigen Tabelle, die einen Verweis auf das identifizierte CI der obersten Ebene hat. Regeln in der Tabelle „zugehöriger Eintrag" \[cmdb_related_entry\] definieren, welche Art von Datensätzen in diesem Array sein kann. Die zugehörige Tabelle kann die Konfigurationselementtabelle \[cmdb_ci\] erweitern oder nicht. Diese Datensätze werden nicht zur Identifizierung des Konfigurationselements verwendet. Datentyp: Array von Objekten "related": [ { "className": "String", "internal_id": "String", "sys_object_source_info": {Object}, "values": {Object} } ] |
| Elements.related.className | Erforderlich. Der sys_class_Name oder der Klassen-/Tabellenname des zugehörigen Elements, das erstellt oder aktualisiert werden soll. Datentyp: Zeichenfolge |
| items.related.internal_id | Eindeutiger Bezeichner für dieses zugehörige Element in dieser Nutzlast. Kann ein beliebiger Wert sein, muss jedoch innerhalb der Nutzlast eindeutig sein. Datentyp: Zeichenfolge |
| items.related.sys_object_source_info | Objekt, das einen eindeutigen CI-Bezeichner für eine angegebene Datenquelle beschreibt. Verschiedene Quellen können verschiedene Name-Wert-Paare für dasselbe CI haben. Datentyp: Objekt "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 | Name, der den Feed eindeutig identifiziert, der dieses zugehörige Element sendet. Verwenden Sie diese Option, wenn die Quelle mehrere Feeds haben kann. Datentyp: Zeichenfolge |
| items.related.sys_object_source_info.source_name | Datenquelle für die zugehörigen Elementinformationen. Dieser Wert muss einer der Auswahlwerte sein, die für das Feld „Discovery_Source" der Tabelle „Konfigurationselement \[cmdb_ci\] definiert sind. Datentyp: Zeichenfolge |
| items.related.sys_object_source_info.source_native_key | Eindeutiger Schlüssel/ID aus der Quelle für das zugehörige Element. Kann eine beliebige Zeichenfolge sein, die für das Element eindeutig ist. Datentyp: Zeichenfolge |
| items.related.sys_object_source_info.source_recency_timestamp | UTC-Datum und -Uhrzeit, zu der das zugehörige Element gescannt wurde. Datentyp: Zeichenfolge Format: JJJJ-MM-TT hh:mm:ss |
| Elemente.zugehörige.Werte | Objekt, das Felder beschreibt, die für dieses zugehörige Element als Name/Wert-Paare erstellt oder aktualisiert werden sollen, wobei der Name der Feldname ist. Für ein Referenzfeld muss der Wert die referenzierte sys_ID sein Datentyp: Objekt Feldnamen und -Typen hängen von den vom Anwender ausgewählten Feldern ab, z. B.: "values": { "host_name": "String", "ip_address": "String", "name": "String", "os_name": "String", "sys_class_name": "String" } |
| items.settings | Objekt mit Parametern, die die Arten der zulässigen Updates definieren. Datentyp: Objekt "settings": { "skipReclassificationRestrictionRules": Boolean, "updateWithoutDowngrade": Boolean, "updateWithoutSwitch": Boolean, "updateWithoutUpgrade": Boolean } |
| items.settings.skipReclassificationRestrictionRules | Kennzeichnung, die angibt, ob Ire die Ausführung der Reklassifizierungseinschränkungsregel überspringen soll, die der Klasse für das Nutzlastelement entspricht. Gültige Werte: * Wahr: Ausführung der Regel wird übersprungen. * Falsch: Führen Sie die Regel aus. Standard: Falsch |
| items.settings.updateWithoutDowngrade | Kennzeichnung, die angibt, ob Update und Downgrade für dieses CI zulässig sind. Gültige Werte: * Wahr: Aktualisieren Sie das Element, ein Downgrade ist jedoch nicht zulässig. * Falsch: Sowohl Elementaktualisierung als auch Downgrade sind zulässig. Datentyp: Boolescher Wert Standard: Falsch |
| items.settings.updateWithoutSwitch | Kennzeichnung, die angibt, ob dieses CI aktualisiert und seine Klasse gewechselt werden kann. Gültige Werte: * Wahr: Aktualisieren Sie das Element, aber Klassenwechsel ist nicht zulässig. * Falsch: Sowohl Elementaktualisierung als auch Klassenwechsel sind zulässig. Datentyp: Boolescher Wert Standard: Falsch |
| items.settings.updateWithoutUpgrade | Kennzeichnung, die angibt, ob Aktualisierung und Upgrade für dieses CI zulässig sind. Gültige Werte: * Wahr: Aktualisieren Sie das Element, aber ein Upgrade ist nicht zulässig. * Falsch: Elementaktualisierung und Upgrade sind zulässig. Datentyp: Boolescher Wert Standard: Falsch |
| items.sys_object_source_info | Objekt, das einen eindeutigen CI-Bezeichner beschreibt. Datentyp: Objekt "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 | Name, der den Feed eindeutig identifiziert, der dieses CI sendet. Verwenden Sie diese Option, wenn die Quelle mehrere Feeds haben kann. Datentyp: Zeichenfolge |
| items.sys_object_source_info.source_name | Datenquelle für die CI-Informationen. Dieser Wert muss einer der Auswahlwerte sein, die für das Feld „Discovery_Source" der Tabelle „Konfigurationselement \[cmdb_ci\] definiert sind. Datentyp: Zeichenfolge |
| items.sys_object_source_info.source_native_key | Eindeutiger Schlüssel/ID aus der Quelle für das CI. Kann eine beliebige Zeichenfolge sein, die für das Element eindeutig ist. Datentyp: Zeichenfolge |
| items.sys_object_source_info.source_recency_timestamp | UTC-Datum und -Uhrzeit, zu der das CI gescannt wurde. Datentyp: Zeichenfolge Format: JJJJ-MM-TT hh:mm:ss |
| Elemente.Werte | Objekt, das Felder beschreibt, die für dieses CI erstellt oder aktualisiert werden sollen, als Name/Wert-Paare, wobei der Name der Feldname ist. Für ein Referenzfeld muss der Wert die referenzierte sys_ID sein Datentyp: Objekt Feldnamen und -Typen hängen von den vom Anwender ausgewählten Feldern ab, z. B.: "values": { "host_name": "String", "ip_address": "String", "name": "String", "os_name": "String", "sys_class_name": "String" } |
| ReferenceItems | Liste der Referenzen zwischen zwei Elementen in der Nutzlast. Datentyp: Array von Objekten "referenceItems": [ { "referenced": "String", "referencedBy": "String", "referenceField": "String" } ] |
| ReferenzierenElemente.referenziert | Die internal_idDefiniert für das Element, auf das von einem anderen Element verwiesen wird. Datentyp: Zeichenfolge |
| ReferenceItems.referencedBy | Die internal_idDefiniert für das Element, das auf ein anderes Element verweist. Datentyp: Zeichenfolge |
| ReferenceItems.referenceField | Name des Referenzfelds in der Klasse/Tabelle für referencedByElement. Datentyp: Zeichenfolge |
| Beziehungen | Liste der Beziehungen zwischen zwei in der Nutzlast definierten Elementen. Ein Objekt in diesem Array kann eines der zwei Formate verwenden: * Das Objekt kann eine Beziehung zwischen zwei Elementen der obersten Ebene (nur) mit definieren parentUnd childName-Wert-Paare, deren Werte Elementindizes aus der Nutzlast darstellen itemsArray. * Das Objekt kann eine Beziehung zwischen zwei beliebigen Elementen definieren, einschließlich Elementen der obersten Ebene, zugehörigen Elementen oder Suchelementen parent_idUnd child_idSchlüssel-Wert-Paare, wobei Werte darstellen internal_idWerte, die für diese Elemente definiert sind. {#identifyreconcile-POST-queryenhanced__ul_s1s_phb_nlb} Datentyp: Array von Objekten "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 | Ganzzahliger Index des CI-Objekts in itemsArray, das das untergeordnete Element in der Beziehung darstellt. Datentyp: Zahl |
| relations.child_id | Die internal_idDes untergeordneten Elements in der Beziehung. Datentyp: Zeichenfolge |
| Beziehungen.übergeordnet | Ganzzahliger Index des CI-Objekts in itemsArray, das das übergeordnete Element in der Beziehung darstellt. Datentyp: Zahl |
| Relations.parent_ID | Die internal_idDes übergeordneten Elements in der Beziehung. Datentyp: Zeichenfolge |
| relations.sys_rel_source_info | Discovery-Quellinformationen für die Beziehung. Für Beziehungen ohne Abhängigkeit befinden sich diese Informationen in der Tabelle „Beziehungsquellen" \[sys_rel_Source\]. Datentyp: Objekt "sys_rel_source_info": { "source_name": "String", "source_feed": "String" } |
| relations.sys_rel_source_info.source_name | Name der Discovery-Quelle. Standard: Discovery-Quelle im API-Methodenparameter übergeben. |
| relations.sys_rel_source_info.source_feed | Jede Zeichenfolge, die eine untergeordnete Discovery/Scan innerhalb der Discovery-Quelle ist. Standard: „UNBEKANNT" wird in der Spalte „Source_Feed" gespeichert, wenn ein Datensatz in der Tabelle „sys_rel_Source" erstellt wird. |
| Beziehungen.Typ | Typ der Beziehung zwischen den übergeordneten und untergeordneten Elementen. Dies muss ein Namensfeldwert aus der CI-Beziehungstyp-Tabelle \[cmdb_rel_type\] sein. Datentyp: Zeichenfolge |
[Tabelle : 21. Anforderungstext-Parameter (XML oder JSON)]

{#identifyreconcile-POST-queryenhanced__table_c2c_bzn_rlb}

### Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter [Unterstützte REST-API-Header](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#identifyreconcile-POST-queryenhanced__entry__104}{#identifyreconcile-POST-queryenhanced__accept-JSON-only-entry-RESTAPI}{#identifyreconcile-POST-queryenhanced__content_type-JSON-only-entry-RESTAPI}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Nur unterstützt application/json. |
| Inhaltstyp | Datenformat des Anforderungstexts. Nur unterstützt application/json. |
[Tabelle : 22. Anforderungskopfzeilen.]

{#identifyreconcile-POST-queryenhanced__entry__110}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 23. Antwort-Header]

### Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST-API verwendet werden, finden Sie unter [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#identifyreconcile-POST-queryenhanced__entry__114}{#identifyreconcile-POST-queryenhanced__entry-200-status-code}{#identifyreconcile-POST-queryenhanced__entry-401-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 401 | Nicht autorisiert Die Anwenderanmeldeinformationen sind falsch oder wurden nicht übergeben. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Fehlermeldungsdetail „Block \[...\] Ist kein gültiger Eintrag" gibt an, dass optionsAbfrageparameter weist nicht das richtige Name-Wert-Paarformat auf. Beispiel: Geben Sie an optionsParameter von `Teilweise `Erstellt einen Statuscode 500 mit „Block \[teilweise\] ist kein gültiger Eintrag" im Nachrichtendetail. |
[Tabelle : 24. Statuscodes]

### Antworttext-Parameter (JSON oder 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}

| Name | Beschreibung |
|-|-|
| Ergebnis | Liste der von der Abfrage erzeugten Ergebnisse. Datentyp: Array "result": [ "additionalCommittedItems": [Array], "additionalCommittedRelations": [Array], "items": [Array], "relations": [Array] ] |
| Ergebnis.ZusätzlichKommittedElemente | Liste der CIs, die nicht im Anforderungstext enthalten sind itemsArray, das eingefügt oder aktualisiert werden soll. Datentyp: Array von Objekten "additionalCommittedItems": [ { "className": "String", "errorCount": Number, "identificationAttempts": [Array], "inputIndices": [Array], "markers": [Array], "mergedPayloads": [Array], "operation": "String", "sysId": "String" } ] |
| Ergebnis.additionalCommittedItems.className | Der sys_class_Name dieses zusätzlichen CI. Datentyp: Zeichenfolge |
| Ergebnis.zusätzlichCommittedItems.Fehleranzahl | Anzahl der Fehler, die bei der Verarbeitung dieses zusätzlichen CI aufgetreten sind. Datentyp: Zahl |
| Ergebnis.ZusätzlichCommittedElemente.Fehler | Liste der Fehler, die bei der Verarbeitung dieses zusätzlichen CI aufgetreten sind. Datentyp: Array von Objekten "errors": [ { "error": "String", "message": "String" } ] |
| Ergebnis.zusätzlichCommittedElemente.Fehler.Fehler | Typ des beim Verarbeiten dieses zusätzlichen CI aufgetretenen Fehlers. Datentyp: Zeichenfolge |
| Ergebnis.ZusätzlichCommittedElemente.Fehler.Nachricht | Beim Verarbeiten dieses zusätzlichen CI ist eine Fehlermeldung aufgetreten. Datentyp: Zeichenfolge |
| Ergebnis.ZusätzlichKommittedElemente.IdentifikationVermutungen | Liste der Versuche, dieses zusätzliche CI zu identifizieren. Datentyp: Array von Objekten "identificationAttempts": [ { "attemptResult": "String", "attributes": [Array], "hybridEntryCiAttributes": [Array], "identiferName": "String", "searchOnTable": [Array] } ] |
| Ergebnis.ZusätzlichCommittedElemente.IdentifikationVersuchen.Versuch.Weiterleiten | Ergebnis dieses zusätzlichen CI-Identifizierungsversuchs. Mögliche Werte: * ÜBEREINSTIMMEND: Identifizierung erfolgreich. In der Bezeichnerregeltabelle wurde ein eindeutiges CI gefunden, das genau mit den angegebenen Attributen übereinstimmte. * MULTI_MATCH: Identifizierung mit Fehler fehlgeschlagen. Doppelte CIs wurden in der Bezeichnerregeltabelle beim Abgleich mit den angegebenen Attributen gefunden. * NO_MATCH: Identifizierung fehlgeschlagen. In der Bezeichnerregeltabelle wurde kein CI gefunden, das den angegebenen Attributen entsprach. * ÜBERSPRUNGEN: Identifizierung nicht versucht. Die für diese Bezeichnerregeltabellensuche erforderlichen Attribute wurden nicht angegeben, daher wurde die Regel nicht angewendet. {#identifyreconcile-POST-queryenhanced__ul_axc_bxx_glb} Datentyp: Zeichenfolge |
| Ergebnis.ZusätzlichKommittedElemente.IdentifikationAttempts.Attribute | Array von CI-Bezeichnereintragsattributen, die während dieses zusätzlichen CI-Identifizierungsversuchs verwendet werden. Datentyp: Array Attributnamen und -Typen hängen von den Anforderungstext-Daten und dem verwendeten Bezeichner ab, z. B.: "attributes": [ "serial_number": "String", "serial_number_type": "String" ] |
| Ergebnis.ZusätzlichCommittedItems.identificationAttempts.hybridEintragungCiAttribute | Liste der CI-Bezeichnereintragsattribute, die während dieses zusätzlichen CI-Identifizierungsversuchs verwendet werden. Datentyp: Array Attributnamen und -Typen hängen von den Anforderungstext-Daten und dem verwendeten Bezeichner ab, z. B.: "hybridEntryCiAttributes": [ "name": "String", "serial_number": "String" ] |
| Ergebnis.zusätzlichCommittedItems.identificationAttempts.identifierName | Bezeichnerregel, die für diesen zusätzlichen CI-Identifizierungsversuch verwendet wird. Datentyp: Zeichenfolge |
| result.additionalCommittedItems.identificationAttempts.searchOnTable | Name der Tabelle, die für diesen zusätzlichen CI-Identifizierungsversuch gesucht wurde. Datentyp: Zeichenfolge |
| Ergebnis.ZusätzlichCommittedItems.identifierEintragungSysId | SYS_ID für die Bezeichnerregel, die zur Identifizierung dieses zusätzlichen CI verwendet wird. Bedeutende Werte: * Unbekannt: Identifizierung dieses zusätzlichen CI fehlgeschlagen. Details siehe errors. {#identifyreconcile-POST-queryenhanced__ul_hlk_gyx_glb} Datentyp: Zeichenfolge |
| result.additionalCommittedItems.inputIndices | Liste der Indexwerte für CIs aus dem Anforderungstext itemsArray, das diesem zusätzlichen CI entspricht. Datentyp: Array von Objekten "inputIndices": [ { Number } ] |
| Ergebnis.ZusätzlichCommittedElemente.Markierungen | Liste der Markerwerte für die interne Verwendung. Datentyp: Array "markers": [] |
| Ergebnis.zusätzlichCommittedItems.mergedNutzlasten | Liste der sys_ID-Werte für Teilnutzlasten aus der Tabelle „Teilnutzlasten für CMDB-Ire \[cmdb_ire_partial_payloads\]", die während der Verarbeitung dieses zusätzlichen CI zusammengeführt wurden. Datentyp: Array "mergedPayloadIds": [ "String" ] |
| Ergebnis.ZusätzlichCommittedElemente.Vorgang | Vorgang, der für dieses zusätzliche CI ausgeführt wird. Mögliche Werte: * LÖSCHEN: Ein vorhandenes CI wird aus der Zieltabelle entfernt. * EINFÜGEN: Das zusätzliche CI wird als neuer Datensatz in die Zieltabelle eingefügt. * NO_CHANGE: Für das zusätzliche CI wird kein Vorgang ausgeführt. * AKTUALISIEREN: Ein vorhandenes CI in der Zieltabelle wird aktualisiert. * UPDATE_WITH_DOWNGRADE: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine generischere Klasse (Vorgängerklasse) geändert. * UPDATE_WITH_SWITCH: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine andere Klasse geändert, die keine Vorgänger- oder untergeordnete Klasse ist. * UPDATE_WITH_UPGRADE: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine speziellere Klasse (untergeordnete Klasse) geändert. {#identifyreconcile-POST-queryenhanced__ul_dwt_qwx_glb} Datentyp: Zeichenfolge |
| Ergebnis.zusätzlichCommittedItems.sysId | SYS_ID für dieses zusätzliche CI durch Identifizierung gefunden. Bedeutende Werte: Unbekannt -- Identifizierung dieses zusätzlichen CI fehlgeschlagen. Details siehe errors. Datentyp: Zeichenfolge |
| Ergebnis.ZusätzlichKommittedElemente.Warnungen | Liste der Warnungen, die bei der Verarbeitung dieses zusätzlichen CI aufgetreten sind. Datentyp: Array von Objekten "warnings": [ { "error": "String", "message": "String" } ] |
| Ergebnis.zusätzlichCommittedElemente.Warnungen.Fehler | Typ der Warnung, die bei der Verarbeitung dieses zusätzlichen CI aufgetreten ist. Datentyp: Zeichenfolge |
| Ergebnis.ZusätzlichCommittedElemente.Warnungen.Nachricht | Warnmeldung beim Verarbeiten dieses zusätzlichen CI aufgetreten. Datentyp: Zeichenfolge |
| Ergebnis.ZusätzlichZusammenarbeitenBeziehungen | Liste der abhängigen Beziehungs-CIs, die nicht im Anforderungstext enthalten sind relationsListe zum Einfügen oder Aktualisieren. Datentyp: Array von Objekten "additionalCommittedRelations": [ { "className": "String", "operation": "String", "markers": [Array], "inputIndices": [Array], "mergedPayloadIds": [Array] } ] |
| Ergebnis.ZusätzlichZusammenarbeitenBeziehungen.className | Der sys_class_Name dieses zusätzlichen abhängigen Beziehungs-CI. Nur unterstützter Wert: * cmdb_rel_ci: Die CI-Beziehungstabelle. {#identifyreconcile-POST-queryenhanced__ul_bsb_pxx_glb} Datentyp: Zeichenfolge |
| Ergebnis.ZusätzlichCommittedBeziehungen.Fehleranzahl | Anzahl der Fehler, die bei der Verarbeitung dieses zusätzlichen abhängigen Beziehungs-CI aufgetreten sind. Datentyp: Zahl |
| Ergebnis.ZusätzlichZusammenarbeitenBeziehungen.Fehler | Liste der Fehler, die bei der Verarbeitung dieses zusätzlichen abhängigen Beziehungs-CI aufgetreten sind. Datentyp: Array von Objekten "errors": [ { "error": "String", "message": "String" } ] |
| Ergebnis.ZusätzlichZusammenarbeitenBeziehungen.Fehler.Fehler | Typ des beim Verarbeiten dieses zusätzlichen abhängigen Beziehungs-CI aufgetretenen Fehlers. Datentyp: Zeichenfolge |
| Ergebnis.ZusätzlichCommittedBeziehungen.Fehler.Nachricht | Beim Verarbeiten dieses zusätzlichen abhängigen Beziehungs-CI ist eine Fehlermeldung aufgetreten. Datentyp: Zeichenfolge |
| result.additionalCommittedRelations.inputIndices | Liste der Indexwerte für abhängige Beziehungs-CI-Objekte im Anforderungstext relationsArray, das diesem zusätzlichen abhängigen Beziehungs-CI entspricht. Datentyp: Array "inputIndices": [ Number ] |
| Ergebnis.ZusätzlichZusammenarbeitenBeziehungen.Markierungen | Liste der Markerwerte für die interne Verwendung. Datentyp: Array "markers": [] |
| Ergebnis.ZusätzlichCommittedRelations.mergedPayloadIds | Liste der sys_ID-Werte für Teilnutzlasten aus der Tabelle „Teilnutzlasten für CMDB-Ire \[cmdb_ire_partial_payloads\]", die während der Verarbeitung dieses zusätzlichen abhängigen Beziehungs-CI zusammengeführt wurden. Datentyp: Array "mergedPayloadIds": [ "String" ] |
| Ergebnis.ZusätzlichCommittedBeziehungen.Vorgang | Vorgang, der für dieses zusätzliche abhängige Beziehungs-CI ausgeführt wird. Mögliche Werte: * EINFÜGEN: Das abhängige Beziehungs-CI wird als neuer Datensatz in die Zieltabelle eingefügt. * INSERT_AS_INPLETE: Das abhängige Beziehungs-CI wies Fehler auf und wird in die Tabelle „unvollständige Nutzlasten für CMDB-Ire \[cmdb_ire_incomplete_payloads\] eingefügt. * INSERT_AS_PARTIAL: Das abhängige Beziehungs-CI wies Fehler auf und wird in die Tabelle „partielle Ire-Nutzlasten" \[cmdb_ire_partial_payloads\] eingefügt. * NO_CHANGE: Für das abhängige Beziehungs-CI wird kein Vorgang ausgeführt. * AKTUALISIEREN: Ein vorhandenes abhängiges Beziehungs-CI in der Zieltabelle wird aktualisiert. {#identifyreconcile-POST-queryenhanced__ul_ltk_vxx_glb} Datentyp: Zeichenfolge |
| result.items | Liste der CIs, die im Anforderungstext enthalten sind itemsArray. Datentyp: Array von Objekten "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 | Liste der zugehörigen CIs (Tabellensuche-CI) aus der Tabelle „partielle Ire-Nutzlasten" \[cmdb_ire_partial_payloads\]. Datentyp: Array von Objekten "additionalRelatedItems": [ { "className": "String", "inputIndices": [Array], "markers": [Array], "mergedPayloadIds": [Array], "sysId": "String" } ] |
| result.items.additionalRelatedItems.className | Der sys_class_Name des zugehörigen Elements. Datentyp: Zeichenfolge |
| result.items.additionalRelatedItems.inputIndices | Liste der Indexwerte für CIs aus dem Anforderungstext itemsArray, das diesem zugehörigen Element entspricht. Datentyp: Array "inputIndices": [ Number ] |
| result.items.additionalRelatedItems.markers | Liste der Markerwerte für die interne Verwendung. Datentyp: Array "markers": [] |
| result.items.additionalRelatedItems.mergedPayloadIds | Liste der sys_ID-Werte für Teilnutzlasten aus der Tabelle „Teilnutzlasten für CMDB-Ire \[cmdb_ire_partial_payloads\]", die während der Verarbeitung dieses zugehörigen Elements zusammengeführt wurden. Datentyp: Array "mergedPayloadIds": [ "String" ] |
| result.items.additionalRelatedItems.sysId | SYS_ID dieses zugehörigen CI. Datentyp: Zeichenfolge |
| result.items.className | SYS_class_Name dieses CI. Datentyp: Zeichenfolge |
| result.items.duplicateLookupIndices | Objekt mit Arrays von Indexwerten für items.lookupArray-Elemente, die auf dasselbe zugehörige CI verweisen. Der Array-Name gibt das erste Element aus dem Anforderungstext an items.lookupArray, das auf ein bestimmtes zugehöriges CI verweist. Seine Werte sind der Satz zusätzlicher Elemente aus demselben Array, die auf dasselbe zugehörige CI verweisen. Datentyp: Objekt Dieses Beispiel zeigt einen Fall, in dem das zweite Element in angezeigt wird items.lookupArray verweist auf dasselbe zugehörige CI als späteres Element aus diesem Array: "duplicateLookupIndices": [ "2": [Array] ] |
| result.items.errorCount | Anzahl der beim Verarbeiten dieses CI aufgetretenen Fehler. Datentyp: Zahl |
| result.items.errors | Liste der Fehler, die bei der Verarbeitung dieses CI aufgetreten sind. Datentyp: Array von Objekten "errors": [ { "error": "String", "message": "String" } ] |
| result.items.errors.error | Typ des beim Verarbeiten dieses CI aufgetretenen Fehlers. Datentyp: Zeichenfolge |
| result.items.errors.message | Beim Verarbeiten dieses CI ist eine Fehlermeldung aufgetreten. Datentyp: Zeichenfolge |
| result.items.identificationAttempts | Liste der Versuche, dieses CI zu identifizieren. Datentyp: Array von Objekten "identificationAttempts": [ { "attemptResult": "String", "attributes": [Array], "hybridEntryCiAttributes": [Array], "identiferName": "String", "searchOnTable": [Array] } ] |
| result.items.identificationAttempts.attemptResult | Ergebnis dieses CI-Identifizierungsversuchs. Mögliche Werte: * ÜBEREINSTIMMEND: Identifizierung erfolgreich. In der Bezeichnerregeltabelle wurde ein eindeutiges CI gefunden, das genau mit den angegebenen Attributen übereinstimmte. * MULTI_MATCH: Identifizierung mit Fehler fehlgeschlagen. Doppelte CIs wurden in der Bezeichnerregeltabelle beim Abgleich mit den angegebenen Attributen gefunden. * NO_MATCH: Identifizierung fehlgeschlagen. In der Bezeichnerregeltabelle wurde kein CI gefunden, das den angegebenen Attributen entsprach. * ÜBERSPRUNGEN: Identifizierung nicht versucht. Die für diese Bezeichnerregeltabellensuche erforderlichen Attribute wurden nicht angegeben, daher wurde die Regel nicht angewendet. {#identifyreconcile-POST-queryenhanced__ul_gmw_qn5_flb} Datentyp: Zeichenfolge |
| result.items.identificationAttempts.attributes | Liste der CI-Bezeichnereintragsattribute, die während dieses CI-Identifizierungsversuchs verwendet wurden. Datentyp: Array Attributnamen und -Typen hängen von den Anforderungstext-Daten und dem verwendeten Bezeichner ab, z. B.: "attributes": [ "serial_number": "String", "serial_number_type": "String", ] |
| result.items.identificationAttempts.hybridEntryCiAttributes | Liste der CI-Bezeichnereintragsattribute, die während dieses CI-Identifizierungsversuchs verwendet wurden. Datentyp: Array Attributnamen und -Typen hängen von den Anforderungstext-Daten und dem verwendeten Bezeichner ab, z. B.: "hybridEntryCiAttributes": [ "name": "String", "serial_number": "String" ] |
| result.items.identificationAttempts.identifierName | Bezeichnerregel, die für diesen CI-Identifizierungsversuch verwendet wird. Datentyp: Zeichenfolge |
| result.items.identificationAttempts.searchOnTable | Name der Tabelle, die für diesen CI-Identifizierungsversuch gesucht wurde. Datentyp: Zeichenfolge |
| result.items.identifierEntrySysId | SYS_ID für die Bezeichnerregel, die zur Identifizierung dieses CI verwendet wird. Bedeutende Werte: * Unbekannt: Identifizierung dieses CI fehlgeschlagen. Details finden Sie unter errors. {#identifyreconcile-POST-queryenhanced__ul_lzk_rvb_glb} Datentyp: Zeichenfolge |
| result.items.info | Liste zusätzlicher Informationen zur Verarbeitung des Elements. Datentyp: Array von Objekten "info": [ { "code": "String", "message": "String", "ruleSysId": "String" } ] |
| result.items.info.code | Reklassifizierungstyp, der übersprungen wurde. Mögliche Werte: * ÜBERSPRUNGEN_CLASS_SWITCH * SKIPPED_CLASS_DOWNGRADE * ÜBERSPRUNGEN_CLASS_UPGRADE {#identifyreconcile-POST-queryenhanced__ul_pb2_dxp_snb} |
| result.items.info.message | Nachricht, die zusätzliche Einblicke in den Grund für das Überspringen der Neuklassifizierung bietet. Datentyp: Zeichenfolge |
| result.items.info.ruleSysId | SYS_ID der Reklassifizierungseinschränkungsregel, die abgeglichen wurde. Gilt nur, wenn Ire die Neuklassifizierung aufgrund der Reklassifizierungseinschränkungsregel überspringt. Dieser Wert ist leer, wenn die Neuklassifizierung aufgrund einer Nutzlast oder einer globalen Kennzeichnung übersprungen wird. Datentyp: Zeichenfolge |
| result.items.inputIndices | Liste der Indexwerte für CIs aus dem Anforderungstext itemsArray, das diesem CI entspricht. Datentyp: Array von Objekten "inputIndices": [ { Number } ] |
| result.items.markers | Liste der Markerwerte für die interne Verwendung. Datentyp: Array "markers": [] |
| result.items.mergedPayloadIds | Liste der sys_ID-Werte für Teilnutzlasten aus der Tabelle „Teilnutzlasten für CMDB-Ire \[cmdb_ire_partial_payloads\]", die während der Verarbeitung dieses CI zusammengeführt wurden. Datentyp: Array "mergedPayloadIds": [ "String" ] |
| result.items.operation | Für dieses CI ausgeführter Vorgang. Mögliche Werte: * LÖSCHEN: Ein vorhandenes CI wird aus der Zieltabelle entfernt. * EINFÜGEN: Das CI wird als neuer Datensatz in die Zieltabelle eingefügt. * NO_CHANGE: Für das CI wird kein Vorgang ausgeführt. * AKTUALISIEREN: Ein vorhandenes CI in der Zieltabelle wird aktualisiert. * UPDATE_WITH_DOWNGRADE: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine generischere Klasse (Vorgängerklasse) geändert. * UPDATE_WITH_SWITCH: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine andere Klasse geändert, die keine Vorgänger- oder untergeordnete Klasse ist. * UPDATE_WITH_UPGRADE: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine speziellere Klasse (untergeordnete Klasse) geändert. {#identifyreconcile-POST-queryenhanced__ul_jhl_gg5_flb} Datentyp: Zeichenfolge |
| result.items.relatedItems | Liste der zugehörigen CIs (Tabellensuche-CI) aus dem Anforderungstext items.lookupArray. Datentyp: Array von Objekten "relatedItems": [ { "className": "String", "inputIndices": [Array], "markers": [Array], "mergedPayloadIds": [Array], "sysId": "String" } ] |
| result.items.relatedItems.className | Der sys_class_Name des zugehörigen Elements. Datentyp: Zeichenfolge |
| result.items.relatedItems.inputIndices | Liste der Indexwerte für CIs und Suchelemente aus dem Anforderungstext itemsUnd items.lookupArrays, die diesem zugehörigen Element entsprechen. Datentyp: Array von Objekten "inputIndices": [ { "mainIndex": Number, "subIndex": Number } ] |
| result.items.relatedItems.inputIndices.mainIndex | Indexwert aus dem Anforderungstext itemsArray, das dem übergeordneten CI des zugehörigen Elements entspricht. Datentyp: Zahl |
| result.items.relatedItems.inputIndices.subIndex | Indexwert aus dem Anforderungstext items.lookupArray, das dem zugehörigen Element entspricht. Datentyp: Zahl |
| result.items.relatedItems.markers | Liste der Markerwerte für die interne Verwendung. Datentyp: Array "markers": [] |
| result.items.relatedItems.mergedPayloadIds | Liste der sys_ID-Werte für Einträge in der Tabelle „teilweise Nutzlasten des CMDB-Ire \[cmdb_ire_partial_payloads\]", die während der Verarbeitung mit diesem CI zusammengeführt wurden. Datentyp: Array "mergedPayloadIds": [ "String" ] |
| result.items.relatedSysIds | Liste der sys_ID-Werte für zugehörige Elemente (Tabellensuchelemente) aus dem Anforderungstext items.lookupArray. Datentyp: Array Bedeutende Werte: * Null: Für dieses zugehörige Element wurde keine sys_ID identifiziert. {#identifyreconcile-POST-queryenhanced__ul_zs5_f1y_glb} "relatedSysIds": [ Number, Number ] |
| result.items.sysId | SYS_ID für dieses CI durch Identifizierung gefunden. Bedeutende Werte: * Unbekannt: Identifizierung dieses CI fehlgeschlagen. Details siehe errors. {#identifyreconcile-POST-queryenhanced__ul_zz5_5vb_glb} Datentyp: Zeichenfolge |
| result.items.warnings | Liste der Warnungen, die bei der Verarbeitung dieses CI aufgetreten sind. Datentyp: Array von Objekten "warnings": [ { "error": "String", "message": "String" } ] |
| result.items.warnings.error | Typ der Warnung, die bei der Verarbeitung dieses CI aufgetreten ist. Datentyp: Zeichenfolge |
| result.items.warnings.message | Warnmeldung beim Verarbeiten dieses CI aufgetreten. Datentyp: Zeichenfolge |
| Ergebnis.logKontextId | Kontext-ID, die für diese Nutzlast gemeldet wurde. Datentyp: Zeichenfolge |
| Ergebnis.Beziehungen | Liste der abhängigen Beziehungs-CIs aus dem Anforderungstext relationsArray. Datentyp: Array von Objekten "relations": [ { "className": "String", "errorCount": Number, "errors": [Array], "inputIndices": [Array], "markers": [Array], "mergedPayloadIds": [Array], "operation": "String", "warnings": [Array] } ] |
| Ergebnis.Beziehungen.Klassenname | Der sys_class_Name dieses abhängigen Beziehungs-CI. Nur unterstützter Wert: * cmdb_rel_ci: Die CI-Beziehungstabelle. {#identifyreconcile-POST-queryenhanced__ul_ilx_d1v_flb} Datentyp: Zeichenfolge |
| Ergebnis.Beziehungen.Fehleranzahl | Anzahl der Fehler, die bei der Verarbeitung dieses abhängigen Beziehungs-CI aufgetreten sind. Datentyp: Zahl |
| Ergebnis.Beziehungen.Fehler | Liste der Fehler, die bei der Verarbeitung dieses abhängigen Beziehungs-CI aufgetreten sind. Datentyp: Array von Objekten "errors": [ { "error": "String", "message": "String" } ] |
| Ergebnis.Beziehungen.Fehler.Fehler | Typ des beim Verarbeiten dieses abhängigen Beziehungs-CI aufgetretenen Fehlers. Datentyp: Zeichenfolge |
| Ergebnis.Beziehungen.Fehler.Nachricht | Fehlermeldung beim Verarbeiten dieses abhängigen Beziehungs-CI aufgetreten. Datentyp: Zeichenfolge |
| result.relations.inputIndices | Liste der Indexwerte für die abhängigen Beziehungs-CI-Objekte im Anforderungstext relationsArray, das diesem abhängigen Beziehungs-CI entspricht. Datentyp: Array "inputIndices": [ Number ] |
| Ergebnis.Beziehungen.Markierungen | Liste der Markerwerte für die interne Verwendung. Datentyp: Array "markers": [] |
| Ergebnis.Beziehungen.mergedPayloadIds | Liste der sys_ID-Werte für Teilnutzlasten aus der Tabelle „Teilnutzlasten für CMDB-Ire \[cmdb_ire_partial_payloads\]", die während der Verarbeitung dieses abhängigen Beziehungs-CI zusammengeführt wurden. Datentyp: Array "mergedPayloadIds": [ "String" ] |
| Ergebnis.Beziehungen.Vorgang | Vorgang, der für dieses abhängige Beziehungs-CI ausgeführt wird. Mögliche Werte: * EINFÜGEN: Das abhängige Beziehungs-CI wurde als neuer Datensatz in die Zieltabelle eingefügt. * INSERT_AS_INPLETE: Das abhängige Beziehungs-CI wies Fehler auf und wurde in die Tabelle „unvollständige Nutzlasten für CMDB-Ire" \[cmdb_ire_incomplete_payloads\] eingefügt. * INSERT_AS_PARTIAL: Das abhängige Beziehungs-CI wies Fehler auf und wurde in die Tabelle „partielle Ire-Nutzlasten" \[cmdb_ire_partial_payloads\] eingefügt. * NO_CHANGE: Für das abhängige Beziehungs-CI wurde kein Vorgang ausgeführt. * UPDATE: Ein vorhandenes abhängiges Beziehungs-CI in der Zieltabelle wurde aktualisiert. {#identifyreconcile-POST-queryenhanced__ul_qd5_kg5_flb} Datentyp: Zeichenfolge |
| Ergebnis.Beziehungen.Warnungen | Liste der Warnungen, die bei der Verarbeitung dieses abhängigen Beziehungs-CI aufgetreten sind. Datentyp: Array von Objekten "warnings": [ { "error": "String", "message": "String" } ] |
| Ergebnis.Beziehungen.Warnungen.Fehler | Typ der Warnung, die bei der Verarbeitung dieses abhängigen Beziehungs-CI aufgetreten ist. Datentyp: Zeichenfolge |
| Ergebnis.Beziehungen.Warnungen.Nachricht | Warnmeldung beim Verarbeiten dieses abhängigen Beziehungs-CI aufgetreten. Datentyp: Zeichenfolge |
[ ]

{#identifyreconcile-POST-queryenhanced__table_gy4_yyn_rlb}  

### Curl-Anforderung

Simulieren Sie die Übermittlung einer Teilnutzlast für ein Computer-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" \
          } \
        } \
      ] \
    }'

Die Antwort zeigt an, dass die Nutzlast in die Tabelle „Teilnutzlasten für CMDB-Ire" \[cmdb_ire_partial_payloads\] eingefügt würde.

    {
      "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": []
      }
    }

Simulieren Sie die Übermittlung einer zweiten Teilnutzlast, die die Beschreibung des Computer-CI vervollständigt, wobei die Option „Erweiterter Ire für Zusammenfassungsgenerierung" aktiviert ist.

    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 '{ \
    }'

Die Antwort zeigt an, dass das Computer-CI eingefügt würde, und zeigt eine Zusammenfassung der ausgeführten Vorgänge an.

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


