API Identification et rapprochement

Rversion finale: Australia

Mis à jour 12 mars 2026

108 minutes de lecture

L’API Identification et rapprochement fournit des points de terminaison qui utilisent le moteur Identification et rapprochement (IRE) pour minimiser la création d’éléments de configuration (CI) en double et pour rapprocher les attributs de CI en acceptant uniquement les informations provenant de sources autorisées lors de la mise à jour du Base de données de gestion des configurations (CMDB).

Les utilisateurs doivent avoir le rôle itil ou asset pour utiliser cette API.

Pour plus d’informations sur l’IRE, voir Moteur Identification et réconciliation (IRE).

Identification et rapprochement : PUBLIER /now/identifyreconcile

Insère ou met à jour des éléments de configuration (CI) dans le en appliquant des règles d’identification CMDB et de rapprochement à la charge utile spécifiée (corps de la demande). Utilisez cette API au lieu de mettre à jour directement le CMDB

Utilisez le point de terminaison pour simuler la Identification et rapprochement : POST /now/identifyreconcile/query soumission d’une charge utile à ce point de terminaison sans valider les modifications apportées à la base de données.

Utilisez plutôt le point de terminaison si vous devez spécifier des Identification et rapprochement : PUBLIER /now/identifyreconcile/enhanced options IRE améliorées. Pour plus d’informations sur les options IRE améliorées, voir Moteur d’identification et de rapprochement (IRE).

Format d'URL

URL versionnée : /api/now/{api_version}/identifyreconcile

URL par défaut : /api/now/identifyreconcile

Remarque :

Les versions disponibles sont spécifiées dans l’explorateur d’API REST. Pour les API REST scriptées, des informations supplémentaires sur la version se trouvent dans le formulaire Service REST scripté.

Paramètres de demande pris en charge

Tableau 1. Paramètres de chemin d'accès
Nom	Description
api_version	Facultatif. Version du point de terminaison auquel accéder. Par exemple, `v1` ou `v2`. Spécifiez uniquement cette valeur pour utiliser une version de point de terminaison autre que la plus récente. Type de données : chaîne

Tableau 2. Paramètres de requête
Nom	Description
sysparm_data_source	Source des informations sur le CI. Il doit s’agir de l’une des valeurs de choix définies pour le champ discovery_source de la table Configuration Item (Élément de configuration) [cmdb_ci]. Type de données : chaîne Par défaut : insérez la charge utile de l’API dans la table des charges utiles incomplètes.

Tableau 3. Paramètres de corps de demande (XML ou JSON)
Nom	Description
Éléments	Liste des CI à créer ou à mettre à jour. Type de données : tableau d’objets `"items": [ { "className": "String", "internal_id": "String", "lookup": [Array], "related": [Array], "settings": {Object}, "sys_object_source_info": {Object}, "values": {Object} } ]`
items.className	Requis. Le sys_class_name (nom de classe/table) du CI à créer ou à mettre à jour. Cette valeur peut être n’importe quelle CMDB table, telle que cmdb_ci_linux_server ou cmdb_ci_win_server. Type de données : chaîne
items.internal_id	Identificateur unique de cet élément dans cette charge utile. Peut être n’importe quelle valeur, mais doit être unique dans la charge utile. Type de données : chaîne
Recherche.Éléments	Tableau d’objets dans lequel chaque objet décrit un enregistrement d’identification basé sur la recherche. Ces enregistrements sont utilisés pour identifier l’élément de configuration de niveau supérieur en fonction d’une table de recherche qui fait référence à la table Élément de configuration [cmdb_ci]. Type de données : Tableau sur les objets `"lookup": [ { "className": "String", "internal_id": "String", "sys_object_source_info": {Object}, "values": {Object} } ]`
items.lookup.className	Requis. Le nom de sys_class_name ou de classe/table du CI à créer ou à mettre à jour. Cette valeur peut être n’importe quelle CMDB classe/table, telle que cmdb_serial_number ou cmdb_ci_network_adapter, ou une classe nonCMDB hiérarchique. Type de données : chaîne
items.lookup.internal_id	Identificateur unique de cet enregistrement de recherche dans cette charge utile. Peut être n’importe quelle valeur, mais doit être unique dans la charge utile. Type de données : chaîne
items.lookup.sys_objet_source_info	Objet décrivant un identificateur de CI unique pour une source de données spécifiée. Différentes sources peuvent avoir des paires nom-valeur différentes pour le même CI. Type de données : objet `"sys_object_source_info": { "source_feed": "String", "source_name": "String", "source_native_key": "String", "source_recency_timestamp": "String" }`
items.lookup.sys_object_source_info.source_feed	Nom qui identifie de manière unique le flux qui envoie ce CI. A utiliser si la source peut avoir plusieurs flux. Type de données : chaîne
items.lookup.sys_objet_source_info.nom_source	Source de données pour les informations sur le CI. Cette valeur doit être l’une des valeurs de choix définies pour le champ discovery_source de la table Élément de configuration [cmdb_ci]. Type de données : chaîne
items.lookup.sys_object_source_info.source_native_key	Clé/ID unique de la source pour le CI. Peut être n’importe quelle chaîne unique à l’élément. Type de données : chaîne
items.lookup.sys_object_source_info.source_recency_timestamp	Date et heure UTC de l’analyse du CI. Type de données : chaîne Format : JJ-MM-AAAA hh :mm :ss
éléments.recherche.valeurs	Objet décrivant les champs de cet élément de recherche sous forme de paires nom/valeur, où le nom est le nom du champ. Type de données : objet Les noms et types de champs dépendent des champs sélectionnés par l’utilisateur, tels que : `"values": { "ip_address": "String", "mac_address": "String", "serial_number": "String", "serial_number_type": "String", "valid": "String" }`
éléments.connexes	Tableau d’objets dans lequel chaque objet décrit un enregistrement d’élément à créer ou à mettre à jour, en fonction d’une table connexe qui fait référence au CI de niveau supérieur en cours d’identification. Les règles de la table Entrée connexe [cmdb_related_entry] définissent le type d’enregistrements qui peuvent figurer dans ce tableau. La table connexe peut étendre ou non la table Élément de configuration [cmdb_ci]. Ces enregistrements ne sont pas utilisés pour identifier l’élément de configuration. Type de données : tableau d’objets `"related": [ { "className": "String", "internal_id": "String", "sys_object_source_info": {Object}, "values": {Object} } ]`
items.related.className	Requis. Nom de sys_class_name ou de classe/table de l’élément connexe à créer ou à mettre à jour. Type de données : chaîne
items.related.internal_id	Identificateur unique de cet élément connexe dans cette charge utile. Peut être n’importe quelle valeur, mais doit être unique dans la charge utile. Type de données : chaîne
items.related.sys_objet_source_info	Objet décrivant un identificateur de CI unique pour une source de données spécifiée. Différentes sources peuvent avoir des paires nom-valeur différentes pour le même CI. Type de données : objet `"sys_object_source_info": { "source_feed": "String", "source_name": "String", "source_native_key": "String", "source_recency_timestamp": "String" }`
items.related.sys_object_source_info.source_feed	Nom qui identifie de manière unique le flux qui envoie cet élément associé. A utiliser si la source peut avoir plusieurs flux. Type de données : chaîne
items.related.sys_objet_source_info.nom_source	Source de données pour les informations sur l’élément connexe. Cette valeur doit être l’une des valeurs de choix définies pour le champ discovery_source de la table Élément de configuration [cmdb_ci]. Type de données : chaîne
items.related.sys_object_source_info.source_native_key	Clé/ID unique de la source pour l’élément connexe. Peut être n’importe quelle chaîne unique à l’élément. Type de données : chaîne
items.related.sys_object_source_info.source_recency_timestamp	Date et heure UTC auxquelles l’élément connexe a été analysé. Type de données : chaîne Format : JJ-MM-AAAA hh :mm :ss
Valeurs.Éléments.Connexes	Objet décrivant les champs à créer ou mettre à jour pour cet élément connexe sous forme de paires nom/valeur, où le nom est le nom du champ. Pour un champ de référence, la valeur doit être le sys_id référencé. Type de données : objet Les noms et types de champs dépendent des champs sélectionnés par l’utilisateur, tels que : `"values": { "host_name": "String", "ip_address": "String", "name": "String", "os_name": "String", "sys_class_name": "String" }`
éléments.paramètres	Objet contenant les paramètres définissant les types de mises à jour autorisés. Type de données : objet `"settings": { "skipReclassificationRestrictionRules": Boolean, "updateWithoutDowngrade": Boolean, "updateWithoutSwitch": Boolean, "updateWithoutUpgrade": Boolean }`
items.settings.skipReclassificationRestrictionRules	Marqueur indiquant si IRE doit ignorer l’exécution de la règle de restriction de reclassification qui correspond à la classe de l’élément de charge utile. Valeurs valides : vrai : ignorer l’exécution de la règle. false : exécutez la règle. Valeur par défaut : false
items.settings.updateWithoutDowngrade	Marqueur indiquant si la mise à jour et le passage à une version antérieure sont autorisés pour ce CI. Valeurs valides : vrai : mettre à jour l’élément, mais passer à une version antérieure n’est pas autorisé. false : la mise à jour de l’élément et le passage à une version antérieure sont autorisés. Type de données : booléennes Valeur par défaut : false
items.settings.updateWithoutSwitch	Marqueur indiquant si ce CI peut être mis à jour et si sa classe peut être changée. Valeurs valides : vrai : mettre à jour l’élément, mais le changement de classe n’est pas autorisé. false : la mise à jour d’article et le changement de classe sont autorisés. Type de données : booléennes Valeur par défaut : false
items.settings.updateWithoutUpgrade	Marqueur indiquant si la mise à jour et la mise à niveau sont autorisées pour ce CI. Valeurs valides : vrai : mettre à jour l’élément, mais la mise à niveau n’est pas autorisée. faux : la mise à jour et la mise à niveau de l’élément sont autorisées. Type de données : booléennes Valeur par défaut : false
items.sys_object_source_info	Objet décrivant un identificateur de CI unique. Type de données : objet `"sys_object_source_info": { "source_feed": "String", "source_name": "String", "source_native_key": "String", "source_recency_timestamp": "String" }`
items.sys_object_source_info.source_feed	Nom qui identifie de manière unique le flux qui envoie ce CI. A utiliser si la source peut avoir plusieurs flux. Type de données : chaîne
items.sys_objet_source_info.nom_source	Source de données pour les informations sur le CI. Cette valeur doit être l’une des valeurs de choix définies pour le champ discovery_source de la table Élément de configuration [cmdb_ci]. Type de données : chaîne
items.sys_object_source_info.source_native_key	Clé/ID unique de la source pour le CI. Peut être n’importe quelle chaîne unique à l’élément. Type de données : chaîne
items.sys_object_source_info.source_recency_timestamp	Date et heure UTC de l’analyse du CI. Type de données : chaîne Format : JJ-MM-AAAA hh :mm :ss
éléments.valeurs	Objet décrivant les champs à créer ou à mettre à jour pour ce CI sous forme de paires nom/valeur, où le nom est le nom du champ. Pour un champ de référence, la valeur doit être le sys_id référencé. Type de données : objet Les noms et types de champs dépendent des champs sélectionnés par l’utilisateur, tels que : `"values": { "host_name": "String", "ip_address": "String", "name": "String", "os_name": "String", "sys_class_name": "String" }`
Éléments de référence	Liste de référence entre deux éléments de la charge utile. Les valeurs de chaque élément de référence sont renseignées avant d’identifier un CI à l’aide des règles IRE définies sur une classe. Type de données : tableau d’objets `"referenceItems": [ { "referenced": "String", "referencedBy": "String", "referenceField": "String" } ]`
referenceItems.referenced	Défini internal_id pour l’élément référencé par un autre élément. Type de données : chaîne
referenceItems.referencedBy	Défini internal_id pour l’élément qui fait référence à un autre élément. Type de données : chaîne
referenceItems.referenceField	Nom du champ de référence dans la classe/la table pour l’élément referencedBy . Type de données : chaîne
relations de travail	Liste des relations entre deux éléments définis dans la charge utile. Un objet de ce tableau peut utiliser l’un des deux formats suivants : L’objet peut définir une relation entre deux éléments de niveau supérieur (uniquement) à l’aide parent de paires nom-valeur et , child les valeurs représentant les index d’éléments du tableau de charge items utile. L’objet peut définir une relation entre deux éléments quelconques, y compris les éléments de niveau supérieur, connexes ou de recherche, à l’aide de parent_id paires clé/valeur et child_id avec des valeurs représentant internal_id les valeurs définies pour ces éléments. Type de données : tableau d’objets `"relations": [ { "child": Number, "parent": Number, "sys_rel_source_info": {Object}, "type": "String" } ]` `"relations": [ { "child_id": "String", "parent_id": "String", "sys_rel_source_info": {Object}, "type": "String" } ]`
relations.enfant	Index d’entier de l’objet CI dans le items tableau qui représente l’enfant dans la relation. Type de données : nombre
relations.child_id	L’élément internal_id enfant dans la relation. Type de données : chaîne
relations.parents	Index d’entier de l’objet CI dans le items tableau qui représente le parent dans la relation. Type de données : nombre
relations.parent_id	L’élément internal_id parent dans la relation. Type de données : chaîne
relations.sys_rel_source_info	Informations sur la source de découverte pour la relation. Pour les relations de non-dépendance, ces informations figurent dans la table Sources de relation [sys_rel_source]. Type de données : objet `"sys_rel_source_info": { "source_name": "String", "source_feed": "String" }`
relations.sys_rel_source_info.nom_source	Nom de la source de découverte. Par défaut : source de découverte transmise dans le paramètre de méthode API.
relations.sys_rel_source_info.source_feed	Toute chaîne qui est une sous-découverte/analyse au sein de la source de découverte. Par défaut : « INCONNU » est stocké dans la colonne source_feed lors de la création d’un enregistrement dans sys_rel_source table.
relations.type	Type de relation existant entre les éléments parent et enfant. Il doit s’agir d’une valeur de champ de nom de la table Type de relation CI [cmdb_rel_type]. Type de données : chaîne

En-têtes

Les en-têtes de demande et de réponse suivants s’appliquent uniquement à cette action HTTP ou s’appliquent à cette action d’une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l’API REST, consultez En-têtes d’API REST pris en charge.

Tableau 4. En-têtes de demandes
En-tête	Description
Accepter	Format de données du corps de la réponse. Prend uniquement en charge application/json.
Type de contenu	Format des données du corps de la demande. Prend uniquement en charge application/json.

Tableau 5. En-têtes de réponses
En-tête	Description
Néant

Codes d'état

Les codes d’état suivants s’appliquent à cette action HTTP. Pour obtenir la liste des codes d’état possibles utilisés dans l’API REST, consultez Codes de réponse HTTP de l’API REST.

Tableau 6. Codes d'état
Code d'état	Description
200	Réussi. La demande a été traitée avec succès.
401	Non autorisé. Les informations d’identification de l’utilisateur sont incorrectes ou n’ont pas été transmises.
500	Erreur interne du serveur. Une erreur inattendue s’est produite lors du traitement de la demande. La réponse contient des informations supplémentaires sur l’erreur.

Paramètres du corps de la réponse (JSON ou XML)


Nom	Description
résultat	Liste des résultats produits par la requête. Type de données : tableau `"result": [ "additionalCommittedItems": [Array], "additionalCommittedRelations": [Array], "items": [Array], "relations": [Array] ]`
résultat.additionalCommittedItems	Liste des CI non inclus dans le tableau de corps items de la demande à insérer ou à mettre à jour. Type de données : tableau d’objets `"additionalCommittedItems": [ { "className": "String", "errorCount": Number, "identificationAttempts": [Array], "inputIndices": [Array], "markers": [Array], "mergedPayloads": [Array], "operation": "String", "sysId": "String" } ]`
résultat.additionalCommittedItems.className	La sys_class_name de ce CI supplémentaire. Type de données : chaîne
résultat.additionalCommittedItems.errorCount	Nombre d’erreurs rencontrées lors du traitement de ce CI supplémentaire. Type de données : nombre
résultat.additionalCommittedItems.errors	Liste des erreurs rencontrées lors du traitement de ce CI supplémentaire. Type de données : tableau d’objets `"errors": [ { "error": "String", "message": "String" } ]`
résultat.élémentscommissupplémentaires.erreurs.erreur	Type d’erreur rencontré lors du traitement de ce CI supplémentaire. Type de données : chaîne
résultat.élémentscommis.supplémentaires.erreurs.message	Message d’erreur survenu lors du traitement de ce CI supplémentaire. Type de données : chaîne
résultat.additionalCommittedItems.identificationAttempts	Liste des tentatives effectuées pour identifier ce CI supplémentaire. Type de données : tableau d’objets `"identificationAttempts": [ { "attemptResult": "String", "attributes": [Array], "hybridEntryCiAttributes": [Array], "identiferName": "String", "searchOnTable": [Array] } ]`
résultat.élémentsCommittedSupplémentaires.Tentativesd’identification.RésultatTentative	Résultat de cette tentative d’identification de CI supplémentaire. Valeurs possibles : CORRESPONDANCE : identification réussie. Un CI unique a été trouvé dans la table de règles d’identificateur qui correspond exactement aux attributs spécifiés. MULTI_MATCH : échec de l’identification avec une erreur. Des CI en double ont été trouvés dans la table de règles d’identificateur lors de la mise en correspondance avec les attributs spécifiés. NO_MATCH : échec de l’identification. Aucun CI correspondant aux attributs spécifiés n’a été trouvé dans la table de règles d’identificateur. IGNORÉ : identification non tentée. Les attributs requis pour cette recherche dans la table de règles d’identificateur n’étant pas fournis, la règle n’a donc pas été appliquée. Type de données : chaîne
résultat.additionalCommittedItems.identificationAttempts.attributes	Tableau des attributs d’entrée d’identificateur de CI utilisés au cours de cette tentative d’identification de CI supplémentaire. Type de données : tableau Les noms et types d’attributs dépendent des données du corps de la demande et de l’identificateur utilisé, par exemple : `"attributes": [ "serial_number": "String", "serial_number_type": "String" ]`
résultat.additionalCommittedItems.identificationAttempts.hybridEntryCiAttributes	Liste des attributs d’entrée d’identificateur de CI utilisés au cours de cette tentative d’identification de CI supplémentaire. Type de données : tableau Les noms et types d’attributs dépendent des données du corps de la demande et de l’identificateur utilisé, par exemple : `"hybridEntryCiAttributes": [ "name": "String", "serial_number": "String" ]`
résultat.additionalCommittedItems.identificationAttempts.identifierName	Règle d’identificateur utilisée pour cette tentative d’identification de CI supplémentaire. Type de données : chaîne
résultat.additionalCommittedItems.identificationAttempts.searchOnTable	Nom de la table recherchée pour cette tentative d’identification de CI supplémentaire. Type de données : chaîne
résultat.additionalCommittedItems.identifierEntrySysId	Sys_id la règle d’identificateur utilisée pour identifier ce CI supplémentaire. Valeurs notables : Inconnu : échec de l’identification de ce CI supplémentaire. Consultez errors pour en savoir plus. Type de données : chaîne
résultat.additionalCommittedItems.inputIndices	Liste des valeurs d’index pour les CI du tableau de corps items de la demande qui correspondent à ce CI supplémentaire. Type de données : tableau d’objets `"inputIndices": [ { Number } ]`
résultat.additionalCommittedItems.markers	Liste des valeurs de marqueurs pour une utilisation interne. Type de données : tableau `"markers": []`
résultat.additionalCommittedItems.mergedPayloads	Liste des valeurs de sys_id des charges utiles partielles de la table Charges utiles partielles IRE de la CMDB [cmdb_ire_partial_payloads] qui ont été fusionnées pendant le traitement de ce CI supplémentaire. Type de données : tableau `"mergedPayloadIds": [ "String" ]`
résultat.additionalCommittedItems.operation	Opération exécutée pour ce CI supplémentaire. Valeurs possibles : DELETE : un CI existant est supprimé de la table cible. INSERT : le CI supplémentaire est inséré dans la table cible en tant que nouvel enregistrement. NO_CHANGE : aucune opération n’est effectuée pour le CI supplémentaire. MISE À JOUR : un CI existant dans la table cible est mis à jour. UPDATE_WITH_DOWNGRADE : un CI existant dans la table cible est mis à jour et sa classe est changée en une classe plus générique (classe ancêtre). UPDATE_WITH_SWITCH : un CI existant dans la table cible est mis à jour et sa classe est changée en une autre classe qui n’est pas une classe ancêtres ou descendantes. UPDATE_WITH_UPGRADE : un CI existant dans la table cible est mis à jour et sa classe est changée en une classe plus spécialisée (classe descendante). Type de données : chaîne
résultat.additionalCommittedItems.sysId	Sys_id trouvé pour ce CI supplémentaire via l’identification. Valeurs notables : Inconnu : échec de l’identification de ce CI supplémentaire. Consultez errors pour en savoir plus. Type de données : chaîne
résultat.élémentsCommittedSupplémentaires.avertissements	Liste des avertissements rencontrés lors du traitement de ce CI supplémentaire. Type de données : tableau d’objets `"warnings": [ { "error": "String", "message": "String" } ]`
résultat.élémentssupplémentaires validés.avertissements.erreur	Type d’avertissement rencontré lors du traitement de ce CI supplémentaire. Type de données : chaîne
résultat.élémentsCommittedSupplémentaires.avertissements.message	Message d’avertissement rencontré lors du traitement de ce CI supplémentaire. Type de données : chaîne
résultat.additionalCommittedRelations	Liste des CI de relation dépendante non inclus dans la liste du corps relations de la demande à insérer ou à mettre à jour. Type de données : tableau d’objets `"additionalCommittedRelations": [ { "className": "String", "operation": "String", "markers": [Array], "inputIndices": [Array], "mergedPayloadIds": [Array] } ]`
résultat.additionalCommittedRelations.className	Le sys_class_name de ce CI de relation dépendante supplémentaire. Seule valeur prise en charge : cmdb_rel_ci : table Relations CI. Type de données : chaîne
résultat.relationsengagéessupplémentaires.errorCount	Nombre d’erreurs rencontrées lors du traitement de ce CI de relation dépendante supplémentaire. Type de données : nombre
résultat.relationsengagéessupplémentaires.erreurs	Liste des erreurs rencontrées lors du traitement de ce CI de relation dépendante supplémentaire. Type de données : tableau d’objets `"errors": [ { "error": "String", "message": "String" } ]`
résultat.relationsengagéessupplémentaires.erreurs.erreur	Type d’erreur rencontrée lors du traitement de ce CI de relation dépendante supplémentaire. Type de données : chaîne
résultat.relationsengagéessupplémentaires.erreurs.message	Un message d’erreur est survenu lors du traitement de ce CI de relation dépendante supplémentaire. Type de données : chaîne
résultat.relationsengagéessupplémentaires.indicesentrées	Liste des valeurs d’index pour les objets CI de relation dépendante dans le tableau corps relations de la demande qui correspondent à ce CI de relation dépendante supplémentaire. Type de données : tableau `"inputIndices": [ Number ]`
résultat.relationsengagéessupplémentaires.marqueurs	Liste des valeurs de marqueurs pour une utilisation interne. Type de données : tableau `"markers": []`
résultat.additionalCommittedRelations.mergedPayloadIds	Liste des valeurs de sys_id des charges utiles partielles de la table Charges utiles partielles [cmdb_ire_partial_payloads] IRE CMDB qui ont été fusionnées pendant le traitement de ce CI de relation dépendante supplémentaire. Type de données : tableau `"mergedPayloadIds": [ "String" ]`
résultat.relationsengagéessupplémentaires.opération	Opération exécutée pour ce CI de relation dépendante supplémentaire. Valeurs possibles : INSERT : le CI de relation dépendante est inséré dans la table cible en tant que nouvel enregistrement. INSERT_AS_INCOMPLETE : CI de relation dépendante comportant des erreurs et inséré dans la table Charges utiles incomplètes [cmdb_ire_incomplete_payloads] IRE de la CMDB. INSERT_AS_PARTIAL : CI de relation dépendante comportait des erreurs et est inséré dans la table Charges utiles partielles [cmdb_ire_partial_payloads] IRE de la CMDB. NO_CHANGE : aucune opération n’est réalisée pour le CI de relation dépendante. MISE À JOUR : un CI de relation dépendante existant dans la table cible est mis à jour. Type de données : chaîne
résultat.éléments	Liste des CI inclus dans le tableau de corps items de la demande. Type de données : tableau d’objets `"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] } ]`
résultat.éléments.élémentsconnexes supplémentaires	Liste des CI associés (CI de recherche de table) à partir de la table Charges utiles partielles [cmdb_ire_partial_payloads] IRE de la CMDB. Type de données : tableau d’objets `"additionalRelatedItems": [ { "className": "String", "inputIndices": [Array], "markers": [Array], "mergedPayloadIds": [Array], "sysId": "String" } ]`
result.items.additionalRelatedItems.className	La sys_class_name de l’élément connexe. Type de données : chaîne
résultat.éléments.élémentsconnexes supplémentaires.indicesd’entrée	Liste des valeurs d’index pour les CI du tableau de corps items de la demande qui correspondent à cet élément associé. Type de données : tableau `"inputIndices": [ Number ]`
résultat.éléments.supplémentairesÉlémentsConnexes.marqueurs	Liste des valeurs de marqueurs pour une utilisation interne. Type de données : tableau `"markers": []`
résultat.éléments.supplémentairesÉlémentsConnexes.fusionnésIdsPayloadIds	Liste des valeurs sys_id des charges utiles partielles de la table Charges utiles partielles [cmdb_ire_partial_payloads] IRE de CMDB qui ont été fusionnées pendant le traitement de cet élément connexe. Type de données : tableau `"mergedPayloadIds": [ "String" ]`
result.items.additionalRelatedItems.sysId	Sys_id de ce CI associé. Type de données : chaîne
result.items.className	Sys_class_name de ce CI. Type de données : chaîne
result.items.duplicateLookupIndices	Objet contenant des tableaux de valeurs d’index pour items.lookup les éléments de tableau qui font référence au même CI connexe. Le nom du tableau indique le premier élément du tableau de corps items.lookup de la demande qui fait référence à un CI connexe donné. Ses valeurs sont l’ensemble des éléments supplémentaires du même tableau qui font référence au même CI associé. Type de données : objet Cet exemple montre un cas où le deuxième élément du items.lookup tableau fait référence au même CI connexe qu’un élément ultérieur de ce tableau : `"duplicateLookupIndices": [ "2": [Array] ]`
result.items.errorCount	Nombre d’erreurs rencontrées lors du traitement de ce CI. Type de données : nombre
Résultat.Éléments.Erreurs	Liste des erreurs rencontrées lors du traitement de ce CI. Type de données : tableau d’objets `"errors": [ { "error": "String", "message": "String" } ]`
Résultat.Éléments.Erreurs.Erreur	Type d’erreur rencontrée lors du traitement de ce CI. Type de données : chaîne
Résultat.Éléments.Erreurs.Message	Un message d’erreur est survenu lors du traitement de ce CI. Type de données : chaîne
résultat.items.identificationAttempts	Liste des tentatives effectuées pour identifier ce CI. Type de données : tableau d’objets `"identificationAttempts": [ { "attemptResult": "String", "attributes": [Array], "hybridEntryCiAttributes": [Array], "identiferName": "String", "searchOnTable": [Array] } ]`
résultat.éléments.tentativesd’identification.résultat.tentative	Résultat de cette tentative d’identification de CI. Valeurs possibles : CORRESPONDANCE : identification réussie. Un CI unique a été trouvé dans la table de règles d’identificateur qui correspond exactement aux attributs spécifiés. MULTI_MATCH : échec de l’identification avec une erreur. Des CI en double ont été trouvés dans la table de règles d’identificateur lors de la mise en correspondance avec les attributs spécifiés. NO_MATCH : échec de l’identification. Aucun CI correspondant aux attributs spécifiés n’a été trouvé dans la table de règles d’identificateur. IGNORÉ : identification non tentée. Les attributs requis pour cette recherche dans la table de règles d’identificateur n’étant pas fournis, la règle n’a donc pas été appliquée. Type de données : chaîne
résultat.éléments.tentativesd’identification.attributs	Liste des attributs d’entrée d’identificateur de CI utilisés au cours de cette tentative d’identification de CI. Type de données : tableau Les noms et types d’attributs dépendent des données du corps de la demande et de l’identificateur utilisé, par exemple : `"attributes": [ "serial_number": "String", "serial_number_type": "String", ]`
résultat.items.identificationAttempts.hybridEntryCiAttributes	Liste des attributs d’entrée d’identificateur de CI utilisés au cours de cette tentative d’identification de CI. Type de données : tableau Les noms et types d’attributs dépendent des données du corps de la demande et de l’identificateur utilisé, par exemple : `"hybridEntryCiAttributes": [ "name": "String", "serial_number": "String" ]`
résultat.items.identificationAttempts.identifierName	Règle d’identificateur utilisée pour cette tentative d’identification de CI. Type de données : chaîne
résultat.items.identificationAttempts.searchOnTable	Nom de la table recherchée pour cette tentative d’identification de CI. Type de données : chaîne
result.items.identifierEntrySysId	Sys_id de la règle d’identificateur utilisée pour identifier ce CI. Valeurs notables : Inconnu : échec de l’identification de ce CI. Pour plus de détails, voir errors. Type de données : chaîne
result.items.info	Liste d’informations supplémentaires sur le traitement de l’élément. Type de données : tableau d’objets `"info": [ { "code": "String", "message": "String", "ruleSysId": "String" } ]`
code.éléments.résultat.info	Type de reclassification qui a été ignoré. Valeurs possibles : SKIPPED_CLASS_SWITCH SKIPPED_CLASS_DOWNGRADE SKIPPED_CLASS_UPGRADE
résultat.éléments.info.message	Message qui fournit des informations supplémentaires sur le motif de l’omission de la reclassification. Type de données : chaîne
result.items.info.ruleSysId	Sys_id de la règle de restriction de reclassification correspondante. Applicable uniquement lorsque IRE ignore la reclassification en raison d’une règle de restriction de reclassification. Cette valeur est vide si la reclassification est ignorée en raison d’une charge utile ou d’un marqueur global. Type de données : chaîne
résultat.éléments.indicesentrée	Liste des valeurs d’index pour les CI du tableau de corps items de la demande qui correspondent à ce CI. Type de données : tableau d’objets `"inputIndices": [ { Number } ]`
résultat.éléments.marqueurs	Liste des valeurs de marqueurs pour une utilisation interne. Type de données : tableau `"markers": []`
résultat.éléments.mergedPayloadIds	Liste des valeurs de sys_id des charges utiles partielles de la table Charges utiles partielles IRE de la CMDB [cmdb_ire_partial_payloads] qui ont été fusionnées pendant le traitement de ce CI. Type de données : tableau `"mergedPayloadIds": [ "String" ]`
résultat.éléments.opération	Opération exécutée pour ce CI. Valeurs possibles : DELETE : un CI existant est supprimé de la table cible. INSERT : le CI est inséré dans la table cible en tant que nouvel enregistrement. NO_CHANGE : aucune opération n’est réalisée sur le CI. MISE À JOUR : un CI existant dans la table cible est mis à jour. UPDATE_WITH_DOWNGRADE : un CI existant dans la table cible est mis à jour et sa classe est changée en une classe plus générique (classe ancêtre). UPDATE_WITH_SWITCH : un CI existant dans la table cible est mis à jour et sa classe est changée en une autre classe qui n’est pas une classe ancêtres ou descendantes. UPDATE_WITH_UPGRADE : un CI existant dans la table cible est mis à jour et sa classe est changée en une classe plus spécialisée (classe descendante). Type de données : chaîne
résultat.éléments.connexes	Liste des CI associés (table : rechercher un CI) à partir du tableau du corps items.lookup de la demande. Type de données : tableau d’objets `"relatedItems": [ { "className": "String", "inputIndices": [Array], "markers": [Array], "mergedPayloadIds": [Array], "sysId": "String" } ]`
résultat.éléments.connexes.nomclasse	La sys_class_name de l’élément connexe. Type de données : chaîne
résultat.éléments.élémentsconnexes.indicesentrée	Liste des valeurs d’index pour les CI et des éléments de recherche du corps items de la demande et items.lookup des tableaux qui correspondent à cet élément connexe. Type de données : tableau d’objets `"inputIndices": [ { "mainIndex": Number, "subIndex": Number } ]`
résultat.éléments.connexes.indicesd’entrée.principalIndex	Valeur d’index du tableau de corps items de la demande qui correspond au parent CI de l’élément connexe. Type de données : nombre
result.items.relatedItems.inputIndices.subIndex	Valeur d’index du tableau du corps items.lookup de la demande qui correspond à l’élément connexe. Type de données : nombre
résultat.éléments.connexes.marqueurs	Liste des valeurs de marqueurs pour une utilisation interne. Type de données : tableau `"markers": []`
résultat.éléments.connexes.mergedPayloadIds	Liste des valeurs sys_id des entrées de la table Charges utiles partielles IRE de la CMDB [cmdb_ire_partial_payloads] qui ont été fusionnées dans ce CI au cours du traitement. Type de données : tableau `"mergedPayloadIds": [ "String" ]`
résultat.éléments.relatedSysIds	Liste des valeurs de sys_id pour les éléments connexes (éléments de recherche de table) à partir du tableau du corps items.lookup de la demande. Type de données : tableau Valeurs notables : nul : aucune sys_id n’a été identifiée pour cet élément associé. `"relatedSysIds": [ Number, Number ]`
résultat.éléments.sysId	Sys_id trouvé pour ce CI via l’identification. Valeurs notables : Inconnu : échec de l’identification de ce CI. Consultez errors pour en savoir plus. Type de données : chaîne
résultat.éléments.avertissements	Liste des avertissements rencontrés lors du traitement de ce CI. Type de données : tableau d’objets `"warnings": [ { "error": "String", "message": "String" } ]`
Résultat.Éléments.Avertissements.Erreur	Type d’avertissement rencontré lors du traitement de ce CI. Type de données : chaîne
Résultat.Éléments.Avertissements.Message	Message d’avertissement rencontré lors du traitement de ce CI. Type de données : chaîne
résultat.logContextId	ID de contexte signalé pour cette charge utile. Type de données : chaîne
résultat.relations	Liste des CI de relation dépendante du tableau de corps relations de la demande. Type de données : tableau d’objets `"relations": [ { "className": "String", "errorCount": Number, "errors": [Array], "inputIndices": [Array], "markers": [Array], "mergedPayloadIds": [Array], "operation": "String", "warnings": [Array] } ]`
résultat.relations.nomdeclasse	Le sys_class_name de ce CI de relation dépendante. Seule valeur prise en charge : cmdb_rel_ci : table Relations CI. Type de données : chaîne
résultat.relations.errorCount	Nombre d’erreurs rencontrées lors du traitement de ce CI de relation dépendante. Type de données : nombre
Résultat.Relations.Erreurs	Liste des erreurs rencontrées lors du traitement de ce CI de relation dépendante. Type de données : tableau d’objets `"errors": [ { "error": "String", "message": "String" } ]`
Résultat.Relations.Erreurs.Erreur	Type d’erreur survenue lors du traitement de ce CI de relation dépendante. Type de données : chaîne
Résultat.Relations.Erreurs.Message	Un message d’erreur est survenu lors du traitement de ce CI de relation dépendante. Type de données : chaîne
résultat.relations.indicesentrées	Liste des valeurs d’index pour les objets CI de relation dépendante dans le tableau corps relations de la demande qui correspondent à ce CI de relation dépendante. Type de données : tableau `"inputIndices": [ Number ]`
résultat.relations.marqueurs	Liste des valeurs de marqueurs pour une utilisation interne. Type de données : tableau `"markers": []`
résultat.relations.mergedPayloadIds	Liste des valeurs sys_id des charges utiles partielles de la table Charges utiles partielles [cmdb_ire_partial_payloads] IRE CMDB qui ont été fusionnées pendant le traitement de ce CI de relation dépendante. Type de données : tableau `"mergedPayloadIds": [ "String" ]`
résultat.relations.opération	Opération exécutée pour ce CI de relation dépendante. Valeurs possibles : INSERT : le CI de relation dépendante a été inséré dans la table cible en tant que nouvel enregistrement. INSERT_AS_INCOMPLETE : le CI de relation dépendante comportait des erreurs et a été inséré dans la table Charges utiles incomplètes [cmdb_ire_incomplete_payloads] IRE de la CMDB. INSERT_AS_PARTIAL : le CI de relation dépendante comportait des erreurs et a été inséré dans la table Charges utiles partielles [cmdb_ire_partial_payloads] IRE de la CMDB. NO_CHANGE : aucune opération n’a été réalisée pour le CI de relation dépendante. MISE À JOUR : un CI de relation dépendante existant dans la table cible a été mis à jour. Type de données : chaîne
Résultat.Relations.Avertissements	Liste des avertissements rencontrés lors du traitement de ce CI de relation dépendante. Type de données : tableau d’objets `"warnings": [ { "error": "String", "message": "String" } ]`
Résultat.Relations.Avertissements.Erreur	Type d’avertissement rencontré lors du traitement de ce CI de relation dépendante. Type de données : chaîne
Résultat.Relations.Avertissements.Message	Message d’avertissement rencontré lors du traitement de ce CI de relation dépendante. Type de données : chaîne

Demande cURL

Soumettez une charge utile contenant un serveur Linux (avec des recherches d’éléments connexes de numéro de série et de carte réseau) et un commutateur IP, avec une relation dépendante de la connexion IP entre eux.

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

Le CI du serveur Linux est identifié via une règle matérielle, recherchez son nom dans la table Matériel [cmdb_ci_hardware] et est traité comme une mise à jour d’un CI existant dans la table Serveur Linux [cmdb_ci_linux_server]. Le commutateur IP est identifié de la même manière via une règle matérielle, recherchez son nom dans la table Matériel et met à jour un CI existant dans la table Commutateur IP [cmdb_ci_ip_switch]. Enfin, la relation dépendante de la connexion IP entre le serveur et le commutateur est insérée en tant que nouvel enregistrement dans la table CI Relationship (Relations CI) [cmdb_rel_ci].

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

Identification et rapprochement : PUBLIER /now/identifyreconcile/enhanced

Utilisez le point de terminaison pour simuler la Identification et rapprochement : POST /now/identifyreconcile/queryEnhanced soumission d’une charge utile à ce point de terminaison sans valider les modifications apportées à la base de données.

Cette méthode est similaire à la Identification et rapprochement : PUBLIER /now/identifyreconcile méthode, mais ajoute les fonctionnalités suivantes :

Charges utiles partielles
- Si un élément présente un avertissement ou une erreur, indique si une opération d’élément est INSERT_AS_PARTIAL ou INSERT_INCOMPLETE.
- Renvoie le sys_ids des charges utiles partielles qui ont été fusionnées avec des charges utiles partielles existantes.
Prend en charge la fonctionnalité de déduplication de la charge utile.
Génère un résumé.

Format d'URL

URL versionnée : /api/now/{api_version}/identifyreconcile/enhanced

URL par défaut : /api/now/identifyreconcile/enhanced

Remarque :

Paramètres de demande pris en charge

Tableau 7. Paramètres de chemin d'accès
Nom	Description
api_version	Facultatif. Version du point de terminaison auquel accéder. Par exemple, `v1` ou `v2`. Spécifiez uniquement cette valeur pour utiliser une version de point de terminaison autre que la plus récente. Type de données : chaîne

Tableau 8. Paramètres de requête
Nom	Description
options	Liste séparée par des virgules des paires nom-valeur représentant les options IRE améliorée appliquées à la demande. Par exemple, pour remplacer les valeurs par défaut des charges utiles partielles, des validations partielles, des charges utiles dédupliquées et générer un résumé Options IRE améliorées : `partial_payloads :false,partial_commits :false,deduplicate_payloads :false,generate_summary :true` Remarque : Par défaut ou si partial_payloads est défini sur true, les deux partial_commits et deduplicate_payloads sont activés, même s’ils sont définis sur false, car ces fonctionnalités sont essentielles pour la fonctionnalité de charges utiles partielles. Pour plus d’informations sur les options IRE améliorées, voir Moteur d’identification et de rapprochement (IRE). Valeurs valides pour chaque paire nom-valeur : vrai : activez cette option IRE améliorée. faux : désactivez cette option IRE améliorée. Type de données : chaîne
sysparm_data_source	Source des informations sur le CI. Il doit s’agir de l’une des valeurs de choix définies pour le champ discovery_source de la table Configuration Item (Élément de configuration) [cmdb_ci]. Type de données : chaîne Par défaut : insérez la charge utile de l’API dans la table des charges utiles incomplètes.

Tableau 9. Paramètres de corps de demande (XML ou JSON)
Nom	Description
Éléments	Liste des CI à créer ou à mettre à jour. Type de données : tableau d’objets `"items": [ { "className": "String", "internal_id": "String", "lookup": [Array], "related": [Array], "settings": {Object}, "sys_object_source_info": {Object}, "values": {Object} } ]`
items.className	Requis. Le sys_class_name (nom de classe/table) du CI à créer ou à mettre à jour. Cette valeur peut être n’importe quelle CMDB table, telle que cmdb_ci_linux_server ou cmdb_ci_win_server. Type de données : chaîne
items.internal_id	Identificateur unique de cet élément dans cette charge utile. Peut être n’importe quelle valeur, mais doit être unique dans la charge utile. Type de données : chaîne
Recherche.Éléments	Tableau d’objets dans lequel chaque objet décrit un enregistrement d’identification basé sur la recherche. Ces enregistrements sont utilisés pour identifier l’élément de configuration de niveau supérieur en fonction d’une table de recherche qui fait référence à la table Élément de configuration [cmdb_ci]. Type de données : Tableau sur les objets `"lookup": [ { "className": "String", "internal_id": "String", "sys_object_source_info": {Object}, "values": {Object} } ]`
items.lookup.className	Requis. Le nom de sys_class_name ou de classe/table du CI à créer ou à mettre à jour. Cette valeur peut être n’importe quelle CMDB classe/table, telle que cmdb_serial_number ou cmdb_ci_network_adapter, ou une classe nonCMDB hiérarchique. Type de données : chaîne
items.lookup.internal_id	Identificateur unique de cet enregistrement de recherche dans cette charge utile. Peut être n’importe quelle valeur, mais doit être unique dans la charge utile. Type de données : chaîne
items.lookup.sys_objet_source_info	Objet décrivant un identificateur de CI unique pour une source de données spécifiée. Différentes sources peuvent avoir des paires nom-valeur différentes pour le même CI. Type de données : objet `"sys_object_source_info": { "source_feed": "String", "source_name": "String", "source_native_key": "String", "source_recency_timestamp": "String" }`
items.lookup.sys_object_source_info.source_feed	Nom qui identifie de manière unique le flux qui envoie ce CI. A utiliser si la source peut avoir plusieurs flux. Type de données : chaîne
items.lookup.sys_objet_source_info.nom_source	Source de données pour les informations sur le CI. Cette valeur doit être l’une des valeurs de choix définies pour le champ discovery_source de la table Élément de configuration [cmdb_ci]. Type de données : chaîne
items.lookup.sys_object_source_info.source_native_key	Clé/ID unique de la source pour le CI. Peut être n’importe quelle chaîne unique à l’élément. Type de données : chaîne
items.lookup.sys_object_source_info.source_recency_timestamp	Date et heure UTC de l’analyse du CI. Type de données : chaîne Format : JJ-MM-AAAA hh :mm :ss
éléments.recherche.valeurs	Objet décrivant les champs de cet élément de recherche sous forme de paires nom/valeur, où le nom est le nom du champ. Type de données : objet Les noms et types de champs dépendent des champs sélectionnés par l’utilisateur, tels que : `"values": { "ip_address": "String", "mac_address": "String", "serial_number": "String", "serial_number_type": "String", "valid": "String" }`
éléments.connexes	Tableau d’objets dans lequel chaque objet décrit un enregistrement d’élément à créer ou à mettre à jour, en fonction d’une table connexe qui fait référence au CI de niveau supérieur en cours d’identification. Les règles de la table Entrée connexe [cmdb_related_entry] définissent le type d’enregistrements qui peuvent figurer dans ce tableau. La table connexe peut étendre ou non la table Élément de configuration [cmdb_ci]. Ces enregistrements ne sont pas utilisés pour identifier l’élément de configuration. Type de données : tableau d’objets `"related": [ { "className": "String", "internal_id": "String", "sys_object_source_info": {Object}, "values": {Object} } ]`
items.related.className	Requis. Nom de sys_class_name ou de classe/table de l’élément connexe à créer ou à mettre à jour. Type de données : chaîne
items.related.internal_id	Identificateur unique de cet élément connexe dans cette charge utile. Peut être n’importe quelle valeur, mais doit être unique dans la charge utile. Type de données : chaîne
items.related.sys_objet_source_info	Objet décrivant un identificateur de CI unique pour une source de données spécifiée. Différentes sources peuvent avoir des paires nom-valeur différentes pour le même CI. Type de données : objet `"sys_object_source_info": { "source_feed": "String", "source_name": "String", "source_native_key": "String", "source_recency_timestamp": "String" }`
items.related.sys_object_source_info.source_feed	Nom qui identifie de manière unique le flux qui envoie cet élément associé. A utiliser si la source peut avoir plusieurs flux. Type de données : chaîne
items.related.sys_objet_source_info.nom_source	Source de données pour les informations sur l’élément connexe. Cette valeur doit être l’une des valeurs de choix définies pour le champ discovery_source de la table Élément de configuration [cmdb_ci]. Type de données : chaîne
items.related.sys_object_source_info.source_native_key	Clé/ID unique de la source pour l’élément connexe. Peut être n’importe quelle chaîne unique à l’élément. Type de données : chaîne
items.related.sys_object_source_info.source_recency_timestamp	Date et heure UTC auxquelles l’élément connexe a été analysé. Type de données : chaîne Format : JJ-MM-AAAA hh :mm :ss
Valeurs.Éléments.Connexes	Objet décrivant les champs à créer ou mettre à jour pour cet élément connexe sous forme de paires nom/valeur, où le nom est le nom du champ. Pour un champ de référence, la valeur doit être le sys_id référencé. Type de données : objet Les noms et types de champs dépendent des champs sélectionnés par l’utilisateur, tels que : `"values": { "host_name": "String", "ip_address": "String", "name": "String", "os_name": "String", "sys_class_name": "String" }`
éléments.paramètres	Objet contenant les paramètres définissant les types de mises à jour autorisés. Type de données : objet `"settings": { "skipReclassificationRestrictionRules": Boolean, "updateWithoutDowngrade": Boolean, "updateWithoutSwitch": Boolean, "updateWithoutUpgrade": Boolean }`
items.settings.skipReclassificationRestrictionRules	Marqueur indiquant si IRE doit ignorer l’exécution de la règle de restriction de reclassification qui correspond à la classe de l’élément de charge utile. Valeurs valides : vrai : ignorer l’exécution de la règle. false : exécutez la règle. Valeur par défaut : false
items.settings.updateWithoutDowngrade	Marqueur indiquant si la mise à jour et le passage à une version antérieure sont autorisés pour ce CI. Valeurs valides : vrai : mettre à jour l’élément, mais passer à une version antérieure n’est pas autorisé. false : la mise à jour de l’élément et le passage à une version antérieure sont autorisés. Type de données : booléennes Valeur par défaut : false
items.settings.updateWithoutSwitch	Marqueur indiquant si ce CI peut être mis à jour et si sa classe peut être changée. Valeurs valides : vrai : mettre à jour l’élément, mais le changement de classe n’est pas autorisé. false : la mise à jour d’article et le changement de classe sont autorisés. Type de données : booléennes Valeur par défaut : false
items.settings.updateWithoutUpgrade	Marqueur indiquant si la mise à jour et la mise à niveau sont autorisées pour ce CI. Valeurs valides : vrai : mettre à jour l’élément, mais la mise à niveau n’est pas autorisée. faux : la mise à jour et la mise à niveau de l’élément sont autorisées. Type de données : booléennes Valeur par défaut : false
items.sys_object_source_info	Objet décrivant un identificateur de CI unique. Type de données : objet `"sys_object_source_info": { "source_feed": "String", "source_name": "String", "source_native_key": "String", "source_recency_timestamp": "String" }`
items.sys_object_source_info.source_feed	Nom qui identifie de manière unique le flux qui envoie ce CI. A utiliser si la source peut avoir plusieurs flux. Type de données : chaîne
items.sys_objet_source_info.nom_source	Source de données pour les informations sur le CI. Cette valeur doit être l’une des valeurs de choix définies pour le champ discovery_source de la table Élément de configuration [cmdb_ci]. Type de données : chaîne
items.sys_object_source_info.source_native_key	Clé/ID unique de la source pour le CI. Peut être n’importe quelle chaîne unique à l’élément. Type de données : chaîne
items.sys_object_source_info.source_recency_timestamp	Date et heure UTC de l’analyse du CI. Type de données : chaîne Format : JJ-MM-AAAA hh :mm :ss
éléments.valeurs	Objet décrivant les champs à créer ou à mettre à jour pour ce CI sous forme de paires nom/valeur, où le nom est le nom du champ. Pour un champ de référence, la valeur doit être le sys_id référencé. Type de données : objet Les noms et types de champs dépendent des champs sélectionnés par l’utilisateur, tels que : `"values": { "host_name": "String", "ip_address": "String", "name": "String", "os_name": "String", "sys_class_name": "String" }`
Éléments de référence	Liste de référence entre deux éléments de la charge utile. Les valeurs de chaque élément de référence sont renseignées avant d’identifier un CI à l’aide des règles IRE définies sur une classe. Type de données : tableau d’objets `"referenceItems": [ { "referenced": "String", "referencedBy": "String", "referenceField": "String" } ]`
referenceItems.referenced	Défini internal_id pour l’élément référencé par un autre élément. Type de données : chaîne
referenceItems.referencedBy	Défini internal_id pour l’élément qui fait référence à un autre élément. Type de données : chaîne
referenceItems.referenceField	Nom du champ de référence dans la classe/la table pour l’élément referencedBy . Type de données : chaîne
relations de travail	Liste des relations entre deux éléments définis dans la charge utile. Un objet de ce tableau peut utiliser l’un des deux formats suivants : L’objet peut définir une relation entre deux éléments de niveau supérieur (uniquement) à l’aide parent de paires nom-valeur et , child les valeurs représentant les index d’éléments du tableau de charge items utile. L’objet peut définir une relation entre deux éléments quelconques, y compris les éléments de niveau supérieur, connexes ou de recherche, à l’aide de parent_id paires clé/valeur et child_id avec des valeurs représentant internal_id les valeurs définies pour ces éléments. Type de données : tableau d’objets `"relations": [ { "child": Number, "parent": Number, "sys_rel_source_info": {Object}, "type": "String" } ]` `"relations": [ { "child_id": "String", "parent_id": "String", "sys_rel_source_info": {Object}, "type": "String" } ]`
relations.enfant	Index d’entier de l’objet CI dans le items tableau qui représente l’enfant dans la relation. Type de données : nombre
relations.child_id	L’élément internal_id enfant dans la relation. Type de données : chaîne
relations.parents	Index d’entier de l’objet CI dans le items tableau qui représente le parent dans la relation. Type de données : nombre
relations.parent_id	L’élément internal_id parent dans la relation. Type de données : chaîne
relations.sys_rel_source_info	Informations sur la source de découverte pour la relation. Pour les relations de non-dépendance, ces informations figurent dans la table Sources de relation [sys_rel_source]. Type de données : objet `"sys_rel_source_info": { "source_name": "String", "source_feed": "String" }`
relations.sys_rel_source_info.nom_source	Nom de la source de découverte. Par défaut : source de découverte transmise dans le paramètre de méthode API.
relations.sys_rel_source_info.source_feed	Toute chaîne qui est une sous-découverte/analyse au sein de la source de découverte. Par défaut : « INCONNU » est stocké dans la colonne source_feed lors de la création d’un enregistrement dans sys_rel_source table.
relations.type	Type de relation existant entre les éléments parent et enfant. Il doit s’agir d’une valeur de champ de nom de la table Type de relation CI [cmdb_rel_type]. Type de données : chaîne

En-têtes

Tableau 10. En-têtes de demandes
En-tête	Description
Accepter	Format de données du corps de la réponse. Prend uniquement en charge application/json.
Type de contenu	Format des données du corps de la demande. Prend uniquement en charge application/json.

Tableau 11. En-têtes de réponses
En-tête	Description
Néant

Codes d'état

Les codes d’état suivants s’appliquent à cette action HTTP. Pour obtenir la liste des codes d’état possibles utilisés dans l’API REST, consultez Codes de réponse HTTP de l’API REST.

Tableau 12. Codes d'état
Code d'état	Description
200	Réussi. La demande a été traitée avec succès.
401	Non autorisé. Les informations d’identification de l’utilisateur sont incorrectes ou n’ont pas été transmises.
500	Erreur interne du serveur. Une erreur inattendue s’est produite lors du traitement de la demande. Détail du message d’erreur « Le bloc [...] n’est pas une entrée valide » indique que le paramètre de options requête n’est pas au format de paire nom-valeur correct. Par exemple, la spécification d’un options paramètre de `partiel` produit un code d’état 500 avec « Chunk [partial] is not a valid entry » (Bloc [partiel] n’est pas une entrée valide) dans le détail du message.

Paramètres du corps de la réponse (JSON ou XML)


Nom	Description
résultat	Liste des résultats produits par la requête. Type de données : tableau `"result": [ "additionalCommittedItems": [Array], "additionalCommittedRelations": [Array], "items": [Array], "relations": [Array] ]`
résultat.additionalCommittedItems	Liste des CI non inclus dans le tableau de corps items de la demande à insérer ou à mettre à jour. Type de données : tableau d’objets `"additionalCommittedItems": [ { "className": "String", "errorCount": Number, "identificationAttempts": [Array], "inputIndices": [Array], "markers": [Array], "mergedPayloads": [Array], "operation": "String", "sysId": "String" } ]`
résultat.additionalCommittedItems.className	La sys_class_name de ce CI supplémentaire. Type de données : chaîne
résultat.additionalCommittedItems.errorCount	Nombre d’erreurs rencontrées lors du traitement de ce CI supplémentaire. Type de données : nombre
résultat.additionalCommittedItems.errors	Liste des erreurs rencontrées lors du traitement de ce CI supplémentaire. Type de données : tableau d’objets `"errors": [ { "error": "String", "message": "String" } ]`
résultat.élémentscommissupplémentaires.erreurs.erreur	Type d’erreur rencontré lors du traitement de ce CI supplémentaire. Type de données : chaîne
résultat.élémentscommis.supplémentaires.erreurs.message	Message d’erreur survenu lors du traitement de ce CI supplémentaire. Type de données : chaîne
résultat.additionalCommittedItems.identificationAttempts	Liste des tentatives effectuées pour identifier ce CI supplémentaire. Type de données : tableau d’objets `"identificationAttempts": [ { "attemptResult": "String", "attributes": [Array], "hybridEntryCiAttributes": [Array], "identiferName": "String", "searchOnTable": [Array] } ]`
résultat.élémentsCommittedSupplémentaires.Tentativesd’identification.RésultatTentative	Résultat de cette tentative d’identification de CI supplémentaire. Valeurs possibles : CORRESPONDANCE : identification réussie. Un CI unique a été trouvé dans la table de règles d’identificateur qui correspond exactement aux attributs spécifiés. MULTI_MATCH : échec de l’identification avec une erreur. Des CI en double ont été trouvés dans la table de règles d’identificateur lors de la mise en correspondance avec les attributs spécifiés. NO_MATCH : échec de l’identification. Aucun CI correspondant aux attributs spécifiés n’a été trouvé dans la table de règles d’identificateur. IGNORÉ : identification non tentée. Les attributs requis pour cette recherche dans la table de règles d’identificateur n’étant pas fournis, la règle n’a donc pas été appliquée. Type de données : chaîne
résultat.additionalCommittedItems.identificationAttempts.attributes	Tableau des attributs d’entrée d’identificateur de CI utilisés au cours de cette tentative d’identification de CI supplémentaire. Type de données : tableau Les noms et types d’attributs dépendent des données du corps de la demande et de l’identificateur utilisé, par exemple : `"attributes": [ "serial_number": "String", "serial_number_type": "String" ]`
résultat.additionalCommittedItems.identificationAttempts.hybridEntryCiAttributes	Liste des attributs d’entrée d’identificateur de CI utilisés au cours de cette tentative d’identification de CI supplémentaire. Type de données : tableau Les noms et types d’attributs dépendent des données du corps de la demande et de l’identificateur utilisé, par exemple : `"hybridEntryCiAttributes": [ "name": "String", "serial_number": "String" ]`
résultat.additionalCommittedItems.identificationAttempts.identifierName	Règle d’identificateur utilisée pour cette tentative d’identification de CI supplémentaire. Type de données : chaîne
résultat.additionalCommittedItems.identificationAttempts.searchOnTable	Nom de la table recherchée pour cette tentative d’identification de CI supplémentaire. Type de données : chaîne
résultat.additionalCommittedItems.identifierEntrySysId	Sys_id la règle d’identificateur utilisée pour identifier ce CI supplémentaire. Valeurs notables : Inconnu : échec de l’identification de ce CI supplémentaire. Consultez errors pour en savoir plus. Type de données : chaîne
résultat.additionalCommittedItems.inputIndices	Liste des valeurs d’index pour les CI du tableau de corps items de la demande qui correspondent à ce CI supplémentaire. Type de données : tableau d’objets `"inputIndices": [ { Number } ]`
résultat.additionalCommittedItems.markers	Liste des valeurs de marqueurs pour une utilisation interne. Type de données : tableau `"markers": []`
résultat.additionalCommittedItems.mergedPayloads	Liste des valeurs de sys_id des charges utiles partielles de la table Charges utiles partielles IRE de la CMDB [cmdb_ire_partial_payloads] qui ont été fusionnées pendant le traitement de ce CI supplémentaire. Type de données : tableau `"mergedPayloadIds": [ "String" ]`
résultat.additionalCommittedItems.operation	Opération exécutée pour ce CI supplémentaire. Valeurs possibles : DELETE : un CI existant est supprimé de la table cible. INSERT : le CI supplémentaire est inséré dans la table cible en tant que nouvel enregistrement. NO_CHANGE : aucune opération n’est effectuée pour le CI supplémentaire. MISE À JOUR : un CI existant dans la table cible est mis à jour. UPDATE_WITH_DOWNGRADE : un CI existant dans la table cible est mis à jour et sa classe est changée en une classe plus générique (classe ancêtre). UPDATE_WITH_SWITCH : un CI existant dans la table cible est mis à jour et sa classe est changée en une autre classe qui n’est pas une classe ancêtres ou descendantes. UPDATE_WITH_UPGRADE : un CI existant dans la table cible est mis à jour et sa classe est changée en une classe plus spécialisée (classe descendante). Type de données : chaîne
résultat.additionalCommittedItems.sysId	Sys_id trouvé pour ce CI supplémentaire via l’identification. Valeurs notables : Inconnu : échec de l’identification de ce CI supplémentaire. Consultez errors pour en savoir plus. Type de données : chaîne
résultat.élémentsCommittedSupplémentaires.avertissements	Liste des avertissements rencontrés lors du traitement de ce CI supplémentaire. Type de données : tableau d’objets `"warnings": [ { "error": "String", "message": "String" } ]`
résultat.élémentssupplémentaires validés.avertissements.erreur	Type d’avertissement rencontré lors du traitement de ce CI supplémentaire. Type de données : chaîne
résultat.élémentsCommittedSupplémentaires.avertissements.message	Message d’avertissement rencontré lors du traitement de ce CI supplémentaire. Type de données : chaîne
résultat.additionalCommittedRelations	Liste des CI de relation dépendante non inclus dans la liste du corps relations de la demande à insérer ou à mettre à jour. Type de données : tableau d’objets `"additionalCommittedRelations": [ { "className": "String", "operation": "String", "markers": [Array], "inputIndices": [Array], "mergedPayloadIds": [Array] } ]`
résultat.additionalCommittedRelations.className	Le sys_class_name de ce CI de relation dépendante supplémentaire. Seule valeur prise en charge : cmdb_rel_ci : table Relations CI. Type de données : chaîne
résultat.relationsengagéessupplémentaires.errorCount	Nombre d’erreurs rencontrées lors du traitement de ce CI de relation dépendante supplémentaire. Type de données : nombre
résultat.relationsengagéessupplémentaires.erreurs	Liste des erreurs rencontrées lors du traitement de ce CI de relation dépendante supplémentaire. Type de données : tableau d’objets `"errors": [ { "error": "String", "message": "String" } ]`
résultat.relationsengagéessupplémentaires.erreurs.erreur	Type d’erreur rencontrée lors du traitement de ce CI de relation dépendante supplémentaire. Type de données : chaîne
résultat.relationsengagéessupplémentaires.erreurs.message	Un message d’erreur est survenu lors du traitement de ce CI de relation dépendante supplémentaire. Type de données : chaîne
résultat.relationsengagéessupplémentaires.indicesentrées	Liste des valeurs d’index pour les objets CI de relation dépendante dans le tableau corps relations de la demande qui correspondent à ce CI de relation dépendante supplémentaire. Type de données : tableau `"inputIndices": [ Number ]`
résultat.relationsengagéessupplémentaires.marqueurs	Liste des valeurs de marqueurs pour une utilisation interne. Type de données : tableau `"markers": []`
résultat.additionalCommittedRelations.mergedPayloadIds	Liste des valeurs de sys_id des charges utiles partielles de la table Charges utiles partielles [cmdb_ire_partial_payloads] IRE CMDB qui ont été fusionnées pendant le traitement de ce CI de relation dépendante supplémentaire. Type de données : tableau `"mergedPayloadIds": [ "String" ]`
résultat.relationsengagéessupplémentaires.opération	Opération exécutée pour ce CI de relation dépendante supplémentaire. Valeurs possibles : INSERT : le CI de relation dépendante est inséré dans la table cible en tant que nouvel enregistrement. INSERT_AS_INCOMPLETE : CI de relation dépendante comportant des erreurs et inséré dans la table Charges utiles incomplètes [cmdb_ire_incomplete_payloads] IRE de la CMDB. INSERT_AS_PARTIAL : CI de relation dépendante comportait des erreurs et est inséré dans la table Charges utiles partielles [cmdb_ire_partial_payloads] IRE de la CMDB. NO_CHANGE : aucune opération n’est réalisée pour le CI de relation dépendante. MISE À JOUR : un CI de relation dépendante existant dans la table cible est mis à jour. Type de données : chaîne
résultat.éléments	Liste des CI inclus dans le tableau de corps items de la demande. Type de données : tableau d’objets `"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] } ]`
résultat.éléments.élémentsconnexes supplémentaires	Liste des CI associés (CI de recherche de table) à partir de la table Charges utiles partielles [cmdb_ire_partial_payloads] IRE de la CMDB. Type de données : tableau d’objets `"additionalRelatedItems": [ { "className": "String", "inputIndices": [Array], "markers": [Array], "mergedPayloadIds": [Array], "sysId": "String" } ]`
result.items.additionalRelatedItems.className	La sys_class_name de l’élément connexe. Type de données : chaîne
résultat.éléments.élémentsconnexes supplémentaires.indicesd’entrée	Liste des valeurs d’index pour les CI du tableau de corps items de la demande qui correspondent à cet élément associé. Type de données : tableau `"inputIndices": [ Number ]`
résultat.éléments.supplémentairesÉlémentsConnexes.marqueurs	Liste des valeurs de marqueurs pour une utilisation interne. Type de données : tableau `"markers": []`
résultat.éléments.supplémentairesÉlémentsConnexes.fusionnésIdsPayloadIds	Liste des valeurs sys_id des charges utiles partielles de la table Charges utiles partielles [cmdb_ire_partial_payloads] IRE de CMDB qui ont été fusionnées pendant le traitement de cet élément connexe. Type de données : tableau `"mergedPayloadIds": [ "String" ]`
result.items.additionalRelatedItems.sysId	Sys_id de ce CI associé. Type de données : chaîne
result.items.className	Sys_class_name de ce CI. Type de données : chaîne
result.items.duplicateLookupIndices	Objet contenant des tableaux de valeurs d’index pour items.lookup les éléments de tableau qui font référence au même CI connexe. Le nom du tableau indique le premier élément du tableau de corps items.lookup de la demande qui fait référence à un CI connexe donné. Ses valeurs sont l’ensemble des éléments supplémentaires du même tableau qui font référence au même CI associé. Type de données : objet Cet exemple montre un cas où le deuxième élément du items.lookup tableau fait référence au même CI connexe qu’un élément ultérieur de ce tableau : `"duplicateLookupIndices": [ "2": [Array] ]`
result.items.errorCount	Nombre d’erreurs rencontrées lors du traitement de ce CI. Type de données : nombre
Résultat.Éléments.Erreurs	Liste des erreurs rencontrées lors du traitement de ce CI. Type de données : tableau d’objets `"errors": [ { "error": "String", "message": "String" } ]`
Résultat.Éléments.Erreurs.Erreur	Type d’erreur rencontrée lors du traitement de ce CI. Type de données : chaîne
Résultat.Éléments.Erreurs.Message	Un message d’erreur est survenu lors du traitement de ce CI. Type de données : chaîne
résultat.items.identificationAttempts	Liste des tentatives effectuées pour identifier ce CI. Type de données : tableau d’objets `"identificationAttempts": [ { "attemptResult": "String", "attributes": [Array], "hybridEntryCiAttributes": [Array], "identiferName": "String", "searchOnTable": [Array] } ]`
résultat.éléments.tentativesd’identification.résultat.tentative	Résultat de cette tentative d’identification de CI. Valeurs possibles : CORRESPONDANCE : identification réussie. Un CI unique a été trouvé dans la table de règles d’identificateur qui correspond exactement aux attributs spécifiés. MULTI_MATCH : échec de l’identification avec une erreur. Des CI en double ont été trouvés dans la table de règles d’identificateur lors de la mise en correspondance avec les attributs spécifiés. NO_MATCH : échec de l’identification. Aucun CI correspondant aux attributs spécifiés n’a été trouvé dans la table de règles d’identificateur. IGNORÉ : identification non tentée. Les attributs requis pour cette recherche dans la table de règles d’identificateur n’étant pas fournis, la règle n’a donc pas été appliquée. Type de données : chaîne
résultat.éléments.tentativesd’identification.attributs	Liste des attributs d’entrée d’identificateur de CI utilisés au cours de cette tentative d’identification de CI. Type de données : tableau Les noms et types d’attributs dépendent des données du corps de la demande et de l’identificateur utilisé, par exemple : `"attributes": [ "serial_number": "String", "serial_number_type": "String", ]`
résultat.items.identificationAttempts.hybridEntryCiAttributes	Liste des attributs d’entrée d’identificateur de CI utilisés au cours de cette tentative d’identification de CI. Type de données : tableau Les noms et types d’attributs dépendent des données du corps de la demande et de l’identificateur utilisé, par exemple : `"hybridEntryCiAttributes": [ "name": "String", "serial_number": "String" ]`
résultat.items.identificationAttempts.identifierName	Règle d’identificateur utilisée pour cette tentative d’identification de CI. Type de données : chaîne
résultat.items.identificationAttempts.searchOnTable	Nom de la table recherchée pour cette tentative d’identification de CI. Type de données : chaîne
result.items.identifierEntrySysId	Sys_id de la règle d’identificateur utilisée pour identifier ce CI. Valeurs notables : Inconnu : échec de l’identification de ce CI. Pour plus de détails, voir errors. Type de données : chaîne
result.items.info	Liste d’informations supplémentaires sur le traitement de l’élément. Type de données : tableau d’objets `"info": [ { "code": "String", "message": "String", "ruleSysId": "String" } ]`
code.éléments.résultat.info	Type de reclassification qui a été ignoré. Valeurs possibles : SKIPPED_CLASS_SWITCH SKIPPED_CLASS_DOWNGRADE SKIPPED_CLASS_UPGRADE
résultat.éléments.info.message	Message qui fournit des informations supplémentaires sur le motif de l’omission de la reclassification. Type de données : chaîne
result.items.info.ruleSysId	Sys_id de la règle de restriction de reclassification correspondante. Applicable uniquement lorsque IRE ignore la reclassification en raison d’une règle de restriction de reclassification. Cette valeur est vide si la reclassification est ignorée en raison d’une charge utile ou d’un marqueur global. Type de données : chaîne
résultat.éléments.indicesentrée	Liste des valeurs d’index pour les CI du tableau de corps items de la demande qui correspondent à ce CI. Type de données : tableau d’objets `"inputIndices": [ { Number } ]`
résultat.éléments.marqueurs	Liste des valeurs de marqueurs pour une utilisation interne. Type de données : tableau `"markers": []`
résultat.éléments.mergedPayloadIds	Liste des valeurs de sys_id des charges utiles partielles de la table Charges utiles partielles IRE de la CMDB [cmdb_ire_partial_payloads] qui ont été fusionnées pendant le traitement de ce CI. Type de données : tableau `"mergedPayloadIds": [ "String" ]`
résultat.éléments.opération	Opération exécutée pour ce CI. Valeurs possibles : DELETE : un CI existant est supprimé de la table cible. INSERT : le CI est inséré dans la table cible en tant que nouvel enregistrement. NO_CHANGE : aucune opération n’est réalisée sur le CI. MISE À JOUR : un CI existant dans la table cible est mis à jour. UPDATE_WITH_DOWNGRADE : un CI existant dans la table cible est mis à jour et sa classe est changée en une classe plus générique (classe ancêtre). UPDATE_WITH_SWITCH : un CI existant dans la table cible est mis à jour et sa classe est changée en une autre classe qui n’est pas une classe ancêtres ou descendantes. UPDATE_WITH_UPGRADE : un CI existant dans la table cible est mis à jour et sa classe est changée en une classe plus spécialisée (classe descendante). Type de données : chaîne
résultat.éléments.connexes	Liste des CI associés (table : rechercher un CI) à partir du tableau du corps items.lookup de la demande. Type de données : tableau d’objets `"relatedItems": [ { "className": "String", "inputIndices": [Array], "markers": [Array], "mergedPayloadIds": [Array], "sysId": "String" } ]`
résultat.éléments.connexes.nomclasse	La sys_class_name de l’élément connexe. Type de données : chaîne
résultat.éléments.élémentsconnexes.indicesentrée	Liste des valeurs d’index pour les CI et des éléments de recherche du corps items de la demande et items.lookup des tableaux qui correspondent à cet élément connexe. Type de données : tableau d’objets `"inputIndices": [ { "mainIndex": Number, "subIndex": Number } ]`
résultat.éléments.connexes.indicesd’entrée.principalIndex	Valeur d’index du tableau de corps items de la demande qui correspond au parent CI de l’élément connexe. Type de données : nombre
result.items.relatedItems.inputIndices.subIndex	Valeur d’index du tableau du corps items.lookup de la demande qui correspond à l’élément connexe. Type de données : nombre
résultat.éléments.connexes.marqueurs	Liste des valeurs de marqueurs pour une utilisation interne. Type de données : tableau `"markers": []`
résultat.éléments.connexes.mergedPayloadIds	Liste des valeurs sys_id des entrées de la table Charges utiles partielles IRE de la CMDB [cmdb_ire_partial_payloads] qui ont été fusionnées dans ce CI au cours du traitement. Type de données : tableau `"mergedPayloadIds": [ "String" ]`
résultat.éléments.relatedSysIds	Liste des valeurs de sys_id pour les éléments connexes (éléments de recherche de table) à partir du tableau du corps items.lookup de la demande. Type de données : tableau Valeurs notables : nul : aucune sys_id n’a été identifiée pour cet élément associé. `"relatedSysIds": [ Number, Number ]`
résultat.éléments.sysId	Sys_id trouvé pour ce CI via l’identification. Valeurs notables : Inconnu : échec de l’identification de ce CI. Consultez errors pour en savoir plus. Type de données : chaîne
résultat.éléments.avertissements	Liste des avertissements rencontrés lors du traitement de ce CI. Type de données : tableau d’objets `"warnings": [ { "error": "String", "message": "String" } ]`
Résultat.Éléments.Avertissements.Erreur	Type d’avertissement rencontré lors du traitement de ce CI. Type de données : chaîne
Résultat.Éléments.Avertissements.Message	Message d’avertissement rencontré lors du traitement de ce CI. Type de données : chaîne
résultat.logContextId	ID de contexte signalé pour cette charge utile. Type de données : chaîne
résultat.relations	Liste des CI de relation dépendante du tableau de corps relations de la demande. Type de données : tableau d’objets `"relations": [ { "className": "String", "errorCount": Number, "errors": [Array], "inputIndices": [Array], "markers": [Array], "mergedPayloadIds": [Array], "operation": "String", "warnings": [Array] } ]`
résultat.relations.nomdeclasse	Le sys_class_name de ce CI de relation dépendante. Seule valeur prise en charge : cmdb_rel_ci : table Relations CI. Type de données : chaîne
résultat.relations.errorCount	Nombre d’erreurs rencontrées lors du traitement de ce CI de relation dépendante. Type de données : nombre
Résultat.Relations.Erreurs	Liste des erreurs rencontrées lors du traitement de ce CI de relation dépendante. Type de données : tableau d’objets `"errors": [ { "error": "String", "message": "String" } ]`
Résultat.Relations.Erreurs.Erreur	Type d’erreur survenue lors du traitement de ce CI de relation dépendante. Type de données : chaîne
Résultat.Relations.Erreurs.Message	Un message d’erreur est survenu lors du traitement de ce CI de relation dépendante. Type de données : chaîne
résultat.relations.indicesentrées	Liste des valeurs d’index pour les objets CI de relation dépendante dans le tableau corps relations de la demande qui correspondent à ce CI de relation dépendante. Type de données : tableau `"inputIndices": [ Number ]`
résultat.relations.marqueurs	Liste des valeurs de marqueurs pour une utilisation interne. Type de données : tableau `"markers": []`
résultat.relations.mergedPayloadIds	Liste des valeurs sys_id des charges utiles partielles de la table Charges utiles partielles [cmdb_ire_partial_payloads] IRE CMDB qui ont été fusionnées pendant le traitement de ce CI de relation dépendante. Type de données : tableau `"mergedPayloadIds": [ "String" ]`
résultat.relations.opération	Opération exécutée pour ce CI de relation dépendante. Valeurs possibles : INSERT : le CI de relation dépendante a été inséré dans la table cible en tant que nouvel enregistrement. INSERT_AS_INCOMPLETE : le CI de relation dépendante comportait des erreurs et a été inséré dans la table Charges utiles incomplètes [cmdb_ire_incomplete_payloads] IRE de la CMDB. INSERT_AS_PARTIAL : le CI de relation dépendante comportait des erreurs et a été inséré dans la table Charges utiles partielles [cmdb_ire_partial_payloads] IRE de la CMDB. NO_CHANGE : aucune opération n’a été réalisée pour le CI de relation dépendante. MISE À JOUR : un CI de relation dépendante existant dans la table cible a été mis à jour. Type de données : chaîne
Résultat.Relations.Avertissements	Liste des avertissements rencontrés lors du traitement de ce CI de relation dépendante. Type de données : tableau d’objets `"warnings": [ { "error": "String", "message": "String" } ]`
Résultat.Relations.Avertissements.Erreur	Type d’avertissement rencontré lors du traitement de ce CI de relation dépendante. Type de données : chaîne
Résultat.Relations.Avertissements.Message	Message d’avertissement rencontré lors du traitement de ce CI de relation dépendante. Type de données : chaîne

Demande cURL

Soumettez une charge utile partielle pour un CI d’ordinateur.

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

La réponse montre que la charge utile a été insérée dans la table Charges utiles partielles IRE de la CMDB [cmdb_ire_partial_payloads].

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

Soumettez une deuxième charge utile partielle qui complète la description du CI de l’ordinateur, avec l’option IRE améliorée de génération de résumé activée.

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

La réponse indique que le CI de l’ordinateur est inséré et affiche un résumé des opérations effectuées.

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

Identification et rapprochement : POST /now/identifyreconcile/query

Détermine l’opération CMDB (insérer/mettre à jour) à effectuer avec la charge utile spécifiée (corps de la demande), sans valider les opérations dans la base de données.

Utilisez ce point de terminaison pour simuler la soumission d’une charge utile (corps de la demande) au point de Identification et rapprochement : PUBLIER /now/identifyreconcile terminaison.

Format d'URL

URL avec version : /api/now/{api_version}/identifyreconcile/query

URL par défaut : /api/now/identifyreconcile/query

Remarque :

Paramètres de demande pris en charge

Tableau 13. Paramètres de chemin d'accès
Nom	Description
api_version	Facultatif. Version du point de terminaison auquel accéder. Par exemple, `v1` ou `v2`. Spécifiez uniquement cette valeur pour utiliser une version de point de terminaison autre que la plus récente. Type de données : chaîne

Tableau 14. Paramètres de requête
Nom	Description
sysparm_data_source	Source des informations sur le CI. Il doit s’agir de l’une des valeurs de choix définies pour le champ discovery_source de la table Configuration Item (Élément de configuration) [cmdb_ci]. Type de données : chaîne Par défaut : insérez la charge utile de l’API dans la table des charges utiles incomplètes.

Tableau 15. Paramètres de corps de demande (XML ou JSON)
Nom	Description
Éléments	Liste des CI à créer ou à mettre à jour. Type de données : tableau d’objets `"items": [ { "className": "String", "internal_id": "String", "lookup": [Array], "related": [Array], "settings": {Object}, "sys_object_source_info": {Object}, "values": {Object} } ]`
items.className	Requis. Le sys_class_name (nom de classe/table) du CI à créer ou à mettre à jour. Cette valeur peut être n’importe quelle CMDB table, telle que cmdb_ci_linux_server ou cmdb_ci_win_server. Type de données : chaîne
items.internal_id	Identificateur unique de cet élément dans cette charge utile. Peut être n’importe quelle valeur, mais doit être unique dans la charge utile. Type de données : chaîne
Recherche.Éléments	Tableau d’objets dans lequel chaque objet décrit un enregistrement d’identification basé sur la recherche. Ces enregistrements sont utilisés pour identifier l’élément de configuration de niveau supérieur en fonction d’une table de recherche qui fait référence à la table Élément de configuration [cmdb_ci]. Type de données : Tableau sur les objets `"lookup": [ { "className": "String", "internal_id": "String", "sys_object_source_info": {Object}, "values": {Object} } ]`
items.lookup.className	Requis. Le nom de sys_class_name ou de classe/table du CI à créer ou à mettre à jour. Cette valeur peut être n’importe quelle CMDB classe/table, telle que cmdb_serial_number ou cmdb_ci_network_adapter, ou une classe nonCMDB hiérarchique. Type de données : chaîne
items.lookup.internal_id	Identificateur unique de cet enregistrement de recherche dans cette charge utile. Peut être n’importe quelle valeur, mais doit être unique dans la charge utile. Type de données : chaîne
items.lookup.sys_objet_source_info	Objet décrivant un identificateur de CI unique pour une source de données spécifiée. Différentes sources peuvent avoir des paires nom-valeur différentes pour le même CI. Type de données : objet `"sys_object_source_info": { "source_feed": "String", "source_name": "String", "source_native_key": "String", "source_recency_timestamp": "String" }`
items.lookup.sys_object_source_info.source_feed	Nom qui identifie de manière unique le flux qui envoie ce CI. A utiliser si la source peut avoir plusieurs flux. Type de données : chaîne
items.lookup.sys_objet_source_info.nom_source	Source de données pour les informations sur le CI. Cette valeur doit être l’une des valeurs de choix définies pour le champ discovery_source de la table Élément de configuration [cmdb_ci]. Type de données : chaîne
items.lookup.sys_object_source_info.source_native_key	Clé/ID unique de la source pour le CI. Peut être n’importe quelle chaîne unique à l’élément. Type de données : chaîne
items.lookup.sys_object_source_info.source_recency_timestamp	Date et heure UTC de l’analyse du CI. Type de données : chaîne Format : JJ-MM-AAAA hh :mm :ss
éléments.recherche.valeurs	Objet décrivant les champs de cet élément de recherche sous forme de paires nom/valeur, où le nom est le nom du champ. Type de données : objet Les noms et types de champs dépendent des champs sélectionnés par l’utilisateur, tels que : `"values": { "ip_address": "String", "mac_address": "String", "serial_number": "String", "serial_number_type": "String", "valid": "String" }`
éléments.connexes	Tableau d’objets dans lequel chaque objet décrit un enregistrement d’élément à créer ou à mettre à jour, en fonction d’une table connexe qui fait référence au CI de niveau supérieur en cours d’identification. Les règles de la table Entrée connexe [cmdb_related_entry] définissent le type d’enregistrements qui peuvent figurer dans ce tableau. La table connexe peut étendre ou non la table Élément de configuration [cmdb_ci]. Ces enregistrements ne sont pas utilisés pour identifier l’élément de configuration. Type de données : tableau d’objets `"related": [ { "className": "String", "internal_id": "String", "sys_object_source_info": {Object}, "values": {Object} } ]`
items.related.className	Requis. Nom de sys_class_name ou de classe/table de l’élément connexe à créer ou à mettre à jour. Type de données : chaîne
items.related.internal_id	Identificateur unique de cet élément connexe dans cette charge utile. Peut être n’importe quelle valeur, mais doit être unique dans la charge utile. Type de données : chaîne
items.related.sys_objet_source_info	Objet décrivant un identificateur de CI unique pour une source de données spécifiée. Différentes sources peuvent avoir des paires nom-valeur différentes pour le même CI. Type de données : objet `"sys_object_source_info": { "source_feed": "String", "source_name": "String", "source_native_key": "String", "source_recency_timestamp": "String" }`
items.related.sys_object_source_info.source_feed	Nom qui identifie de manière unique le flux qui envoie cet élément associé. A utiliser si la source peut avoir plusieurs flux. Type de données : chaîne
items.related.sys_objet_source_info.nom_source	Source de données pour les informations sur l’élément connexe. Cette valeur doit être l’une des valeurs de choix définies pour le champ discovery_source de la table Élément de configuration [cmdb_ci]. Type de données : chaîne
items.related.sys_object_source_info.source_native_key	Clé/ID unique de la source pour l’élément connexe. Peut être n’importe quelle chaîne unique à l’élément. Type de données : chaîne
items.related.sys_object_source_info.source_recency_timestamp	Date et heure UTC auxquelles l’élément connexe a été analysé. Type de données : chaîne Format : JJ-MM-AAAA hh :mm :ss
Valeurs.Éléments.Connexes	Objet décrivant les champs à créer ou mettre à jour pour cet élément connexe sous forme de paires nom/valeur, où le nom est le nom du champ. Pour un champ de référence, la valeur doit être le sys_id référencé. Type de données : objet Les noms et types de champs dépendent des champs sélectionnés par l’utilisateur, tels que : `"values": { "host_name": "String", "ip_address": "String", "name": "String", "os_name": "String", "sys_class_name": "String" }`
éléments.paramètres	Objet contenant les paramètres définissant les types de mises à jour autorisés. Type de données : objet `"settings": { "skipReclassificationRestrictionRules": Boolean, "updateWithoutDowngrade": Boolean, "updateWithoutSwitch": Boolean, "updateWithoutUpgrade": Boolean }`
items.settings.skipReclassificationRestrictionRules	Marqueur indiquant si IRE doit ignorer l’exécution de la règle de restriction de reclassification qui correspond à la classe de l’élément de charge utile. Valeurs valides : vrai : ignorer l’exécution de la règle. false : exécutez la règle. Valeur par défaut : false
items.settings.updateWithoutDowngrade	Marqueur indiquant si la mise à jour et le passage à une version antérieure sont autorisés pour ce CI. Valeurs valides : vrai : mettre à jour l’élément, mais passer à une version antérieure n’est pas autorisé. false : la mise à jour de l’élément et le passage à une version antérieure sont autorisés. Type de données : booléennes Valeur par défaut : false
items.settings.updateWithoutSwitch	Marqueur indiquant si ce CI peut être mis à jour et si sa classe peut être changée. Valeurs valides : vrai : mettre à jour l’élément, mais le changement de classe n’est pas autorisé. false : la mise à jour d’article et le changement de classe sont autorisés. Type de données : booléennes Valeur par défaut : false
items.settings.updateWithoutUpgrade	Marqueur indiquant si la mise à jour et la mise à niveau sont autorisées pour ce CI. Valeurs valides : vrai : mettre à jour l’élément, mais la mise à niveau n’est pas autorisée. faux : la mise à jour et la mise à niveau de l’élément sont autorisées. Type de données : booléennes Valeur par défaut : false
items.sys_object_source_info	Objet décrivant un identificateur de CI unique. Type de données : objet `"sys_object_source_info": { "source_feed": "String", "source_name": "String", "source_native_key": "String", "source_recency_timestamp": "String" }`
items.sys_object_source_info.source_feed	Nom qui identifie de manière unique le flux qui envoie ce CI. A utiliser si la source peut avoir plusieurs flux. Type de données : chaîne
items.sys_objet_source_info.nom_source	Source de données pour les informations sur le CI. Cette valeur doit être l’une des valeurs de choix définies pour le champ discovery_source de la table Élément de configuration [cmdb_ci]. Type de données : chaîne
items.sys_object_source_info.source_native_key	Clé/ID unique de la source pour le CI. Peut être n’importe quelle chaîne unique à l’élément. Type de données : chaîne
items.sys_object_source_info.source_recency_timestamp	Date et heure UTC de l’analyse du CI. Type de données : chaîne Format : JJ-MM-AAAA hh :mm :ss
éléments.valeurs	Objet décrivant les champs à créer ou à mettre à jour pour ce CI sous forme de paires nom/valeur, où le nom est le nom du champ. Pour un champ de référence, la valeur doit être le sys_id référencé. Type de données : objet Les noms et types de champs dépendent des champs sélectionnés par l’utilisateur, tels que : `"values": { "host_name": "String", "ip_address": "String", "name": "String", "os_name": "String", "sys_class_name": "String" }`
Éléments de référence	Liste de référence entre deux éléments de la charge utile. Les valeurs de chaque élément de référence sont renseignées avant d’identifier un CI à l’aide des règles IRE définies sur une classe. Type de données : tableau d’objets `"referenceItems": [ { "referenced": "String", "referencedBy": "String", "referenceField": "String" } ]`
referenceItems.referenced	Défini internal_id pour l’élément référencé par un autre élément. Type de données : chaîne
referenceItems.referencedBy	Défini internal_id pour l’élément qui fait référence à un autre élément. Type de données : chaîne
referenceItems.referenceField	Nom du champ de référence dans la classe/la table pour l’élément referencedBy . Type de données : chaîne
relations de travail	Liste des relations entre deux éléments définis dans la charge utile. Un objet de ce tableau peut utiliser l’un des deux formats suivants : L’objet peut définir une relation entre deux éléments de niveau supérieur (uniquement) à l’aide parent de paires nom-valeur et , child les valeurs représentant les index d’éléments du tableau de charge items utile. L’objet peut définir une relation entre deux éléments quelconques, y compris les éléments de niveau supérieur, connexes ou de recherche, à l’aide de parent_id paires clé/valeur et child_id avec des valeurs représentant internal_id les valeurs définies pour ces éléments. Type de données : tableau d’objets `"relations": [ { "child": Number, "parent": Number, "sys_rel_source_info": {Object}, "type": "String" } ]` `"relations": [ { "child_id": "String", "parent_id": "String", "sys_rel_source_info": {Object}, "type": "String" } ]`
relations.enfant	Index d’entier de l’objet CI dans le items tableau qui représente l’enfant dans la relation. Type de données : nombre
relations.child_id	L’élément internal_id enfant dans la relation. Type de données : chaîne
relations.parents	Index d’entier de l’objet CI dans le items tableau qui représente le parent dans la relation. Type de données : nombre
relations.parent_id	L’élément internal_id parent dans la relation. Type de données : chaîne
relations.sys_rel_source_info	Informations sur la source de découverte pour la relation. Pour les relations de non-dépendance, ces informations figurent dans la table Sources de relation [sys_rel_source]. Type de données : objet `"sys_rel_source_info": { "source_name": "String", "source_feed": "String" }`
relations.sys_rel_source_info.nom_source	Nom de la source de découverte. Par défaut : source de découverte transmise dans le paramètre de méthode API.
relations.sys_rel_source_info.source_feed	Toute chaîne qui est une sous-découverte/analyse au sein de la source de découverte. Par défaut : « INCONNU » est stocké dans la colonne source_feed lors de la création d’un enregistrement dans sys_rel_source table.
relations.type	Type de relation existant entre les éléments parent et enfant. Il doit s’agir d’une valeur de champ de nom de la table Type de relation CI [cmdb_rel_type]. Type de données : chaîne

En-têtes

Tableau 16. En-têtes de demandes
En-tête	Description
Accepter	Format de données du corps de la réponse. Prend uniquement en charge application/json.
Type de contenu	Format des données du corps de la demande. Prend uniquement en charge application/json.

Tableau 17. En-têtes de réponses
En-tête	Description
Néant

Codes d'état

Les codes d’état suivants s’appliquent à cette action HTTP. Pour obtenir la liste des codes d’état possibles utilisés dans l’API REST, consultez Codes de réponse HTTP de l’API REST.

Tableau 18. Codes d'état
Code d'état	Description
200	Réussi. La demande a été traitée avec succès.
401	Non autorisé. Les informations d’identification de l’utilisateur sont incorrectes ou n’ont pas été transmises.
500	Erreur interne du serveur. Une erreur inattendue s’est produite lors du traitement de la demande. La réponse contient des informations supplémentaires sur l’erreur.

Paramètres du corps de la réponse (JSON ou XML)


Nom	Description
résultat	Liste des résultats produits par la requête. Type de données : tableau `"result": [ "additionalCommittedItems": [Array], "additionalCommittedRelations": [Array], "items": [Array], "relations": [Array] ]`
résultat.additionalCommittedItems	Liste des CI non inclus dans le tableau de corps items de la demande à insérer ou à mettre à jour. Type de données : tableau d’objets `"additionalCommittedItems": [ { "className": "String", "errorCount": Number, "identificationAttempts": [Array], "inputIndices": [Array], "markers": [Array], "mergedPayloads": [Array], "operation": "String", "sysId": "String" } ]`
résultat.additionalCommittedItems.className	La sys_class_name de ce CI supplémentaire. Type de données : chaîne
résultat.additionalCommittedItems.errorCount	Nombre d’erreurs rencontrées lors du traitement de ce CI supplémentaire. Type de données : nombre
résultat.additionalCommittedItems.errors	Liste des erreurs rencontrées lors du traitement de ce CI supplémentaire. Type de données : tableau d’objets `"errors": [ { "error": "String", "message": "String" } ]`
résultat.élémentscommissupplémentaires.erreurs.erreur	Type d’erreur rencontré lors du traitement de ce CI supplémentaire. Type de données : chaîne
résultat.élémentscommis.supplémentaires.erreurs.message	Message d’erreur survenu lors du traitement de ce CI supplémentaire. Type de données : chaîne
résultat.additionalCommittedItems.identificationAttempts	Liste des tentatives effectuées pour identifier ce CI supplémentaire. Type de données : tableau d’objets `"identificationAttempts": [ { "attemptResult": "String", "attributes": [Array], "hybridEntryCiAttributes": [Array], "identiferName": "String", "searchOnTable": [Array] } ]`
résultat.élémentsCommittedSupplémentaires.Tentativesd’identification.RésultatTentative	Résultat de cette tentative d’identification de CI supplémentaire. Valeurs possibles : CORRESPONDANCE : identification réussie. Un CI unique a été trouvé dans la table de règles d’identificateur qui correspond exactement aux attributs spécifiés. MULTI_MATCH : échec de l’identification avec une erreur. Des CI en double ont été trouvés dans la table de règles d’identificateur lors de la mise en correspondance avec les attributs spécifiés. NO_MATCH : échec de l’identification. Aucun CI correspondant aux attributs spécifiés n’a été trouvé dans la table de règles d’identificateur. IGNORÉ : identification non tentée. Les attributs requis pour cette recherche dans la table de règles d’identificateur n’étant pas fournis, la règle n’a donc pas été appliquée. Type de données : chaîne
résultat.additionalCommittedItems.identificationAttempts.attributes	Tableau des attributs d’entrée d’identificateur de CI utilisés au cours de cette tentative d’identification de CI supplémentaire. Type de données : tableau Les noms et types d’attributs dépendent des données du corps de la demande et de l’identificateur utilisé, par exemple : `"attributes": [ "serial_number": "String", "serial_number_type": "String" ]`
résultat.additionalCommittedItems.identificationAttempts.hybridEntryCiAttributes	Liste des attributs d’entrée d’identificateur de CI utilisés au cours de cette tentative d’identification de CI supplémentaire. Type de données : tableau Les noms et types d’attributs dépendent des données du corps de la demande et de l’identificateur utilisé, par exemple : `"hybridEntryCiAttributes": [ "name": "String", "serial_number": "String" ]`
résultat.additionalCommittedItems.identificationAttempts.identifierName	Règle d’identificateur utilisée pour cette tentative d’identification de CI supplémentaire. Type de données : chaîne
résultat.additionalCommittedItems.identificationAttempts.searchOnTable	Nom de la table recherchée pour cette tentative d’identification de CI supplémentaire. Type de données : chaîne
résultat.additionalCommittedItems.identifierEntrySysId	Sys_id la règle d’identificateur utilisée pour identifier ce CI supplémentaire. Valeurs notables : Inconnu : échec de l’identification de ce CI supplémentaire. Consultez errors pour en savoir plus. Type de données : chaîne
résultat.additionalCommittedItems.inputIndices	Liste des valeurs d’index pour les CI du tableau de corps items de la demande qui correspondent à ce CI supplémentaire. Type de données : tableau d’objets `"inputIndices": [ { Number } ]`
résultat.additionalCommittedItems.markers	Liste des valeurs de marqueurs pour une utilisation interne. Type de données : tableau `"markers": []`
résultat.additionalCommittedItems.mergedPayloads	Liste des valeurs de sys_id des charges utiles partielles de la table Charges utiles partielles IRE de la CMDB [cmdb_ire_partial_payloads] qui ont été fusionnées pendant le traitement de ce CI supplémentaire. Type de données : tableau `"mergedPayloadIds": [ "String" ]`
résultat.additionalCommittedItems.operation	Opération exécutée pour ce CI supplémentaire. Valeurs possibles : DELETE : un CI existant est supprimé de la table cible. INSERT : le CI supplémentaire est inséré dans la table cible en tant que nouvel enregistrement. NO_CHANGE : aucune opération n’est effectuée pour le CI supplémentaire. MISE À JOUR : un CI existant dans la table cible est mis à jour. UPDATE_WITH_DOWNGRADE : un CI existant dans la table cible est mis à jour et sa classe est changée en une classe plus générique (classe ancêtre). UPDATE_WITH_SWITCH : un CI existant dans la table cible est mis à jour et sa classe est changée en une autre classe qui n’est pas une classe ancêtres ou descendantes. UPDATE_WITH_UPGRADE : un CI existant dans la table cible est mis à jour et sa classe est changée en une classe plus spécialisée (classe descendante). Type de données : chaîne
résultat.additionalCommittedItems.sysId	Sys_id trouvé pour ce CI supplémentaire via l’identification. Valeurs notables : Inconnu : échec de l’identification de ce CI supplémentaire. Consultez errors pour en savoir plus. Type de données : chaîne
résultat.élémentsCommittedSupplémentaires.avertissements	Liste des avertissements rencontrés lors du traitement de ce CI supplémentaire. Type de données : tableau d’objets `"warnings": [ { "error": "String", "message": "String" } ]`
résultat.élémentssupplémentaires validés.avertissements.erreur	Type d’avertissement rencontré lors du traitement de ce CI supplémentaire. Type de données : chaîne
résultat.élémentsCommittedSupplémentaires.avertissements.message	Message d’avertissement rencontré lors du traitement de ce CI supplémentaire. Type de données : chaîne
résultat.additionalCommittedRelations	Liste des CI de relation dépendante non inclus dans la liste du corps relations de la demande à insérer ou à mettre à jour. Type de données : tableau d’objets `"additionalCommittedRelations": [ { "className": "String", "operation": "String", "markers": [Array], "inputIndices": [Array], "mergedPayloadIds": [Array] } ]`
résultat.additionalCommittedRelations.className	Le sys_class_name de ce CI de relation dépendante supplémentaire. Seule valeur prise en charge : cmdb_rel_ci : table Relations CI. Type de données : chaîne
résultat.relationsengagéessupplémentaires.errorCount	Nombre d’erreurs rencontrées lors du traitement de ce CI de relation dépendante supplémentaire. Type de données : nombre
résultat.relationsengagéessupplémentaires.erreurs	Liste des erreurs rencontrées lors du traitement de ce CI de relation dépendante supplémentaire. Type de données : tableau d’objets `"errors": [ { "error": "String", "message": "String" } ]`
résultat.relationsengagéessupplémentaires.erreurs.erreur	Type d’erreur rencontrée lors du traitement de ce CI de relation dépendante supplémentaire. Type de données : chaîne
résultat.relationsengagéessupplémentaires.erreurs.message	Un message d’erreur est survenu lors du traitement de ce CI de relation dépendante supplémentaire. Type de données : chaîne
résultat.relationsengagéessupplémentaires.indicesentrées	Liste des valeurs d’index pour les objets CI de relation dépendante dans le tableau corps relations de la demande qui correspondent à ce CI de relation dépendante supplémentaire. Type de données : tableau `"inputIndices": [ Number ]`
résultat.relationsengagéessupplémentaires.marqueurs	Liste des valeurs de marqueurs pour une utilisation interne. Type de données : tableau `"markers": []`
résultat.additionalCommittedRelations.mergedPayloadIds	Liste des valeurs de sys_id des charges utiles partielles de la table Charges utiles partielles [cmdb_ire_partial_payloads] IRE CMDB qui ont été fusionnées pendant le traitement de ce CI de relation dépendante supplémentaire. Type de données : tableau `"mergedPayloadIds": [ "String" ]`
résultat.relationsengagéessupplémentaires.opération	Opération exécutée pour ce CI de relation dépendante supplémentaire. Valeurs possibles : INSERT : le CI de relation dépendante est inséré dans la table cible en tant que nouvel enregistrement. INSERT_AS_INCOMPLETE : CI de relation dépendante comportant des erreurs et inséré dans la table Charges utiles incomplètes [cmdb_ire_incomplete_payloads] IRE de la CMDB. INSERT_AS_PARTIAL : CI de relation dépendante comportait des erreurs et est inséré dans la table Charges utiles partielles [cmdb_ire_partial_payloads] IRE de la CMDB. NO_CHANGE : aucune opération n’est réalisée pour le CI de relation dépendante. MISE À JOUR : un CI de relation dépendante existant dans la table cible est mis à jour. Type de données : chaîne
résultat.éléments	Liste des CI inclus dans le tableau de corps items de la demande. Type de données : tableau d’objets `"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] } ]`
résultat.éléments.élémentsconnexes supplémentaires	Liste des CI associés (CI de recherche de table) à partir de la table Charges utiles partielles [cmdb_ire_partial_payloads] IRE de la CMDB. Type de données : tableau d’objets `"additionalRelatedItems": [ { "className": "String", "inputIndices": [Array], "markers": [Array], "mergedPayloadIds": [Array], "sysId": "String" } ]`
result.items.additionalRelatedItems.className	La sys_class_name de l’élément connexe. Type de données : chaîne
résultat.éléments.élémentsconnexes supplémentaires.indicesd’entrée	Liste des valeurs d’index pour les CI du tableau de corps items de la demande qui correspondent à cet élément associé. Type de données : tableau `"inputIndices": [ Number ]`
résultat.éléments.supplémentairesÉlémentsConnexes.marqueurs	Liste des valeurs de marqueurs pour une utilisation interne. Type de données : tableau `"markers": []`
résultat.éléments.supplémentairesÉlémentsConnexes.fusionnésIdsPayloadIds	Liste des valeurs sys_id des charges utiles partielles de la table Charges utiles partielles [cmdb_ire_partial_payloads] IRE de CMDB qui ont été fusionnées pendant le traitement de cet élément connexe. Type de données : tableau `"mergedPayloadIds": [ "String" ]`
result.items.additionalRelatedItems.sysId	Sys_id de ce CI associé. Type de données : chaîne
result.items.className	Sys_class_name de ce CI. Type de données : chaîne
result.items.duplicateLookupIndices	Objet contenant des tableaux de valeurs d’index pour items.lookup les éléments de tableau qui font référence au même CI connexe. Le nom du tableau indique le premier élément du tableau de corps items.lookup de la demande qui fait référence à un CI connexe donné. Ses valeurs sont l’ensemble des éléments supplémentaires du même tableau qui font référence au même CI associé. Type de données : objet Cet exemple montre un cas où le deuxième élément du items.lookup tableau fait référence au même CI connexe qu’un élément ultérieur de ce tableau : `"duplicateLookupIndices": [ "2": [Array] ]`
result.items.errorCount	Nombre d’erreurs rencontrées lors du traitement de ce CI. Type de données : nombre
Résultat.Éléments.Erreurs	Liste des erreurs rencontrées lors du traitement de ce CI. Type de données : tableau d’objets `"errors": [ { "error": "String", "message": "String" } ]`
Résultat.Éléments.Erreurs.Erreur	Type d’erreur rencontrée lors du traitement de ce CI. Type de données : chaîne
Résultat.Éléments.Erreurs.Message	Un message d’erreur est survenu lors du traitement de ce CI. Type de données : chaîne
résultat.items.identificationAttempts	Liste des tentatives effectuées pour identifier ce CI. Type de données : tableau d’objets `"identificationAttempts": [ { "attemptResult": "String", "attributes": [Array], "hybridEntryCiAttributes": [Array], "identiferName": "String", "searchOnTable": [Array] } ]`
résultat.éléments.tentativesd’identification.résultat.tentative	Résultat de cette tentative d’identification de CI. Valeurs possibles : CORRESPONDANCE : identification réussie. Un CI unique a été trouvé dans la table de règles d’identificateur qui correspond exactement aux attributs spécifiés. MULTI_MATCH : échec de l’identification avec une erreur. Des CI en double ont été trouvés dans la table de règles d’identificateur lors de la mise en correspondance avec les attributs spécifiés. NO_MATCH : échec de l’identification. Aucun CI correspondant aux attributs spécifiés n’a été trouvé dans la table de règles d’identificateur. IGNORÉ : identification non tentée. Les attributs requis pour cette recherche dans la table de règles d’identificateur n’étant pas fournis, la règle n’a donc pas été appliquée. Type de données : chaîne
résultat.éléments.tentativesd’identification.attributs	Liste des attributs d’entrée d’identificateur de CI utilisés au cours de cette tentative d’identification de CI. Type de données : tableau Les noms et types d’attributs dépendent des données du corps de la demande et de l’identificateur utilisé, par exemple : `"attributes": [ "serial_number": "String", "serial_number_type": "String", ]`
résultat.items.identificationAttempts.hybridEntryCiAttributes	Liste des attributs d’entrée d’identificateur de CI utilisés au cours de cette tentative d’identification de CI. Type de données : tableau Les noms et types d’attributs dépendent des données du corps de la demande et de l’identificateur utilisé, par exemple : `"hybridEntryCiAttributes": [ "name": "String", "serial_number": "String" ]`
résultat.items.identificationAttempts.identifierName	Règle d’identificateur utilisée pour cette tentative d’identification de CI. Type de données : chaîne
résultat.items.identificationAttempts.searchOnTable	Nom de la table recherchée pour cette tentative d’identification de CI. Type de données : chaîne
result.items.identifierEntrySysId	Sys_id de la règle d’identificateur utilisée pour identifier ce CI. Valeurs notables : Inconnu : échec de l’identification de ce CI. Pour plus de détails, voir errors. Type de données : chaîne
result.items.info	Liste d’informations supplémentaires sur le traitement de l’élément. Type de données : tableau d’objets `"info": [ { "code": "String", "message": "String", "ruleSysId": "String" } ]`
code.éléments.résultat.info	Type de reclassification qui a été ignoré. Valeurs possibles : SKIPPED_CLASS_SWITCH SKIPPED_CLASS_DOWNGRADE SKIPPED_CLASS_UPGRADE
résultat.éléments.info.message	Message qui fournit des informations supplémentaires sur le motif de l’omission de la reclassification. Type de données : chaîne
result.items.info.ruleSysId	Sys_id de la règle de restriction de reclassification correspondante. Applicable uniquement lorsque IRE ignore la reclassification en raison d’une règle de restriction de reclassification. Cette valeur est vide si la reclassification est ignorée en raison d’une charge utile ou d’un marqueur global. Type de données : chaîne
résultat.éléments.indicesentrée	Liste des valeurs d’index pour les CI du tableau de corps items de la demande qui correspondent à ce CI. Type de données : tableau d’objets `"inputIndices": [ { Number } ]`
résultat.éléments.marqueurs	Liste des valeurs de marqueurs pour une utilisation interne. Type de données : tableau `"markers": []`
résultat.éléments.mergedPayloadIds	Liste des valeurs de sys_id des charges utiles partielles de la table Charges utiles partielles IRE de la CMDB [cmdb_ire_partial_payloads] qui ont été fusionnées pendant le traitement de ce CI. Type de données : tableau `"mergedPayloadIds": [ "String" ]`
résultat.éléments.opération	Opération exécutée pour ce CI. Valeurs possibles : DELETE : un CI existant est supprimé de la table cible. INSERT : le CI est inséré dans la table cible en tant que nouvel enregistrement. NO_CHANGE : aucune opération n’est réalisée sur le CI. MISE À JOUR : un CI existant dans la table cible est mis à jour. UPDATE_WITH_DOWNGRADE : un CI existant dans la table cible est mis à jour et sa classe est changée en une classe plus générique (classe ancêtre). UPDATE_WITH_SWITCH : un CI existant dans la table cible est mis à jour et sa classe est changée en une autre classe qui n’est pas une classe ancêtres ou descendantes. UPDATE_WITH_UPGRADE : un CI existant dans la table cible est mis à jour et sa classe est changée en une classe plus spécialisée (classe descendante). Type de données : chaîne
résultat.éléments.connexes	Liste des CI associés (table : rechercher un CI) à partir du tableau du corps items.lookup de la demande. Type de données : tableau d’objets `"relatedItems": [ { "className": "String", "inputIndices": [Array], "markers": [Array], "mergedPayloadIds": [Array], "sysId": "String" } ]`
résultat.éléments.connexes.nomclasse	La sys_class_name de l’élément connexe. Type de données : chaîne
résultat.éléments.élémentsconnexes.indicesentrée	Liste des valeurs d’index pour les CI et des éléments de recherche du corps items de la demande et items.lookup des tableaux qui correspondent à cet élément connexe. Type de données : tableau d’objets `"inputIndices": [ { "mainIndex": Number, "subIndex": Number } ]`
résultat.éléments.connexes.indicesd’entrée.principalIndex	Valeur d’index du tableau de corps items de la demande qui correspond au parent CI de l’élément connexe. Type de données : nombre
result.items.relatedItems.inputIndices.subIndex	Valeur d’index du tableau du corps items.lookup de la demande qui correspond à l’élément connexe. Type de données : nombre
résultat.éléments.connexes.marqueurs	Liste des valeurs de marqueurs pour une utilisation interne. Type de données : tableau `"markers": []`
résultat.éléments.connexes.mergedPayloadIds	Liste des valeurs sys_id des entrées de la table Charges utiles partielles IRE de la CMDB [cmdb_ire_partial_payloads] qui ont été fusionnées dans ce CI au cours du traitement. Type de données : tableau `"mergedPayloadIds": [ "String" ]`
résultat.éléments.relatedSysIds	Liste des valeurs de sys_id pour les éléments connexes (éléments de recherche de table) à partir du tableau du corps items.lookup de la demande. Type de données : tableau Valeurs notables : nul : aucune sys_id n’a été identifiée pour cet élément associé. `"relatedSysIds": [ Number, Number ]`
résultat.éléments.sysId	Sys_id trouvé pour ce CI via l’identification. Valeurs notables : Inconnu : échec de l’identification de ce CI. Consultez errors pour en savoir plus. Type de données : chaîne
résultat.éléments.avertissements	Liste des avertissements rencontrés lors du traitement de ce CI. Type de données : tableau d’objets `"warnings": [ { "error": "String", "message": "String" } ]`
Résultat.Éléments.Avertissements.Erreur	Type d’avertissement rencontré lors du traitement de ce CI. Type de données : chaîne
Résultat.Éléments.Avertissements.Message	Message d’avertissement rencontré lors du traitement de ce CI. Type de données : chaîne
résultat.logContextId	ID de contexte signalé pour cette charge utile. Type de données : chaîne
résultat.relations	Liste des CI de relation dépendante du tableau de corps relations de la demande. Type de données : tableau d’objets `"relations": [ { "className": "String", "errorCount": Number, "errors": [Array], "inputIndices": [Array], "markers": [Array], "mergedPayloadIds": [Array], "operation": "String", "warnings": [Array] } ]`
résultat.relations.nomdeclasse	Le sys_class_name de ce CI de relation dépendante. Seule valeur prise en charge : cmdb_rel_ci : table Relations CI. Type de données : chaîne
résultat.relations.errorCount	Nombre d’erreurs rencontrées lors du traitement de ce CI de relation dépendante. Type de données : nombre
Résultat.Relations.Erreurs	Liste des erreurs rencontrées lors du traitement de ce CI de relation dépendante. Type de données : tableau d’objets `"errors": [ { "error": "String", "message": "String" } ]`
Résultat.Relations.Erreurs.Erreur	Type d’erreur survenue lors du traitement de ce CI de relation dépendante. Type de données : chaîne
Résultat.Relations.Erreurs.Message	Un message d’erreur est survenu lors du traitement de ce CI de relation dépendante. Type de données : chaîne
résultat.relations.indicesentrées	Liste des valeurs d’index pour les objets CI de relation dépendante dans le tableau corps relations de la demande qui correspondent à ce CI de relation dépendante. Type de données : tableau `"inputIndices": [ Number ]`
résultat.relations.marqueurs	Liste des valeurs de marqueurs pour une utilisation interne. Type de données : tableau `"markers": []`
résultat.relations.mergedPayloadIds	Liste des valeurs sys_id des charges utiles partielles de la table Charges utiles partielles [cmdb_ire_partial_payloads] IRE CMDB qui ont été fusionnées pendant le traitement de ce CI de relation dépendante. Type de données : tableau `"mergedPayloadIds": [ "String" ]`
résultat.relations.opération	Opération exécutée pour ce CI de relation dépendante. Valeurs possibles : INSERT : le CI de relation dépendante a été inséré dans la table cible en tant que nouvel enregistrement. INSERT_AS_INCOMPLETE : le CI de relation dépendante comportait des erreurs et a été inséré dans la table Charges utiles incomplètes [cmdb_ire_incomplete_payloads] IRE de la CMDB. INSERT_AS_PARTIAL : le CI de relation dépendante comportait des erreurs et a été inséré dans la table Charges utiles partielles [cmdb_ire_partial_payloads] IRE de la CMDB. NO_CHANGE : aucune opération n’a été réalisée pour le CI de relation dépendante. MISE À JOUR : un CI de relation dépendante existant dans la table cible a été mis à jour. Type de données : chaîne
Résultat.Relations.Avertissements	Liste des avertissements rencontrés lors du traitement de ce CI de relation dépendante. Type de données : tableau d’objets `"warnings": [ { "error": "String", "message": "String" } ]`
Résultat.Relations.Avertissements.Erreur	Type d’avertissement rencontré lors du traitement de ce CI de relation dépendante. Type de données : chaîne
Résultat.Relations.Avertissements.Message	Message d’avertissement rencontré lors du traitement de ce CI de relation dépendante. Type de données : chaîne

Demande cURL

Simulez la soumission d’une charge utile contenant un serveur Linux (avec des recherches de numéro de série et d’élément connexe de carte réseau) et un commutateur IP, avec une relation de connexion IP entre eux.

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

Le CI du serveur Linux est identifié via une règle matérielle, recherchez son nom dans la table Matériel [cmdb_ci_hardware] et est traité comme une mise à jour d’un CI existant dans la table Serveur Linux [cmdb_ci_linux_server]. Le commutateur IP est identifié de la même manière via une règle matérielle, recherchez son nom dans la table Matériel et met à jour un CI existant dans la table Commutateur IP [cmdb_ci_ip_switch]. Enfin, la relation de connexion IP entre le serveur et le commutateur est insérée en tant que nouvel enregistrement dans la table CI Relationship (Relations CI) [cmdb_rel_ci].

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

Identification et rapprochement : POST /now/identifyreconcile/queryEnhanced

Détermine l’opération CMDB (insérer/mettre à jour) à effectuer avec la charge utile spécifiée (corps de la demande), sans valider les opérations dans la base de données.

Utilisez ce point de terminaison pour simuler la soumission d’une charge utile (corps de la demande) au point de Identification et rapprochement : PUBLIER /now/identifyreconcile/enhanced terminaison.

Cette méthode est similaire à la Identification et rapprochement : POST /now/identifyreconcile/query méthode, mais ajoute les fonctionnalités suivantes :

Charges utiles partielles
- Si un élément présente un avertissement ou une erreur, indique si une opération d’élément est INSERT_AS_PARTIAL ou INSERT_INCOMPLETE.
- Renvoie le sys_ids des charges utiles partielles qui ont été fusionnées avec des charges utiles partielles existantes.
Prend en charge la fonctionnalité de déduplication de la charge utile.
Génère un résumé.

Format d'URL

URL avec version : /api/now/{api_version}/identifyreconcile/queryEnhanced

URL par défaut : /api/now/identifyreconcile/queryEnhanced

Remarque :

Paramètres de demande pris en charge

Tableau 19. Paramètres de chemin d'accès
Nom	Description
api_version	Facultatif. Version du point de terminaison auquel accéder. Par exemple, `v1` ou `v2`. Spécifiez uniquement cette valeur pour utiliser une version de point de terminaison autre que la plus récente. Type de données : chaîne

Tableau 20. Paramètres de requête
Nom	Description
options	Liste séparée par des virgules des paires nom-valeur représentant les options IRE améliorée appliquées à la demande. Par exemple, pour remplacer les valeurs par défaut des charges utiles partielles, des validations partielles, des charges utiles dédupliquées et générer un résumé Options IRE améliorées : `partial_payloads :false,partial_commits :false,deduplicate_payloads :false,generate_summary :true` Remarque : Par défaut ou si partial_payloads est défini sur true, les deux partial_commits et deduplicate_payloads sont activés, même s’ils sont définis sur false, car ces fonctionnalités sont essentielles pour la fonctionnalité de charges utiles partielles. Pour plus d’informations sur les options IRE améliorées, voir Moteur d’identification et de rapprochement (IRE). Valeurs valides pour chaque paire nom-valeur : vrai : activez cette option IRE améliorée. faux : désactivez cette option IRE améliorée. Type de données : chaîne
sysparm_data_source	Source des informations sur le CI. Il doit s’agir de l’une des valeurs de choix définies pour le champ discovery_source de la table Configuration Item (Élément de configuration) [cmdb_ci]. Type de données : chaîne Par défaut : insérez la charge utile de l’API dans la table des charges utiles incomplètes.

Tableau 21. Paramètres de corps de demande (XML ou JSON)
Nom	Description
Éléments	Liste des CI à créer ou à mettre à jour. Type de données : tableau d’objets `"items": [ { "className": "String", "internal_id": "String", "lookup": [Array], "related": [Array], "settings": {Object}, "sys_object_source_info": {Object}, "values": {Object} } ]`
items.className	Requis. Le sys_class_name (nom de classe/table) du CI à créer ou à mettre à jour. Cette valeur peut être n’importe quelle CMDB table, telle que cmdb_ci_linux_server ou cmdb_ci_win_server. Type de données : chaîne
items.internal_id	Identificateur unique de cet élément dans cette charge utile. Peut être n’importe quelle valeur, mais doit être unique dans la charge utile. Type de données : chaîne
Recherche.Éléments	Tableau d’objets dans lequel chaque objet décrit un enregistrement d’identification basé sur la recherche. Ces enregistrements sont utilisés pour identifier l’élément de configuration de niveau supérieur en fonction d’une table de recherche qui fait référence à la table Élément de configuration [cmdb_ci]. Type de données : Tableau sur les objets `"lookup": [ { "className": "String", "internal_id": "String", "sys_object_source_info": {Object}, "values": {Object} } ]`
items.lookup.className	Requis. Le nom de sys_class_name ou de classe/table du CI à créer ou à mettre à jour. Cette valeur peut être n’importe quelle CMDB classe/table, telle que cmdb_serial_number ou cmdb_ci_network_adapter, ou une classe nonCMDB hiérarchique. Type de données : chaîne
items.lookup.internal_id	Identificateur unique de cet enregistrement de recherche dans cette charge utile. Peut être n’importe quelle valeur, mais doit être unique dans la charge utile. Type de données : chaîne
items.lookup.sys_objet_source_info	Objet décrivant un identificateur de CI unique pour une source de données spécifiée. Différentes sources peuvent avoir des paires nom-valeur différentes pour le même CI. Type de données : objet `"sys_object_source_info": { "source_feed": "String", "source_name": "String", "source_native_key": "String", "source_recency_timestamp": "String" }`
items.lookup.sys_object_source_info.source_feed	Nom qui identifie de manière unique le flux qui envoie ce CI. A utiliser si la source peut avoir plusieurs flux. Type de données : chaîne
items.lookup.sys_objet_source_info.nom_source	Source de données pour les informations sur le CI. Cette valeur doit être l’une des valeurs de choix définies pour le champ discovery_source de la table Élément de configuration [cmdb_ci]. Type de données : chaîne
items.lookup.sys_object_source_info.source_native_key	Clé/ID unique de la source pour le CI. Peut être n’importe quelle chaîne unique à l’élément. Type de données : chaîne
items.lookup.sys_object_source_info.source_recency_timestamp	Date et heure UTC de l’analyse du CI. Type de données : chaîne Format : JJ-MM-AAAA hh :mm :ss
éléments.recherche.valeurs	Objet décrivant les champs de cet élément de recherche sous forme de paires nom/valeur, où le nom est le nom du champ. Type de données : objet Les noms et types de champs dépendent des champs sélectionnés par l’utilisateur, tels que : `"values": { "ip_address": "String", "mac_address": "String", "serial_number": "String", "serial_number_type": "String", "valid": "String" }`
éléments.connexes	Tableau d’objets dans lequel chaque objet décrit un enregistrement d’élément à créer ou à mettre à jour, en fonction d’une table connexe qui fait référence au CI de niveau supérieur en cours d’identification. Les règles de la table Entrée connexe [cmdb_related_entry] définissent le type d’enregistrements qui peuvent figurer dans ce tableau. La table connexe peut étendre ou non la table Élément de configuration [cmdb_ci]. Ces enregistrements ne sont pas utilisés pour identifier l’élément de configuration. Type de données : tableau d’objets `"related": [ { "className": "String", "internal_id": "String", "sys_object_source_info": {Object}, "values": {Object} } ]`
items.related.className	Requis. Nom de sys_class_name ou de classe/table de l’élément connexe à créer ou à mettre à jour. Type de données : chaîne
items.related.internal_id	Identificateur unique de cet élément connexe dans cette charge utile. Peut être n’importe quelle valeur, mais doit être unique dans la charge utile. Type de données : chaîne
items.related.sys_objet_source_info	Objet décrivant un identificateur de CI unique pour une source de données spécifiée. Différentes sources peuvent avoir des paires nom-valeur différentes pour le même CI. Type de données : objet `"sys_object_source_info": { "source_feed": "String", "source_name": "String", "source_native_key": "String", "source_recency_timestamp": "String" }`
items.related.sys_object_source_info.source_feed	Nom qui identifie de manière unique le flux qui envoie cet élément associé. A utiliser si la source peut avoir plusieurs flux. Type de données : chaîne
items.related.sys_objet_source_info.nom_source	Source de données pour les informations sur l’élément connexe. Cette valeur doit être l’une des valeurs de choix définies pour le champ discovery_source de la table Élément de configuration [cmdb_ci]. Type de données : chaîne
items.related.sys_object_source_info.source_native_key	Clé/ID unique de la source pour l’élément connexe. Peut être n’importe quelle chaîne unique à l’élément. Type de données : chaîne
items.related.sys_object_source_info.source_recency_timestamp	Date et heure UTC auxquelles l’élément connexe a été analysé. Type de données : chaîne Format : JJ-MM-AAAA hh :mm :ss
Valeurs.Éléments.Connexes	Objet décrivant les champs à créer ou mettre à jour pour cet élément connexe sous forme de paires nom/valeur, où le nom est le nom du champ. Pour un champ de référence, la valeur doit être le sys_id référencé. Type de données : objet Les noms et types de champs dépendent des champs sélectionnés par l’utilisateur, tels que : `"values": { "host_name": "String", "ip_address": "String", "name": "String", "os_name": "String", "sys_class_name": "String" }`
éléments.paramètres	Objet contenant les paramètres définissant les types de mises à jour autorisés. Type de données : objet `"settings": { "skipReclassificationRestrictionRules": Boolean, "updateWithoutDowngrade": Boolean, "updateWithoutSwitch": Boolean, "updateWithoutUpgrade": Boolean }`
items.settings.skipReclassificationRestrictionRules	Marqueur indiquant si IRE doit ignorer l’exécution de la règle de restriction de reclassification qui correspond à la classe de l’élément de charge utile. Valeurs valides : vrai : ignorer l’exécution de la règle. false : exécutez la règle. Valeur par défaut : false
items.settings.updateWithoutDowngrade	Marqueur indiquant si la mise à jour et le passage à une version antérieure sont autorisés pour ce CI. Valeurs valides : vrai : mettre à jour l’élément, mais passer à une version antérieure n’est pas autorisé. false : la mise à jour de l’élément et le passage à une version antérieure sont autorisés. Type de données : booléennes Valeur par défaut : false
items.settings.updateWithoutSwitch	Marqueur indiquant si ce CI peut être mis à jour et si sa classe peut être changée. Valeurs valides : vrai : mettre à jour l’élément, mais le changement de classe n’est pas autorisé. false : la mise à jour d’article et le changement de classe sont autorisés. Type de données : booléennes Valeur par défaut : false
items.settings.updateWithoutUpgrade	Marqueur indiquant si la mise à jour et la mise à niveau sont autorisées pour ce CI. Valeurs valides : vrai : mettre à jour l’élément, mais la mise à niveau n’est pas autorisée. faux : la mise à jour et la mise à niveau de l’élément sont autorisées. Type de données : booléennes Valeur par défaut : false
items.sys_object_source_info	Objet décrivant un identificateur de CI unique. Type de données : objet `"sys_object_source_info": { "source_feed": "String", "source_name": "String", "source_native_key": "String", "source_recency_timestamp": "String" }`
items.sys_object_source_info.source_feed	Nom qui identifie de manière unique le flux qui envoie ce CI. A utiliser si la source peut avoir plusieurs flux. Type de données : chaîne
items.sys_objet_source_info.nom_source	Source de données pour les informations sur le CI. Cette valeur doit être l’une des valeurs de choix définies pour le champ discovery_source de la table Élément de configuration [cmdb_ci]. Type de données : chaîne
items.sys_object_source_info.source_native_key	Clé/ID unique de la source pour le CI. Peut être n’importe quelle chaîne unique à l’élément. Type de données : chaîne
items.sys_object_source_info.source_recency_timestamp	Date et heure UTC de l’analyse du CI. Type de données : chaîne Format : JJ-MM-AAAA hh :mm :ss
éléments.valeurs	Objet décrivant les champs à créer ou à mettre à jour pour ce CI sous forme de paires nom/valeur, où le nom est le nom du champ. Pour un champ de référence, la valeur doit être le sys_id référencé. Type de données : objet Les noms et types de champs dépendent des champs sélectionnés par l’utilisateur, tels que : `"values": { "host_name": "String", "ip_address": "String", "name": "String", "os_name": "String", "sys_class_name": "String" }`
Éléments de référence	Liste de référence entre deux éléments de la charge utile. Les valeurs de chaque élément de référence sont renseignées avant d’identifier un CI à l’aide des règles IRE définies sur une classe. Type de données : tableau d’objets `"referenceItems": [ { "referenced": "String", "referencedBy": "String", "referenceField": "String" } ]`
referenceItems.referenced	Défini internal_id pour l’élément référencé par un autre élément. Type de données : chaîne
referenceItems.referencedBy	Défini internal_id pour l’élément qui fait référence à un autre élément. Type de données : chaîne
referenceItems.referenceField	Nom du champ de référence dans la classe/la table pour l’élément referencedBy . Type de données : chaîne
relations de travail	Liste des relations entre deux éléments définis dans la charge utile. Un objet de ce tableau peut utiliser l’un des deux formats suivants : L’objet peut définir une relation entre deux éléments de niveau supérieur (uniquement) à l’aide parent de paires nom-valeur et , child les valeurs représentant les index d’éléments du tableau de charge items utile. L’objet peut définir une relation entre deux éléments quelconques, y compris les éléments de niveau supérieur, connexes ou de recherche, à l’aide de parent_id paires clé/valeur et child_id avec des valeurs représentant internal_id les valeurs définies pour ces éléments. Type de données : tableau d’objets `"relations": [ { "child": Number, "parent": Number, "sys_rel_source_info": {Object}, "type": "String" } ]` `"relations": [ { "child_id": "String", "parent_id": "String", "sys_rel_source_info": {Object}, "type": "String" } ]`
relations.enfant	Index d’entier de l’objet CI dans le items tableau qui représente l’enfant dans la relation. Type de données : nombre
relations.child_id	L’élément internal_id enfant dans la relation. Type de données : chaîne
relations.parents	Index d’entier de l’objet CI dans le items tableau qui représente le parent dans la relation. Type de données : nombre
relations.parent_id	L’élément internal_id parent dans la relation. Type de données : chaîne
relations.sys_rel_source_info	Informations sur la source de découverte pour la relation. Pour les relations de non-dépendance, ces informations figurent dans la table Sources de relation [sys_rel_source]. Type de données : objet `"sys_rel_source_info": { "source_name": "String", "source_feed": "String" }`
relations.sys_rel_source_info.nom_source	Nom de la source de découverte. Par défaut : source de découverte transmise dans le paramètre de méthode API.
relations.sys_rel_source_info.source_feed	Toute chaîne qui est une sous-découverte/analyse au sein de la source de découverte. Par défaut : « INCONNU » est stocké dans la colonne source_feed lors de la création d’un enregistrement dans sys_rel_source table.
relations.type	Type de relation existant entre les éléments parent et enfant. Il doit s’agir d’une valeur de champ de nom de la table Type de relation CI [cmdb_rel_type]. Type de données : chaîne

En-têtes

Tableau 22. En-têtes de demandes
En-tête	Description
Accepter	Format de données du corps de la réponse. Prend uniquement en charge application/json.
Type de contenu	Format des données du corps de la demande. Prend uniquement en charge application/json.

Tableau 23. En-têtes de réponses
En-tête	Description
Néant

Codes d'état

Les codes d’état suivants s’appliquent à cette action HTTP. Pour obtenir la liste des codes d’état possibles utilisés dans l’API REST, consultez Codes de réponse HTTP de l’API REST.

Tableau 24. Codes d'état
Code d'état	Description
200	Réussi. La demande a été traitée avec succès.
401	Non autorisé. Les informations d’identification de l’utilisateur sont incorrectes ou n’ont pas été transmises.
500	Erreur interne du serveur. Une erreur inattendue s’est produite lors du traitement de la demande. Détail du message d’erreur « Le bloc [...] n’est pas une entrée valide » indique que le paramètre de options requête n’est pas au format de paire nom-valeur correct. Par exemple, la spécification d’un options paramètre de `partiel` produit un code d’état 500 avec « Chunk [partial] is not a valid entry » (Bloc [partiel] n’est pas une entrée valide) dans le détail du message.

Paramètres du corps de la réponse (JSON ou XML)


Nom	Description
résultat	Liste des résultats produits par la requête. Type de données : tableau `"result": [ "additionalCommittedItems": [Array], "additionalCommittedRelations": [Array], "items": [Array], "relations": [Array] ]`
résultat.additionalCommittedItems	Liste des CI non inclus dans le tableau de corps items de la demande à insérer ou à mettre à jour. Type de données : tableau d’objets `"additionalCommittedItems": [ { "className": "String", "errorCount": Number, "identificationAttempts": [Array], "inputIndices": [Array], "markers": [Array], "mergedPayloads": [Array], "operation": "String", "sysId": "String" } ]`
résultat.additionalCommittedItems.className	La sys_class_name de ce CI supplémentaire. Type de données : chaîne
résultat.additionalCommittedItems.errorCount	Nombre d’erreurs rencontrées lors du traitement de ce CI supplémentaire. Type de données : nombre
résultat.additionalCommittedItems.errors	Liste des erreurs rencontrées lors du traitement de ce CI supplémentaire. Type de données : tableau d’objets `"errors": [ { "error": "String", "message": "String" } ]`
résultat.élémentscommissupplémentaires.erreurs.erreur	Type d’erreur rencontré lors du traitement de ce CI supplémentaire. Type de données : chaîne
résultat.élémentscommis.supplémentaires.erreurs.message	Message d’erreur survenu lors du traitement de ce CI supplémentaire. Type de données : chaîne
résultat.additionalCommittedItems.identificationAttempts	Liste des tentatives effectuées pour identifier ce CI supplémentaire. Type de données : tableau d’objets `"identificationAttempts": [ { "attemptResult": "String", "attributes": [Array], "hybridEntryCiAttributes": [Array], "identiferName": "String", "searchOnTable": [Array] } ]`
résultat.élémentsCommittedSupplémentaires.Tentativesd’identification.RésultatTentative	Résultat de cette tentative d’identification de CI supplémentaire. Valeurs possibles : CORRESPONDANCE : identification réussie. Un CI unique a été trouvé dans la table de règles d’identificateur qui correspond exactement aux attributs spécifiés. MULTI_MATCH : échec de l’identification avec une erreur. Des CI en double ont été trouvés dans la table de règles d’identificateur lors de la mise en correspondance avec les attributs spécifiés. NO_MATCH : échec de l’identification. Aucun CI correspondant aux attributs spécifiés n’a été trouvé dans la table de règles d’identificateur. IGNORÉ : identification non tentée. Les attributs requis pour cette recherche dans la table de règles d’identificateur n’étant pas fournis, la règle n’a donc pas été appliquée. Type de données : chaîne
résultat.additionalCommittedItems.identificationAttempts.attributes	Tableau des attributs d’entrée d’identificateur de CI utilisés au cours de cette tentative d’identification de CI supplémentaire. Type de données : tableau Les noms et types d’attributs dépendent des données du corps de la demande et de l’identificateur utilisé, par exemple : `"attributes": [ "serial_number": "String", "serial_number_type": "String" ]`
résultat.additionalCommittedItems.identificationAttempts.hybridEntryCiAttributes	Liste des attributs d’entrée d’identificateur de CI utilisés au cours de cette tentative d’identification de CI supplémentaire. Type de données : tableau Les noms et types d’attributs dépendent des données du corps de la demande et de l’identificateur utilisé, par exemple : `"hybridEntryCiAttributes": [ "name": "String", "serial_number": "String" ]`
résultat.additionalCommittedItems.identificationAttempts.identifierName	Règle d’identificateur utilisée pour cette tentative d’identification de CI supplémentaire. Type de données : chaîne
résultat.additionalCommittedItems.identificationAttempts.searchOnTable	Nom de la table recherchée pour cette tentative d’identification de CI supplémentaire. Type de données : chaîne
résultat.additionalCommittedItems.identifierEntrySysId	Sys_id la règle d’identificateur utilisée pour identifier ce CI supplémentaire. Valeurs notables : Inconnu : échec de l’identification de ce CI supplémentaire. Consultez errors pour en savoir plus. Type de données : chaîne
résultat.additionalCommittedItems.inputIndices	Liste des valeurs d’index pour les CI du tableau de corps items de la demande qui correspondent à ce CI supplémentaire. Type de données : tableau d’objets `"inputIndices": [ { Number } ]`
résultat.additionalCommittedItems.markers	Liste des valeurs de marqueurs pour une utilisation interne. Type de données : tableau `"markers": []`
résultat.additionalCommittedItems.mergedPayloads	Liste des valeurs de sys_id des charges utiles partielles de la table Charges utiles partielles IRE de la CMDB [cmdb_ire_partial_payloads] qui ont été fusionnées pendant le traitement de ce CI supplémentaire. Type de données : tableau `"mergedPayloadIds": [ "String" ]`
résultat.additionalCommittedItems.operation	Opération exécutée pour ce CI supplémentaire. Valeurs possibles : DELETE : un CI existant est supprimé de la table cible. INSERT : le CI supplémentaire est inséré dans la table cible en tant que nouvel enregistrement. NO_CHANGE : aucune opération n’est effectuée pour le CI supplémentaire. MISE À JOUR : un CI existant dans la table cible est mis à jour. UPDATE_WITH_DOWNGRADE : un CI existant dans la table cible est mis à jour et sa classe est changée en une classe plus générique (classe ancêtre). UPDATE_WITH_SWITCH : un CI existant dans la table cible est mis à jour et sa classe est changée en une autre classe qui n’est pas une classe ancêtres ou descendantes. UPDATE_WITH_UPGRADE : un CI existant dans la table cible est mis à jour et sa classe est changée en une classe plus spécialisée (classe descendante). Type de données : chaîne
résultat.additionalCommittedItems.sysId	Sys_id trouvé pour ce CI supplémentaire via l’identification. Valeurs notables : Inconnu : échec de l’identification de ce CI supplémentaire. Consultez errors pour en savoir plus. Type de données : chaîne
résultat.élémentsCommittedSupplémentaires.avertissements	Liste des avertissements rencontrés lors du traitement de ce CI supplémentaire. Type de données : tableau d’objets `"warnings": [ { "error": "String", "message": "String" } ]`
résultat.élémentssupplémentaires validés.avertissements.erreur	Type d’avertissement rencontré lors du traitement de ce CI supplémentaire. Type de données : chaîne
résultat.élémentsCommittedSupplémentaires.avertissements.message	Message d’avertissement rencontré lors du traitement de ce CI supplémentaire. Type de données : chaîne
résultat.additionalCommittedRelations	Liste des CI de relation dépendante non inclus dans la liste du corps relations de la demande à insérer ou à mettre à jour. Type de données : tableau d’objets `"additionalCommittedRelations": [ { "className": "String", "operation": "String", "markers": [Array], "inputIndices": [Array], "mergedPayloadIds": [Array] } ]`
résultat.additionalCommittedRelations.className	Le sys_class_name de ce CI de relation dépendante supplémentaire. Seule valeur prise en charge : cmdb_rel_ci : table Relations CI. Type de données : chaîne
résultat.relationsengagéessupplémentaires.errorCount	Nombre d’erreurs rencontrées lors du traitement de ce CI de relation dépendante supplémentaire. Type de données : nombre
résultat.relationsengagéessupplémentaires.erreurs	Liste des erreurs rencontrées lors du traitement de ce CI de relation dépendante supplémentaire. Type de données : tableau d’objets `"errors": [ { "error": "String", "message": "String" } ]`
résultat.relationsengagéessupplémentaires.erreurs.erreur	Type d’erreur rencontrée lors du traitement de ce CI de relation dépendante supplémentaire. Type de données : chaîne
résultat.relationsengagéessupplémentaires.erreurs.message	Un message d’erreur est survenu lors du traitement de ce CI de relation dépendante supplémentaire. Type de données : chaîne
résultat.relationsengagéessupplémentaires.indicesentrées	Liste des valeurs d’index pour les objets CI de relation dépendante dans le tableau corps relations de la demande qui correspondent à ce CI de relation dépendante supplémentaire. Type de données : tableau `"inputIndices": [ Number ]`
résultat.relationsengagéessupplémentaires.marqueurs	Liste des valeurs de marqueurs pour une utilisation interne. Type de données : tableau `"markers": []`
résultat.additionalCommittedRelations.mergedPayloadIds	Liste des valeurs de sys_id des charges utiles partielles de la table Charges utiles partielles [cmdb_ire_partial_payloads] IRE CMDB qui ont été fusionnées pendant le traitement de ce CI de relation dépendante supplémentaire. Type de données : tableau `"mergedPayloadIds": [ "String" ]`
résultat.relationsengagéessupplémentaires.opération	Opération exécutée pour ce CI de relation dépendante supplémentaire. Valeurs possibles : INSERT : le CI de relation dépendante est inséré dans la table cible en tant que nouvel enregistrement. INSERT_AS_INCOMPLETE : CI de relation dépendante comportant des erreurs et inséré dans la table Charges utiles incomplètes [cmdb_ire_incomplete_payloads] IRE de la CMDB. INSERT_AS_PARTIAL : CI de relation dépendante comportait des erreurs et est inséré dans la table Charges utiles partielles [cmdb_ire_partial_payloads] IRE de la CMDB. NO_CHANGE : aucune opération n’est réalisée pour le CI de relation dépendante. MISE À JOUR : un CI de relation dépendante existant dans la table cible est mis à jour. Type de données : chaîne
résultat.éléments	Liste des CI inclus dans le tableau de corps items de la demande. Type de données : tableau d’objets `"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] } ]`
résultat.éléments.élémentsconnexes supplémentaires	Liste des CI associés (CI de recherche de table) à partir de la table Charges utiles partielles [cmdb_ire_partial_payloads] IRE de la CMDB. Type de données : tableau d’objets `"additionalRelatedItems": [ { "className": "String", "inputIndices": [Array], "markers": [Array], "mergedPayloadIds": [Array], "sysId": "String" } ]`
result.items.additionalRelatedItems.className	La sys_class_name de l’élément connexe. Type de données : chaîne
résultat.éléments.élémentsconnexes supplémentaires.indicesd’entrée	Liste des valeurs d’index pour les CI du tableau de corps items de la demande qui correspondent à cet élément associé. Type de données : tableau `"inputIndices": [ Number ]`
résultat.éléments.supplémentairesÉlémentsConnexes.marqueurs	Liste des valeurs de marqueurs pour une utilisation interne. Type de données : tableau `"markers": []`
résultat.éléments.supplémentairesÉlémentsConnexes.fusionnésIdsPayloadIds	Liste des valeurs sys_id des charges utiles partielles de la table Charges utiles partielles [cmdb_ire_partial_payloads] IRE de CMDB qui ont été fusionnées pendant le traitement de cet élément connexe. Type de données : tableau `"mergedPayloadIds": [ "String" ]`
result.items.additionalRelatedItems.sysId	Sys_id de ce CI associé. Type de données : chaîne
result.items.className	Sys_class_name de ce CI. Type de données : chaîne
result.items.duplicateLookupIndices	Objet contenant des tableaux de valeurs d’index pour items.lookup les éléments de tableau qui font référence au même CI connexe. Le nom du tableau indique le premier élément du tableau de corps items.lookup de la demande qui fait référence à un CI connexe donné. Ses valeurs sont l’ensemble des éléments supplémentaires du même tableau qui font référence au même CI associé. Type de données : objet Cet exemple montre un cas où le deuxième élément du items.lookup tableau fait référence au même CI connexe qu’un élément ultérieur de ce tableau : `"duplicateLookupIndices": [ "2": [Array] ]`
result.items.errorCount	Nombre d’erreurs rencontrées lors du traitement de ce CI. Type de données : nombre
Résultat.Éléments.Erreurs	Liste des erreurs rencontrées lors du traitement de ce CI. Type de données : tableau d’objets `"errors": [ { "error": "String", "message": "String" } ]`
Résultat.Éléments.Erreurs.Erreur	Type d’erreur rencontrée lors du traitement de ce CI. Type de données : chaîne
Résultat.Éléments.Erreurs.Message	Un message d’erreur est survenu lors du traitement de ce CI. Type de données : chaîne
résultat.items.identificationAttempts	Liste des tentatives effectuées pour identifier ce CI. Type de données : tableau d’objets `"identificationAttempts": [ { "attemptResult": "String", "attributes": [Array], "hybridEntryCiAttributes": [Array], "identiferName": "String", "searchOnTable": [Array] } ]`
résultat.éléments.tentativesd’identification.résultat.tentative	Résultat de cette tentative d’identification de CI. Valeurs possibles : CORRESPONDANCE : identification réussie. Un CI unique a été trouvé dans la table de règles d’identificateur qui correspond exactement aux attributs spécifiés. MULTI_MATCH : échec de l’identification avec une erreur. Des CI en double ont été trouvés dans la table de règles d’identificateur lors de la mise en correspondance avec les attributs spécifiés. NO_MATCH : échec de l’identification. Aucun CI correspondant aux attributs spécifiés n’a été trouvé dans la table de règles d’identificateur. IGNORÉ : identification non tentée. Les attributs requis pour cette recherche dans la table de règles d’identificateur n’étant pas fournis, la règle n’a donc pas été appliquée. Type de données : chaîne
résultat.éléments.tentativesd’identification.attributs	Liste des attributs d’entrée d’identificateur de CI utilisés au cours de cette tentative d’identification de CI. Type de données : tableau Les noms et types d’attributs dépendent des données du corps de la demande et de l’identificateur utilisé, par exemple : `"attributes": [ "serial_number": "String", "serial_number_type": "String", ]`
résultat.items.identificationAttempts.hybridEntryCiAttributes	Liste des attributs d’entrée d’identificateur de CI utilisés au cours de cette tentative d’identification de CI. Type de données : tableau Les noms et types d’attributs dépendent des données du corps de la demande et de l’identificateur utilisé, par exemple : `"hybridEntryCiAttributes": [ "name": "String", "serial_number": "String" ]`
résultat.items.identificationAttempts.identifierName	Règle d’identificateur utilisée pour cette tentative d’identification de CI. Type de données : chaîne
résultat.items.identificationAttempts.searchOnTable	Nom de la table recherchée pour cette tentative d’identification de CI. Type de données : chaîne
result.items.identifierEntrySysId	Sys_id de la règle d’identificateur utilisée pour identifier ce CI. Valeurs notables : Inconnu : échec de l’identification de ce CI. Pour plus de détails, voir errors. Type de données : chaîne
result.items.info	Liste d’informations supplémentaires sur le traitement de l’élément. Type de données : tableau d’objets `"info": [ { "code": "String", "message": "String", "ruleSysId": "String" } ]`
code.éléments.résultat.info	Type de reclassification qui a été ignoré. Valeurs possibles : SKIPPED_CLASS_SWITCH SKIPPED_CLASS_DOWNGRADE SKIPPED_CLASS_UPGRADE
résultat.éléments.info.message	Message qui fournit des informations supplémentaires sur le motif de l’omission de la reclassification. Type de données : chaîne
result.items.info.ruleSysId	Sys_id de la règle de restriction de reclassification correspondante. Applicable uniquement lorsque IRE ignore la reclassification en raison d’une règle de restriction de reclassification. Cette valeur est vide si la reclassification est ignorée en raison d’une charge utile ou d’un marqueur global. Type de données : chaîne
résultat.éléments.indicesentrée	Liste des valeurs d’index pour les CI du tableau de corps items de la demande qui correspondent à ce CI. Type de données : tableau d’objets `"inputIndices": [ { Number } ]`
résultat.éléments.marqueurs	Liste des valeurs de marqueurs pour une utilisation interne. Type de données : tableau `"markers": []`
résultat.éléments.mergedPayloadIds	Liste des valeurs de sys_id des charges utiles partielles de la table Charges utiles partielles IRE de la CMDB [cmdb_ire_partial_payloads] qui ont été fusionnées pendant le traitement de ce CI. Type de données : tableau `"mergedPayloadIds": [ "String" ]`
résultat.éléments.opération	Opération exécutée pour ce CI. Valeurs possibles : DELETE : un CI existant est supprimé de la table cible. INSERT : le CI est inséré dans la table cible en tant que nouvel enregistrement. NO_CHANGE : aucune opération n’est réalisée sur le CI. MISE À JOUR : un CI existant dans la table cible est mis à jour. UPDATE_WITH_DOWNGRADE : un CI existant dans la table cible est mis à jour et sa classe est changée en une classe plus générique (classe ancêtre). UPDATE_WITH_SWITCH : un CI existant dans la table cible est mis à jour et sa classe est changée en une autre classe qui n’est pas une classe ancêtres ou descendantes. UPDATE_WITH_UPGRADE : un CI existant dans la table cible est mis à jour et sa classe est changée en une classe plus spécialisée (classe descendante). Type de données : chaîne
résultat.éléments.connexes	Liste des CI associés (table : rechercher un CI) à partir du tableau du corps items.lookup de la demande. Type de données : tableau d’objets `"relatedItems": [ { "className": "String", "inputIndices": [Array], "markers": [Array], "mergedPayloadIds": [Array], "sysId": "String" } ]`
résultat.éléments.connexes.nomclasse	La sys_class_name de l’élément connexe. Type de données : chaîne
résultat.éléments.élémentsconnexes.indicesentrée	Liste des valeurs d’index pour les CI et des éléments de recherche du corps items de la demande et items.lookup des tableaux qui correspondent à cet élément connexe. Type de données : tableau d’objets `"inputIndices": [ { "mainIndex": Number, "subIndex": Number } ]`
résultat.éléments.connexes.indicesd’entrée.principalIndex	Valeur d’index du tableau de corps items de la demande qui correspond au parent CI de l’élément connexe. Type de données : nombre
result.items.relatedItems.inputIndices.subIndex	Valeur d’index du tableau du corps items.lookup de la demande qui correspond à l’élément connexe. Type de données : nombre
résultat.éléments.connexes.marqueurs	Liste des valeurs de marqueurs pour une utilisation interne. Type de données : tableau `"markers": []`
résultat.éléments.connexes.mergedPayloadIds	Liste des valeurs sys_id des entrées de la table Charges utiles partielles IRE de la CMDB [cmdb_ire_partial_payloads] qui ont été fusionnées dans ce CI au cours du traitement. Type de données : tableau `"mergedPayloadIds": [ "String" ]`
résultat.éléments.relatedSysIds	Liste des valeurs de sys_id pour les éléments connexes (éléments de recherche de table) à partir du tableau du corps items.lookup de la demande. Type de données : tableau Valeurs notables : nul : aucune sys_id n’a été identifiée pour cet élément associé. `"relatedSysIds": [ Number, Number ]`
résultat.éléments.sysId	Sys_id trouvé pour ce CI via l’identification. Valeurs notables : Inconnu : échec de l’identification de ce CI. Consultez errors pour en savoir plus. Type de données : chaîne
résultat.éléments.avertissements	Liste des avertissements rencontrés lors du traitement de ce CI. Type de données : tableau d’objets `"warnings": [ { "error": "String", "message": "String" } ]`
Résultat.Éléments.Avertissements.Erreur	Type d’avertissement rencontré lors du traitement de ce CI. Type de données : chaîne
Résultat.Éléments.Avertissements.Message	Message d’avertissement rencontré lors du traitement de ce CI. Type de données : chaîne
résultat.logContextId	ID de contexte signalé pour cette charge utile. Type de données : chaîne
résultat.relations	Liste des CI de relation dépendante du tableau de corps relations de la demande. Type de données : tableau d’objets `"relations": [ { "className": "String", "errorCount": Number, "errors": [Array], "inputIndices": [Array], "markers": [Array], "mergedPayloadIds": [Array], "operation": "String", "warnings": [Array] } ]`
résultat.relations.nomdeclasse	Le sys_class_name de ce CI de relation dépendante. Seule valeur prise en charge : cmdb_rel_ci : table Relations CI. Type de données : chaîne
résultat.relations.errorCount	Nombre d’erreurs rencontrées lors du traitement de ce CI de relation dépendante. Type de données : nombre
Résultat.Relations.Erreurs	Liste des erreurs rencontrées lors du traitement de ce CI de relation dépendante. Type de données : tableau d’objets `"errors": [ { "error": "String", "message": "String" } ]`
Résultat.Relations.Erreurs.Erreur	Type d’erreur survenue lors du traitement de ce CI de relation dépendante. Type de données : chaîne
Résultat.Relations.Erreurs.Message	Un message d’erreur est survenu lors du traitement de ce CI de relation dépendante. Type de données : chaîne
résultat.relations.indicesentrées	Liste des valeurs d’index pour les objets CI de relation dépendante dans le tableau corps relations de la demande qui correspondent à ce CI de relation dépendante. Type de données : tableau `"inputIndices": [ Number ]`
résultat.relations.marqueurs	Liste des valeurs de marqueurs pour une utilisation interne. Type de données : tableau `"markers": []`
résultat.relations.mergedPayloadIds	Liste des valeurs sys_id des charges utiles partielles de la table Charges utiles partielles [cmdb_ire_partial_payloads] IRE CMDB qui ont été fusionnées pendant le traitement de ce CI de relation dépendante. Type de données : tableau `"mergedPayloadIds": [ "String" ]`
résultat.relations.opération	Opération exécutée pour ce CI de relation dépendante. Valeurs possibles : INSERT : le CI de relation dépendante a été inséré dans la table cible en tant que nouvel enregistrement. INSERT_AS_INCOMPLETE : le CI de relation dépendante comportait des erreurs et a été inséré dans la table Charges utiles incomplètes [cmdb_ire_incomplete_payloads] IRE de la CMDB. INSERT_AS_PARTIAL : le CI de relation dépendante comportait des erreurs et a été inséré dans la table Charges utiles partielles [cmdb_ire_partial_payloads] IRE de la CMDB. NO_CHANGE : aucune opération n’a été réalisée pour le CI de relation dépendante. MISE À JOUR : un CI de relation dépendante existant dans la table cible a été mis à jour. Type de données : chaîne
Résultat.Relations.Avertissements	Liste des avertissements rencontrés lors du traitement de ce CI de relation dépendante. Type de données : tableau d’objets `"warnings": [ { "error": "String", "message": "String" } ]`
Résultat.Relations.Avertissements.Erreur	Type d’avertissement rencontré lors du traitement de ce CI de relation dépendante. Type de données : chaîne
Résultat.Relations.Avertissements.Message	Message d’avertissement rencontré lors du traitement de ce CI de relation dépendante. Type de données : chaîne

Demande cURL

Simuler la soumission d’une charge utile partielle pour un CI d’ordinateur.

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

La réponse indique que la charge utile sera insérée dans la table Charges utiles partielles IRE de la CMDB [cmdb_ire_partial_payloads].

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

Simulez la soumission d’une deuxième charge utile partielle qui compléterait la description du CI de l’ordinateur, avec l’option IRE améliorée de génération de résumé activée.

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

La réponse indique que le CI de l’ordinateur sera inséré et affiche un résumé des opérations qui seront effectuées.

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