API Identification et réconciliation

Rversion finale: Washingtondc

Mis à jour 1 févr. 2024

109 minutes de lecture

L’API Identification et réconciliation utilise le moteur Identification et réconciliation (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 disposer du rôle itil ou asset pour utiliser cette API.

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

Identification et réconciliation : POST /now/identifyreconcile

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

Utilisez le point de terminaison pour simuler la Identification et réconciliation : 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 le Identification et réconciliation : POST /now/identifyreconcile/enhanced point de terminaison à la place si vous devez spécifier des options IRE améliorées. Pour en savoir plus sur les options IRE améliorées, consultez Moteur Identification et réconciliation (IRE).

Format d'URL

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

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

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. Exemple : `v1` ou `v2`. Spécifiez uniquement cette valeur pour utiliser une version de point de terminaison différente de la dernière. Type de données : chaîne

Tableau 2. Paramètres de requête
Nom	Description
sysparm_data_source	Identifie la 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 É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	Tableau d’objets dans lequel chaque objet décrit un CI à créer ou à mettre à jour. Type de données : tableau `"items": [ { "className": "String", "internal_id": "String", "lookup": [Array], "related": [Array], "settings": {Object}, "sys_object_source_info": {Object}, "values": {Object} } ]`
items.className	Requis. sys_class_name (nom de classe/table) du CI à créer ou à mettre à jour. Cette valeur peut être n’importe quelle CMDB table, comme 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 prendre n’importe quelle valeur, mais doit être unique dans la charge utile. Type de données : chaîne
items.rechercher	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 `"lookup": [ { "className": "String", "internal_id": "String", "sys_object_source_info": {Object}, "values": {Object} } ]`
items.lookup.className	Requis. sys_class_name ou nom 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 pour cet enregistrement de recherche dans cette charge utile. Peut prendre n’importe quelle valeur, mais doit être unique dans la charge utile. Type de données : chaîne
items.lookup.sys_object_source_info	Objet décrivant un identificateur 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 façon unique le flux qui envoie ce CI. À utiliser si la source peut avoir plusieurs flux. Type de données : chaîne
items.lookup.sys_object_source_info.source_name	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 auxquelles le CI a été analysé. Type de données : chaîne Format : AAAA-MM-JJ 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 les 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, basé sur 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 que peut trouver ce tableau. La table associée 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 `"related": [ { "className": "String", "internal_id": "String", "sys_object_source_info": {Object}, "values": {Object} } ]`
items.related.className	Requis. Le 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 pour cet élément connexe dans cette charge utile. Peut prendre n’importe quelle valeur, mais doit être unique dans la charge utile. Type de données : chaîne
items.related.sys_object_source_info	Objet décrivant un identificateur 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 façon unique le flux qui envoie cet élément connexe. À utiliser si la source peut avoir plusieurs flux. Type de données : chaîne
items.related.sys_object_source_info.source_name	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 : AAAA-MM-JJ hh :mm :ss
valeurs.connexes.éléments.	Objet décrivant les champs à créer ou à mettre à jour pour cet élément connexe en tant que 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 les 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 des 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 classification qui correspond à la classe de l’élément de charge utile. Valeurs valides : true : ignorer l’exécution de la règle. false : exécute la règle. Valeur par défaut : false
items.settings.updateWithoutDowngrade	Indique si la mise à jour et le passage à une version antérieure sont autorisés pour ce CI. Valeurs valides : true : mettre à jour l’élément, mais l’installation d’une version antérieure n’est pas autorisée. false : la mise à jour d’é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	Indique si ce CI peut être mis à jour et si sa classe peut être changée. Valeurs valides : true : met à jour l’élément, mais le changement de classe n’est pas autorisé. false : la mise à jour d’élément et le changement de classe sont autorisés. Type de données : booléennes Valeur par défaut : false
items.settings.updateWithoutUpgrade	Indique si la mise à jour et la mise à niveau sont autorisées pour ce CI. Valeurs valides : true : met à jour l’élément, mais la mise à niveau n’est pas autorisée. false : la mise à jour et la mise à niveau d’éléments sont autorisées. Type de données : booléennes Valeur par défaut : false
items.sys_objet_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 façon unique le flux qui envoie ce CI. À utiliser si la source peut avoir plusieurs flux. Type de données : chaîne
items.sys_object_source_info.source_name	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 auxquelles le CI a été analysé. Type de données : chaîne Format : AAAA-MM-JJ hh :mm :ss
éléments.valeurs	Objet décrivant les champs à créer ou à mettre à jour pour ce CI en tant que 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 les 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	Tableau d’objets dans lequel chaque objet décrit une référence entre deux éléments de la charge utile. Type de données : tableau `"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/table pour l’élément referencedBy . Type de données : chaîne
Relations	Tableau d’objets dans lequel chaque objet décrit une relation 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 parentchild de paires nom-valeur, les valeurs représentant les index d’éléments du tableau de charges items utiles. L’objet peut définir une relation entre deux éléments quelconques, y compris des éléments de niveau supérieur, connexes ou de recherche, à l’aide parent_id de child_id paires clé/valeur, avec des valeurs représentant internal_id des valeurs définies pour ces éléments. Type de données : tableau `"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	L’index 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.parent	Index 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étection pour la relation. Pour les relations de non-dépendance, ces informations se trouvent 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.source_name	Nom de la source de détection. Par défaut : source de détection transmise dans le paramètre de méthode d’API.
relations.sys_rel_source_info.source_feed	Toute chaîne qui est une sous-détection/analyse au sein de la source de détection. 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 parents et enfants. 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 à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir une 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.
Content-Type	Format de 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
Aucun

Codes d'état

Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir une 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é correctement traitée.
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 de corps de réponse (JSON ou XML)


Nom	Description
résultat	Tableau des résultats produits par la requête. Type de données : tableau `"result": [ "additionalCommittedItems": [Array], "additionalCommittedRelations": [Array], "items": [Array], "relations": [Array] ]`
result.additionalCommittedItems	Tableau d’objets dans lequel chaque objet décrit un CI non inclus dans le corps de la demande items Tableau à insérer ou à mettre à jour. Type de données : tableau `"additionalCommittedItems": [ { "className": "String", "errorCount": Number, "identificationAttempts": [Array], "inputIndices": [Array], "markers": [Array], "mergedPayloads": [Array], "operation": "String", "sysId": "String" } ]`
result.additionalCommittedItems.className	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	Tableau d’objets dans lequel chaque objet décrit une erreur rencontrée lors du traitement de ce CI supplémentaire. Type de données : tableau `"errors": [ { "error": "String", "message": "String" } ]`
résultat.additionalCommittedItems.errors.error	Type d’erreur rencontré lors du traitement de ce CI supplémentaire. Type de données : chaîne
résultat.additionalCommittedItems.errors.message	Message d’erreur rencontré lors du traitement de ce CI supplémentaire. Type de données : chaîne
result.additionalCommittedItems.identificationAttempts	Tableau d’objets dans lequel chaque objet décrit une tentative d’identification de ce CI supplémentaire. Type de données : tableau `"identificationAttempts": [ { "attemptResult": "String", "attributes": [Array], "hybridEntryCiAttributes": [Array], "identiferName": "String", "searchOnTable": [Array] } ]`
résultat.additionalCommittedItems.identificationAttempts.attemptResult	Résultat de cette tentative d’identification de CI supplémentaire. Valeurs possibles : MATCHED : identification réussie. Un CI unique a été trouvé dans la table de règles d’identificateur qui correspondait 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É : aucune tentative d’identification. Les attributs requis pour cette recherche dans la table de règles d’identificateurs n’ont pas été fournis, par conséquent la règle n’a pas été appliquée. Type de données : chaîne
result.additionalCommittedItems.identificationAttempts.attributes	Tableau des attributs d’entrée d’identificateur de CI utilisés lors 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", ]`
result.additionalCommittedItems.identificationAttempts.hybridEntryCiAttributes	Tableau des attributs d’entrée d’identificateur de CI utilisés lors 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" ]`
result.additionalCommittedItems.identificationAttempts.identifierName	Règle d’identificateur utilisée pour cette tentative d’identification de CI supplémentaire. Type de données : chaîne
result.additionalCommittedItems.identificationAttempts.searchOnTable	Nom de la table recherchée pour cette tentative d’identification de CI supplémentaire. Type de données : chaîne
result.additionalCommittedItems.identifierEntrySysId	sys_id de 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
result.additionalCommittedItems.inputIndex	Tableau 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 `"inputIndices": [ { Number } ]`
result.additionalCommittedItems.markers	Tableau de valeurs de marqueurs pour une utilisation interne. Type de données : tableau `"markers": []`
result.additionalCommittedItems.mergedPayloads	Tableau de valeurs sys_id pour les 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 supplémentaire. Type de données : tableau `"mergedPayloadIds": [ "String" ]`
résultat.additionalCommittedItems.operation	Opération effectuée pour ce CI supplémentaire. Valeurs possibles : SUPPRIMER : un CI existant est supprimé de la table cible. INSÉRER : 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. METTRE À 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 remplacée par 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 remplacée par une autre classe qui n’est ni une classe ancêtre ni descendante. UPDATE_WITH_UPGRADE : un CI existant dans la table cible est mis à jour et sa classe est remplacée par une classe plus spécialisée (classe descendante). Type de données : chaîne
result.additionalCommittedItems.sysId	La sys_id trouvée pour ce CI supplémentaire grâce à 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
result.additionalCommittedItems.warnings	Tableau d’objets dans lequel chaque objet décrit un avertissement rencontré lors du traitement de ce CI supplémentaire. Type de données : tableau `"warnings": [ { "error": "String", "message": "String" } ]`
résultat.additionalCommittedItems.warnings.error	Type d’avertissement rencontré lors du traitement de ce CI supplémentaire. Type de données : chaîne
résultat.additionalCommittedItems.warnings.message	Message d’avertissement rencontré lors du traitement de ce CI supplémentaire. Type de données : chaîne
résultat.additionalCommittedRelations	Tableau d’objets dans lequel chaque objet décrit un CI de relation dépendant non inclus dans la liste du corps relations de la demande à insérer ou à mettre à jour. Type de données : tableau `"additionalCommittedRelations": [ { "className": "String", "operation": "String", "markers": [Array], "inputIndices": [Array], "mergedPayloadIds": [Array] } ]`
result.additionalCommittedRelations.className	sys_class_name de ce CI de relation dépendante supplémentaire. Seule valeur prise en charge : cmdb_rel_ci : table Relation CI. Type de données : chaîne
result.additionalCommittedRelations.errorCount	Le nombre d’erreurs rencontrées lors du traitement de ce CI de relation dépendante supplémentaire. Type de données : nombre
résultat.additionalRelationsEngagées.erreurs	Tableau d’objets dans lequel chaque objet décrit une erreur rencontrée lors du traitement de ce CI de relation dépendante supplémentaire. Type de données : tableau `"errors": [ { "error": "String", "message": "String" } ]`
résultat.additionalRelationsEngagées.errors.erreur	Type d’erreur rencontré lors du traitement de ce CI de relation dépendante supplémentaire. Type de données : chaîne
result.additionalCommittedRelations.errors.message	Message d’erreur rencontré lors du traitement de ce CI de relation dépendante supplémentaire. Type de données : chaîne
result.additionalCommittedRelations.inputIndex	Tableau des valeurs d’index pour les objets CI de relation dépendante dans le tableau de corps relations de la demande qui correspondent à ce CI de relation dépendante supplémentaire. Type de données : tableau `"inputIndices": [ Number ]`
result.additionalCommittedRelations.markers	Tableau de valeurs de marqueurs pour une utilisation interne. Type de données : tableau `"markers": []`
result.additionalCommittedRelations.mergedPayloadIds	Tableau de valeurs d’sys_id pour les charges utiles partielles de la table Charges utiles partielles IRE CMDB [cmdb_ire_partial_payloads] 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.additionnellesRelationsEngagées.opération	Opération exécutée pour ce CI de relation dépendante supplémentaire. Valeurs possibles : INSÉRER : le CI de relation dépendante est inséré dans la table cible en tant que nouvel enregistrement. INSERT_AS_INCOMPLETE : le CI de relation dépendante a commis des erreurs et est inséré dans la table Charges utiles incomplètes IRE CMDB [cmdb_ire_incomplete_payloads]. INSERT_AS_PARTIAL : le CI de relation dépendante a commis des erreurs et est inséré dans la table Charges utiles partielles IRE CMDB [cmdb_ire_partial_payloads]. NO_CHANGE : Aucune opération n’est effectuée pour le CI de relation dépendante. METTRE À JOUR : un CI de relation dépendante existant dans la table cible est mis à jour. Type de données : chaîne
éléments.résultats	Tableau d’objets dans lequel chaque objet décrit un CI inclus dans le tableau de corps items de la demande. Type de données : tableau `"items": [ { "additionalRelatedItems": [Array], "className": "String", "duplicateLookupIndices": {Object}, "errorCount": Number, "errors": [Array], "identificationAttempts": [Array], "identifierEntrySysId": "String", "info": [Array], "inputIndices": [Array], "markers": [Array], "mergedPayloadIds": [Array], "operation": "String", "relatedItems": [Array], "relatedSysIds": [Array], "sysId": "String", "warnings": [Array] } ]`
result.items.additionalRelatedItems	Tableau d’objets dans lequel chaque objet décrit un CI connexe (CI de recherche de table) de la table Charges utiles partielles IRE [cmdb_ire_partial_payloads] CMDB. Type de données : tableau `"additionalRelatedItems": [ { "className": "String", "inputIndices": [Array], "markers": [Array], "mergedPayloadIds": [Array], "sysId": "String" } ]`
result.items.additionalRelatedItems.className	sys_class_name de l’élément connexe. Type de données : chaîne
result.items.additionalRelatedItems.inputIndex	Tableau des valeurs d’index des CI du tableau de corps items de la demande qui correspondent à cet élément connexe. Type de données : tableau `"inputIndices": [ Number ]`
result.items.additionalRelatedItems.markers	Tableau de valeurs de marqueurs pour une utilisation interne. Type de données : tableau `"markers": []`
result.items.additionalRelatedItems.mergedPayloadIds	Tableau de valeurs sys_id pour les charges utiles partielles de la table Charges utiles partielles IRE CMDB [cmdb_ire_partial_payloads] qui ont été fusionnées au cours du traitement de cet élément connexe. Type de données : tableau `"mergedPayloadIds": [ "String" ]`
result.items.additionalRelatedItems.sysId	sys_id de ce CI connexe. Type de données : chaîne
result.items.className	sys_class_name de ce CI. Type de données : chaîne
result.items.duplicateLookupIndex	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 associé. 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 correspondent à 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	Tableau d’objets dans lequel chaque objet décrit une erreur rencontrée lors du traitement de ce CI. Type de données : tableau `"errors": [ { "error": "String", "message": "String" } ]`
résultat.éléments.erreurs.erreur	Type d’erreur rencontré lors du traitement de ce CI. Type de données : chaîne
result.items.errors.message	Message d’erreur rencontré lors du traitement de ce CI. Type de données : chaîne
result.items.identificationAttempts	Tableau d’objets dans lequel chaque objet décrit une tentative d’identification de ce CI. Type de données : tableau `"identificationAttempts": [ { "attemptResult": "String", "attributes": [Array], "hybridEntryCiAttributes": [Array], "identiferName": "String", "searchOnTable": [Array] } ]`
result.items.identificationAttempts.attemptResult	Résultat de cette tentative d’identification de CI. Valeurs possibles : MATCHED : identification réussie. Un CI unique a été trouvé dans la table de règles d’identificateur qui correspondait 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É : aucune tentative d’identification. Les attributs requis pour cette recherche dans la table de règles d’identificateurs n’ont pas été fournis, par conséquent la règle n’a pas été appliquée. Type de données : chaîne
result.items.identificationAttempts.attributes	Tableau d’attributs d’entrée d’identificateur CI utilisés pendant cette tentative d’identification 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", ]`
result.items.identificationAttempts.hybridEntryCiAttributes	Tableau d’attributs d’entrée d’identificateur CI utilisés pendant cette tentative d’identification 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" ]`
result.items.identificationAttempts.identifierName	Règle d’identificateur utilisée pour cette tentative d’identification de CI. Type de données : chaîne
result.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. Consultez errors pour en savoir plus. Type de données : chaîne
result.items.info	Liste d’objets contenant des informations supplémentaires sur le traitement de l’élément. Type de données : tableau `"info": [ { "code": "String", "message": "String", "ruleSysId": "String" } ]`
résultat.articles.info.code	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 qui a été mise en correspondance. Applicable uniquement lorsque le moteur IRE ignore la reclassification en raison de la règle de restriction de classification. 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
result.items.inputIndex	Tableau des valeurs d’index pour les CI provenant du tableau du corps items de la demande correspondant à ce CI. Type de données : tableau `"inputIndices": [ { Number } ]`
resultat.éléments.marqueurs	Tableau de valeurs de marqueurs pour une utilisation interne. Type de données : tableau `"markers": []`
result.items.mergedPayloadIds	Tableau des valeurs d’sys_id pour les charges utiles partielles de la table Charges utiles partielles [cmdb_ire_partial_payloads] IRE CMDB qui ont été fusionnées au cours du 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 : SUPPRIMER : 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 effectuée pour le CI. METTRE À 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 remplacée par 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 remplacée par une autre classe qui n’est ni une classe ancêtre ni descendante. UPDATE_WITH_UPGRADE : un CI existant dans la table cible est mis à jour et sa classe est remplacée par une classe plus spécialisée (classe descendante). Type de données : chaîne
result.items.relatedItems	Tableau d’objets dans lequel chaque objet décrit un CI connexe (CI de recherche de table) à partir du tableau de corps items.lookup de la demande. Type de données : tableau `"relatedItems": [ { "className": "String", "inputIndices": [Array], "markers": [Array], "mergedPayloadIds": [Array], "sysId": "String" } ]`
result.items.relatedItems.className	sys_class_name de l’élément connexe. Type de données : chaîne
result.items.relatedItems.inputIndex	Tableau des valeurs d’index pour les CI et les éléments de recherche dans le corps items de la demande et items.lookup les tableaux qui correspondent à cet élément connexe. Type de données : tableau `"inputIndices": [ { "mainIndex": Number, "subIndex": Number } ]`
result.items.relatedItems.inputIndices.mainIndex	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 de corps items.lookup de la demande qui correspond à l’élément connexe. Type de données : nombre
result.items.relatedItems.markers	Tableau de valeurs de marqueurs pour une utilisation interne. Type de données : tableau `"markers": []`
result.items.relatedItems.mergedPayloadIds	Tableau de valeurs sys_id pour les entrées de la table Charges utiles partielles IRE CMDB [cmdb_ire_partial_payloads] qui ont été fusionnées dans ce CI pendant le traitement. Type de données : tableau `"mergedPayloadIds": [ "String" ]`
result.items.relatedSysIds	Tableau des valeurs de sys_id pour les éléments connexes (éléments de recherche de table) provenant du tableau de 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 connexe. `"relatedSysIds": [ Number, Number ]`
result.items.sysId	La sys_id trouvée pour ce CI grâce à l’identification. Valeurs notables : Inconnu : échec de l’identification de ce CI. Consultez errors pour en savoir plus. Type de données : chaîne
resultat.éléments.avertissements	Tableau d’objets dans lequel chaque objet décrit un avertissement rencontré lors du traitement de ce CI. Type de données : tableau `"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
result.logContextId	ID de contexte signalé pour cette charge utile. Type de données : chaîne
relations.résultats	Tableau d’objets dans lequel chaque objet décrit un CI de relation dépendant du tableau de corps relations de la demande. Type de données : tableau `"relations": [ { "className": "String", "errorCount": Number, "errors": [Array], "inputIndices": [Array], "markers": [Array], "mergedPayloadIds": [Array], "operation": "String", "warnings": [Array] } ]`
result.relations.className	La sys_class_name de ce CI de relation dépendante. Seule valeur prise en charge : cmdb_rel_ci : table Relation CI. Type de données : chaîne
result.relations.errorCount	Le nombre d’erreurs rencontrées lors du traitement de ce CI de relation dépendante. Type de données : nombre
result.relations.erreurs	Tableau d’objets dans lequel chaque objet décrit une erreur rencontrée lors du traitement de ce CI de relation dépendante. Type de données : tableau `"errors": [ { "error": "String", "message": "String" } ]`
résultat.relations.erreurs.erreur	Type d’erreur rencontré lors du traitement de ce CI de relation dépendante. Type de données : chaîne
resultat.relations.erreurs.message	Message d’erreur rencontré lors du traitement de ce CI de relation dépendante. Type de données : chaîne
result.relations.inputIndex	Tableau des valeurs d’index pour les objets CI de relation dépendante dans le tableau de corps relations de la demande qui correspondent à ce CI de relation dépendante. Type de données : tableau `"inputIndices": [ Number ]`
result.relations.marqueurs	Tableau de valeurs de marqueurs pour une utilisation interne. Type de données : tableau `"markers": []`
result.relations.mergedPayloadIds	Tableau de valeurs d’sys_id pour les charges utiles partielles de la table Charges utiles partielles IRE CMDB [cmdb_ire_partial_payloads] 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épendant. 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 a commis des erreurs et a été inséré dans la table Charges utiles incomplètes IRE CMDB [cmdb_ire_incomplete_payloads]. INSERT_AS_PARTIAL : Le CI de relation dépendante a commis des erreurs et a été inséré dans la table Charges utiles partielles IRE CMDB [cmdb_ire_partial_payloads]. NO_CHANGE : aucune opération n’a été effectué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ésultats.relations.avertissements	Tableau d’objets dans lequel chaque objet décrit un avertissement rencontré lors du traitement de ce CI de relation dépendante. Type de données : tableau `"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 d’adaptateur réseau) et un commutateur IP, avec une relation dépendante de la connexion IP.

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 recherche de règle de matériel pour son nom dans la table Matériel [cmdb_ci_hardware] et est traité comme une mise à jour d’un CI existant dans la table du serveur Linux [cmdb_ci_linux_server]. Le commutateur IP est identifié de la même façon via une recherche de règle de matériel pour 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 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 réconciliation : POST /now/identifyreconcile/enhanced

Utilisez le point de terminaison pour simuler la Identification et réconciliation : 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 réconciliation : POST /now/identifyreconcile méthode, mais ajoute les fonctionnalités suivantes :

Charges utiles partielles
- Dans le cas d’un avertissement ou d’une erreur pour un élément, indique si une opération d’élément est INSERT_AS_PARTIAL ou INSERT_INCOMPLETE.
- Renvoie la sys_ids des charges utiles partielles qui ont été fusionnées avec les charges utiles partielles existantes.
Prend en charge la fonctionnalité de déduplication de 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

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. Exemple : `v1` ou `v2`. Spécifiez uniquement cette valeur pour utiliser une version de point de terminaison différente de la dernière. Type de données : chaîne

Tableau 8. Paramètres de requête
Nom	Description
options	Liste de paires nom-valeur séparées par des virgules représentant les options IRE améliorées appliquées pour 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 des options IRE améliorées : `partial_payloads :faux,partial_commits :faux,deduplicate_payloads :faux,generate_summary :vrai` Remarque : Par défaut ou si partial_payloads est défini sur vrai, les deux partial_commits et deduplicate_payloads sont activés, même s’ils sont définis sur faux, car ces fonctionnalités sont essentielles pour la fonctionnalité des charges utiles partielles. Pour en savoir plus sur les options IRE améliorées, consultez Moteur Identification et réconciliation (IRE). Valeurs valides pour chaque paire nom-valeur : true : permet d’activer cette option IRE améliorée. false : désactivez cette option IRE améliorée. Type de données : chaîne
sysparm_data_source	Identifie la 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 É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	Tableau d’objets dans lequel chaque objet décrit un CI à créer ou à mettre à jour. Type de données : tableau `"items": [ { "className": "String", "internal_id": "String", "lookup": [Array], "related": [Array], "settings": {Object}, "sys_object_source_info": {Object}, "values": {Object} } ]`
items.className	Requis. sys_class_name (nom de classe/table) du CI à créer ou à mettre à jour. Cette valeur peut être n’importe quelle CMDB table, comme 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 prendre n’importe quelle valeur, mais doit être unique dans la charge utile. Type de données : chaîne
items.rechercher	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 `"lookup": [ { "className": "String", "internal_id": "String", "sys_object_source_info": {Object}, "values": {Object} } ]`
items.lookup.className	Requis. sys_class_name ou nom 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 pour cet enregistrement de recherche dans cette charge utile. Peut prendre n’importe quelle valeur, mais doit être unique dans la charge utile. Type de données : chaîne
items.lookup.sys_object_source_info	Objet décrivant un identificateur 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 façon unique le flux qui envoie ce CI. À utiliser si la source peut avoir plusieurs flux. Type de données : chaîne
items.lookup.sys_object_source_info.source_name	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 auxquelles le CI a été analysé. Type de données : chaîne Format : AAAA-MM-JJ 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 les 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, basé sur 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 que peut trouver ce tableau. La table associée 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 `"related": [ { "className": "String", "internal_id": "String", "sys_object_source_info": {Object}, "values": {Object} } ]`
items.related.className	Requis. Le 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 pour cet élément connexe dans cette charge utile. Peut prendre n’importe quelle valeur, mais doit être unique dans la charge utile. Type de données : chaîne
items.related.sys_object_source_info	Objet décrivant un identificateur 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 façon unique le flux qui envoie cet élément connexe. À utiliser si la source peut avoir plusieurs flux. Type de données : chaîne
items.related.sys_object_source_info.source_name	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 : AAAA-MM-JJ hh :mm :ss
valeurs.connexes.éléments.	Objet décrivant les champs à créer ou à mettre à jour pour cet élément connexe en tant que 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 les 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 des 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 classification qui correspond à la classe de l’élément de charge utile. Valeurs valides : true : ignorer l’exécution de la règle. false : exécute la règle. Valeur par défaut : false
items.settings.updateWithoutDowngrade	Indique si la mise à jour et le passage à une version antérieure sont autorisés pour ce CI. Valeurs valides : true : mettre à jour l’élément, mais l’installation d’une version antérieure n’est pas autorisée. false : la mise à jour d’é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	Indique si ce CI peut être mis à jour et si sa classe peut être changée. Valeurs valides : true : met à jour l’élément, mais le changement de classe n’est pas autorisé. false : la mise à jour d’élément et le changement de classe sont autorisés. Type de données : booléennes Valeur par défaut : false
items.settings.updateWithoutUpgrade	Indique si la mise à jour et la mise à niveau sont autorisées pour ce CI. Valeurs valides : true : met à jour l’élément, mais la mise à niveau n’est pas autorisée. false : la mise à jour et la mise à niveau d’éléments sont autorisées. Type de données : booléennes Valeur par défaut : false
items.sys_objet_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 façon unique le flux qui envoie ce CI. À utiliser si la source peut avoir plusieurs flux. Type de données : chaîne
items.sys_object_source_info.source_name	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 auxquelles le CI a été analysé. Type de données : chaîne Format : AAAA-MM-JJ hh :mm :ss
éléments.valeurs	Objet décrivant les champs à créer ou à mettre à jour pour ce CI en tant que 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 les 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	Tableau d’objets dans lequel chaque objet décrit une référence entre deux éléments de la charge utile. Type de données : tableau `"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/table pour l’élément referencedBy . Type de données : chaîne
Relations	Tableau d’objets dans lequel chaque objet décrit une relation 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 parentchild de paires nom-valeur, les valeurs représentant les index d’éléments du tableau de charges items utiles. L’objet peut définir une relation entre deux éléments quelconques, y compris des éléments de niveau supérieur, connexes ou de recherche, à l’aide parent_id de child_id paires clé/valeur, avec des valeurs représentant internal_id des valeurs définies pour ces éléments. Type de données : tableau `"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	L’index 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.parent	Index 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étection pour la relation. Pour les relations de non-dépendance, ces informations se trouvent 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.source_name	Nom de la source de détection. Par défaut : source de détection transmise dans le paramètre de méthode d’API.
relations.sys_rel_source_info.source_feed	Toute chaîne qui est une sous-détection/analyse au sein de la source de détection. 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 parents et enfants. 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.
Content-Type	Format de 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
Aucun

Codes d'état

Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir une 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é correctement traitée.
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 « Chunk [...] is not a valid entry » indique que le paramètre de requête n’est options pas dans le format de paire nom-valeur correct. Par exemple, la spécification d’un options paramètre `partiel` produit un code d’état 500 avec « Chunk [partiel] is not a valid entry » dans le détail du message.

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


Nom	Description
résultat	Tableau des résultats produits par la requête. Type de données : tableau `"result": [ "additionalCommittedItems": [Array], "additionalCommittedRelations": [Array], "items": [Array], "relations": [Array] ]`
result.additionalCommittedItems	Tableau d’objets dans lequel chaque objet décrit un CI non inclus dans le corps de la demande items Tableau à insérer ou à mettre à jour. Type de données : tableau `"additionalCommittedItems": [ { "className": "String", "errorCount": Number, "identificationAttempts": [Array], "inputIndices": [Array], "markers": [Array], "mergedPayloads": [Array], "operation": "String", "sysId": "String" } ]`
result.additionalCommittedItems.className	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	Tableau d’objets dans lequel chaque objet décrit une erreur rencontrée lors du traitement de ce CI supplémentaire. Type de données : tableau `"errors": [ { "error": "String", "message": "String" } ]`
résultat.additionalCommittedItems.errors.error	Type d’erreur rencontré lors du traitement de ce CI supplémentaire. Type de données : chaîne
résultat.additionalCommittedItems.errors.message	Message d’erreur rencontré lors du traitement de ce CI supplémentaire. Type de données : chaîne
result.additionalCommittedItems.identificationAttempts	Tableau d’objets dans lequel chaque objet décrit une tentative d’identification de ce CI supplémentaire. Type de données : tableau `"identificationAttempts": [ { "attemptResult": "String", "attributes": [Array], "hybridEntryCiAttributes": [Array], "identiferName": "String", "searchOnTable": [Array] } ]`
résultat.additionalCommittedItems.identificationAttempts.attemptResult	Résultat de cette tentative d’identification de CI supplémentaire. Valeurs possibles : MATCHED : identification réussie. Un CI unique a été trouvé dans la table de règles d’identificateur qui correspondait 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É : aucune tentative d’identification. Les attributs requis pour cette recherche dans la table de règles d’identificateurs n’ont pas été fournis, par conséquent la règle n’a pas été appliquée. Type de données : chaîne
result.additionalCommittedItems.identificationAttempts.attributes	Tableau des attributs d’entrée d’identificateur de CI utilisés lors 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", ]`
result.additionalCommittedItems.identificationAttempts.hybridEntryCiAttributes	Tableau des attributs d’entrée d’identificateur de CI utilisés lors 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" ]`
result.additionalCommittedItems.identificationAttempts.identifierName	Règle d’identificateur utilisée pour cette tentative d’identification de CI supplémentaire. Type de données : chaîne
result.additionalCommittedItems.identificationAttempts.searchOnTable	Nom de la table recherchée pour cette tentative d’identification de CI supplémentaire. Type de données : chaîne
result.additionalCommittedItems.identifierEntrySysId	sys_id de 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
result.additionalCommittedItems.inputIndex	Tableau 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 `"inputIndices": [ { Number } ]`
result.additionalCommittedItems.markers	Tableau de valeurs de marqueurs pour une utilisation interne. Type de données : tableau `"markers": []`
result.additionalCommittedItems.mergedPayloads	Tableau de valeurs sys_id pour les 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 supplémentaire. Type de données : tableau `"mergedPayloadIds": [ "String" ]`
résultat.additionalCommittedItems.operation	Opération effectuée pour ce CI supplémentaire. Valeurs possibles : SUPPRIMER : un CI existant est supprimé de la table cible. INSÉRER : 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. METTRE À 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 remplacée par 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 remplacée par une autre classe qui n’est ni une classe ancêtre ni descendante. UPDATE_WITH_UPGRADE : un CI existant dans la table cible est mis à jour et sa classe est remplacée par une classe plus spécialisée (classe descendante). Type de données : chaîne
result.additionalCommittedItems.sysId	La sys_id trouvée pour ce CI supplémentaire grâce à 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
result.additionalCommittedItems.warnings	Tableau d’objets dans lequel chaque objet décrit un avertissement rencontré lors du traitement de ce CI supplémentaire. Type de données : tableau `"warnings": [ { "error": "String", "message": "String" } ]`
résultat.additionalCommittedItems.warnings.error	Type d’avertissement rencontré lors du traitement de ce CI supplémentaire. Type de données : chaîne
résultat.additionalCommittedItems.warnings.message	Message d’avertissement rencontré lors du traitement de ce CI supplémentaire. Type de données : chaîne
résultat.additionalCommittedRelations	Tableau d’objets dans lequel chaque objet décrit un CI de relation dépendant non inclus dans la liste du corps relations de la demande à insérer ou à mettre à jour. Type de données : tableau `"additionalCommittedRelations": [ { "className": "String", "operation": "String", "markers": [Array], "inputIndices": [Array], "mergedPayloadIds": [Array] } ]`
result.additionalCommittedRelations.className	sys_class_name de ce CI de relation dépendante supplémentaire. Seule valeur prise en charge : cmdb_rel_ci : table Relation CI. Type de données : chaîne
result.additionalCommittedRelations.errorCount	Le nombre d’erreurs rencontrées lors du traitement de ce CI de relation dépendante supplémentaire. Type de données : nombre
résultat.additionalRelationsEngagées.erreurs	Tableau d’objets dans lequel chaque objet décrit une erreur rencontrée lors du traitement de ce CI de relation dépendante supplémentaire. Type de données : tableau `"errors": [ { "error": "String", "message": "String" } ]`
résultat.additionalRelationsEngagées.errors.erreur	Type d’erreur rencontré lors du traitement de ce CI de relation dépendante supplémentaire. Type de données : chaîne
result.additionalCommittedRelations.errors.message	Message d’erreur rencontré lors du traitement de ce CI de relation dépendante supplémentaire. Type de données : chaîne
result.additionalCommittedRelations.inputIndex	Tableau des valeurs d’index pour les objets CI de relation dépendante dans le tableau de corps relations de la demande qui correspondent à ce CI de relation dépendante supplémentaire. Type de données : tableau `"inputIndices": [ Number ]`
result.additionalCommittedRelations.markers	Tableau de valeurs de marqueurs pour une utilisation interne. Type de données : tableau `"markers": []`
result.additionalCommittedRelations.mergedPayloadIds	Tableau de valeurs d’sys_id pour les charges utiles partielles de la table Charges utiles partielles IRE CMDB [cmdb_ire_partial_payloads] 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.additionnellesRelationsEngagées.opération	Opération exécutée pour ce CI de relation dépendante supplémentaire. Valeurs possibles : INSÉRER : le CI de relation dépendante est inséré dans la table cible en tant que nouvel enregistrement. INSERT_AS_INCOMPLETE : le CI de relation dépendante a commis des erreurs et est inséré dans la table Charges utiles incomplètes IRE CMDB [cmdb_ire_incomplete_payloads]. INSERT_AS_PARTIAL : le CI de relation dépendante a commis des erreurs et est inséré dans la table Charges utiles partielles IRE CMDB [cmdb_ire_partial_payloads]. NO_CHANGE : Aucune opération n’est effectuée pour le CI de relation dépendante. METTRE À JOUR : un CI de relation dépendante existant dans la table cible est mis à jour. Type de données : chaîne
éléments.résultats	Tableau d’objets dans lequel chaque objet décrit un CI inclus dans le tableau de corps items de la demande. Type de données : tableau `"items": [ { "additionalRelatedItems": [Array], "className": "String", "duplicateLookupIndices": {Object}, "errorCount": Number, "errors": [Array], "identificationAttempts": [Array], "identifierEntrySysId": "String", "info": [Array], "inputIndices": [Array], "markers": [Array], "mergedPayloadIds": [Array], "operation": "String", "relatedItems": [Array], "relatedSysIds": [Array], "sysId": "String", "warnings": [Array] } ]`
result.items.additionalRelatedItems	Tableau d’objets dans lequel chaque objet décrit un CI connexe (CI de recherche de table) de la table Charges utiles partielles IRE [cmdb_ire_partial_payloads] CMDB. Type de données : tableau `"additionalRelatedItems": [ { "className": "String", "inputIndices": [Array], "markers": [Array], "mergedPayloadIds": [Array], "sysId": "String" } ]`
result.items.additionalRelatedItems.className	sys_class_name de l’élément connexe. Type de données : chaîne
result.items.additionalRelatedItems.inputIndex	Tableau des valeurs d’index des CI du tableau de corps items de la demande qui correspondent à cet élément connexe. Type de données : tableau `"inputIndices": [ Number ]`
result.items.additionalRelatedItems.markers	Tableau de valeurs de marqueurs pour une utilisation interne. Type de données : tableau `"markers": []`
result.items.additionalRelatedItems.mergedPayloadIds	Tableau de valeurs sys_id pour les charges utiles partielles de la table Charges utiles partielles IRE CMDB [cmdb_ire_partial_payloads] qui ont été fusionnées au cours du traitement de cet élément connexe. Type de données : tableau `"mergedPayloadIds": [ "String" ]`
result.items.additionalRelatedItems.sysId	sys_id de ce CI connexe. Type de données : chaîne
result.items.className	sys_class_name de ce CI. Type de données : chaîne
result.items.duplicateLookupIndex	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 associé. 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 correspondent à 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	Tableau d’objets dans lequel chaque objet décrit une erreur rencontrée lors du traitement de ce CI. Type de données : tableau `"errors": [ { "error": "String", "message": "String" } ]`
résultat.éléments.erreurs.erreur	Type d’erreur rencontré lors du traitement de ce CI. Type de données : chaîne
result.items.errors.message	Message d’erreur rencontré lors du traitement de ce CI. Type de données : chaîne
result.items.identificationAttempts	Tableau d’objets dans lequel chaque objet décrit une tentative d’identification de ce CI. Type de données : tableau `"identificationAttempts": [ { "attemptResult": "String", "attributes": [Array], "hybridEntryCiAttributes": [Array], "identiferName": "String", "searchOnTable": [Array] } ]`
result.items.identificationAttempts.attemptResult	Résultat de cette tentative d’identification de CI. Valeurs possibles : MATCHED : identification réussie. Un CI unique a été trouvé dans la table de règles d’identificateur qui correspondait 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É : aucune tentative d’identification. Les attributs requis pour cette recherche dans la table de règles d’identificateurs n’ont pas été fournis, par conséquent la règle n’a pas été appliquée. Type de données : chaîne
result.items.identificationAttempts.attributes	Tableau d’attributs d’entrée d’identificateur CI utilisés pendant cette tentative d’identification 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", ]`
result.items.identificationAttempts.hybridEntryCiAttributes	Tableau d’attributs d’entrée d’identificateur CI utilisés pendant cette tentative d’identification 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" ]`
result.items.identificationAttempts.identifierName	Règle d’identificateur utilisée pour cette tentative d’identification de CI. Type de données : chaîne
result.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. Consultez errors pour en savoir plus. Type de données : chaîne
result.items.info	Liste d’objets contenant des informations supplémentaires sur le traitement de l’élément. Type de données : tableau `"info": [ { "code": "String", "message": "String", "ruleSysId": "String" } ]`
résultat.articles.info.code	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 qui a été mise en correspondance. Applicable uniquement lorsque le moteur IRE ignore la reclassification en raison de la règle de restriction de classification. 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
result.items.inputIndex	Tableau des valeurs d’index pour les CI provenant du tableau du corps items de la demande correspondant à ce CI. Type de données : tableau `"inputIndices": [ { Number } ]`
resultat.éléments.marqueurs	Tableau de valeurs de marqueurs pour une utilisation interne. Type de données : tableau `"markers": []`
result.items.mergedPayloadIds	Tableau des valeurs d’sys_id pour les charges utiles partielles de la table Charges utiles partielles [cmdb_ire_partial_payloads] IRE CMDB qui ont été fusionnées au cours du 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 : SUPPRIMER : 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 effectuée pour le CI. METTRE À 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 remplacée par 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 remplacée par une autre classe qui n’est ni une classe ancêtre ni descendante. UPDATE_WITH_UPGRADE : un CI existant dans la table cible est mis à jour et sa classe est remplacée par une classe plus spécialisée (classe descendante). Type de données : chaîne
result.items.relatedItems	Tableau d’objets dans lequel chaque objet décrit un CI connexe (CI de recherche de table) à partir du tableau de corps items.lookup de la demande. Type de données : tableau `"relatedItems": [ { "className": "String", "inputIndices": [Array], "markers": [Array], "mergedPayloadIds": [Array], "sysId": "String" } ]`
result.items.relatedItems.className	sys_class_name de l’élément connexe. Type de données : chaîne
result.items.relatedItems.inputIndex	Tableau des valeurs d’index pour les CI et les éléments de recherche dans le corps items de la demande et items.lookup les tableaux qui correspondent à cet élément connexe. Type de données : tableau `"inputIndices": [ { "mainIndex": Number, "subIndex": Number } ]`
result.items.relatedItems.inputIndices.mainIndex	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 de corps items.lookup de la demande qui correspond à l’élément connexe. Type de données : nombre
result.items.relatedItems.markers	Tableau de valeurs de marqueurs pour une utilisation interne. Type de données : tableau `"markers": []`
result.items.relatedItems.mergedPayloadIds	Tableau de valeurs sys_id pour les entrées de la table Charges utiles partielles IRE CMDB [cmdb_ire_partial_payloads] qui ont été fusionnées dans ce CI pendant le traitement. Type de données : tableau `"mergedPayloadIds": [ "String" ]`
result.items.relatedSysIds	Tableau des valeurs de sys_id pour les éléments connexes (éléments de recherche de table) provenant du tableau de 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 connexe. `"relatedSysIds": [ Number, Number ]`
result.items.sysId	La sys_id trouvée pour ce CI grâce à l’identification. Valeurs notables : Inconnu : échec de l’identification de ce CI. Consultez errors pour en savoir plus. Type de données : chaîne
resultat.éléments.avertissements	Tableau d’objets dans lequel chaque objet décrit un avertissement rencontré lors du traitement de ce CI. Type de données : tableau `"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
result.logContextId	ID de contexte signalé pour cette charge utile. Type de données : chaîne
relations.résultats	Tableau d’objets dans lequel chaque objet décrit un CI de relation dépendant du tableau de corps relations de la demande. Type de données : tableau `"relations": [ { "className": "String", "errorCount": Number, "errors": [Array], "inputIndices": [Array], "markers": [Array], "mergedPayloadIds": [Array], "operation": "String", "warnings": [Array] } ]`
result.relations.className	La sys_class_name de ce CI de relation dépendante. Seule valeur prise en charge : cmdb_rel_ci : table Relation CI. Type de données : chaîne
result.relations.errorCount	Le nombre d’erreurs rencontrées lors du traitement de ce CI de relation dépendante. Type de données : nombre
result.relations.erreurs	Tableau d’objets dans lequel chaque objet décrit une erreur rencontrée lors du traitement de ce CI de relation dépendante. Type de données : tableau `"errors": [ { "error": "String", "message": "String" } ]`
résultat.relations.erreurs.erreur	Type d’erreur rencontré lors du traitement de ce CI de relation dépendante. Type de données : chaîne
resultat.relations.erreurs.message	Message d’erreur rencontré lors du traitement de ce CI de relation dépendante. Type de données : chaîne
result.relations.inputIndex	Tableau des valeurs d’index pour les objets CI de relation dépendante dans le tableau de corps relations de la demande qui correspondent à ce CI de relation dépendante. Type de données : tableau `"inputIndices": [ Number ]`
result.relations.marqueurs	Tableau de valeurs de marqueurs pour une utilisation interne. Type de données : tableau `"markers": []`
result.relations.mergedPayloadIds	Tableau de valeurs d’sys_id pour les charges utiles partielles de la table Charges utiles partielles IRE CMDB [cmdb_ire_partial_payloads] 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épendant. 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 a commis des erreurs et a été inséré dans la table Charges utiles incomplètes IRE CMDB [cmdb_ire_incomplete_payloads]. INSERT_AS_PARTIAL : Le CI de relation dépendante a commis des erreurs et a été inséré dans la table Charges utiles partielles IRE CMDB [cmdb_ire_partial_payloads]. NO_CHANGE : aucune opération n’a été effectué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ésultats.relations.avertissements	Tableau d’objets dans lequel chaque objet décrit un avertissement rencontré lors du traitement de ce CI de relation dépendante. Type de données : tableau `"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

Envoyez 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 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é de génération de synthèse 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 réconciliation : POST /now/identifyreconcile/query

Détermine l’opération CMDB (insertion/mise à 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 Identification et réconciliation : POST /now/identifyreconcile demande) au point de terminaison.

Format d'URL

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

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

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. Exemple : `v1` ou `v2`. Spécifiez uniquement cette valeur pour utiliser une version de point de terminaison différente de la dernière. Type de données : chaîne

Tableau 14. Paramètres de requête
Nom	Description
sysparm_data_source	Identifie la 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 É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	Tableau d’objets dans lequel chaque objet décrit un CI à créer ou à mettre à jour. Type de données : tableau `"items": [ { "className": "String", "internal_id": "String", "lookup": [Array], "related": [Array], "settings": {Object}, "sys_object_source_info": {Object}, "values": {Object} } ]`
items.className	Requis. sys_class_name (nom de classe/table) du CI à créer ou à mettre à jour. Cette valeur peut être n’importe quelle CMDB table, comme 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 prendre n’importe quelle valeur, mais doit être unique dans la charge utile. Type de données : chaîne
items.rechercher	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 `"lookup": [ { "className": "String", "internal_id": "String", "sys_object_source_info": {Object}, "values": {Object} } ]`
items.lookup.className	Requis. sys_class_name ou nom 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 pour cet enregistrement de recherche dans cette charge utile. Peut prendre n’importe quelle valeur, mais doit être unique dans la charge utile. Type de données : chaîne
items.lookup.sys_object_source_info	Objet décrivant un identificateur 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 façon unique le flux qui envoie ce CI. À utiliser si la source peut avoir plusieurs flux. Type de données : chaîne
items.lookup.sys_object_source_info.source_name	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 auxquelles le CI a été analysé. Type de données : chaîne Format : AAAA-MM-JJ 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 les 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, basé sur 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 que peut trouver ce tableau. La table associée 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 `"related": [ { "className": "String", "internal_id": "String", "sys_object_source_info": {Object}, "values": {Object} } ]`
items.related.className	Requis. Le 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 pour cet élément connexe dans cette charge utile. Peut prendre n’importe quelle valeur, mais doit être unique dans la charge utile. Type de données : chaîne
items.related.sys_object_source_info	Objet décrivant un identificateur 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 façon unique le flux qui envoie cet élément connexe. À utiliser si la source peut avoir plusieurs flux. Type de données : chaîne
items.related.sys_object_source_info.source_name	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 : AAAA-MM-JJ hh :mm :ss
valeurs.connexes.éléments.	Objet décrivant les champs à créer ou à mettre à jour pour cet élément connexe en tant que 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 les 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 des 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 classification qui correspond à la classe de l’élément de charge utile. Valeurs valides : true : ignorer l’exécution de la règle. false : exécute la règle. Valeur par défaut : false
items.settings.updateWithoutDowngrade	Indique si la mise à jour et le passage à une version antérieure sont autorisés pour ce CI. Valeurs valides : true : mettre à jour l’élément, mais l’installation d’une version antérieure n’est pas autorisée. false : la mise à jour d’é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	Indique si ce CI peut être mis à jour et si sa classe peut être changée. Valeurs valides : true : met à jour l’élément, mais le changement de classe n’est pas autorisé. false : la mise à jour d’élément et le changement de classe sont autorisés. Type de données : booléennes Valeur par défaut : false
items.settings.updateWithoutUpgrade	Indique si la mise à jour et la mise à niveau sont autorisées pour ce CI. Valeurs valides : true : met à jour l’élément, mais la mise à niveau n’est pas autorisée. false : la mise à jour et la mise à niveau d’éléments sont autorisées. Type de données : booléennes Valeur par défaut : false
items.sys_objet_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 façon unique le flux qui envoie ce CI. À utiliser si la source peut avoir plusieurs flux. Type de données : chaîne
items.sys_object_source_info.source_name	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 auxquelles le CI a été analysé. Type de données : chaîne Format : AAAA-MM-JJ hh :mm :ss
éléments.valeurs	Objet décrivant les champs à créer ou à mettre à jour pour ce CI en tant que 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 les 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	Tableau d’objets dans lequel chaque objet décrit une référence entre deux éléments de la charge utile. Type de données : tableau `"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/table pour l’élément referencedBy . Type de données : chaîne
Relations	Tableau d’objets dans lequel chaque objet décrit une relation 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 parentchild de paires nom-valeur, les valeurs représentant les index d’éléments du tableau de charges items utiles. L’objet peut définir une relation entre deux éléments quelconques, y compris des éléments de niveau supérieur, connexes ou de recherche, à l’aide parent_id de child_id paires clé/valeur, avec des valeurs représentant internal_id des valeurs définies pour ces éléments. Type de données : tableau `"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	L’index 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.parent	Index 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étection pour la relation. Pour les relations de non-dépendance, ces informations se trouvent 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.source_name	Nom de la source de détection. Par défaut : source de détection transmise dans le paramètre de méthode d’API.
relations.sys_rel_source_info.source_feed	Toute chaîne qui est une sous-détection/analyse au sein de la source de détection. 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 parents et enfants. 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.
Content-Type	Format de 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
Aucun

Codes d'état

Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir une 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é correctement traitée.
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 de corps de réponse (JSON ou XML)


Nom	Description
résultat	Tableau des résultats produits par la requête. Type de données : tableau `"result": [ "additionalCommittedItems": [Array], "additionalCommittedRelations": [Array], "items": [Array], "relations": [Array] ]`
result.additionalCommittedItems	Tableau d’objets dans lequel chaque objet décrit un CI non inclus dans le corps de la demande items Tableau à insérer ou à mettre à jour. Type de données : tableau `"additionalCommittedItems": [ { "className": "String", "errorCount": Number, "identificationAttempts": [Array], "inputIndices": [Array], "markers": [Array], "mergedPayloads": [Array], "operation": "String", "sysId": "String" } ]`
result.additionalCommittedItems.className	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	Tableau d’objets dans lequel chaque objet décrit une erreur rencontrée lors du traitement de ce CI supplémentaire. Type de données : tableau `"errors": [ { "error": "String", "message": "String" } ]`
résultat.additionalCommittedItems.errors.error	Type d’erreur rencontré lors du traitement de ce CI supplémentaire. Type de données : chaîne
résultat.additionalCommittedItems.errors.message	Message d’erreur rencontré lors du traitement de ce CI supplémentaire. Type de données : chaîne
result.additionalCommittedItems.identificationAttempts	Tableau d’objets dans lequel chaque objet décrit une tentative d’identification de ce CI supplémentaire. Type de données : tableau `"identificationAttempts": [ { "attemptResult": "String", "attributes": [Array], "hybridEntryCiAttributes": [Array], "identiferName": "String", "searchOnTable": [Array] } ]`
résultat.additionalCommittedItems.identificationAttempts.attemptResult	Résultat de cette tentative d’identification de CI supplémentaire. Valeurs possibles : MATCHED : identification réussie. Un CI unique a été trouvé dans la table de règles d’identificateur qui correspondait 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É : aucune tentative d’identification. Les attributs requis pour cette recherche dans la table de règles d’identificateurs n’ont pas été fournis, par conséquent la règle n’a pas été appliquée. Type de données : chaîne
result.additionalCommittedItems.identificationAttempts.attributes	Tableau des attributs d’entrée d’identificateur de CI utilisés lors 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", ]`
result.additionalCommittedItems.identificationAttempts.hybridEntryCiAttributes	Tableau des attributs d’entrée d’identificateur de CI utilisés lors 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" ]`
result.additionalCommittedItems.identificationAttempts.identifierName	Règle d’identificateur utilisée pour cette tentative d’identification de CI supplémentaire. Type de données : chaîne
result.additionalCommittedItems.identificationAttempts.searchOnTable	Nom de la table recherchée pour cette tentative d’identification de CI supplémentaire. Type de données : chaîne
result.additionalCommittedItems.identifierEntrySysId	sys_id de 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
result.additionalCommittedItems.inputIndex	Tableau 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 `"inputIndices": [ { Number } ]`
result.additionalCommittedItems.markers	Tableau de valeurs de marqueurs pour une utilisation interne. Type de données : tableau `"markers": []`
result.additionalCommittedItems.mergedPayloads	Tableau de valeurs sys_id pour les 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 supplémentaire. Type de données : tableau `"mergedPayloadIds": [ "String" ]`
résultat.additionalCommittedItems.operation	Opération effectuée pour ce CI supplémentaire. Valeurs possibles : SUPPRIMER : un CI existant est supprimé de la table cible. INSÉRER : 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. METTRE À 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 remplacée par 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 remplacée par une autre classe qui n’est ni une classe ancêtre ni descendante. UPDATE_WITH_UPGRADE : un CI existant dans la table cible est mis à jour et sa classe est remplacée par une classe plus spécialisée (classe descendante). Type de données : chaîne
result.additionalCommittedItems.sysId	La sys_id trouvée pour ce CI supplémentaire grâce à 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
result.additionalCommittedItems.warnings	Tableau d’objets dans lequel chaque objet décrit un avertissement rencontré lors du traitement de ce CI supplémentaire. Type de données : tableau `"warnings": [ { "error": "String", "message": "String" } ]`
résultat.additionalCommittedItems.warnings.error	Type d’avertissement rencontré lors du traitement de ce CI supplémentaire. Type de données : chaîne
résultat.additionalCommittedItems.warnings.message	Message d’avertissement rencontré lors du traitement de ce CI supplémentaire. Type de données : chaîne
résultat.additionalCommittedRelations	Tableau d’objets dans lequel chaque objet décrit un CI de relation dépendant non inclus dans la liste du corps relations de la demande à insérer ou à mettre à jour. Type de données : tableau `"additionalCommittedRelations": [ { "className": "String", "operation": "String", "markers": [Array], "inputIndices": [Array], "mergedPayloadIds": [Array] } ]`
result.additionalCommittedRelations.className	sys_class_name de ce CI de relation dépendante supplémentaire. Seule valeur prise en charge : cmdb_rel_ci : table Relation CI. Type de données : chaîne
result.additionalCommittedRelations.errorCount	Le nombre d’erreurs rencontrées lors du traitement de ce CI de relation dépendante supplémentaire. Type de données : nombre
résultat.additionalRelationsEngagées.erreurs	Tableau d’objets dans lequel chaque objet décrit une erreur rencontrée lors du traitement de ce CI de relation dépendante supplémentaire. Type de données : tableau `"errors": [ { "error": "String", "message": "String" } ]`
résultat.additionalRelationsEngagées.errors.erreur	Type d’erreur rencontré lors du traitement de ce CI de relation dépendante supplémentaire. Type de données : chaîne
result.additionalCommittedRelations.errors.message	Message d’erreur rencontré lors du traitement de ce CI de relation dépendante supplémentaire. Type de données : chaîne
result.additionalCommittedRelations.inputIndex	Tableau des valeurs d’index pour les objets CI de relation dépendante dans le tableau de corps relations de la demande qui correspondent à ce CI de relation dépendante supplémentaire. Type de données : tableau `"inputIndices": [ Number ]`
result.additionalCommittedRelations.markers	Tableau de valeurs de marqueurs pour une utilisation interne. Type de données : tableau `"markers": []`
result.additionalCommittedRelations.mergedPayloadIds	Tableau de valeurs d’sys_id pour les charges utiles partielles de la table Charges utiles partielles IRE CMDB [cmdb_ire_partial_payloads] 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.additionnellesRelationsEngagées.opération	Opération exécutée pour ce CI de relation dépendante supplémentaire. Valeurs possibles : INSÉRER : le CI de relation dépendante est inséré dans la table cible en tant que nouvel enregistrement. INSERT_AS_INCOMPLETE : le CI de relation dépendante a commis des erreurs et est inséré dans la table Charges utiles incomplètes IRE CMDB [cmdb_ire_incomplete_payloads]. INSERT_AS_PARTIAL : le CI de relation dépendante a commis des erreurs et est inséré dans la table Charges utiles partielles IRE CMDB [cmdb_ire_partial_payloads]. NO_CHANGE : Aucune opération n’est effectuée pour le CI de relation dépendante. METTRE À JOUR : un CI de relation dépendante existant dans la table cible est mis à jour. Type de données : chaîne
éléments.résultats	Tableau d’objets dans lequel chaque objet décrit un CI inclus dans le tableau de corps items de la demande. Type de données : tableau `"items": [ { "additionalRelatedItems": [Array], "className": "String", "duplicateLookupIndices": {Object}, "errorCount": Number, "errors": [Array], "identificationAttempts": [Array], "identifierEntrySysId": "String", "info": [Array], "inputIndices": [Array], "markers": [Array], "mergedPayloadIds": [Array], "operation": "String", "relatedItems": [Array], "relatedSysIds": [Array], "sysId": "String", "warnings": [Array] } ]`
result.items.additionalRelatedItems	Tableau d’objets dans lequel chaque objet décrit un CI connexe (CI de recherche de table) de la table Charges utiles partielles IRE [cmdb_ire_partial_payloads] CMDB. Type de données : tableau `"additionalRelatedItems": [ { "className": "String", "inputIndices": [Array], "markers": [Array], "mergedPayloadIds": [Array], "sysId": "String" } ]`
result.items.additionalRelatedItems.className	sys_class_name de l’élément connexe. Type de données : chaîne
result.items.additionalRelatedItems.inputIndex	Tableau des valeurs d’index des CI du tableau de corps items de la demande qui correspondent à cet élément connexe. Type de données : tableau `"inputIndices": [ Number ]`
result.items.additionalRelatedItems.markers	Tableau de valeurs de marqueurs pour une utilisation interne. Type de données : tableau `"markers": []`
result.items.additionalRelatedItems.mergedPayloadIds	Tableau de valeurs sys_id pour les charges utiles partielles de la table Charges utiles partielles IRE CMDB [cmdb_ire_partial_payloads] qui ont été fusionnées au cours du traitement de cet élément connexe. Type de données : tableau `"mergedPayloadIds": [ "String" ]`
result.items.additionalRelatedItems.sysId	sys_id de ce CI connexe. Type de données : chaîne
result.items.className	sys_class_name de ce CI. Type de données : chaîne
result.items.duplicateLookupIndex	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 associé. 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 correspondent à 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	Tableau d’objets dans lequel chaque objet décrit une erreur rencontrée lors du traitement de ce CI. Type de données : tableau `"errors": [ { "error": "String", "message": "String" } ]`
résultat.éléments.erreurs.erreur	Type d’erreur rencontré lors du traitement de ce CI. Type de données : chaîne
result.items.errors.message	Message d’erreur rencontré lors du traitement de ce CI. Type de données : chaîne
result.items.identificationAttempts	Tableau d’objets dans lequel chaque objet décrit une tentative d’identification de ce CI. Type de données : tableau `"identificationAttempts": [ { "attemptResult": "String", "attributes": [Array], "hybridEntryCiAttributes": [Array], "identiferName": "String", "searchOnTable": [Array] } ]`
result.items.identificationAttempts.attemptResult	Résultat de cette tentative d’identification de CI. Valeurs possibles : MATCHED : identification réussie. Un CI unique a été trouvé dans la table de règles d’identificateur qui correspondait 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É : aucune tentative d’identification. Les attributs requis pour cette recherche dans la table de règles d’identificateurs n’ont pas été fournis, par conséquent la règle n’a pas été appliquée. Type de données : chaîne
result.items.identificationAttempts.attributes	Tableau d’attributs d’entrée d’identificateur CI utilisés pendant cette tentative d’identification 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", ]`
result.items.identificationAttempts.hybridEntryCiAttributes	Tableau d’attributs d’entrée d’identificateur CI utilisés pendant cette tentative d’identification 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" ]`
result.items.identificationAttempts.identifierName	Règle d’identificateur utilisée pour cette tentative d’identification de CI. Type de données : chaîne
result.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. Consultez errors pour en savoir plus. Type de données : chaîne
result.items.info	Liste d’objets contenant des informations supplémentaires sur le traitement de l’élément. Type de données : tableau `"info": [ { "code": "String", "message": "String", "ruleSysId": "String" } ]`
résultat.articles.info.code	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 qui a été mise en correspondance. Applicable uniquement lorsque le moteur IRE ignore la reclassification en raison de la règle de restriction de classification. 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
result.items.inputIndex	Tableau des valeurs d’index pour les CI provenant du tableau du corps items de la demande correspondant à ce CI. Type de données : tableau `"inputIndices": [ { Number } ]`
resultat.éléments.marqueurs	Tableau de valeurs de marqueurs pour une utilisation interne. Type de données : tableau `"markers": []`
result.items.mergedPayloadIds	Tableau des valeurs d’sys_id pour les charges utiles partielles de la table Charges utiles partielles [cmdb_ire_partial_payloads] IRE CMDB qui ont été fusionnées au cours du 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 : SUPPRIMER : 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 effectuée pour le CI. METTRE À 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 remplacée par 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 remplacée par une autre classe qui n’est ni une classe ancêtre ni descendante. UPDATE_WITH_UPGRADE : un CI existant dans la table cible est mis à jour et sa classe est remplacée par une classe plus spécialisée (classe descendante). Type de données : chaîne
result.items.relatedItems	Tableau d’objets dans lequel chaque objet décrit un CI connexe (CI de recherche de table) à partir du tableau de corps items.lookup de la demande. Type de données : tableau `"relatedItems": [ { "className": "String", "inputIndices": [Array], "markers": [Array], "mergedPayloadIds": [Array], "sysId": "String" } ]`
result.items.relatedItems.className	sys_class_name de l’élément connexe. Type de données : chaîne
result.items.relatedItems.inputIndex	Tableau des valeurs d’index pour les CI et les éléments de recherche dans le corps items de la demande et items.lookup les tableaux qui correspondent à cet élément connexe. Type de données : tableau `"inputIndices": [ { "mainIndex": Number, "subIndex": Number } ]`
result.items.relatedItems.inputIndices.mainIndex	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 de corps items.lookup de la demande qui correspond à l’élément connexe. Type de données : nombre
result.items.relatedItems.markers	Tableau de valeurs de marqueurs pour une utilisation interne. Type de données : tableau `"markers": []`
result.items.relatedItems.mergedPayloadIds	Tableau de valeurs sys_id pour les entrées de la table Charges utiles partielles IRE CMDB [cmdb_ire_partial_payloads] qui ont été fusionnées dans ce CI pendant le traitement. Type de données : tableau `"mergedPayloadIds": [ "String" ]`
result.items.relatedSysIds	Tableau des valeurs de sys_id pour les éléments connexes (éléments de recherche de table) provenant du tableau de 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 connexe. `"relatedSysIds": [ Number, Number ]`
result.items.sysId	La sys_id trouvée pour ce CI grâce à l’identification. Valeurs notables : Inconnu : échec de l’identification de ce CI. Consultez errors pour en savoir plus. Type de données : chaîne
resultat.éléments.avertissements	Tableau d’objets dans lequel chaque objet décrit un avertissement rencontré lors du traitement de ce CI. Type de données : tableau `"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
result.logContextId	ID de contexte signalé pour cette charge utile. Type de données : chaîne
relations.résultats	Tableau d’objets dans lequel chaque objet décrit un CI de relation dépendant du tableau de corps relations de la demande. Type de données : tableau `"relations": [ { "className": "String", "errorCount": Number, "errors": [Array], "inputIndices": [Array], "markers": [Array], "mergedPayloadIds": [Array], "operation": "String", "warnings": [Array] } ]`
result.relations.className	La sys_class_name de ce CI de relation dépendante. Seule valeur prise en charge : cmdb_rel_ci : table Relation CI. Type de données : chaîne
result.relations.errorCount	Le nombre d’erreurs rencontrées lors du traitement de ce CI de relation dépendante. Type de données : nombre
result.relations.erreurs	Tableau d’objets dans lequel chaque objet décrit une erreur rencontrée lors du traitement de ce CI de relation dépendante. Type de données : tableau `"errors": [ { "error": "String", "message": "String" } ]`
résultat.relations.erreurs.erreur	Type d’erreur rencontré lors du traitement de ce CI de relation dépendante. Type de données : chaîne
resultat.relations.erreurs.message	Message d’erreur rencontré lors du traitement de ce CI de relation dépendante. Type de données : chaîne
result.relations.inputIndex	Tableau des valeurs d’index pour les objets CI de relation dépendante dans le tableau de corps relations de la demande qui correspondent à ce CI de relation dépendante. Type de données : tableau `"inputIndices": [ Number ]`
result.relations.marqueurs	Tableau de valeurs de marqueurs pour une utilisation interne. Type de données : tableau `"markers": []`
result.relations.mergedPayloadIds	Tableau de valeurs d’sys_id pour les charges utiles partielles de la table Charges utiles partielles IRE CMDB [cmdb_ire_partial_payloads] 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épendant. 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 a commis des erreurs et a été inséré dans la table Charges utiles incomplètes IRE CMDB [cmdb_ire_incomplete_payloads]. INSERT_AS_PARTIAL : Le CI de relation dépendante a commis des erreurs et a été inséré dans la table Charges utiles partielles IRE CMDB [cmdb_ire_partial_payloads]. NO_CHANGE : aucune opération n’a été effectué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ésultats.relations.avertissements	Tableau d’objets dans lequel chaque objet décrit un avertissement rencontré lors du traitement de ce CI de relation dépendante. Type de données : tableau `"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 d’éléments connexes pour les numéros de série et les cartes 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 recherche de règle de matériel pour son nom dans la table Matériel [cmdb_ci_hardware] et est traité comme une mise à jour d’un CI existant dans la table du serveur Linux [cmdb_ci_linux_server]. Le commutateur IP est identifié de la même façon via une recherche de règle de matériel pour 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 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 réconciliation : POST /now/identifyreconcile/queryEnhanced

Détermine l’opération CMDB (insertion/mise à 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 Identification et réconciliation : POST /now/identifyreconcile/enhanced demande) au point de terminaison.

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

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

Format d'URL

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

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

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. Exemple : `v1` ou `v2`. Spécifiez uniquement cette valeur pour utiliser une version de point de terminaison différente de la dernière. Type de données : chaîne

Tableau 20. Paramètres de requête
Nom	Description
options	Liste de paires nom-valeur séparées par des virgules représentant les options IRE améliorées appliquées pour 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 des options IRE améliorées : `partial_payloads :faux,partial_commits :faux,deduplicate_payloads :faux,generate_summary :vrai` Remarque : Par défaut ou si partial_payloads est défini sur vrai, les deux partial_commits et deduplicate_payloads sont activés, même s’ils sont définis sur faux, car ces fonctionnalités sont essentielles pour la fonctionnalité des charges utiles partielles. Pour en savoir plus sur les options IRE améliorées, consultez Moteur Identification et réconciliation (IRE). Valeurs valides pour chaque paire nom-valeur : true : permet d’activer cette option IRE améliorée. false : désactivez cette option IRE améliorée. Type de données : chaîne
sysparm_data_source	Identifie la 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 É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	Tableau d’objets dans lequel chaque objet décrit un CI à créer ou à mettre à jour. Type de données : tableau `"items": [ { "className": "String", "internal_id": "String", "lookup": [Array], "related": [Array], "settings": {Object}, "sys_object_source_info": {Object}, "values": {Object} } ]`
items.className	Requis. sys_class_name (nom de classe/table) du CI à créer ou à mettre à jour. Cette valeur peut être n’importe quelle CMDB table, comme 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 prendre n’importe quelle valeur, mais doit être unique dans la charge utile. Type de données : chaîne
items.rechercher	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 `"lookup": [ { "className": "String", "internal_id": "String", "sys_object_source_info": {Object}, "values": {Object} } ]`
items.lookup.className	Requis. sys_class_name ou nom 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 pour cet enregistrement de recherche dans cette charge utile. Peut prendre n’importe quelle valeur, mais doit être unique dans la charge utile. Type de données : chaîne
items.lookup.sys_object_source_info	Objet décrivant un identificateur 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 façon unique le flux qui envoie ce CI. À utiliser si la source peut avoir plusieurs flux. Type de données : chaîne
items.lookup.sys_object_source_info.source_name	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 auxquelles le CI a été analysé. Type de données : chaîne Format : AAAA-MM-JJ 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 les 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, basé sur 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 que peut trouver ce tableau. La table associée 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 `"related": [ { "className": "String", "internal_id": "String", "sys_object_source_info": {Object}, "values": {Object} } ]`
items.related.className	Requis. Le 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 pour cet élément connexe dans cette charge utile. Peut prendre n’importe quelle valeur, mais doit être unique dans la charge utile. Type de données : chaîne
items.related.sys_object_source_info	Objet décrivant un identificateur 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 façon unique le flux qui envoie cet élément connexe. À utiliser si la source peut avoir plusieurs flux. Type de données : chaîne
items.related.sys_object_source_info.source_name	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 : AAAA-MM-JJ hh :mm :ss
valeurs.connexes.éléments.	Objet décrivant les champs à créer ou à mettre à jour pour cet élément connexe en tant que 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 les 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 des 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 classification qui correspond à la classe de l’élément de charge utile. Valeurs valides : true : ignorer l’exécution de la règle. false : exécute la règle. Valeur par défaut : false
items.settings.updateWithoutDowngrade	Indique si la mise à jour et le passage à une version antérieure sont autorisés pour ce CI. Valeurs valides : true : mettre à jour l’élément, mais l’installation d’une version antérieure n’est pas autorisée. false : la mise à jour d’é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	Indique si ce CI peut être mis à jour et si sa classe peut être changée. Valeurs valides : true : met à jour l’élément, mais le changement de classe n’est pas autorisé. false : la mise à jour d’élément et le changement de classe sont autorisés. Type de données : booléennes Valeur par défaut : false
items.settings.updateWithoutUpgrade	Indique si la mise à jour et la mise à niveau sont autorisées pour ce CI. Valeurs valides : true : met à jour l’élément, mais la mise à niveau n’est pas autorisée. false : la mise à jour et la mise à niveau d’éléments sont autorisées. Type de données : booléennes Valeur par défaut : false
items.sys_objet_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 façon unique le flux qui envoie ce CI. À utiliser si la source peut avoir plusieurs flux. Type de données : chaîne
items.sys_object_source_info.source_name	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 auxquelles le CI a été analysé. Type de données : chaîne Format : AAAA-MM-JJ hh :mm :ss
éléments.valeurs	Objet décrivant les champs à créer ou à mettre à jour pour ce CI en tant que 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 les 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	Tableau d’objets dans lequel chaque objet décrit une référence entre deux éléments de la charge utile. Type de données : tableau `"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/table pour l’élément referencedBy . Type de données : chaîne
Relations	Tableau d’objets dans lequel chaque objet décrit une relation 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 parentchild de paires nom-valeur, les valeurs représentant les index d’éléments du tableau de charges items utiles. L’objet peut définir une relation entre deux éléments quelconques, y compris des éléments de niveau supérieur, connexes ou de recherche, à l’aide parent_id de child_id paires clé/valeur, avec des valeurs représentant internal_id des valeurs définies pour ces éléments. Type de données : tableau `"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	L’index 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.parent	Index 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étection pour la relation. Pour les relations de non-dépendance, ces informations se trouvent 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.source_name	Nom de la source de détection. Par défaut : source de détection transmise dans le paramètre de méthode d’API.
relations.sys_rel_source_info.source_feed	Toute chaîne qui est une sous-détection/analyse au sein de la source de détection. 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 parents et enfants. 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.
Content-Type	Format de 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
Aucun

Codes d'état

Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir une 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é correctement traitée.
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 « Chunk [...] is not a valid entry » indique que le paramètre de requête n’est options pas dans le format de paire nom-valeur correct. Par exemple, la spécification d’un options paramètre `partiel` produit un code d’état 500 avec « Chunk [partiel] is not a valid entry » dans le détail du message.

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


Nom	Description
résultat	Tableau des résultats produits par la requête. Type de données : tableau `"result": [ "additionalCommittedItems": [Array], "additionalCommittedRelations": [Array], "items": [Array], "relations": [Array] ]`
result.additionalCommittedItems	Tableau d’objets dans lequel chaque objet décrit un CI non inclus dans le corps de la demande items Tableau à insérer ou à mettre à jour. Type de données : tableau `"additionalCommittedItems": [ { "className": "String", "errorCount": Number, "identificationAttempts": [Array], "inputIndices": [Array], "markers": [Array], "mergedPayloads": [Array], "operation": "String", "sysId": "String" } ]`
result.additionalCommittedItems.className	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	Tableau d’objets dans lequel chaque objet décrit une erreur rencontrée lors du traitement de ce CI supplémentaire. Type de données : tableau `"errors": [ { "error": "String", "message": "String" } ]`
résultat.additionalCommittedItems.errors.error	Type d’erreur rencontré lors du traitement de ce CI supplémentaire. Type de données : chaîne
résultat.additionalCommittedItems.errors.message	Message d’erreur rencontré lors du traitement de ce CI supplémentaire. Type de données : chaîne
result.additionalCommittedItems.identificationAttempts	Tableau d’objets dans lequel chaque objet décrit une tentative d’identification de ce CI supplémentaire. Type de données : tableau `"identificationAttempts": [ { "attemptResult": "String", "attributes": [Array], "hybridEntryCiAttributes": [Array], "identiferName": "String", "searchOnTable": [Array] } ]`
résultat.additionalCommittedItems.identificationAttempts.attemptResult	Résultat de cette tentative d’identification de CI supplémentaire. Valeurs possibles : MATCHED : identification réussie. Un CI unique a été trouvé dans la table de règles d’identificateur qui correspondait 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É : aucune tentative d’identification. Les attributs requis pour cette recherche dans la table de règles d’identificateurs n’ont pas été fournis, par conséquent la règle n’a pas été appliquée. Type de données : chaîne
result.additionalCommittedItems.identificationAttempts.attributes	Tableau des attributs d’entrée d’identificateur de CI utilisés lors 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", ]`
result.additionalCommittedItems.identificationAttempts.hybridEntryCiAttributes	Tableau des attributs d’entrée d’identificateur de CI utilisés lors 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" ]`
result.additionalCommittedItems.identificationAttempts.identifierName	Règle d’identificateur utilisée pour cette tentative d’identification de CI supplémentaire. Type de données : chaîne
result.additionalCommittedItems.identificationAttempts.searchOnTable	Nom de la table recherchée pour cette tentative d’identification de CI supplémentaire. Type de données : chaîne
result.additionalCommittedItems.identifierEntrySysId	sys_id de 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
result.additionalCommittedItems.inputIndex	Tableau 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 `"inputIndices": [ { Number } ]`
result.additionalCommittedItems.markers	Tableau de valeurs de marqueurs pour une utilisation interne. Type de données : tableau `"markers": []`
result.additionalCommittedItems.mergedPayloads	Tableau de valeurs sys_id pour les 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 supplémentaire. Type de données : tableau `"mergedPayloadIds": [ "String" ]`
résultat.additionalCommittedItems.operation	Opération effectuée pour ce CI supplémentaire. Valeurs possibles : SUPPRIMER : un CI existant est supprimé de la table cible. INSÉRER : 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. METTRE À 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 remplacée par 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 remplacée par une autre classe qui n’est ni une classe ancêtre ni descendante. UPDATE_WITH_UPGRADE : un CI existant dans la table cible est mis à jour et sa classe est remplacée par une classe plus spécialisée (classe descendante). Type de données : chaîne
result.additionalCommittedItems.sysId	La sys_id trouvée pour ce CI supplémentaire grâce à 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
result.additionalCommittedItems.warnings	Tableau d’objets dans lequel chaque objet décrit un avertissement rencontré lors du traitement de ce CI supplémentaire. Type de données : tableau `"warnings": [ { "error": "String", "message": "String" } ]`
résultat.additionalCommittedItems.warnings.error	Type d’avertissement rencontré lors du traitement de ce CI supplémentaire. Type de données : chaîne
résultat.additionalCommittedItems.warnings.message	Message d’avertissement rencontré lors du traitement de ce CI supplémentaire. Type de données : chaîne
résultat.additionalCommittedRelations	Tableau d’objets dans lequel chaque objet décrit un CI de relation dépendant non inclus dans la liste du corps relations de la demande à insérer ou à mettre à jour. Type de données : tableau `"additionalCommittedRelations": [ { "className": "String", "operation": "String", "markers": [Array], "inputIndices": [Array], "mergedPayloadIds": [Array] } ]`
result.additionalCommittedRelations.className	sys_class_name de ce CI de relation dépendante supplémentaire. Seule valeur prise en charge : cmdb_rel_ci : table Relation CI. Type de données : chaîne
result.additionalCommittedRelations.errorCount	Le nombre d’erreurs rencontrées lors du traitement de ce CI de relation dépendante supplémentaire. Type de données : nombre
résultat.additionalRelationsEngagées.erreurs	Tableau d’objets dans lequel chaque objet décrit une erreur rencontrée lors du traitement de ce CI de relation dépendante supplémentaire. Type de données : tableau `"errors": [ { "error": "String", "message": "String" } ]`
résultat.additionalRelationsEngagées.errors.erreur	Type d’erreur rencontré lors du traitement de ce CI de relation dépendante supplémentaire. Type de données : chaîne
result.additionalCommittedRelations.errors.message	Message d’erreur rencontré lors du traitement de ce CI de relation dépendante supplémentaire. Type de données : chaîne
result.additionalCommittedRelations.inputIndex	Tableau des valeurs d’index pour les objets CI de relation dépendante dans le tableau de corps relations de la demande qui correspondent à ce CI de relation dépendante supplémentaire. Type de données : tableau `"inputIndices": [ Number ]`
result.additionalCommittedRelations.markers	Tableau de valeurs de marqueurs pour une utilisation interne. Type de données : tableau `"markers": []`
result.additionalCommittedRelations.mergedPayloadIds	Tableau de valeurs d’sys_id pour les charges utiles partielles de la table Charges utiles partielles IRE CMDB [cmdb_ire_partial_payloads] 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.additionnellesRelationsEngagées.opération	Opération exécutée pour ce CI de relation dépendante supplémentaire. Valeurs possibles : INSÉRER : le CI de relation dépendante est inséré dans la table cible en tant que nouvel enregistrement. INSERT_AS_INCOMPLETE : le CI de relation dépendante a commis des erreurs et est inséré dans la table Charges utiles incomplètes IRE CMDB [cmdb_ire_incomplete_payloads]. INSERT_AS_PARTIAL : le CI de relation dépendante a commis des erreurs et est inséré dans la table Charges utiles partielles IRE CMDB [cmdb_ire_partial_payloads]. NO_CHANGE : Aucune opération n’est effectuée pour le CI de relation dépendante. METTRE À JOUR : un CI de relation dépendante existant dans la table cible est mis à jour. Type de données : chaîne
éléments.résultats	Tableau d’objets dans lequel chaque objet décrit un CI inclus dans le tableau de corps items de la demande. Type de données : tableau `"items": [ { "additionalRelatedItems": [Array], "className": "String", "duplicateLookupIndices": {Object}, "errorCount": Number, "errors": [Array], "identificationAttempts": [Array], "identifierEntrySysId": "String", "info": [Array], "inputIndices": [Array], "markers": [Array], "mergedPayloadIds": [Array], "operation": "String", "relatedItems": [Array], "relatedSysIds": [Array], "sysId": "String", "warnings": [Array] } ]`
result.items.additionalRelatedItems	Tableau d’objets dans lequel chaque objet décrit un CI connexe (CI de recherche de table) de la table Charges utiles partielles IRE [cmdb_ire_partial_payloads] CMDB. Type de données : tableau `"additionalRelatedItems": [ { "className": "String", "inputIndices": [Array], "markers": [Array], "mergedPayloadIds": [Array], "sysId": "String" } ]`
result.items.additionalRelatedItems.className	sys_class_name de l’élément connexe. Type de données : chaîne
result.items.additionalRelatedItems.inputIndex	Tableau des valeurs d’index des CI du tableau de corps items de la demande qui correspondent à cet élément connexe. Type de données : tableau `"inputIndices": [ Number ]`
result.items.additionalRelatedItems.markers	Tableau de valeurs de marqueurs pour une utilisation interne. Type de données : tableau `"markers": []`
result.items.additionalRelatedItems.mergedPayloadIds	Tableau de valeurs sys_id pour les charges utiles partielles de la table Charges utiles partielles IRE CMDB [cmdb_ire_partial_payloads] qui ont été fusionnées au cours du traitement de cet élément connexe. Type de données : tableau `"mergedPayloadIds": [ "String" ]`
result.items.additionalRelatedItems.sysId	sys_id de ce CI connexe. Type de données : chaîne
result.items.className	sys_class_name de ce CI. Type de données : chaîne
result.items.duplicateLookupIndex	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 associé. 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 correspondent à 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	Tableau d’objets dans lequel chaque objet décrit une erreur rencontrée lors du traitement de ce CI. Type de données : tableau `"errors": [ { "error": "String", "message": "String" } ]`
résultat.éléments.erreurs.erreur	Type d’erreur rencontré lors du traitement de ce CI. Type de données : chaîne
result.items.errors.message	Message d’erreur rencontré lors du traitement de ce CI. Type de données : chaîne
result.items.identificationAttempts	Tableau d’objets dans lequel chaque objet décrit une tentative d’identification de ce CI. Type de données : tableau `"identificationAttempts": [ { "attemptResult": "String", "attributes": [Array], "hybridEntryCiAttributes": [Array], "identiferName": "String", "searchOnTable": [Array] } ]`
result.items.identificationAttempts.attemptResult	Résultat de cette tentative d’identification de CI. Valeurs possibles : MATCHED : identification réussie. Un CI unique a été trouvé dans la table de règles d’identificateur qui correspondait 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É : aucune tentative d’identification. Les attributs requis pour cette recherche dans la table de règles d’identificateurs n’ont pas été fournis, par conséquent la règle n’a pas été appliquée. Type de données : chaîne
result.items.identificationAttempts.attributes	Tableau d’attributs d’entrée d’identificateur CI utilisés pendant cette tentative d’identification 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", ]`
result.items.identificationAttempts.hybridEntryCiAttributes	Tableau d’attributs d’entrée d’identificateur CI utilisés pendant cette tentative d’identification 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" ]`
result.items.identificationAttempts.identifierName	Règle d’identificateur utilisée pour cette tentative d’identification de CI. Type de données : chaîne
result.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. Consultez errors pour en savoir plus. Type de données : chaîne
result.items.info	Liste d’objets contenant des informations supplémentaires sur le traitement de l’élément. Type de données : tableau `"info": [ { "code": "String", "message": "String", "ruleSysId": "String" } ]`
résultat.articles.info.code	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 qui a été mise en correspondance. Applicable uniquement lorsque le moteur IRE ignore la reclassification en raison de la règle de restriction de classification. 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
result.items.inputIndex	Tableau des valeurs d’index pour les CI provenant du tableau du corps items de la demande correspondant à ce CI. Type de données : tableau `"inputIndices": [ { Number } ]`
resultat.éléments.marqueurs	Tableau de valeurs de marqueurs pour une utilisation interne. Type de données : tableau `"markers": []`
result.items.mergedPayloadIds	Tableau des valeurs d’sys_id pour les charges utiles partielles de la table Charges utiles partielles [cmdb_ire_partial_payloads] IRE CMDB qui ont été fusionnées au cours du 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 : SUPPRIMER : 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 effectuée pour le CI. METTRE À 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 remplacée par 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 remplacée par une autre classe qui n’est ni une classe ancêtre ni descendante. UPDATE_WITH_UPGRADE : un CI existant dans la table cible est mis à jour et sa classe est remplacée par une classe plus spécialisée (classe descendante). Type de données : chaîne
result.items.relatedItems	Tableau d’objets dans lequel chaque objet décrit un CI connexe (CI de recherche de table) à partir du tableau de corps items.lookup de la demande. Type de données : tableau `"relatedItems": [ { "className": "String", "inputIndices": [Array], "markers": [Array], "mergedPayloadIds": [Array], "sysId": "String" } ]`
result.items.relatedItems.className	sys_class_name de l’élément connexe. Type de données : chaîne
result.items.relatedItems.inputIndex	Tableau des valeurs d’index pour les CI et les éléments de recherche dans le corps items de la demande et items.lookup les tableaux qui correspondent à cet élément connexe. Type de données : tableau `"inputIndices": [ { "mainIndex": Number, "subIndex": Number } ]`
result.items.relatedItems.inputIndices.mainIndex	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 de corps items.lookup de la demande qui correspond à l’élément connexe. Type de données : nombre
result.items.relatedItems.markers	Tableau de valeurs de marqueurs pour une utilisation interne. Type de données : tableau `"markers": []`
result.items.relatedItems.mergedPayloadIds	Tableau de valeurs sys_id pour les entrées de la table Charges utiles partielles IRE CMDB [cmdb_ire_partial_payloads] qui ont été fusionnées dans ce CI pendant le traitement. Type de données : tableau `"mergedPayloadIds": [ "String" ]`
result.items.relatedSysIds	Tableau des valeurs de sys_id pour les éléments connexes (éléments de recherche de table) provenant du tableau de 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 connexe. `"relatedSysIds": [ Number, Number ]`
result.items.sysId	La sys_id trouvée pour ce CI grâce à l’identification. Valeurs notables : Inconnu : échec de l’identification de ce CI. Consultez errors pour en savoir plus. Type de données : chaîne
resultat.éléments.avertissements	Tableau d’objets dans lequel chaque objet décrit un avertissement rencontré lors du traitement de ce CI. Type de données : tableau `"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
result.logContextId	ID de contexte signalé pour cette charge utile. Type de données : chaîne
relations.résultats	Tableau d’objets dans lequel chaque objet décrit un CI de relation dépendant du tableau de corps relations de la demande. Type de données : tableau `"relations": [ { "className": "String", "errorCount": Number, "errors": [Array], "inputIndices": [Array], "markers": [Array], "mergedPayloadIds": [Array], "operation": "String", "warnings": [Array] } ]`
result.relations.className	La sys_class_name de ce CI de relation dépendante. Seule valeur prise en charge : cmdb_rel_ci : table Relation CI. Type de données : chaîne
result.relations.errorCount	Le nombre d’erreurs rencontrées lors du traitement de ce CI de relation dépendante. Type de données : nombre
result.relations.erreurs	Tableau d’objets dans lequel chaque objet décrit une erreur rencontrée lors du traitement de ce CI de relation dépendante. Type de données : tableau `"errors": [ { "error": "String", "message": "String" } ]`
résultat.relations.erreurs.erreur	Type d’erreur rencontré lors du traitement de ce CI de relation dépendante. Type de données : chaîne
resultat.relations.erreurs.message	Message d’erreur rencontré lors du traitement de ce CI de relation dépendante. Type de données : chaîne
result.relations.inputIndex	Tableau des valeurs d’index pour les objets CI de relation dépendante dans le tableau de corps relations de la demande qui correspondent à ce CI de relation dépendante. Type de données : tableau `"inputIndices": [ Number ]`
result.relations.marqueurs	Tableau de valeurs de marqueurs pour une utilisation interne. Type de données : tableau `"markers": []`
result.relations.mergedPayloadIds	Tableau de valeurs d’sys_id pour les charges utiles partielles de la table Charges utiles partielles IRE CMDB [cmdb_ire_partial_payloads] 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épendant. 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 a commis des erreurs et a été inséré dans la table Charges utiles incomplètes IRE CMDB [cmdb_ire_incomplete_payloads]. INSERT_AS_PARTIAL : Le CI de relation dépendante a commis des erreurs et a été inséré dans la table Charges utiles partielles IRE CMDB [cmdb_ire_partial_payloads]. NO_CHANGE : aucune opération n’a été effectué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ésultats.relations.avertissements	Tableau d’objets dans lequel chaque objet décrit un avertissement rencontré lors du traitement de ce CI de relation dépendante. Type de données : tableau `"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 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 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 synthèse 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
      }
    }
  }
}