Identification and Reconciliation API

  • Freigeben Version: Xanadu
  • Aktualisiert 1. August 2024
  • 85 Minuten Lesedauer

    • Die Identification and Reconciliation API stellt Endpunkte bereit, die die Identification and Reconciliation Engine (IRE) verwenden, um die Erstellung von doppelten Configuration Items (CIs) zu minimieren und CI-Attribute abzugleichen, indem beim Aktualisieren von Configuration Management Database (CMDB)nur Informationen aus autorisierten Quellen akzeptiert werden.

    Benutzer müssen über die Rolle „itil“ oder „asset“ verfügen, um diese API zu verwenden.

    Weitere Informationen zur IRE finden Sie unter Identification and Reconciliation Engine (IRE).

    Identifizierung und Abgleich – POST /now/identifyreconcile

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

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

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

    URL-Format

    URL mit Versionsnummer: /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 Quelle der CI-Informationen. Dies muss einer der Auswahlwerte sein, die für das Feld „discovery_source“ der Tabelle „Konfigurationselement“ [cmdb_ci] definiert sind.

    Datentyp: Zeichenfolge

    Standard: Fügen Sie die API-Nutzlast in die Tabelle der unvollständigen Nutzlasten ein.
    Tabelle : 3. Anforderungstextparameter (XML oder JSON)
    Name Beschreibung
    items Liste der zu erstellenden oder zu aktualisierenden CIs.

    Datentyp: Array von Objekten

    "items": [
  {
    "className": "String",
    "internal_id": "String",
    "lookup": [Array],
    "related": [Array],
    "settings": {Object},
    "sys_object_source_info": {Object},
    "values": {Object}
  }
]
    elemente.klassenname Erforderlich. Der sys_class_name (Klassen-/Tabellenname) des zu erstellenden oder zu aktualisierenden CI. Dieser Wert kann eine beliebige Tabelle CMDB sein, z. B. cmdb_ci_linux_server oder cmdb_ci_win_server.

    Datentyp: Zeichenfolge
    item.internal_id Eindeutiger Bezeichner für das Element in dieser Nutzlast Kann ein beliebiger Wert sein, muss aber innerhalb der Nutzlast eindeutig sein.

    Datentyp: Zeichenfolge
    Items.Suche Array von Objekten, in dem jedes Objekt einen suchbasierten Identifizierungsdatensatz beschreibt. Diese Datensätze werden verwendet, um das Konfigurationselement der obersten Ebene basierend auf einer Suchtabelle zu identifizieren, die einen Verweis zurück auf die Tabelle „Konfigurationselement“ [cmdb_ci] enthält.

    Datentyp: Array aus Objekten

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

    Datentyp: Zeichenfolge
    elemente.suche.internal_id Eindeutiger Bezeichner für den Suchdatensatz in dieser Nutzlast Kann ein beliebiger Wert sein, muss aber innerhalb der Nutzlast eindeutig sein.

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

    Datentyp: Objekt

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

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

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

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

    Datentyp: Zeichenfolge

    Format: JJJJ-MM-TT hh:mm:ss
    elemente.suche.werte Objekt, das Felder für dieses Suchelement als Name/Wert-Paare beschreibt, wobei der Name der Feldname ist.

    Datentyp: Objekt

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

    "values": {
  "ip_address": "String",
  "mac_address": "String",
  "serial_number": "String",
  "serial_number_type": "String",
  "valid": "String"
}
    elemente.zugehörig Array von Objekten, in dem jedes Objekt einen zu erstellenden oder zu aktualisierenden Elementdatensatz beschreibt, basierend auf einer zugehörigen Tabelle, die einen Verweis auf das identifizierte CI der obersten Ebene enthält. Regeln in der Tabelle „Zugehöriger Eintrag“ [cmdb_related_entry] definieren, welche Arten von Datensätzen dieses Array enthalten darf.

    Die zugehörige Tabelle kann die Konfigurationselement-Tabelle [cmdb_ci] erweitern, muss es aber nicht. Diese Datensätze werden nicht zum Identifizieren des Konfigurationselements verwendet.

    Datentyp: Array von Objekten

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

    Datentyp: Zeichenfolge
    elemente.zugehörig.internal_id Eindeutiger Bezeichner für das zugehörige Element in dieser Nutzlast Kann ein beliebiger Wert sein, muss aber innerhalb der Nutzlast eindeutig sein.

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

    Datentyp: Objekt

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

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

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

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

    Datentyp: Zeichenfolge

    Format: JJJJ-MM-TT hh:mm:ss
    elemente.zugehörige.Werte Objekt, das die für dieses zugehörige Element zu erstellenden oder zu aktualisierenden Felder als Name/Wert-Paare beschreibt, wobei der Name der Feldname ist. Für ein Referenzfeld muss der Wert die referenzierte sys_id sein.

    Datentyp: Objekt

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

    "values": {
  "host_name": "String",
  "ip_address": "String",
  "name": "String",
  "os_name": "String",
  "sys_class_name": "String"
}
    elemente.einstellungen Objekt mit Parametern, die festlegen, welche Arten von Updates zulässig sind.

    Datentyp: Objekt

    "settings": {
  "skipReclassificationRestrictionRules": Boolean,
  "updateWithoutDowngrade": Boolean,
  "updateWithoutSwitch": Boolean,
  "updateWithoutUpgrade": Boolean
}
    elemente.einstellungen.reklassifizierungsbeschränkungsregeln überspringen Kennzeichnung, die angibt, ob IRE die Ausführung der Regel zur Einschränkung der Neuklassifizierung überspringen soll, die der Klasse für das Nutzlastelement entspricht.
    Gültige Werte:
    • true: Ausführung der Regel überspringen.
    • „falsch“: Führen Sie die Regel aus.

    Standardwert: false
    elemente.einstellungen.updateOhneDowngrade Kennzeichnung, die angibt, ob Update und Downgrade für dieses CI zulässig sind.
    Gültige Werte:
    • „wahr“: Element wird aktualisiert, Downgrade ist jedoch nicht zulässig.
    • false: Sowohl Elementaktualisierungen als auch Downgrades sind zulässig.

    Datentyp: Boolesch

    Standardwert: false
    elemente.einstellungen.updateOhneSchalter Kennzeichnung, die angibt, ob dieses CI aktualisiert und seine Klasse gewechselt werden kann.
    Gültige Werte:
    • „wahr“: Element wird aktualisiert, aber Klassenwechsel ist nicht zulässig.
    • false: Sowohl Elementaktualisierungen als auch Klassenwechsel sind zulässig.

    Datentyp: Boolesch

    Standardwert: false
    elemente.einstellungen.updateOhneUpgrade Kennzeichnung, die angibt, ob Update und Upgrade für dieses CI zulässig sind.
    Gültige Werte:
    • „wahr“: Element wird aktualisiert, aber Upgrade ist nicht zulässig.
    • „falsch“: Sowohl Element-Updates als auch -Upgrades sind zulässig.

    Datentyp: Boolesch

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

    Datentyp: Objekt

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

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

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

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

    Datentyp: Zeichenfolge

    Format: JJJJ-MM-TT hh:mm:ss
    elemente.werte Objekt, das die für dieses CI zu erstellenden oder zu aktualisierenden Felder als Name/Wert-Paare beschreibt, wobei der Name der Feldname ist. Für ein Referenzfeld muss der Wert die referenzierte sys_id sein.

    Datentyp: Objekt

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

    "values": {
  "host_name": "String",
  "ip_address": "String",
  "name": "String",
  "os_name": "String",
  "sys_class_name": "String"
}
    referenceItems Referenzliste zwischen zwei Elementen in der Nutzlast.

    Datentyp: Array von Objekten

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

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

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

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

    Datentyp: Array von Objekten

    "relations": [
  {
    "child": Number,
    "parent": Number,
    "sys_rel_source_info": {Object},
    "type": "String"
  }
]
    "relations": [
  {
    "child_id": "String",
    "parent_id": "String",
    "sys_rel_source_info": {Object},
    "type": "String"
  }
]
    beziehungen.untergeordnetes element Ganzzahlindex des CI-Objekts im Array items, das das untergeordnete Element in der Beziehung darstellt.

    Datentyp: Zahl
    beziehungen.child_id internal_id des untergeordneten Elements in der Beziehung.

    Datentyp: Zeichenfolge
    beziehungen.übergeordnet Ganzzahlindex des CI-Objekts im Array items, das das übergeordnete Element in der Beziehung darstellt.

    Datentyp: Zahl
    beziehungen.parent_id internal_id des übergeordneten Elements in der Beziehung.

    Datentyp: Zeichenfolge
    beziehungen.sys_rel_source_info Informationen zur Discovery-Quelle für die Beziehung. Bei Nicht-Abhängigkeitsbeziehungen befinden sich diese Informationen in der Tabelle „Beziehungsquellen“ [sys_rel_source].

    Datentyp: Objekt

    "sys_rel_source_info": { 
  "source_name": "String", 
  "source_feed": "String" 
}
    beziehungen.sys_rel_source_info.quellenname Name der Discovery-Quelle.

    Standard: Discovery-Quelle, die im API-Methodenparameter übergeben wird.
    beziehungen.sys_rel_source_info.source_feed Beliebige Zeichenfolge, die eine Unter-Discovery/ein Unterscan innerhalb der Discovery-Quelle ist.

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

    Datentyp: Zeichenfolge

    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.

    Parameter des Antworttexts (JSON oder XML)

    Name Beschreibung
    Ergebnis Liste der von der Abfrage erzeugten Ergebnisse.

    Datentyp: Array

    "result": [
  "additionalCommittedItems": [Array],
  "additionalCommittedRelations": [Array],
  "items": [Array],
  "relations": [Array]
]
    result.additionalCommittedItems Liste der CIs, die nicht im Array des Anforderungstexts items zum Einfügen oder Aktualisieren enthalten sind.

    Datentyp: Array von Objekten

    "additionalCommittedItems": [
  {
    "className": "String",
    "errorCount": Number,
    "identificationAttempts": [Array],
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloads": [Array],
    "operation": "String",
    "sysId": "String"
  }
]
    result.additionalCommittedItems.className Der sys_class_name dieses zusätzlichen CI.

    Datentyp: Zeichenfolge
    Ergebnis.zusätzlichefestgelegteElemente.Fehleranzahl Anzahl der bei der Verarbeitung dieses zusätzlichen CI aufgetretenen Fehler.

    Datentyp: Zahl
    Ergebnis.zusätzlicheCommittedItems.errors Liste der Fehler, die bei der Verarbeitung dieses zusätzlichen CI aufgetreten sind.

    Datentyp: Array von Objekten

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

    Datentyp: Zeichenfolge
    Ergebnis.zusätzlicheCommittedItems.errors.message Fehlermeldung bei der Verarbeitung dieses zusätzlichen CI.

    Datentyp: Zeichenfolge
    Ergebnis.ZusätzlicheZusätzlicheElemente.Identifizierungsversuche Liste der Versuche, die unternommen wurden, um dieses zusätzliche CI zu identifizieren.
    Datentyp: Array von Objekten
    "identificationAttempts": [
  {
    "attemptResult": "String",
    "attributes": [Array],
    "hybridEntryCiAttributes": [Array],
    "identiferName": "String",
    "searchOnTable": [Array]
  }
]
    Ergebnis.zusätzlicheZusätzlicheElemente.Identifizierungsversuche.Versuchsergebnis Ergebnis dieses zusätzlichen CI-Identifizierungsversuchs.
    Mögliche Werte:
    • ABGEGLICHEN: Identifizierung erfolgreich. In der Identifier-Regeltabelle wurde ein eindeutiges CI gefunden, das genau mit den angegebenen Attributen übereinstimmt.
    • Multi_MATCH: Die Identifizierung ist mit einem Fehler fehlgeschlagen. In der Identifier-Regeltabelle wurden beim Abgleich mit den angegebenen Attributen doppelte CIs gefunden.
    • NO_MATCH: Identifizierung fehlgeschlagen. In der Identifier-Regeltabelle wurde kein CI gefunden, das den angegebenen Attributen entspricht.
    • ÜBERSPRUNGEN: Identifizierung nicht versucht. Die für die Suche in dieser Identifier-Regeltabelle erforderlichen Attribute wurden nicht angegeben, daher wurde die Regel nicht angewendet.

    Datentyp: Zeichenfolge
    Ergebnis.zusätzlicheZusätzlicheElemente.Identifizierungsversuche.Attribute Array von CI-Identifier-Eintragsattributen, die bei diesem zusätzlichen CI-Identifizierungsversuch verwendet werden.

    Datentyp: Array

    Attributnamen und -typen hängen von den Anforderungstextdaten und dem verwendeten Bezeichner ab, z. B.:

    "attributes": [
  "serial_number": "String",
  "serial_number_type": "String"
]
    Ergebnis.zusätzlicheCommittedItems.IdentificationAttempts.HybridEntryCiAttributes Liste der CI-Bezeichner-Eintragsattribute, die bei diesem zusätzlichen CI-Identifizierungsversuch verwendet werden.

    Datentyp: Array

    Attributnamen und -typen hängen von den Anforderungstextdaten und dem verwendeten Bezeichner ab, z. B.:

    "hybridEntryCiAttributes": [
  "name": "String",
  "serial_number": "String"
]
    Ergebnis.zusätzlichefestgelegteElemente.Identifizierungsversuche.Bezeichnername Identifier-Regel, die für diesen zusätzlichen CI-Identifizierungsversuch verwendet wird.

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

    Datentyp: Zeichenfolge
    result.additionalCommittedItems.identifierEntrySysId Sys_id für die Identifier-Regel, die zum Identifizieren dieses zusätzlichen CI verwendet wird.
    Bemerkbare Werte:
    • Unbekannt: Die Identifizierung dieses zusätzlichen CI ist fehlgeschlagen. Details siehe errors.

    Datentyp: Zeichenfolge
    result.additionalCommittedItems.inputIndices Liste der Indexwerte für CIs aus dem Array des Anforderungstextes items, die diesem zusätzlichen CI entsprechen.

    Datentyp: Array von Objekten

    "inputIndices": [
  {
    Number
  }
]
    Ergebnis.zusätzlicheCommittedItems.Marker Liste der Markerwerte zur internen Verwendung.

    Datentyp: Array

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

    Datentyp: Array

    "mergedPayloadIds": [
  "String"
]
    result.additionalCommittedItems.operation Für dieses zusätzliche CI durchgeführter Vorgang.
    Mögliche Werte:
    • LÖSCHEN: Ein vorhandenes CI wird aus der Zieltabelle entfernt.
    • EINFÜGEN: Das zusätzliche CI wird als neuer Datensatz in die Zieltabelle eingefügt.
    • NO_CHANGE: Für das zusätzliche CI wird kein Vorgang ausgeführt.
    • UPDATE: Ein vorhandenes CI in der Zieltabelle wird aktualisiert.
    • UPDATE_WITH_DOWNGRADE: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine allgemeinere Klasse (Vorgängerklasse) geändert.
    • UPDATE_WITH_SWITCH: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine andere Klasse geändert, die keine Vorgängerklasse oder untergeordnete Klasse ist.
    • UPDATE_WITH_UPGRADE: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine spezialisiertere Klasse (absteigende Klasse) geändert.

    Datentyp: Zeichenfolge
    result.additionalCommittedItems.sysId Sys_id für dieses zusätzliche CI durch Identifizierung gefunden.

    Bemerkbare Werte: Unbekannt: Die Identifizierung dieses zusätzlichen CI ist fehlgeschlagen. Details siehe errors.

    Datentyp: Zeichenfolge
    Ergebnis.zusätzlicheCommittedItems.Warnungen Liste der Warnungen, die bei der Verarbeitung dieses zusätzlichen CI aufgetreten sind.

    Datentyp: Array von Objekten

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    Ergebnis.zusätzlicheCommittedItems.Warnungen.Fehler Typ der Warnung, die bei der Verarbeitung dieses zusätzlichen CI aufgetreten ist.

    Datentyp: Zeichenfolge
    Ergebnis.zusätzlicheCommittedItems.Warnungen.Nachricht Bei der Verarbeitung dieses zusätzlichen CI ist eine Warnmeldung aufgetreten.

    Datentyp: Zeichenfolge
    result.additionalCommittedRelations Liste der abhängigen Beziehungs-CIs, die nicht in der Liste des Anforderungstextes relations zum Einfügen oder Aktualisieren enthalten sind.

    Datentyp: Array von Objekten

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

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

    Datentyp: Zahl
    Ergebnis.zusätzlicheCommittedRelations.errors Liste der Fehler, die bei der Verarbeitung dieses zusätzlichen CI für abhängige Beziehungen aufgetreten sind.

    Datentyp: Array von Objekten

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

    Datentyp: Zeichenfolge
    Ergebnis.zusätzlicheBestätigteBeziehungen.Fehler.Nachricht Fehlermeldung beim Verarbeiten dieses zusätzlichen abhängigen Beziehungs-CI.

    Datentyp: Zeichenfolge
    result.additionalCommittedRelations.inputIndexes Liste der Indexwerte für abhängige Beziehungs-CI-Objekte im Array des Anforderungstexts relations, die diesem zusätzlichen abhängigen Beziehungs-CI entsprechen.

    Datentyp: Array

    "inputIndices": [
  Number
]
    result.additionalCommittedRelations.markers Liste der Markerwerte zur internen Verwendung.

    Datentyp: Array

    "markers": []
    result.additionalCommittedRelations.mergedPayloadIds Liste der sys_id-Werte für Teilnutzlasten aus der Tabelle „Teilliche CMDB-IRE-Nutzlasten“ [cmdb_ire_partial_payloads], die während der Verarbeitung dieses zusätzlichen abhängigen Beziehungs-CI zusammengeführt wurden.

    Datentyp: Array

    "mergedPayloadIds": [
  "String"
]
    result.additionalCommittedRelations.operation Für dieses zusätzliche abhängige Beziehungs-CI durchgeführte Operation.
    Mögliche Werte:
    • INSERT: Das CI der abhängigen Beziehung wird als neuer Datensatz in die Zieltabelle eingefügt.
    • INSERT_AS_INCOMPLETE: Das abhängige Beziehungs-CI wies Fehler auf und wird in die Tabelle „CMDB IRE Unvollständige Nutzlasten“ [cmdb_ire_incomplete_payloads] eingefügt.
    • INSERT_AS_partial: Das abhängige Beziehungs-CI wies Fehler auf und wird in die Tabelle der teilweisen CMDB-IRE-Nutzlasten [cmdb_ire_partial_payloads] eingefügt.
    • NO_CHANGE: Für das abhängige Beziehungs-CI wird kein Vorgang ausgeführt.
    • UPDATE: Ein vorhandenes abhängiges Beziehungs-CI in der Zieltabelle wird aktualisiert.

    Datentyp: Zeichenfolge
    result.items Liste der CIs, die im Array des Anforderungstexts items enthalten sind.

    Datentyp: Array von Objekten

    "items": [
  {
    "additionalRelatedItems": [Array],
    "className": "String",
    "duplicateLookupIndices": {Object},
    "errorCount": Number,
    "errors": [Array],
    "identificationAttempts": [Array],
    "identifierEntrySysId": "String",
    "info": [Array],
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloadIds": [Array],
    "operation": "String",
    "relatedItems": [Array],
    "relatedSysIds": [Array],
    "sysId": "String",
    "warnings": [Array]
  }
]
    Ergebnis.Elemente.ZusätzlicheZugehörigeElemente Liste der zugehörigen CIs (Tabellensuch-CI) aus der Tabelle „Teilweise Nutzlasten der CMDB-IRE“ [cmdb_ire_partial_payloads].

    Datentyp: Array von Objekten

    "additionalRelatedItems": [
  {
    "className": "String",
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloadIds": [Array],
    "sysId": "String"
  }
]
    Ergebnis.Elemente.ZusätzlicheZugehörigeElemente.Klassenname Der sys_class_name des zugehörigen Elements.

    Datentyp: Zeichenfolge
    Ergebnis.Elemente.ZusätzlicheZugehörigeElemente.Eingabeindizes Liste der Indexwerte für CIs aus dem Array des Anforderungstextes items, die diesem zugehörigen Element entsprechen.

    Datentyp: Array

    "inputIndices": [
    Number
]
    Ergebnis.Elemente.ZusätzlicheZugehörigeElemente.Marker Liste der Markerwerte zur internen Verwendung.

    Datentyp: Array

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

    Datentyp: Array

    "mergedPayloadIds": [
  "String"
]
    Ergebnis.Elemente.ZusätzlicheZugehörigeElemente.SysId Sys_id des zugehörigen CI.

    Datentyp: Zeichenfolge
    Ergebnis.Elemente.Klassenname Sys_class_name dieses CI.

    Datentyp: Zeichenfolge
    result.items.duplicateLookupIndices Objekt mit Arrays von Indexwerten für items.lookup -Array-Elemente, die auf dasselbe zugehörige CI verweisen.

    Der Array-Name gibt das erste Element aus dem Array des Anforderungstextes items.lookup an, das auf ein bestimmtes zugehöriges CI verweist. Seine Werte sind der Satz zusätzlicher Elemente aus demselben Array, die auf dasselbe zugehörige CI verweisen.

    Datentyp: Objekt

    Dieses Beispiel zeigt einen Fall, in dem das zweite Element im Array items.lookup auf dasselbe zugehörige CI verweist wie ein späteres Element aus diesem Array:

    "duplicateLookupIndices": [
  "2": [Array]
]
    Ergebnis.Elemente.Fehleranzahl Anzahl der bei der Verarbeitung dieses CI aufgetretenen Fehler.

    Datentyp: Zahl
    Ergebnis.Elemente.Fehler Liste der bei der Verarbeitung des CI aufgetretenen Fehler.

    Datentyp: Array von Objekten

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

    Datentyp: Zeichenfolge
    Ergebnis.Elemente.Fehlermeldung Bei der Verarbeitung dieses CI ist eine Fehlermeldung aufgetreten.

    Datentyp: Zeichenfolge
    Ergebnis.Elemente.Identifizierungsversuche Liste der Versuche, die unternommen wurden, um dieses CI zu identifizieren.
    Datentyp: Array von Objekten
    "identificationAttempts": [
  {
    "attemptResult": "String",
    "attributes": [Array],
    "hybridEntryCiAttributes": [Array],
    "identiferName": "String",
    "searchOnTable": [Array]
  }
]
    Ergebnis.Elemente.Identifizierungsversuche.VersuchErgebnis Ergebnis des CI-Identifizierungsversuchs.
    Mögliche Werte:
    • ABGEGLICHEN: Identifizierung erfolgreich. In der Identifier-Regeltabelle wurde ein eindeutiges CI gefunden, das genau mit den angegebenen Attributen übereinstimmt.
    • Multi_MATCH: Die Identifizierung ist mit einem Fehler fehlgeschlagen. In der Identifier-Regeltabelle wurden beim Abgleich mit den angegebenen Attributen doppelte CIs gefunden.
    • NO_MATCH: Identifizierung fehlgeschlagen. In der Identifier-Regeltabelle wurde kein CI gefunden, das den angegebenen Attributen entspricht.
    • ÜBERSPRUNGEN: Identifizierung nicht versucht. Die für die Suche in dieser Identifier-Regeltabelle erforderlichen Attribute wurden nicht angegeben, daher wurde die Regel nicht angewendet.

    Datentyp: Zeichenfolge
    Ergebnis.Elemente.Identifizierungsversuche.Attribute Liste der CI-Bezeichner-Eintragsattribute, die während dieses CI-Identifizierungsversuchs verwendet werden.

    Datentyp: Array

    Attributnamen und -typen hängen von den Anforderungstextdaten und dem verwendeten Bezeichner ab, z. B.:

    "attributes": [
  "serial_number": "String",
  "serial_number_type": "String",
]
    result.items.identificationAttempts.hybridEntryCiAttributes Liste der CI-Bezeichner-Eintragsattribute, die während dieses CI-Identifizierungsversuchs verwendet werden.

    Datentyp: Array

    Attributnamen und -typen hängen von den Anforderungstextdaten und dem verwendeten Bezeichner ab, z. B.:

    "hybridEntryCiAttributes": [
  "name": "String",
  "serial_number": "String"
]
    Ergebnis.Elemente.Identifizierungsversuche.Bezeichnername Identifier-Regel, die für diesen CI-Identifizierungsversuch verwendet wird.

    Datentyp: Zeichenfolge
    result.items.identificationVersuche.searchOnTable Name der Tabelle, die für diesen CI-Identifizierungsversuch durchsucht wurde.

    Datentyp: Zeichenfolge
    result.items.identifierEntrySysId Sys_id für die Identifier-Regel, die zum Identifizieren dieses CI verwendet wird.
    Bemerkbare Werte:
    • Unbekannt: Die Identifizierung dieses CI ist fehlgeschlagen. Details finden Sie unter errors.

    Datentyp: Zeichenfolge
    result.items.info Liste zusätzlicher Informationen zur Verarbeitung des Elements.

    Datentyp: Array von Objekten

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

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

    Datentyp: Zeichenfolge
    result.items.inputIndices Liste der Indexwerte für CIs aus dem Array des Anforderungstextes items, die diesem CI entsprechen.

    Datentyp: Array von Objekten

    "inputIndices": [
  {
    Number
  }
]
    Ergebnis.Elemente.Marker Liste der Markerwerte zur internen Verwendung.

    Datentyp: Array

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

    Datentyp: Array

    "mergedPayloadIds": [
  "String"
]
    Ergebnis.Elemente.Vorgang Für dieses CI durchgeführter Vorgang.
    Mögliche Werte:
    • LÖSCHEN: Ein vorhandenes CI wird aus der Zieltabelle entfernt.
    • EINFÜGEN: Das CI wird als neuer Datensatz in die Zieltabelle eingefügt.
    • NO_CHANGE: Für das CI wird kein Vorgang ausgeführt.
    • UPDATE: Ein vorhandenes CI in der Zieltabelle wird aktualisiert.
    • UPDATE_WITH_DOWNGRADE: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine allgemeinere Klasse (Vorgängerklasse) geändert.
    • UPDATE_WITH_SWITCH: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine andere Klasse geändert, die keine Vorgängerklasse oder untergeordnete Klasse ist.
    • UPDATE_WITH_UPGRADE: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine spezialisiertere Klasse (absteigende Klasse) geändert.

    Datentyp: Zeichenfolge
    Ergebnis.Elemente.ZugehörigeElemente Liste der zugehörigen CIs (Tabellensuch-CI) aus dem Array des Anforderungstextes items.lookup.

    Datentyp: Array von Objekten

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

    Datentyp: Zeichenfolge
    result.items.relatedItems.inputIndices Liste der Indexwerte für CIs und Suchelemente aus den Arrays items und items.lookup des Anforderungstexts, die diesem zugehörigen Element entsprechen.

    Datentyp: Array von Objekten

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

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

    Datentyp: Zahl
    Ergebnis.Elemente.ZugehörigeElemente.Marker Liste der Markerwerte zur internen Verwendung.

    Datentyp: Array

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

    Datentyp: Array

    "mergedPayloadIds": [
  "String"
]
    result.items.relatedSysIds Liste der sys_id-Werte für zugehörige Elemente (Tabellensuchelemente) aus dem Array des Anforderungstexts items.lookup.

    Datentyp: Array

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

    Datentyp: Zeichenfolge
    Ergebnis.Elemente.Warnungen Liste der Warnungen, die bei der Verarbeitung dieses CI aufgetreten sind.

    Datentyp: Array von Objekten

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    Ergebnis.Elemente.Warnungen.Fehler Typ der Warnung, die bei der Verarbeitung des CI aufgetreten ist.

    Datentyp: Zeichenfolge
    Ergebnis.Elemente.Warnungen.Nachricht Bei der Verarbeitung dieses CI ist eine Warnmeldung aufgetreten.

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

    Datentyp: Zeichenfolge
    result.relations Liste der abhängigen Beziehungs-CIs aus dem Array des Anforderungstextes relations.

    Datentyp: Array von Objekten

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

    Datentyp: Zeichenfolge
    Ergebnis.Beziehungen.Fehleranzahl Anzahl der Fehler, die bei der Verarbeitung dieses abhängigen Beziehungs-CI aufgetreten sind.

    Datentyp: Zahl
    Ergebnis.Beziehungen.Fehler Liste der Fehler, die bei der Verarbeitung dieses abhängigen Beziehungs-CI aufgetreten sind.

    Datentyp: Array von Objekten

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    Ergebnis.Beziehungen.Fehler.Fehler Typ des Fehlers, der bei der Verarbeitung dieser abhängigen Beziehungs-CI aufgetreten ist.

    Datentyp: Zeichenfolge
    Ergebnis.Beziehungen.Fehler.Meldung Fehlermeldung bei der Verarbeitung dieses abhängigen Beziehungs-CI.

    Datentyp: Zeichenfolge
    result.beziehungen.inputIndices Liste der Indexwerte für die abhängigen Beziehungs-CI-Objekte im Array des Anforderungstextes relations, die diesem abhängigen Beziehungs-CI entsprechen.

    Datentyp: Array

    "inputIndices": [
  Number
]
    Ergebnis.Beziehungen.Marker Liste der Markerwerte zur internen Verwendung.

    Datentyp: Array

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

    Datentyp: Array

    "mergedPayloadIds": [
  "String"
]
    Ergebnis.Beziehungen.Vorgang Für dieses abhängige Beziehungs-CI durchgeführte Operation.
    Mögliche Werte:
    • EINFÜGEN: Das abhängige Beziehungs-CI wurde als neuer Datensatz in die Zieltabelle eingefügt.
    • INSERT_AS_INCOMPLETE: Das abhängige Beziehungs-CI wies Fehler auf und wurde in die Tabelle „CMDB IRE Unvollständige Nutzlasten“ [cmdb_ire_incomplete_payloads] eingefügt.
    • INSERT_AS_partial: Das abhängige Beziehungs-CI wies Fehler auf und wurde in die Tabelle der teilweisen CMDB-IRE-Nutzlasten [cmdb_ire_partial_payloads] eingefügt.
    • NO_CHANGE: Für das abhängige Beziehungs-CI wurde kein Vorgang ausgeführt.
    • UPDATE: Ein vorhandenes abhängiges Beziehungs-CI in der Zieltabelle wurde aktualisiert.

    Datentyp: Zeichenfolge
    Ergebnis.Beziehungen.Warnungen Liste der Warnungen, die bei der Verarbeitung dieses abhängigen Beziehungs-CI aufgetreten sind.

    Datentyp: Array von Objekten

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    Ergebnis.Beziehungen.Warnungen.Fehler Typ der Warnung, die bei der Verarbeitung dieser abhängigen Beziehungs-CI aufgetreten ist.

    Datentyp: Zeichenfolge
    Ergebnis.Beziehungen.Warnungen.Nachricht Bei der Verarbeitung dieses abhängigen Beziehungs-CI ist eine Warnmeldung aufgetreten.

    Datentyp: Zeichenfolge

    cURL-Anforderung

    Senden Sie eine Nutzlast, die einen Linux-Server (mit Seriennummern- und Netzwerkadapter-Suchvorgängen zugehöriger Elemente) und einen IP-Switch mit einer von der IP-Verbindung abhängigen Beziehung enthält.

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

    Das Linux-Server-CI wird über eine Hardwareregelsuche nach seinem Namen in der Hardwaretabelle [cmdb_ci_hardware] identifiziert und als Aktualisierung eines vorhandenen CI in der Linux-Servertabelle [cmdb_ci_linux_server] verarbeitet. Der IP-Switch wird ebenfalls über eine Hardwareregelsuche nach seinem Namen in der Hardware-Tabelle identifiziert und aktualisiert ein vorhandenes CI in der IP-Switch-Tabelle [cmdb_ci_ip_Switch]. Abschließend wird die von der IP-Verbindung abhängige Beziehung zwischen Server und Switch als neuer Datensatz in die CI-Beziehungstabelle [cmdb_rel_ci] eingefügt.

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

    Identifizierung und Abgleich – POST /now/identifyreconcile/enhanced

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

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

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

    URL-Format

    URL mit Versionsnummer: /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 für die Anforderung angewendet werden.

    Um die Standardwerte für die Optionen für teilweise Nutzlasten, teilweise Commits, deduplizierte Nutzlasten und das Generieren einer Zusammenfassung für erweiterte IRE zu überschreiben:

    Partial_payloads:false,partial_commits:false,deduplizierte_nutzlasten:falsch,generate_summary:wahr
    Hinweis:
    Standardmäßig oder wenn partial_payloads auf „true“ festgelegt ist, sind sowohl partial_commits als auch deduplicate_payloads aktiviert, auch wenn sie auf „false“ festgelegt sind, da diese Funktionen für die Funktionalität von Teilnutzlasten wichtig sind.

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

    Gültige Werte für jedes Name-Wert-Paar:
    • true: Aktivieren Sie diese Option für die erweiterte IRE.
    • „falsch“: Deaktivieren Sie diese erweiterte IRE-Option.

    Datentyp: Zeichenfolge
    sysparm_data_source Quelle der CI-Informationen. Dies muss einer der Auswahlwerte sein, die für das Feld „discovery_source“ der Tabelle „Konfigurationselement“ [cmdb_ci] definiert sind.

    Datentyp: Zeichenfolge

    Standard: Fügen Sie die API-Nutzlast in die Tabelle der unvollständigen Nutzlasten ein.
    Tabelle : 9. Anforderungstextparameter (XML oder JSON)
    Name Beschreibung
    items Liste der zu erstellenden oder zu aktualisierenden CIs.

    Datentyp: Array von Objekten

    "items": [
  {
    "className": "String",
    "internal_id": "String",
    "lookup": [Array],
    "related": [Array],
    "settings": {Object},
    "sys_object_source_info": {Object},
    "values": {Object}
  }
]
    elemente.klassenname Erforderlich. Der sys_class_name (Klassen-/Tabellenname) des zu erstellenden oder zu aktualisierenden CI. Dieser Wert kann eine beliebige Tabelle CMDB sein, z. B. cmdb_ci_linux_server oder cmdb_ci_win_server.

    Datentyp: Zeichenfolge
    item.internal_id Eindeutiger Bezeichner für das Element in dieser Nutzlast Kann ein beliebiger Wert sein, muss aber innerhalb der Nutzlast eindeutig sein.

    Datentyp: Zeichenfolge
    Items.Suche Array von Objekten, in dem jedes Objekt einen suchbasierten Identifizierungsdatensatz beschreibt. Diese Datensätze werden verwendet, um das Konfigurationselement der obersten Ebene basierend auf einer Suchtabelle zu identifizieren, die einen Verweis zurück auf die Tabelle „Konfigurationselement“ [cmdb_ci] enthält.

    Datentyp: Array aus Objekten

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

    Datentyp: Zeichenfolge
    elemente.suche.internal_id Eindeutiger Bezeichner für den Suchdatensatz in dieser Nutzlast Kann ein beliebiger Wert sein, muss aber innerhalb der Nutzlast eindeutig sein.

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

    Datentyp: Objekt

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

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

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

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

    Datentyp: Zeichenfolge

    Format: JJJJ-MM-TT hh:mm:ss
    elemente.suche.werte Objekt, das Felder für dieses Suchelement als Name/Wert-Paare beschreibt, wobei der Name der Feldname ist.

    Datentyp: Objekt

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

    "values": {
  "ip_address": "String",
  "mac_address": "String",
  "serial_number": "String",
  "serial_number_type": "String",
  "valid": "String"
}
    elemente.zugehörig Array von Objekten, in dem jedes Objekt einen zu erstellenden oder zu aktualisierenden Elementdatensatz beschreibt, basierend auf einer zugehörigen Tabelle, die einen Verweis auf das identifizierte CI der obersten Ebene enthält. Regeln in der Tabelle „Zugehöriger Eintrag“ [cmdb_related_entry] definieren, welche Arten von Datensätzen dieses Array enthalten darf.

    Die zugehörige Tabelle kann die Konfigurationselement-Tabelle [cmdb_ci] erweitern, muss es aber nicht. Diese Datensätze werden nicht zum Identifizieren des Konfigurationselements verwendet.

    Datentyp: Array von Objekten

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

    Datentyp: Zeichenfolge
    elemente.zugehörig.internal_id Eindeutiger Bezeichner für das zugehörige Element in dieser Nutzlast Kann ein beliebiger Wert sein, muss aber innerhalb der Nutzlast eindeutig sein.

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

    Datentyp: Objekt

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

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

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

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

    Datentyp: Zeichenfolge

    Format: JJJJ-MM-TT hh:mm:ss
    elemente.zugehörige.Werte Objekt, das die für dieses zugehörige Element zu erstellenden oder zu aktualisierenden Felder als Name/Wert-Paare beschreibt, wobei der Name der Feldname ist. Für ein Referenzfeld muss der Wert die referenzierte sys_id sein.

    Datentyp: Objekt

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

    "values": {
  "host_name": "String",
  "ip_address": "String",
  "name": "String",
  "os_name": "String",
  "sys_class_name": "String"
}
    elemente.einstellungen Objekt mit Parametern, die festlegen, welche Arten von Updates zulässig sind.

    Datentyp: Objekt

    "settings": {
  "skipReclassificationRestrictionRules": Boolean,
  "updateWithoutDowngrade": Boolean,
  "updateWithoutSwitch": Boolean,
  "updateWithoutUpgrade": Boolean
}
    elemente.einstellungen.reklassifizierungsbeschränkungsregeln überspringen Kennzeichnung, die angibt, ob IRE die Ausführung der Regel zur Einschränkung der Neuklassifizierung überspringen soll, die der Klasse für das Nutzlastelement entspricht.
    Gültige Werte:
    • true: Ausführung der Regel überspringen.
    • „falsch“: Führen Sie die Regel aus.

    Standardwert: false
    elemente.einstellungen.updateOhneDowngrade Kennzeichnung, die angibt, ob Update und Downgrade für dieses CI zulässig sind.
    Gültige Werte:
    • „wahr“: Element wird aktualisiert, Downgrade ist jedoch nicht zulässig.
    • false: Sowohl Elementaktualisierungen als auch Downgrades sind zulässig.

    Datentyp: Boolesch

    Standardwert: false
    elemente.einstellungen.updateOhneSchalter Kennzeichnung, die angibt, ob dieses CI aktualisiert und seine Klasse gewechselt werden kann.
    Gültige Werte:
    • „wahr“: Element wird aktualisiert, aber Klassenwechsel ist nicht zulässig.
    • false: Sowohl Elementaktualisierungen als auch Klassenwechsel sind zulässig.

    Datentyp: Boolesch

    Standardwert: false
    elemente.einstellungen.updateOhneUpgrade Kennzeichnung, die angibt, ob Update und Upgrade für dieses CI zulässig sind.
    Gültige Werte:
    • „wahr“: Element wird aktualisiert, aber Upgrade ist nicht zulässig.
    • „falsch“: Sowohl Element-Updates als auch -Upgrades sind zulässig.

    Datentyp: Boolesch

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

    Datentyp: Objekt

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

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

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

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

    Datentyp: Zeichenfolge

    Format: JJJJ-MM-TT hh:mm:ss
    elemente.werte Objekt, das die für dieses CI zu erstellenden oder zu aktualisierenden Felder als Name/Wert-Paare beschreibt, wobei der Name der Feldname ist. Für ein Referenzfeld muss der Wert die referenzierte sys_id sein.

    Datentyp: Objekt

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

    "values": {
  "host_name": "String",
  "ip_address": "String",
  "name": "String",
  "os_name": "String",
  "sys_class_name": "String"
}
    referenceItems Referenzliste zwischen zwei Elementen in der Nutzlast.

    Datentyp: Array von Objekten

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

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

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

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

    Datentyp: Array von Objekten

    "relations": [
  {
    "child": Number,
    "parent": Number,
    "sys_rel_source_info": {Object},
    "type": "String"
  }
]
    "relations": [
  {
    "child_id": "String",
    "parent_id": "String",
    "sys_rel_source_info": {Object},
    "type": "String"
  }
]
    beziehungen.untergeordnetes element Ganzzahlindex des CI-Objekts im Array items, das das untergeordnete Element in der Beziehung darstellt.

    Datentyp: Zahl
    beziehungen.child_id internal_id des untergeordneten Elements in der Beziehung.

    Datentyp: Zeichenfolge
    beziehungen.übergeordnet Ganzzahlindex des CI-Objekts im Array items, das das übergeordnete Element in der Beziehung darstellt.

    Datentyp: Zahl
    beziehungen.parent_id internal_id des übergeordneten Elements in der Beziehung.

    Datentyp: Zeichenfolge
    beziehungen.sys_rel_source_info Informationen zur Discovery-Quelle für die Beziehung. Bei Nicht-Abhängigkeitsbeziehungen befinden sich diese Informationen in der Tabelle „Beziehungsquellen“ [sys_rel_source].

    Datentyp: Objekt

    "sys_rel_source_info": { 
  "source_name": "String", 
  "source_feed": "String" 
}
    beziehungen.sys_rel_source_info.quellenname Name der Discovery-Quelle.

    Standard: Discovery-Quelle, die im API-Methodenparameter übergeben wird.
    beziehungen.sys_rel_source_info.source_feed Beliebige Zeichenfolge, die eine Unter-Discovery/ein Unterscan innerhalb der Discovery-Quelle ist.

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

    Datentyp: Zeichenfolge

    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.

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

    Wenn Sie beispielsweise den Parameter options des Typs „ partial “ angeben, wird beispielsweise ein Statuscode 500 mit „Block [partial] is not a valid Eintrag“ im Nachrichtendetail angezeigt.

    Parameter des Antworttexts (JSON oder XML)

    Name Beschreibung
    Ergebnis Liste der von der Abfrage erzeugten Ergebnisse.

    Datentyp: Array

    "result": [
  "additionalCommittedItems": [Array],
  "additionalCommittedRelations": [Array],
  "items": [Array],
  "relations": [Array]
]
    result.additionalCommittedItems Liste der CIs, die nicht im Array des Anforderungstexts items zum Einfügen oder Aktualisieren enthalten sind.

    Datentyp: Array von Objekten

    "additionalCommittedItems": [
  {
    "className": "String",
    "errorCount": Number,
    "identificationAttempts": [Array],
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloads": [Array],
    "operation": "String",
    "sysId": "String"
  }
]
    result.additionalCommittedItems.className Der sys_class_name dieses zusätzlichen CI.

    Datentyp: Zeichenfolge
    Ergebnis.zusätzlichefestgelegteElemente.Fehleranzahl Anzahl der bei der Verarbeitung dieses zusätzlichen CI aufgetretenen Fehler.

    Datentyp: Zahl
    Ergebnis.zusätzlicheCommittedItems.errors Liste der Fehler, die bei der Verarbeitung dieses zusätzlichen CI aufgetreten sind.

    Datentyp: Array von Objekten

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

    Datentyp: Zeichenfolge
    Ergebnis.zusätzlicheCommittedItems.errors.message Fehlermeldung bei der Verarbeitung dieses zusätzlichen CI.

    Datentyp: Zeichenfolge
    Ergebnis.ZusätzlicheZusätzlicheElemente.Identifizierungsversuche Liste der Versuche, die unternommen wurden, um dieses zusätzliche CI zu identifizieren.
    Datentyp: Array von Objekten
    "identificationAttempts": [
  {
    "attemptResult": "String",
    "attributes": [Array],
    "hybridEntryCiAttributes": [Array],
    "identiferName": "String",
    "searchOnTable": [Array]
  }
]
    Ergebnis.zusätzlicheZusätzlicheElemente.Identifizierungsversuche.Versuchsergebnis Ergebnis dieses zusätzlichen CI-Identifizierungsversuchs.
    Mögliche Werte:
    • ABGEGLICHEN: Identifizierung erfolgreich. In der Identifier-Regeltabelle wurde ein eindeutiges CI gefunden, das genau mit den angegebenen Attributen übereinstimmt.
    • Multi_MATCH: Die Identifizierung ist mit einem Fehler fehlgeschlagen. In der Identifier-Regeltabelle wurden beim Abgleich mit den angegebenen Attributen doppelte CIs gefunden.
    • NO_MATCH: Identifizierung fehlgeschlagen. In der Identifier-Regeltabelle wurde kein CI gefunden, das den angegebenen Attributen entspricht.
    • ÜBERSPRUNGEN: Identifizierung nicht versucht. Die für die Suche in dieser Identifier-Regeltabelle erforderlichen Attribute wurden nicht angegeben, daher wurde die Regel nicht angewendet.

    Datentyp: Zeichenfolge
    Ergebnis.zusätzlicheZusätzlicheElemente.Identifizierungsversuche.Attribute Array von CI-Identifier-Eintragsattributen, die bei diesem zusätzlichen CI-Identifizierungsversuch verwendet werden.

    Datentyp: Array

    Attributnamen und -typen hängen von den Anforderungstextdaten und dem verwendeten Bezeichner ab, z. B.:

    "attributes": [
  "serial_number": "String",
  "serial_number_type": "String"
]
    Ergebnis.zusätzlicheCommittedItems.IdentificationAttempts.HybridEntryCiAttributes Liste der CI-Bezeichner-Eintragsattribute, die bei diesem zusätzlichen CI-Identifizierungsversuch verwendet werden.

    Datentyp: Array

    Attributnamen und -typen hängen von den Anforderungstextdaten und dem verwendeten Bezeichner ab, z. B.:

    "hybridEntryCiAttributes": [
  "name": "String",
  "serial_number": "String"
]
    Ergebnis.zusätzlichefestgelegteElemente.Identifizierungsversuche.Bezeichnername Identifier-Regel, die für diesen zusätzlichen CI-Identifizierungsversuch verwendet wird.

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

    Datentyp: Zeichenfolge
    result.additionalCommittedItems.identifierEntrySysId Sys_id für die Identifier-Regel, die zum Identifizieren dieses zusätzlichen CI verwendet wird.
    Bemerkbare Werte:
    • Unbekannt: Die Identifizierung dieses zusätzlichen CI ist fehlgeschlagen. Details siehe errors.

    Datentyp: Zeichenfolge
    result.additionalCommittedItems.inputIndices Liste der Indexwerte für CIs aus dem Array des Anforderungstextes items, die diesem zusätzlichen CI entsprechen.

    Datentyp: Array von Objekten

    "inputIndices": [
  {
    Number
  }
]
    Ergebnis.zusätzlicheCommittedItems.Marker Liste der Markerwerte zur internen Verwendung.

    Datentyp: Array

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

    Datentyp: Array

    "mergedPayloadIds": [
  "String"
]
    result.additionalCommittedItems.operation Für dieses zusätzliche CI durchgeführter Vorgang.
    Mögliche Werte:
    • LÖSCHEN: Ein vorhandenes CI wird aus der Zieltabelle entfernt.
    • EINFÜGEN: Das zusätzliche CI wird als neuer Datensatz in die Zieltabelle eingefügt.
    • NO_CHANGE: Für das zusätzliche CI wird kein Vorgang ausgeführt.
    • UPDATE: Ein vorhandenes CI in der Zieltabelle wird aktualisiert.
    • UPDATE_WITH_DOWNGRADE: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine allgemeinere Klasse (Vorgängerklasse) geändert.
    • UPDATE_WITH_SWITCH: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine andere Klasse geändert, die keine Vorgängerklasse oder untergeordnete Klasse ist.
    • UPDATE_WITH_UPGRADE: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine spezialisiertere Klasse (absteigende Klasse) geändert.

    Datentyp: Zeichenfolge
    result.additionalCommittedItems.sysId Sys_id für dieses zusätzliche CI durch Identifizierung gefunden.

    Bemerkbare Werte: Unbekannt: Die Identifizierung dieses zusätzlichen CI ist fehlgeschlagen. Details siehe errors.

    Datentyp: Zeichenfolge
    Ergebnis.zusätzlicheCommittedItems.Warnungen Liste der Warnungen, die bei der Verarbeitung dieses zusätzlichen CI aufgetreten sind.

    Datentyp: Array von Objekten

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    Ergebnis.zusätzlicheCommittedItems.Warnungen.Fehler Typ der Warnung, die bei der Verarbeitung dieses zusätzlichen CI aufgetreten ist.

    Datentyp: Zeichenfolge
    Ergebnis.zusätzlicheCommittedItems.Warnungen.Nachricht Bei der Verarbeitung dieses zusätzlichen CI ist eine Warnmeldung aufgetreten.

    Datentyp: Zeichenfolge
    result.additionalCommittedRelations Liste der abhängigen Beziehungs-CIs, die nicht in der Liste des Anforderungstextes relations zum Einfügen oder Aktualisieren enthalten sind.

    Datentyp: Array von Objekten

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

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

    Datentyp: Zahl
    Ergebnis.zusätzlicheCommittedRelations.errors Liste der Fehler, die bei der Verarbeitung dieses zusätzlichen CI für abhängige Beziehungen aufgetreten sind.

    Datentyp: Array von Objekten

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

    Datentyp: Zeichenfolge
    Ergebnis.zusätzlicheBestätigteBeziehungen.Fehler.Nachricht Fehlermeldung beim Verarbeiten dieses zusätzlichen abhängigen Beziehungs-CI.

    Datentyp: Zeichenfolge
    result.additionalCommittedRelations.inputIndexes Liste der Indexwerte für abhängige Beziehungs-CI-Objekte im Array des Anforderungstexts relations, die diesem zusätzlichen abhängigen Beziehungs-CI entsprechen.

    Datentyp: Array

    "inputIndices": [
  Number
]
    result.additionalCommittedRelations.markers Liste der Markerwerte zur internen Verwendung.

    Datentyp: Array

    "markers": []
    result.additionalCommittedRelations.mergedPayloadIds Liste der sys_id-Werte für Teilnutzlasten aus der Tabelle „Teilliche CMDB-IRE-Nutzlasten“ [cmdb_ire_partial_payloads], die während der Verarbeitung dieses zusätzlichen abhängigen Beziehungs-CI zusammengeführt wurden.

    Datentyp: Array

    "mergedPayloadIds": [
  "String"
]
    result.additionalCommittedRelations.operation Für dieses zusätzliche abhängige Beziehungs-CI durchgeführte Operation.
    Mögliche Werte:
    • INSERT: Das CI der abhängigen Beziehung wird als neuer Datensatz in die Zieltabelle eingefügt.
    • INSERT_AS_INCOMPLETE: Das abhängige Beziehungs-CI wies Fehler auf und wird in die Tabelle „CMDB IRE Unvollständige Nutzlasten“ [cmdb_ire_incomplete_payloads] eingefügt.
    • INSERT_AS_partial: Das abhängige Beziehungs-CI wies Fehler auf und wird in die Tabelle der teilweisen CMDB-IRE-Nutzlasten [cmdb_ire_partial_payloads] eingefügt.
    • NO_CHANGE: Für das abhängige Beziehungs-CI wird kein Vorgang ausgeführt.
    • UPDATE: Ein vorhandenes abhängiges Beziehungs-CI in der Zieltabelle wird aktualisiert.

    Datentyp: Zeichenfolge
    result.items Liste der CIs, die im Array des Anforderungstexts items enthalten sind.

    Datentyp: Array von Objekten

    "items": [
  {
    "additionalRelatedItems": [Array],
    "className": "String",
    "duplicateLookupIndices": {Object},
    "errorCount": Number,
    "errors": [Array],
    "identificationAttempts": [Array],
    "identifierEntrySysId": "String",
    "info": [Array],
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloadIds": [Array],
    "operation": "String",
    "relatedItems": [Array],
    "relatedSysIds": [Array],
    "sysId": "String",
    "warnings": [Array]
  }
]
    Ergebnis.Elemente.ZusätzlicheZugehörigeElemente Liste der zugehörigen CIs (Tabellensuch-CI) aus der Tabelle „Teilweise Nutzlasten der CMDB-IRE“ [cmdb_ire_partial_payloads].

    Datentyp: Array von Objekten

    "additionalRelatedItems": [
  {
    "className": "String",
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloadIds": [Array],
    "sysId": "String"
  }
]
    Ergebnis.Elemente.ZusätzlicheZugehörigeElemente.Klassenname Der sys_class_name des zugehörigen Elements.

    Datentyp: Zeichenfolge
    Ergebnis.Elemente.ZusätzlicheZugehörigeElemente.Eingabeindizes Liste der Indexwerte für CIs aus dem Array des Anforderungstextes items, die diesem zugehörigen Element entsprechen.

    Datentyp: Array

    "inputIndices": [
    Number
]
    Ergebnis.Elemente.ZusätzlicheZugehörigeElemente.Marker Liste der Markerwerte zur internen Verwendung.

    Datentyp: Array

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

    Datentyp: Array

    "mergedPayloadIds": [
  "String"
]
    Ergebnis.Elemente.ZusätzlicheZugehörigeElemente.SysId Sys_id des zugehörigen CI.

    Datentyp: Zeichenfolge
    Ergebnis.Elemente.Klassenname Sys_class_name dieses CI.

    Datentyp: Zeichenfolge
    result.items.duplicateLookupIndices Objekt mit Arrays von Indexwerten für items.lookup -Array-Elemente, die auf dasselbe zugehörige CI verweisen.

    Der Array-Name gibt das erste Element aus dem Array des Anforderungstextes items.lookup an, das auf ein bestimmtes zugehöriges CI verweist. Seine Werte sind der Satz zusätzlicher Elemente aus demselben Array, die auf dasselbe zugehörige CI verweisen.

    Datentyp: Objekt

    Dieses Beispiel zeigt einen Fall, in dem das zweite Element im Array items.lookup auf dasselbe zugehörige CI verweist wie ein späteres Element aus diesem Array:

    "duplicateLookupIndices": [
  "2": [Array]
]
    Ergebnis.Elemente.Fehleranzahl Anzahl der bei der Verarbeitung dieses CI aufgetretenen Fehler.

    Datentyp: Zahl
    Ergebnis.Elemente.Fehler Liste der bei der Verarbeitung des CI aufgetretenen Fehler.

    Datentyp: Array von Objekten

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

    Datentyp: Zeichenfolge
    Ergebnis.Elemente.Fehlermeldung Bei der Verarbeitung dieses CI ist eine Fehlermeldung aufgetreten.

    Datentyp: Zeichenfolge
    Ergebnis.Elemente.Identifizierungsversuche Liste der Versuche, die unternommen wurden, um dieses CI zu identifizieren.
    Datentyp: Array von Objekten
    "identificationAttempts": [
  {
    "attemptResult": "String",
    "attributes": [Array],
    "hybridEntryCiAttributes": [Array],
    "identiferName": "String",
    "searchOnTable": [Array]
  }
]
    Ergebnis.Elemente.Identifizierungsversuche.VersuchErgebnis Ergebnis des CI-Identifizierungsversuchs.
    Mögliche Werte:
    • ABGEGLICHEN: Identifizierung erfolgreich. In der Identifier-Regeltabelle wurde ein eindeutiges CI gefunden, das genau mit den angegebenen Attributen übereinstimmt.
    • Multi_MATCH: Die Identifizierung ist mit einem Fehler fehlgeschlagen. In der Identifier-Regeltabelle wurden beim Abgleich mit den angegebenen Attributen doppelte CIs gefunden.
    • NO_MATCH: Identifizierung fehlgeschlagen. In der Identifier-Regeltabelle wurde kein CI gefunden, das den angegebenen Attributen entspricht.
    • ÜBERSPRUNGEN: Identifizierung nicht versucht. Die für die Suche in dieser Identifier-Regeltabelle erforderlichen Attribute wurden nicht angegeben, daher wurde die Regel nicht angewendet.

    Datentyp: Zeichenfolge
    Ergebnis.Elemente.Identifizierungsversuche.Attribute Liste der CI-Bezeichner-Eintragsattribute, die während dieses CI-Identifizierungsversuchs verwendet werden.

    Datentyp: Array

    Attributnamen und -typen hängen von den Anforderungstextdaten und dem verwendeten Bezeichner ab, z. B.:

    "attributes": [
  "serial_number": "String",
  "serial_number_type": "String",
]
    result.items.identificationAttempts.hybridEntryCiAttributes Liste der CI-Bezeichner-Eintragsattribute, die während dieses CI-Identifizierungsversuchs verwendet werden.

    Datentyp: Array

    Attributnamen und -typen hängen von den Anforderungstextdaten und dem verwendeten Bezeichner ab, z. B.:

    "hybridEntryCiAttributes": [
  "name": "String",
  "serial_number": "String"
]
    Ergebnis.Elemente.Identifizierungsversuche.Bezeichnername Identifier-Regel, die für diesen CI-Identifizierungsversuch verwendet wird.

    Datentyp: Zeichenfolge
    result.items.identificationVersuche.searchOnTable Name der Tabelle, die für diesen CI-Identifizierungsversuch durchsucht wurde.

    Datentyp: Zeichenfolge
    result.items.identifierEntrySysId Sys_id für die Identifier-Regel, die zum Identifizieren dieses CI verwendet wird.
    Bemerkbare Werte:
    • Unbekannt: Die Identifizierung dieses CI ist fehlgeschlagen. Details finden Sie unter errors.

    Datentyp: Zeichenfolge
    result.items.info Liste zusätzlicher Informationen zur Verarbeitung des Elements.

    Datentyp: Array von Objekten

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

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

    Datentyp: Zeichenfolge
    result.items.inputIndices Liste der Indexwerte für CIs aus dem Array des Anforderungstextes items, die diesem CI entsprechen.

    Datentyp: Array von Objekten

    "inputIndices": [
  {
    Number
  }
]
    Ergebnis.Elemente.Marker Liste der Markerwerte zur internen Verwendung.

    Datentyp: Array

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

    Datentyp: Array

    "mergedPayloadIds": [
  "String"
]
    Ergebnis.Elemente.Vorgang Für dieses CI durchgeführter Vorgang.
    Mögliche Werte:
    • LÖSCHEN: Ein vorhandenes CI wird aus der Zieltabelle entfernt.
    • EINFÜGEN: Das CI wird als neuer Datensatz in die Zieltabelle eingefügt.
    • NO_CHANGE: Für das CI wird kein Vorgang ausgeführt.
    • UPDATE: Ein vorhandenes CI in der Zieltabelle wird aktualisiert.
    • UPDATE_WITH_DOWNGRADE: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine allgemeinere Klasse (Vorgängerklasse) geändert.
    • UPDATE_WITH_SWITCH: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine andere Klasse geändert, die keine Vorgängerklasse oder untergeordnete Klasse ist.
    • UPDATE_WITH_UPGRADE: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine spezialisiertere Klasse (absteigende Klasse) geändert.

    Datentyp: Zeichenfolge
    Ergebnis.Elemente.ZugehörigeElemente Liste der zugehörigen CIs (Tabellensuch-CI) aus dem Array des Anforderungstextes items.lookup.

    Datentyp: Array von Objekten

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

    Datentyp: Zeichenfolge
    result.items.relatedItems.inputIndices Liste der Indexwerte für CIs und Suchelemente aus den Arrays items und items.lookup des Anforderungstexts, die diesem zugehörigen Element entsprechen.

    Datentyp: Array von Objekten

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

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

    Datentyp: Zahl
    Ergebnis.Elemente.ZugehörigeElemente.Marker Liste der Markerwerte zur internen Verwendung.

    Datentyp: Array

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

    Datentyp: Array

    "mergedPayloadIds": [
  "String"
]
    result.items.relatedSysIds Liste der sys_id-Werte für zugehörige Elemente (Tabellensuchelemente) aus dem Array des Anforderungstexts items.lookup.

    Datentyp: Array

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

    Datentyp: Zeichenfolge
    Ergebnis.Elemente.Warnungen Liste der Warnungen, die bei der Verarbeitung dieses CI aufgetreten sind.

    Datentyp: Array von Objekten

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    Ergebnis.Elemente.Warnungen.Fehler Typ der Warnung, die bei der Verarbeitung des CI aufgetreten ist.

    Datentyp: Zeichenfolge
    Ergebnis.Elemente.Warnungen.Nachricht Bei der Verarbeitung dieses CI ist eine Warnmeldung aufgetreten.

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

    Datentyp: Zeichenfolge
    result.relations Liste der abhängigen Beziehungs-CIs aus dem Array des Anforderungstextes relations.

    Datentyp: Array von Objekten

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

    Datentyp: Zeichenfolge
    Ergebnis.Beziehungen.Fehleranzahl Anzahl der Fehler, die bei der Verarbeitung dieses abhängigen Beziehungs-CI aufgetreten sind.

    Datentyp: Zahl
    Ergebnis.Beziehungen.Fehler Liste der Fehler, die bei der Verarbeitung dieses abhängigen Beziehungs-CI aufgetreten sind.

    Datentyp: Array von Objekten

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    Ergebnis.Beziehungen.Fehler.Fehler Typ des Fehlers, der bei der Verarbeitung dieser abhängigen Beziehungs-CI aufgetreten ist.

    Datentyp: Zeichenfolge
    Ergebnis.Beziehungen.Fehler.Meldung Fehlermeldung bei der Verarbeitung dieses abhängigen Beziehungs-CI.

    Datentyp: Zeichenfolge
    result.beziehungen.inputIndices Liste der Indexwerte für die abhängigen Beziehungs-CI-Objekte im Array des Anforderungstextes relations, die diesem abhängigen Beziehungs-CI entsprechen.

    Datentyp: Array

    "inputIndices": [
  Number
]
    Ergebnis.Beziehungen.Marker Liste der Markerwerte zur internen Verwendung.

    Datentyp: Array

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

    Datentyp: Array

    "mergedPayloadIds": [
  "String"
]
    Ergebnis.Beziehungen.Vorgang Für dieses abhängige Beziehungs-CI durchgeführte Operation.
    Mögliche Werte:
    • EINFÜGEN: Das abhängige Beziehungs-CI wurde als neuer Datensatz in die Zieltabelle eingefügt.
    • INSERT_AS_INCOMPLETE: Das abhängige Beziehungs-CI wies Fehler auf und wurde in die Tabelle „CMDB IRE Unvollständige Nutzlasten“ [cmdb_ire_incomplete_payloads] eingefügt.
    • INSERT_AS_partial: Das abhängige Beziehungs-CI wies Fehler auf und wurde in die Tabelle der teilweisen CMDB-IRE-Nutzlasten [cmdb_ire_partial_payloads] eingefügt.
    • NO_CHANGE: Für das abhängige Beziehungs-CI wurde kein Vorgang ausgeführt.
    • UPDATE: Ein vorhandenes abhängiges Beziehungs-CI in der Zieltabelle wurde aktualisiert.

    Datentyp: Zeichenfolge
    Ergebnis.Beziehungen.Warnungen Liste der Warnungen, die bei der Verarbeitung dieses abhängigen Beziehungs-CI aufgetreten sind.

    Datentyp: Array von Objekten

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    Ergebnis.Beziehungen.Warnungen.Fehler Typ der Warnung, die bei der Verarbeitung dieser abhängigen Beziehungs-CI aufgetreten ist.

    Datentyp: Zeichenfolge
    Ergebnis.Beziehungen.Warnungen.Nachricht Bei der Verarbeitung dieses abhängigen Beziehungs-CI ist eine Warnmeldung aufgetreten.

    Datentyp: Zeichenfolge

    cURL-Anforderung

    Senden Sie eine Teilnutzlast für ein Computer-CI.

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

    Die Antwort zeigt, dass die Nutzlast in die Tabelle „CMDB IRE Partielle Nutzlasten“ [cmdb_ire_partial_payloads] eingefügt wurde.

    {
  "result": {
    "items": [{
      "className": "cmdb_ci_computer",
      "operation": "INSERT_AS_PARTIAL",
      "sysId": "Unknown",
      "partialSysIds": ["1aec79151bb45010593876a61a4bcb28"],
      "identifierEntrySysId": "Unknown",
      "errors": [],
      "warnings": [{
        "error": "MISSING_MATCHING_ATTRIBUTES",
        "message": "In payload missing minimum set of input values for criterion (matching) attributes from identify rule for table [cmdb_ci_hardware]. Add these input values in payload item '{\"className\":\"cmdb_ci_computer\",\"values\":{\"discovery_source\":\"ServiceNow\",\"company\":\"My Company\",\"cpu_core_count\":\"6\",\"ram\":\"8192\",\"manufacturer\":\"DELL\"},\"sys_object_source_info\":{\"source_name\":\"ServiceNow\",\"source_native_key\":\"ncomputer3367\"},\"settings\":{},\"sys_ire_info\":{\"ire_received_time\":\"2020-05-14 20:14:51\"}}'"
      }],
      "identificationAttempts": [{
        "info": "sys_object_source NO_MATCH",
        "identifierName": "",
        "attemptResult": "NO_MATCH",
        "attributes": [],
        "hybridEntryCiAttributes": []
      }, {
        "identifierName": "Hardware Rule",
        "attemptResult": "SKIPPED",
        "attributes": ["serial_number", "serial_number_type"],
        "searchOnTable": "cmdb_serial_number",
        "hybridEntryCiAttributes": []
      }, {
        "identifierName": "Hardware Rule",
        "attemptResult": "SKIPPED",
        "attributes": ["serial_number"],
        "searchOnTable": "cmdb_ci_hardware",
        "hybridEntryCiAttributes": []
      }, {
        "identifierName": "Hardware Rule",
        "attemptResult": "SKIPPED",
        "attributes": ["name"],
        "searchOnTable": "cmdb_ci_hardware",
        "hybridEntryCiAttributes": []
      }, {
        "identifierName": "Hardware Rule",
        "attemptResult": "SKIPPED",
        "attributes": ["mac_address", "name"],
        "searchOnTable": "cmdb_ci_network_adapter",
        "hybridEntryCiAttributes": []
      }],
      "errorCount": 0,
      "markers": [],
      "warningCount": 1,
      "mergedPayloadIds": ["7ddcb9551bb45010593876a61a4bcb08"],
      "inputIndices": [0]
    }],
    "additionalCommittedItems": [],
    "relations": [],
    "additionalCommittedRelations": []
  }
}

    Senden Sie eine zweite Teilnutzlast, die die Beschreibung des Computer-CI abschließt, wobei die Option Erweiterte IRE für die Zusammenfassungsgenerierung aktiviert sein muss.

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

    In der Antwort wird angezeigt, dass das Computer-CI eingefügt wird, und eine Zusammenfassung der durchgeführten Vorgänge angezeigt.

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

    Identifizierung und Abgleich – POST /now/identifyreconcile/query

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

    Verwenden Sie diesen Endpunkt, um die Übermittlung einer Nutzlast (Anforderungstext) an den Endpunkt Identifizierung und Abgleich – POST /now/identifyreconcile 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

    URL mit Versionsnummer: /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 Quelle der CI-Informationen. Dies muss einer der Auswahlwerte sein, die für das Feld „discovery_source“ der Tabelle „Konfigurationselement“ [cmdb_ci] definiert sind.

    Datentyp: Zeichenfolge

    Standard: Fügen Sie die API-Nutzlast in die Tabelle der unvollständigen Nutzlasten ein.
    Tabelle : 15. Anforderungstextparameter (XML oder JSON)
    Name Beschreibung
    items Liste der zu erstellenden oder zu aktualisierenden CIs.

    Datentyp: Array von Objekten

    "items": [
  {
    "className": "String",
    "internal_id": "String",
    "lookup": [Array],
    "related": [Array],
    "settings": {Object},
    "sys_object_source_info": {Object},
    "values": {Object}
  }
]
    elemente.klassenname Erforderlich. Der sys_class_name (Klassen-/Tabellenname) des zu erstellenden oder zu aktualisierenden CI. Dieser Wert kann eine beliebige Tabelle CMDB sein, z. B. cmdb_ci_linux_server oder cmdb_ci_win_server.

    Datentyp: Zeichenfolge
    item.internal_id Eindeutiger Bezeichner für das Element in dieser Nutzlast Kann ein beliebiger Wert sein, muss aber innerhalb der Nutzlast eindeutig sein.

    Datentyp: Zeichenfolge
    Items.Suche Array von Objekten, in dem jedes Objekt einen suchbasierten Identifizierungsdatensatz beschreibt. Diese Datensätze werden verwendet, um das Konfigurationselement der obersten Ebene basierend auf einer Suchtabelle zu identifizieren, die einen Verweis zurück auf die Tabelle „Konfigurationselement“ [cmdb_ci] enthält.

    Datentyp: Array aus Objekten

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

    Datentyp: Zeichenfolge
    elemente.suche.internal_id Eindeutiger Bezeichner für den Suchdatensatz in dieser Nutzlast Kann ein beliebiger Wert sein, muss aber innerhalb der Nutzlast eindeutig sein.

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

    Datentyp: Objekt

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

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

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

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

    Datentyp: Zeichenfolge

    Format: JJJJ-MM-TT hh:mm:ss
    elemente.suche.werte Objekt, das Felder für dieses Suchelement als Name/Wert-Paare beschreibt, wobei der Name der Feldname ist.

    Datentyp: Objekt

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

    "values": {
  "ip_address": "String",
  "mac_address": "String",
  "serial_number": "String",
  "serial_number_type": "String",
  "valid": "String"
}
    elemente.zugehörig Array von Objekten, in dem jedes Objekt einen zu erstellenden oder zu aktualisierenden Elementdatensatz beschreibt, basierend auf einer zugehörigen Tabelle, die einen Verweis auf das identifizierte CI der obersten Ebene enthält. Regeln in der Tabelle „Zugehöriger Eintrag“ [cmdb_related_entry] definieren, welche Arten von Datensätzen dieses Array enthalten darf.

    Die zugehörige Tabelle kann die Konfigurationselement-Tabelle [cmdb_ci] erweitern, muss es aber nicht. Diese Datensätze werden nicht zum Identifizieren des Konfigurationselements verwendet.

    Datentyp: Array von Objekten

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

    Datentyp: Zeichenfolge
    elemente.zugehörig.internal_id Eindeutiger Bezeichner für das zugehörige Element in dieser Nutzlast Kann ein beliebiger Wert sein, muss aber innerhalb der Nutzlast eindeutig sein.

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

    Datentyp: Objekt

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

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

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

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

    Datentyp: Zeichenfolge

    Format: JJJJ-MM-TT hh:mm:ss
    elemente.zugehörige.Werte Objekt, das die für dieses zugehörige Element zu erstellenden oder zu aktualisierenden Felder als Name/Wert-Paare beschreibt, wobei der Name der Feldname ist. Für ein Referenzfeld muss der Wert die referenzierte sys_id sein.

    Datentyp: Objekt

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

    "values": {
  "host_name": "String",
  "ip_address": "String",
  "name": "String",
  "os_name": "String",
  "sys_class_name": "String"
}
    elemente.einstellungen Objekt mit Parametern, die festlegen, welche Arten von Updates zulässig sind.

    Datentyp: Objekt

    "settings": {
  "skipReclassificationRestrictionRules": Boolean,
  "updateWithoutDowngrade": Boolean,
  "updateWithoutSwitch": Boolean,
  "updateWithoutUpgrade": Boolean
}
    elemente.einstellungen.reklassifizierungsbeschränkungsregeln überspringen Kennzeichnung, die angibt, ob IRE die Ausführung der Regel zur Einschränkung der Neuklassifizierung überspringen soll, die der Klasse für das Nutzlastelement entspricht.
    Gültige Werte:
    • true: Ausführung der Regel überspringen.
    • „falsch“: Führen Sie die Regel aus.

    Standardwert: false
    elemente.einstellungen.updateOhneDowngrade Kennzeichnung, die angibt, ob Update und Downgrade für dieses CI zulässig sind.
    Gültige Werte:
    • „wahr“: Element wird aktualisiert, Downgrade ist jedoch nicht zulässig.
    • false: Sowohl Elementaktualisierungen als auch Downgrades sind zulässig.

    Datentyp: Boolesch

    Standardwert: false
    elemente.einstellungen.updateOhneSchalter Kennzeichnung, die angibt, ob dieses CI aktualisiert und seine Klasse gewechselt werden kann.
    Gültige Werte:
    • „wahr“: Element wird aktualisiert, aber Klassenwechsel ist nicht zulässig.
    • false: Sowohl Elementaktualisierungen als auch Klassenwechsel sind zulässig.

    Datentyp: Boolesch

    Standardwert: false
    elemente.einstellungen.updateOhneUpgrade Kennzeichnung, die angibt, ob Update und Upgrade für dieses CI zulässig sind.
    Gültige Werte:
    • „wahr“: Element wird aktualisiert, aber Upgrade ist nicht zulässig.
    • „falsch“: Sowohl Element-Updates als auch -Upgrades sind zulässig.

    Datentyp: Boolesch

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

    Datentyp: Objekt

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

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

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

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

    Datentyp: Zeichenfolge

    Format: JJJJ-MM-TT hh:mm:ss
    elemente.werte Objekt, das die für dieses CI zu erstellenden oder zu aktualisierenden Felder als Name/Wert-Paare beschreibt, wobei der Name der Feldname ist. Für ein Referenzfeld muss der Wert die referenzierte sys_id sein.

    Datentyp: Objekt

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

    "values": {
  "host_name": "String",
  "ip_address": "String",
  "name": "String",
  "os_name": "String",
  "sys_class_name": "String"
}
    referenceItems Referenzliste zwischen zwei Elementen in der Nutzlast.

    Datentyp: Array von Objekten

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

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

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

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

    Datentyp: Array von Objekten

    "relations": [
  {
    "child": Number,
    "parent": Number,
    "sys_rel_source_info": {Object},
    "type": "String"
  }
]
    "relations": [
  {
    "child_id": "String",
    "parent_id": "String",
    "sys_rel_source_info": {Object},
    "type": "String"
  }
]
    beziehungen.untergeordnetes element Ganzzahlindex des CI-Objekts im Array items, das das untergeordnete Element in der Beziehung darstellt.

    Datentyp: Zahl
    beziehungen.child_id internal_id des untergeordneten Elements in der Beziehung.

    Datentyp: Zeichenfolge
    beziehungen.übergeordnet Ganzzahlindex des CI-Objekts im Array items, das das übergeordnete Element in der Beziehung darstellt.

    Datentyp: Zahl
    beziehungen.parent_id internal_id des übergeordneten Elements in der Beziehung.

    Datentyp: Zeichenfolge
    beziehungen.sys_rel_source_info Informationen zur Discovery-Quelle für die Beziehung. Bei Nicht-Abhängigkeitsbeziehungen befinden sich diese Informationen in der Tabelle „Beziehungsquellen“ [sys_rel_source].

    Datentyp: Objekt

    "sys_rel_source_info": { 
  "source_name": "String", 
  "source_feed": "String" 
}
    beziehungen.sys_rel_source_info.quellenname Name der Discovery-Quelle.

    Standard: Discovery-Quelle, die im API-Methodenparameter übergeben wird.
    beziehungen.sys_rel_source_info.source_feed Beliebige Zeichenfolge, die eine Unter-Discovery/ein Unterscan innerhalb der Discovery-Quelle ist.

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

    Datentyp: Zeichenfolge

    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.

    Parameter des Antworttexts (JSON oder XML)

    Name Beschreibung
    Ergebnis Liste der von der Abfrage erzeugten Ergebnisse.

    Datentyp: Array

    "result": [
  "additionalCommittedItems": [Array],
  "additionalCommittedRelations": [Array],
  "items": [Array],
  "relations": [Array]
]
    result.additionalCommittedItems Liste der CIs, die nicht im Array des Anforderungstexts items zum Einfügen oder Aktualisieren enthalten sind.

    Datentyp: Array von Objekten

    "additionalCommittedItems": [
  {
    "className": "String",
    "errorCount": Number,
    "identificationAttempts": [Array],
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloads": [Array],
    "operation": "String",
    "sysId": "String"
  }
]
    result.additionalCommittedItems.className Der sys_class_name dieses zusätzlichen CI.

    Datentyp: Zeichenfolge
    Ergebnis.zusätzlichefestgelegteElemente.Fehleranzahl Anzahl der bei der Verarbeitung dieses zusätzlichen CI aufgetretenen Fehler.

    Datentyp: Zahl
    Ergebnis.zusätzlicheCommittedItems.errors Liste der Fehler, die bei der Verarbeitung dieses zusätzlichen CI aufgetreten sind.

    Datentyp: Array von Objekten

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

    Datentyp: Zeichenfolge
    Ergebnis.zusätzlicheCommittedItems.errors.message Fehlermeldung bei der Verarbeitung dieses zusätzlichen CI.

    Datentyp: Zeichenfolge
    Ergebnis.ZusätzlicheZusätzlicheElemente.Identifizierungsversuche Liste der Versuche, die unternommen wurden, um dieses zusätzliche CI zu identifizieren.
    Datentyp: Array von Objekten
    "identificationAttempts": [
  {
    "attemptResult": "String",
    "attributes": [Array],
    "hybridEntryCiAttributes": [Array],
    "identiferName": "String",
    "searchOnTable": [Array]
  }
]
    Ergebnis.zusätzlicheZusätzlicheElemente.Identifizierungsversuche.Versuchsergebnis Ergebnis dieses zusätzlichen CI-Identifizierungsversuchs.
    Mögliche Werte:
    • ABGEGLICHEN: Identifizierung erfolgreich. In der Identifier-Regeltabelle wurde ein eindeutiges CI gefunden, das genau mit den angegebenen Attributen übereinstimmt.
    • Multi_MATCH: Die Identifizierung ist mit einem Fehler fehlgeschlagen. In der Identifier-Regeltabelle wurden beim Abgleich mit den angegebenen Attributen doppelte CIs gefunden.
    • NO_MATCH: Identifizierung fehlgeschlagen. In der Identifier-Regeltabelle wurde kein CI gefunden, das den angegebenen Attributen entspricht.
    • ÜBERSPRUNGEN: Identifizierung nicht versucht. Die für die Suche in dieser Identifier-Regeltabelle erforderlichen Attribute wurden nicht angegeben, daher wurde die Regel nicht angewendet.

    Datentyp: Zeichenfolge
    Ergebnis.zusätzlicheZusätzlicheElemente.Identifizierungsversuche.Attribute Array von CI-Identifier-Eintragsattributen, die bei diesem zusätzlichen CI-Identifizierungsversuch verwendet werden.

    Datentyp: Array

    Attributnamen und -typen hängen von den Anforderungstextdaten und dem verwendeten Bezeichner ab, z. B.:

    "attributes": [
  "serial_number": "String",
  "serial_number_type": "String"
]
    Ergebnis.zusätzlicheCommittedItems.IdentificationAttempts.HybridEntryCiAttributes Liste der CI-Bezeichner-Eintragsattribute, die bei diesem zusätzlichen CI-Identifizierungsversuch verwendet werden.

    Datentyp: Array

    Attributnamen und -typen hängen von den Anforderungstextdaten und dem verwendeten Bezeichner ab, z. B.:

    "hybridEntryCiAttributes": [
  "name": "String",
  "serial_number": "String"
]
    Ergebnis.zusätzlichefestgelegteElemente.Identifizierungsversuche.Bezeichnername Identifier-Regel, die für diesen zusätzlichen CI-Identifizierungsversuch verwendet wird.

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

    Datentyp: Zeichenfolge
    result.additionalCommittedItems.identifierEntrySysId Sys_id für die Identifier-Regel, die zum Identifizieren dieses zusätzlichen CI verwendet wird.
    Bemerkbare Werte:
    • Unbekannt: Die Identifizierung dieses zusätzlichen CI ist fehlgeschlagen. Details siehe errors.

    Datentyp: Zeichenfolge
    result.additionalCommittedItems.inputIndices Liste der Indexwerte für CIs aus dem Array des Anforderungstextes items, die diesem zusätzlichen CI entsprechen.

    Datentyp: Array von Objekten

    "inputIndices": [
  {
    Number
  }
]
    Ergebnis.zusätzlicheCommittedItems.Marker Liste der Markerwerte zur internen Verwendung.

    Datentyp: Array

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

    Datentyp: Array

    "mergedPayloadIds": [
  "String"
]
    result.additionalCommittedItems.operation Für dieses zusätzliche CI durchgeführter Vorgang.
    Mögliche Werte:
    • LÖSCHEN: Ein vorhandenes CI wird aus der Zieltabelle entfernt.
    • EINFÜGEN: Das zusätzliche CI wird als neuer Datensatz in die Zieltabelle eingefügt.
    • NO_CHANGE: Für das zusätzliche CI wird kein Vorgang ausgeführt.
    • UPDATE: Ein vorhandenes CI in der Zieltabelle wird aktualisiert.
    • UPDATE_WITH_DOWNGRADE: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine allgemeinere Klasse (Vorgängerklasse) geändert.
    • UPDATE_WITH_SWITCH: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine andere Klasse geändert, die keine Vorgängerklasse oder untergeordnete Klasse ist.
    • UPDATE_WITH_UPGRADE: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine spezialisiertere Klasse (absteigende Klasse) geändert.

    Datentyp: Zeichenfolge
    result.additionalCommittedItems.sysId Sys_id für dieses zusätzliche CI durch Identifizierung gefunden.

    Bemerkbare Werte: Unbekannt: Die Identifizierung dieses zusätzlichen CI ist fehlgeschlagen. Details siehe errors.

    Datentyp: Zeichenfolge
    Ergebnis.zusätzlicheCommittedItems.Warnungen Liste der Warnungen, die bei der Verarbeitung dieses zusätzlichen CI aufgetreten sind.

    Datentyp: Array von Objekten

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    Ergebnis.zusätzlicheCommittedItems.Warnungen.Fehler Typ der Warnung, die bei der Verarbeitung dieses zusätzlichen CI aufgetreten ist.

    Datentyp: Zeichenfolge
    Ergebnis.zusätzlicheCommittedItems.Warnungen.Nachricht Bei der Verarbeitung dieses zusätzlichen CI ist eine Warnmeldung aufgetreten.

    Datentyp: Zeichenfolge
    result.additionalCommittedRelations Liste der abhängigen Beziehungs-CIs, die nicht in der Liste des Anforderungstextes relations zum Einfügen oder Aktualisieren enthalten sind.

    Datentyp: Array von Objekten

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

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

    Datentyp: Zahl
    Ergebnis.zusätzlicheCommittedRelations.errors Liste der Fehler, die bei der Verarbeitung dieses zusätzlichen CI für abhängige Beziehungen aufgetreten sind.

    Datentyp: Array von Objekten

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

    Datentyp: Zeichenfolge
    Ergebnis.zusätzlicheBestätigteBeziehungen.Fehler.Nachricht Fehlermeldung beim Verarbeiten dieses zusätzlichen abhängigen Beziehungs-CI.

    Datentyp: Zeichenfolge
    result.additionalCommittedRelations.inputIndexes Liste der Indexwerte für abhängige Beziehungs-CI-Objekte im Array des Anforderungstexts relations, die diesem zusätzlichen abhängigen Beziehungs-CI entsprechen.

    Datentyp: Array

    "inputIndices": [
  Number
]
    result.additionalCommittedRelations.markers Liste der Markerwerte zur internen Verwendung.

    Datentyp: Array

    "markers": []
    result.additionalCommittedRelations.mergedPayloadIds Liste der sys_id-Werte für Teilnutzlasten aus der Tabelle „Teilliche CMDB-IRE-Nutzlasten“ [cmdb_ire_partial_payloads], die während der Verarbeitung dieses zusätzlichen abhängigen Beziehungs-CI zusammengeführt wurden.

    Datentyp: Array

    "mergedPayloadIds": [
  "String"
]
    result.additionalCommittedRelations.operation Für dieses zusätzliche abhängige Beziehungs-CI durchgeführte Operation.
    Mögliche Werte:
    • INSERT: Das CI der abhängigen Beziehung wird als neuer Datensatz in die Zieltabelle eingefügt.
    • INSERT_AS_INCOMPLETE: Das abhängige Beziehungs-CI wies Fehler auf und wird in die Tabelle „CMDB IRE Unvollständige Nutzlasten“ [cmdb_ire_incomplete_payloads] eingefügt.
    • INSERT_AS_partial: Das abhängige Beziehungs-CI wies Fehler auf und wird in die Tabelle der teilweisen CMDB-IRE-Nutzlasten [cmdb_ire_partial_payloads] eingefügt.
    • NO_CHANGE: Für das abhängige Beziehungs-CI wird kein Vorgang ausgeführt.
    • UPDATE: Ein vorhandenes abhängiges Beziehungs-CI in der Zieltabelle wird aktualisiert.

    Datentyp: Zeichenfolge
    result.items Liste der CIs, die im Array des Anforderungstexts items enthalten sind.

    Datentyp: Array von Objekten

    "items": [
  {
    "additionalRelatedItems": [Array],
    "className": "String",
    "duplicateLookupIndices": {Object},
    "errorCount": Number,
    "errors": [Array],
    "identificationAttempts": [Array],
    "identifierEntrySysId": "String",
    "info": [Array],
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloadIds": [Array],
    "operation": "String",
    "relatedItems": [Array],
    "relatedSysIds": [Array],
    "sysId": "String",
    "warnings": [Array]
  }
]
    Ergebnis.Elemente.ZusätzlicheZugehörigeElemente Liste der zugehörigen CIs (Tabellensuch-CI) aus der Tabelle „Teilweise Nutzlasten der CMDB-IRE“ [cmdb_ire_partial_payloads].

    Datentyp: Array von Objekten

    "additionalRelatedItems": [
  {
    "className": "String",
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloadIds": [Array],
    "sysId": "String"
  }
]
    Ergebnis.Elemente.ZusätzlicheZugehörigeElemente.Klassenname Der sys_class_name des zugehörigen Elements.

    Datentyp: Zeichenfolge
    Ergebnis.Elemente.ZusätzlicheZugehörigeElemente.Eingabeindizes Liste der Indexwerte für CIs aus dem Array des Anforderungstextes items, die diesem zugehörigen Element entsprechen.

    Datentyp: Array

    "inputIndices": [
    Number
]
    Ergebnis.Elemente.ZusätzlicheZugehörigeElemente.Marker Liste der Markerwerte zur internen Verwendung.

    Datentyp: Array

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

    Datentyp: Array

    "mergedPayloadIds": [
  "String"
]
    Ergebnis.Elemente.ZusätzlicheZugehörigeElemente.SysId Sys_id des zugehörigen CI.

    Datentyp: Zeichenfolge
    Ergebnis.Elemente.Klassenname Sys_class_name dieses CI.

    Datentyp: Zeichenfolge
    result.items.duplicateLookupIndices Objekt mit Arrays von Indexwerten für items.lookup -Array-Elemente, die auf dasselbe zugehörige CI verweisen.

    Der Array-Name gibt das erste Element aus dem Array des Anforderungstextes items.lookup an, das auf ein bestimmtes zugehöriges CI verweist. Seine Werte sind der Satz zusätzlicher Elemente aus demselben Array, die auf dasselbe zugehörige CI verweisen.

    Datentyp: Objekt

    Dieses Beispiel zeigt einen Fall, in dem das zweite Element im Array items.lookup auf dasselbe zugehörige CI verweist wie ein späteres Element aus diesem Array:

    "duplicateLookupIndices": [
  "2": [Array]
]
    Ergebnis.Elemente.Fehleranzahl Anzahl der bei der Verarbeitung dieses CI aufgetretenen Fehler.

    Datentyp: Zahl
    Ergebnis.Elemente.Fehler Liste der bei der Verarbeitung des CI aufgetretenen Fehler.

    Datentyp: Array von Objekten

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

    Datentyp: Zeichenfolge
    Ergebnis.Elemente.Fehlermeldung Bei der Verarbeitung dieses CI ist eine Fehlermeldung aufgetreten.

    Datentyp: Zeichenfolge
    Ergebnis.Elemente.Identifizierungsversuche Liste der Versuche, die unternommen wurden, um dieses CI zu identifizieren.
    Datentyp: Array von Objekten
    "identificationAttempts": [
  {
    "attemptResult": "String",
    "attributes": [Array],
    "hybridEntryCiAttributes": [Array],
    "identiferName": "String",
    "searchOnTable": [Array]
  }
]
    Ergebnis.Elemente.Identifizierungsversuche.VersuchErgebnis Ergebnis des CI-Identifizierungsversuchs.
    Mögliche Werte:
    • ABGEGLICHEN: Identifizierung erfolgreich. In der Identifier-Regeltabelle wurde ein eindeutiges CI gefunden, das genau mit den angegebenen Attributen übereinstimmt.
    • Multi_MATCH: Die Identifizierung ist mit einem Fehler fehlgeschlagen. In der Identifier-Regeltabelle wurden beim Abgleich mit den angegebenen Attributen doppelte CIs gefunden.
    • NO_MATCH: Identifizierung fehlgeschlagen. In der Identifier-Regeltabelle wurde kein CI gefunden, das den angegebenen Attributen entspricht.
    • ÜBERSPRUNGEN: Identifizierung nicht versucht. Die für die Suche in dieser Identifier-Regeltabelle erforderlichen Attribute wurden nicht angegeben, daher wurde die Regel nicht angewendet.

    Datentyp: Zeichenfolge
    Ergebnis.Elemente.Identifizierungsversuche.Attribute Liste der CI-Bezeichner-Eintragsattribute, die während dieses CI-Identifizierungsversuchs verwendet werden.

    Datentyp: Array

    Attributnamen und -typen hängen von den Anforderungstextdaten und dem verwendeten Bezeichner ab, z. B.:

    "attributes": [
  "serial_number": "String",
  "serial_number_type": "String",
]
    result.items.identificationAttempts.hybridEntryCiAttributes Liste der CI-Bezeichner-Eintragsattribute, die während dieses CI-Identifizierungsversuchs verwendet werden.

    Datentyp: Array

    Attributnamen und -typen hängen von den Anforderungstextdaten und dem verwendeten Bezeichner ab, z. B.:

    "hybridEntryCiAttributes": [
  "name": "String",
  "serial_number": "String"
]
    Ergebnis.Elemente.Identifizierungsversuche.Bezeichnername Identifier-Regel, die für diesen CI-Identifizierungsversuch verwendet wird.

    Datentyp: Zeichenfolge
    result.items.identificationVersuche.searchOnTable Name der Tabelle, die für diesen CI-Identifizierungsversuch durchsucht wurde.

    Datentyp: Zeichenfolge
    result.items.identifierEntrySysId Sys_id für die Identifier-Regel, die zum Identifizieren dieses CI verwendet wird.
    Bemerkbare Werte:
    • Unbekannt: Die Identifizierung dieses CI ist fehlgeschlagen. Details finden Sie unter errors.

    Datentyp: Zeichenfolge
    result.items.info Liste zusätzlicher Informationen zur Verarbeitung des Elements.

    Datentyp: Array von Objekten

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

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

    Datentyp: Zeichenfolge
    result.items.inputIndices Liste der Indexwerte für CIs aus dem Array des Anforderungstextes items, die diesem CI entsprechen.

    Datentyp: Array von Objekten

    "inputIndices": [
  {
    Number
  }
]
    Ergebnis.Elemente.Marker Liste der Markerwerte zur internen Verwendung.

    Datentyp: Array

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

    Datentyp: Array

    "mergedPayloadIds": [
  "String"
]
    Ergebnis.Elemente.Vorgang Für dieses CI durchgeführter Vorgang.
    Mögliche Werte:
    • LÖSCHEN: Ein vorhandenes CI wird aus der Zieltabelle entfernt.
    • EINFÜGEN: Das CI wird als neuer Datensatz in die Zieltabelle eingefügt.
    • NO_CHANGE: Für das CI wird kein Vorgang ausgeführt.
    • UPDATE: Ein vorhandenes CI in der Zieltabelle wird aktualisiert.
    • UPDATE_WITH_DOWNGRADE: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine allgemeinere Klasse (Vorgängerklasse) geändert.
    • UPDATE_WITH_SWITCH: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine andere Klasse geändert, die keine Vorgängerklasse oder untergeordnete Klasse ist.
    • UPDATE_WITH_UPGRADE: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine spezialisiertere Klasse (absteigende Klasse) geändert.

    Datentyp: Zeichenfolge
    Ergebnis.Elemente.ZugehörigeElemente Liste der zugehörigen CIs (Tabellensuch-CI) aus dem Array des Anforderungstextes items.lookup.

    Datentyp: Array von Objekten

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

    Datentyp: Zeichenfolge
    result.items.relatedItems.inputIndices Liste der Indexwerte für CIs und Suchelemente aus den Arrays items und items.lookup des Anforderungstexts, die diesem zugehörigen Element entsprechen.

    Datentyp: Array von Objekten

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

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

    Datentyp: Zahl
    Ergebnis.Elemente.ZugehörigeElemente.Marker Liste der Markerwerte zur internen Verwendung.

    Datentyp: Array

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

    Datentyp: Array

    "mergedPayloadIds": [
  "String"
]
    result.items.relatedSysIds Liste der sys_id-Werte für zugehörige Elemente (Tabellensuchelemente) aus dem Array des Anforderungstexts items.lookup.

    Datentyp: Array

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

    Datentyp: Zeichenfolge
    Ergebnis.Elemente.Warnungen Liste der Warnungen, die bei der Verarbeitung dieses CI aufgetreten sind.

    Datentyp: Array von Objekten

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    Ergebnis.Elemente.Warnungen.Fehler Typ der Warnung, die bei der Verarbeitung des CI aufgetreten ist.

    Datentyp: Zeichenfolge
    Ergebnis.Elemente.Warnungen.Nachricht Bei der Verarbeitung dieses CI ist eine Warnmeldung aufgetreten.

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

    Datentyp: Zeichenfolge
    result.relations Liste der abhängigen Beziehungs-CIs aus dem Array des Anforderungstextes relations.

    Datentyp: Array von Objekten

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

    Datentyp: Zeichenfolge
    Ergebnis.Beziehungen.Fehleranzahl Anzahl der Fehler, die bei der Verarbeitung dieses abhängigen Beziehungs-CI aufgetreten sind.

    Datentyp: Zahl
    Ergebnis.Beziehungen.Fehler Liste der Fehler, die bei der Verarbeitung dieses abhängigen Beziehungs-CI aufgetreten sind.

    Datentyp: Array von Objekten

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    Ergebnis.Beziehungen.Fehler.Fehler Typ des Fehlers, der bei der Verarbeitung dieser abhängigen Beziehungs-CI aufgetreten ist.

    Datentyp: Zeichenfolge
    Ergebnis.Beziehungen.Fehler.Meldung Fehlermeldung bei der Verarbeitung dieses abhängigen Beziehungs-CI.

    Datentyp: Zeichenfolge
    result.beziehungen.inputIndices Liste der Indexwerte für die abhängigen Beziehungs-CI-Objekte im Array des Anforderungstextes relations, die diesem abhängigen Beziehungs-CI entsprechen.

    Datentyp: Array

    "inputIndices": [
  Number
]
    Ergebnis.Beziehungen.Marker Liste der Markerwerte zur internen Verwendung.

    Datentyp: Array

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

    Datentyp: Array

    "mergedPayloadIds": [
  "String"
]
    Ergebnis.Beziehungen.Vorgang Für dieses abhängige Beziehungs-CI durchgeführte Operation.
    Mögliche Werte:
    • EINFÜGEN: Das abhängige Beziehungs-CI wurde als neuer Datensatz in die Zieltabelle eingefügt.
    • INSERT_AS_INCOMPLETE: Das abhängige Beziehungs-CI wies Fehler auf und wurde in die Tabelle „CMDB IRE Unvollständige Nutzlasten“ [cmdb_ire_incomplete_payloads] eingefügt.
    • INSERT_AS_partial: Das abhängige Beziehungs-CI wies Fehler auf und wurde in die Tabelle der teilweisen CMDB-IRE-Nutzlasten [cmdb_ire_partial_payloads] eingefügt.
    • NO_CHANGE: Für das abhängige Beziehungs-CI wurde kein Vorgang ausgeführt.
    • UPDATE: Ein vorhandenes abhängiges Beziehungs-CI in der Zieltabelle wurde aktualisiert.

    Datentyp: Zeichenfolge
    Ergebnis.Beziehungen.Warnungen Liste der Warnungen, die bei der Verarbeitung dieses abhängigen Beziehungs-CI aufgetreten sind.

    Datentyp: Array von Objekten

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    Ergebnis.Beziehungen.Warnungen.Fehler Typ der Warnung, die bei der Verarbeitung dieser abhängigen Beziehungs-CI aufgetreten ist.

    Datentyp: Zeichenfolge
    Ergebnis.Beziehungen.Warnungen.Nachricht Bei der Verarbeitung dieses abhängigen Beziehungs-CI ist eine Warnmeldung aufgetreten.

    Datentyp: Zeichenfolge

    cURL-Anforderung

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

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

    Das Linux-Server-CI wird über eine Hardwareregelsuche nach seinem Namen in der Hardwaretabelle [cmdb_ci_hardware] identifiziert und als Aktualisierung eines vorhandenen CI in der Linux-Servertabelle [cmdb_ci_linux_server] verarbeitet. Der IP-Switch wird ebenfalls über eine Hardwareregelsuche nach seinem Namen in der Hardware-Tabelle identifiziert und aktualisiert ein vorhandenes CI in der IP-Switch-Tabelle [cmdb_ci_ip_Switch]. Abschließend wird die IP-Verbindungsbeziehung zwischen Server und Switch als neuer Datensatz in die CI-Beziehungstabelle [cmdb_rel_ci] eingefügt.

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

    Identifizierung und Abgleich – POST /now/identifyreconcile/queryEnhanced

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

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

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

    URL-Format

    URL mit Versionsnummer: /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 für die Anforderung angewendet werden.

    Um die Standardwerte für die Optionen für teilweise Nutzlasten, teilweise Commits, deduplizierte Nutzlasten und das Generieren einer Zusammenfassung für erweiterte IRE zu überschreiben:

    Partial_payloads:false,partial_commits:false,deduplizierte_nutzlasten:falsch,generate_summary:wahr
    Hinweis:
    Standardmäßig oder wenn partial_payloads auf „true“ festgelegt ist, sind sowohl partial_commits als auch deduplicate_payloads aktiviert, auch wenn sie auf „false“ festgelegt sind, da diese Funktionen für die Funktionalität von Teilnutzlasten wichtig sind.

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

    Gültige Werte für jedes Name-Wert-Paar:
    • true: Aktivieren Sie diese Option für die erweiterte IRE.
    • „falsch“: Deaktivieren Sie diese erweiterte IRE-Option.

    Datentyp: Zeichenfolge
    sysparm_data_source Quelle der CI-Informationen. Dies muss einer der Auswahlwerte sein, die für das Feld „discovery_source“ der Tabelle „Konfigurationselement“ [cmdb_ci] definiert sind.

    Datentyp: Zeichenfolge

    Standard: Fügen Sie die API-Nutzlast in die Tabelle der unvollständigen Nutzlasten ein.
    Tabelle : 21. Anforderungstextparameter (XML oder JSON)
    Name Beschreibung
    items Liste der zu erstellenden oder zu aktualisierenden CIs.

    Datentyp: Array von Objekten

    "items": [
  {
    "className": "String",
    "internal_id": "String",
    "lookup": [Array],
    "related": [Array],
    "settings": {Object},
    "sys_object_source_info": {Object},
    "values": {Object}
  }
]
    elemente.klassenname Erforderlich. Der sys_class_name (Klassen-/Tabellenname) des zu erstellenden oder zu aktualisierenden CI. Dieser Wert kann eine beliebige Tabelle CMDB sein, z. B. cmdb_ci_linux_server oder cmdb_ci_win_server.

    Datentyp: Zeichenfolge
    item.internal_id Eindeutiger Bezeichner für das Element in dieser Nutzlast Kann ein beliebiger Wert sein, muss aber innerhalb der Nutzlast eindeutig sein.

    Datentyp: Zeichenfolge
    Items.Suche Array von Objekten, in dem jedes Objekt einen suchbasierten Identifizierungsdatensatz beschreibt. Diese Datensätze werden verwendet, um das Konfigurationselement der obersten Ebene basierend auf einer Suchtabelle zu identifizieren, die einen Verweis zurück auf die Tabelle „Konfigurationselement“ [cmdb_ci] enthält.

    Datentyp: Array aus Objekten

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

    Datentyp: Zeichenfolge
    elemente.suche.internal_id Eindeutiger Bezeichner für den Suchdatensatz in dieser Nutzlast Kann ein beliebiger Wert sein, muss aber innerhalb der Nutzlast eindeutig sein.

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

    Datentyp: Objekt

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

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

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

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

    Datentyp: Zeichenfolge

    Format: JJJJ-MM-TT hh:mm:ss
    elemente.suche.werte Objekt, das Felder für dieses Suchelement als Name/Wert-Paare beschreibt, wobei der Name der Feldname ist.

    Datentyp: Objekt

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

    "values": {
  "ip_address": "String",
  "mac_address": "String",
  "serial_number": "String",
  "serial_number_type": "String",
  "valid": "String"
}
    elemente.zugehörig Array von Objekten, in dem jedes Objekt einen zu erstellenden oder zu aktualisierenden Elementdatensatz beschreibt, basierend auf einer zugehörigen Tabelle, die einen Verweis auf das identifizierte CI der obersten Ebene enthält. Regeln in der Tabelle „Zugehöriger Eintrag“ [cmdb_related_entry] definieren, welche Arten von Datensätzen dieses Array enthalten darf.

    Die zugehörige Tabelle kann die Konfigurationselement-Tabelle [cmdb_ci] erweitern, muss es aber nicht. Diese Datensätze werden nicht zum Identifizieren des Konfigurationselements verwendet.

    Datentyp: Array von Objekten

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

    Datentyp: Zeichenfolge
    elemente.zugehörig.internal_id Eindeutiger Bezeichner für das zugehörige Element in dieser Nutzlast Kann ein beliebiger Wert sein, muss aber innerhalb der Nutzlast eindeutig sein.

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

    Datentyp: Objekt

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

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

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

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

    Datentyp: Zeichenfolge

    Format: JJJJ-MM-TT hh:mm:ss
    elemente.zugehörige.Werte Objekt, das die für dieses zugehörige Element zu erstellenden oder zu aktualisierenden Felder als Name/Wert-Paare beschreibt, wobei der Name der Feldname ist. Für ein Referenzfeld muss der Wert die referenzierte sys_id sein.

    Datentyp: Objekt

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

    "values": {
  "host_name": "String",
  "ip_address": "String",
  "name": "String",
  "os_name": "String",
  "sys_class_name": "String"
}
    elemente.einstellungen Objekt mit Parametern, die festlegen, welche Arten von Updates zulässig sind.

    Datentyp: Objekt

    "settings": {
  "skipReclassificationRestrictionRules": Boolean,
  "updateWithoutDowngrade": Boolean,
  "updateWithoutSwitch": Boolean,
  "updateWithoutUpgrade": Boolean
}
    elemente.einstellungen.reklassifizierungsbeschränkungsregeln überspringen Kennzeichnung, die angibt, ob IRE die Ausführung der Regel zur Einschränkung der Neuklassifizierung überspringen soll, die der Klasse für das Nutzlastelement entspricht.
    Gültige Werte:
    • true: Ausführung der Regel überspringen.
    • „falsch“: Führen Sie die Regel aus.

    Standardwert: false
    elemente.einstellungen.updateOhneDowngrade Kennzeichnung, die angibt, ob Update und Downgrade für dieses CI zulässig sind.
    Gültige Werte:
    • „wahr“: Element wird aktualisiert, Downgrade ist jedoch nicht zulässig.
    • false: Sowohl Elementaktualisierungen als auch Downgrades sind zulässig.

    Datentyp: Boolesch

    Standardwert: false
    elemente.einstellungen.updateOhneSchalter Kennzeichnung, die angibt, ob dieses CI aktualisiert und seine Klasse gewechselt werden kann.
    Gültige Werte:
    • „wahr“: Element wird aktualisiert, aber Klassenwechsel ist nicht zulässig.
    • false: Sowohl Elementaktualisierungen als auch Klassenwechsel sind zulässig.

    Datentyp: Boolesch

    Standardwert: false
    elemente.einstellungen.updateOhneUpgrade Kennzeichnung, die angibt, ob Update und Upgrade für dieses CI zulässig sind.
    Gültige Werte:
    • „wahr“: Element wird aktualisiert, aber Upgrade ist nicht zulässig.
    • „falsch“: Sowohl Element-Updates als auch -Upgrades sind zulässig.

    Datentyp: Boolesch

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

    Datentyp: Objekt

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

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

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

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

    Datentyp: Zeichenfolge

    Format: JJJJ-MM-TT hh:mm:ss
    elemente.werte Objekt, das die für dieses CI zu erstellenden oder zu aktualisierenden Felder als Name/Wert-Paare beschreibt, wobei der Name der Feldname ist. Für ein Referenzfeld muss der Wert die referenzierte sys_id sein.

    Datentyp: Objekt

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

    "values": {
  "host_name": "String",
  "ip_address": "String",
  "name": "String",
  "os_name": "String",
  "sys_class_name": "String"
}
    referenceItems Referenzliste zwischen zwei Elementen in der Nutzlast.

    Datentyp: Array von Objekten

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

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

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

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

    Datentyp: Array von Objekten

    "relations": [
  {
    "child": Number,
    "parent": Number,
    "sys_rel_source_info": {Object},
    "type": "String"
  }
]
    "relations": [
  {
    "child_id": "String",
    "parent_id": "String",
    "sys_rel_source_info": {Object},
    "type": "String"
  }
]
    beziehungen.untergeordnetes element Ganzzahlindex des CI-Objekts im Array items, das das untergeordnete Element in der Beziehung darstellt.

    Datentyp: Zahl
    beziehungen.child_id internal_id des untergeordneten Elements in der Beziehung.

    Datentyp: Zeichenfolge
    beziehungen.übergeordnet Ganzzahlindex des CI-Objekts im Array items, das das übergeordnete Element in der Beziehung darstellt.

    Datentyp: Zahl
    beziehungen.parent_id internal_id des übergeordneten Elements in der Beziehung.

    Datentyp: Zeichenfolge
    beziehungen.sys_rel_source_info Informationen zur Discovery-Quelle für die Beziehung. Bei Nicht-Abhängigkeitsbeziehungen befinden sich diese Informationen in der Tabelle „Beziehungsquellen“ [sys_rel_source].

    Datentyp: Objekt

    "sys_rel_source_info": { 
  "source_name": "String", 
  "source_feed": "String" 
}
    beziehungen.sys_rel_source_info.quellenname Name der Discovery-Quelle.

    Standard: Discovery-Quelle, die im API-Methodenparameter übergeben wird.
    beziehungen.sys_rel_source_info.source_feed Beliebige Zeichenfolge, die eine Unter-Discovery/ein Unterscan innerhalb der Discovery-Quelle ist.

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

    Datentyp: Zeichenfolge

    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.

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

    Wenn Sie beispielsweise den Parameter options des Typs „ partial “ angeben, wird beispielsweise ein Statuscode 500 mit „Block [partial] is not a valid Eintrag“ im Nachrichtendetail angezeigt.

    Parameter des Antworttexts (JSON oder XML)

    Name Beschreibung
    Ergebnis Liste der von der Abfrage erzeugten Ergebnisse.

    Datentyp: Array

    "result": [
  "additionalCommittedItems": [Array],
  "additionalCommittedRelations": [Array],
  "items": [Array],
  "relations": [Array]
]
    result.additionalCommittedItems Liste der CIs, die nicht im Array des Anforderungstexts items zum Einfügen oder Aktualisieren enthalten sind.

    Datentyp: Array von Objekten

    "additionalCommittedItems": [
  {
    "className": "String",
    "errorCount": Number,
    "identificationAttempts": [Array],
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloads": [Array],
    "operation": "String",
    "sysId": "String"
  }
]
    result.additionalCommittedItems.className Der sys_class_name dieses zusätzlichen CI.

    Datentyp: Zeichenfolge
    Ergebnis.zusätzlichefestgelegteElemente.Fehleranzahl Anzahl der bei der Verarbeitung dieses zusätzlichen CI aufgetretenen Fehler.

    Datentyp: Zahl
    Ergebnis.zusätzlicheCommittedItems.errors Liste der Fehler, die bei der Verarbeitung dieses zusätzlichen CI aufgetreten sind.

    Datentyp: Array von Objekten

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

    Datentyp: Zeichenfolge
    Ergebnis.zusätzlicheCommittedItems.errors.message Fehlermeldung bei der Verarbeitung dieses zusätzlichen CI.

    Datentyp: Zeichenfolge
    Ergebnis.ZusätzlicheZusätzlicheElemente.Identifizierungsversuche Liste der Versuche, die unternommen wurden, um dieses zusätzliche CI zu identifizieren.
    Datentyp: Array von Objekten
    "identificationAttempts": [
  {
    "attemptResult": "String",
    "attributes": [Array],
    "hybridEntryCiAttributes": [Array],
    "identiferName": "String",
    "searchOnTable": [Array]
  }
]
    Ergebnis.zusätzlicheZusätzlicheElemente.Identifizierungsversuche.Versuchsergebnis Ergebnis dieses zusätzlichen CI-Identifizierungsversuchs.
    Mögliche Werte:
    • ABGEGLICHEN: Identifizierung erfolgreich. In der Identifier-Regeltabelle wurde ein eindeutiges CI gefunden, das genau mit den angegebenen Attributen übereinstimmt.
    • Multi_MATCH: Die Identifizierung ist mit einem Fehler fehlgeschlagen. In der Identifier-Regeltabelle wurden beim Abgleich mit den angegebenen Attributen doppelte CIs gefunden.
    • NO_MATCH: Identifizierung fehlgeschlagen. In der Identifier-Regeltabelle wurde kein CI gefunden, das den angegebenen Attributen entspricht.
    • ÜBERSPRUNGEN: Identifizierung nicht versucht. Die für die Suche in dieser Identifier-Regeltabelle erforderlichen Attribute wurden nicht angegeben, daher wurde die Regel nicht angewendet.

    Datentyp: Zeichenfolge
    Ergebnis.zusätzlicheZusätzlicheElemente.Identifizierungsversuche.Attribute Array von CI-Identifier-Eintragsattributen, die bei diesem zusätzlichen CI-Identifizierungsversuch verwendet werden.

    Datentyp: Array

    Attributnamen und -typen hängen von den Anforderungstextdaten und dem verwendeten Bezeichner ab, z. B.:

    "attributes": [
  "serial_number": "String",
  "serial_number_type": "String"
]
    Ergebnis.zusätzlicheCommittedItems.IdentificationAttempts.HybridEntryCiAttributes Liste der CI-Bezeichner-Eintragsattribute, die bei diesem zusätzlichen CI-Identifizierungsversuch verwendet werden.

    Datentyp: Array

    Attributnamen und -typen hängen von den Anforderungstextdaten und dem verwendeten Bezeichner ab, z. B.:

    "hybridEntryCiAttributes": [
  "name": "String",
  "serial_number": "String"
]
    Ergebnis.zusätzlichefestgelegteElemente.Identifizierungsversuche.Bezeichnername Identifier-Regel, die für diesen zusätzlichen CI-Identifizierungsversuch verwendet wird.

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

    Datentyp: Zeichenfolge
    result.additionalCommittedItems.identifierEntrySysId Sys_id für die Identifier-Regel, die zum Identifizieren dieses zusätzlichen CI verwendet wird.
    Bemerkbare Werte:
    • Unbekannt: Die Identifizierung dieses zusätzlichen CI ist fehlgeschlagen. Details siehe errors.

    Datentyp: Zeichenfolge
    result.additionalCommittedItems.inputIndices Liste der Indexwerte für CIs aus dem Array des Anforderungstextes items, die diesem zusätzlichen CI entsprechen.

    Datentyp: Array von Objekten

    "inputIndices": [
  {
    Number
  }
]
    Ergebnis.zusätzlicheCommittedItems.Marker Liste der Markerwerte zur internen Verwendung.

    Datentyp: Array

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

    Datentyp: Array

    "mergedPayloadIds": [
  "String"
]
    result.additionalCommittedItems.operation Für dieses zusätzliche CI durchgeführter Vorgang.
    Mögliche Werte:
    • LÖSCHEN: Ein vorhandenes CI wird aus der Zieltabelle entfernt.
    • EINFÜGEN: Das zusätzliche CI wird als neuer Datensatz in die Zieltabelle eingefügt.
    • NO_CHANGE: Für das zusätzliche CI wird kein Vorgang ausgeführt.
    • UPDATE: Ein vorhandenes CI in der Zieltabelle wird aktualisiert.
    • UPDATE_WITH_DOWNGRADE: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine allgemeinere Klasse (Vorgängerklasse) geändert.
    • UPDATE_WITH_SWITCH: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine andere Klasse geändert, die keine Vorgängerklasse oder untergeordnete Klasse ist.
    • UPDATE_WITH_UPGRADE: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine spezialisiertere Klasse (absteigende Klasse) geändert.

    Datentyp: Zeichenfolge
    result.additionalCommittedItems.sysId Sys_id für dieses zusätzliche CI durch Identifizierung gefunden.

    Bemerkbare Werte: Unbekannt: Die Identifizierung dieses zusätzlichen CI ist fehlgeschlagen. Details siehe errors.

    Datentyp: Zeichenfolge
    Ergebnis.zusätzlicheCommittedItems.Warnungen Liste der Warnungen, die bei der Verarbeitung dieses zusätzlichen CI aufgetreten sind.

    Datentyp: Array von Objekten

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    Ergebnis.zusätzlicheCommittedItems.Warnungen.Fehler Typ der Warnung, die bei der Verarbeitung dieses zusätzlichen CI aufgetreten ist.

    Datentyp: Zeichenfolge
    Ergebnis.zusätzlicheCommittedItems.Warnungen.Nachricht Bei der Verarbeitung dieses zusätzlichen CI ist eine Warnmeldung aufgetreten.

    Datentyp: Zeichenfolge
    result.additionalCommittedRelations Liste der abhängigen Beziehungs-CIs, die nicht in der Liste des Anforderungstextes relations zum Einfügen oder Aktualisieren enthalten sind.

    Datentyp: Array von Objekten

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

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

    Datentyp: Zahl
    Ergebnis.zusätzlicheCommittedRelations.errors Liste der Fehler, die bei der Verarbeitung dieses zusätzlichen CI für abhängige Beziehungen aufgetreten sind.

    Datentyp: Array von Objekten

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

    Datentyp: Zeichenfolge
    Ergebnis.zusätzlicheBestätigteBeziehungen.Fehler.Nachricht Fehlermeldung beim Verarbeiten dieses zusätzlichen abhängigen Beziehungs-CI.

    Datentyp: Zeichenfolge
    result.additionalCommittedRelations.inputIndexes Liste der Indexwerte für abhängige Beziehungs-CI-Objekte im Array des Anforderungstexts relations, die diesem zusätzlichen abhängigen Beziehungs-CI entsprechen.

    Datentyp: Array

    "inputIndices": [
  Number
]
    result.additionalCommittedRelations.markers Liste der Markerwerte zur internen Verwendung.

    Datentyp: Array

    "markers": []
    result.additionalCommittedRelations.mergedPayloadIds Liste der sys_id-Werte für Teilnutzlasten aus der Tabelle „Teilliche CMDB-IRE-Nutzlasten“ [cmdb_ire_partial_payloads], die während der Verarbeitung dieses zusätzlichen abhängigen Beziehungs-CI zusammengeführt wurden.

    Datentyp: Array

    "mergedPayloadIds": [
  "String"
]
    result.additionalCommittedRelations.operation Für dieses zusätzliche abhängige Beziehungs-CI durchgeführte Operation.
    Mögliche Werte:
    • INSERT: Das CI der abhängigen Beziehung wird als neuer Datensatz in die Zieltabelle eingefügt.
    • INSERT_AS_INCOMPLETE: Das abhängige Beziehungs-CI wies Fehler auf und wird in die Tabelle „CMDB IRE Unvollständige Nutzlasten“ [cmdb_ire_incomplete_payloads] eingefügt.
    • INSERT_AS_partial: Das abhängige Beziehungs-CI wies Fehler auf und wird in die Tabelle der teilweisen CMDB-IRE-Nutzlasten [cmdb_ire_partial_payloads] eingefügt.
    • NO_CHANGE: Für das abhängige Beziehungs-CI wird kein Vorgang ausgeführt.
    • UPDATE: Ein vorhandenes abhängiges Beziehungs-CI in der Zieltabelle wird aktualisiert.

    Datentyp: Zeichenfolge
    result.items Liste der CIs, die im Array des Anforderungstexts items enthalten sind.

    Datentyp: Array von Objekten

    "items": [
  {
    "additionalRelatedItems": [Array],
    "className": "String",
    "duplicateLookupIndices": {Object},
    "errorCount": Number,
    "errors": [Array],
    "identificationAttempts": [Array],
    "identifierEntrySysId": "String",
    "info": [Array],
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloadIds": [Array],
    "operation": "String",
    "relatedItems": [Array],
    "relatedSysIds": [Array],
    "sysId": "String",
    "warnings": [Array]
  }
]
    Ergebnis.Elemente.ZusätzlicheZugehörigeElemente Liste der zugehörigen CIs (Tabellensuch-CI) aus der Tabelle „Teilweise Nutzlasten der CMDB-IRE“ [cmdb_ire_partial_payloads].

    Datentyp: Array von Objekten

    "additionalRelatedItems": [
  {
    "className": "String",
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloadIds": [Array],
    "sysId": "String"
  }
]
    Ergebnis.Elemente.ZusätzlicheZugehörigeElemente.Klassenname Der sys_class_name des zugehörigen Elements.

    Datentyp: Zeichenfolge
    Ergebnis.Elemente.ZusätzlicheZugehörigeElemente.Eingabeindizes Liste der Indexwerte für CIs aus dem Array des Anforderungstextes items, die diesem zugehörigen Element entsprechen.

    Datentyp: Array

    "inputIndices": [
    Number
]
    Ergebnis.Elemente.ZusätzlicheZugehörigeElemente.Marker Liste der Markerwerte zur internen Verwendung.

    Datentyp: Array

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

    Datentyp: Array

    "mergedPayloadIds": [
  "String"
]
    Ergebnis.Elemente.ZusätzlicheZugehörigeElemente.SysId Sys_id des zugehörigen CI.

    Datentyp: Zeichenfolge
    Ergebnis.Elemente.Klassenname Sys_class_name dieses CI.

    Datentyp: Zeichenfolge
    result.items.duplicateLookupIndices Objekt mit Arrays von Indexwerten für items.lookup -Array-Elemente, die auf dasselbe zugehörige CI verweisen.

    Der Array-Name gibt das erste Element aus dem Array des Anforderungstextes items.lookup an, das auf ein bestimmtes zugehöriges CI verweist. Seine Werte sind der Satz zusätzlicher Elemente aus demselben Array, die auf dasselbe zugehörige CI verweisen.

    Datentyp: Objekt

    Dieses Beispiel zeigt einen Fall, in dem das zweite Element im Array items.lookup auf dasselbe zugehörige CI verweist wie ein späteres Element aus diesem Array:

    "duplicateLookupIndices": [
  "2": [Array]
]
    Ergebnis.Elemente.Fehleranzahl Anzahl der bei der Verarbeitung dieses CI aufgetretenen Fehler.

    Datentyp: Zahl
    Ergebnis.Elemente.Fehler Liste der bei der Verarbeitung des CI aufgetretenen Fehler.

    Datentyp: Array von Objekten

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

    Datentyp: Zeichenfolge
    Ergebnis.Elemente.Fehlermeldung Bei der Verarbeitung dieses CI ist eine Fehlermeldung aufgetreten.

    Datentyp: Zeichenfolge
    Ergebnis.Elemente.Identifizierungsversuche Liste der Versuche, die unternommen wurden, um dieses CI zu identifizieren.
    Datentyp: Array von Objekten
    "identificationAttempts": [
  {
    "attemptResult": "String",
    "attributes": [Array],
    "hybridEntryCiAttributes": [Array],
    "identiferName": "String",
    "searchOnTable": [Array]
  }
]
    Ergebnis.Elemente.Identifizierungsversuche.VersuchErgebnis Ergebnis des CI-Identifizierungsversuchs.
    Mögliche Werte:
    • ABGEGLICHEN: Identifizierung erfolgreich. In der Identifier-Regeltabelle wurde ein eindeutiges CI gefunden, das genau mit den angegebenen Attributen übereinstimmt.
    • Multi_MATCH: Die Identifizierung ist mit einem Fehler fehlgeschlagen. In der Identifier-Regeltabelle wurden beim Abgleich mit den angegebenen Attributen doppelte CIs gefunden.
    • NO_MATCH: Identifizierung fehlgeschlagen. In der Identifier-Regeltabelle wurde kein CI gefunden, das den angegebenen Attributen entspricht.
    • ÜBERSPRUNGEN: Identifizierung nicht versucht. Die für die Suche in dieser Identifier-Regeltabelle erforderlichen Attribute wurden nicht angegeben, daher wurde die Regel nicht angewendet.

    Datentyp: Zeichenfolge
    Ergebnis.Elemente.Identifizierungsversuche.Attribute Liste der CI-Bezeichner-Eintragsattribute, die während dieses CI-Identifizierungsversuchs verwendet werden.

    Datentyp: Array

    Attributnamen und -typen hängen von den Anforderungstextdaten und dem verwendeten Bezeichner ab, z. B.:

    "attributes": [
  "serial_number": "String",
  "serial_number_type": "String",
]
    result.items.identificationAttempts.hybridEntryCiAttributes Liste der CI-Bezeichner-Eintragsattribute, die während dieses CI-Identifizierungsversuchs verwendet werden.

    Datentyp: Array

    Attributnamen und -typen hängen von den Anforderungstextdaten und dem verwendeten Bezeichner ab, z. B.:

    "hybridEntryCiAttributes": [
  "name": "String",
  "serial_number": "String"
]
    Ergebnis.Elemente.Identifizierungsversuche.Bezeichnername Identifier-Regel, die für diesen CI-Identifizierungsversuch verwendet wird.

    Datentyp: Zeichenfolge
    result.items.identificationVersuche.searchOnTable Name der Tabelle, die für diesen CI-Identifizierungsversuch durchsucht wurde.

    Datentyp: Zeichenfolge
    result.items.identifierEntrySysId Sys_id für die Identifier-Regel, die zum Identifizieren dieses CI verwendet wird.
    Bemerkbare Werte:
    • Unbekannt: Die Identifizierung dieses CI ist fehlgeschlagen. Details finden Sie unter errors.

    Datentyp: Zeichenfolge
    result.items.info Liste zusätzlicher Informationen zur Verarbeitung des Elements.

    Datentyp: Array von Objekten

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

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

    Datentyp: Zeichenfolge
    result.items.inputIndices Liste der Indexwerte für CIs aus dem Array des Anforderungstextes items, die diesem CI entsprechen.

    Datentyp: Array von Objekten

    "inputIndices": [
  {
    Number
  }
]
    Ergebnis.Elemente.Marker Liste der Markerwerte zur internen Verwendung.

    Datentyp: Array

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

    Datentyp: Array

    "mergedPayloadIds": [
  "String"
]
    Ergebnis.Elemente.Vorgang Für dieses CI durchgeführter Vorgang.
    Mögliche Werte:
    • LÖSCHEN: Ein vorhandenes CI wird aus der Zieltabelle entfernt.
    • EINFÜGEN: Das CI wird als neuer Datensatz in die Zieltabelle eingefügt.
    • NO_CHANGE: Für das CI wird kein Vorgang ausgeführt.
    • UPDATE: Ein vorhandenes CI in der Zieltabelle wird aktualisiert.
    • UPDATE_WITH_DOWNGRADE: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine allgemeinere Klasse (Vorgängerklasse) geändert.
    • UPDATE_WITH_SWITCH: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine andere Klasse geändert, die keine Vorgängerklasse oder untergeordnete Klasse ist.
    • UPDATE_WITH_UPGRADE: Ein vorhandenes CI in der Zieltabelle wird aktualisiert, und seine Klasse wird in eine spezialisiertere Klasse (absteigende Klasse) geändert.

    Datentyp: Zeichenfolge
    Ergebnis.Elemente.ZugehörigeElemente Liste der zugehörigen CIs (Tabellensuch-CI) aus dem Array des Anforderungstextes items.lookup.

    Datentyp: Array von Objekten

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

    Datentyp: Zeichenfolge
    result.items.relatedItems.inputIndices Liste der Indexwerte für CIs und Suchelemente aus den Arrays items und items.lookup des Anforderungstexts, die diesem zugehörigen Element entsprechen.

    Datentyp: Array von Objekten

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

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

    Datentyp: Zahl
    Ergebnis.Elemente.ZugehörigeElemente.Marker Liste der Markerwerte zur internen Verwendung.

    Datentyp: Array

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

    Datentyp: Array

    "mergedPayloadIds": [
  "String"
]
    result.items.relatedSysIds Liste der sys_id-Werte für zugehörige Elemente (Tabellensuchelemente) aus dem Array des Anforderungstexts items.lookup.

    Datentyp: Array

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

    Datentyp: Zeichenfolge
    Ergebnis.Elemente.Warnungen Liste der Warnungen, die bei der Verarbeitung dieses CI aufgetreten sind.

    Datentyp: Array von Objekten

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    Ergebnis.Elemente.Warnungen.Fehler Typ der Warnung, die bei der Verarbeitung des CI aufgetreten ist.

    Datentyp: Zeichenfolge
    Ergebnis.Elemente.Warnungen.Nachricht Bei der Verarbeitung dieses CI ist eine Warnmeldung aufgetreten.

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

    Datentyp: Zeichenfolge
    result.relations Liste der abhängigen Beziehungs-CIs aus dem Array des Anforderungstextes relations.

    Datentyp: Array von Objekten

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

    Datentyp: Zeichenfolge
    Ergebnis.Beziehungen.Fehleranzahl Anzahl der Fehler, die bei der Verarbeitung dieses abhängigen Beziehungs-CI aufgetreten sind.

    Datentyp: Zahl
    Ergebnis.Beziehungen.Fehler Liste der Fehler, die bei der Verarbeitung dieses abhängigen Beziehungs-CI aufgetreten sind.

    Datentyp: Array von Objekten

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    Ergebnis.Beziehungen.Fehler.Fehler Typ des Fehlers, der bei der Verarbeitung dieser abhängigen Beziehungs-CI aufgetreten ist.

    Datentyp: Zeichenfolge
    Ergebnis.Beziehungen.Fehler.Meldung Fehlermeldung bei der Verarbeitung dieses abhängigen Beziehungs-CI.

    Datentyp: Zeichenfolge
    result.beziehungen.inputIndices Liste der Indexwerte für die abhängigen Beziehungs-CI-Objekte im Array des Anforderungstextes relations, die diesem abhängigen Beziehungs-CI entsprechen.

    Datentyp: Array

    "inputIndices": [
  Number
]
    Ergebnis.Beziehungen.Marker Liste der Markerwerte zur internen Verwendung.

    Datentyp: Array

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

    Datentyp: Array

    "mergedPayloadIds": [
  "String"
]
    Ergebnis.Beziehungen.Vorgang Für dieses abhängige Beziehungs-CI durchgeführte Operation.
    Mögliche Werte:
    • EINFÜGEN: Das abhängige Beziehungs-CI wurde als neuer Datensatz in die Zieltabelle eingefügt.
    • INSERT_AS_INCOMPLETE: Das abhängige Beziehungs-CI wies Fehler auf und wurde in die Tabelle „CMDB IRE Unvollständige Nutzlasten“ [cmdb_ire_incomplete_payloads] eingefügt.
    • INSERT_AS_partial: Das abhängige Beziehungs-CI wies Fehler auf und wurde in die Tabelle der teilweisen CMDB-IRE-Nutzlasten [cmdb_ire_partial_payloads] eingefügt.
    • NO_CHANGE: Für das abhängige Beziehungs-CI wurde kein Vorgang ausgeführt.
    • UPDATE: Ein vorhandenes abhängiges Beziehungs-CI in der Zieltabelle wurde aktualisiert.

    Datentyp: Zeichenfolge
    Ergebnis.Beziehungen.Warnungen Liste der Warnungen, die bei der Verarbeitung dieses abhängigen Beziehungs-CI aufgetreten sind.

    Datentyp: Array von Objekten

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    Ergebnis.Beziehungen.Warnungen.Fehler Typ der Warnung, die bei der Verarbeitung dieser abhängigen Beziehungs-CI aufgetreten ist.

    Datentyp: Zeichenfolge
    Ergebnis.Beziehungen.Warnungen.Nachricht Bei der Verarbeitung dieses abhängigen Beziehungs-CI ist eine Warnmeldung aufgetreten.

    Datentyp: Zeichenfolge

    cURL-Anforderung

    Simulieren Sie die Übermittlung einer Teilnutzlast für ein Computer-CI.

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

    Die Antwort zeigt, dass die Nutzlast in die Tabelle „CMDB IRE Partielle Nutzlasten“ [cmdb_ire_partial_payloads] eingefügt wird.

    {
  "result": {
    "relations": [],
    "items": [
      {
        "identifierEntrySysId": "Unknown",
        "partialSysIds": [
          "1aec79151bb45010593876a61a4bcb28"
        ],
        "sysId": "Unknown",
        "errorCount": 0,
        "markers": [],
        "className": "cmdb_ci_computer",
        "inputIndices": [
          0
        ],
        "operation": "INSERT_AS_PARTIAL",
        "errors": [],
        "identificationAttempts": [
          {
            "info": "sys_object_source NO_MATCH",
            "attemptResult": "NO_MATCH",
            "identifierName": "",
            "attributes": [],
            "hybridEntryCiAttributes": []
          },
          {
            "attemptResult": "SKIPPED",
            "identifierName": "Hardware Rule",
            "attributes": [
              "serial_number",
              "serial_number_type"
            ],
            "hybridEntryCiAttributes": [],
            "searchOnTable": "cmdb_serial_number"
          },
          {
            "attemptResult": "SKIPPED",
            "identifierName": "Hardware Rule",
            "attributes": [
              "serial_number"
            ],
            "hybridEntryCiAttributes": [],
            "searchOnTable": "cmdb_ci_hardware"
          },
          {
            "attemptResult": "SKIPPED",
            "identifierName": "Hardware Rule",
            "attributes": [
              "name"
            ],
            "hybridEntryCiAttributes": [],
            "searchOnTable": "cmdb_ci_hardware"
          },
          {
            "attemptResult": "SKIPPED",
            "identifierName": "Hardware Rule",
            "attributes": [
              "mac_address",
              "name"
            ],
            "hybridEntryCiAttributes": [],
            "searchOnTable": "cmdb_ci_network_adapter"
          }
        ],
        "warningCount": 1,
        "warnings": [
          {
            "message": "In payload missing minimum set of input values for criterion (matching) attributes from identify rule for table [cmdb_ci_hardware]. Add these input values in payload item '{\"className\":\"cmdb_ci_computer\",\"values\":{\"discovery_source\":\"ServiceNow\",\"company\":\"My Company\",\"cpu_core_count\":\"6\",\"ram\":\"8192\",\"manufacturer\":\"DELL\"},\"sys_object_source_info\":{\"source_name\":\"ServiceNow\",\"source_native_key\":\"ncomputer3367\"},\"settings\":{},\"sys_ire_info\":{\"ire_received_time\":\"2020-05-14 20:14:51\"}}'",
            "error": "MISSING_MATCHING_ATTRIBUTES"
          }
        ],
        "mergedPayloadIds": [
          "7ddcb9551bb45010593876a61a4bcb08"
        ]
      }
    ],
    "additionalCommittedRelations": [],
    "additionalCommittedItems": []
  }
}

    Simulieren Sie die Übermittlung einer zweiten Teilnutzlast, die die Beschreibung des Computer-CI abschließt, wobei die Option „Erweiterte IRE“ für Zusammenfassungsgenerierung aktiviert ist.

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

    Die Antwort zeigt, dass das Computer-CI eingefügt wird, und zeigt eine Zusammenfassung der durchzuführenden Vorgänge.

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