Identifizierungs- und Abgleich-API

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 87 Minuten Lesedauer

    • Die Identification and Reconciliation -API verwendet die Identification and Reconciliation-Engine (IRE), um die Erstellung doppelter Konfigurationselemente (CIs) zu minimieren und CI-Attribute abzugleichen, indem beim Aktualisieren der 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).

    Identifizierung und Abgleich – POST /now/identifyreconcile

    Fügt Konfigurationselemente (CIs) in CMDB ein oder aktualisiert sie, indem Identifizierungs- und Abgleichsregeln auf die angegebene Nutzlast (Anforderungstext) angewendet werden. Verwenden Sie diese API, anstatt CMDB direkt zu aktualisieren.

    Verwenden Sie den Endpunkt Identifizierung und Abgleich – POST /now/identifyreconcile/query, um die Übermittlung einer Nutzlast an diesen Endpunkt zu simulieren, ohne Änderungen an der Datenbank vorzunehmen.

    Verwenden Sie stattdessen den Endpunkt Identifizierung und Abgleich – POST /now/identifyreconcile/enhanced, wenn Sie erweiterte IRE-Optionen angeben müssen. Weitere Informationen zu erweiterten IRE-Optionen finden Sie unter Identification and Reconciliation Engine (IRE).

    URL-Format

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

    Standard-URL: /api/now/identifyreconcile

    Unterstützte Anforderungsparameter

    Tabelle : 1. Pfadparameter
    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 : 2. Abfrageparameter
    Name Beschreibung
    sysparm_data_source Gibt die Quelle der CI-Informationen an. 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 : 3. Anforderungstextparameter (XML oder JSON)
    Name Beschreibung
    items Array von Objekten, in dem jedes Objekt ein zu erstellendes oder zu aktualisierendes CI beschreibt.

    Datentyp: Array

    "items": [
  {
    "className": "String",
    "internal_id": "String",
    "lookup": [Array],
    "related": [Array],
    "settings": {Object},
    "sys_object_source_info": {Object},
    "values": {Object}
  }
]
    items.className 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
    items.internal_id Eindeutiger Bezeichner für dieses Element in dieser Nutzlast. Kann ein beliebiger Wert sein, muss jedoch innerhalb der Nutzlast eindeutig sein.

    Datentyp: Zeichenfolge
    items.lookup Array von Objekten, in dem jedes Objekt einen Lookup-basierten Identifizierungsdatensatz beschreibt. Diese Datensätze werden verwendet, um das Konfigurationselement der obersten Ebene basierend auf einer Suchtabelle zu identifizieren, die einen Verweis auf die Tabelle „Konfigurationselement“ [cmdb_ci] enthält.

    Datentyp: Array

    "lookup": [
  {
    "className": "String",
    "internal_id": "String",
    "sys_object_source_info": {Object},
    "values": {Object}
  }
]
    items.lookup.className Erforderlich. sys_class_name oder Klassen-/Tabellenname des zu erstellenden oder zu aktualisierenden CI. Dieser Wert kann eine beliebige Klasse/Tabelle von CMDB sein, z. B. cmdb_serial_number oder cmdb_ci_network_adapter, oder eine NichtCMDB -[]- Hierarchieklasse.

    Datentyp: Zeichenfolge
    items.lookup.internal_id Eindeutiger Bezeichner für diesen Suchdatensatz in dieser Nutzlast. Kann ein beliebiger Wert sein, muss jedoch innerhalb der Nutzlast eindeutig sein.

    Datentyp: Zeichenfolge
    items.lookup.sys_object_source_info Objekt, das einen eindeutigen CI-Bezeichner für eine angegebene Datenquelle beschreibt. Verschiedene Quellen können unterschiedliche Name-Wert-Paare für dasselbe CI haben.

    Datentyp: Objekt

    "sys_object_source_info": {
  "source_feed": "String",
  "source_name": "String",  
  "source_native_key": "String",
  "source_recency_timestamp": "String"
}
    items.lookup.sys_object_source_info.source_feed Name, der den Feed eindeutig identifiziert, der dieses CI sendet Verwenden Sie diese Option, wenn die Quelle mehrere Feeds haben kann.

    Datentyp: Zeichenfolge
    items.lookup.sys_object_source_info.source_name Datenquelle für die CI-Informationen. Dieser Wert muss einer der Auswahlwerte sein, die für das Feld discovery_source der Tabelle „Konfigurationselement“ [cmdb_ci] definiert sind.

    Datentyp: Zeichenfolge
    items.lookup.sys_object_source_info.source_native_key Eindeutiger Schlüssel/ID aus der Quelle für das CI. Kann eine beliebige Zeichenfolge sein, die für das Element eindeutig ist.

    Datentyp: Zeichenfolge
    items.lookup.sys_object_source_info.source_recency_timestamp UTC-Datum und Uhrzeit, zu der das CI gescannt wurde

    Datentyp: Zeichenfolge

    Format: JJJJ-MM-TT hh:mm:ss
    items.lookup.values 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 Benutzer ausgewählten Feldern ab, z. B.:

    "values": {
  "ip_address": "String",
  "mac_address": "String",
  "serial_number": "String",
  "serial_number_type": "String",
  "valid": "String"
}
    items.related 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 Art von Datensätzen in diesem Array enthalten sein kann.

    Die zugehörige Tabelle kann die Konfigurationselementtabelle [cmdb_ci] erweitern oder auch nicht. Diese Datensätze werden nicht zum Identifizieren des Konfigurationselements verwendet.

    Datentyp: Array

    "related": [
  {
    "className": "String",
    "internal_id": "String",
    "sys_object_source_info": {Object},
    "values": {Object}
  }
]
    items.related.className Erforderlich. Der sys_class_name oder Klassen-/Tabellenname des zugehörigen Elements, das erstellt oder aktualisiert werden soll.

    Datentyp: Zeichenfolge
    items.related.internal_id Eindeutiger Bezeichner für dieses zugehörige Element in dieser Nutzlast. Kann ein beliebiger Wert sein, muss jedoch innerhalb der Nutzlast eindeutig sein.

    Datentyp: Zeichenfolge
    items.related.sys_object_source_info Objekt, das einen eindeutigen CI-Bezeichner für eine angegebene Datenquelle beschreibt. Verschiedene Quellen können unterschiedliche Name-Wert-Paare für dasselbe CI haben.

    Datentyp: Objekt

    "sys_object_source_info": {
  "source_feed": "String",
  "source_name": "String",  
  "source_native_key": "String",
  "source_recency_timestamp": "String"
}
    items.related.sys_object_source_info.source_feed Name, der den Feed eindeutig identifiziert, der dieses zugehörige Element sendet. Verwenden Sie diese Option, wenn die Quelle mehrere Feeds haben kann.

    Datentyp: Zeichenfolge
    items.related.sys_object_source_info.source_name Datenquelle für die zugehörigen Elementinformationen. Dieser Wert muss einer der Auswahlwerte sein, die für das Feld discovery_source der Tabelle „Konfigurationselement“ [cmdb_ci] definiert sind.

    Datentyp: Zeichenfolge
    items.related.sys_object_source_info.source_native_key Eindeutiger Schlüssel/ID aus der Quelle für das zugehörige Element. Kann eine beliebige Zeichenfolge sein, die für das Element eindeutig ist.

    Datentyp: Zeichenfolge
    items.related.sys_object_source_info.source_recency_timestamp UTC-Datum und Uhrzeit, zu der das zugehörige Element gescannt wurde.

    Datentyp: Zeichenfolge

    Format: JJJJ-MM-TT hh:mm:ss
    items.related.values Objekt, das Felder beschreibt, die für dieses zugehörige Element erstellt oder aktualisiert werden sollen, als Name/Wert-Paare, wobei der Name der Feldname ist. Für ein Referenzfeld muss der Wert die referenzierte sys_id sein.

    Datentyp: Objekt

    Feldnamen und -typen hängen von den vom Benutzer ausgewählten Feldern ab, z. B.:

    "values": {
  "host_name": "String",
  "ip_address": "String",
  "name": "String",
  "os_name": "String",
  "sys_class_name": "String"
}
    items.settings Objekt mit Parametern, die die zulässigen Aktualisierungstypen definieren.

    Datentyp: Objekt

    "settings": {
  "skipReclassificationRestrictionRules": Boolean,
  "updateWithoutDowngrade": Boolean,
  "updateWithoutSwitch": Boolean,
  "updateWithoutUpgrade": Boolean
}
    items.settings.skipReclassificationRestrictionRules 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.
    • false: Regel wird ausgeführt.

    Standardwert: false
    items.settings.updateOhneDowngrade Gibt an, ob sowohl Aktualisierung als auch Downgrade für dieses CI zulässig sind.
    Gültige Werte:
    • true: Element aktualisieren, Downgrade ist jedoch nicht zulässig.
    • false: Sowohl Elementaktualisierung als auch Downgrade sind zulässig.

    Datentyp: Boolesch

    Standardwert: false
    items.settings.updateOhneSwitch Gibt an, ob dieses CI aktualisiert und seine Klasse geändert werden kann.
    Gültige Werte:
    • true: Element aktualisieren, Klassenwechsel ist jedoch nicht zulässig.
    • false: Sowohl Elementaktualisierungen als auch Klassenwechsel sind zulässig.

    Datentyp: Boolesch

    Standardwert: false
    items.settings.updateOhneUpgrade Gibt an, ob Update und Upgrade für dieses CI zulässig sind.
    Gültige Werte:
    • true: Element wird aktualisiert, Upgrade ist jedoch nicht zulässig.
    • false: Sowohl Elementaktualisierungen als auch Upgrades sind zulässig.

    Datentyp: Boolesch

    Standardwert: false
    items.sys_object_source_info Objekt, das einen eindeutigen CI-Bezeichner beschreibt.

    Datentyp: Objekt

    "sys_object_source_info": {
  "source_feed": "String",
  "source_name": "String",  
  "source_native_key": "String",
  "source_recency_timestamp": "String"
}
    items.sys_object_source_info.source_feed Name, der den Feed eindeutig identifiziert, der dieses CI sendet Verwenden Sie diese Option, wenn die Quelle mehrere Feeds haben kann.

    Datentyp: Zeichenfolge
    items.sys_object_source_info.source_name Datenquelle für die CI-Informationen. Dieser Wert muss einer der Auswahlwerte sein, die für das Feld discovery_source der Tabelle „Konfigurationselement“ [cmdb_ci] definiert sind.

    Datentyp: Zeichenfolge
    items.sys_object_source_info.source_native_key Eindeutiger Schlüssel/ID aus der Quelle für das CI. Kann eine beliebige Zeichenfolge sein, die für das Element eindeutig ist.

    Datentyp: Zeichenfolge
    items.sys_object_source_info.source_recency_timestamp UTC-Datum und Uhrzeit, zu der das CI gescannt wurde

    Datentyp: Zeichenfolge

    Format: JJJJ-MM-TT hh:mm:ss
    items.values 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 Benutzer ausgewählten Feldern ab, z. B.:

    "values": {
  "host_name": "String",
  "ip_address": "String",
  "name": "String",
  "os_name": "String",
  "sys_class_name": "String"
}
    Referenzelemente Array von Objekten, in dem jedes Objekt eine Referenz zwischen zwei Elementen in der Nutzlast beschreibt.

    Datentyp: Array

    "referenceItems": [
  {
    "referenced": "String",
    "referencedBy": "String",
    "referenceField": "String"
  }
]
    referenceItems.referenced Der internal_id, der für das Element definiert ist, auf das von einem anderen Element verwiesen wird.

    Datentyp: Zeichenfolge
    referenceItems.referencedBy Der internal_id, der für das Element definiert ist, das auf ein anderes Element verweist.

    Datentyp: Zeichenfolge
    referenceItems.referenceField Name des Referenzfelds in der Klasse/Tabelle für das Element referencedBy.

    Datentyp: Zeichenfolge
    relations Array von Objekten, in dem jedes Objekt eine Beziehung zwischen zwei in der Nutzlast definierten Elementen beschreibt.
    Ein Objekt in diesem Array kann eines von zwei Formaten verwenden:
    • Das Objekt kann (nur) mithilfe der Name-Wert-Paare parent und child eine Beziehung zwischen zwei Elementen der obersten Ebene definieren, wobei Werte Elementindizes aus dem Payload-Array items darstellen.
    • Das Objekt kann eine Beziehung zwischen zwei beliebigen Elementen definieren, einschließlich oberster Ebene, zugehöriger Elemente oder Suchelemente, wobei die Schlüssel/Wert-Paare parent_id und child_id verwendet werden, wobei -Werte internal_id Werte darstellen, die für diese Elemente definiert sind.

    Datentyp: Array

    "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 Ganzzahliger Index 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 Ganzzahliger Index 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 Discovery-Quelleninformationen 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.source_name Name der Discovery-Quelle

    Standard: Discovery-Quelle, die im API-Methodenparameter übergeben wird.
    beziehungen.sys_rel_source_info.source_feed Jede Zeichenfolge, die eine Untererkennung/ein Scan innerhalb der Erkennungsquelle ist.

    Standard: „UNKNOWN“ wird in der Spalte „source_feed“ gespeichert, wenn ein Datensatz in der Tabelle „sys_rel_source“ erstellt wird.
    relations.type Die Art der Beziehung zwischen den übergeordneten und untergeordneten Elementen. Dies muss ein Namensfeldwert aus der Tabelle „CI-Beziehungstyp“ [cmdb_rel_type] sein.

    Datentyp: Zeichenfolge

    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.

    Tabelle : 4. Anforderungskopfzeilen
    Kopfzeile Beschreibung
    Akzeptieren Datenformat des Antworttexts. Unterstützt nur application/json.
    Content-Type Datenformat des Anforderungstexts. Unterstützt nur application/json.
    Tabelle : 5. Antwortkopfzeilen
    Kopfzeile Beschreibung
    Keine

    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-Antwortcodesder REST-API.

    Tabelle : 6. Statuscodes
    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.

    Antworttextparameter (JSON oder XML)

    Name Beschreibung
    Ergebnis Array von Ergebnissen, die von der Abfrage erzeugt werden.

    Datentyp: Array

    "result": [
  "additionalCommittedItems": [Array],
  "additionalCommittedRelations": [Array],
  "items": [Array],
  "relations": [Array]
]
    result.additionalCommittedItems Array von Objekten, in dem jedes Objekt ein CI beschreibt, das nicht im Anforderungstext-Array items zum Einfügen oder Aktualisieren enthalten ist.

    Datentyp: Array

    "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
    result.additionalCommittedItems.errorCount Die Anzahl der Fehler, die bei der Verarbeitung dieses zusätzlichen CI aufgetreten sind.

    Datentyp: Zahl
    result.additionalCommittedItems.errors Array von Objekten, in dem jedes Objekt einen Fehler beschreibt, der bei der Verarbeitung dieses zusätzlichen CI aufgetreten ist.

    Datentyp: Array

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    result.additionalCommittedItems.errors.error Typ des Fehlers, der bei der Verarbeitung dieses zusätzlichen CI aufgetreten ist.

    Datentyp: Zeichenfolge
    result.additionalCommittedItems.errors.message Die Fehlermeldung, die bei der Verarbeitung dieses zusätzlichen CI aufgetreten ist.

    Datentyp: Zeichenfolge
    result.additionalCommittedItems.identificationAttempts Array von Objekten, in dem jedes Objekt einen Versuch beschreibt, dieses zusätzliche CI zu identifizieren.
    Datentyp: Array
    "identificationAttempts": [
  {
    "attemptResult": "String",
    "attributes": [Array],
    "hybridEntryCiAttributes": [Array],
    "identiferName": "String",
    "searchOnTable": [Array]
  }
]
    result.additionalCommittedItems.identificationAttempts.attemptResult Das Ergebnis dieses zusätzlichen CI-Identifizierungsversuchs.
    Mögliche Werte:
    • MATCHED: Identifizierung erfolgreich. In der Bezeichner-Regeltabelle wurde ein eindeutiges CI gefunden, das genau mit den angegebenen Attributen übereinstimmt.
    • MULTI_MATCH: Identifizierung mit einem Fehler fehlgeschlagen. Doppelte CIs wurden in der Bezeichner-Regeltabelle beim Abgleich mit den angegebenen Attributen gefunden.
    • NO_MATCH: Identifizierung fehlgeschlagen. In der Identifier-Regeltabelle wurde kein CI gefunden, das den angegebenen Attributen entspricht.
    • SKIPPED: Identifizierung nicht versucht. Die für die Suche in dieser Identifier-Regeltabelle erforderlichen Attribute wurden nicht angegeben, daher wurde die Regel nicht angewendet.

    Datentyp: Zeichenfolge
    result.additionalCommittedItems.identificationAttempts.attributes Array von CI-Bezeichner-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",
]
    result.additionalCommittedItems.identificationAttempts.hybridEntryCiAttributes Array von CI-Bezeichner-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.:

    "hybridEntryCiAttributes": [
  "name": "String",
  "serial_number": "String"
]
    result.additionalCommittedItems.identificationAttempts.identifierName Die für diesen zusätzlichen CI-Identifizierungsversuch verwendete Bezeichnerregel.

    Datentyp: Zeichenfolge
    result.additionalCommittedItems.identificationAttempts.searchOnTable Der Name der Tabelle, in der nach diesem zusätzlichen CI-Identifizierungsversuch gesucht wurde.

    Datentyp: Zeichenfolge
    result.additionalCommittedItems.identifierEntrySysId Die sys_id für die Bezeichnerregel, die zum Identifizieren dieses zusätzlichen CI verwendet wird.
    Bemerkenswerte Werte:
    • Unbekannt: Identifizierung dieses zusätzlichen CI fehlgeschlagen. Details siehe errors.

    Datentyp: Zeichenfolge
    result.additionalCommittedItems.inputIndices Array von Indexwerten für CIs aus dem Anforderungstext-Array items, die diesem zusätzlichen CI entsprechen.

    Datentyp: Array

    "inputIndices": [
  {
    Number
  }
]
    result.additionalCommittedItems.markers Array von Markerwerten für den internen Gebrauch.

    Datentyp: Array

    "markers": []
    result.additionalCommittedItems.mergedPayloads Array von sys_id-Werten für Teilnutzlasten aus der Tabelle „CMDB-IRE-Teilnutzlasten“ [cmdb_ire_partial_payloads], die während der Verarbeitung dieses zusätzlichen CI zusammengeführt wurden.

    Datentyp: Array

    "mergedPayloadIds": [
  "String"
]
    result.additionalCommittedItems.operation Der für dieses zusätzliche CI ausgeführte Vorgang.
    Mögliche Werte:
    • DELETE: 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 generischere Klasse (Vorgängerklasse) geändert.
    • UPDATE_WITH_SWITCH: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine andere Klasse geändert, die keine Vorgänger- oder Nachfolgeklasse ist.
    • UPDATE_WITH_UPGRADE: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine spezialisiertere Klasse (untergeordnete Klasse) geändert.

    Datentyp: Zeichenfolge
    result.additionalCommittedItems.sysId Die für dieses zusätzliche CI durch Identifizierung gefundene sys_id.
    Bemerkenswerte Werte:
    • Unbekannt: Identifizierung dieses zusätzlichen CI fehlgeschlagen. Details siehe errors.

    Datentyp: Zeichenfolge
    result.additionalCommittedItems.warnings Array von Objekten, in dem jedes Objekt eine Warnung beschreibt, die bei der Verarbeitung dieses zusätzlichen CI aufgetreten ist.

    Datentyp: Array

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    result.additionalCommittedItems.warnings.error Die Art der Warnung, die bei der Verarbeitung dieses zusätzlichen CI aufgetreten ist.

    Datentyp: Zeichenfolge
    result.additionalCommittedItems.warnings.message Die Warnmeldung, die bei der Verarbeitung dieses zusätzlichen CI aufgetreten ist.

    Datentyp: Zeichenfolge
    result.additionalCommittedRelations Array von Objekten, in dem jedes Objekt ein abhängiges Beziehungs-CI beschreibt, das nicht in der Liste des Anforderungstexts relations zum Einfügen oder Aktualisieren enthalten ist.

    Datentyp: Array

    "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.

    Datentyp: Zeichenfolge
    result.additionalCommittedRelations.errorCount Die Anzahl der Fehler, die bei der Verarbeitung dieses zusätzlichen abhängigen Beziehungs-CI aufgetreten sind.

    Datentyp: Zahl
    result.additionalCommittedRelations.errors Array von Objekten, in dem jedes Objekt einen Fehler beschreibt, der bei der Verarbeitung dieses zusätzlichen abhängigen Beziehungs-CI aufgetreten ist.

    Datentyp: Array

    "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
    result.additionalCommittedRelations.errors.message Die Fehlermeldung, die beim Verarbeiten dieses zusätzlichen abhängigen Beziehungs-CI aufgetreten ist.

    Datentyp: Zeichenfolge
    result.additionalCommittedRelations.inputIndices Array von Indexwerten für abhängige Beziehungs-CI-Objekte im Anforderungstext-Array relations, die diesem zusätzlichen abhängigen Beziehungs-CI entsprechen.

    Datentyp: Array

    "inputIndices": [
  Number
]
    result.additionalCommittedRelations.markers Array von Markerwerten für den internen Gebrauch.

    Datentyp: Array

    "markers": []
    result.additionalCommittedRelations.mergedPayloadIds Array von sys_id-Werten für Teilnutzlasten aus der Tabelle „CMDB-IRE-Teilnutzlasten“ [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 Der Vorgang, der für dieses zusätzliche abhängige Beziehungs-CI ausgeführt wird.
    Mögliche Werte:
    • EINFÜGEN: Das abhängige Beziehungs-CI wird als neuer Datensatz in die Zieltabelle eingefügt.
    • INSERT_AS_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 „CMDB-IRE-Teilnutzlasten“ [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.

    Datentyp: Zeichenfolge
    result.items Array von Objekten, in dem jedes Objekt ein CI beschreibt, das im Array des Anforderungstexts items enthalten ist.

    Datentyp: Array

    "items": [
  {
    "additionalRelatedItems": [Array],
    "className": "String",
    "duplicateLookupIndices": {Object},
    "errorCount": Number,
    "errors": [Array],
    "identificationAttempts": [Array],
    "identifierEntrySysId": "String",
    "info": [Array],
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloadIds": [Array],
    "operation": "String",
    "relatedItems": [Array],
    "relatedSysIds": [Array],
    "sysId": "String",
    "warnings": [Array]
  }
]
    result.items.additionalRelatedItems Array von Objekten, in dem jedes Objekt ein zugehöriges CI (Tabellensuch-CI) aus der Tabelle „CMDB-IRE-Teilnutzlasten“ [cmdb_ire_partial_payloads] beschreibt.

    Datentyp: Array

    "additionalRelatedItems": [
  {
    "className": "String",
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloadIds": [Array],
    "sysId": "String"
  }
]
    result.items.additionalRelatedItems.className Der sys_class_name des zugehörigen Elements.

    Datentyp: Zeichenfolge
    result.items.additionalRelatedItems.inputIndices Array von Indexwerten für CIs aus dem Anforderungstext-Array items, die diesem zugehörigen Element entsprechen.

    Datentyp: Array

    "inputIndices": [
    Number
]
    result.items.additionalRelatedItems.markers Array von Markerwerten für den internen Gebrauch.

    Datentyp: Array

    "markers": []
    result.items.additionalRelatedItems.mergedPayloadIds Array von sys_id-Werten für Teilnutzlasten aus der Tabelle „CMDB-IRE-Teilnutzlasten“ [cmdb_ire_partial_payloads], die während der Verarbeitung dieses zugehörigen Elements zusammengeführt wurden.

    Datentyp: Array

    "mergedPayloadIds": [
  "String"
]
    result.items.additionalRelatedItems.sysId Die sys_id dieses zugehörigen CI.

    Datentyp: Zeichenfolge
    result.items.className Der sys_class_name dieses CI.

    Datentyp: Zeichenfolge
    result.items.duplicateLookupIndizes Objekt, das Arrays von Indexwerten für items.lookup Array-Elemente enthält, die auf dasselbe zugehörige CI verweisen.

    Der Array-Name gibt das erste Element aus dem Anforderungstext-Array items.lookup an, das auf ein bestimmtes zugehöriges CI verweist. Seine Werte sind die Menge 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 als späteres Element aus diesem Array verweist:

    "duplicateLookupIndices": [
  "2": [Array]
]
    result.items.errorAnzahl Die Anzahl der bei der Verarbeitung dieses CI aufgetretenen Fehler.

    Datentyp: Zahl
    result.items.errors Array von Objekten, in dem jedes Objekt einen Fehler beschreibt, der bei der Verarbeitung dieses CI aufgetreten ist.

    Datentyp: Array

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    result.items.errors.error Typ des Fehlers, der bei der Verarbeitung dieses CI aufgetreten ist.

    Datentyp: Zeichenfolge
    result.items.errors.message Die Fehlermeldung, die beim Verarbeiten dieses CI aufgetreten ist.

    Datentyp: Zeichenfolge
    result.items.identificationAttempts Array von Objekten, in dem jedes Objekt einen Versuch beschreibt, dieses CI zu identifizieren.
    Datentyp: Array
    "identificationAttempts": [
  {
    "attemptResult": "String",
    "attributes": [Array],
    "hybridEntryCiAttributes": [Array],
    "identiferName": "String",
    "searchOnTable": [Array]
  }
]
    result.items.identificationAttempts.attemptResult Das Ergebnis dieses CI-Identifizierungsversuchs.
    Mögliche Werte:
    • MATCHED: Identifizierung erfolgreich. In der Bezeichner-Regeltabelle wurde ein eindeutiges CI gefunden, das genau mit den angegebenen Attributen übereinstimmt.
    • MULTI_MATCH: Identifizierung mit einem Fehler fehlgeschlagen. Doppelte CIs wurden in der Bezeichner-Regeltabelle beim Abgleich mit den angegebenen Attributen gefunden.
    • NO_MATCH: Identifizierung fehlgeschlagen. In der Identifier-Regeltabelle wurde kein CI gefunden, das den angegebenen Attributen entspricht.
    • SKIPPED: Identifizierung nicht versucht. Die für die Suche in dieser Identifier-Regeltabelle erforderlichen Attribute wurden nicht angegeben, daher wurde die Regel nicht angewendet.

    Datentyp: Zeichenfolge
    result.items.identificationAttempts.attributes Array von CI-Bezeichner-Eintragsattributen, 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 Array von CI-Bezeichner-Eintragsattributen, 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"
]
    result.items.identificationAttempts.identifierName Die für diesen CI-Identifizierungsversuch verwendete Bezeichnerregel.

    Datentyp: Zeichenfolge
    result.items.identificationAttempts.searchOnTable Der Name der Tabelle, in der nach diesem CI-Identifizierungsversuch gesucht wurde.

    Datentyp: Zeichenfolge
    result.items.identifierEntrySysId Die sys_id für die Bezeichnerregel, die zum Identifizieren dieses CI verwendet wird.
    Bemerkenswerte Werte:
    • Unbekannt: Identifizierung dieses CI fehlgeschlagen. Details siehe errors.

    Datentyp: Zeichenfolge
    result.items.info Liste der Objekte, die zusätzliche Informationen zur Verarbeitung des Elements enthalten.

    Datentyp: Array

    "info": [
  {
    "code": "String",
    "message": "String",
    "ruleSysId": "String"
  }
]
    result.items.info.code Reklassifizierungstyp, der übersprungen wurde.
    Mögliche Werte:
    • SKIPPED_CLASS_SWITCH
    • SKIPPED_CLASS_DOWNGRADE
    • SKIPPED_CLASS_UPGRADE
    result.items.info.message Nachricht, die zusätzliche Einblicke in den Grund für das Überspringen der Neuklassifizierung bietet.

    Datentyp: Zeichenfolge
    result.items.info.ruleSysId Sys_id der abgeglichenen Reklassifizierungs-Einschränkungsregel. Gilt nur, wenn IRE die Neuklassifizierung aufgrund der Regel zur Einschränkung der Neuklassifizierung überspringt. Dieser Wert ist leer, wenn die Neuklassifizierung aufgrund einer Nutzlast oder einer globalen Kennzeichnung übersprungen wird.

    Datentyp: Zeichenfolge
    result.items.inputIndices Array von Indexwerten für CIs aus dem Anforderungstext-Array items, die diesem CI entsprechen.

    Datentyp: Array

    "inputIndices": [
  {
    Number
  }
]
    result.items.markers Array von Markerwerten für den internen Gebrauch.

    Datentyp: Array

    "markers": []
    result.items.mergedPayloadIds Array von sys_id-Werten für Teilnutzlasten aus der Tabelle „CMDB-IRE-Teilnutzlasten“ [cmdb_ire_partial_payloads], die während der Verarbeitung dieses CI zusammengeführt wurden.

    Datentyp: Array

    "mergedPayloadIds": [
  "String"
]
    result.items.operation Der für dieses CI ausgeführte Vorgang.
    Mögliche Werte:
    • DELETE: 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 generischere Klasse (Vorgängerklasse) geändert.
    • UPDATE_WITH_SWITCH: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine andere Klasse geändert, die keine Vorgänger- oder Nachfolgeklasse ist.
    • UPDATE_WITH_UPGRADE: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine spezialisiertere Klasse (untergeordnete Klasse) geändert.

    Datentyp: Zeichenfolge
    result.items.relatedItems Array von Objekten, in dem jedes Objekt ein zugehöriges CI (Tabellensuch-CI) aus dem Anforderungstext-Array items.lookup beschreibt.

    Datentyp: Array

    "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 Array von Indexwerten für CIs und Suchelemente aus den Arrays items und items.lookup des Anforderungstexts, die diesem zugehörigen Element entsprechen.

    Datentyp: Array

    "inputIndices": [
  {
    "mainIndex": Number,
    "subIndex": Number
  }
]
    result.items.relatedItems.inputIndices.mainIndex Indexwert aus dem Anforderungstext-Array items, der dem übergeordneten CI des zugehörigen Elements entspricht.

    Datentyp: Zahl
    result.items.relatedItems.inputIndices.subIndex Indexwert aus dem Anforderungstext-Array items.lookup, der dem zugehörigen Element entspricht.

    Datentyp: Zahl
    result.items.relatedItems.markers Array von Markerwerten für den internen Gebrauch.

    Datentyp: Array

    "markers": []
    result.items.relatedItems.mergedPayloadIds Array von sys_id-Werten für Einträge in der Tabelle „CMDB-IRE-Teilnutzlasten“ [cmdb_ire_partial_payloads], die während der Verarbeitung mit diesem CI zusammengeführt wurden.

    Datentyp: Array

    "mergedPayloadIds": [
  "String"
]
    result.items.relatedSysIds Array von sys_id-Werten für zugehörige Elemente (Tabellensuchelemente) aus dem Anforderungstext-Array items.lookup.

    Datentyp: Array

    Bemerkenswerte Werte:
    • null: Für dieses zugehörige Element wurde keine sys_id identifiziert.
    "relatedSysIds": [
    Number,
    Number
]
    result.items.sysId Die für dieses CI durch Identifizierung gefundene sys_id.
    Bemerkenswerte Werte:
    • Unbekannt: Identifizierung dieses CI fehlgeschlagen. Details siehe errors.

    Datentyp: Zeichenfolge
    result.items.warnings Array von Objekten, in dem jedes Objekt eine Warnung beschreibt, die bei der Verarbeitung dieses CI aufgetreten ist.

    Datentyp: Array

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    result.items.warnings.error Die Art der Warnung, die bei der Verarbeitung dieses CI aufgetreten ist.

    Datentyp: Zeichenfolge
    result.items.warnings.message Die Warnmeldung, die bei der Verarbeitung dieses CI aufgetreten ist.

    Datentyp: Zeichenfolge
    result.logContextId Für diese Nutzlast gemeldete Kontext-ID.

    Datentyp: Zeichenfolge
    result.relations Array von Objekten, in dem jedes Objekt ein abhängiges Beziehungs-CI aus dem Array des Anforderungstexts relations beschreibt.

    Datentyp: Array

    "relations": [
  {
    "className": "String",
    "errorCount": Number,
    "errors": [Array],
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloadIds": [Array],
    "operation": "String",
    "warnings": [Array]
  }
]
    result.relations.className Der sys_class_name dieses abhängigen Beziehungs-CI.
    Einziger unterstützter Wert:
    • cmdb_rel_ci: Die CI-Beziehungstabelle.

    Datentyp: Zeichenfolge
    result.relations.errorAnzahl Die Anzahl der Fehler, die bei der Verarbeitung dieses abhängigen Beziehungs-CI aufgetreten sind.

    Datentyp: Zahl
    result.relations.errors Array von Objekten, in dem jedes Objekt einen Fehler beschreibt, der bei der Verarbeitung dieses abhängigen Beziehungs-CI aufgetreten ist.

    Datentyp: Array

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    result.relations.errors.error Typ des Fehlers, der bei der Verarbeitung dieses abhängigen Beziehungs-CI aufgetreten ist.

    Datentyp: Zeichenfolge
    result.relations.errors.message Die Fehlermeldung, die beim Verarbeiten dieses abhängigen Beziehungs-CI aufgetreten ist.

    Datentyp: Zeichenfolge
    result.relations.inputIndices Array von Indexwerten für die abhängigen Beziehungs-CI-Objekte im Anforderungstext-Array relations, die diesem abhängigen Beziehungs-CI entsprechen.

    Datentyp: Array

    "inputIndices": [
  Number
]
    result.relations.markers Array von Markerwerten für den internen Gebrauch.

    Datentyp: Array

    "markers": []
    result.relations.mergedPayloadIds Array von sys_id-Werten für Teilnutzlasten aus der Tabelle „CMDB-IRE-Teilnutzlasten“ [cmdb_ire_partial_payloads], die während der Verarbeitung dieses abhängigen Beziehungs-CI zusammengeführt wurden.

    Datentyp: Array

    "mergedPayloadIds": [
  "String"
]
    result.relations.operation Der Vorgang, der für dieses abhängige Beziehungs-CI ausgeführt wird.
    Mögliche Werte:
    • EINFÜGEN: Das abhängige Beziehungs-CI wurde als neuer Datensatz in die Zieltabelle eingefügt.
    • INSERT_AS_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 „CMDB-IRE-Teilnutzlasten“ [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.

    Datentyp: Zeichenfolge
    result.relations.warnings Array von Objekten, in dem jedes Objekt eine Warnung beschreibt, die bei der Verarbeitung dieses abhängigen Beziehungs-CI aufgetreten ist.

    Datentyp: Array

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    result.relations.warnings.error Die Art der Warnung, die bei der Verarbeitung dieses abhängigen Beziehungs-CI aufgetreten ist.

    Datentyp: Zeichenfolge
    result.relations.warnings.message Die Warnmeldung, die beim Verarbeiten dieses abhängigen Beziehungs-CI aufgetreten ist.

    Datentyp: Zeichenfolge

    cURL-Anforderung

    Senden Sie eine Nutzlast, die einen Linux-Server (mit Seriennummer und Netzwerkadapter-Suche nach zugehörigen Elementen) und einen IP-Switch enthält, mit einer von der IP-Verbindung abhängigen Beziehung zwischen ihnen.

    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 Hardwareregel-Suche 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 auf ähnliche Weise über eine Hardwareregel-Suche nach seinem Namen in der Hardwaretabelle identifiziert und aktualisiert ein vorhandenes CI in der IP-Switch-Tabelle [cmdb_ci_ip_switch]. Schließlich wird die von der IP-Verbindung abhängige Beziehung zwischen dem Server und dem Switch als neuer Datensatz in die Tabelle „CI-Beziehung“ [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

    Fügt Konfigurationselemente (CIs) in CMDB ein oder aktualisiert sie, indem Identifizierungs- und Abgleichsregeln auf die angegebene Nutzlast (Anforderungstext) angewendet werden. Verwenden Sie diese API, anstatt CMDB direkt zu aktualisieren.

    Verwenden Sie den Endpunkt Identifizierung und Abgleich – POST /now/identifyreconcile/queryEnhanced, um die Übermittlung einer Nutzlast an diesen Endpunkt zu simulieren, ohne Änderungen an der Datenbank vorzunehmen.

    Diese Methode ähnelt der Methode Identifizierung und Abgleich – POST /now/identifyreconcile, fügt jedoch die folgende Funktionalität hinzu:
    • Teilnutzlasten
      • Gibt bei einem Element mit einer Warnung oder einem Fehler an, ob ein Elementvorgang INSERT_AS_partial oder INSERT_INCOMPLETE ist.
      • Gibt die sys_ids von Teilnutzlasten zurück, die mit vorhandenen Teilnutzlasten zusammengeführt wurden.
    • Unterstützt die Funktion „Nutzlast-Deduplizierung“.
    • Generiert eine Zusammenfassung.

    URL-Format

    Versionierte URL: /api/now/{api_version}/identifyreconcile/enhanced

    Standard-URL: /api/now/identifyreconcile/enhanced

    Unterstützte Anforderungsparameter

    Tabelle : 7. Pfadparameter
    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 : 8. Abfrageparameter
    Name Beschreibung
    Optionen Kommagetrennte Liste von Name-Wert-Paaren, die erweiterte IRE-Optionen darstellen, die auf die Anforderung angewendet werden.

    So überschreiben Sie beispielsweise die Standardwerte für Teilnutzlasten, Teil-Commits, deduplizieren Nutzlasten und generieren eine Zusammenfassung der erweiterten IRE-Optionen:

    teilweise_nutzlasten:falsch,partial_commits:falsch,dedupliziert_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 erforderlich sind.

    Weitere Informationen zu erweiterten IRE-Optionen finden Sie unter Identification and Reconciliation Engine (IRE).

    Gültige Werte für jedes Name-Wert-Paar:
    • true: Aktivieren Sie diese Option für erweiterte IRE.
    • false: Deaktiviert diese erweiterte IRE-Option.

    Datentyp: Zeichenfolge
    sysparm_data_source Gibt die Quelle der CI-Informationen an. 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 : 9. Anforderungstextparameter (XML oder JSON)
    Name Beschreibung
    items Array von Objekten, in dem jedes Objekt ein zu erstellendes oder zu aktualisierendes CI beschreibt.

    Datentyp: Array

    "items": [
  {
    "className": "String",
    "internal_id": "String",
    "lookup": [Array],
    "related": [Array],
    "settings": {Object},
    "sys_object_source_info": {Object},
    "values": {Object}
  }
]
    items.className 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
    items.internal_id Eindeutiger Bezeichner für dieses Element in dieser Nutzlast. Kann ein beliebiger Wert sein, muss jedoch innerhalb der Nutzlast eindeutig sein.

    Datentyp: Zeichenfolge
    items.lookup Array von Objekten, in dem jedes Objekt einen Lookup-basierten Identifizierungsdatensatz beschreibt. Diese Datensätze werden verwendet, um das Konfigurationselement der obersten Ebene basierend auf einer Suchtabelle zu identifizieren, die einen Verweis auf die Tabelle „Konfigurationselement“ [cmdb_ci] enthält.

    Datentyp: Array

    "lookup": [
  {
    "className": "String",
    "internal_id": "String",
    "sys_object_source_info": {Object},
    "values": {Object}
  }
]
    items.lookup.className Erforderlich. sys_class_name oder Klassen-/Tabellenname des zu erstellenden oder zu aktualisierenden CI. Dieser Wert kann eine beliebige Klasse/Tabelle von CMDB sein, z. B. cmdb_serial_number oder cmdb_ci_network_adapter, oder eine NichtCMDB -[]- Hierarchieklasse.

    Datentyp: Zeichenfolge
    items.lookup.internal_id Eindeutiger Bezeichner für diesen Suchdatensatz in dieser Nutzlast. Kann ein beliebiger Wert sein, muss jedoch innerhalb der Nutzlast eindeutig sein.

    Datentyp: Zeichenfolge
    items.lookup.sys_object_source_info Objekt, das einen eindeutigen CI-Bezeichner für eine angegebene Datenquelle beschreibt. Verschiedene Quellen können unterschiedliche Name-Wert-Paare für dasselbe CI haben.

    Datentyp: Objekt

    "sys_object_source_info": {
  "source_feed": "String",
  "source_name": "String",  
  "source_native_key": "String",
  "source_recency_timestamp": "String"
}
    items.lookup.sys_object_source_info.source_feed Name, der den Feed eindeutig identifiziert, der dieses CI sendet Verwenden Sie diese Option, wenn die Quelle mehrere Feeds haben kann.

    Datentyp: Zeichenfolge
    items.lookup.sys_object_source_info.source_name Datenquelle für die CI-Informationen. Dieser Wert muss einer der Auswahlwerte sein, die für das Feld discovery_source der Tabelle „Konfigurationselement“ [cmdb_ci] definiert sind.

    Datentyp: Zeichenfolge
    items.lookup.sys_object_source_info.source_native_key Eindeutiger Schlüssel/ID aus der Quelle für das CI. Kann eine beliebige Zeichenfolge sein, die für das Element eindeutig ist.

    Datentyp: Zeichenfolge
    items.lookup.sys_object_source_info.source_recency_timestamp UTC-Datum und Uhrzeit, zu der das CI gescannt wurde

    Datentyp: Zeichenfolge

    Format: JJJJ-MM-TT hh:mm:ss
    items.lookup.values 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 Benutzer ausgewählten Feldern ab, z. B.:

    "values": {
  "ip_address": "String",
  "mac_address": "String",
  "serial_number": "String",
  "serial_number_type": "String",
  "valid": "String"
}
    items.related 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 Art von Datensätzen in diesem Array enthalten sein kann.

    Die zugehörige Tabelle kann die Konfigurationselementtabelle [cmdb_ci] erweitern oder auch nicht. Diese Datensätze werden nicht zum Identifizieren des Konfigurationselements verwendet.

    Datentyp: Array

    "related": [
  {
    "className": "String",
    "internal_id": "String",
    "sys_object_source_info": {Object},
    "values": {Object}
  }
]
    items.related.className Erforderlich. Der sys_class_name oder Klassen-/Tabellenname des zugehörigen Elements, das erstellt oder aktualisiert werden soll.

    Datentyp: Zeichenfolge
    items.related.internal_id Eindeutiger Bezeichner für dieses zugehörige Element in dieser Nutzlast. Kann ein beliebiger Wert sein, muss jedoch innerhalb der Nutzlast eindeutig sein.

    Datentyp: Zeichenfolge
    items.related.sys_object_source_info Objekt, das einen eindeutigen CI-Bezeichner für eine angegebene Datenquelle beschreibt. Verschiedene Quellen können unterschiedliche Name-Wert-Paare für dasselbe CI haben.

    Datentyp: Objekt

    "sys_object_source_info": {
  "source_feed": "String",
  "source_name": "String",  
  "source_native_key": "String",
  "source_recency_timestamp": "String"
}
    items.related.sys_object_source_info.source_feed Name, der den Feed eindeutig identifiziert, der dieses zugehörige Element sendet. Verwenden Sie diese Option, wenn die Quelle mehrere Feeds haben kann.

    Datentyp: Zeichenfolge
    items.related.sys_object_source_info.source_name Datenquelle für die zugehörigen Elementinformationen. Dieser Wert muss einer der Auswahlwerte sein, die für das Feld discovery_source der Tabelle „Konfigurationselement“ [cmdb_ci] definiert sind.

    Datentyp: Zeichenfolge
    items.related.sys_object_source_info.source_native_key Eindeutiger Schlüssel/ID aus der Quelle für das zugehörige Element. Kann eine beliebige Zeichenfolge sein, die für das Element eindeutig ist.

    Datentyp: Zeichenfolge
    items.related.sys_object_source_info.source_recency_timestamp UTC-Datum und Uhrzeit, zu der das zugehörige Element gescannt wurde.

    Datentyp: Zeichenfolge

    Format: JJJJ-MM-TT hh:mm:ss
    items.related.values Objekt, das Felder beschreibt, die für dieses zugehörige Element erstellt oder aktualisiert werden sollen, als Name/Wert-Paare, wobei der Name der Feldname ist. Für ein Referenzfeld muss der Wert die referenzierte sys_id sein.

    Datentyp: Objekt

    Feldnamen und -typen hängen von den vom Benutzer ausgewählten Feldern ab, z. B.:

    "values": {
  "host_name": "String",
  "ip_address": "String",
  "name": "String",
  "os_name": "String",
  "sys_class_name": "String"
}
    items.settings Objekt mit Parametern, die die zulässigen Aktualisierungstypen definieren.

    Datentyp: Objekt

    "settings": {
  "skipReclassificationRestrictionRules": Boolean,
  "updateWithoutDowngrade": Boolean,
  "updateWithoutSwitch": Boolean,
  "updateWithoutUpgrade": Boolean
}
    items.settings.skipReclassificationRestrictionRules 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.
    • false: Regel wird ausgeführt.

    Standardwert: false
    items.settings.updateOhneDowngrade Gibt an, ob sowohl Aktualisierung als auch Downgrade für dieses CI zulässig sind.
    Gültige Werte:
    • true: Element aktualisieren, Downgrade ist jedoch nicht zulässig.
    • false: Sowohl Elementaktualisierung als auch Downgrade sind zulässig.

    Datentyp: Boolesch

    Standardwert: false
    items.settings.updateOhneSwitch Gibt an, ob dieses CI aktualisiert und seine Klasse geändert werden kann.
    Gültige Werte:
    • true: Element aktualisieren, Klassenwechsel ist jedoch nicht zulässig.
    • false: Sowohl Elementaktualisierungen als auch Klassenwechsel sind zulässig.

    Datentyp: Boolesch

    Standardwert: false
    items.settings.updateOhneUpgrade Gibt an, ob Update und Upgrade für dieses CI zulässig sind.
    Gültige Werte:
    • true: Element wird aktualisiert, Upgrade ist jedoch nicht zulässig.
    • false: Sowohl Elementaktualisierungen als auch Upgrades sind zulässig.

    Datentyp: Boolesch

    Standardwert: false
    items.sys_object_source_info Objekt, das einen eindeutigen CI-Bezeichner beschreibt.

    Datentyp: Objekt

    "sys_object_source_info": {
  "source_feed": "String",
  "source_name": "String",  
  "source_native_key": "String",
  "source_recency_timestamp": "String"
}
    items.sys_object_source_info.source_feed Name, der den Feed eindeutig identifiziert, der dieses CI sendet Verwenden Sie diese Option, wenn die Quelle mehrere Feeds haben kann.

    Datentyp: Zeichenfolge
    items.sys_object_source_info.source_name Datenquelle für die CI-Informationen. Dieser Wert muss einer der Auswahlwerte sein, die für das Feld discovery_source der Tabelle „Konfigurationselement“ [cmdb_ci] definiert sind.

    Datentyp: Zeichenfolge
    items.sys_object_source_info.source_native_key Eindeutiger Schlüssel/ID aus der Quelle für das CI. Kann eine beliebige Zeichenfolge sein, die für das Element eindeutig ist.

    Datentyp: Zeichenfolge
    items.sys_object_source_info.source_recency_timestamp UTC-Datum und Uhrzeit, zu der das CI gescannt wurde

    Datentyp: Zeichenfolge

    Format: JJJJ-MM-TT hh:mm:ss
    items.values 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 Benutzer ausgewählten Feldern ab, z. B.:

    "values": {
  "host_name": "String",
  "ip_address": "String",
  "name": "String",
  "os_name": "String",
  "sys_class_name": "String"
}
    Referenzelemente Array von Objekten, in dem jedes Objekt eine Referenz zwischen zwei Elementen in der Nutzlast beschreibt.

    Datentyp: Array

    "referenceItems": [
  {
    "referenced": "String",
    "referencedBy": "String",
    "referenceField": "String"
  }
]
    referenceItems.referenced Der internal_id, der für das Element definiert ist, auf das von einem anderen Element verwiesen wird.

    Datentyp: Zeichenfolge
    referenceItems.referencedBy Der internal_id, der für das Element definiert ist, das auf ein anderes Element verweist.

    Datentyp: Zeichenfolge
    referenceItems.referenceField Name des Referenzfelds in der Klasse/Tabelle für das Element referencedBy.

    Datentyp: Zeichenfolge
    relations Array von Objekten, in dem jedes Objekt eine Beziehung zwischen zwei in der Nutzlast definierten Elementen beschreibt.
    Ein Objekt in diesem Array kann eines von zwei Formaten verwenden:
    • Das Objekt kann (nur) mithilfe der Name-Wert-Paare parent und child eine Beziehung zwischen zwei Elementen der obersten Ebene definieren, wobei Werte Elementindizes aus dem Payload-Array items darstellen.
    • Das Objekt kann eine Beziehung zwischen zwei beliebigen Elementen definieren, einschließlich oberster Ebene, zugehöriger Elemente oder Suchelemente, wobei die Schlüssel/Wert-Paare parent_id und child_id verwendet werden, wobei -Werte internal_id Werte darstellen, die für diese Elemente definiert sind.

    Datentyp: Array

    "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 Ganzzahliger Index 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 Ganzzahliger Index 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 Discovery-Quelleninformationen 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.source_name Name der Discovery-Quelle

    Standard: Discovery-Quelle, die im API-Methodenparameter übergeben wird.
    beziehungen.sys_rel_source_info.source_feed Jede Zeichenfolge, die eine Untererkennung/ein Scan innerhalb der Erkennungsquelle ist.

    Standard: „UNKNOWN“ wird in der Spalte „source_feed“ gespeichert, wenn ein Datensatz in der Tabelle „sys_rel_source“ erstellt wird.
    relations.type Die Art der Beziehung zwischen den übergeordneten und untergeordneten Elementen. Dies muss ein Namensfeldwert aus der Tabelle „CI-Beziehungstyp“ [cmdb_rel_type] sein.

    Datentyp: Zeichenfolge

    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.

    Tabelle : 10. Anforderungskopfzeilen
    Kopfzeile Beschreibung
    Akzeptieren Datenformat des Antworttexts. Unterstützt nur application/json.
    Content-Type Datenformat des Anforderungstexts. Unterstützt nur application/json.
    Tabelle : 11. Antwortkopfzeilen
    Kopfzeile Beschreibung
    Keine

    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-Antwortcodesder REST-API.

    Tabelle : 12. Statuscodes
    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.

    Fehlermeldungsdetails „Chunk … ist kein gültiger Eintrag“ gibt an, dass der Abfrageparameter options nicht das richtige Name-Wert-Paar-Format aufweist.

    Wenn Sie beispielsweise den Parameter options von teilweise angeben, wird der Statuscode 500 mit „Block [partial] ist kein gültiger Eintrag“ im Nachrichtendetail angezeigt.

    Antworttextparameter (JSON oder XML)

    Name Beschreibung
    Ergebnis Array von Ergebnissen, die von der Abfrage erzeugt werden.

    Datentyp: Array

    "result": [
  "additionalCommittedItems": [Array],
  "additionalCommittedRelations": [Array],
  "items": [Array],
  "relations": [Array]
]
    result.additionalCommittedItems Array von Objekten, in dem jedes Objekt ein CI beschreibt, das nicht im Anforderungstext-Array items zum Einfügen oder Aktualisieren enthalten ist.

    Datentyp: Array

    "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
    result.additionalCommittedItems.errorCount Die Anzahl der Fehler, die bei der Verarbeitung dieses zusätzlichen CI aufgetreten sind.

    Datentyp: Zahl
    result.additionalCommittedItems.errors Array von Objekten, in dem jedes Objekt einen Fehler beschreibt, der bei der Verarbeitung dieses zusätzlichen CI aufgetreten ist.

    Datentyp: Array

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    result.additionalCommittedItems.errors.error Typ des Fehlers, der bei der Verarbeitung dieses zusätzlichen CI aufgetreten ist.

    Datentyp: Zeichenfolge
    result.additionalCommittedItems.errors.message Die Fehlermeldung, die bei der Verarbeitung dieses zusätzlichen CI aufgetreten ist.

    Datentyp: Zeichenfolge
    result.additionalCommittedItems.identificationAttempts Array von Objekten, in dem jedes Objekt einen Versuch beschreibt, dieses zusätzliche CI zu identifizieren.
    Datentyp: Array
    "identificationAttempts": [
  {
    "attemptResult": "String",
    "attributes": [Array],
    "hybridEntryCiAttributes": [Array],
    "identiferName": "String",
    "searchOnTable": [Array]
  }
]
    result.additionalCommittedItems.identificationAttempts.attemptResult Das Ergebnis dieses zusätzlichen CI-Identifizierungsversuchs.
    Mögliche Werte:
    • MATCHED: Identifizierung erfolgreich. In der Bezeichner-Regeltabelle wurde ein eindeutiges CI gefunden, das genau mit den angegebenen Attributen übereinstimmt.
    • MULTI_MATCH: Identifizierung mit einem Fehler fehlgeschlagen. Doppelte CIs wurden in der Bezeichner-Regeltabelle beim Abgleich mit den angegebenen Attributen gefunden.
    • NO_MATCH: Identifizierung fehlgeschlagen. In der Identifier-Regeltabelle wurde kein CI gefunden, das den angegebenen Attributen entspricht.
    • SKIPPED: Identifizierung nicht versucht. Die für die Suche in dieser Identifier-Regeltabelle erforderlichen Attribute wurden nicht angegeben, daher wurde die Regel nicht angewendet.

    Datentyp: Zeichenfolge
    result.additionalCommittedItems.identificationAttempts.attributes Array von CI-Bezeichner-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",
]
    result.additionalCommittedItems.identificationAttempts.hybridEntryCiAttributes Array von CI-Bezeichner-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.:

    "hybridEntryCiAttributes": [
  "name": "String",
  "serial_number": "String"
]
    result.additionalCommittedItems.identificationAttempts.identifierName Die für diesen zusätzlichen CI-Identifizierungsversuch verwendete Bezeichnerregel.

    Datentyp: Zeichenfolge
    result.additionalCommittedItems.identificationAttempts.searchOnTable Der Name der Tabelle, in der nach diesem zusätzlichen CI-Identifizierungsversuch gesucht wurde.

    Datentyp: Zeichenfolge
    result.additionalCommittedItems.identifierEntrySysId Die sys_id für die Bezeichnerregel, die zum Identifizieren dieses zusätzlichen CI verwendet wird.
    Bemerkenswerte Werte:
    • Unbekannt: Identifizierung dieses zusätzlichen CI fehlgeschlagen. Details siehe errors.

    Datentyp: Zeichenfolge
    result.additionalCommittedItems.inputIndices Array von Indexwerten für CIs aus dem Anforderungstext-Array items, die diesem zusätzlichen CI entsprechen.

    Datentyp: Array

    "inputIndices": [
  {
    Number
  }
]
    result.additionalCommittedItems.markers Array von Markerwerten für den internen Gebrauch.

    Datentyp: Array

    "markers": []
    result.additionalCommittedItems.mergedPayloads Array von sys_id-Werten für Teilnutzlasten aus der Tabelle „CMDB-IRE-Teilnutzlasten“ [cmdb_ire_partial_payloads], die während der Verarbeitung dieses zusätzlichen CI zusammengeführt wurden.

    Datentyp: Array

    "mergedPayloadIds": [
  "String"
]
    result.additionalCommittedItems.operation Der für dieses zusätzliche CI ausgeführte Vorgang.
    Mögliche Werte:
    • DELETE: 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 generischere Klasse (Vorgängerklasse) geändert.
    • UPDATE_WITH_SWITCH: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine andere Klasse geändert, die keine Vorgänger- oder Nachfolgeklasse ist.
    • UPDATE_WITH_UPGRADE: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine spezialisiertere Klasse (untergeordnete Klasse) geändert.

    Datentyp: Zeichenfolge
    result.additionalCommittedItems.sysId Die für dieses zusätzliche CI durch Identifizierung gefundene sys_id.
    Bemerkenswerte Werte:
    • Unbekannt: Identifizierung dieses zusätzlichen CI fehlgeschlagen. Details siehe errors.

    Datentyp: Zeichenfolge
    result.additionalCommittedItems.warnings Array von Objekten, in dem jedes Objekt eine Warnung beschreibt, die bei der Verarbeitung dieses zusätzlichen CI aufgetreten ist.

    Datentyp: Array

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    result.additionalCommittedItems.warnings.error Die Art der Warnung, die bei der Verarbeitung dieses zusätzlichen CI aufgetreten ist.

    Datentyp: Zeichenfolge
    result.additionalCommittedItems.warnings.message Die Warnmeldung, die bei der Verarbeitung dieses zusätzlichen CI aufgetreten ist.

    Datentyp: Zeichenfolge
    result.additionalCommittedRelations Array von Objekten, in dem jedes Objekt ein abhängiges Beziehungs-CI beschreibt, das nicht in der Liste des Anforderungstexts relations zum Einfügen oder Aktualisieren enthalten ist.

    Datentyp: Array

    "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.

    Datentyp: Zeichenfolge
    result.additionalCommittedRelations.errorCount Die Anzahl der Fehler, die bei der Verarbeitung dieses zusätzlichen abhängigen Beziehungs-CI aufgetreten sind.

    Datentyp: Zahl
    result.additionalCommittedRelations.errors Array von Objekten, in dem jedes Objekt einen Fehler beschreibt, der bei der Verarbeitung dieses zusätzlichen abhängigen Beziehungs-CI aufgetreten ist.

    Datentyp: Array

    "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
    result.additionalCommittedRelations.errors.message Die Fehlermeldung, die beim Verarbeiten dieses zusätzlichen abhängigen Beziehungs-CI aufgetreten ist.

    Datentyp: Zeichenfolge
    result.additionalCommittedRelations.inputIndices Array von Indexwerten für abhängige Beziehungs-CI-Objekte im Anforderungstext-Array relations, die diesem zusätzlichen abhängigen Beziehungs-CI entsprechen.

    Datentyp: Array

    "inputIndices": [
  Number
]
    result.additionalCommittedRelations.markers Array von Markerwerten für den internen Gebrauch.

    Datentyp: Array

    "markers": []
    result.additionalCommittedRelations.mergedPayloadIds Array von sys_id-Werten für Teilnutzlasten aus der Tabelle „CMDB-IRE-Teilnutzlasten“ [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 Der Vorgang, der für dieses zusätzliche abhängige Beziehungs-CI ausgeführt wird.
    Mögliche Werte:
    • EINFÜGEN: Das abhängige Beziehungs-CI wird als neuer Datensatz in die Zieltabelle eingefügt.
    • INSERT_AS_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 „CMDB-IRE-Teilnutzlasten“ [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.

    Datentyp: Zeichenfolge
    result.items Array von Objekten, in dem jedes Objekt ein CI beschreibt, das im Array des Anforderungstexts items enthalten ist.

    Datentyp: Array

    "items": [
  {
    "additionalRelatedItems": [Array],
    "className": "String",
    "duplicateLookupIndices": {Object},
    "errorCount": Number,
    "errors": [Array],
    "identificationAttempts": [Array],
    "identifierEntrySysId": "String",
    "info": [Array],
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloadIds": [Array],
    "operation": "String",
    "relatedItems": [Array],
    "relatedSysIds": [Array],
    "sysId": "String",
    "warnings": [Array]
  }
]
    result.items.additionalRelatedItems Array von Objekten, in dem jedes Objekt ein zugehöriges CI (Tabellensuch-CI) aus der Tabelle „CMDB-IRE-Teilnutzlasten“ [cmdb_ire_partial_payloads] beschreibt.

    Datentyp: Array

    "additionalRelatedItems": [
  {
    "className": "String",
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloadIds": [Array],
    "sysId": "String"
  }
]
    result.items.additionalRelatedItems.className Der sys_class_name des zugehörigen Elements.

    Datentyp: Zeichenfolge
    result.items.additionalRelatedItems.inputIndices Array von Indexwerten für CIs aus dem Anforderungstext-Array items, die diesem zugehörigen Element entsprechen.

    Datentyp: Array

    "inputIndices": [
    Number
]
    result.items.additionalRelatedItems.markers Array von Markerwerten für den internen Gebrauch.

    Datentyp: Array

    "markers": []
    result.items.additionalRelatedItems.mergedPayloadIds Array von sys_id-Werten für Teilnutzlasten aus der Tabelle „CMDB-IRE-Teilnutzlasten“ [cmdb_ire_partial_payloads], die während der Verarbeitung dieses zugehörigen Elements zusammengeführt wurden.

    Datentyp: Array

    "mergedPayloadIds": [
  "String"
]
    result.items.additionalRelatedItems.sysId Die sys_id dieses zugehörigen CI.

    Datentyp: Zeichenfolge
    result.items.className Der sys_class_name dieses CI.

    Datentyp: Zeichenfolge
    result.items.duplicateLookupIndizes Objekt, das Arrays von Indexwerten für items.lookup Array-Elemente enthält, die auf dasselbe zugehörige CI verweisen.

    Der Array-Name gibt das erste Element aus dem Anforderungstext-Array items.lookup an, das auf ein bestimmtes zugehöriges CI verweist. Seine Werte sind die Menge 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 als späteres Element aus diesem Array verweist:

    "duplicateLookupIndices": [
  "2": [Array]
]
    result.items.errorAnzahl Die Anzahl der bei der Verarbeitung dieses CI aufgetretenen Fehler.

    Datentyp: Zahl
    result.items.errors Array von Objekten, in dem jedes Objekt einen Fehler beschreibt, der bei der Verarbeitung dieses CI aufgetreten ist.

    Datentyp: Array

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    result.items.errors.error Typ des Fehlers, der bei der Verarbeitung dieses CI aufgetreten ist.

    Datentyp: Zeichenfolge
    result.items.errors.message Die Fehlermeldung, die beim Verarbeiten dieses CI aufgetreten ist.

    Datentyp: Zeichenfolge
    result.items.identificationAttempts Array von Objekten, in dem jedes Objekt einen Versuch beschreibt, dieses CI zu identifizieren.
    Datentyp: Array
    "identificationAttempts": [
  {
    "attemptResult": "String",
    "attributes": [Array],
    "hybridEntryCiAttributes": [Array],
    "identiferName": "String",
    "searchOnTable": [Array]
  }
]
    result.items.identificationAttempts.attemptResult Das Ergebnis dieses CI-Identifizierungsversuchs.
    Mögliche Werte:
    • MATCHED: Identifizierung erfolgreich. In der Bezeichner-Regeltabelle wurde ein eindeutiges CI gefunden, das genau mit den angegebenen Attributen übereinstimmt.
    • MULTI_MATCH: Identifizierung mit einem Fehler fehlgeschlagen. Doppelte CIs wurden in der Bezeichner-Regeltabelle beim Abgleich mit den angegebenen Attributen gefunden.
    • NO_MATCH: Identifizierung fehlgeschlagen. In der Identifier-Regeltabelle wurde kein CI gefunden, das den angegebenen Attributen entspricht.
    • SKIPPED: Identifizierung nicht versucht. Die für die Suche in dieser Identifier-Regeltabelle erforderlichen Attribute wurden nicht angegeben, daher wurde die Regel nicht angewendet.

    Datentyp: Zeichenfolge
    result.items.identificationAttempts.attributes Array von CI-Bezeichner-Eintragsattributen, 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 Array von CI-Bezeichner-Eintragsattributen, 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"
]
    result.items.identificationAttempts.identifierName Die für diesen CI-Identifizierungsversuch verwendete Bezeichnerregel.

    Datentyp: Zeichenfolge
    result.items.identificationAttempts.searchOnTable Der Name der Tabelle, in der nach diesem CI-Identifizierungsversuch gesucht wurde.

    Datentyp: Zeichenfolge
    result.items.identifierEntrySysId Die sys_id für die Bezeichnerregel, die zum Identifizieren dieses CI verwendet wird.
    Bemerkenswerte Werte:
    • Unbekannt: Identifizierung dieses CI fehlgeschlagen. Details siehe errors.

    Datentyp: Zeichenfolge
    result.items.info Liste der Objekte, die zusätzliche Informationen zur Verarbeitung des Elements enthalten.

    Datentyp: Array

    "info": [
  {
    "code": "String",
    "message": "String",
    "ruleSysId": "String"
  }
]
    result.items.info.code Reklassifizierungstyp, der übersprungen wurde.
    Mögliche Werte:
    • SKIPPED_CLASS_SWITCH
    • SKIPPED_CLASS_DOWNGRADE
    • SKIPPED_CLASS_UPGRADE
    result.items.info.message Nachricht, die zusätzliche Einblicke in den Grund für das Überspringen der Neuklassifizierung bietet.

    Datentyp: Zeichenfolge
    result.items.info.ruleSysId Sys_id der abgeglichenen Reklassifizierungs-Einschränkungsregel. Gilt nur, wenn IRE die Neuklassifizierung aufgrund der Regel zur Einschränkung der Neuklassifizierung überspringt. Dieser Wert ist leer, wenn die Neuklassifizierung aufgrund einer Nutzlast oder einer globalen Kennzeichnung übersprungen wird.

    Datentyp: Zeichenfolge
    result.items.inputIndices Array von Indexwerten für CIs aus dem Anforderungstext-Array items, die diesem CI entsprechen.

    Datentyp: Array

    "inputIndices": [
  {
    Number
  }
]
    result.items.markers Array von Markerwerten für den internen Gebrauch.

    Datentyp: Array

    "markers": []
    result.items.mergedPayloadIds Array von sys_id-Werten für Teilnutzlasten aus der Tabelle „CMDB-IRE-Teilnutzlasten“ [cmdb_ire_partial_payloads], die während der Verarbeitung dieses CI zusammengeführt wurden.

    Datentyp: Array

    "mergedPayloadIds": [
  "String"
]
    result.items.operation Der für dieses CI ausgeführte Vorgang.
    Mögliche Werte:
    • DELETE: 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 generischere Klasse (Vorgängerklasse) geändert.
    • UPDATE_WITH_SWITCH: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine andere Klasse geändert, die keine Vorgänger- oder Nachfolgeklasse ist.
    • UPDATE_WITH_UPGRADE: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine spezialisiertere Klasse (untergeordnete Klasse) geändert.

    Datentyp: Zeichenfolge
    result.items.relatedItems Array von Objekten, in dem jedes Objekt ein zugehöriges CI (Tabellensuch-CI) aus dem Anforderungstext-Array items.lookup beschreibt.

    Datentyp: Array

    "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 Array von Indexwerten für CIs und Suchelemente aus den Arrays items und items.lookup des Anforderungstexts, die diesem zugehörigen Element entsprechen.

    Datentyp: Array

    "inputIndices": [
  {
    "mainIndex": Number,
    "subIndex": Number
  }
]
    result.items.relatedItems.inputIndices.mainIndex Indexwert aus dem Anforderungstext-Array items, der dem übergeordneten CI des zugehörigen Elements entspricht.

    Datentyp: Zahl
    result.items.relatedItems.inputIndices.subIndex Indexwert aus dem Anforderungstext-Array items.lookup, der dem zugehörigen Element entspricht.

    Datentyp: Zahl
    result.items.relatedItems.markers Array von Markerwerten für den internen Gebrauch.

    Datentyp: Array

    "markers": []
    result.items.relatedItems.mergedPayloadIds Array von sys_id-Werten für Einträge in der Tabelle „CMDB-IRE-Teilnutzlasten“ [cmdb_ire_partial_payloads], die während der Verarbeitung mit diesem CI zusammengeführt wurden.

    Datentyp: Array

    "mergedPayloadIds": [
  "String"
]
    result.items.relatedSysIds Array von sys_id-Werten für zugehörige Elemente (Tabellensuchelemente) aus dem Anforderungstext-Array items.lookup.

    Datentyp: Array

    Bemerkenswerte Werte:
    • null: Für dieses zugehörige Element wurde keine sys_id identifiziert.
    "relatedSysIds": [
    Number,
    Number
]
    result.items.sysId Die für dieses CI durch Identifizierung gefundene sys_id.
    Bemerkenswerte Werte:
    • Unbekannt: Identifizierung dieses CI fehlgeschlagen. Details siehe errors.

    Datentyp: Zeichenfolge
    result.items.warnings Array von Objekten, in dem jedes Objekt eine Warnung beschreibt, die bei der Verarbeitung dieses CI aufgetreten ist.

    Datentyp: Array

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    result.items.warnings.error Die Art der Warnung, die bei der Verarbeitung dieses CI aufgetreten ist.

    Datentyp: Zeichenfolge
    result.items.warnings.message Die Warnmeldung, die bei der Verarbeitung dieses CI aufgetreten ist.

    Datentyp: Zeichenfolge
    result.logContextId Für diese Nutzlast gemeldete Kontext-ID.

    Datentyp: Zeichenfolge
    result.relations Array von Objekten, in dem jedes Objekt ein abhängiges Beziehungs-CI aus dem Array des Anforderungstexts relations beschreibt.

    Datentyp: Array

    "relations": [
  {
    "className": "String",
    "errorCount": Number,
    "errors": [Array],
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloadIds": [Array],
    "operation": "String",
    "warnings": [Array]
  }
]
    result.relations.className Der sys_class_name dieses abhängigen Beziehungs-CI.
    Einziger unterstützter Wert:
    • cmdb_rel_ci: Die CI-Beziehungstabelle.

    Datentyp: Zeichenfolge
    result.relations.errorAnzahl Die Anzahl der Fehler, die bei der Verarbeitung dieses abhängigen Beziehungs-CI aufgetreten sind.

    Datentyp: Zahl
    result.relations.errors Array von Objekten, in dem jedes Objekt einen Fehler beschreibt, der bei der Verarbeitung dieses abhängigen Beziehungs-CI aufgetreten ist.

    Datentyp: Array

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    result.relations.errors.error Typ des Fehlers, der bei der Verarbeitung dieses abhängigen Beziehungs-CI aufgetreten ist.

    Datentyp: Zeichenfolge
    result.relations.errors.message Die Fehlermeldung, die beim Verarbeiten dieses abhängigen Beziehungs-CI aufgetreten ist.

    Datentyp: Zeichenfolge
    result.relations.inputIndices Array von Indexwerten für die abhängigen Beziehungs-CI-Objekte im Anforderungstext-Array relations, die diesem abhängigen Beziehungs-CI entsprechen.

    Datentyp: Array

    "inputIndices": [
  Number
]
    result.relations.markers Array von Markerwerten für den internen Gebrauch.

    Datentyp: Array

    "markers": []
    result.relations.mergedPayloadIds Array von sys_id-Werten für Teilnutzlasten aus der Tabelle „CMDB-IRE-Teilnutzlasten“ [cmdb_ire_partial_payloads], die während der Verarbeitung dieses abhängigen Beziehungs-CI zusammengeführt wurden.

    Datentyp: Array

    "mergedPayloadIds": [
  "String"
]
    result.relations.operation Der Vorgang, der für dieses abhängige Beziehungs-CI ausgeführt wird.
    Mögliche Werte:
    • EINFÜGEN: Das abhängige Beziehungs-CI wurde als neuer Datensatz in die Zieltabelle eingefügt.
    • INSERT_AS_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 „CMDB-IRE-Teilnutzlasten“ [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.

    Datentyp: Zeichenfolge
    result.relations.warnings Array von Objekten, in dem jedes Objekt eine Warnung beschreibt, die bei der Verarbeitung dieses abhängigen Beziehungs-CI aufgetreten ist.

    Datentyp: Array

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    result.relations.warnings.error Die Art der Warnung, die bei der Verarbeitung dieses abhängigen Beziehungs-CI aufgetreten ist.

    Datentyp: Zeichenfolge
    result.relations.warnings.message Die Warnmeldung, die beim Verarbeiten dieses abhängigen Beziehungs-CI aufgetreten ist.

    Datentyp: Zeichenfolge

    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-Teilnutzlasten“ [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, mit aktivierter Option „Erweiterte IRE für Zusammenfassungsgenerierung“.

    curl "https://instance.servicenow.com/api/now/identifyreconcile/enhanced?options=generate_summary:true" \
--request POST \
--header "Accept: application/json" \
--header "Content-Type: application/json" \
--user "username":"password" \
--data '{ \
}'

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

    {
  "result": {
    "relations": [],
    "hasError": false,
    "additionalCommittedItems": [],
    "hasWarning": false,
    "items": [
      {
        "relatedSysIds": [
          "735c79151bb45010593876a61a4bcb67"
        ],
        "identifierEntrySysId": "Unknown",
        "sysId": "ff5c79151bb45010593876a61a4bcb64",
        "errorCount": 0,
        "markers": [],
        "className": "cmdb_ci_computer",
        "inputIndices": [
          0
        ],
        "operation": "INSERT",
        "relatedItems": [
          {
            "operation": "INSERT",
            "warningCount": 0,
            "errors": [],
            "sysId": "735c79151bb45010593876a61a4bcb67",
            "className": "cmdb_ci_network_adapter",
            "errorCount": 0,
            "markers": [],
            "inputIndices": [
              {
                "subIndex": 0,
                "mainIndex": 0
              }
            ],
            "mergedPayloadIds": []
          }
        ],
        "mergedPayloadIds": [
          "fe4c39151bb45010593876a61a4bcbd3"
        ],
        "identificationAttempts": [
          {
            "info": "sys_object_source NO_MATCH",
            "attemptResult": "NO_MATCH",
            "identifierName": "",
            "attributes": [],
            "hybridEntryCiAttributes": []
          },
          {
            "attemptResult": "SKIPPED",
            "identifierName": "Hardware Rule",
            "attributes": [
              "serial_number",
              "serial_number_type"
            ],
            "hybridEntryCiAttributes": [],
            "searchOnTable": "cmdb_serial_number"
          },
          {
            "attemptResult": "SKIPPED",
            "identifierName": "Hardware Rule",
            "attributes": [
              "serial_number"
            ],
            "hybridEntryCiAttributes": [],
            "searchOnTable": "cmdb_ci_hardware"
          },
          {
            "attemptResult": "SKIPPED",
            "identifierName": "Hardware Rule",
            "attributes": [
              "name"
            ],
            "hybridEntryCiAttributes": [],
            "searchOnTable": "cmdb_ci_hardware"
          },
          {
            "attemptResult": "NO_MATCH",
            "identifierName": "Hardware Rule",
            "attributes": [
              "mac_address",
              "name"
            ],
            "hybridEntryCiAttributes": [],
            "searchOnTable": "cmdb_ci_network_adapter"
          }
        ],
        "warningCount": 0
      }
    ],
    "additionalCommittedRelations": [],
    "summary": {
      "cmdb_ci_network_adapter": {
        "mergedPartialPayloads": 0,
        "inserted": 1,
        "partial": 0,
        "warnings": 0,
        "incomplete": 0,
        "additionalInserted": 0,
        "unchanged": 0,
        "skipped": 0,
        "updated": 0,
        "errors": 0
      },
      "cmdb_ci_computer": {
        "mergedPartialPayloads": 1,
        "inserted": 1,
        "partial": 0,
        "warnings": 0,
        "incomplete": 0,
        "additionalInserted": 0,
        "unchanged": 0,
        "skipped": 0,
        "updated": 0,
        "errors": 0
      }
    }
  }
}

    Identifizierung und Abgleich – POST /now/identifyreconcile/query

    Bestimmt den Vorgang CMDB (Einfügen/Aktualisieren), der mit der angegebenen Nutzlast (Anforderungstext) ausgeführt werden soll, ohne dass die Vorgänge in der Datenbank festgeschrieben werden.

    Verwenden Sie diesen Endpunkt, um die Übermittlung einer Nutzlast (Anforderungstext) an den Endpunkt Identifizierung und Abgleich – POST /now/identifyreconcile zu simulieren.

    Verwenden Sie stattdessen den Endpunkt Identifizierung und Abgleich – POST /now/identifyreconcile/enhanced, wenn Sie erweiterte IRE-Optionen angeben müssen. Weitere Informationen zu erweiterten IRE-Optionen finden Sie unter Identification and Reconciliation Engine (IRE).

    URL-Format

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

    Standard-URL: /api/now/identifyreconcile/query

    Unterstützte Anforderungsparameter

    Tabelle : 13. Pfadparameter
    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 : 14. Abfrageparameter
    Name Beschreibung
    sysparm_data_source Gibt die Quelle der CI-Informationen an. 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 : 15. Anforderungstextparameter (XML oder JSON)
    Name Beschreibung
    items Array von Objekten, in dem jedes Objekt ein zu erstellendes oder zu aktualisierendes CI beschreibt.

    Datentyp: Array

    "items": [
  {
    "className": "String",
    "internal_id": "String",
    "lookup": [Array],
    "related": [Array],
    "settings": {Object},
    "sys_object_source_info": {Object},
    "values": {Object}
  }
]
    items.className 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
    items.internal_id Eindeutiger Bezeichner für dieses Element in dieser Nutzlast. Kann ein beliebiger Wert sein, muss jedoch innerhalb der Nutzlast eindeutig sein.

    Datentyp: Zeichenfolge
    items.lookup Array von Objekten, in dem jedes Objekt einen Lookup-basierten Identifizierungsdatensatz beschreibt. Diese Datensätze werden verwendet, um das Konfigurationselement der obersten Ebene basierend auf einer Suchtabelle zu identifizieren, die einen Verweis auf die Tabelle „Konfigurationselement“ [cmdb_ci] enthält.

    Datentyp: Array

    "lookup": [
  {
    "className": "String",
    "internal_id": "String",
    "sys_object_source_info": {Object},
    "values": {Object}
  }
]
    items.lookup.className Erforderlich. sys_class_name oder Klassen-/Tabellenname des zu erstellenden oder zu aktualisierenden CI. Dieser Wert kann eine beliebige Klasse/Tabelle von CMDB sein, z. B. cmdb_serial_number oder cmdb_ci_network_adapter, oder eine NichtCMDB -[]- Hierarchieklasse.

    Datentyp: Zeichenfolge
    items.lookup.internal_id Eindeutiger Bezeichner für diesen Suchdatensatz in dieser Nutzlast. Kann ein beliebiger Wert sein, muss jedoch innerhalb der Nutzlast eindeutig sein.

    Datentyp: Zeichenfolge
    items.lookup.sys_object_source_info Objekt, das einen eindeutigen CI-Bezeichner für eine angegebene Datenquelle beschreibt. Verschiedene Quellen können unterschiedliche Name-Wert-Paare für dasselbe CI haben.

    Datentyp: Objekt

    "sys_object_source_info": {
  "source_feed": "String",
  "source_name": "String",  
  "source_native_key": "String",
  "source_recency_timestamp": "String"
}
    items.lookup.sys_object_source_info.source_feed Name, der den Feed eindeutig identifiziert, der dieses CI sendet Verwenden Sie diese Option, wenn die Quelle mehrere Feeds haben kann.

    Datentyp: Zeichenfolge
    items.lookup.sys_object_source_info.source_name Datenquelle für die CI-Informationen. Dieser Wert muss einer der Auswahlwerte sein, die für das Feld discovery_source der Tabelle „Konfigurationselement“ [cmdb_ci] definiert sind.

    Datentyp: Zeichenfolge
    items.lookup.sys_object_source_info.source_native_key Eindeutiger Schlüssel/ID aus der Quelle für das CI. Kann eine beliebige Zeichenfolge sein, die für das Element eindeutig ist.

    Datentyp: Zeichenfolge
    items.lookup.sys_object_source_info.source_recency_timestamp UTC-Datum und Uhrzeit, zu der das CI gescannt wurde

    Datentyp: Zeichenfolge

    Format: JJJJ-MM-TT hh:mm:ss
    items.lookup.values 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 Benutzer ausgewählten Feldern ab, z. B.:

    "values": {
  "ip_address": "String",
  "mac_address": "String",
  "serial_number": "String",
  "serial_number_type": "String",
  "valid": "String"
}
    items.related 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 Art von Datensätzen in diesem Array enthalten sein kann.

    Die zugehörige Tabelle kann die Konfigurationselementtabelle [cmdb_ci] erweitern oder auch nicht. Diese Datensätze werden nicht zum Identifizieren des Konfigurationselements verwendet.

    Datentyp: Array

    "related": [
  {
    "className": "String",
    "internal_id": "String",
    "sys_object_source_info": {Object},
    "values": {Object}
  }
]
    items.related.className Erforderlich. Der sys_class_name oder Klassen-/Tabellenname des zugehörigen Elements, das erstellt oder aktualisiert werden soll.

    Datentyp: Zeichenfolge
    items.related.internal_id Eindeutiger Bezeichner für dieses zugehörige Element in dieser Nutzlast. Kann ein beliebiger Wert sein, muss jedoch innerhalb der Nutzlast eindeutig sein.

    Datentyp: Zeichenfolge
    items.related.sys_object_source_info Objekt, das einen eindeutigen CI-Bezeichner für eine angegebene Datenquelle beschreibt. Verschiedene Quellen können unterschiedliche Name-Wert-Paare für dasselbe CI haben.

    Datentyp: Objekt

    "sys_object_source_info": {
  "source_feed": "String",
  "source_name": "String",  
  "source_native_key": "String",
  "source_recency_timestamp": "String"
}
    items.related.sys_object_source_info.source_feed Name, der den Feed eindeutig identifiziert, der dieses zugehörige Element sendet. Verwenden Sie diese Option, wenn die Quelle mehrere Feeds haben kann.

    Datentyp: Zeichenfolge
    items.related.sys_object_source_info.source_name Datenquelle für die zugehörigen Elementinformationen. Dieser Wert muss einer der Auswahlwerte sein, die für das Feld discovery_source der Tabelle „Konfigurationselement“ [cmdb_ci] definiert sind.

    Datentyp: Zeichenfolge
    items.related.sys_object_source_info.source_native_key Eindeutiger Schlüssel/ID aus der Quelle für das zugehörige Element. Kann eine beliebige Zeichenfolge sein, die für das Element eindeutig ist.

    Datentyp: Zeichenfolge
    items.related.sys_object_source_info.source_recency_timestamp UTC-Datum und Uhrzeit, zu der das zugehörige Element gescannt wurde.

    Datentyp: Zeichenfolge

    Format: JJJJ-MM-TT hh:mm:ss
    items.related.values Objekt, das Felder beschreibt, die für dieses zugehörige Element erstellt oder aktualisiert werden sollen, als Name/Wert-Paare, wobei der Name der Feldname ist. Für ein Referenzfeld muss der Wert die referenzierte sys_id sein.

    Datentyp: Objekt

    Feldnamen und -typen hängen von den vom Benutzer ausgewählten Feldern ab, z. B.:

    "values": {
  "host_name": "String",
  "ip_address": "String",
  "name": "String",
  "os_name": "String",
  "sys_class_name": "String"
}
    items.settings Objekt mit Parametern, die die zulässigen Aktualisierungstypen definieren.

    Datentyp: Objekt

    "settings": {
  "skipReclassificationRestrictionRules": Boolean,
  "updateWithoutDowngrade": Boolean,
  "updateWithoutSwitch": Boolean,
  "updateWithoutUpgrade": Boolean
}
    items.settings.skipReclassificationRestrictionRules 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.
    • false: Regel wird ausgeführt.

    Standardwert: false
    items.settings.updateOhneDowngrade Gibt an, ob sowohl Aktualisierung als auch Downgrade für dieses CI zulässig sind.
    Gültige Werte:
    • true: Element aktualisieren, Downgrade ist jedoch nicht zulässig.
    • false: Sowohl Elementaktualisierung als auch Downgrade sind zulässig.

    Datentyp: Boolesch

    Standardwert: false
    items.settings.updateOhneSwitch Gibt an, ob dieses CI aktualisiert und seine Klasse geändert werden kann.
    Gültige Werte:
    • true: Element aktualisieren, Klassenwechsel ist jedoch nicht zulässig.
    • false: Sowohl Elementaktualisierungen als auch Klassenwechsel sind zulässig.

    Datentyp: Boolesch

    Standardwert: false
    items.settings.updateOhneUpgrade Gibt an, ob Update und Upgrade für dieses CI zulässig sind.
    Gültige Werte:
    • true: Element wird aktualisiert, Upgrade ist jedoch nicht zulässig.
    • false: Sowohl Elementaktualisierungen als auch Upgrades sind zulässig.

    Datentyp: Boolesch

    Standardwert: false
    items.sys_object_source_info Objekt, das einen eindeutigen CI-Bezeichner beschreibt.

    Datentyp: Objekt

    "sys_object_source_info": {
  "source_feed": "String",
  "source_name": "String",  
  "source_native_key": "String",
  "source_recency_timestamp": "String"
}
    items.sys_object_source_info.source_feed Name, der den Feed eindeutig identifiziert, der dieses CI sendet Verwenden Sie diese Option, wenn die Quelle mehrere Feeds haben kann.

    Datentyp: Zeichenfolge
    items.sys_object_source_info.source_name Datenquelle für die CI-Informationen. Dieser Wert muss einer der Auswahlwerte sein, die für das Feld discovery_source der Tabelle „Konfigurationselement“ [cmdb_ci] definiert sind.

    Datentyp: Zeichenfolge
    items.sys_object_source_info.source_native_key Eindeutiger Schlüssel/ID aus der Quelle für das CI. Kann eine beliebige Zeichenfolge sein, die für das Element eindeutig ist.

    Datentyp: Zeichenfolge
    items.sys_object_source_info.source_recency_timestamp UTC-Datum und Uhrzeit, zu der das CI gescannt wurde

    Datentyp: Zeichenfolge

    Format: JJJJ-MM-TT hh:mm:ss
    items.values 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 Benutzer ausgewählten Feldern ab, z. B.:

    "values": {
  "host_name": "String",
  "ip_address": "String",
  "name": "String",
  "os_name": "String",
  "sys_class_name": "String"
}
    Referenzelemente Array von Objekten, in dem jedes Objekt eine Referenz zwischen zwei Elementen in der Nutzlast beschreibt.

    Datentyp: Array

    "referenceItems": [
  {
    "referenced": "String",
    "referencedBy": "String",
    "referenceField": "String"
  }
]
    referenceItems.referenced Der internal_id, der für das Element definiert ist, auf das von einem anderen Element verwiesen wird.

    Datentyp: Zeichenfolge
    referenceItems.referencedBy Der internal_id, der für das Element definiert ist, das auf ein anderes Element verweist.

    Datentyp: Zeichenfolge
    referenceItems.referenceField Name des Referenzfelds in der Klasse/Tabelle für das Element referencedBy.

    Datentyp: Zeichenfolge
    relations Array von Objekten, in dem jedes Objekt eine Beziehung zwischen zwei in der Nutzlast definierten Elementen beschreibt.
    Ein Objekt in diesem Array kann eines von zwei Formaten verwenden:
    • Das Objekt kann (nur) mithilfe der Name-Wert-Paare parent und child eine Beziehung zwischen zwei Elementen der obersten Ebene definieren, wobei Werte Elementindizes aus dem Payload-Array items darstellen.
    • Das Objekt kann eine Beziehung zwischen zwei beliebigen Elementen definieren, einschließlich oberster Ebene, zugehöriger Elemente oder Suchelemente, wobei die Schlüssel/Wert-Paare parent_id und child_id verwendet werden, wobei -Werte internal_id Werte darstellen, die für diese Elemente definiert sind.

    Datentyp: Array

    "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 Ganzzahliger Index 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 Ganzzahliger Index 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 Discovery-Quelleninformationen 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.source_name Name der Discovery-Quelle

    Standard: Discovery-Quelle, die im API-Methodenparameter übergeben wird.
    beziehungen.sys_rel_source_info.source_feed Jede Zeichenfolge, die eine Untererkennung/ein Scan innerhalb der Erkennungsquelle ist.

    Standard: „UNKNOWN“ wird in der Spalte „source_feed“ gespeichert, wenn ein Datensatz in der Tabelle „sys_rel_source“ erstellt wird.
    relations.type Die Art der Beziehung zwischen den übergeordneten und untergeordneten Elementen. Dies muss ein Namensfeldwert aus der Tabelle „CI-Beziehungstyp“ [cmdb_rel_type] sein.

    Datentyp: Zeichenfolge

    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.

    Tabelle : 16. Anforderungskopfzeilen
    Kopfzeile Beschreibung
    Akzeptieren Datenformat des Antworttexts. Unterstützt nur application/json.
    Content-Type Datenformat des Anforderungstexts. Unterstützt nur application/json.
    Tabelle : 17. Antwortkopfzeilen
    Kopfzeile Beschreibung
    Keine

    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-Antwortcodesder REST-API.

    Tabelle : 18. Statuscodes
    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.

    Antworttextparameter (JSON oder XML)

    Name Beschreibung
    Ergebnis Array von Ergebnissen, die von der Abfrage erzeugt werden.

    Datentyp: Array

    "result": [
  "additionalCommittedItems": [Array],
  "additionalCommittedRelations": [Array],
  "items": [Array],
  "relations": [Array]
]
    result.additionalCommittedItems Array von Objekten, in dem jedes Objekt ein CI beschreibt, das nicht im Anforderungstext-Array items zum Einfügen oder Aktualisieren enthalten ist.

    Datentyp: Array

    "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
    result.additionalCommittedItems.errorCount Die Anzahl der Fehler, die bei der Verarbeitung dieses zusätzlichen CI aufgetreten sind.

    Datentyp: Zahl
    result.additionalCommittedItems.errors Array von Objekten, in dem jedes Objekt einen Fehler beschreibt, der bei der Verarbeitung dieses zusätzlichen CI aufgetreten ist.

    Datentyp: Array

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    result.additionalCommittedItems.errors.error Typ des Fehlers, der bei der Verarbeitung dieses zusätzlichen CI aufgetreten ist.

    Datentyp: Zeichenfolge
    result.additionalCommittedItems.errors.message Die Fehlermeldung, die bei der Verarbeitung dieses zusätzlichen CI aufgetreten ist.

    Datentyp: Zeichenfolge
    result.additionalCommittedItems.identificationAttempts Array von Objekten, in dem jedes Objekt einen Versuch beschreibt, dieses zusätzliche CI zu identifizieren.
    Datentyp: Array
    "identificationAttempts": [
  {
    "attemptResult": "String",
    "attributes": [Array],
    "hybridEntryCiAttributes": [Array],
    "identiferName": "String",
    "searchOnTable": [Array]
  }
]
    result.additionalCommittedItems.identificationAttempts.attemptResult Das Ergebnis dieses zusätzlichen CI-Identifizierungsversuchs.
    Mögliche Werte:
    • MATCHED: Identifizierung erfolgreich. In der Bezeichner-Regeltabelle wurde ein eindeutiges CI gefunden, das genau mit den angegebenen Attributen übereinstimmt.
    • MULTI_MATCH: Identifizierung mit einem Fehler fehlgeschlagen. Doppelte CIs wurden in der Bezeichner-Regeltabelle beim Abgleich mit den angegebenen Attributen gefunden.
    • NO_MATCH: Identifizierung fehlgeschlagen. In der Identifier-Regeltabelle wurde kein CI gefunden, das den angegebenen Attributen entspricht.
    • SKIPPED: Identifizierung nicht versucht. Die für die Suche in dieser Identifier-Regeltabelle erforderlichen Attribute wurden nicht angegeben, daher wurde die Regel nicht angewendet.

    Datentyp: Zeichenfolge
    result.additionalCommittedItems.identificationAttempts.attributes Array von CI-Bezeichner-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",
]
    result.additionalCommittedItems.identificationAttempts.hybridEntryCiAttributes Array von CI-Bezeichner-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.:

    "hybridEntryCiAttributes": [
  "name": "String",
  "serial_number": "String"
]
    result.additionalCommittedItems.identificationAttempts.identifierName Die für diesen zusätzlichen CI-Identifizierungsversuch verwendete Bezeichnerregel.

    Datentyp: Zeichenfolge
    result.additionalCommittedItems.identificationAttempts.searchOnTable Der Name der Tabelle, in der nach diesem zusätzlichen CI-Identifizierungsversuch gesucht wurde.

    Datentyp: Zeichenfolge
    result.additionalCommittedItems.identifierEntrySysId Die sys_id für die Bezeichnerregel, die zum Identifizieren dieses zusätzlichen CI verwendet wird.
    Bemerkenswerte Werte:
    • Unbekannt: Identifizierung dieses zusätzlichen CI fehlgeschlagen. Details siehe errors.

    Datentyp: Zeichenfolge
    result.additionalCommittedItems.inputIndices Array von Indexwerten für CIs aus dem Anforderungstext-Array items, die diesem zusätzlichen CI entsprechen.

    Datentyp: Array

    "inputIndices": [
  {
    Number
  }
]
    result.additionalCommittedItems.markers Array von Markerwerten für den internen Gebrauch.

    Datentyp: Array

    "markers": []
    result.additionalCommittedItems.mergedPayloads Array von sys_id-Werten für Teilnutzlasten aus der Tabelle „CMDB-IRE-Teilnutzlasten“ [cmdb_ire_partial_payloads], die während der Verarbeitung dieses zusätzlichen CI zusammengeführt wurden.

    Datentyp: Array

    "mergedPayloadIds": [
  "String"
]
    result.additionalCommittedItems.operation Der für dieses zusätzliche CI ausgeführte Vorgang.
    Mögliche Werte:
    • DELETE: 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 generischere Klasse (Vorgängerklasse) geändert.
    • UPDATE_WITH_SWITCH: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine andere Klasse geändert, die keine Vorgänger- oder Nachfolgeklasse ist.
    • UPDATE_WITH_UPGRADE: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine spezialisiertere Klasse (untergeordnete Klasse) geändert.

    Datentyp: Zeichenfolge
    result.additionalCommittedItems.sysId Die für dieses zusätzliche CI durch Identifizierung gefundene sys_id.
    Bemerkenswerte Werte:
    • Unbekannt: Identifizierung dieses zusätzlichen CI fehlgeschlagen. Details siehe errors.

    Datentyp: Zeichenfolge
    result.additionalCommittedItems.warnings Array von Objekten, in dem jedes Objekt eine Warnung beschreibt, die bei der Verarbeitung dieses zusätzlichen CI aufgetreten ist.

    Datentyp: Array

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    result.additionalCommittedItems.warnings.error Die Art der Warnung, die bei der Verarbeitung dieses zusätzlichen CI aufgetreten ist.

    Datentyp: Zeichenfolge
    result.additionalCommittedItems.warnings.message Die Warnmeldung, die bei der Verarbeitung dieses zusätzlichen CI aufgetreten ist.

    Datentyp: Zeichenfolge
    result.additionalCommittedRelations Array von Objekten, in dem jedes Objekt ein abhängiges Beziehungs-CI beschreibt, das nicht in der Liste des Anforderungstexts relations zum Einfügen oder Aktualisieren enthalten ist.

    Datentyp: Array

    "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.

    Datentyp: Zeichenfolge
    result.additionalCommittedRelations.errorCount Die Anzahl der Fehler, die bei der Verarbeitung dieses zusätzlichen abhängigen Beziehungs-CI aufgetreten sind.

    Datentyp: Zahl
    result.additionalCommittedRelations.errors Array von Objekten, in dem jedes Objekt einen Fehler beschreibt, der bei der Verarbeitung dieses zusätzlichen abhängigen Beziehungs-CI aufgetreten ist.

    Datentyp: Array

    "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
    result.additionalCommittedRelations.errors.message Die Fehlermeldung, die beim Verarbeiten dieses zusätzlichen abhängigen Beziehungs-CI aufgetreten ist.

    Datentyp: Zeichenfolge
    result.additionalCommittedRelations.inputIndices Array von Indexwerten für abhängige Beziehungs-CI-Objekte im Anforderungstext-Array relations, die diesem zusätzlichen abhängigen Beziehungs-CI entsprechen.

    Datentyp: Array

    "inputIndices": [
  Number
]
    result.additionalCommittedRelations.markers Array von Markerwerten für den internen Gebrauch.

    Datentyp: Array

    "markers": []
    result.additionalCommittedRelations.mergedPayloadIds Array von sys_id-Werten für Teilnutzlasten aus der Tabelle „CMDB-IRE-Teilnutzlasten“ [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 Der Vorgang, der für dieses zusätzliche abhängige Beziehungs-CI ausgeführt wird.
    Mögliche Werte:
    • EINFÜGEN: Das abhängige Beziehungs-CI wird als neuer Datensatz in die Zieltabelle eingefügt.
    • INSERT_AS_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 „CMDB-IRE-Teilnutzlasten“ [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.

    Datentyp: Zeichenfolge
    result.items Array von Objekten, in dem jedes Objekt ein CI beschreibt, das im Array des Anforderungstexts items enthalten ist.

    Datentyp: Array

    "items": [
  {
    "additionalRelatedItems": [Array],
    "className": "String",
    "duplicateLookupIndices": {Object},
    "errorCount": Number,
    "errors": [Array],
    "identificationAttempts": [Array],
    "identifierEntrySysId": "String",
    "info": [Array],
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloadIds": [Array],
    "operation": "String",
    "relatedItems": [Array],
    "relatedSysIds": [Array],
    "sysId": "String",
    "warnings": [Array]
  }
]
    result.items.additionalRelatedItems Array von Objekten, in dem jedes Objekt ein zugehöriges CI (Tabellensuch-CI) aus der Tabelle „CMDB-IRE-Teilnutzlasten“ [cmdb_ire_partial_payloads] beschreibt.

    Datentyp: Array

    "additionalRelatedItems": [
  {
    "className": "String",
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloadIds": [Array],
    "sysId": "String"
  }
]
    result.items.additionalRelatedItems.className Der sys_class_name des zugehörigen Elements.

    Datentyp: Zeichenfolge
    result.items.additionalRelatedItems.inputIndices Array von Indexwerten für CIs aus dem Anforderungstext-Array items, die diesem zugehörigen Element entsprechen.

    Datentyp: Array

    "inputIndices": [
    Number
]
    result.items.additionalRelatedItems.markers Array von Markerwerten für den internen Gebrauch.

    Datentyp: Array

    "markers": []
    result.items.additionalRelatedItems.mergedPayloadIds Array von sys_id-Werten für Teilnutzlasten aus der Tabelle „CMDB-IRE-Teilnutzlasten“ [cmdb_ire_partial_payloads], die während der Verarbeitung dieses zugehörigen Elements zusammengeführt wurden.

    Datentyp: Array

    "mergedPayloadIds": [
  "String"
]
    result.items.additionalRelatedItems.sysId Die sys_id dieses zugehörigen CI.

    Datentyp: Zeichenfolge
    result.items.className Der sys_class_name dieses CI.

    Datentyp: Zeichenfolge
    result.items.duplicateLookupIndizes Objekt, das Arrays von Indexwerten für items.lookup Array-Elemente enthält, die auf dasselbe zugehörige CI verweisen.

    Der Array-Name gibt das erste Element aus dem Anforderungstext-Array items.lookup an, das auf ein bestimmtes zugehöriges CI verweist. Seine Werte sind die Menge 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 als späteres Element aus diesem Array verweist:

    "duplicateLookupIndices": [
  "2": [Array]
]
    result.items.errorAnzahl Die Anzahl der bei der Verarbeitung dieses CI aufgetretenen Fehler.

    Datentyp: Zahl
    result.items.errors Array von Objekten, in dem jedes Objekt einen Fehler beschreibt, der bei der Verarbeitung dieses CI aufgetreten ist.

    Datentyp: Array

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    result.items.errors.error Typ des Fehlers, der bei der Verarbeitung dieses CI aufgetreten ist.

    Datentyp: Zeichenfolge
    result.items.errors.message Die Fehlermeldung, die beim Verarbeiten dieses CI aufgetreten ist.

    Datentyp: Zeichenfolge
    result.items.identificationAttempts Array von Objekten, in dem jedes Objekt einen Versuch beschreibt, dieses CI zu identifizieren.
    Datentyp: Array
    "identificationAttempts": [
  {
    "attemptResult": "String",
    "attributes": [Array],
    "hybridEntryCiAttributes": [Array],
    "identiferName": "String",
    "searchOnTable": [Array]
  }
]
    result.items.identificationAttempts.attemptResult Das Ergebnis dieses CI-Identifizierungsversuchs.
    Mögliche Werte:
    • MATCHED: Identifizierung erfolgreich. In der Bezeichner-Regeltabelle wurde ein eindeutiges CI gefunden, das genau mit den angegebenen Attributen übereinstimmt.
    • MULTI_MATCH: Identifizierung mit einem Fehler fehlgeschlagen. Doppelte CIs wurden in der Bezeichner-Regeltabelle beim Abgleich mit den angegebenen Attributen gefunden.
    • NO_MATCH: Identifizierung fehlgeschlagen. In der Identifier-Regeltabelle wurde kein CI gefunden, das den angegebenen Attributen entspricht.
    • SKIPPED: Identifizierung nicht versucht. Die für die Suche in dieser Identifier-Regeltabelle erforderlichen Attribute wurden nicht angegeben, daher wurde die Regel nicht angewendet.

    Datentyp: Zeichenfolge
    result.items.identificationAttempts.attributes Array von CI-Bezeichner-Eintragsattributen, 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 Array von CI-Bezeichner-Eintragsattributen, 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"
]
    result.items.identificationAttempts.identifierName Die für diesen CI-Identifizierungsversuch verwendete Bezeichnerregel.

    Datentyp: Zeichenfolge
    result.items.identificationAttempts.searchOnTable Der Name der Tabelle, in der nach diesem CI-Identifizierungsversuch gesucht wurde.

    Datentyp: Zeichenfolge
    result.items.identifierEntrySysId Die sys_id für die Bezeichnerregel, die zum Identifizieren dieses CI verwendet wird.
    Bemerkenswerte Werte:
    • Unbekannt: Identifizierung dieses CI fehlgeschlagen. Details siehe errors.

    Datentyp: Zeichenfolge
    result.items.info Liste der Objekte, die zusätzliche Informationen zur Verarbeitung des Elements enthalten.

    Datentyp: Array

    "info": [
  {
    "code": "String",
    "message": "String",
    "ruleSysId": "String"
  }
]
    result.items.info.code Reklassifizierungstyp, der übersprungen wurde.
    Mögliche Werte:
    • SKIPPED_CLASS_SWITCH
    • SKIPPED_CLASS_DOWNGRADE
    • SKIPPED_CLASS_UPGRADE
    result.items.info.message Nachricht, die zusätzliche Einblicke in den Grund für das Überspringen der Neuklassifizierung bietet.

    Datentyp: Zeichenfolge
    result.items.info.ruleSysId Sys_id der abgeglichenen Reklassifizierungs-Einschränkungsregel. Gilt nur, wenn IRE die Neuklassifizierung aufgrund der Regel zur Einschränkung der Neuklassifizierung überspringt. Dieser Wert ist leer, wenn die Neuklassifizierung aufgrund einer Nutzlast oder einer globalen Kennzeichnung übersprungen wird.

    Datentyp: Zeichenfolge
    result.items.inputIndices Array von Indexwerten für CIs aus dem Anforderungstext-Array items, die diesem CI entsprechen.

    Datentyp: Array

    "inputIndices": [
  {
    Number
  }
]
    result.items.markers Array von Markerwerten für den internen Gebrauch.

    Datentyp: Array

    "markers": []
    result.items.mergedPayloadIds Array von sys_id-Werten für Teilnutzlasten aus der Tabelle „CMDB-IRE-Teilnutzlasten“ [cmdb_ire_partial_payloads], die während der Verarbeitung dieses CI zusammengeführt wurden.

    Datentyp: Array

    "mergedPayloadIds": [
  "String"
]
    result.items.operation Der für dieses CI ausgeführte Vorgang.
    Mögliche Werte:
    • DELETE: 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 generischere Klasse (Vorgängerklasse) geändert.
    • UPDATE_WITH_SWITCH: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine andere Klasse geändert, die keine Vorgänger- oder Nachfolgeklasse ist.
    • UPDATE_WITH_UPGRADE: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine spezialisiertere Klasse (untergeordnete Klasse) geändert.

    Datentyp: Zeichenfolge
    result.items.relatedItems Array von Objekten, in dem jedes Objekt ein zugehöriges CI (Tabellensuch-CI) aus dem Anforderungstext-Array items.lookup beschreibt.

    Datentyp: Array

    "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 Array von Indexwerten für CIs und Suchelemente aus den Arrays items und items.lookup des Anforderungstexts, die diesem zugehörigen Element entsprechen.

    Datentyp: Array

    "inputIndices": [
  {
    "mainIndex": Number,
    "subIndex": Number
  }
]
    result.items.relatedItems.inputIndices.mainIndex Indexwert aus dem Anforderungstext-Array items, der dem übergeordneten CI des zugehörigen Elements entspricht.

    Datentyp: Zahl
    result.items.relatedItems.inputIndices.subIndex Indexwert aus dem Anforderungstext-Array items.lookup, der dem zugehörigen Element entspricht.

    Datentyp: Zahl
    result.items.relatedItems.markers Array von Markerwerten für den internen Gebrauch.

    Datentyp: Array

    "markers": []
    result.items.relatedItems.mergedPayloadIds Array von sys_id-Werten für Einträge in der Tabelle „CMDB-IRE-Teilnutzlasten“ [cmdb_ire_partial_payloads], die während der Verarbeitung mit diesem CI zusammengeführt wurden.

    Datentyp: Array

    "mergedPayloadIds": [
  "String"
]
    result.items.relatedSysIds Array von sys_id-Werten für zugehörige Elemente (Tabellensuchelemente) aus dem Anforderungstext-Array items.lookup.

    Datentyp: Array

    Bemerkenswerte Werte:
    • null: Für dieses zugehörige Element wurde keine sys_id identifiziert.
    "relatedSysIds": [
    Number,
    Number
]
    result.items.sysId Die für dieses CI durch Identifizierung gefundene sys_id.
    Bemerkenswerte Werte:
    • Unbekannt: Identifizierung dieses CI fehlgeschlagen. Details siehe errors.

    Datentyp: Zeichenfolge
    result.items.warnings Array von Objekten, in dem jedes Objekt eine Warnung beschreibt, die bei der Verarbeitung dieses CI aufgetreten ist.

    Datentyp: Array

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    result.items.warnings.error Die Art der Warnung, die bei der Verarbeitung dieses CI aufgetreten ist.

    Datentyp: Zeichenfolge
    result.items.warnings.message Die Warnmeldung, die bei der Verarbeitung dieses CI aufgetreten ist.

    Datentyp: Zeichenfolge
    result.logContextId Für diese Nutzlast gemeldete Kontext-ID.

    Datentyp: Zeichenfolge
    result.relations Array von Objekten, in dem jedes Objekt ein abhängiges Beziehungs-CI aus dem Array des Anforderungstexts relations beschreibt.

    Datentyp: Array

    "relations": [
  {
    "className": "String",
    "errorCount": Number,
    "errors": [Array],
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloadIds": [Array],
    "operation": "String",
    "warnings": [Array]
  }
]
    result.relations.className Der sys_class_name dieses abhängigen Beziehungs-CI.
    Einziger unterstützter Wert:
    • cmdb_rel_ci: Die CI-Beziehungstabelle.

    Datentyp: Zeichenfolge
    result.relations.errorAnzahl Die Anzahl der Fehler, die bei der Verarbeitung dieses abhängigen Beziehungs-CI aufgetreten sind.

    Datentyp: Zahl
    result.relations.errors Array von Objekten, in dem jedes Objekt einen Fehler beschreibt, der bei der Verarbeitung dieses abhängigen Beziehungs-CI aufgetreten ist.

    Datentyp: Array

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    result.relations.errors.error Typ des Fehlers, der bei der Verarbeitung dieses abhängigen Beziehungs-CI aufgetreten ist.

    Datentyp: Zeichenfolge
    result.relations.errors.message Die Fehlermeldung, die beim Verarbeiten dieses abhängigen Beziehungs-CI aufgetreten ist.

    Datentyp: Zeichenfolge
    result.relations.inputIndices Array von Indexwerten für die abhängigen Beziehungs-CI-Objekte im Anforderungstext-Array relations, die diesem abhängigen Beziehungs-CI entsprechen.

    Datentyp: Array

    "inputIndices": [
  Number
]
    result.relations.markers Array von Markerwerten für den internen Gebrauch.

    Datentyp: Array

    "markers": []
    result.relations.mergedPayloadIds Array von sys_id-Werten für Teilnutzlasten aus der Tabelle „CMDB-IRE-Teilnutzlasten“ [cmdb_ire_partial_payloads], die während der Verarbeitung dieses abhängigen Beziehungs-CI zusammengeführt wurden.

    Datentyp: Array

    "mergedPayloadIds": [
  "String"
]
    result.relations.operation Der Vorgang, der für dieses abhängige Beziehungs-CI ausgeführt wird.
    Mögliche Werte:
    • EINFÜGEN: Das abhängige Beziehungs-CI wurde als neuer Datensatz in die Zieltabelle eingefügt.
    • INSERT_AS_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 „CMDB-IRE-Teilnutzlasten“ [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.

    Datentyp: Zeichenfolge
    result.relations.warnings Array von Objekten, in dem jedes Objekt eine Warnung beschreibt, die bei der Verarbeitung dieses abhängigen Beziehungs-CI aufgetreten ist.

    Datentyp: Array

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    result.relations.warnings.error Die Art der Warnung, die bei der Verarbeitung dieses abhängigen Beziehungs-CI aufgetreten ist.

    Datentyp: Zeichenfolge
    result.relations.warnings.message Die Warnmeldung, die beim Verarbeiten dieses abhängigen Beziehungs-CI aufgetreten ist.

    Datentyp: Zeichenfolge

    cURL-Anforderung

    Simulieren Sie die Übermittlung einer Nutzlast, die einen Linux-Server (mit Seriennummer und Netzwerkadapter-Suche nach zugehörigen Elementen) 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 Hardwareregel-Suche 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 auf ähnliche Weise über eine Hardwareregel-Suche nach seinem Namen in der Hardwaretabelle identifiziert und aktualisiert ein vorhandenes CI in der IP-Switch-Tabelle [cmdb_ci_ip_switch]. Schließlich wird die IP-Verbindungsbeziehung zwischen dem Server und dem Switch als neuer Datensatz in die Tabelle „CI-Beziehung“ [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

    Bestimmt den Vorgang CMDB (Einfügen/Aktualisieren), der mit der angegebenen Nutzlast (Anforderungstext) ausgeführt werden soll, ohne dass die Vorgänge in der Datenbank festgeschrieben werden.

    Verwenden Sie diesen Endpunkt, um die Übermittlung einer Nutzlast (Anforderungstext) an den Endpunkt Identifizierung und Abgleich – POST /now/identifyreconcile/enhanced zu simulieren.

    Diese Methode ähnelt der Methode Identifizierung und Abgleich – POST /now/identifyreconcile/query, fügt jedoch die folgende Funktionalität hinzu:
    • Teilnutzlasten
      • Gibt bei einem Element mit einer Warnung oder einem Fehler an, ob ein Elementvorgang INSERT_AS_partial oder INSERT_INCOMPLETE ist.
      • Gibt die sys_ids von Teilnutzlasten zurück, die mit vorhandenen Teilnutzlasten zusammengeführt wurden.
    • Unterstützt die Funktion „Nutzlast-Deduplizierung“.
    • Generiert eine Zusammenfassung.

    URL-Format

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

    Standard-URL: /api/now/identifyreconcile/queryEnhanced

    Unterstützte Anforderungsparameter

    Tabelle : 19. Pfadparameter
    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 : 20. Abfrageparameter
    Name Beschreibung
    Optionen Kommagetrennte Liste von Name-Wert-Paaren, die erweiterte IRE-Optionen darstellen, die auf die Anforderung angewendet werden.

    So überschreiben Sie beispielsweise die Standardwerte für Teilnutzlasten, Teil-Commits, deduplizieren Nutzlasten und generieren eine Zusammenfassung der erweiterten IRE-Optionen:

    teilweise_nutzlasten:falsch,partial_commits:falsch,dedupliziert_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 erforderlich sind.

    Weitere Informationen zu erweiterten IRE-Optionen finden Sie unter Identification and Reconciliation Engine (IRE).

    Gültige Werte für jedes Name-Wert-Paar:
    • true: Aktivieren Sie diese Option für erweiterte IRE.
    • false: Deaktiviert diese erweiterte IRE-Option.

    Datentyp: Zeichenfolge
    sysparm_data_source Gibt die Quelle der CI-Informationen an. 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 : 21. Anforderungstextparameter (XML oder JSON)
    Name Beschreibung
    items Array von Objekten, in dem jedes Objekt ein zu erstellendes oder zu aktualisierendes CI beschreibt.

    Datentyp: Array

    "items": [
  {
    "className": "String",
    "internal_id": "String",
    "lookup": [Array],
    "related": [Array],
    "settings": {Object},
    "sys_object_source_info": {Object},
    "values": {Object}
  }
]
    items.className 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
    items.internal_id Eindeutiger Bezeichner für dieses Element in dieser Nutzlast. Kann ein beliebiger Wert sein, muss jedoch innerhalb der Nutzlast eindeutig sein.

    Datentyp: Zeichenfolge
    items.lookup Array von Objekten, in dem jedes Objekt einen Lookup-basierten Identifizierungsdatensatz beschreibt. Diese Datensätze werden verwendet, um das Konfigurationselement der obersten Ebene basierend auf einer Suchtabelle zu identifizieren, die einen Verweis auf die Tabelle „Konfigurationselement“ [cmdb_ci] enthält.

    Datentyp: Array

    "lookup": [
  {
    "className": "String",
    "internal_id": "String",
    "sys_object_source_info": {Object},
    "values": {Object}
  }
]
    items.lookup.className Erforderlich. sys_class_name oder Klassen-/Tabellenname des zu erstellenden oder zu aktualisierenden CI. Dieser Wert kann eine beliebige Klasse/Tabelle von CMDB sein, z. B. cmdb_serial_number oder cmdb_ci_network_adapter, oder eine NichtCMDB -[]- Hierarchieklasse.

    Datentyp: Zeichenfolge
    items.lookup.internal_id Eindeutiger Bezeichner für diesen Suchdatensatz in dieser Nutzlast. Kann ein beliebiger Wert sein, muss jedoch innerhalb der Nutzlast eindeutig sein.

    Datentyp: Zeichenfolge
    items.lookup.sys_object_source_info Objekt, das einen eindeutigen CI-Bezeichner für eine angegebene Datenquelle beschreibt. Verschiedene Quellen können unterschiedliche Name-Wert-Paare für dasselbe CI haben.

    Datentyp: Objekt

    "sys_object_source_info": {
  "source_feed": "String",
  "source_name": "String",  
  "source_native_key": "String",
  "source_recency_timestamp": "String"
}
    items.lookup.sys_object_source_info.source_feed Name, der den Feed eindeutig identifiziert, der dieses CI sendet Verwenden Sie diese Option, wenn die Quelle mehrere Feeds haben kann.

    Datentyp: Zeichenfolge
    items.lookup.sys_object_source_info.source_name Datenquelle für die CI-Informationen. Dieser Wert muss einer der Auswahlwerte sein, die für das Feld discovery_source der Tabelle „Konfigurationselement“ [cmdb_ci] definiert sind.

    Datentyp: Zeichenfolge
    items.lookup.sys_object_source_info.source_native_key Eindeutiger Schlüssel/ID aus der Quelle für das CI. Kann eine beliebige Zeichenfolge sein, die für das Element eindeutig ist.

    Datentyp: Zeichenfolge
    items.lookup.sys_object_source_info.source_recency_timestamp UTC-Datum und Uhrzeit, zu der das CI gescannt wurde

    Datentyp: Zeichenfolge

    Format: JJJJ-MM-TT hh:mm:ss
    items.lookup.values 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 Benutzer ausgewählten Feldern ab, z. B.:

    "values": {
  "ip_address": "String",
  "mac_address": "String",
  "serial_number": "String",
  "serial_number_type": "String",
  "valid": "String"
}
    items.related 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 Art von Datensätzen in diesem Array enthalten sein kann.

    Die zugehörige Tabelle kann die Konfigurationselementtabelle [cmdb_ci] erweitern oder auch nicht. Diese Datensätze werden nicht zum Identifizieren des Konfigurationselements verwendet.

    Datentyp: Array

    "related": [
  {
    "className": "String",
    "internal_id": "String",
    "sys_object_source_info": {Object},
    "values": {Object}
  }
]
    items.related.className Erforderlich. Der sys_class_name oder Klassen-/Tabellenname des zugehörigen Elements, das erstellt oder aktualisiert werden soll.

    Datentyp: Zeichenfolge
    items.related.internal_id Eindeutiger Bezeichner für dieses zugehörige Element in dieser Nutzlast. Kann ein beliebiger Wert sein, muss jedoch innerhalb der Nutzlast eindeutig sein.

    Datentyp: Zeichenfolge
    items.related.sys_object_source_info Objekt, das einen eindeutigen CI-Bezeichner für eine angegebene Datenquelle beschreibt. Verschiedene Quellen können unterschiedliche Name-Wert-Paare für dasselbe CI haben.

    Datentyp: Objekt

    "sys_object_source_info": {
  "source_feed": "String",
  "source_name": "String",  
  "source_native_key": "String",
  "source_recency_timestamp": "String"
}
    items.related.sys_object_source_info.source_feed Name, der den Feed eindeutig identifiziert, der dieses zugehörige Element sendet. Verwenden Sie diese Option, wenn die Quelle mehrere Feeds haben kann.

    Datentyp: Zeichenfolge
    items.related.sys_object_source_info.source_name Datenquelle für die zugehörigen Elementinformationen. Dieser Wert muss einer der Auswahlwerte sein, die für das Feld discovery_source der Tabelle „Konfigurationselement“ [cmdb_ci] definiert sind.

    Datentyp: Zeichenfolge
    items.related.sys_object_source_info.source_native_key Eindeutiger Schlüssel/ID aus der Quelle für das zugehörige Element. Kann eine beliebige Zeichenfolge sein, die für das Element eindeutig ist.

    Datentyp: Zeichenfolge
    items.related.sys_object_source_info.source_recency_timestamp UTC-Datum und Uhrzeit, zu der das zugehörige Element gescannt wurde.

    Datentyp: Zeichenfolge

    Format: JJJJ-MM-TT hh:mm:ss
    items.related.values Objekt, das Felder beschreibt, die für dieses zugehörige Element erstellt oder aktualisiert werden sollen, als Name/Wert-Paare, wobei der Name der Feldname ist. Für ein Referenzfeld muss der Wert die referenzierte sys_id sein.

    Datentyp: Objekt

    Feldnamen und -typen hängen von den vom Benutzer ausgewählten Feldern ab, z. B.:

    "values": {
  "host_name": "String",
  "ip_address": "String",
  "name": "String",
  "os_name": "String",
  "sys_class_name": "String"
}
    items.settings Objekt mit Parametern, die die zulässigen Aktualisierungstypen definieren.

    Datentyp: Objekt

    "settings": {
  "skipReclassificationRestrictionRules": Boolean,
  "updateWithoutDowngrade": Boolean,
  "updateWithoutSwitch": Boolean,
  "updateWithoutUpgrade": Boolean
}
    items.settings.skipReclassificationRestrictionRules 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.
    • false: Regel wird ausgeführt.

    Standardwert: false
    items.settings.updateOhneDowngrade Gibt an, ob sowohl Aktualisierung als auch Downgrade für dieses CI zulässig sind.
    Gültige Werte:
    • true: Element aktualisieren, Downgrade ist jedoch nicht zulässig.
    • false: Sowohl Elementaktualisierung als auch Downgrade sind zulässig.

    Datentyp: Boolesch

    Standardwert: false
    items.settings.updateOhneSwitch Gibt an, ob dieses CI aktualisiert und seine Klasse geändert werden kann.
    Gültige Werte:
    • true: Element aktualisieren, Klassenwechsel ist jedoch nicht zulässig.
    • false: Sowohl Elementaktualisierungen als auch Klassenwechsel sind zulässig.

    Datentyp: Boolesch

    Standardwert: false
    items.settings.updateOhneUpgrade Gibt an, ob Update und Upgrade für dieses CI zulässig sind.
    Gültige Werte:
    • true: Element wird aktualisiert, Upgrade ist jedoch nicht zulässig.
    • false: Sowohl Elementaktualisierungen als auch Upgrades sind zulässig.

    Datentyp: Boolesch

    Standardwert: false
    items.sys_object_source_info Objekt, das einen eindeutigen CI-Bezeichner beschreibt.

    Datentyp: Objekt

    "sys_object_source_info": {
  "source_feed": "String",
  "source_name": "String",  
  "source_native_key": "String",
  "source_recency_timestamp": "String"
}
    items.sys_object_source_info.source_feed Name, der den Feed eindeutig identifiziert, der dieses CI sendet Verwenden Sie diese Option, wenn die Quelle mehrere Feeds haben kann.

    Datentyp: Zeichenfolge
    items.sys_object_source_info.source_name Datenquelle für die CI-Informationen. Dieser Wert muss einer der Auswahlwerte sein, die für das Feld discovery_source der Tabelle „Konfigurationselement“ [cmdb_ci] definiert sind.

    Datentyp: Zeichenfolge
    items.sys_object_source_info.source_native_key Eindeutiger Schlüssel/ID aus der Quelle für das CI. Kann eine beliebige Zeichenfolge sein, die für das Element eindeutig ist.

    Datentyp: Zeichenfolge
    items.sys_object_source_info.source_recency_timestamp UTC-Datum und Uhrzeit, zu der das CI gescannt wurde

    Datentyp: Zeichenfolge

    Format: JJJJ-MM-TT hh:mm:ss
    items.values 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 Benutzer ausgewählten Feldern ab, z. B.:

    "values": {
  "host_name": "String",
  "ip_address": "String",
  "name": "String",
  "os_name": "String",
  "sys_class_name": "String"
}
    Referenzelemente Array von Objekten, in dem jedes Objekt eine Referenz zwischen zwei Elementen in der Nutzlast beschreibt.

    Datentyp: Array

    "referenceItems": [
  {
    "referenced": "String",
    "referencedBy": "String",
    "referenceField": "String"
  }
]
    referenceItems.referenced Der internal_id, der für das Element definiert ist, auf das von einem anderen Element verwiesen wird.

    Datentyp: Zeichenfolge
    referenceItems.referencedBy Der internal_id, der für das Element definiert ist, das auf ein anderes Element verweist.

    Datentyp: Zeichenfolge
    referenceItems.referenceField Name des Referenzfelds in der Klasse/Tabelle für das Element referencedBy.

    Datentyp: Zeichenfolge
    relations Array von Objekten, in dem jedes Objekt eine Beziehung zwischen zwei in der Nutzlast definierten Elementen beschreibt.
    Ein Objekt in diesem Array kann eines von zwei Formaten verwenden:
    • Das Objekt kann (nur) mithilfe der Name-Wert-Paare parent und child eine Beziehung zwischen zwei Elementen der obersten Ebene definieren, wobei Werte Elementindizes aus dem Payload-Array items darstellen.
    • Das Objekt kann eine Beziehung zwischen zwei beliebigen Elementen definieren, einschließlich oberster Ebene, zugehöriger Elemente oder Suchelemente, wobei die Schlüssel/Wert-Paare parent_id und child_id verwendet werden, wobei -Werte internal_id Werte darstellen, die für diese Elemente definiert sind.

    Datentyp: Array

    "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 Ganzzahliger Index 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 Ganzzahliger Index 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 Discovery-Quelleninformationen 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.source_name Name der Discovery-Quelle

    Standard: Discovery-Quelle, die im API-Methodenparameter übergeben wird.
    beziehungen.sys_rel_source_info.source_feed Jede Zeichenfolge, die eine Untererkennung/ein Scan innerhalb der Erkennungsquelle ist.

    Standard: „UNKNOWN“ wird in der Spalte „source_feed“ gespeichert, wenn ein Datensatz in der Tabelle „sys_rel_source“ erstellt wird.
    relations.type Die Art der Beziehung zwischen den übergeordneten und untergeordneten Elementen. Dies muss ein Namensfeldwert aus der Tabelle „CI-Beziehungstyp“ [cmdb_rel_type] sein.

    Datentyp: Zeichenfolge

    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.

    Tabelle : 22. Anforderungskopfzeilen
    Kopfzeile Beschreibung
    Akzeptieren Datenformat des Antworttexts. Unterstützt nur application/json.
    Content-Type Datenformat des Anforderungstexts. Unterstützt nur application/json.
    Tabelle : 23. Antwortkopfzeilen
    Kopfzeile Beschreibung
    Keine

    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-Antwortcodesder REST-API.

    Tabelle : 24. Statuscodes
    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.

    Fehlermeldungsdetails „Chunk … ist kein gültiger Eintrag“ gibt an, dass der Abfrageparameter options nicht das richtige Name-Wert-Paar-Format aufweist.

    Wenn Sie beispielsweise den Parameter options von teilweise angeben, wird der Statuscode 500 mit „Block [partial] ist kein gültiger Eintrag“ im Nachrichtendetail angezeigt.

    Antworttextparameter (JSON oder XML)

    Name Beschreibung
    Ergebnis Array von Ergebnissen, die von der Abfrage erzeugt werden.

    Datentyp: Array

    "result": [
  "additionalCommittedItems": [Array],
  "additionalCommittedRelations": [Array],
  "items": [Array],
  "relations": [Array]
]
    result.additionalCommittedItems Array von Objekten, in dem jedes Objekt ein CI beschreibt, das nicht im Anforderungstext-Array items zum Einfügen oder Aktualisieren enthalten ist.

    Datentyp: Array

    "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
    result.additionalCommittedItems.errorCount Die Anzahl der Fehler, die bei der Verarbeitung dieses zusätzlichen CI aufgetreten sind.

    Datentyp: Zahl
    result.additionalCommittedItems.errors Array von Objekten, in dem jedes Objekt einen Fehler beschreibt, der bei der Verarbeitung dieses zusätzlichen CI aufgetreten ist.

    Datentyp: Array

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    result.additionalCommittedItems.errors.error Typ des Fehlers, der bei der Verarbeitung dieses zusätzlichen CI aufgetreten ist.

    Datentyp: Zeichenfolge
    result.additionalCommittedItems.errors.message Die Fehlermeldung, die bei der Verarbeitung dieses zusätzlichen CI aufgetreten ist.

    Datentyp: Zeichenfolge
    result.additionalCommittedItems.identificationAttempts Array von Objekten, in dem jedes Objekt einen Versuch beschreibt, dieses zusätzliche CI zu identifizieren.
    Datentyp: Array
    "identificationAttempts": [
  {
    "attemptResult": "String",
    "attributes": [Array],
    "hybridEntryCiAttributes": [Array],
    "identiferName": "String",
    "searchOnTable": [Array]
  }
]
    result.additionalCommittedItems.identificationAttempts.attemptResult Das Ergebnis dieses zusätzlichen CI-Identifizierungsversuchs.
    Mögliche Werte:
    • MATCHED: Identifizierung erfolgreich. In der Bezeichner-Regeltabelle wurde ein eindeutiges CI gefunden, das genau mit den angegebenen Attributen übereinstimmt.
    • MULTI_MATCH: Identifizierung mit einem Fehler fehlgeschlagen. Doppelte CIs wurden in der Bezeichner-Regeltabelle beim Abgleich mit den angegebenen Attributen gefunden.
    • NO_MATCH: Identifizierung fehlgeschlagen. In der Identifier-Regeltabelle wurde kein CI gefunden, das den angegebenen Attributen entspricht.
    • SKIPPED: Identifizierung nicht versucht. Die für die Suche in dieser Identifier-Regeltabelle erforderlichen Attribute wurden nicht angegeben, daher wurde die Regel nicht angewendet.

    Datentyp: Zeichenfolge
    result.additionalCommittedItems.identificationAttempts.attributes Array von CI-Bezeichner-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",
]
    result.additionalCommittedItems.identificationAttempts.hybridEntryCiAttributes Array von CI-Bezeichner-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.:

    "hybridEntryCiAttributes": [
  "name": "String",
  "serial_number": "String"
]
    result.additionalCommittedItems.identificationAttempts.identifierName Die für diesen zusätzlichen CI-Identifizierungsversuch verwendete Bezeichnerregel.

    Datentyp: Zeichenfolge
    result.additionalCommittedItems.identificationAttempts.searchOnTable Der Name der Tabelle, in der nach diesem zusätzlichen CI-Identifizierungsversuch gesucht wurde.

    Datentyp: Zeichenfolge
    result.additionalCommittedItems.identifierEntrySysId Die sys_id für die Bezeichnerregel, die zum Identifizieren dieses zusätzlichen CI verwendet wird.
    Bemerkenswerte Werte:
    • Unbekannt: Identifizierung dieses zusätzlichen CI fehlgeschlagen. Details siehe errors.

    Datentyp: Zeichenfolge
    result.additionalCommittedItems.inputIndices Array von Indexwerten für CIs aus dem Anforderungstext-Array items, die diesem zusätzlichen CI entsprechen.

    Datentyp: Array

    "inputIndices": [
  {
    Number
  }
]
    result.additionalCommittedItems.markers Array von Markerwerten für den internen Gebrauch.

    Datentyp: Array

    "markers": []
    result.additionalCommittedItems.mergedPayloads Array von sys_id-Werten für Teilnutzlasten aus der Tabelle „CMDB-IRE-Teilnutzlasten“ [cmdb_ire_partial_payloads], die während der Verarbeitung dieses zusätzlichen CI zusammengeführt wurden.

    Datentyp: Array

    "mergedPayloadIds": [
  "String"
]
    result.additionalCommittedItems.operation Der für dieses zusätzliche CI ausgeführte Vorgang.
    Mögliche Werte:
    • DELETE: 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 generischere Klasse (Vorgängerklasse) geändert.
    • UPDATE_WITH_SWITCH: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine andere Klasse geändert, die keine Vorgänger- oder Nachfolgeklasse ist.
    • UPDATE_WITH_UPGRADE: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine spezialisiertere Klasse (untergeordnete Klasse) geändert.

    Datentyp: Zeichenfolge
    result.additionalCommittedItems.sysId Die für dieses zusätzliche CI durch Identifizierung gefundene sys_id.
    Bemerkenswerte Werte:
    • Unbekannt: Identifizierung dieses zusätzlichen CI fehlgeschlagen. Details siehe errors.

    Datentyp: Zeichenfolge
    result.additionalCommittedItems.warnings Array von Objekten, in dem jedes Objekt eine Warnung beschreibt, die bei der Verarbeitung dieses zusätzlichen CI aufgetreten ist.

    Datentyp: Array

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    result.additionalCommittedItems.warnings.error Die Art der Warnung, die bei der Verarbeitung dieses zusätzlichen CI aufgetreten ist.

    Datentyp: Zeichenfolge
    result.additionalCommittedItems.warnings.message Die Warnmeldung, die bei der Verarbeitung dieses zusätzlichen CI aufgetreten ist.

    Datentyp: Zeichenfolge
    result.additionalCommittedRelations Array von Objekten, in dem jedes Objekt ein abhängiges Beziehungs-CI beschreibt, das nicht in der Liste des Anforderungstexts relations zum Einfügen oder Aktualisieren enthalten ist.

    Datentyp: Array

    "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.

    Datentyp: Zeichenfolge
    result.additionalCommittedRelations.errorCount Die Anzahl der Fehler, die bei der Verarbeitung dieses zusätzlichen abhängigen Beziehungs-CI aufgetreten sind.

    Datentyp: Zahl
    result.additionalCommittedRelations.errors Array von Objekten, in dem jedes Objekt einen Fehler beschreibt, der bei der Verarbeitung dieses zusätzlichen abhängigen Beziehungs-CI aufgetreten ist.

    Datentyp: Array

    "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
    result.additionalCommittedRelations.errors.message Die Fehlermeldung, die beim Verarbeiten dieses zusätzlichen abhängigen Beziehungs-CI aufgetreten ist.

    Datentyp: Zeichenfolge
    result.additionalCommittedRelations.inputIndices Array von Indexwerten für abhängige Beziehungs-CI-Objekte im Anforderungstext-Array relations, die diesem zusätzlichen abhängigen Beziehungs-CI entsprechen.

    Datentyp: Array

    "inputIndices": [
  Number
]
    result.additionalCommittedRelations.markers Array von Markerwerten für den internen Gebrauch.

    Datentyp: Array

    "markers": []
    result.additionalCommittedRelations.mergedPayloadIds Array von sys_id-Werten für Teilnutzlasten aus der Tabelle „CMDB-IRE-Teilnutzlasten“ [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 Der Vorgang, der für dieses zusätzliche abhängige Beziehungs-CI ausgeführt wird.
    Mögliche Werte:
    • EINFÜGEN: Das abhängige Beziehungs-CI wird als neuer Datensatz in die Zieltabelle eingefügt.
    • INSERT_AS_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 „CMDB-IRE-Teilnutzlasten“ [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.

    Datentyp: Zeichenfolge
    result.items Array von Objekten, in dem jedes Objekt ein CI beschreibt, das im Array des Anforderungstexts items enthalten ist.

    Datentyp: Array

    "items": [
  {
    "additionalRelatedItems": [Array],
    "className": "String",
    "duplicateLookupIndices": {Object},
    "errorCount": Number,
    "errors": [Array],
    "identificationAttempts": [Array],
    "identifierEntrySysId": "String",
    "info": [Array],
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloadIds": [Array],
    "operation": "String",
    "relatedItems": [Array],
    "relatedSysIds": [Array],
    "sysId": "String",
    "warnings": [Array]
  }
]
    result.items.additionalRelatedItems Array von Objekten, in dem jedes Objekt ein zugehöriges CI (Tabellensuch-CI) aus der Tabelle „CMDB-IRE-Teilnutzlasten“ [cmdb_ire_partial_payloads] beschreibt.

    Datentyp: Array

    "additionalRelatedItems": [
  {
    "className": "String",
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloadIds": [Array],
    "sysId": "String"
  }
]
    result.items.additionalRelatedItems.className Der sys_class_name des zugehörigen Elements.

    Datentyp: Zeichenfolge
    result.items.additionalRelatedItems.inputIndices Array von Indexwerten für CIs aus dem Anforderungstext-Array items, die diesem zugehörigen Element entsprechen.

    Datentyp: Array

    "inputIndices": [
    Number
]
    result.items.additionalRelatedItems.markers Array von Markerwerten für den internen Gebrauch.

    Datentyp: Array

    "markers": []
    result.items.additionalRelatedItems.mergedPayloadIds Array von sys_id-Werten für Teilnutzlasten aus der Tabelle „CMDB-IRE-Teilnutzlasten“ [cmdb_ire_partial_payloads], die während der Verarbeitung dieses zugehörigen Elements zusammengeführt wurden.

    Datentyp: Array

    "mergedPayloadIds": [
  "String"
]
    result.items.additionalRelatedItems.sysId Die sys_id dieses zugehörigen CI.

    Datentyp: Zeichenfolge
    result.items.className Der sys_class_name dieses CI.

    Datentyp: Zeichenfolge
    result.items.duplicateLookupIndizes Objekt, das Arrays von Indexwerten für items.lookup Array-Elemente enthält, die auf dasselbe zugehörige CI verweisen.

    Der Array-Name gibt das erste Element aus dem Anforderungstext-Array items.lookup an, das auf ein bestimmtes zugehöriges CI verweist. Seine Werte sind die Menge 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 als späteres Element aus diesem Array verweist:

    "duplicateLookupIndices": [
  "2": [Array]
]
    result.items.errorAnzahl Die Anzahl der bei der Verarbeitung dieses CI aufgetretenen Fehler.

    Datentyp: Zahl
    result.items.errors Array von Objekten, in dem jedes Objekt einen Fehler beschreibt, der bei der Verarbeitung dieses CI aufgetreten ist.

    Datentyp: Array

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    result.items.errors.error Typ des Fehlers, der bei der Verarbeitung dieses CI aufgetreten ist.

    Datentyp: Zeichenfolge
    result.items.errors.message Die Fehlermeldung, die beim Verarbeiten dieses CI aufgetreten ist.

    Datentyp: Zeichenfolge
    result.items.identificationAttempts Array von Objekten, in dem jedes Objekt einen Versuch beschreibt, dieses CI zu identifizieren.
    Datentyp: Array
    "identificationAttempts": [
  {
    "attemptResult": "String",
    "attributes": [Array],
    "hybridEntryCiAttributes": [Array],
    "identiferName": "String",
    "searchOnTable": [Array]
  }
]
    result.items.identificationAttempts.attemptResult Das Ergebnis dieses CI-Identifizierungsversuchs.
    Mögliche Werte:
    • MATCHED: Identifizierung erfolgreich. In der Bezeichner-Regeltabelle wurde ein eindeutiges CI gefunden, das genau mit den angegebenen Attributen übereinstimmt.
    • MULTI_MATCH: Identifizierung mit einem Fehler fehlgeschlagen. Doppelte CIs wurden in der Bezeichner-Regeltabelle beim Abgleich mit den angegebenen Attributen gefunden.
    • NO_MATCH: Identifizierung fehlgeschlagen. In der Identifier-Regeltabelle wurde kein CI gefunden, das den angegebenen Attributen entspricht.
    • SKIPPED: Identifizierung nicht versucht. Die für die Suche in dieser Identifier-Regeltabelle erforderlichen Attribute wurden nicht angegeben, daher wurde die Regel nicht angewendet.

    Datentyp: Zeichenfolge
    result.items.identificationAttempts.attributes Array von CI-Bezeichner-Eintragsattributen, 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 Array von CI-Bezeichner-Eintragsattributen, 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"
]
    result.items.identificationAttempts.identifierName Die für diesen CI-Identifizierungsversuch verwendete Bezeichnerregel.

    Datentyp: Zeichenfolge
    result.items.identificationAttempts.searchOnTable Der Name der Tabelle, in der nach diesem CI-Identifizierungsversuch gesucht wurde.

    Datentyp: Zeichenfolge
    result.items.identifierEntrySysId Die sys_id für die Bezeichnerregel, die zum Identifizieren dieses CI verwendet wird.
    Bemerkenswerte Werte:
    • Unbekannt: Identifizierung dieses CI fehlgeschlagen. Details siehe errors.

    Datentyp: Zeichenfolge
    result.items.info Liste der Objekte, die zusätzliche Informationen zur Verarbeitung des Elements enthalten.

    Datentyp: Array

    "info": [
  {
    "code": "String",
    "message": "String",
    "ruleSysId": "String"
  }
]
    result.items.info.code Reklassifizierungstyp, der übersprungen wurde.
    Mögliche Werte:
    • SKIPPED_CLASS_SWITCH
    • SKIPPED_CLASS_DOWNGRADE
    • SKIPPED_CLASS_UPGRADE
    result.items.info.message Nachricht, die zusätzliche Einblicke in den Grund für das Überspringen der Neuklassifizierung bietet.

    Datentyp: Zeichenfolge
    result.items.info.ruleSysId Sys_id der abgeglichenen Reklassifizierungs-Einschränkungsregel. Gilt nur, wenn IRE die Neuklassifizierung aufgrund der Regel zur Einschränkung der Neuklassifizierung überspringt. Dieser Wert ist leer, wenn die Neuklassifizierung aufgrund einer Nutzlast oder einer globalen Kennzeichnung übersprungen wird.

    Datentyp: Zeichenfolge
    result.items.inputIndices Array von Indexwerten für CIs aus dem Anforderungstext-Array items, die diesem CI entsprechen.

    Datentyp: Array

    "inputIndices": [
  {
    Number
  }
]
    result.items.markers Array von Markerwerten für den internen Gebrauch.

    Datentyp: Array

    "markers": []
    result.items.mergedPayloadIds Array von sys_id-Werten für Teilnutzlasten aus der Tabelle „CMDB-IRE-Teilnutzlasten“ [cmdb_ire_partial_payloads], die während der Verarbeitung dieses CI zusammengeführt wurden.

    Datentyp: Array

    "mergedPayloadIds": [
  "String"
]
    result.items.operation Der für dieses CI ausgeführte Vorgang.
    Mögliche Werte:
    • DELETE: 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 generischere Klasse (Vorgängerklasse) geändert.
    • UPDATE_WITH_SWITCH: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine andere Klasse geändert, die keine Vorgänger- oder Nachfolgeklasse ist.
    • UPDATE_WITH_UPGRADE: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine spezialisiertere Klasse (untergeordnete Klasse) geändert.

    Datentyp: Zeichenfolge
    result.items.relatedItems Array von Objekten, in dem jedes Objekt ein zugehöriges CI (Tabellensuch-CI) aus dem Anforderungstext-Array items.lookup beschreibt.

    Datentyp: Array

    "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 Array von Indexwerten für CIs und Suchelemente aus den Arrays items und items.lookup des Anforderungstexts, die diesem zugehörigen Element entsprechen.

    Datentyp: Array

    "inputIndices": [
  {
    "mainIndex": Number,
    "subIndex": Number
  }
]
    result.items.relatedItems.inputIndices.mainIndex Indexwert aus dem Anforderungstext-Array items, der dem übergeordneten CI des zugehörigen Elements entspricht.

    Datentyp: Zahl
    result.items.relatedItems.inputIndices.subIndex Indexwert aus dem Anforderungstext-Array items.lookup, der dem zugehörigen Element entspricht.

    Datentyp: Zahl
    result.items.relatedItems.markers Array von Markerwerten für den internen Gebrauch.

    Datentyp: Array

    "markers": []
    result.items.relatedItems.mergedPayloadIds Array von sys_id-Werten für Einträge in der Tabelle „CMDB-IRE-Teilnutzlasten“ [cmdb_ire_partial_payloads], die während der Verarbeitung mit diesem CI zusammengeführt wurden.

    Datentyp: Array

    "mergedPayloadIds": [
  "String"
]
    result.items.relatedSysIds Array von sys_id-Werten für zugehörige Elemente (Tabellensuchelemente) aus dem Anforderungstext-Array items.lookup.

    Datentyp: Array

    Bemerkenswerte Werte:
    • null: Für dieses zugehörige Element wurde keine sys_id identifiziert.
    "relatedSysIds": [
    Number,
    Number
]
    result.items.sysId Die für dieses CI durch Identifizierung gefundene sys_id.
    Bemerkenswerte Werte:
    • Unbekannt: Identifizierung dieses CI fehlgeschlagen. Details siehe errors.

    Datentyp: Zeichenfolge
    result.items.warnings Array von Objekten, in dem jedes Objekt eine Warnung beschreibt, die bei der Verarbeitung dieses CI aufgetreten ist.

    Datentyp: Array

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    result.items.warnings.error Die Art der Warnung, die bei der Verarbeitung dieses CI aufgetreten ist.

    Datentyp: Zeichenfolge
    result.items.warnings.message Die Warnmeldung, die bei der Verarbeitung dieses CI aufgetreten ist.

    Datentyp: Zeichenfolge
    result.logContextId Für diese Nutzlast gemeldete Kontext-ID.

    Datentyp: Zeichenfolge
    result.relations Array von Objekten, in dem jedes Objekt ein abhängiges Beziehungs-CI aus dem Array des Anforderungstexts relations beschreibt.

    Datentyp: Array

    "relations": [
  {
    "className": "String",
    "errorCount": Number,
    "errors": [Array],
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloadIds": [Array],
    "operation": "String",
    "warnings": [Array]
  }
]
    result.relations.className Der sys_class_name dieses abhängigen Beziehungs-CI.
    Einziger unterstützter Wert:
    • cmdb_rel_ci: Die CI-Beziehungstabelle.

    Datentyp: Zeichenfolge
    result.relations.errorAnzahl Die Anzahl der Fehler, die bei der Verarbeitung dieses abhängigen Beziehungs-CI aufgetreten sind.

    Datentyp: Zahl
    result.relations.errors Array von Objekten, in dem jedes Objekt einen Fehler beschreibt, der bei der Verarbeitung dieses abhängigen Beziehungs-CI aufgetreten ist.

    Datentyp: Array

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    result.relations.errors.error Typ des Fehlers, der bei der Verarbeitung dieses abhängigen Beziehungs-CI aufgetreten ist.

    Datentyp: Zeichenfolge
    result.relations.errors.message Die Fehlermeldung, die beim Verarbeiten dieses abhängigen Beziehungs-CI aufgetreten ist.

    Datentyp: Zeichenfolge
    result.relations.inputIndices Array von Indexwerten für die abhängigen Beziehungs-CI-Objekte im Anforderungstext-Array relations, die diesem abhängigen Beziehungs-CI entsprechen.

    Datentyp: Array

    "inputIndices": [
  Number
]
    result.relations.markers Array von Markerwerten für den internen Gebrauch.

    Datentyp: Array

    "markers": []
    result.relations.mergedPayloadIds Array von sys_id-Werten für Teilnutzlasten aus der Tabelle „CMDB-IRE-Teilnutzlasten“ [cmdb_ire_partial_payloads], die während der Verarbeitung dieses abhängigen Beziehungs-CI zusammengeführt wurden.

    Datentyp: Array

    "mergedPayloadIds": [
  "String"
]
    result.relations.operation Der Vorgang, der für dieses abhängige Beziehungs-CI ausgeführt wird.
    Mögliche Werte:
    • EINFÜGEN: Das abhängige Beziehungs-CI wurde als neuer Datensatz in die Zieltabelle eingefügt.
    • INSERT_AS_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 „CMDB-IRE-Teilnutzlasten“ [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.

    Datentyp: Zeichenfolge
    result.relations.warnings Array von Objekten, in dem jedes Objekt eine Warnung beschreibt, die bei der Verarbeitung dieses abhängigen Beziehungs-CI aufgetreten ist.

    Datentyp: Array

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    result.relations.warnings.error Die Art der Warnung, die bei der Verarbeitung dieses abhängigen Beziehungs-CI aufgetreten ist.

    Datentyp: Zeichenfolge
    result.relations.warnings.message Die Warnmeldung, die beim Verarbeiten dieses abhängigen Beziehungs-CI aufgetreten ist.

    Datentyp: Zeichenfolge

    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-Teilnutzlasten“ [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 vervollständigt, mit aktivierter Option „Erweiterte IRE für Zusammenfassungsgenerierung“.

    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 durchgeführten Vorgänge an.

    {
  "result": {
    "relations": [],
    "hasError": false,
    "additionalCommittedItems": [],
    "hasWarning": false,
    "items": [
      {
        "relatedSysIds": [
          "735c79151bb45010593876a61a4bcb67"
        ],
        "identifierEntrySysId": "Unknown",
        "sysId": "ff5c79151bb45010593876a61a4bcb64",
        "errorCount": 0,
        "markers": [],
        "className": "cmdb_ci_computer",
        "inputIndices": [
          0
        ],
        "operation": "INSERT",
        "relatedItems": [
          {
            "operation": "INSERT",
            "warningCount": 0,
            "errors": [],
            "sysId": "735c79151bb45010593876a61a4bcb67",
            "className": "cmdb_ci_network_adapter",
            "errorCount": 0,
            "markers": [],
            "inputIndices": [
              {
                "subIndex": 0,
                "mainIndex": 0
              }
            ],
            "mergedPayloadIds": []
          }
        ],
        "mergedPayloadIds": [
          "fe4c39151bb45010593876a61a4bcbd3"
        ],
        "identificationAttempts": [
          {
            "info": "sys_object_source NO_MATCH",
            "attemptResult": "NO_MATCH",
            "identifierName": "",
            "attributes": [],
            "hybridEntryCiAttributes": []
          },
          {
            "attemptResult": "SKIPPED",
            "identifierName": "Hardware Rule",
            "attributes": [
              "serial_number",
              "serial_number_type"
            ],
            "hybridEntryCiAttributes": [],
            "searchOnTable": "cmdb_serial_number"
          },
          {
            "attemptResult": "SKIPPED",
            "identifierName": "Hardware Rule",
            "attributes": [
              "serial_number"
            ],
            "hybridEntryCiAttributes": [],
            "searchOnTable": "cmdb_ci_hardware"
          },
          {
            "attemptResult": "SKIPPED",
            "identifierName": "Hardware Rule",
            "attributes": [
              "name"
            ],
            "hybridEntryCiAttributes": [],
            "searchOnTable": "cmdb_ci_hardware"
          },
          {
            "attemptResult": "NO_MATCH",
            "identifierName": "Hardware Rule",
            "attributes": [
              "mac_address",
              "name"
            ],
            "hybridEntryCiAttributes": [],
            "searchOnTable": "cmdb_ci_network_adapter"
          }
        ],
        "warningCount": 0
      }
    ],
    "additionalCommittedRelations": [],
    "summary": {
      "cmdb_ci_network_adapter": {
        "mergedPartialPayloads": 0,
        "inserted": 1,
        "partial": 0,
        "warnings": 0,
        "incomplete": 0,
        "additionalInserted": 0,
        "unchanged": 0,
        "skipped": 0,
        "updated": 0,
        "errors": 0
      },
      "cmdb_ci_computer": {
        "mergedPartialPayloads": 1,
        "inserted": 1,
        "partial": 0,
        "warnings": 0,
        "incomplete": 0,
        "additionalInserted": 0,
        "unchanged": 0,
        "skipped": 0,
        "updated": 0,
        "errors": 0
      }
    }
  }
}