---
sourceDocument: Xanadu-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/xanadu/api-reference
Release :
- xanadu
ft:locale :
- de-DE
ft:publication_title :
- Xanadu-API-Referenz
ft:clusterId :
- crapiref
bundleId :
- crapiref
workflow :
- Creator
---
# Identification and Reconciliation API
# Identification and Reconciliation API {#ariaid-title1}
* Freigeben Version: Xanadu
*
* Aktualisiert 1. August 2024
*
*  85 Minuten Lesedauer
Die Identification and Reconciliation API stellt Endpunkte bereit, die die Identification and Reconciliation Engine (IRE) verwenden, um die Erstellung von doppelten Configuration Items (CIs) zu minimieren und CI-Attribute abzugleichen, indem beim Aktualisieren von Configuration Management Database (CMDB)nur Informationen aus autorisierten Quellen akzeptiert werden.
Benutzer müssen über die Rolle „itil" oder „asset" verfügen, um diese API zu verwenden.
Weitere Informationen zur IRE finden Sie unter [Identification and Reconciliation Engine (IRE)](https://www.servicenow.com/docs/access?context=ire&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US).
## Identifizierung und Abgleich -- POST /now/identifyreconcile {#ariaid-title2}
Fügt Konfigurationselemente (CIs) in CMDB ein oder aktualisiert sie, indem auf die angegebene Nutzlast (Anforderungstext) Identifizierungs- und Abgleichregeln angewendet werden. Verwenden Sie diese API, anstatt CMDB direkt zu aktualisieren.
Verwenden Sie den Endpunkt [Identifizierung und Abgleich -- POST /now/identifyreconcile/query](https://servicenow-prod.fluidtopics.net/ZRNLHAWYFKoNwL1GNeNMig#identifyreconcile-POST-query "Bestimmt den CMDB -Vorgang (Einfügen/Aktualisieren), der mit der angegebenen Nutzlast (Anforderungstext) ausgeführt werden soll, ohne dass die Vorgänge in der Datenbank committet werden."), um die Übermittlung einer Nutzlast an diesen Endpunkt zu simulieren, ohne Änderungen an der Datenbank festzuschreiben.
Verwenden Sie stattdessen den Endpunkt [Identifizierung und Abgleich -- POST /now/identifyreconcile/enhanced](https://servicenow-prod.fluidtopics.net/ZRNLHAWYFKoNwL1GNeNMig#identifyreconcile-POST-enhanced "Fügt Konfigurationselemente (CIs) in CMDB ein oder aktualisiert sie, indem auf die angegebene Nutzlast (Anforderungstext) Identifizierungs- und Abgleichregeln angewendet werden. Verwenden Sie diese API, anstatt CMDB direkt zu aktualisieren."), wenn Sie erweiterte IRE-Optionen angeben müssen. Weitere Informationen zu erweiterten IRE-Optionen finden Sie unter [Identification and Reconciliation Engine (IRE)](https://www.servicenow.com/docs/access?context=ire&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US).
### URL-Format
URL mit Versionsnummer: /api/now/{api_version}/identifyreconcile
Standard-URL: /api/now/identifyreconcile
### Unterstützte Anforderungsparameter
{#identifyreconcile-POST__entry__2}{#identifyreconcile-POST__version-RESTAPI}
| Name | Beschreibung |
|-|-|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum Beispiel v1 oder v2. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge |
[Tabelle : 1. Pfadparameter]
{#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 der unvollständigen 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 zu erstellenden oder zu aktualisierenden CIs. Datentyp: Array von Objekten "items": [ { "className": "String", "internal_id": "String", "lookup": [Array], "related": [Array], "settings": {Object}, "sys_object_source_info": {Object}, "values": {Object} } ] |
| elemente.klassenname | Erforderlich. Der sys_class_name (Klassen-/Tabellenname) des zu erstellenden oder zu aktualisierenden CI. Dieser Wert kann eine beliebige Tabelle CMDB sein, z. B. cmdb_ci_linux_server oder cmdb_ci_win_server. Datentyp: Zeichenfolge |
| item.internal_id | Eindeutiger Bezeichner für das Element in dieser Nutzlast Kann ein beliebiger Wert sein, muss aber innerhalb der Nutzlast eindeutig sein. Datentyp: Zeichenfolge |
| Items.Suche | Array von Objekten, in dem 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 zurück auf die Tabelle „Konfigurationselement" \[cmdb_ci\] enthält. Datentyp: Array aus Objekten "lookup": [ { "className": "String", "internal_id": "String", "sys_object_source_info": {Object}, "values": {Object} } ] |
| elemente.suche.klassenname | Erforderlich. sys_class_name oder Klassen-/Tabellenname des zu erstellenden oder zu aktualisierenden CI. Dieser Wert kann eine beliebige CMDB -Klasse/-Tabelle sein, z. B. cmdb_serial_number oder cmdb_ci_network_adapter, oder eine NichtCMDB -\[\]- Hierarchieklasse. Datentyp: Zeichenfolge |
| elemente.suche.internal_id | Eindeutiger Bezeichner für den Suchdatensatz in dieser Nutzlast Kann ein beliebiger Wert sein, muss aber innerhalb der Nutzlast eindeutig sein. Datentyp: Zeichenfolge |
| item.lookup.sys_object_source_info | Objekt, das einen eindeutigen CI-Bezeichner für eine angegebene Datenquelle beschreibt. Verschiedene Quellen können unterschiedliche Name/Wert-Paare für dasselbe CI aufweisen. Datentyp: Objekt "sys_object_source_info": { "source_feed": "String", "source_name": "String", "source_native_key": "String", "source_recency_timestamp": "String" } |
| item.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 |
| item.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 |
| item.lookup.sys_object_source_info.source_native_key | Eindeutiger Schlüssel/eindeutige ID aus der Quelle für das CI. Kann eine beliebige Zeichenfolge sein, die für das Element eindeutig ist. Datentyp: Zeichenfolge |
| item.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 |
| elemente.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 dem jedes Objekt einen zu erstellenden oder zu aktualisierenden Elementdatensatz beschreibt, basierend auf einer zugehörigen Tabelle, die einen Verweis auf das identifizierte CI der obersten Ebene enthält. Regeln in der Tabelle „Zugehöriger Eintrag" \[cmdb_related_entry\] definieren, welche Arten von Datensätzen dieses Array enthalten darf. Die zugehörige Tabelle kann die Konfigurationselement-Tabelle \[cmdb_ci\] erweitern, muss es aber nicht. Diese Datensätze werden nicht zum Identifizieren des Konfigurationselements verwendet. Datentyp: Array von Objekten "related": [ { "className": "String", "internal_id": "String", "sys_object_source_info": {Object}, "values": {Object} } ] |
| elemente.zugehörig.klassenname | Erforderlich. sys_class_name oder Klassen-/Tabellenname des zugehörigen Elements, das erstellt oder aktualisiert werden soll. Datentyp: Zeichenfolge |
| elemente.zugehörig.internal_id | Eindeutiger Bezeichner für das zugehörige Element in dieser Nutzlast Kann ein beliebiger Wert sein, muss aber innerhalb der Nutzlast eindeutig sein. Datentyp: Zeichenfolge |
| item.related.sys_object_source_info | Objekt, das einen eindeutigen CI-Bezeichner für eine angegebene Datenquelle beschreibt. Verschiedene Quellen können unterschiedliche Name/Wert-Paare für dasselbe CI aufweisen. Datentyp: Objekt "sys_object_source_info": { "source_feed": "String", "source_name": "String", "source_native_key": "String", "source_recency_timestamp": "String" } |
| item.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 |
| item.related.sys_object_source_info.source_name | Datenquelle für die zugehörigen Artikelinformationen. Dieser Wert muss einer der Auswahlwerte sein, die für das Feld „discovery_source" der Tabelle „Konfigurationselement" \[cmdb_ci\] definiert sind. Datentyp: Zeichenfolge |
| item.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 |
| item.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 die für dieses zugehörige Element zu erstellenden oder zu aktualisierenden Felder als Name/Wert-Paare beschreibt, 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" } |
| elemente.einstellungen | Objekt mit Parametern, die festlegen, welche Arten von Updates zulässig sind. Datentyp: Objekt "settings": { "skipReclassificationRestrictionRules": Boolean, "updateWithoutDowngrade": Boolean, "updateWithoutSwitch": Boolean, "updateWithoutUpgrade": Boolean } |
| elemente.einstellungen.reklassifizierungsbeschränkungsregeln überspringen | Kennzeichnung, die angibt, ob IRE die Ausführung der Regel zur Einschränkung der Neuklassifizierung überspringen soll, die der Klasse für das Nutzlastelement entspricht. Gültige Werte: * true: Ausführung der Regel überspringen. * „falsch": Führen Sie die Regel aus. Standardwert: false |
| elemente.einstellungen.updateOhneDowngrade | Kennzeichnung, die angibt, ob Update und Downgrade für dieses CI zulässig sind. Gültige Werte: * „wahr": Element wird aktualisiert, Downgrade ist jedoch nicht zulässig. * false: Sowohl Elementaktualisierungen als auch Downgrades sind zulässig. Datentyp: Boolesch Standardwert: false |
| elemente.einstellungen.updateOhneSchalter | Kennzeichnung, die angibt, ob dieses CI aktualisiert und seine Klasse gewechselt werden kann. Gültige Werte: * „wahr": Element wird aktualisiert, aber Klassenwechsel ist nicht zulässig. * false: Sowohl Elementaktualisierungen als auch Klassenwechsel sind zulässig. Datentyp: Boolesch Standardwert: false |
| elemente.einstellungen.updateOhneUpgrade | Kennzeichnung, die angibt, ob Update und Upgrade für dieses CI zulässig sind. Gültige Werte: * „wahr": Element wird aktualisiert, aber Upgrade ist nicht zulässig. * „falsch": Sowohl Element-Updates als auch -Upgrades sind zulässig. Datentyp: Boolesch Standardwert: false |
| item.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" } |
| item.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 |
| item.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 |
| item.sys_object_source_info.source_native_key | Eindeutiger Schlüssel/eindeutige ID aus der Quelle für das CI. Kann eine beliebige Zeichenfolge sein, die für das Element eindeutig ist. Datentyp: Zeichenfolge |
| item.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 die für dieses CI zu erstellenden oder zu aktualisierenden Felder als Name/Wert-Paare beschreibt, 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 | Referenzliste zwischen zwei Elementen in der Nutzlast. Datentyp: Array von Objekten "referenceItems": [ { "referenced": "String", "referencedBy": "String", "referenceField": "String" } ] |
| referenceItems.referenced | internal_id, das für das Element definiert ist, auf das von einem anderen Element verwiesen wird. Datentyp: Zeichenfolge |
| referenceItems.referencedBy | internal_id, das für das Element definiert ist und auf ein anderes Element verweist. Datentyp: Zeichenfolge |
| referenceItems.referenceField | Name des Referenzfelds in der Klasse/Tabelle für das Element referencedBy. Datentyp: Zeichenfolge |
| relations | Liste der Beziehungen zwischen zwei in der Nutzlast definierten Elementen. Ein Objekt in diesem Array kann eines von zwei Formaten verwenden: * Das Objekt kann eine Beziehung zwischen zwei Elementen der obersten Ebene (nur) mithilfe von Name-Wert-Paaren parent und child definieren, wobei Werte Elementindizes aus dem Nutzlast-Array items darstellen. * Das Objekt kann eine Beziehung zwischen zwei beliebigen Elementen definieren, einschließlich Elementen der obersten Ebene, zugehörigen Elementen oder Suchelementen, indem Schlüssel-Wert-Paare parent_id und child_id verwendet werden, wobei -Werte die für diese Elemente definierten internal_id -Werte darstellen. {#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" } ] |
| beziehungen.untergeordnetes element | Ganzzahlindex des CI-Objekts im Array items, das das untergeordnete Element in der Beziehung darstellt. Datentyp: Zahl |
| beziehungen.child_id | internal_id des untergeordneten Elements in der Beziehung. Datentyp: Zeichenfolge |
| beziehungen.übergeordnet | Ganzzahlindex des CI-Objekts im Array items, das das übergeordnete Element in der Beziehung darstellt. Datentyp: Zahl |
| beziehungen.parent_id | internal_id des übergeordneten Elements in der Beziehung. Datentyp: Zeichenfolge |
| beziehungen.sys_rel_source_info | Informationen zur Discovery-Quelle für die Beziehung. Bei Nicht-Abhängigkeitsbeziehungen befinden sich diese Informationen in der Tabelle „Beziehungsquellen" \[sys_rel_source\]. Datentyp: Objekt "sys_rel_source_info": { "source_name": "String", "source_feed": "String" } |
| beziehungen.sys_rel_source_info.quellenname | Name der Discovery-Quelle. Standard: Discovery-Quelle, die im API-Methodenparameter übergeben wird. |
| beziehungen.sys_rel_source_info.source_feed | Beliebige Zeichenfolge, die eine Unter-Discovery/ein Unterscan 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.type | Typ der Beziehung zwischen den übergeordneten und untergeordneten Elementen. Dies muss ein Namensfeldwert aus der Tabelle „CI-Beziehungstyp" \[cmdb_rel_type\] sein. Datentyp: Zeichenfolge |
[Tabelle : 3. Anforderungstextparameter (XML oder JSON)]
### Kopfzeilen
Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. 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/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass 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}
| Kopfzeile | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützt nur application/json. |
| Content-Type | Datenformat des Anforderungstexts. Unterstützt nur application/json. |
[Tabelle : 4. Anforderungskopfzeilen]
{#identifyreconcile-POST__entry__108}
| Kopfzeile | Beschreibung |
|-|-|
| Keine | |
[Tabelle : 5. Antwortkopfzeilen]
### 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 [HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.")der REST-API.
{#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 Anmeldeinformationen sind falsch oder wurden nicht übergeben. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Der Antworttext enthält Informationen zum Fehler. |
[Tabelle : 6. Statuscodes]
### Parameter des Antworttexts (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] ] |
| result.additionalCommittedItems | Liste der CIs, die nicht im Array des Anforderungstexts items zum Einfügen oder Aktualisieren enthalten sind. Datentyp: Array von Objekten "additionalCommittedItems": [ { "className": "String", "errorCount": Number, "identificationAttempts": [Array], "inputIndices": [Array], "markers": [Array], "mergedPayloads": [Array], "operation": "String", "sysId": "String" } ] |
| result.additionalCommittedItems.className | Der sys_class_name dieses zusätzlichen CI. Datentyp: Zeichenfolge |
| Ergebnis.zusätzlichefestgelegteElemente.Fehleranzahl | Anzahl der bei der Verarbeitung dieses zusätzlichen CI aufgetretenen Fehler. Datentyp: Zahl |
| Ergebnis.zusätzlicheCommittedItems.errors | Liste der Fehler, die bei der Verarbeitung dieses zusätzlichen CI aufgetreten sind. Datentyp: Array von Objekten "errors": [ { "error": "String", "message": "String" } ] |
| result.additionalCommittedItems.errors.error | Typ des Fehlers, der bei der Verarbeitung dieses zusätzlichen CI aufgetreten ist. Datentyp: Zeichenfolge |
| Ergebnis.zusätzlicheCommittedItems.errors.message | Fehlermeldung bei der Verarbeitung dieses zusätzlichen CI. Datentyp: Zeichenfolge |
| Ergebnis.ZusätzlicheZusätzlicheElemente.Identifizierungsversuche | Liste der Versuche, die unternommen wurden, um dieses zusätzliche CI zu identifizieren. Datentyp: Array von Objekten "identificationAttempts": [ { "attemptResult": "String", "attributes": [Array], "hybridEntryCiAttributes": [Array], "identiferName": "String", "searchOnTable": [Array] } ] |
| Ergebnis.zusätzlicheZusätzlicheElemente.Identifizierungsversuche.Versuchsergebnis | Ergebnis dieses zusätzlichen CI-Identifizierungsversuchs. Mögliche Werte: * ABGEGLICHEN: Identifizierung erfolgreich. In der Identifier-Regeltabelle wurde ein eindeutiges CI gefunden, das genau mit den angegebenen Attributen übereinstimmt. * Multi_MATCH: Die Identifizierung ist mit einem Fehler fehlgeschlagen. In der Identifier-Regeltabelle wurden beim Abgleich mit den angegebenen Attributen doppelte CIs gefunden. * NO_MATCH: Identifizierung fehlgeschlagen. In der Identifier-Regeltabelle wurde kein CI gefunden, das den angegebenen Attributen entspricht. * ÜBERSPRUNGEN: Identifizierung nicht versucht. Die für die Suche in dieser Identifier-Regeltabelle erforderlichen Attribute wurden nicht angegeben, daher wurde die Regel nicht angewendet. {#identifyreconcile-POST__ul_axc_bxx_glb} Datentyp: Zeichenfolge |
| Ergebnis.zusätzlicheZusätzlicheElemente.Identifizierungsversuche.Attribute | Array von CI-Identifier-Eintragsattributen, die bei diesem zusätzlichen CI-Identifizierungsversuch verwendet werden. Datentyp: Array Attributnamen und -typen hängen von den Anforderungstextdaten und dem verwendeten Bezeichner ab, z. B.: "attributes": [ "serial_number": "String", "serial_number_type": "String" ] |
| Ergebnis.zusätzlicheCommittedItems.IdentificationAttempts.HybridEntryCiAttributes | Liste der CI-Bezeichner-Eintragsattribute, die bei diesem zusätzlichen CI-Identifizierungsversuch verwendet werden. Datentyp: Array Attributnamen und -typen hängen von den Anforderungstextdaten und dem verwendeten Bezeichner ab, z. B.: "hybridEntryCiAttributes": [ "name": "String", "serial_number": "String" ] |
| Ergebnis.zusätzlichefestgelegteElemente.Identifizierungsversuche.Bezeichnername | Identifier-Regel, die für diesen zusätzlichen CI-Identifizierungsversuch verwendet wird. Datentyp: Zeichenfolge |
| result.additionalCommittedItems.identificationAttempts.searchOnTable | Name der Tabelle, in der nach diesem zusätzlichen CI-Identifizierungsversuch gesucht wurde. Datentyp: Zeichenfolge |
| result.additionalCommittedItems.identifierEntrySysId | Sys_id für die Identifier-Regel, die zum Identifizieren dieses zusätzlichen CI verwendet wird. Bemerkbare Werte: * Unbekannt: Die Identifizierung dieses zusätzlichen CI ist fehlgeschlagen. Details siehe errors. {#identifyreconcile-POST__ul_hlk_gyx_glb} Datentyp: Zeichenfolge |
| result.additionalCommittedItems.inputIndices | Liste der Indexwerte für CIs aus dem Array des Anforderungstextes items, die diesem zusätzlichen CI entsprechen. Datentyp: Array von Objekten "inputIndices": [ { Number } ] |
| Ergebnis.zusätzlicheCommittedItems.Marker | Liste der Markerwerte zur internen Verwendung. Datentyp: Array "markers": [] |
| result.additionalCommittedItems.mergedPayloads | Liste der sys_id-Werte für Teilnutzlasten aus der Tabelle „Teilliche CMDB-IRE-Nutzlasten" \[cmdb_ire_partial_payloads\], die während der Verarbeitung dieses zusätzlichen CI zusammengeführt wurden. Datentyp: Array "mergedPayloadIds": [ "String" ] |
| result.additionalCommittedItems.operation | Für dieses zusätzliche CI durchgeführter Vorgang. 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. * UPDATE: 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 allgemeinere 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ängerklasse oder untergeordnete Klasse ist. * UPDATE_WITH_UPGRADE: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine spezialisiertere Klasse (absteigende Klasse) geändert. {#identifyreconcile-POST__ul_dwt_qwx_glb} Datentyp: Zeichenfolge |
| result.additionalCommittedItems.sysId | Sys_id für dieses zusätzliche CI durch Identifizierung gefunden. Bemerkbare Werte: Unbekannt: Die Identifizierung dieses zusätzlichen CI ist fehlgeschlagen. Details siehe errors. Datentyp: Zeichenfolge |
| Ergebnis.zusätzlicheCommittedItems.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ätzlicheCommittedItems.Warnungen.Fehler | Typ der Warnung, die bei der Verarbeitung dieses zusätzlichen CI aufgetreten ist. Datentyp: Zeichenfolge |
| Ergebnis.zusätzlicheCommittedItems.Warnungen.Nachricht | Bei der Verarbeitung dieses zusätzlichen CI ist eine Warnmeldung aufgetreten. Datentyp: Zeichenfolge |
| result.additionalCommittedRelations | Liste der abhängigen Beziehungs-CIs, die nicht in der Liste des Anforderungstextes relations zum Einfügen oder Aktualisieren enthalten sind. Datentyp: Array von Objekten "additionalCommittedRelations": [ { "className": "String", "operation": "String", "markers": [Array], "inputIndices": [Array], "mergedPayloadIds": [Array] } ] |
| result.additionalCommittedRelations.className | Der sys_class_name dieses zusätzlichen abhängigen Beziehungs-CI. Einziger unterstützter Wert: * cmdb_rel_ci: Die CI-Beziehungstabelle. {#identifyreconcile-POST__ul_bsb_pxx_glb} Datentyp: Zeichenfolge |
| result.additionalCommittedRelations.errorCount | Anzahl der Fehler, die bei der Verarbeitung dieses zusätzlichen abhängigen Beziehungs-CI aufgetreten sind. Datentyp: Zahl |
| Ergebnis.zusätzlicheCommittedRelations.errors | Liste der Fehler, die bei der Verarbeitung dieses zusätzlichen CI für abhängige Beziehungen aufgetreten sind. Datentyp: Array von Objekten "errors": [ { "error": "String", "message": "String" } ] |
| result.additionalCommittedRelations.errors.error | Typ des Fehlers, der bei der Verarbeitung dieses zusätzlichen abhängigen Beziehungs-CI aufgetreten ist. Datentyp: Zeichenfolge |
| Ergebnis.zusätzlicheBestätigteBeziehungen.Fehler.Nachricht | Fehlermeldung beim Verarbeiten dieses zusätzlichen abhängigen Beziehungs-CI. Datentyp: Zeichenfolge |
| result.additionalCommittedRelations.inputIndexes | Liste der Indexwerte für abhängige Beziehungs-CI-Objekte im Array des Anforderungstexts relations, die diesem zusätzlichen abhängigen Beziehungs-CI entsprechen. Datentyp: Array "inputIndices": [ Number ] |
| result.additionalCommittedRelations.markers | Liste der Markerwerte zur internen Verwendung. Datentyp: Array "markers": [] |
| result.additionalCommittedRelations.mergedPayloadIds | Liste der sys_id-Werte für Teilnutzlasten aus der Tabelle „Teilliche CMDB-IRE-Nutzlasten" \[cmdb_ire_partial_payloads\], die während der Verarbeitung dieses zusätzlichen abhängigen Beziehungs-CI zusammengeführt wurden. Datentyp: Array "mergedPayloadIds": [ "String" ] |
| result.additionalCommittedRelations.operation | Für dieses zusätzliche abhängige Beziehungs-CI durchgeführte Operation. Mögliche Werte: * INSERT: Das CI der abhängigen Beziehung wird als neuer Datensatz in die Zieltabelle eingefügt. * INSERT_AS_INCOMPLETE: Das abhängige Beziehungs-CI wies Fehler auf und wird in die Tabelle „CMDB IRE Unvollständige Nutzlasten" \[cmdb_ire_incomplete_payloads\] eingefügt. * INSERT_AS_partial: Das abhängige Beziehungs-CI wies Fehler auf und wird in die Tabelle der teilweisen CMDB-IRE-Nutzlasten \[cmdb_ire_partial_payloads\] eingefügt. * NO_CHANGE: Für das abhängige Beziehungs-CI wird kein Vorgang ausgeführt. * UPDATE: 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 Array des Anforderungstexts items enthalten sind. 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] } ] |
| Ergebnis.Elemente.ZusätzlicheZugehörigeElemente | Liste der zugehörigen CIs (Tabellensuch-CI) aus der Tabelle „Teilweise Nutzlasten der CMDB-IRE" \[cmdb_ire_partial_payloads\]. Datentyp: Array von Objekten "additionalRelatedItems": [ { "className": "String", "inputIndices": [Array], "markers": [Array], "mergedPayloadIds": [Array], "sysId": "String" } ] |
| Ergebnis.Elemente.ZusätzlicheZugehörigeElemente.Klassenname | Der sys_class_name des zugehörigen Elements. Datentyp: Zeichenfolge |
| Ergebnis.Elemente.ZusätzlicheZugehörigeElemente.Eingabeindizes | Liste der Indexwerte für CIs aus dem Array des Anforderungstextes items, die diesem zugehörigen Element entsprechen. Datentyp: Array "inputIndices": [ Number ] |
| Ergebnis.Elemente.ZusätzlicheZugehörigeElemente.Marker | Liste der Markerwerte zur internen Verwendung. Datentyp: Array "markers": [] |
| result.items.additionalRelatedItems.mergedPayloadIds | Liste der sys_id-Werte für Teilnutzlasten aus der Tabelle „Teilliche CMDB-IRE-Nutzlasten" \[cmdb_ire_partial_payloads\], die während der Verarbeitung dieses zugehörigen Elements zusammengeführt wurden. Datentyp: Array "mergedPayloadIds": [ "String" ] |
| Ergebnis.Elemente.ZusätzlicheZugehörigeElemente.SysId | Sys_id des zugehörigen CI. Datentyp: Zeichenfolge |
| Ergebnis.Elemente.Klassenname | Sys_class_name dieses CI. Datentyp: Zeichenfolge |
| result.items.duplicateLookupIndices | Objekt mit Arrays von Indexwerten für items.lookup -Array-Elemente, die auf dasselbe zugehörige CI verweisen. Der Array-Name gibt das erste Element aus dem Array des Anforderungstextes items.lookup an, 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 im Array items.lookup auf dasselbe zugehörige CI verweist wie ein späteres Element aus diesem Array: "duplicateLookupIndices": [ "2": [Array] ] |
| Ergebnis.Elemente.Fehleranzahl | Anzahl der bei der Verarbeitung dieses CI aufgetretenen Fehler. Datentyp: Zahl |
| Ergebnis.Elemente.Fehler | Liste der bei der Verarbeitung des CI aufgetretenen Fehler. Datentyp: Array von Objekten "errors": [ { "error": "String", "message": "String" } ] |
| Ergebnis.Elemente.Fehler.Fehler | Typ des Fehlers, der bei der Verarbeitung dieses CI aufgetreten ist. Datentyp: Zeichenfolge |
| Ergebnis.Elemente.Fehlermeldung | Bei der Verarbeitung dieses CI ist eine Fehlermeldung aufgetreten. Datentyp: Zeichenfolge |
| Ergebnis.Elemente.Identifizierungsversuche | Liste der Versuche, die unternommen wurden, um dieses CI zu identifizieren. Datentyp: Array von Objekten "identificationAttempts": [ { "attemptResult": "String", "attributes": [Array], "hybridEntryCiAttributes": [Array], "identiferName": "String", "searchOnTable": [Array] } ] |
| Ergebnis.Elemente.Identifizierungsversuche.VersuchErgebnis | Ergebnis des CI-Identifizierungsversuchs. Mögliche Werte: * ABGEGLICHEN: Identifizierung erfolgreich. In der Identifier-Regeltabelle wurde ein eindeutiges CI gefunden, das genau mit den angegebenen Attributen übereinstimmt. * Multi_MATCH: Die Identifizierung ist mit einem Fehler fehlgeschlagen. In der Identifier-Regeltabelle wurden beim Abgleich mit den angegebenen Attributen doppelte CIs gefunden. * NO_MATCH: Identifizierung fehlgeschlagen. In der Identifier-Regeltabelle wurde kein CI gefunden, das den angegebenen Attributen entspricht. * ÜBERSPRUNGEN: Identifizierung nicht versucht. Die für die Suche in dieser Identifier-Regeltabelle erforderlichen Attribute wurden nicht angegeben, daher wurde die Regel nicht angewendet. {#identifyreconcile-POST__ul_gmw_qn5_flb} Datentyp: Zeichenfolge |
| Ergebnis.Elemente.Identifizierungsversuche.Attribute | Liste der CI-Bezeichner-Eintragsattribute, die während dieses CI-Identifizierungsversuchs verwendet werden. Datentyp: Array Attributnamen und -typen hängen von den Anforderungstextdaten und dem verwendeten Bezeichner ab, z. B.: "attributes": [ "serial_number": "String", "serial_number_type": "String", ] |
| result.items.identificationAttempts.hybridEntryCiAttributes | Liste der CI-Bezeichner-Eintragsattribute, die während dieses CI-Identifizierungsversuchs verwendet werden. Datentyp: Array Attributnamen und -typen hängen von den Anforderungstextdaten und dem verwendeten Bezeichner ab, z. B.: "hybridEntryCiAttributes": [ "name": "String", "serial_number": "String" ] |
| Ergebnis.Elemente.Identifizierungsversuche.Bezeichnername | Identifier-Regel, die für diesen CI-Identifizierungsversuch verwendet wird. Datentyp: Zeichenfolge |
| result.items.identificationVersuche.searchOnTable | Name der Tabelle, die für diesen CI-Identifizierungsversuch durchsucht wurde. Datentyp: Zeichenfolge |
| result.items.identifierEntrySysId | Sys_id für die Identifier-Regel, die zum Identifizieren dieses CI verwendet wird. Bemerkbare Werte: * Unbekannt: Die Identifizierung dieses CI ist 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: * SKIPPED_CLASS_SWITCH * SKIPPED_CLASS_DOWNGRADE * ÜBERSPRUNGEN_KLASSEN_UPGRADE {#identifyreconcile-POST__ul_pb2_dxp_snb} |
| Ergebnis.Elemente.Info.Nachricht | Nachricht, die zusätzliche Einblicke in den Grund für das Überspringen der erneuten Klassifizierung bietet. Datentyp: Zeichenfolge |
| result.items.info.ruleSysId | Sys_id der übereinstimmenden Reklassifizierungsbeschränkungsregel. Gilt nur, wenn die IRE die Neuklassifizierung aufgrund der Regel zur Einschränkung der Neuklassifizierung überspringt. Dieser Wert ist leer, wenn die erneute Klassifizierung aufgrund einer Nutzlast oder globalen Kennzeichnung übersprungen wird. Datentyp: Zeichenfolge |
| result.items.inputIndices | Liste der Indexwerte für CIs aus dem Array des Anforderungstextes items, die diesem CI entsprechen. Datentyp: Array von Objekten "inputIndices": [ { Number } ] |
| Ergebnis.Elemente.Marker | Liste der Markerwerte zur internen Verwendung. Datentyp: Array "markers": [] |
| result.items.mergedPayloadIds | Liste der sys_id-Werte für Teilnutzlasten aus der Tabelle „Teilliche CMDB-IRE-Nutzlasten" \[cmdb_ire_partial_payloads\], die während der Verarbeitung dieses CI zusammengeführt wurden. Datentyp: Array "mergedPayloadIds": [ "String" ] |
| Ergebnis.Elemente.Vorgang | Für dieses CI durchgefü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. * UPDATE: 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 allgemeinere 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ängerklasse oder untergeordnete Klasse ist. * UPDATE_WITH_UPGRADE: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine spezialisiertere Klasse (absteigende Klasse) geändert. {#identifyreconcile-POST__ul_jhl_gg5_flb} Datentyp: Zeichenfolge |
| Ergebnis.Elemente.ZugehörigeElemente | Liste der zugehörigen CIs (Tabellensuch-CI) aus dem Array des Anforderungstextes items.lookup. 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 den Arrays items und items.lookup des Anforderungstexts, die diesem zugehörigen Element entsprechen. Datentyp: Array von Objekten "inputIndices": [ { "mainIndex": Number, "subIndex": Number } ] |
| result.items.relatedItems.inputIndices.mainIndex | Indexwert aus dem Array des Anforderungstexts items, der dem übergeordneten CI des zugehörigen Elements entspricht. Datentyp: Zahl |
| result.items.relatedItems.inputIndices.subIndex | Indexwert aus dem Array des Anforderungstexts items.lookup, der dem zugehörigen Element entspricht. Datentyp: Zahl |
| Ergebnis.Elemente.ZugehörigeElemente.Marker | Liste der Markerwerte zur internen Verwendung. Datentyp: Array "markers": [] |
| result.items.relatedItems.mergedPayloadIds | Liste der sys_id-Werte für Einträge in der Tabelle „Teilliche CMDB-IRE-Nutzlasten" \[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 Array des Anforderungstexts items.lookup. Datentyp: Array Bemerkbare 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. Bemerkbare Werte: * Unbekannt: Die Identifizierung dieses CI ist fehlgeschlagen. Details siehe errors. {#identifyreconcile-POST__ul_zz5_5vb_glb} Datentyp: Zeichenfolge |
| Ergebnis.Elemente.Warnungen | Liste der Warnungen, die bei der Verarbeitung dieses CI aufgetreten sind. Datentyp: Array von Objekten "warnings": [ { "error": "String", "message": "String" } ] |
| Ergebnis.Elemente.Warnungen.Fehler | Typ der Warnung, die bei der Verarbeitung des CI aufgetreten ist. Datentyp: Zeichenfolge |
| Ergebnis.Elemente.Warnungen.Nachricht | Bei der Verarbeitung dieses CI ist eine Warnmeldung aufgetreten. Datentyp: Zeichenfolge |
| result.logContextId | Für diese Nutzlast gemeldete Kontext-ID. Datentyp: Zeichenfolge |
| result.relations | Liste der abhängigen Beziehungs-CIs aus dem Array des Anforderungstextes relations. Datentyp: Array von Objekten "relations": [ { "className": "String", "errorCount": Number, "errors": [Array], "inputIndices": [Array], "markers": [Array], "mergedPayloadIds": [Array], "operation": "String", "warnings": [Array] } ] |
| result.beziehungen.className | Der sys_class_name dieses abhängigen Beziehungs-CI. Einziger 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 Fehlers, der bei der Verarbeitung dieser abhängigen Beziehungs-CI aufgetreten ist. Datentyp: Zeichenfolge |
| Ergebnis.Beziehungen.Fehler.Meldung | Fehlermeldung bei der Verarbeitung dieses abhängigen Beziehungs-CI. Datentyp: Zeichenfolge |
| result.beziehungen.inputIndices | Liste der Indexwerte für die abhängigen Beziehungs-CI-Objekte im Array des Anforderungstextes relations, die diesem abhängigen Beziehungs-CI entsprechen. Datentyp: Array "inputIndices": [ Number ] |
| Ergebnis.Beziehungen.Marker | Liste der Markerwerte zur internen Verwendung. Datentyp: Array "markers": [] |
| result.beziehungen.mergedPayloadIds | Liste der sys_id-Werte für Teilnutzlasten aus der Tabelle „Teilliche CMDB-IRE-Nutzlasten" \[cmdb_ire_partial_payloads\], die während der Verarbeitung dieses abhängigen Beziehungs-CI zusammengeführt wurden. Datentyp: Array "mergedPayloadIds": [ "String" ] |
| Ergebnis.Beziehungen.Vorgang | Für dieses abhängige Beziehungs-CI durchgeführte Operation. Mögliche Werte: * EINFÜGEN: Das abhängige Beziehungs-CI wurde als neuer Datensatz in die Zieltabelle eingefügt. * INSERT_AS_INCOMPLETE: Das abhängige Beziehungs-CI wies Fehler auf und wurde in die Tabelle „CMDB IRE Unvollständige Nutzlasten" \[cmdb_ire_incomplete_payloads\] eingefügt. * INSERT_AS_partial: Das abhängige Beziehungs-CI wies Fehler auf und wurde in die Tabelle der teilweisen CMDB-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 dieser abhängigen Beziehungs-CI aufgetreten ist. Datentyp: Zeichenfolge |
| Ergebnis.Beziehungen.Warnungen.Nachricht | Bei der Verarbeitung dieses abhängigen Beziehungs-CI ist eine Warnmeldung aufgetreten. Datentyp: Zeichenfolge |
[ ]
### cURL-Anforderung
Senden Sie eine Nutzlast, die einen Linux-Server (mit Seriennummern- und Netzwerkadapter-Suchvorgängen zugehöriger Elemente) und einen IP-Switch mit einer von der IP-Verbindung abhängigen Beziehung 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 Hardwaretabelle \[cmdb_ci_hardware\] identifiziert und als Aktualisierung eines vorhandenen CI in der Linux-Servertabelle \[cmdb_ci_linux_server\] verarbeitet. Der IP-Switch wird ebenfalls über eine Hardwareregelsuche nach seinem Namen in der Hardware-Tabelle identifiziert und aktualisiert ein vorhandenes CI in der IP-Switch-Tabelle \[cmdb_ci_ip_Switch\]. Abschließend wird die von der IP-Verbindung abhängige Beziehung zwischen Server und 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 CMDB ein oder aktualisiert sie, indem auf die angegebene Nutzlast (Anforderungstext) Identifizierungs- und Abgleichregeln angewendet werden. Verwenden Sie diese API, anstatt CMDB direkt zu aktualisieren.
Verwenden Sie den Endpunkt [Identifizierung und Abgleich -- POST /now/identifyreconcile/queryEnhanced](https://servicenow-prod.fluidtopics.net/ZRNLHAWYFKoNwL1GNeNMig#identifyreconcile-POST-queryenhanced "Bestimmt den CMDB -Vorgang (Einfügen/Aktualisieren), der mit der angegebenen Nutzlast (Anforderungstext) ausgeführt werden soll, ohne dass die Vorgänge in der Datenbank committet werden."), um die Übermittlung einer Nutzlast an diesen Endpunkt zu simulieren, ohne Änderungen an der Datenbank festzuschreiben.
Diese Methode ähnelt der Methode [Identifizierung und Abgleich -- POST /now/identifyreconcile](https://servicenow-prod.fluidtopics.net/ZRNLHAWYFKoNwL1GNeNMig#identifyreconcile-POST "Fügt Konfigurationselemente (CIs) in CMDB ein oder aktualisiert sie, indem auf die angegebene Nutzlast (Anforderungstext) Identifizierungs- und Abgleichregeln angewendet werden. Verwenden Sie diese API, anstatt CMDB direkt zu aktualisieren."), fügt jedoch folgende Funktionalität hinzu:
* Teilnutzlasten
* Gibt an, ob ein Artikelvorgang INSERT_AS_partial oder INSERT_INCOMPLETE ist, wenn für ein Element eine Warnung oder ein Fehler auftritt.
* 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 Funktion zur Deduplizierung der Nutzlast.
* Generiert eine Zusammenfassung.
{#identifyreconcile-POST-enhanced__ul_scj_jvk_xlb}
### URL-Format
URL mit Versionsnummer: /api/now/{api_version}/identifyreconcile/enhanced
Standard-URL: /api/now/identifyreconcile/enhanced
### Unterstützte Anforderungsparameter
{#identifyreconcile-POST-enhanced__entry__2}{#identifyreconcile-POST-enhanced__version-RESTAPI}
| Name | Beschreibung |
|-|-|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum Beispiel v1 oder v2. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge |
[Tabelle : 7. Pfadparameter]
{#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. Um die Standardwerte für die Optionen für teilweise Nutzlasten, teilweise Commits, deduplizierte Nutzlasten und das Generieren einer Zusammenfassung für erweiterte IRE zu überschreiben: `Partial_payloads:false,partial_commits:false,deduplizierte_nutzlasten:falsch,generate_summary:wahr` Hinweis: Standardmäßig oder wenn partial_payloads auf „true" festgelegt ist, sind sowohl partial_commits als auch deduplicate_payloads aktiviert, auch wenn sie auf „false" festgelegt sind, da diese Funktionen für die Funktionalität von Teilnutzlasten wichtig sind. Weitere Informationen zu erweiterten IRE-Optionen finden Sie unter [Identification and Reconciliation Engine (IRE)](https://www.servicenow.com/docs/access?context=ire&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US). Gültige Werte für jedes Name-Wert-Paar: * true: Aktivieren Sie diese Option für die erweiterte IRE. * „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 der unvollständigen 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 zu erstellenden oder zu aktualisierenden CIs. Datentyp: Array von Objekten "items": [ { "className": "String", "internal_id": "String", "lookup": [Array], "related": [Array], "settings": {Object}, "sys_object_source_info": {Object}, "values": {Object} } ] |
| elemente.klassenname | Erforderlich. Der sys_class_name (Klassen-/Tabellenname) des zu erstellenden oder zu aktualisierenden CI. Dieser Wert kann eine beliebige Tabelle CMDB sein, z. B. cmdb_ci_linux_server oder cmdb_ci_win_server. Datentyp: Zeichenfolge |
| item.internal_id | Eindeutiger Bezeichner für das Element in dieser Nutzlast Kann ein beliebiger Wert sein, muss aber innerhalb der Nutzlast eindeutig sein. Datentyp: Zeichenfolge |
| Items.Suche | Array von Objekten, in dem 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 zurück auf die Tabelle „Konfigurationselement" \[cmdb_ci\] enthält. Datentyp: Array aus Objekten "lookup": [ { "className": "String", "internal_id": "String", "sys_object_source_info": {Object}, "values": {Object} } ] |
| elemente.suche.klassenname | Erforderlich. sys_class_name oder Klassen-/Tabellenname des zu erstellenden oder zu aktualisierenden CI. Dieser Wert kann eine beliebige CMDB -Klasse/-Tabelle sein, z. B. cmdb_serial_number oder cmdb_ci_network_adapter, oder eine NichtCMDB -\[\]- Hierarchieklasse. Datentyp: Zeichenfolge |
| elemente.suche.internal_id | Eindeutiger Bezeichner für den Suchdatensatz in dieser Nutzlast Kann ein beliebiger Wert sein, muss aber innerhalb der Nutzlast eindeutig sein. Datentyp: Zeichenfolge |
| item.lookup.sys_object_source_info | Objekt, das einen eindeutigen CI-Bezeichner für eine angegebene Datenquelle beschreibt. Verschiedene Quellen können unterschiedliche Name/Wert-Paare für dasselbe CI aufweisen. Datentyp: Objekt "sys_object_source_info": { "source_feed": "String", "source_name": "String", "source_native_key": "String", "source_recency_timestamp": "String" } |
| item.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 |
| item.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 |
| item.lookup.sys_object_source_info.source_native_key | Eindeutiger Schlüssel/eindeutige ID aus der Quelle für das CI. Kann eine beliebige Zeichenfolge sein, die für das Element eindeutig ist. Datentyp: Zeichenfolge |
| item.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 |
| elemente.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 dem jedes Objekt einen zu erstellenden oder zu aktualisierenden Elementdatensatz beschreibt, basierend auf einer zugehörigen Tabelle, die einen Verweis auf das identifizierte CI der obersten Ebene enthält. Regeln in der Tabelle „Zugehöriger Eintrag" \[cmdb_related_entry\] definieren, welche Arten von Datensätzen dieses Array enthalten darf. Die zugehörige Tabelle kann die Konfigurationselement-Tabelle \[cmdb_ci\] erweitern, muss es aber nicht. Diese Datensätze werden nicht zum Identifizieren des Konfigurationselements verwendet. Datentyp: Array von Objekten "related": [ { "className": "String", "internal_id": "String", "sys_object_source_info": {Object}, "values": {Object} } ] |
| elemente.zugehörig.klassenname | Erforderlich. sys_class_name oder Klassen-/Tabellenname des zugehörigen Elements, das erstellt oder aktualisiert werden soll. Datentyp: Zeichenfolge |
| elemente.zugehörig.internal_id | Eindeutiger Bezeichner für das zugehörige Element in dieser Nutzlast Kann ein beliebiger Wert sein, muss aber innerhalb der Nutzlast eindeutig sein. Datentyp: Zeichenfolge |
| item.related.sys_object_source_info | Objekt, das einen eindeutigen CI-Bezeichner für eine angegebene Datenquelle beschreibt. Verschiedene Quellen können unterschiedliche Name/Wert-Paare für dasselbe CI aufweisen. Datentyp: Objekt "sys_object_source_info": { "source_feed": "String", "source_name": "String", "source_native_key": "String", "source_recency_timestamp": "String" } |
| item.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 |
| item.related.sys_object_source_info.source_name | Datenquelle für die zugehörigen Artikelinformationen. Dieser Wert muss einer der Auswahlwerte sein, die für das Feld „discovery_source" der Tabelle „Konfigurationselement" \[cmdb_ci\] definiert sind. Datentyp: Zeichenfolge |
| item.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 |
| item.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 die für dieses zugehörige Element zu erstellenden oder zu aktualisierenden Felder als Name/Wert-Paare beschreibt, 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" } |
| elemente.einstellungen | Objekt mit Parametern, die festlegen, welche Arten von Updates zulässig sind. Datentyp: Objekt "settings": { "skipReclassificationRestrictionRules": Boolean, "updateWithoutDowngrade": Boolean, "updateWithoutSwitch": Boolean, "updateWithoutUpgrade": Boolean } |
| elemente.einstellungen.reklassifizierungsbeschränkungsregeln überspringen | Kennzeichnung, die angibt, ob IRE die Ausführung der Regel zur Einschränkung der Neuklassifizierung überspringen soll, die der Klasse für das Nutzlastelement entspricht. Gültige Werte: * true: Ausführung der Regel überspringen. * „falsch": Führen Sie die Regel aus. Standardwert: false |
| elemente.einstellungen.updateOhneDowngrade | Kennzeichnung, die angibt, ob Update und Downgrade für dieses CI zulässig sind. Gültige Werte: * „wahr": Element wird aktualisiert, Downgrade ist jedoch nicht zulässig. * false: Sowohl Elementaktualisierungen als auch Downgrades sind zulässig. Datentyp: Boolesch Standardwert: false |
| elemente.einstellungen.updateOhneSchalter | Kennzeichnung, die angibt, ob dieses CI aktualisiert und seine Klasse gewechselt werden kann. Gültige Werte: * „wahr": Element wird aktualisiert, aber Klassenwechsel ist nicht zulässig. * false: Sowohl Elementaktualisierungen als auch Klassenwechsel sind zulässig. Datentyp: Boolesch Standardwert: false |
| elemente.einstellungen.updateOhneUpgrade | Kennzeichnung, die angibt, ob Update und Upgrade für dieses CI zulässig sind. Gültige Werte: * „wahr": Element wird aktualisiert, aber Upgrade ist nicht zulässig. * „falsch": Sowohl Element-Updates als auch -Upgrades sind zulässig. Datentyp: Boolesch Standardwert: false |
| item.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" } |
| item.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 |
| item.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 |
| item.sys_object_source_info.source_native_key | Eindeutiger Schlüssel/eindeutige ID aus der Quelle für das CI. Kann eine beliebige Zeichenfolge sein, die für das Element eindeutig ist. Datentyp: Zeichenfolge |
| item.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 die für dieses CI zu erstellenden oder zu aktualisierenden Felder als Name/Wert-Paare beschreibt, 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 | Referenzliste zwischen zwei Elementen in der Nutzlast. Datentyp: Array von Objekten "referenceItems": [ { "referenced": "String", "referencedBy": "String", "referenceField": "String" } ] |
| referenceItems.referenced | internal_id, das für das Element definiert ist, auf das von einem anderen Element verwiesen wird. Datentyp: Zeichenfolge |
| referenceItems.referencedBy | internal_id, das für das Element definiert ist und auf ein anderes Element verweist. Datentyp: Zeichenfolge |
| referenceItems.referenceField | Name des Referenzfelds in der Klasse/Tabelle für das Element referencedBy. Datentyp: Zeichenfolge |
| relations | Liste der Beziehungen zwischen zwei in der Nutzlast definierten Elementen. Ein Objekt in diesem Array kann eines von zwei Formaten verwenden: * Das Objekt kann eine Beziehung zwischen zwei Elementen der obersten Ebene (nur) mithilfe von Name-Wert-Paaren parent und child definieren, wobei Werte Elementindizes aus dem Nutzlast-Array items darstellen. * Das Objekt kann eine Beziehung zwischen zwei beliebigen Elementen definieren, einschließlich Elementen der obersten Ebene, zugehörigen Elementen oder Suchelementen, indem Schlüssel-Wert-Paare parent_id und child_id verwendet werden, wobei -Werte die für diese Elemente definierten internal_id -Werte darstellen. {#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" } ] |
| beziehungen.untergeordnetes element | Ganzzahlindex des CI-Objekts im Array items, das das untergeordnete Element in der Beziehung darstellt. Datentyp: Zahl |
| beziehungen.child_id | internal_id des untergeordneten Elements in der Beziehung. Datentyp: Zeichenfolge |
| beziehungen.übergeordnet | Ganzzahlindex des CI-Objekts im Array items, das das übergeordnete Element in der Beziehung darstellt. Datentyp: Zahl |
| beziehungen.parent_id | internal_id des übergeordneten Elements in der Beziehung. Datentyp: Zeichenfolge |
| beziehungen.sys_rel_source_info | Informationen zur Discovery-Quelle für die Beziehung. Bei Nicht-Abhängigkeitsbeziehungen befinden sich diese Informationen in der Tabelle „Beziehungsquellen" \[sys_rel_source\]. Datentyp: Objekt "sys_rel_source_info": { "source_name": "String", "source_feed": "String" } |
| beziehungen.sys_rel_source_info.quellenname | Name der Discovery-Quelle. Standard: Discovery-Quelle, die im API-Methodenparameter übergeben wird. |
| beziehungen.sys_rel_source_info.source_feed | Beliebige Zeichenfolge, die eine Unter-Discovery/ein Unterscan 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.type | Typ der Beziehung zwischen den übergeordneten und untergeordneten Elementen. Dies muss ein Namensfeldwert aus der Tabelle „CI-Beziehungstyp" \[cmdb_rel_type\] sein. Datentyp: Zeichenfolge |
[Tabelle : 9. Anforderungstextparameter (XML oder JSON)]
{#identifyreconcile-POST-enhanced__table_idz_wyn_rlb}
### Kopfzeilen
Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. 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/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass 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}
| Kopfzeile | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützt nur application/json. |
| Content-Type | Datenformat des Anforderungstexts. Unterstützt nur application/json. |
[Tabelle : 10. Anforderungskopfzeilen]
{#identifyreconcile-POST-enhanced__entry__110}
| Kopfzeile | Beschreibung |
|-|-|
| Keine | |
[Tabelle : 11. Antwortkopfzeilen]
### 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 [HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.")der REST-API.
{#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 Anmeldeinformationen sind falsch oder wurden nicht übergeben. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Das Fehlermeldungsdetail „Chunk ... ist kein gültiger Eintrag" gibt an, dass der Abfrageparameter options nicht das richtige Name-Wert-Paarformat aufweist. Wenn Sie beispielsweise den Parameter options des Typs „ `partial` " angeben, wird beispielsweise ein Statuscode 500 mit „Block \[partial\] is not a valid Eintrag" im Nachrichtendetail angezeigt. |
[Tabelle : 12. Statuscodes]
### Parameter des Antworttexts (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] ] |
| result.additionalCommittedItems | Liste der CIs, die nicht im Array des Anforderungstexts items zum Einfügen oder Aktualisieren enthalten sind. Datentyp: Array von Objekten "additionalCommittedItems": [ { "className": "String", "errorCount": Number, "identificationAttempts": [Array], "inputIndices": [Array], "markers": [Array], "mergedPayloads": [Array], "operation": "String", "sysId": "String" } ] |
| result.additionalCommittedItems.className | Der sys_class_name dieses zusätzlichen CI. Datentyp: Zeichenfolge |
| Ergebnis.zusätzlichefestgelegteElemente.Fehleranzahl | Anzahl der bei der Verarbeitung dieses zusätzlichen CI aufgetretenen Fehler. Datentyp: Zahl |
| Ergebnis.zusätzlicheCommittedItems.errors | Liste der Fehler, die bei der Verarbeitung dieses zusätzlichen CI aufgetreten sind. Datentyp: Array von Objekten "errors": [ { "error": "String", "message": "String" } ] |
| result.additionalCommittedItems.errors.error | Typ des Fehlers, der bei der Verarbeitung dieses zusätzlichen CI aufgetreten ist. Datentyp: Zeichenfolge |
| Ergebnis.zusätzlicheCommittedItems.errors.message | Fehlermeldung bei der Verarbeitung dieses zusätzlichen CI. Datentyp: Zeichenfolge |
| Ergebnis.ZusätzlicheZusätzlicheElemente.Identifizierungsversuche | Liste der Versuche, die unternommen wurden, um dieses zusätzliche CI zu identifizieren. Datentyp: Array von Objekten "identificationAttempts": [ { "attemptResult": "String", "attributes": [Array], "hybridEntryCiAttributes": [Array], "identiferName": "String", "searchOnTable": [Array] } ] |
| Ergebnis.zusätzlicheZusätzlicheElemente.Identifizierungsversuche.Versuchsergebnis | Ergebnis dieses zusätzlichen CI-Identifizierungsversuchs. Mögliche Werte: * ABGEGLICHEN: Identifizierung erfolgreich. In der Identifier-Regeltabelle wurde ein eindeutiges CI gefunden, das genau mit den angegebenen Attributen übereinstimmt. * Multi_MATCH: Die Identifizierung ist mit einem Fehler fehlgeschlagen. In der Identifier-Regeltabelle wurden beim Abgleich mit den angegebenen Attributen doppelte CIs gefunden. * NO_MATCH: Identifizierung fehlgeschlagen. In der Identifier-Regeltabelle wurde kein CI gefunden, das den angegebenen Attributen entspricht. * ÜBERSPRUNGEN: Identifizierung nicht versucht. Die für die Suche in dieser Identifier-Regeltabelle erforderlichen Attribute wurden nicht angegeben, daher wurde die Regel nicht angewendet. {#identifyreconcile-POST-enhanced__ul_axc_bxx_glb} Datentyp: Zeichenfolge |
| Ergebnis.zusätzlicheZusätzlicheElemente.Identifizierungsversuche.Attribute | Array von CI-Identifier-Eintragsattributen, die bei diesem zusätzlichen CI-Identifizierungsversuch verwendet werden. Datentyp: Array Attributnamen und -typen hängen von den Anforderungstextdaten und dem verwendeten Bezeichner ab, z. B.: "attributes": [ "serial_number": "String", "serial_number_type": "String" ] |
| Ergebnis.zusätzlicheCommittedItems.IdentificationAttempts.HybridEntryCiAttributes | Liste der CI-Bezeichner-Eintragsattribute, die bei diesem zusätzlichen CI-Identifizierungsversuch verwendet werden. Datentyp: Array Attributnamen und -typen hängen von den Anforderungstextdaten und dem verwendeten Bezeichner ab, z. B.: "hybridEntryCiAttributes": [ "name": "String", "serial_number": "String" ] |
| Ergebnis.zusätzlichefestgelegteElemente.Identifizierungsversuche.Bezeichnername | Identifier-Regel, die für diesen zusätzlichen CI-Identifizierungsversuch verwendet wird. Datentyp: Zeichenfolge |
| result.additionalCommittedItems.identificationAttempts.searchOnTable | Name der Tabelle, in der nach diesem zusätzlichen CI-Identifizierungsversuch gesucht wurde. Datentyp: Zeichenfolge |
| result.additionalCommittedItems.identifierEntrySysId | Sys_id für die Identifier-Regel, die zum Identifizieren dieses zusätzlichen CI verwendet wird. Bemerkbare Werte: * Unbekannt: Die Identifizierung dieses zusätzlichen CI ist fehlgeschlagen. Details siehe errors. {#identifyreconcile-POST-enhanced__ul_hlk_gyx_glb} Datentyp: Zeichenfolge |
| result.additionalCommittedItems.inputIndices | Liste der Indexwerte für CIs aus dem Array des Anforderungstextes items, die diesem zusätzlichen CI entsprechen. Datentyp: Array von Objekten "inputIndices": [ { Number } ] |
| Ergebnis.zusätzlicheCommittedItems.Marker | Liste der Markerwerte zur internen Verwendung. Datentyp: Array "markers": [] |
| result.additionalCommittedItems.mergedPayloads | Liste der sys_id-Werte für Teilnutzlasten aus der Tabelle „Teilliche CMDB-IRE-Nutzlasten" \[cmdb_ire_partial_payloads\], die während der Verarbeitung dieses zusätzlichen CI zusammengeführt wurden. Datentyp: Array "mergedPayloadIds": [ "String" ] |
| result.additionalCommittedItems.operation | Für dieses zusätzliche CI durchgeführter Vorgang. 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. * UPDATE: 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 allgemeinere 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ängerklasse oder untergeordnete Klasse ist. * UPDATE_WITH_UPGRADE: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine spezialisiertere Klasse (absteigende Klasse) geändert. {#identifyreconcile-POST-enhanced__ul_dwt_qwx_glb} Datentyp: Zeichenfolge |
| result.additionalCommittedItems.sysId | Sys_id für dieses zusätzliche CI durch Identifizierung gefunden. Bemerkbare Werte: Unbekannt: Die Identifizierung dieses zusätzlichen CI ist fehlgeschlagen. Details siehe errors. Datentyp: Zeichenfolge |
| Ergebnis.zusätzlicheCommittedItems.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ätzlicheCommittedItems.Warnungen.Fehler | Typ der Warnung, die bei der Verarbeitung dieses zusätzlichen CI aufgetreten ist. Datentyp: Zeichenfolge |
| Ergebnis.zusätzlicheCommittedItems.Warnungen.Nachricht | Bei der Verarbeitung dieses zusätzlichen CI ist eine Warnmeldung aufgetreten. Datentyp: Zeichenfolge |
| result.additionalCommittedRelations | Liste der abhängigen Beziehungs-CIs, die nicht in der Liste des Anforderungstextes relations zum Einfügen oder Aktualisieren enthalten sind. Datentyp: Array von Objekten "additionalCommittedRelations": [ { "className": "String", "operation": "String", "markers": [Array], "inputIndices": [Array], "mergedPayloadIds": [Array] } ] |
| result.additionalCommittedRelations.className | Der sys_class_name dieses zusätzlichen abhängigen Beziehungs-CI. Einziger unterstützter Wert: * cmdb_rel_ci: Die CI-Beziehungstabelle. {#identifyreconcile-POST-enhanced__ul_bsb_pxx_glb} Datentyp: Zeichenfolge |
| result.additionalCommittedRelations.errorCount | Anzahl der Fehler, die bei der Verarbeitung dieses zusätzlichen abhängigen Beziehungs-CI aufgetreten sind. Datentyp: Zahl |
| Ergebnis.zusätzlicheCommittedRelations.errors | Liste der Fehler, die bei der Verarbeitung dieses zusätzlichen CI für abhängige Beziehungen aufgetreten sind. Datentyp: Array von Objekten "errors": [ { "error": "String", "message": "String" } ] |
| result.additionalCommittedRelations.errors.error | Typ des Fehlers, der bei der Verarbeitung dieses zusätzlichen abhängigen Beziehungs-CI aufgetreten ist. Datentyp: Zeichenfolge |
| Ergebnis.zusätzlicheBestätigteBeziehungen.Fehler.Nachricht | Fehlermeldung beim Verarbeiten dieses zusätzlichen abhängigen Beziehungs-CI. Datentyp: Zeichenfolge |
| result.additionalCommittedRelations.inputIndexes | Liste der Indexwerte für abhängige Beziehungs-CI-Objekte im Array des Anforderungstexts relations, die diesem zusätzlichen abhängigen Beziehungs-CI entsprechen. Datentyp: Array "inputIndices": [ Number ] |
| result.additionalCommittedRelations.markers | Liste der Markerwerte zur internen Verwendung. Datentyp: Array "markers": [] |
| result.additionalCommittedRelations.mergedPayloadIds | Liste der sys_id-Werte für Teilnutzlasten aus der Tabelle „Teilliche CMDB-IRE-Nutzlasten" \[cmdb_ire_partial_payloads\], die während der Verarbeitung dieses zusätzlichen abhängigen Beziehungs-CI zusammengeführt wurden. Datentyp: Array "mergedPayloadIds": [ "String" ] |
| result.additionalCommittedRelations.operation | Für dieses zusätzliche abhängige Beziehungs-CI durchgeführte Operation. Mögliche Werte: * INSERT: Das CI der abhängigen Beziehung wird als neuer Datensatz in die Zieltabelle eingefügt. * INSERT_AS_INCOMPLETE: Das abhängige Beziehungs-CI wies Fehler auf und wird in die Tabelle „CMDB IRE Unvollständige Nutzlasten" \[cmdb_ire_incomplete_payloads\] eingefügt. * INSERT_AS_partial: Das abhängige Beziehungs-CI wies Fehler auf und wird in die Tabelle der teilweisen CMDB-IRE-Nutzlasten \[cmdb_ire_partial_payloads\] eingefügt. * NO_CHANGE: Für das abhängige Beziehungs-CI wird kein Vorgang ausgeführt. * UPDATE: 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 Array des Anforderungstexts items enthalten sind. 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] } ] |
| Ergebnis.Elemente.ZusätzlicheZugehörigeElemente | Liste der zugehörigen CIs (Tabellensuch-CI) aus der Tabelle „Teilweise Nutzlasten der CMDB-IRE" \[cmdb_ire_partial_payloads\]. Datentyp: Array von Objekten "additionalRelatedItems": [ { "className": "String", "inputIndices": [Array], "markers": [Array], "mergedPayloadIds": [Array], "sysId": "String" } ] |
| Ergebnis.Elemente.ZusätzlicheZugehörigeElemente.Klassenname | Der sys_class_name des zugehörigen Elements. Datentyp: Zeichenfolge |
| Ergebnis.Elemente.ZusätzlicheZugehörigeElemente.Eingabeindizes | Liste der Indexwerte für CIs aus dem Array des Anforderungstextes items, die diesem zugehörigen Element entsprechen. Datentyp: Array "inputIndices": [ Number ] |
| Ergebnis.Elemente.ZusätzlicheZugehörigeElemente.Marker | Liste der Markerwerte zur internen Verwendung. Datentyp: Array "markers": [] |
| result.items.additionalRelatedItems.mergedPayloadIds | Liste der sys_id-Werte für Teilnutzlasten aus der Tabelle „Teilliche CMDB-IRE-Nutzlasten" \[cmdb_ire_partial_payloads\], die während der Verarbeitung dieses zugehörigen Elements zusammengeführt wurden. Datentyp: Array "mergedPayloadIds": [ "String" ] |
| Ergebnis.Elemente.ZusätzlicheZugehörigeElemente.SysId | Sys_id des zugehörigen CI. Datentyp: Zeichenfolge |
| Ergebnis.Elemente.Klassenname | Sys_class_name dieses CI. Datentyp: Zeichenfolge |
| result.items.duplicateLookupIndices | Objekt mit Arrays von Indexwerten für items.lookup -Array-Elemente, die auf dasselbe zugehörige CI verweisen. Der Array-Name gibt das erste Element aus dem Array des Anforderungstextes items.lookup an, 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 im Array items.lookup auf dasselbe zugehörige CI verweist wie ein späteres Element aus diesem Array: "duplicateLookupIndices": [ "2": [Array] ] |
| Ergebnis.Elemente.Fehleranzahl | Anzahl der bei der Verarbeitung dieses CI aufgetretenen Fehler. Datentyp: Zahl |
| Ergebnis.Elemente.Fehler | Liste der bei der Verarbeitung des CI aufgetretenen Fehler. Datentyp: Array von Objekten "errors": [ { "error": "String", "message": "String" } ] |
| Ergebnis.Elemente.Fehler.Fehler | Typ des Fehlers, der bei der Verarbeitung dieses CI aufgetreten ist. Datentyp: Zeichenfolge |
| Ergebnis.Elemente.Fehlermeldung | Bei der Verarbeitung dieses CI ist eine Fehlermeldung aufgetreten. Datentyp: Zeichenfolge |
| Ergebnis.Elemente.Identifizierungsversuche | Liste der Versuche, die unternommen wurden, um dieses CI zu identifizieren. Datentyp: Array von Objekten "identificationAttempts": [ { "attemptResult": "String", "attributes": [Array], "hybridEntryCiAttributes": [Array], "identiferName": "String", "searchOnTable": [Array] } ] |
| Ergebnis.Elemente.Identifizierungsversuche.VersuchErgebnis | Ergebnis des CI-Identifizierungsversuchs. Mögliche Werte: * ABGEGLICHEN: Identifizierung erfolgreich. In der Identifier-Regeltabelle wurde ein eindeutiges CI gefunden, das genau mit den angegebenen Attributen übereinstimmt. * Multi_MATCH: Die Identifizierung ist mit einem Fehler fehlgeschlagen. In der Identifier-Regeltabelle wurden beim Abgleich mit den angegebenen Attributen doppelte CIs gefunden. * NO_MATCH: Identifizierung fehlgeschlagen. In der Identifier-Regeltabelle wurde kein CI gefunden, das den angegebenen Attributen entspricht. * ÜBERSPRUNGEN: Identifizierung nicht versucht. Die für die Suche in dieser Identifier-Regeltabelle erforderlichen Attribute wurden nicht angegeben, daher wurde die Regel nicht angewendet. {#identifyreconcile-POST-enhanced__ul_gmw_qn5_flb} Datentyp: Zeichenfolge |
| Ergebnis.Elemente.Identifizierungsversuche.Attribute | Liste der CI-Bezeichner-Eintragsattribute, die während dieses CI-Identifizierungsversuchs verwendet werden. Datentyp: Array Attributnamen und -typen hängen von den Anforderungstextdaten und dem verwendeten Bezeichner ab, z. B.: "attributes": [ "serial_number": "String", "serial_number_type": "String", ] |
| result.items.identificationAttempts.hybridEntryCiAttributes | Liste der CI-Bezeichner-Eintragsattribute, die während dieses CI-Identifizierungsversuchs verwendet werden. Datentyp: Array Attributnamen und -typen hängen von den Anforderungstextdaten und dem verwendeten Bezeichner ab, z. B.: "hybridEntryCiAttributes": [ "name": "String", "serial_number": "String" ] |
| Ergebnis.Elemente.Identifizierungsversuche.Bezeichnername | Identifier-Regel, die für diesen CI-Identifizierungsversuch verwendet wird. Datentyp: Zeichenfolge |
| result.items.identificationVersuche.searchOnTable | Name der Tabelle, die für diesen CI-Identifizierungsversuch durchsucht wurde. Datentyp: Zeichenfolge |
| result.items.identifierEntrySysId | Sys_id für die Identifier-Regel, die zum Identifizieren dieses CI verwendet wird. Bemerkbare Werte: * Unbekannt: Die Identifizierung dieses CI ist 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: * SKIPPED_CLASS_SWITCH * SKIPPED_CLASS_DOWNGRADE * ÜBERSPRUNGEN_KLASSEN_UPGRADE {#identifyreconcile-POST-enhanced__ul_pb2_dxp_snb} |
| Ergebnis.Elemente.Info.Nachricht | Nachricht, die zusätzliche Einblicke in den Grund für das Überspringen der erneuten Klassifizierung bietet. Datentyp: Zeichenfolge |
| result.items.info.ruleSysId | Sys_id der übereinstimmenden Reklassifizierungsbeschränkungsregel. Gilt nur, wenn die IRE die Neuklassifizierung aufgrund der Regel zur Einschränkung der Neuklassifizierung überspringt. Dieser Wert ist leer, wenn die erneute Klassifizierung aufgrund einer Nutzlast oder globalen Kennzeichnung übersprungen wird. Datentyp: Zeichenfolge |
| result.items.inputIndices | Liste der Indexwerte für CIs aus dem Array des Anforderungstextes items, die diesem CI entsprechen. Datentyp: Array von Objekten "inputIndices": [ { Number } ] |
| Ergebnis.Elemente.Marker | Liste der Markerwerte zur internen Verwendung. Datentyp: Array "markers": [] |
| result.items.mergedPayloadIds | Liste der sys_id-Werte für Teilnutzlasten aus der Tabelle „Teilliche CMDB-IRE-Nutzlasten" \[cmdb_ire_partial_payloads\], die während der Verarbeitung dieses CI zusammengeführt wurden. Datentyp: Array "mergedPayloadIds": [ "String" ] |
| Ergebnis.Elemente.Vorgang | Für dieses CI durchgefü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. * UPDATE: 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 allgemeinere 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ängerklasse oder untergeordnete Klasse ist. * UPDATE_WITH_UPGRADE: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine spezialisiertere Klasse (absteigende Klasse) geändert. {#identifyreconcile-POST-enhanced__ul_jhl_gg5_flb} Datentyp: Zeichenfolge |
| Ergebnis.Elemente.ZugehörigeElemente | Liste der zugehörigen CIs (Tabellensuch-CI) aus dem Array des Anforderungstextes items.lookup. 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 den Arrays items und items.lookup des Anforderungstexts, die diesem zugehörigen Element entsprechen. Datentyp: Array von Objekten "inputIndices": [ { "mainIndex": Number, "subIndex": Number } ] |
| result.items.relatedItems.inputIndices.mainIndex | Indexwert aus dem Array des Anforderungstexts items, der dem übergeordneten CI des zugehörigen Elements entspricht. Datentyp: Zahl |
| result.items.relatedItems.inputIndices.subIndex | Indexwert aus dem Array des Anforderungstexts items.lookup, der dem zugehörigen Element entspricht. Datentyp: Zahl |
| Ergebnis.Elemente.ZugehörigeElemente.Marker | Liste der Markerwerte zur internen Verwendung. Datentyp: Array "markers": [] |
| result.items.relatedItems.mergedPayloadIds | Liste der sys_id-Werte für Einträge in der Tabelle „Teilliche CMDB-IRE-Nutzlasten" \[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 Array des Anforderungstexts items.lookup. Datentyp: Array Bemerkbare 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. Bemerkbare Werte: * Unbekannt: Die Identifizierung dieses CI ist fehlgeschlagen. Details siehe errors. {#identifyreconcile-POST-enhanced__ul_zz5_5vb_glb} Datentyp: Zeichenfolge |
| Ergebnis.Elemente.Warnungen | Liste der Warnungen, die bei der Verarbeitung dieses CI aufgetreten sind. Datentyp: Array von Objekten "warnings": [ { "error": "String", "message": "String" } ] |
| Ergebnis.Elemente.Warnungen.Fehler | Typ der Warnung, die bei der Verarbeitung des CI aufgetreten ist. Datentyp: Zeichenfolge |
| Ergebnis.Elemente.Warnungen.Nachricht | Bei der Verarbeitung dieses CI ist eine Warnmeldung aufgetreten. Datentyp: Zeichenfolge |
| result.logContextId | Für diese Nutzlast gemeldete Kontext-ID. Datentyp: Zeichenfolge |
| result.relations | Liste der abhängigen Beziehungs-CIs aus dem Array des Anforderungstextes relations. Datentyp: Array von Objekten "relations": [ { "className": "String", "errorCount": Number, "errors": [Array], "inputIndices": [Array], "markers": [Array], "mergedPayloadIds": [Array], "operation": "String", "warnings": [Array] } ] |
| result.beziehungen.className | Der sys_class_name dieses abhängigen Beziehungs-CI. Einziger 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 Fehlers, der bei der Verarbeitung dieser abhängigen Beziehungs-CI aufgetreten ist. Datentyp: Zeichenfolge |
| Ergebnis.Beziehungen.Fehler.Meldung | Fehlermeldung bei der Verarbeitung dieses abhängigen Beziehungs-CI. Datentyp: Zeichenfolge |
| result.beziehungen.inputIndices | Liste der Indexwerte für die abhängigen Beziehungs-CI-Objekte im Array des Anforderungstextes relations, die diesem abhängigen Beziehungs-CI entsprechen. Datentyp: Array "inputIndices": [ Number ] |
| Ergebnis.Beziehungen.Marker | Liste der Markerwerte zur internen Verwendung. Datentyp: Array "markers": [] |
| result.beziehungen.mergedPayloadIds | Liste der sys_id-Werte für Teilnutzlasten aus der Tabelle „Teilliche CMDB-IRE-Nutzlasten" \[cmdb_ire_partial_payloads\], die während der Verarbeitung dieses abhängigen Beziehungs-CI zusammengeführt wurden. Datentyp: Array "mergedPayloadIds": [ "String" ] |
| Ergebnis.Beziehungen.Vorgang | Für dieses abhängige Beziehungs-CI durchgeführte Operation. Mögliche Werte: * EINFÜGEN: Das abhängige Beziehungs-CI wurde als neuer Datensatz in die Zieltabelle eingefügt. * INSERT_AS_INCOMPLETE: Das abhängige Beziehungs-CI wies Fehler auf und wurde in die Tabelle „CMDB IRE Unvollständige Nutzlasten" \[cmdb_ire_incomplete_payloads\] eingefügt. * INSERT_AS_partial: Das abhängige Beziehungs-CI wies Fehler auf und wurde in die Tabelle der teilweisen CMDB-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 dieser abhängigen Beziehungs-CI aufgetreten ist. Datentyp: Zeichenfolge |
| Ergebnis.Beziehungen.Warnungen.Nachricht | Bei der Verarbeitung dieses abhängigen Beziehungs-CI ist eine Warnmeldung aufgetreten. Datentyp: Zeichenfolge |
[ ]
{#identifyreconcile-POST-enhanced__table_mr2_yyn_rlb}
### cURL-Anforderung
Senden 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, dass die Nutzlast in die Tabelle „CMDB IRE Partielle Nutzlasten" \[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 abschließt, wobei die Option Erweiterte IRE für die Zusammenfassungsgenerierung aktiviert sein muss.
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 '{ \
}'
In der Antwort wird angezeigt, dass das Computer-CI eingefügt wird, und eine Zusammenfassung der durchgeführten Vorgänge angezeigt.
{
"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 den CMDB -Vorgang (Einfügen/Aktualisieren), der mit der angegebenen Nutzlast (Anforderungstext) ausgeführt werden soll, ohne dass die Vorgänge in der Datenbank committet werden.
Verwenden Sie diesen Endpunkt, um die Übermittlung einer Nutzlast (Anforderungstext) an den Endpunkt [Identifizierung und Abgleich -- POST /now/identifyreconcile](https://servicenow-prod.fluidtopics.net/ZRNLHAWYFKoNwL1GNeNMig#identifyreconcile-POST "Fügt Konfigurationselemente (CIs) in CMDB ein oder aktualisiert sie, indem auf die angegebene Nutzlast (Anforderungstext) Identifizierungs- und Abgleichregeln angewendet werden. Verwenden Sie diese API, anstatt CMDB direkt zu aktualisieren.") zu simulieren.
Verwenden Sie stattdessen den Endpunkt [Identifizierung und Abgleich -- POST /now/identifyreconcile/enhanced](https://servicenow-prod.fluidtopics.net/ZRNLHAWYFKoNwL1GNeNMig#identifyreconcile-POST-enhanced "Fügt Konfigurationselemente (CIs) in CMDB ein oder aktualisiert sie, indem auf die angegebene Nutzlast (Anforderungstext) Identifizierungs- und Abgleichregeln angewendet werden. Verwenden Sie diese API, anstatt CMDB direkt zu aktualisieren."), wenn Sie erweiterte IRE-Optionen angeben müssen. Weitere Informationen zu erweiterten IRE-Optionen finden Sie unter [Identification and Reconciliation Engine (IRE)](https://www.servicenow.com/docs/access?context=ire&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US).
### URL-Format
URL mit Versionsnummer: /api/now/{api_version}/identifyreconcile/query
Standard-URL: /api/now/identifyreconcile/query
### Unterstützte Anforderungsparameter
{#identifyreconcile-POST-query__entry__2}{#identifyreconcile-POST-query__version-RESTAPI}
| Name | Beschreibung |
|-|-|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum Beispiel v1 oder v2. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge |
[Tabelle : 13. Pfadparameter]
{#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 der unvollständigen 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 zu erstellenden oder zu aktualisierenden CIs. Datentyp: Array von Objekten "items": [ { "className": "String", "internal_id": "String", "lookup": [Array], "related": [Array], "settings": {Object}, "sys_object_source_info": {Object}, "values": {Object} } ] |
| elemente.klassenname | Erforderlich. Der sys_class_name (Klassen-/Tabellenname) des zu erstellenden oder zu aktualisierenden CI. Dieser Wert kann eine beliebige Tabelle CMDB sein, z. B. cmdb_ci_linux_server oder cmdb_ci_win_server. Datentyp: Zeichenfolge |
| item.internal_id | Eindeutiger Bezeichner für das Element in dieser Nutzlast Kann ein beliebiger Wert sein, muss aber innerhalb der Nutzlast eindeutig sein. Datentyp: Zeichenfolge |
| Items.Suche | Array von Objekten, in dem 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 zurück auf die Tabelle „Konfigurationselement" \[cmdb_ci\] enthält. Datentyp: Array aus Objekten "lookup": [ { "className": "String", "internal_id": "String", "sys_object_source_info": {Object}, "values": {Object} } ] |
| elemente.suche.klassenname | Erforderlich. sys_class_name oder Klassen-/Tabellenname des zu erstellenden oder zu aktualisierenden CI. Dieser Wert kann eine beliebige CMDB -Klasse/-Tabelle sein, z. B. cmdb_serial_number oder cmdb_ci_network_adapter, oder eine NichtCMDB -\[\]- Hierarchieklasse. Datentyp: Zeichenfolge |
| elemente.suche.internal_id | Eindeutiger Bezeichner für den Suchdatensatz in dieser Nutzlast Kann ein beliebiger Wert sein, muss aber innerhalb der Nutzlast eindeutig sein. Datentyp: Zeichenfolge |
| item.lookup.sys_object_source_info | Objekt, das einen eindeutigen CI-Bezeichner für eine angegebene Datenquelle beschreibt. Verschiedene Quellen können unterschiedliche Name/Wert-Paare für dasselbe CI aufweisen. Datentyp: Objekt "sys_object_source_info": { "source_feed": "String", "source_name": "String", "source_native_key": "String", "source_recency_timestamp": "String" } |
| item.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 |
| item.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 |
| item.lookup.sys_object_source_info.source_native_key | Eindeutiger Schlüssel/eindeutige ID aus der Quelle für das CI. Kann eine beliebige Zeichenfolge sein, die für das Element eindeutig ist. Datentyp: Zeichenfolge |
| item.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 |
| elemente.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 dem jedes Objekt einen zu erstellenden oder zu aktualisierenden Elementdatensatz beschreibt, basierend auf einer zugehörigen Tabelle, die einen Verweis auf das identifizierte CI der obersten Ebene enthält. Regeln in der Tabelle „Zugehöriger Eintrag" \[cmdb_related_entry\] definieren, welche Arten von Datensätzen dieses Array enthalten darf. Die zugehörige Tabelle kann die Konfigurationselement-Tabelle \[cmdb_ci\] erweitern, muss es aber nicht. Diese Datensätze werden nicht zum Identifizieren des Konfigurationselements verwendet. Datentyp: Array von Objekten "related": [ { "className": "String", "internal_id": "String", "sys_object_source_info": {Object}, "values": {Object} } ] |
| elemente.zugehörig.klassenname | Erforderlich. sys_class_name oder Klassen-/Tabellenname des zugehörigen Elements, das erstellt oder aktualisiert werden soll. Datentyp: Zeichenfolge |
| elemente.zugehörig.internal_id | Eindeutiger Bezeichner für das zugehörige Element in dieser Nutzlast Kann ein beliebiger Wert sein, muss aber innerhalb der Nutzlast eindeutig sein. Datentyp: Zeichenfolge |
| item.related.sys_object_source_info | Objekt, das einen eindeutigen CI-Bezeichner für eine angegebene Datenquelle beschreibt. Verschiedene Quellen können unterschiedliche Name/Wert-Paare für dasselbe CI aufweisen. Datentyp: Objekt "sys_object_source_info": { "source_feed": "String", "source_name": "String", "source_native_key": "String", "source_recency_timestamp": "String" } |
| item.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 |
| item.related.sys_object_source_info.source_name | Datenquelle für die zugehörigen Artikelinformationen. Dieser Wert muss einer der Auswahlwerte sein, die für das Feld „discovery_source" der Tabelle „Konfigurationselement" \[cmdb_ci\] definiert sind. Datentyp: Zeichenfolge |
| item.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 |
| item.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 die für dieses zugehörige Element zu erstellenden oder zu aktualisierenden Felder als Name/Wert-Paare beschreibt, 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" } |
| elemente.einstellungen | Objekt mit Parametern, die festlegen, welche Arten von Updates zulässig sind. Datentyp: Objekt "settings": { "skipReclassificationRestrictionRules": Boolean, "updateWithoutDowngrade": Boolean, "updateWithoutSwitch": Boolean, "updateWithoutUpgrade": Boolean } |
| elemente.einstellungen.reklassifizierungsbeschränkungsregeln überspringen | Kennzeichnung, die angibt, ob IRE die Ausführung der Regel zur Einschränkung der Neuklassifizierung überspringen soll, die der Klasse für das Nutzlastelement entspricht. Gültige Werte: * true: Ausführung der Regel überspringen. * „falsch": Führen Sie die Regel aus. Standardwert: false |
| elemente.einstellungen.updateOhneDowngrade | Kennzeichnung, die angibt, ob Update und Downgrade für dieses CI zulässig sind. Gültige Werte: * „wahr": Element wird aktualisiert, Downgrade ist jedoch nicht zulässig. * false: Sowohl Elementaktualisierungen als auch Downgrades sind zulässig. Datentyp: Boolesch Standardwert: false |
| elemente.einstellungen.updateOhneSchalter | Kennzeichnung, die angibt, ob dieses CI aktualisiert und seine Klasse gewechselt werden kann. Gültige Werte: * „wahr": Element wird aktualisiert, aber Klassenwechsel ist nicht zulässig. * false: Sowohl Elementaktualisierungen als auch Klassenwechsel sind zulässig. Datentyp: Boolesch Standardwert: false |
| elemente.einstellungen.updateOhneUpgrade | Kennzeichnung, die angibt, ob Update und Upgrade für dieses CI zulässig sind. Gültige Werte: * „wahr": Element wird aktualisiert, aber Upgrade ist nicht zulässig. * „falsch": Sowohl Element-Updates als auch -Upgrades sind zulässig. Datentyp: Boolesch Standardwert: false |
| item.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" } |
| item.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 |
| item.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 |
| item.sys_object_source_info.source_native_key | Eindeutiger Schlüssel/eindeutige ID aus der Quelle für das CI. Kann eine beliebige Zeichenfolge sein, die für das Element eindeutig ist. Datentyp: Zeichenfolge |
| item.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 die für dieses CI zu erstellenden oder zu aktualisierenden Felder als Name/Wert-Paare beschreibt, 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 | Referenzliste zwischen zwei Elementen in der Nutzlast. Datentyp: Array von Objekten "referenceItems": [ { "referenced": "String", "referencedBy": "String", "referenceField": "String" } ] |
| referenceItems.referenced | internal_id, das für das Element definiert ist, auf das von einem anderen Element verwiesen wird. Datentyp: Zeichenfolge |
| referenceItems.referencedBy | internal_id, das für das Element definiert ist und auf ein anderes Element verweist. Datentyp: Zeichenfolge |
| referenceItems.referenceField | Name des Referenzfelds in der Klasse/Tabelle für das Element referencedBy. Datentyp: Zeichenfolge |
| relations | Liste der Beziehungen zwischen zwei in der Nutzlast definierten Elementen. Ein Objekt in diesem Array kann eines von zwei Formaten verwenden: * Das Objekt kann eine Beziehung zwischen zwei Elementen der obersten Ebene (nur) mithilfe von Name-Wert-Paaren parent und child definieren, wobei Werte Elementindizes aus dem Nutzlast-Array items darstellen. * Das Objekt kann eine Beziehung zwischen zwei beliebigen Elementen definieren, einschließlich Elementen der obersten Ebene, zugehörigen Elementen oder Suchelementen, indem Schlüssel-Wert-Paare parent_id und child_id verwendet werden, wobei -Werte die für diese Elemente definierten internal_id -Werte darstellen. {#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" } ] |
| beziehungen.untergeordnetes element | Ganzzahlindex des CI-Objekts im Array items, das das untergeordnete Element in der Beziehung darstellt. Datentyp: Zahl |
| beziehungen.child_id | internal_id des untergeordneten Elements in der Beziehung. Datentyp: Zeichenfolge |
| beziehungen.übergeordnet | Ganzzahlindex des CI-Objekts im Array items, das das übergeordnete Element in der Beziehung darstellt. Datentyp: Zahl |
| beziehungen.parent_id | internal_id des übergeordneten Elements in der Beziehung. Datentyp: Zeichenfolge |
| beziehungen.sys_rel_source_info | Informationen zur Discovery-Quelle für die Beziehung. Bei Nicht-Abhängigkeitsbeziehungen befinden sich diese Informationen in der Tabelle „Beziehungsquellen" \[sys_rel_source\]. Datentyp: Objekt "sys_rel_source_info": { "source_name": "String", "source_feed": "String" } |
| beziehungen.sys_rel_source_info.quellenname | Name der Discovery-Quelle. Standard: Discovery-Quelle, die im API-Methodenparameter übergeben wird. |
| beziehungen.sys_rel_source_info.source_feed | Beliebige Zeichenfolge, die eine Unter-Discovery/ein Unterscan 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.type | Typ der Beziehung zwischen den übergeordneten und untergeordneten Elementen. Dies muss ein Namensfeldwert aus der Tabelle „CI-Beziehungstyp" \[cmdb_rel_type\] sein. Datentyp: Zeichenfolge |
[Tabelle : 15. Anforderungstextparameter (XML oder JSON)]
### Kopfzeilen
Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. 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/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass 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}
| Kopfzeile | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützt nur application/json. |
| Content-Type | Datenformat des Anforderungstexts. Unterstützt nur application/json. |
[Tabelle : 16. Anforderungskopfzeilen]
{#identifyreconcile-POST-query__entry__108}
| Kopfzeile | Beschreibung |
|-|-|
| Keine | |
[Tabelle : 17. Antwortkopfzeilen]
### 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 [HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.")der REST-API.
{#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 Anmeldeinformationen sind falsch oder wurden nicht übergeben. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Der Antworttext enthält Informationen zum Fehler. |
[Tabelle : 18. Statuscodes]
### Parameter des Antworttexts (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] ] |
| result.additionalCommittedItems | Liste der CIs, die nicht im Array des Anforderungstexts items zum Einfügen oder Aktualisieren enthalten sind. Datentyp: Array von Objekten "additionalCommittedItems": [ { "className": "String", "errorCount": Number, "identificationAttempts": [Array], "inputIndices": [Array], "markers": [Array], "mergedPayloads": [Array], "operation": "String", "sysId": "String" } ] |
| result.additionalCommittedItems.className | Der sys_class_name dieses zusätzlichen CI. Datentyp: Zeichenfolge |
| Ergebnis.zusätzlichefestgelegteElemente.Fehleranzahl | Anzahl der bei der Verarbeitung dieses zusätzlichen CI aufgetretenen Fehler. Datentyp: Zahl |
| Ergebnis.zusätzlicheCommittedItems.errors | Liste der Fehler, die bei der Verarbeitung dieses zusätzlichen CI aufgetreten sind. Datentyp: Array von Objekten "errors": [ { "error": "String", "message": "String" } ] |
| result.additionalCommittedItems.errors.error | Typ des Fehlers, der bei der Verarbeitung dieses zusätzlichen CI aufgetreten ist. Datentyp: Zeichenfolge |
| Ergebnis.zusätzlicheCommittedItems.errors.message | Fehlermeldung bei der Verarbeitung dieses zusätzlichen CI. Datentyp: Zeichenfolge |
| Ergebnis.ZusätzlicheZusätzlicheElemente.Identifizierungsversuche | Liste der Versuche, die unternommen wurden, um dieses zusätzliche CI zu identifizieren. Datentyp: Array von Objekten "identificationAttempts": [ { "attemptResult": "String", "attributes": [Array], "hybridEntryCiAttributes": [Array], "identiferName": "String", "searchOnTable": [Array] } ] |
| Ergebnis.zusätzlicheZusätzlicheElemente.Identifizierungsversuche.Versuchsergebnis | Ergebnis dieses zusätzlichen CI-Identifizierungsversuchs. Mögliche Werte: * ABGEGLICHEN: Identifizierung erfolgreich. In der Identifier-Regeltabelle wurde ein eindeutiges CI gefunden, das genau mit den angegebenen Attributen übereinstimmt. * Multi_MATCH: Die Identifizierung ist mit einem Fehler fehlgeschlagen. In der Identifier-Regeltabelle wurden beim Abgleich mit den angegebenen Attributen doppelte CIs gefunden. * NO_MATCH: Identifizierung fehlgeschlagen. In der Identifier-Regeltabelle wurde kein CI gefunden, das den angegebenen Attributen entspricht. * ÜBERSPRUNGEN: Identifizierung nicht versucht. Die für die Suche in dieser Identifier-Regeltabelle erforderlichen Attribute wurden nicht angegeben, daher wurde die Regel nicht angewendet. {#identifyreconcile-POST-query__ul_axc_bxx_glb} Datentyp: Zeichenfolge |
| Ergebnis.zusätzlicheZusätzlicheElemente.Identifizierungsversuche.Attribute | Array von CI-Identifier-Eintragsattributen, die bei diesem zusätzlichen CI-Identifizierungsversuch verwendet werden. Datentyp: Array Attributnamen und -typen hängen von den Anforderungstextdaten und dem verwendeten Bezeichner ab, z. B.: "attributes": [ "serial_number": "String", "serial_number_type": "String" ] |
| Ergebnis.zusätzlicheCommittedItems.IdentificationAttempts.HybridEntryCiAttributes | Liste der CI-Bezeichner-Eintragsattribute, die bei diesem zusätzlichen CI-Identifizierungsversuch verwendet werden. Datentyp: Array Attributnamen und -typen hängen von den Anforderungstextdaten und dem verwendeten Bezeichner ab, z. B.: "hybridEntryCiAttributes": [ "name": "String", "serial_number": "String" ] |
| Ergebnis.zusätzlichefestgelegteElemente.Identifizierungsversuche.Bezeichnername | Identifier-Regel, die für diesen zusätzlichen CI-Identifizierungsversuch verwendet wird. Datentyp: Zeichenfolge |
| result.additionalCommittedItems.identificationAttempts.searchOnTable | Name der Tabelle, in der nach diesem zusätzlichen CI-Identifizierungsversuch gesucht wurde. Datentyp: Zeichenfolge |
| result.additionalCommittedItems.identifierEntrySysId | Sys_id für die Identifier-Regel, die zum Identifizieren dieses zusätzlichen CI verwendet wird. Bemerkbare Werte: * Unbekannt: Die Identifizierung dieses zusätzlichen CI ist fehlgeschlagen. Details siehe errors. {#identifyreconcile-POST-query__ul_hlk_gyx_glb} Datentyp: Zeichenfolge |
| result.additionalCommittedItems.inputIndices | Liste der Indexwerte für CIs aus dem Array des Anforderungstextes items, die diesem zusätzlichen CI entsprechen. Datentyp: Array von Objekten "inputIndices": [ { Number } ] |
| Ergebnis.zusätzlicheCommittedItems.Marker | Liste der Markerwerte zur internen Verwendung. Datentyp: Array "markers": [] |
| result.additionalCommittedItems.mergedPayloads | Liste der sys_id-Werte für Teilnutzlasten aus der Tabelle „Teilliche CMDB-IRE-Nutzlasten" \[cmdb_ire_partial_payloads\], die während der Verarbeitung dieses zusätzlichen CI zusammengeführt wurden. Datentyp: Array "mergedPayloadIds": [ "String" ] |
| result.additionalCommittedItems.operation | Für dieses zusätzliche CI durchgeführter Vorgang. 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. * UPDATE: 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 allgemeinere 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ängerklasse oder untergeordnete Klasse ist. * UPDATE_WITH_UPGRADE: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine spezialisiertere Klasse (absteigende Klasse) geändert. {#identifyreconcile-POST-query__ul_dwt_qwx_glb} Datentyp: Zeichenfolge |
| result.additionalCommittedItems.sysId | Sys_id für dieses zusätzliche CI durch Identifizierung gefunden. Bemerkbare Werte: Unbekannt: Die Identifizierung dieses zusätzlichen CI ist fehlgeschlagen. Details siehe errors. Datentyp: Zeichenfolge |
| Ergebnis.zusätzlicheCommittedItems.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ätzlicheCommittedItems.Warnungen.Fehler | Typ der Warnung, die bei der Verarbeitung dieses zusätzlichen CI aufgetreten ist. Datentyp: Zeichenfolge |
| Ergebnis.zusätzlicheCommittedItems.Warnungen.Nachricht | Bei der Verarbeitung dieses zusätzlichen CI ist eine Warnmeldung aufgetreten. Datentyp: Zeichenfolge |
| result.additionalCommittedRelations | Liste der abhängigen Beziehungs-CIs, die nicht in der Liste des Anforderungstextes relations zum Einfügen oder Aktualisieren enthalten sind. Datentyp: Array von Objekten "additionalCommittedRelations": [ { "className": "String", "operation": "String", "markers": [Array], "inputIndices": [Array], "mergedPayloadIds": [Array] } ] |
| result.additionalCommittedRelations.className | Der sys_class_name dieses zusätzlichen abhängigen Beziehungs-CI. Einziger unterstützter Wert: * cmdb_rel_ci: Die CI-Beziehungstabelle. {#identifyreconcile-POST-query__ul_bsb_pxx_glb} Datentyp: Zeichenfolge |
| result.additionalCommittedRelations.errorCount | Anzahl der Fehler, die bei der Verarbeitung dieses zusätzlichen abhängigen Beziehungs-CI aufgetreten sind. Datentyp: Zahl |
| Ergebnis.zusätzlicheCommittedRelations.errors | Liste der Fehler, die bei der Verarbeitung dieses zusätzlichen CI für abhängige Beziehungen aufgetreten sind. Datentyp: Array von Objekten "errors": [ { "error": "String", "message": "String" } ] |
| result.additionalCommittedRelations.errors.error | Typ des Fehlers, der bei der Verarbeitung dieses zusätzlichen abhängigen Beziehungs-CI aufgetreten ist. Datentyp: Zeichenfolge |
| Ergebnis.zusätzlicheBestätigteBeziehungen.Fehler.Nachricht | Fehlermeldung beim Verarbeiten dieses zusätzlichen abhängigen Beziehungs-CI. Datentyp: Zeichenfolge |
| result.additionalCommittedRelations.inputIndexes | Liste der Indexwerte für abhängige Beziehungs-CI-Objekte im Array des Anforderungstexts relations, die diesem zusätzlichen abhängigen Beziehungs-CI entsprechen. Datentyp: Array "inputIndices": [ Number ] |
| result.additionalCommittedRelations.markers | Liste der Markerwerte zur internen Verwendung. Datentyp: Array "markers": [] |
| result.additionalCommittedRelations.mergedPayloadIds | Liste der sys_id-Werte für Teilnutzlasten aus der Tabelle „Teilliche CMDB-IRE-Nutzlasten" \[cmdb_ire_partial_payloads\], die während der Verarbeitung dieses zusätzlichen abhängigen Beziehungs-CI zusammengeführt wurden. Datentyp: Array "mergedPayloadIds": [ "String" ] |
| result.additionalCommittedRelations.operation | Für dieses zusätzliche abhängige Beziehungs-CI durchgeführte Operation. Mögliche Werte: * INSERT: Das CI der abhängigen Beziehung wird als neuer Datensatz in die Zieltabelle eingefügt. * INSERT_AS_INCOMPLETE: Das abhängige Beziehungs-CI wies Fehler auf und wird in die Tabelle „CMDB IRE Unvollständige Nutzlasten" \[cmdb_ire_incomplete_payloads\] eingefügt. * INSERT_AS_partial: Das abhängige Beziehungs-CI wies Fehler auf und wird in die Tabelle der teilweisen CMDB-IRE-Nutzlasten \[cmdb_ire_partial_payloads\] eingefügt. * NO_CHANGE: Für das abhängige Beziehungs-CI wird kein Vorgang ausgeführt. * UPDATE: 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 Array des Anforderungstexts items enthalten sind. 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] } ] |
| Ergebnis.Elemente.ZusätzlicheZugehörigeElemente | Liste der zugehörigen CIs (Tabellensuch-CI) aus der Tabelle „Teilweise Nutzlasten der CMDB-IRE" \[cmdb_ire_partial_payloads\]. Datentyp: Array von Objekten "additionalRelatedItems": [ { "className": "String", "inputIndices": [Array], "markers": [Array], "mergedPayloadIds": [Array], "sysId": "String" } ] |
| Ergebnis.Elemente.ZusätzlicheZugehörigeElemente.Klassenname | Der sys_class_name des zugehörigen Elements. Datentyp: Zeichenfolge |
| Ergebnis.Elemente.ZusätzlicheZugehörigeElemente.Eingabeindizes | Liste der Indexwerte für CIs aus dem Array des Anforderungstextes items, die diesem zugehörigen Element entsprechen. Datentyp: Array "inputIndices": [ Number ] |
| Ergebnis.Elemente.ZusätzlicheZugehörigeElemente.Marker | Liste der Markerwerte zur internen Verwendung. Datentyp: Array "markers": [] |
| result.items.additionalRelatedItems.mergedPayloadIds | Liste der sys_id-Werte für Teilnutzlasten aus der Tabelle „Teilliche CMDB-IRE-Nutzlasten" \[cmdb_ire_partial_payloads\], die während der Verarbeitung dieses zugehörigen Elements zusammengeführt wurden. Datentyp: Array "mergedPayloadIds": [ "String" ] |
| Ergebnis.Elemente.ZusätzlicheZugehörigeElemente.SysId | Sys_id des zugehörigen CI. Datentyp: Zeichenfolge |
| Ergebnis.Elemente.Klassenname | Sys_class_name dieses CI. Datentyp: Zeichenfolge |
| result.items.duplicateLookupIndices | Objekt mit Arrays von Indexwerten für items.lookup -Array-Elemente, die auf dasselbe zugehörige CI verweisen. Der Array-Name gibt das erste Element aus dem Array des Anforderungstextes items.lookup an, 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 im Array items.lookup auf dasselbe zugehörige CI verweist wie ein späteres Element aus diesem Array: "duplicateLookupIndices": [ "2": [Array] ] |
| Ergebnis.Elemente.Fehleranzahl | Anzahl der bei der Verarbeitung dieses CI aufgetretenen Fehler. Datentyp: Zahl |
| Ergebnis.Elemente.Fehler | Liste der bei der Verarbeitung des CI aufgetretenen Fehler. Datentyp: Array von Objekten "errors": [ { "error": "String", "message": "String" } ] |
| Ergebnis.Elemente.Fehler.Fehler | Typ des Fehlers, der bei der Verarbeitung dieses CI aufgetreten ist. Datentyp: Zeichenfolge |
| Ergebnis.Elemente.Fehlermeldung | Bei der Verarbeitung dieses CI ist eine Fehlermeldung aufgetreten. Datentyp: Zeichenfolge |
| Ergebnis.Elemente.Identifizierungsversuche | Liste der Versuche, die unternommen wurden, um dieses CI zu identifizieren. Datentyp: Array von Objekten "identificationAttempts": [ { "attemptResult": "String", "attributes": [Array], "hybridEntryCiAttributes": [Array], "identiferName": "String", "searchOnTable": [Array] } ] |
| Ergebnis.Elemente.Identifizierungsversuche.VersuchErgebnis | Ergebnis des CI-Identifizierungsversuchs. Mögliche Werte: * ABGEGLICHEN: Identifizierung erfolgreich. In der Identifier-Regeltabelle wurde ein eindeutiges CI gefunden, das genau mit den angegebenen Attributen übereinstimmt. * Multi_MATCH: Die Identifizierung ist mit einem Fehler fehlgeschlagen. In der Identifier-Regeltabelle wurden beim Abgleich mit den angegebenen Attributen doppelte CIs gefunden. * NO_MATCH: Identifizierung fehlgeschlagen. In der Identifier-Regeltabelle wurde kein CI gefunden, das den angegebenen Attributen entspricht. * ÜBERSPRUNGEN: Identifizierung nicht versucht. Die für die Suche in dieser Identifier-Regeltabelle erforderlichen Attribute wurden nicht angegeben, daher wurde die Regel nicht angewendet. {#identifyreconcile-POST-query__ul_gmw_qn5_flb} Datentyp: Zeichenfolge |
| Ergebnis.Elemente.Identifizierungsversuche.Attribute | Liste der CI-Bezeichner-Eintragsattribute, die während dieses CI-Identifizierungsversuchs verwendet werden. Datentyp: Array Attributnamen und -typen hängen von den Anforderungstextdaten und dem verwendeten Bezeichner ab, z. B.: "attributes": [ "serial_number": "String", "serial_number_type": "String", ] |
| result.items.identificationAttempts.hybridEntryCiAttributes | Liste der CI-Bezeichner-Eintragsattribute, die während dieses CI-Identifizierungsversuchs verwendet werden. Datentyp: Array Attributnamen und -typen hängen von den Anforderungstextdaten und dem verwendeten Bezeichner ab, z. B.: "hybridEntryCiAttributes": [ "name": "String", "serial_number": "String" ] |
| Ergebnis.Elemente.Identifizierungsversuche.Bezeichnername | Identifier-Regel, die für diesen CI-Identifizierungsversuch verwendet wird. Datentyp: Zeichenfolge |
| result.items.identificationVersuche.searchOnTable | Name der Tabelle, die für diesen CI-Identifizierungsversuch durchsucht wurde. Datentyp: Zeichenfolge |
| result.items.identifierEntrySysId | Sys_id für die Identifier-Regel, die zum Identifizieren dieses CI verwendet wird. Bemerkbare Werte: * Unbekannt: Die Identifizierung dieses CI ist 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: * SKIPPED_CLASS_SWITCH * SKIPPED_CLASS_DOWNGRADE * ÜBERSPRUNGEN_KLASSEN_UPGRADE {#identifyreconcile-POST-query__ul_pb2_dxp_snb} |
| Ergebnis.Elemente.Info.Nachricht | Nachricht, die zusätzliche Einblicke in den Grund für das Überspringen der erneuten Klassifizierung bietet. Datentyp: Zeichenfolge |
| result.items.info.ruleSysId | Sys_id der übereinstimmenden Reklassifizierungsbeschränkungsregel. Gilt nur, wenn die IRE die Neuklassifizierung aufgrund der Regel zur Einschränkung der Neuklassifizierung überspringt. Dieser Wert ist leer, wenn die erneute Klassifizierung aufgrund einer Nutzlast oder globalen Kennzeichnung übersprungen wird. Datentyp: Zeichenfolge |
| result.items.inputIndices | Liste der Indexwerte für CIs aus dem Array des Anforderungstextes items, die diesem CI entsprechen. Datentyp: Array von Objekten "inputIndices": [ { Number } ] |
| Ergebnis.Elemente.Marker | Liste der Markerwerte zur internen Verwendung. Datentyp: Array "markers": [] |
| result.items.mergedPayloadIds | Liste der sys_id-Werte für Teilnutzlasten aus der Tabelle „Teilliche CMDB-IRE-Nutzlasten" \[cmdb_ire_partial_payloads\], die während der Verarbeitung dieses CI zusammengeführt wurden. Datentyp: Array "mergedPayloadIds": [ "String" ] |
| Ergebnis.Elemente.Vorgang | Für dieses CI durchgefü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. * UPDATE: 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 allgemeinere 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ängerklasse oder untergeordnete Klasse ist. * UPDATE_WITH_UPGRADE: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine spezialisiertere Klasse (absteigende Klasse) geändert. {#identifyreconcile-POST-query__ul_jhl_gg5_flb} Datentyp: Zeichenfolge |
| Ergebnis.Elemente.ZugehörigeElemente | Liste der zugehörigen CIs (Tabellensuch-CI) aus dem Array des Anforderungstextes items.lookup. 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 den Arrays items und items.lookup des Anforderungstexts, die diesem zugehörigen Element entsprechen. Datentyp: Array von Objekten "inputIndices": [ { "mainIndex": Number, "subIndex": Number } ] |
| result.items.relatedItems.inputIndices.mainIndex | Indexwert aus dem Array des Anforderungstexts items, der dem übergeordneten CI des zugehörigen Elements entspricht. Datentyp: Zahl |
| result.items.relatedItems.inputIndices.subIndex | Indexwert aus dem Array des Anforderungstexts items.lookup, der dem zugehörigen Element entspricht. Datentyp: Zahl |
| Ergebnis.Elemente.ZugehörigeElemente.Marker | Liste der Markerwerte zur internen Verwendung. Datentyp: Array "markers": [] |
| result.items.relatedItems.mergedPayloadIds | Liste der sys_id-Werte für Einträge in der Tabelle „Teilliche CMDB-IRE-Nutzlasten" \[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 Array des Anforderungstexts items.lookup. Datentyp: Array Bemerkbare 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. Bemerkbare Werte: * Unbekannt: Die Identifizierung dieses CI ist fehlgeschlagen. Details siehe errors. {#identifyreconcile-POST-query__ul_zz5_5vb_glb} Datentyp: Zeichenfolge |
| Ergebnis.Elemente.Warnungen | Liste der Warnungen, die bei der Verarbeitung dieses CI aufgetreten sind. Datentyp: Array von Objekten "warnings": [ { "error": "String", "message": "String" } ] |
| Ergebnis.Elemente.Warnungen.Fehler | Typ der Warnung, die bei der Verarbeitung des CI aufgetreten ist. Datentyp: Zeichenfolge |
| Ergebnis.Elemente.Warnungen.Nachricht | Bei der Verarbeitung dieses CI ist eine Warnmeldung aufgetreten. Datentyp: Zeichenfolge |
| result.logContextId | Für diese Nutzlast gemeldete Kontext-ID. Datentyp: Zeichenfolge |
| result.relations | Liste der abhängigen Beziehungs-CIs aus dem Array des Anforderungstextes relations. Datentyp: Array von Objekten "relations": [ { "className": "String", "errorCount": Number, "errors": [Array], "inputIndices": [Array], "markers": [Array], "mergedPayloadIds": [Array], "operation": "String", "warnings": [Array] } ] |
| result.beziehungen.className | Der sys_class_name dieses abhängigen Beziehungs-CI. Einziger 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 Fehlers, der bei der Verarbeitung dieser abhängigen Beziehungs-CI aufgetreten ist. Datentyp: Zeichenfolge |
| Ergebnis.Beziehungen.Fehler.Meldung | Fehlermeldung bei der Verarbeitung dieses abhängigen Beziehungs-CI. Datentyp: Zeichenfolge |
| result.beziehungen.inputIndices | Liste der Indexwerte für die abhängigen Beziehungs-CI-Objekte im Array des Anforderungstextes relations, die diesem abhängigen Beziehungs-CI entsprechen. Datentyp: Array "inputIndices": [ Number ] |
| Ergebnis.Beziehungen.Marker | Liste der Markerwerte zur internen Verwendung. Datentyp: Array "markers": [] |
| result.beziehungen.mergedPayloadIds | Liste der sys_id-Werte für Teilnutzlasten aus der Tabelle „Teilliche CMDB-IRE-Nutzlasten" \[cmdb_ire_partial_payloads\], die während der Verarbeitung dieses abhängigen Beziehungs-CI zusammengeführt wurden. Datentyp: Array "mergedPayloadIds": [ "String" ] |
| Ergebnis.Beziehungen.Vorgang | Für dieses abhängige Beziehungs-CI durchgeführte Operation. Mögliche Werte: * EINFÜGEN: Das abhängige Beziehungs-CI wurde als neuer Datensatz in die Zieltabelle eingefügt. * INSERT_AS_INCOMPLETE: Das abhängige Beziehungs-CI wies Fehler auf und wurde in die Tabelle „CMDB IRE Unvollständige Nutzlasten" \[cmdb_ire_incomplete_payloads\] eingefügt. * INSERT_AS_partial: Das abhängige Beziehungs-CI wies Fehler auf und wurde in die Tabelle der teilweisen CMDB-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 dieser abhängigen Beziehungs-CI aufgetreten ist. Datentyp: Zeichenfolge |
| Ergebnis.Beziehungen.Warnungen.Nachricht | Bei der Verarbeitung dieses abhängigen Beziehungs-CI ist eine Warnmeldung aufgetreten. Datentyp: Zeichenfolge |
[ ]
### cURL-Anforderung
Simulieren Sie die Übermittlung einer Nutzlast, die einen Linux-Server (mit Seriennummern- und Netzwerkadapter-Suchvorgängen zugehöriger Elemente) 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 Hardwaretabelle \[cmdb_ci_hardware\] identifiziert und als Aktualisierung eines vorhandenen CI in der Linux-Servertabelle \[cmdb_ci_linux_server\] verarbeitet. Der IP-Switch wird ebenfalls über eine Hardwareregelsuche nach seinem Namen in der Hardware-Tabelle identifiziert und aktualisiert ein vorhandenes CI in der IP-Switch-Tabelle \[cmdb_ci_ip_Switch\]. Abschließend wird die IP-Verbindungsbeziehung zwischen Server und 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 den CMDB -Vorgang (Einfügen/Aktualisieren), der mit der angegebenen Nutzlast (Anforderungstext) ausgeführt werden soll, ohne dass die Vorgänge in der Datenbank committet werden.
Verwenden Sie diesen Endpunkt, um die Übermittlung einer Nutzlast (Anforderungstext) an den Endpunkt [Identifizierung und Abgleich -- POST /now/identifyreconcile/enhanced](https://servicenow-prod.fluidtopics.net/ZRNLHAWYFKoNwL1GNeNMig#identifyreconcile-POST-enhanced "Fügt Konfigurationselemente (CIs) in CMDB ein oder aktualisiert sie, indem auf die angegebene Nutzlast (Anforderungstext) Identifizierungs- und Abgleichregeln angewendet werden. Verwenden Sie diese API, anstatt CMDB direkt zu aktualisieren.") zu simulieren.
Diese Methode ähnelt der Methode [Identifizierung und Abgleich -- POST /now/identifyreconcile/query](https://servicenow-prod.fluidtopics.net/ZRNLHAWYFKoNwL1GNeNMig#identifyreconcile-POST-query "Bestimmt den CMDB -Vorgang (Einfügen/Aktualisieren), der mit der angegebenen Nutzlast (Anforderungstext) ausgeführt werden soll, ohne dass die Vorgänge in der Datenbank committet werden."), fügt jedoch folgende Funktionalität hinzu:
* Teilnutzlasten
* Gibt an, ob ein Artikelvorgang INSERT_AS_partial oder INSERT_INCOMPLETE ist, wenn für ein Element eine Warnung oder ein Fehler auftritt.
* 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 Funktion zur Deduplizierung der Nutzlast.
* Generiert eine Zusammenfassung.
{#identifyreconcile-POST-queryenhanced__ul_scj_jvk_xlb}
### URL-Format
URL mit Versionsnummer: /api/now/{api_version}/identifyreconcile/queryEnhanced
Standard-URL: /api/now/identifyreconcile/queryEnhanced
### Unterstützte Anforderungsparameter
{#identifyreconcile-POST-queryenhanced__entry__2}{#identifyreconcile-POST-queryenhanced__version-RESTAPI}
| Name | Beschreibung |
|-|-|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum Beispiel v1 oder v2. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge |
[Tabelle : 19. Pfadparameter]
{#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. Um die Standardwerte für die Optionen für teilweise Nutzlasten, teilweise Commits, deduplizierte Nutzlasten und das Generieren einer Zusammenfassung für erweiterte IRE zu überschreiben: `Partial_payloads:false,partial_commits:false,deduplizierte_nutzlasten:falsch,generate_summary:wahr` Hinweis: Standardmäßig oder wenn partial_payloads auf „true" festgelegt ist, sind sowohl partial_commits als auch deduplicate_payloads aktiviert, auch wenn sie auf „false" festgelegt sind, da diese Funktionen für die Funktionalität von Teilnutzlasten wichtig sind. Weitere Informationen zu erweiterten IRE-Optionen finden Sie unter [Identification and Reconciliation Engine (IRE)](https://www.servicenow.com/docs/access?context=ire&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US). Gültige Werte für jedes Name-Wert-Paar: * true: Aktivieren Sie diese Option für die erweiterte IRE. * „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 der unvollständigen 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 zu erstellenden oder zu aktualisierenden CIs. Datentyp: Array von Objekten "items": [ { "className": "String", "internal_id": "String", "lookup": [Array], "related": [Array], "settings": {Object}, "sys_object_source_info": {Object}, "values": {Object} } ] |
| elemente.klassenname | Erforderlich. Der sys_class_name (Klassen-/Tabellenname) des zu erstellenden oder zu aktualisierenden CI. Dieser Wert kann eine beliebige Tabelle CMDB sein, z. B. cmdb_ci_linux_server oder cmdb_ci_win_server. Datentyp: Zeichenfolge |
| item.internal_id | Eindeutiger Bezeichner für das Element in dieser Nutzlast Kann ein beliebiger Wert sein, muss aber innerhalb der Nutzlast eindeutig sein. Datentyp: Zeichenfolge |
| Items.Suche | Array von Objekten, in dem 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 zurück auf die Tabelle „Konfigurationselement" \[cmdb_ci\] enthält. Datentyp: Array aus Objekten "lookup": [ { "className": "String", "internal_id": "String", "sys_object_source_info": {Object}, "values": {Object} } ] |
| elemente.suche.klassenname | Erforderlich. sys_class_name oder Klassen-/Tabellenname des zu erstellenden oder zu aktualisierenden CI. Dieser Wert kann eine beliebige CMDB -Klasse/-Tabelle sein, z. B. cmdb_serial_number oder cmdb_ci_network_adapter, oder eine NichtCMDB -\[\]- Hierarchieklasse. Datentyp: Zeichenfolge |
| elemente.suche.internal_id | Eindeutiger Bezeichner für den Suchdatensatz in dieser Nutzlast Kann ein beliebiger Wert sein, muss aber innerhalb der Nutzlast eindeutig sein. Datentyp: Zeichenfolge |
| item.lookup.sys_object_source_info | Objekt, das einen eindeutigen CI-Bezeichner für eine angegebene Datenquelle beschreibt. Verschiedene Quellen können unterschiedliche Name/Wert-Paare für dasselbe CI aufweisen. Datentyp: Objekt "sys_object_source_info": { "source_feed": "String", "source_name": "String", "source_native_key": "String", "source_recency_timestamp": "String" } |
| item.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 |
| item.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 |
| item.lookup.sys_object_source_info.source_native_key | Eindeutiger Schlüssel/eindeutige ID aus der Quelle für das CI. Kann eine beliebige Zeichenfolge sein, die für das Element eindeutig ist. Datentyp: Zeichenfolge |
| item.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 |
| elemente.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 dem jedes Objekt einen zu erstellenden oder zu aktualisierenden Elementdatensatz beschreibt, basierend auf einer zugehörigen Tabelle, die einen Verweis auf das identifizierte CI der obersten Ebene enthält. Regeln in der Tabelle „Zugehöriger Eintrag" \[cmdb_related_entry\] definieren, welche Arten von Datensätzen dieses Array enthalten darf. Die zugehörige Tabelle kann die Konfigurationselement-Tabelle \[cmdb_ci\] erweitern, muss es aber nicht. Diese Datensätze werden nicht zum Identifizieren des Konfigurationselements verwendet. Datentyp: Array von Objekten "related": [ { "className": "String", "internal_id": "String", "sys_object_source_info": {Object}, "values": {Object} } ] |
| elemente.zugehörig.klassenname | Erforderlich. sys_class_name oder Klassen-/Tabellenname des zugehörigen Elements, das erstellt oder aktualisiert werden soll. Datentyp: Zeichenfolge |
| elemente.zugehörig.internal_id | Eindeutiger Bezeichner für das zugehörige Element in dieser Nutzlast Kann ein beliebiger Wert sein, muss aber innerhalb der Nutzlast eindeutig sein. Datentyp: Zeichenfolge |
| item.related.sys_object_source_info | Objekt, das einen eindeutigen CI-Bezeichner für eine angegebene Datenquelle beschreibt. Verschiedene Quellen können unterschiedliche Name/Wert-Paare für dasselbe CI aufweisen. Datentyp: Objekt "sys_object_source_info": { "source_feed": "String", "source_name": "String", "source_native_key": "String", "source_recency_timestamp": "String" } |
| item.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 |
| item.related.sys_object_source_info.source_name | Datenquelle für die zugehörigen Artikelinformationen. Dieser Wert muss einer der Auswahlwerte sein, die für das Feld „discovery_source" der Tabelle „Konfigurationselement" \[cmdb_ci\] definiert sind. Datentyp: Zeichenfolge |
| item.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 |
| item.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 die für dieses zugehörige Element zu erstellenden oder zu aktualisierenden Felder als Name/Wert-Paare beschreibt, 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" } |
| elemente.einstellungen | Objekt mit Parametern, die festlegen, welche Arten von Updates zulässig sind. Datentyp: Objekt "settings": { "skipReclassificationRestrictionRules": Boolean, "updateWithoutDowngrade": Boolean, "updateWithoutSwitch": Boolean, "updateWithoutUpgrade": Boolean } |
| elemente.einstellungen.reklassifizierungsbeschränkungsregeln überspringen | Kennzeichnung, die angibt, ob IRE die Ausführung der Regel zur Einschränkung der Neuklassifizierung überspringen soll, die der Klasse für das Nutzlastelement entspricht. Gültige Werte: * true: Ausführung der Regel überspringen. * „falsch": Führen Sie die Regel aus. Standardwert: false |
| elemente.einstellungen.updateOhneDowngrade | Kennzeichnung, die angibt, ob Update und Downgrade für dieses CI zulässig sind. Gültige Werte: * „wahr": Element wird aktualisiert, Downgrade ist jedoch nicht zulässig. * false: Sowohl Elementaktualisierungen als auch Downgrades sind zulässig. Datentyp: Boolesch Standardwert: false |
| elemente.einstellungen.updateOhneSchalter | Kennzeichnung, die angibt, ob dieses CI aktualisiert und seine Klasse gewechselt werden kann. Gültige Werte: * „wahr": Element wird aktualisiert, aber Klassenwechsel ist nicht zulässig. * false: Sowohl Elementaktualisierungen als auch Klassenwechsel sind zulässig. Datentyp: Boolesch Standardwert: false |
| elemente.einstellungen.updateOhneUpgrade | Kennzeichnung, die angibt, ob Update und Upgrade für dieses CI zulässig sind. Gültige Werte: * „wahr": Element wird aktualisiert, aber Upgrade ist nicht zulässig. * „falsch": Sowohl Element-Updates als auch -Upgrades sind zulässig. Datentyp: Boolesch Standardwert: false |
| item.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" } |
| item.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 |
| item.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 |
| item.sys_object_source_info.source_native_key | Eindeutiger Schlüssel/eindeutige ID aus der Quelle für das CI. Kann eine beliebige Zeichenfolge sein, die für das Element eindeutig ist. Datentyp: Zeichenfolge |
| item.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 die für dieses CI zu erstellenden oder zu aktualisierenden Felder als Name/Wert-Paare beschreibt, 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 | Referenzliste zwischen zwei Elementen in der Nutzlast. Datentyp: Array von Objekten "referenceItems": [ { "referenced": "String", "referencedBy": "String", "referenceField": "String" } ] |
| referenceItems.referenced | internal_id, das für das Element definiert ist, auf das von einem anderen Element verwiesen wird. Datentyp: Zeichenfolge |
| referenceItems.referencedBy | internal_id, das für das Element definiert ist und auf ein anderes Element verweist. Datentyp: Zeichenfolge |
| referenceItems.referenceField | Name des Referenzfelds in der Klasse/Tabelle für das Element referencedBy. Datentyp: Zeichenfolge |
| relations | Liste der Beziehungen zwischen zwei in der Nutzlast definierten Elementen. Ein Objekt in diesem Array kann eines von zwei Formaten verwenden: * Das Objekt kann eine Beziehung zwischen zwei Elementen der obersten Ebene (nur) mithilfe von Name-Wert-Paaren parent und child definieren, wobei Werte Elementindizes aus dem Nutzlast-Array items darstellen. * Das Objekt kann eine Beziehung zwischen zwei beliebigen Elementen definieren, einschließlich Elementen der obersten Ebene, zugehörigen Elementen oder Suchelementen, indem Schlüssel-Wert-Paare parent_id und child_id verwendet werden, wobei -Werte die für diese Elemente definierten internal_id -Werte darstellen. {#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" } ] |
| beziehungen.untergeordnetes element | Ganzzahlindex des CI-Objekts im Array items, das das untergeordnete Element in der Beziehung darstellt. Datentyp: Zahl |
| beziehungen.child_id | internal_id des untergeordneten Elements in der Beziehung. Datentyp: Zeichenfolge |
| beziehungen.übergeordnet | Ganzzahlindex des CI-Objekts im Array items, das das übergeordnete Element in der Beziehung darstellt. Datentyp: Zahl |
| beziehungen.parent_id | internal_id des übergeordneten Elements in der Beziehung. Datentyp: Zeichenfolge |
| beziehungen.sys_rel_source_info | Informationen zur Discovery-Quelle für die Beziehung. Bei Nicht-Abhängigkeitsbeziehungen befinden sich diese Informationen in der Tabelle „Beziehungsquellen" \[sys_rel_source\]. Datentyp: Objekt "sys_rel_source_info": { "source_name": "String", "source_feed": "String" } |
| beziehungen.sys_rel_source_info.quellenname | Name der Discovery-Quelle. Standard: Discovery-Quelle, die im API-Methodenparameter übergeben wird. |
| beziehungen.sys_rel_source_info.source_feed | Beliebige Zeichenfolge, die eine Unter-Discovery/ein Unterscan 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.type | Typ der Beziehung zwischen den übergeordneten und untergeordneten Elementen. Dies muss ein Namensfeldwert aus der Tabelle „CI-Beziehungstyp" \[cmdb_rel_type\] sein. Datentyp: Zeichenfolge |
[Tabelle : 21. Anforderungstextparameter (XML oder JSON)]
{#identifyreconcile-POST-queryenhanced__table_c2c_bzn_rlb}
### Kopfzeilen
Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. 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/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass 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}
| Kopfzeile | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützt nur application/json. |
| Content-Type | Datenformat des Anforderungstexts. Unterstützt nur application/json. |
[Tabelle : 22. Anforderungskopfzeilen]
{#identifyreconcile-POST-queryenhanced__entry__110}
| Kopfzeile | Beschreibung |
|-|-|
| Keine | |
[Tabelle : 23. Antwortkopfzeilen]
### 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 [HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/bHLogaRspC43ztA1sd~MJg "REST (REpresentational State Transfer) ist eine einfache zustandslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, sodass sie leichter miteinander kommunizieren können.")der REST-API.
{#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 Anmeldeinformationen sind falsch oder wurden nicht übergeben. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Das Fehlermeldungsdetail „Chunk ... ist kein gültiger Eintrag" gibt an, dass der Abfrageparameter options nicht das richtige Name-Wert-Paarformat aufweist. Wenn Sie beispielsweise den Parameter options des Typs „ `partial` " angeben, wird beispielsweise ein Statuscode 500 mit „Block \[partial\] is not a valid Eintrag" im Nachrichtendetail angezeigt. |
[Tabelle : 24. Statuscodes]
### Parameter des Antworttexts (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] ] |
| result.additionalCommittedItems | Liste der CIs, die nicht im Array des Anforderungstexts items zum Einfügen oder Aktualisieren enthalten sind. Datentyp: Array von Objekten "additionalCommittedItems": [ { "className": "String", "errorCount": Number, "identificationAttempts": [Array], "inputIndices": [Array], "markers": [Array], "mergedPayloads": [Array], "operation": "String", "sysId": "String" } ] |
| result.additionalCommittedItems.className | Der sys_class_name dieses zusätzlichen CI. Datentyp: Zeichenfolge |
| Ergebnis.zusätzlichefestgelegteElemente.Fehleranzahl | Anzahl der bei der Verarbeitung dieses zusätzlichen CI aufgetretenen Fehler. Datentyp: Zahl |
| Ergebnis.zusätzlicheCommittedItems.errors | Liste der Fehler, die bei der Verarbeitung dieses zusätzlichen CI aufgetreten sind. Datentyp: Array von Objekten "errors": [ { "error": "String", "message": "String" } ] |
| result.additionalCommittedItems.errors.error | Typ des Fehlers, der bei der Verarbeitung dieses zusätzlichen CI aufgetreten ist. Datentyp: Zeichenfolge |
| Ergebnis.zusätzlicheCommittedItems.errors.message | Fehlermeldung bei der Verarbeitung dieses zusätzlichen CI. Datentyp: Zeichenfolge |
| Ergebnis.ZusätzlicheZusätzlicheElemente.Identifizierungsversuche | Liste der Versuche, die unternommen wurden, um dieses zusätzliche CI zu identifizieren. Datentyp: Array von Objekten "identificationAttempts": [ { "attemptResult": "String", "attributes": [Array], "hybridEntryCiAttributes": [Array], "identiferName": "String", "searchOnTable": [Array] } ] |
| Ergebnis.zusätzlicheZusätzlicheElemente.Identifizierungsversuche.Versuchsergebnis | Ergebnis dieses zusätzlichen CI-Identifizierungsversuchs. Mögliche Werte: * ABGEGLICHEN: Identifizierung erfolgreich. In der Identifier-Regeltabelle wurde ein eindeutiges CI gefunden, das genau mit den angegebenen Attributen übereinstimmt. * Multi_MATCH: Die Identifizierung ist mit einem Fehler fehlgeschlagen. In der Identifier-Regeltabelle wurden beim Abgleich mit den angegebenen Attributen doppelte CIs gefunden. * NO_MATCH: Identifizierung fehlgeschlagen. In der Identifier-Regeltabelle wurde kein CI gefunden, das den angegebenen Attributen entspricht. * ÜBERSPRUNGEN: Identifizierung nicht versucht. Die für die Suche in dieser Identifier-Regeltabelle erforderlichen Attribute wurden nicht angegeben, daher wurde die Regel nicht angewendet. {#identifyreconcile-POST-queryenhanced__ul_axc_bxx_glb} Datentyp: Zeichenfolge |
| Ergebnis.zusätzlicheZusätzlicheElemente.Identifizierungsversuche.Attribute | Array von CI-Identifier-Eintragsattributen, die bei diesem zusätzlichen CI-Identifizierungsversuch verwendet werden. Datentyp: Array Attributnamen und -typen hängen von den Anforderungstextdaten und dem verwendeten Bezeichner ab, z. B.: "attributes": [ "serial_number": "String", "serial_number_type": "String" ] |
| Ergebnis.zusätzlicheCommittedItems.IdentificationAttempts.HybridEntryCiAttributes | Liste der CI-Bezeichner-Eintragsattribute, die bei diesem zusätzlichen CI-Identifizierungsversuch verwendet werden. Datentyp: Array Attributnamen und -typen hängen von den Anforderungstextdaten und dem verwendeten Bezeichner ab, z. B.: "hybridEntryCiAttributes": [ "name": "String", "serial_number": "String" ] |
| Ergebnis.zusätzlichefestgelegteElemente.Identifizierungsversuche.Bezeichnername | Identifier-Regel, die für diesen zusätzlichen CI-Identifizierungsversuch verwendet wird. Datentyp: Zeichenfolge |
| result.additionalCommittedItems.identificationAttempts.searchOnTable | Name der Tabelle, in der nach diesem zusätzlichen CI-Identifizierungsversuch gesucht wurde. Datentyp: Zeichenfolge |
| result.additionalCommittedItems.identifierEntrySysId | Sys_id für die Identifier-Regel, die zum Identifizieren dieses zusätzlichen CI verwendet wird. Bemerkbare Werte: * Unbekannt: Die Identifizierung dieses zusätzlichen CI ist fehlgeschlagen. Details siehe errors. {#identifyreconcile-POST-queryenhanced__ul_hlk_gyx_glb} Datentyp: Zeichenfolge |
| result.additionalCommittedItems.inputIndices | Liste der Indexwerte für CIs aus dem Array des Anforderungstextes items, die diesem zusätzlichen CI entsprechen. Datentyp: Array von Objekten "inputIndices": [ { Number } ] |
| Ergebnis.zusätzlicheCommittedItems.Marker | Liste der Markerwerte zur internen Verwendung. Datentyp: Array "markers": [] |
| result.additionalCommittedItems.mergedPayloads | Liste der sys_id-Werte für Teilnutzlasten aus der Tabelle „Teilliche CMDB-IRE-Nutzlasten" \[cmdb_ire_partial_payloads\], die während der Verarbeitung dieses zusätzlichen CI zusammengeführt wurden. Datentyp: Array "mergedPayloadIds": [ "String" ] |
| result.additionalCommittedItems.operation | Für dieses zusätzliche CI durchgeführter Vorgang. 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. * UPDATE: 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 allgemeinere 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ängerklasse oder untergeordnete Klasse ist. * UPDATE_WITH_UPGRADE: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine spezialisiertere Klasse (absteigende Klasse) geändert. {#identifyreconcile-POST-queryenhanced__ul_dwt_qwx_glb} Datentyp: Zeichenfolge |
| result.additionalCommittedItems.sysId | Sys_id für dieses zusätzliche CI durch Identifizierung gefunden. Bemerkbare Werte: Unbekannt: Die Identifizierung dieses zusätzlichen CI ist fehlgeschlagen. Details siehe errors. Datentyp: Zeichenfolge |
| Ergebnis.zusätzlicheCommittedItems.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ätzlicheCommittedItems.Warnungen.Fehler | Typ der Warnung, die bei der Verarbeitung dieses zusätzlichen CI aufgetreten ist. Datentyp: Zeichenfolge |
| Ergebnis.zusätzlicheCommittedItems.Warnungen.Nachricht | Bei der Verarbeitung dieses zusätzlichen CI ist eine Warnmeldung aufgetreten. Datentyp: Zeichenfolge |
| result.additionalCommittedRelations | Liste der abhängigen Beziehungs-CIs, die nicht in der Liste des Anforderungstextes relations zum Einfügen oder Aktualisieren enthalten sind. Datentyp: Array von Objekten "additionalCommittedRelations": [ { "className": "String", "operation": "String", "markers": [Array], "inputIndices": [Array], "mergedPayloadIds": [Array] } ] |
| result.additionalCommittedRelations.className | Der sys_class_name dieses zusätzlichen abhängigen Beziehungs-CI. Einziger unterstützter Wert: * cmdb_rel_ci: Die CI-Beziehungstabelle. {#identifyreconcile-POST-queryenhanced__ul_bsb_pxx_glb} Datentyp: Zeichenfolge |
| result.additionalCommittedRelations.errorCount | Anzahl der Fehler, die bei der Verarbeitung dieses zusätzlichen abhängigen Beziehungs-CI aufgetreten sind. Datentyp: Zahl |
| Ergebnis.zusätzlicheCommittedRelations.errors | Liste der Fehler, die bei der Verarbeitung dieses zusätzlichen CI für abhängige Beziehungen aufgetreten sind. Datentyp: Array von Objekten "errors": [ { "error": "String", "message": "String" } ] |
| result.additionalCommittedRelations.errors.error | Typ des Fehlers, der bei der Verarbeitung dieses zusätzlichen abhängigen Beziehungs-CI aufgetreten ist. Datentyp: Zeichenfolge |
| Ergebnis.zusätzlicheBestätigteBeziehungen.Fehler.Nachricht | Fehlermeldung beim Verarbeiten dieses zusätzlichen abhängigen Beziehungs-CI. Datentyp: Zeichenfolge |
| result.additionalCommittedRelations.inputIndexes | Liste der Indexwerte für abhängige Beziehungs-CI-Objekte im Array des Anforderungstexts relations, die diesem zusätzlichen abhängigen Beziehungs-CI entsprechen. Datentyp: Array "inputIndices": [ Number ] |
| result.additionalCommittedRelations.markers | Liste der Markerwerte zur internen Verwendung. Datentyp: Array "markers": [] |
| result.additionalCommittedRelations.mergedPayloadIds | Liste der sys_id-Werte für Teilnutzlasten aus der Tabelle „Teilliche CMDB-IRE-Nutzlasten" \[cmdb_ire_partial_payloads\], die während der Verarbeitung dieses zusätzlichen abhängigen Beziehungs-CI zusammengeführt wurden. Datentyp: Array "mergedPayloadIds": [ "String" ] |
| result.additionalCommittedRelations.operation | Für dieses zusätzliche abhängige Beziehungs-CI durchgeführte Operation. Mögliche Werte: * INSERT: Das CI der abhängigen Beziehung wird als neuer Datensatz in die Zieltabelle eingefügt. * INSERT_AS_INCOMPLETE: Das abhängige Beziehungs-CI wies Fehler auf und wird in die Tabelle „CMDB IRE Unvollständige Nutzlasten" \[cmdb_ire_incomplete_payloads\] eingefügt. * INSERT_AS_partial: Das abhängige Beziehungs-CI wies Fehler auf und wird in die Tabelle der teilweisen CMDB-IRE-Nutzlasten \[cmdb_ire_partial_payloads\] eingefügt. * NO_CHANGE: Für das abhängige Beziehungs-CI wird kein Vorgang ausgeführt. * UPDATE: 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 Array des Anforderungstexts items enthalten sind. 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] } ] |
| Ergebnis.Elemente.ZusätzlicheZugehörigeElemente | Liste der zugehörigen CIs (Tabellensuch-CI) aus der Tabelle „Teilweise Nutzlasten der CMDB-IRE" \[cmdb_ire_partial_payloads\]. Datentyp: Array von Objekten "additionalRelatedItems": [ { "className": "String", "inputIndices": [Array], "markers": [Array], "mergedPayloadIds": [Array], "sysId": "String" } ] |
| Ergebnis.Elemente.ZusätzlicheZugehörigeElemente.Klassenname | Der sys_class_name des zugehörigen Elements. Datentyp: Zeichenfolge |
| Ergebnis.Elemente.ZusätzlicheZugehörigeElemente.Eingabeindizes | Liste der Indexwerte für CIs aus dem Array des Anforderungstextes items, die diesem zugehörigen Element entsprechen. Datentyp: Array "inputIndices": [ Number ] |
| Ergebnis.Elemente.ZusätzlicheZugehörigeElemente.Marker | Liste der Markerwerte zur internen Verwendung. Datentyp: Array "markers": [] |
| result.items.additionalRelatedItems.mergedPayloadIds | Liste der sys_id-Werte für Teilnutzlasten aus der Tabelle „Teilliche CMDB-IRE-Nutzlasten" \[cmdb_ire_partial_payloads\], die während der Verarbeitung dieses zugehörigen Elements zusammengeführt wurden. Datentyp: Array "mergedPayloadIds": [ "String" ] |
| Ergebnis.Elemente.ZusätzlicheZugehörigeElemente.SysId | Sys_id des zugehörigen CI. Datentyp: Zeichenfolge |
| Ergebnis.Elemente.Klassenname | Sys_class_name dieses CI. Datentyp: Zeichenfolge |
| result.items.duplicateLookupIndices | Objekt mit Arrays von Indexwerten für items.lookup -Array-Elemente, die auf dasselbe zugehörige CI verweisen. Der Array-Name gibt das erste Element aus dem Array des Anforderungstextes items.lookup an, 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 im Array items.lookup auf dasselbe zugehörige CI verweist wie ein späteres Element aus diesem Array: "duplicateLookupIndices": [ "2": [Array] ] |
| Ergebnis.Elemente.Fehleranzahl | Anzahl der bei der Verarbeitung dieses CI aufgetretenen Fehler. Datentyp: Zahl |
| Ergebnis.Elemente.Fehler | Liste der bei der Verarbeitung des CI aufgetretenen Fehler. Datentyp: Array von Objekten "errors": [ { "error": "String", "message": "String" } ] |
| Ergebnis.Elemente.Fehler.Fehler | Typ des Fehlers, der bei der Verarbeitung dieses CI aufgetreten ist. Datentyp: Zeichenfolge |
| Ergebnis.Elemente.Fehlermeldung | Bei der Verarbeitung dieses CI ist eine Fehlermeldung aufgetreten. Datentyp: Zeichenfolge |
| Ergebnis.Elemente.Identifizierungsversuche | Liste der Versuche, die unternommen wurden, um dieses CI zu identifizieren. Datentyp: Array von Objekten "identificationAttempts": [ { "attemptResult": "String", "attributes": [Array], "hybridEntryCiAttributes": [Array], "identiferName": "String", "searchOnTable": [Array] } ] |
| Ergebnis.Elemente.Identifizierungsversuche.VersuchErgebnis | Ergebnis des CI-Identifizierungsversuchs. Mögliche Werte: * ABGEGLICHEN: Identifizierung erfolgreich. In der Identifier-Regeltabelle wurde ein eindeutiges CI gefunden, das genau mit den angegebenen Attributen übereinstimmt. * Multi_MATCH: Die Identifizierung ist mit einem Fehler fehlgeschlagen. In der Identifier-Regeltabelle wurden beim Abgleich mit den angegebenen Attributen doppelte CIs gefunden. * NO_MATCH: Identifizierung fehlgeschlagen. In der Identifier-Regeltabelle wurde kein CI gefunden, das den angegebenen Attributen entspricht. * ÜBERSPRUNGEN: Identifizierung nicht versucht. Die für die Suche in dieser Identifier-Regeltabelle erforderlichen Attribute wurden nicht angegeben, daher wurde die Regel nicht angewendet. {#identifyreconcile-POST-queryenhanced__ul_gmw_qn5_flb} Datentyp: Zeichenfolge |
| Ergebnis.Elemente.Identifizierungsversuche.Attribute | Liste der CI-Bezeichner-Eintragsattribute, die während dieses CI-Identifizierungsversuchs verwendet werden. Datentyp: Array Attributnamen und -typen hängen von den Anforderungstextdaten und dem verwendeten Bezeichner ab, z. B.: "attributes": [ "serial_number": "String", "serial_number_type": "String", ] |
| result.items.identificationAttempts.hybridEntryCiAttributes | Liste der CI-Bezeichner-Eintragsattribute, die während dieses CI-Identifizierungsversuchs verwendet werden. Datentyp: Array Attributnamen und -typen hängen von den Anforderungstextdaten und dem verwendeten Bezeichner ab, z. B.: "hybridEntryCiAttributes": [ "name": "String", "serial_number": "String" ] |
| Ergebnis.Elemente.Identifizierungsversuche.Bezeichnername | Identifier-Regel, die für diesen CI-Identifizierungsversuch verwendet wird. Datentyp: Zeichenfolge |
| result.items.identificationVersuche.searchOnTable | Name der Tabelle, die für diesen CI-Identifizierungsversuch durchsucht wurde. Datentyp: Zeichenfolge |
| result.items.identifierEntrySysId | Sys_id für die Identifier-Regel, die zum Identifizieren dieses CI verwendet wird. Bemerkbare Werte: * Unbekannt: Die Identifizierung dieses CI ist 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: * SKIPPED_CLASS_SWITCH * SKIPPED_CLASS_DOWNGRADE * ÜBERSPRUNGEN_KLASSEN_UPGRADE {#identifyreconcile-POST-queryenhanced__ul_pb2_dxp_snb} |
| Ergebnis.Elemente.Info.Nachricht | Nachricht, die zusätzliche Einblicke in den Grund für das Überspringen der erneuten Klassifizierung bietet. Datentyp: Zeichenfolge |
| result.items.info.ruleSysId | Sys_id der übereinstimmenden Reklassifizierungsbeschränkungsregel. Gilt nur, wenn die IRE die Neuklassifizierung aufgrund der Regel zur Einschränkung der Neuklassifizierung überspringt. Dieser Wert ist leer, wenn die erneute Klassifizierung aufgrund einer Nutzlast oder globalen Kennzeichnung übersprungen wird. Datentyp: Zeichenfolge |
| result.items.inputIndices | Liste der Indexwerte für CIs aus dem Array des Anforderungstextes items, die diesem CI entsprechen. Datentyp: Array von Objekten "inputIndices": [ { Number } ] |
| Ergebnis.Elemente.Marker | Liste der Markerwerte zur internen Verwendung. Datentyp: Array "markers": [] |
| result.items.mergedPayloadIds | Liste der sys_id-Werte für Teilnutzlasten aus der Tabelle „Teilliche CMDB-IRE-Nutzlasten" \[cmdb_ire_partial_payloads\], die während der Verarbeitung dieses CI zusammengeführt wurden. Datentyp: Array "mergedPayloadIds": [ "String" ] |
| Ergebnis.Elemente.Vorgang | Für dieses CI durchgefü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. * UPDATE: 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 allgemeinere 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ängerklasse oder untergeordnete Klasse ist. * UPDATE_WITH_UPGRADE: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine spezialisiertere Klasse (absteigende Klasse) geändert. {#identifyreconcile-POST-queryenhanced__ul_jhl_gg5_flb} Datentyp: Zeichenfolge |
| Ergebnis.Elemente.ZugehörigeElemente | Liste der zugehörigen CIs (Tabellensuch-CI) aus dem Array des Anforderungstextes items.lookup. 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 den Arrays items und items.lookup des Anforderungstexts, die diesem zugehörigen Element entsprechen. Datentyp: Array von Objekten "inputIndices": [ { "mainIndex": Number, "subIndex": Number } ] |
| result.items.relatedItems.inputIndices.mainIndex | Indexwert aus dem Array des Anforderungstexts items, der dem übergeordneten CI des zugehörigen Elements entspricht. Datentyp: Zahl |
| result.items.relatedItems.inputIndices.subIndex | Indexwert aus dem Array des Anforderungstexts items.lookup, der dem zugehörigen Element entspricht. Datentyp: Zahl |
| Ergebnis.Elemente.ZugehörigeElemente.Marker | Liste der Markerwerte zur internen Verwendung. Datentyp: Array "markers": [] |
| result.items.relatedItems.mergedPayloadIds | Liste der sys_id-Werte für Einträge in der Tabelle „Teilliche CMDB-IRE-Nutzlasten" \[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 Array des Anforderungstexts items.lookup. Datentyp: Array Bemerkbare 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. Bemerkbare Werte: * Unbekannt: Die Identifizierung dieses CI ist fehlgeschlagen. Details siehe errors. {#identifyreconcile-POST-queryenhanced__ul_zz5_5vb_glb} Datentyp: Zeichenfolge |
| Ergebnis.Elemente.Warnungen | Liste der Warnungen, die bei der Verarbeitung dieses CI aufgetreten sind. Datentyp: Array von Objekten "warnings": [ { "error": "String", "message": "String" } ] |
| Ergebnis.Elemente.Warnungen.Fehler | Typ der Warnung, die bei der Verarbeitung des CI aufgetreten ist. Datentyp: Zeichenfolge |
| Ergebnis.Elemente.Warnungen.Nachricht | Bei der Verarbeitung dieses CI ist eine Warnmeldung aufgetreten. Datentyp: Zeichenfolge |
| result.logContextId | Für diese Nutzlast gemeldete Kontext-ID. Datentyp: Zeichenfolge |
| result.relations | Liste der abhängigen Beziehungs-CIs aus dem Array des Anforderungstextes relations. Datentyp: Array von Objekten "relations": [ { "className": "String", "errorCount": Number, "errors": [Array], "inputIndices": [Array], "markers": [Array], "mergedPayloadIds": [Array], "operation": "String", "warnings": [Array] } ] |
| result.beziehungen.className | Der sys_class_name dieses abhängigen Beziehungs-CI. Einziger 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 Fehlers, der bei der Verarbeitung dieser abhängigen Beziehungs-CI aufgetreten ist. Datentyp: Zeichenfolge |
| Ergebnis.Beziehungen.Fehler.Meldung | Fehlermeldung bei der Verarbeitung dieses abhängigen Beziehungs-CI. Datentyp: Zeichenfolge |
| result.beziehungen.inputIndices | Liste der Indexwerte für die abhängigen Beziehungs-CI-Objekte im Array des Anforderungstextes relations, die diesem abhängigen Beziehungs-CI entsprechen. Datentyp: Array "inputIndices": [ Number ] |
| Ergebnis.Beziehungen.Marker | Liste der Markerwerte zur internen Verwendung. Datentyp: Array "markers": [] |
| result.beziehungen.mergedPayloadIds | Liste der sys_id-Werte für Teilnutzlasten aus der Tabelle „Teilliche CMDB-IRE-Nutzlasten" \[cmdb_ire_partial_payloads\], die während der Verarbeitung dieses abhängigen Beziehungs-CI zusammengeführt wurden. Datentyp: Array "mergedPayloadIds": [ "String" ] |
| Ergebnis.Beziehungen.Vorgang | Für dieses abhängige Beziehungs-CI durchgeführte Operation. Mögliche Werte: * EINFÜGEN: Das abhängige Beziehungs-CI wurde als neuer Datensatz in die Zieltabelle eingefügt. * INSERT_AS_INCOMPLETE: Das abhängige Beziehungs-CI wies Fehler auf und wurde in die Tabelle „CMDB IRE Unvollständige Nutzlasten" \[cmdb_ire_incomplete_payloads\] eingefügt. * INSERT_AS_partial: Das abhängige Beziehungs-CI wies Fehler auf und wurde in die Tabelle der teilweisen CMDB-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 dieser abhängigen Beziehungs-CI aufgetreten ist. Datentyp: Zeichenfolge |
| Ergebnis.Beziehungen.Warnungen.Nachricht | Bei der Verarbeitung dieses abhängigen Beziehungs-CI ist eine Warnmeldung 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, dass die Nutzlast in die Tabelle „CMDB IRE Partielle Nutzlasten" \[cmdb_ire_partial_payloads\] eingefügt wird.
{
"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 abschließt, wobei die Option „Erweiterte 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, dass das Computer-CI eingefügt wird, und zeigt eine Zusammenfassung der durchzuführenden Vorgänge.
{
"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
}
}
}
}