API d’identification et de rapprochement

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 106 minutes de lecture

    • L’API Identification et rapprochement fournit des points de terminaison qui utilisent le moteur IRE (Identification et rapprochement) pour minimiser la création d’éléments de configuration (CI) en double et pour rapprocher les attributs de CI en acceptant uniquement des 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 en CMDB 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 mettre à jour directement le CMDB .

    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 point de terminaison à la Identification et réconciliation : POST /now/identifyreconcile/enhanced place si vous devez spécifier des options IRE améliorées. Pour plus d’informations 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 Source des informations du CI. Elle doit être l’une des valeurs de choix définies pour le champ discovery_source de la table d’éléments de configuration [cmdb_ci].

    Type de données : chaîne

    Par défaut : insérez la charge utile de l’API dans la table des charges utiles incomplètes.
    Tableau 3. Paramètres de corps de demande (XML ou JSON)
    Nom Description
    Éléments Liste des CI à créer ou mettre à jour.

    Type de données : tableau d’objets

    "items": [
  {
    "className": "String",
    "internal_id": "String",
    "lookup": [Array],
    "related": [Array],
    "settings": {Object},
    "sys_object_source_info": {Object},
    "values": {Object}
  }
]
    items.className Requis. Le sys_class_name (nom de classe/table) du CI à créer ou à mettre à jour. Cette valeur peut être n’importe quelle CMDB table, telle que cmdb_ci_linux_server ou cmdb_ci_win_server.

    Type de données : chaîne
    items.internal_id Identificateur unique de cet élément dans cette charge utile. Peut avoir n’importe quelle valeur, mais doit être unique dans la charge utile.

    Type de données : chaîne
    items.lookup 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 d’éléments de configuration [cmdb_ci].

    Type de données : Tableau désactivé Objets

    "lookup": [
  {
    "className": "String",
    "internal_id": "String",
    "sys_object_source_info": {Object},
    "values": {Object}
  }
]
    items.lookup.className Requis. Le nom de la sys_class_name ou de la 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 avoir 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 envoyant 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 de 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 du 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 UTC Date et heure auxquelles le CI a été analysé.

    Type de données : chaîne

    Format : JJ-MM-AAAA hh :mm :ss
    éléments.recherche.valeurs Objet décrivant les champs de cet élément de recherche sous forme de paires nom/valeur, où le nom est le nom de 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, en fonction d’une table connexe qui fait référence au CI de niveau supérieur en cours d’identification. Les règles de la table Entrée connexe [cmdb_related_entry] définissent quel type d’enregistrements peut figurer dans ce tableau.

    La table connexe peut étendre ou non la table d’éléments de configuration [cmdb_ci]. Ces enregistrements ne sont pas utilisés pour identifier l’élément de configuration.

    Type de données : tableau d’objets

    "related": [
  {
    "className": "String",
    "internal_id": "String",
    "sys_object_source_info": {Object},
    "values": {Object}
  }
]
    items.related.className Requis. 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 de cet élément connexe dans cette charge utile. Peut avoir 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 envoyant cet élément associé. À 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 : JJ-MM-AAAA hh :mm :ss
    éléments.valeurs.connexes Objet décrivant les champs à créer ou mettre à jour pour cet élément connexe sous forme de paires nom/valeur, où le nom est le nom du champ. Pour un champ de référence, la valeur doit être le sys_id référencé.

    Type de données : objet

    Les noms et 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 reclassification qui correspond à la classe de l’élément de charge utile.
    Valeurs valides :
    • true : ignorer l’exécution de la règle.
    • false : exécuter la règle.

    Valeur par défaut : false
    items.settings.updateWithoutDowngrade Marqueur indiquant si la mise à jour et le passage à une version antérieure sont autorisés pour ce CI.
    Valeurs valides :
    • vrai : Mettez à jour l’élément, mais le passage à une version antérieure n’est pas autorisé.
    • faux : la mise à jour et le passage à une version antérieure de l’élément sont autorisés.

    Type de données : booléennes

    Valeur par défaut : false
    items.settings.updateWithoutSwitch Marqueur indiquant si ce CI peut être mis à jour et sa classe commutée.
    Valeurs valides :
    • vrai : Mettez à 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 Marqueur indiquant si la mise à jour et la mise à niveau sont autorisées pour ce CI.
    Valeurs valides :
    • vrai : Mettez à jour l’élément, mais la mise à niveau n’est pas autorisée.
    • faux : 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_object_source_info Objet décrivant un identificateur 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 envoyant 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 de 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 du 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 UTC Date et heure auxquelles le CI a été analysé.

    Type de données : chaîne

    Format : JJ-MM-AAAA hh :mm :ss
    éléments.valeurs Objet décrivant les champs à créer ou mettre à jour pour ce CI sous forme de paires nom/valeur, où le nom est le nom de 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 Liste de référence entre deux éléments de la charge utile.

    Type de données : tableau d’objets

    "referenceItems": [
  {
    "referenced": "String",
    "referencedBy": "String",
    "referenceField": "String"
  }
]
    referenceItems.referenced Défini internal_id pour l’élément référencé par un autre élément.

    Type de données : chaîne
    referenceItems.referencedBy Défini internal_id pour l’élément qui fait référence à un autre élément.

    Type de données : chaîne
    referenceItems.referenceField Nom du champ de référence dans la classe/la table de l’élément referencedBy .

    Type de données : chaîne
    Relations Liste des relations entre deux éléments définis dans la charge utile.
    Un objet de ce tableau peut utiliser l’un des deux formats suivants :
    • L’objet peut définir une relation entre deux éléments de niveau supérieur (uniquement) à l’aide parentchild de paires nom-valeur, les valeurs représentant les index d’élément du tableau de charge items utile.
    • 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, les valeurs représentant internal_id les valeurs définies pour ces éléments.

    Type de données : tableau d’objets

    "relations": [
  {
    "child": Number,
    "parent": Number,
    "sys_rel_source_info": {Object},
    "type": "String"
  }
]
    "relations": [
  {
    "child_id": "String",
    "parent_id": "String",
    "sys_rel_source_info": {Object},
    "type": "String"
  }
]
    relations.enfant Index 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 De internal_id l’élément 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 De internal_id l’élément parent dans la relation.

    Type de données : chaîne
    relations.sys_rel_source_info Informations sur la source de découverte pour la relation. Pour les relations de non-dépendance, ces informations figurent dans la table Sources de relations [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écouverte.

    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écouverte/analyse au sein de la source de découverte.

    Par défaut : « INCONNU » est stocké dans la colonne source_feed lors de la création d’un enregistrement dans sys_rel_source table.
    relations.type Type de relation existant entre les éléments 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 la liste des en-têtes généraux utilisés dans l’API REST, consultez En-têtes d’API REST pris en charge.

    Tableau 4. En-têtes de demandes
    En-tête Description
    Accepter Format de données du corps de la réponse. Prend uniquement en charge application/json.
    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 la liste des codes d’état possibles utilisés dans l’API REST, consultez Codes de réponse HTTP de l’API REST.

    Tableau 6. Codes d'état
    Code d'état Description
    200 Réussi. La demande a été 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 du corps de réponse (JSON ou XML)

    Nom Description
    résultat Liste des résultats produits par la requête.

    Type de données : tableau

    "result": [
  "additionalCommittedItems": [Array],
  "additionalCommittedRelations": [Array],
  "items": [Array],
  "relations": [Array]
]
    résultat.additionalCommittedItems Liste des CI non inclus dans le tableau du corps items de la demande à insérer ou à mettre à jour.

    Type de données : tableau d’objets

    "additionalCommittedItems": [
  {
    "className": "String",
    "errorCount": Number,
    "identificationAttempts": [Array],
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloads": [Array],
    "operation": "String",
    "sysId": "String"
  }
]
    result.additionalCommittedItems.className sys_class_name de ce CI supplémentaire.

    Type de données : chaîne
    result.additionalCommittedItems.errorCount Nombre d’erreurs rencontrées lors du traitement de ce CI supplémentaire.

    Type de données : nombre
    résultat.additionalCommittedItems.errors Liste des erreurs rencontrées lors du traitement de ce CI supplémentaire.

    Type de données : tableau d’objets

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    résultat.additionalCommittedItems.errors.error Type d’erreur rencontrée lors du traitement de ce CI supplémentaire.

    Type de données : chaîne
    résultat.élémentscommittedssupplémentaires.erreurs.message Un message d’erreur s’est produit lors du traitement de ce CI supplémentaire.

    Type de données : chaîne
    result.additionalCommittedItems.identificationAttempts Liste des tentatives effectuées pour identifier ce CI supplémentaire.
    Type de données : tableau d’objets
    "identificationAttempts": [
  {
    "attemptResult": "String",
    "attributes": [Array],
    "hybridEntryCiAttributes": [Array],
    "identiferName": "String",
    "searchOnTable": [Array]
  }
]
    résultat.additionalCommittedItems.identificationAttempts.attemptResult Résultat de cette tentative d’identification de CI supplémentaire.
    Valeurs possibles :
    • CORRESPONDANT : 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’identificateurs 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’identificateurs.
    • 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
    résultat.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 Liste des attributs d’entrée d’identificateur de CI utilisés au cours de cette tentative d’identification de CI supplémentaire.

    Type de données : tableau

    Les noms et types d’attributs dépendent des données du corps de la demande et de l’identificateur utilisé, par exemple :

    "hybridEntryCiAttributes": [
  "name": "String",
  "serial_number": "String"
]
    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
    résultat.additionalCommittedItems.inputIndex Liste des valeurs d’index pour les CI du tableau du corps items de la demande qui correspondent à ce CI supplémentaire.

    Type de données : tableau d’objets

    "inputIndices": [
  {
    Number
  }
]
    résultat.additionalCommittedItems.markers Liste des valeurs de marqueur à usage interne.

    Type de données : tableau

    "markers": []
    résultat.additionalCommittedItems.mergedPayloads Liste des valeurs de sys_id pour les charges utiles partielles de la table Charges utiles partielles IRE [cmdb_ire_partial_payloads] 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 exécutée pour ce CI supplémentaire.
    Valeurs possibles :
    • DELETE : un CI existant est supprimé de la table cible.
    • INSERT : le CI supplémentaire est inséré dans la table cible en tant que nouvel enregistrement.
    • NO_CHANGE : Aucune opération n’est effectuée pour le CI supplémentaire.
    • 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 (ancienne classe).
    • 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 une classe 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 Sys_id trouvé pour ce CI supplémentaire via l’identification.

    Valeurs notables : Inconnu : échec de l’identification de ce CI supplémentaire. Consultez errors pour en savoir plus.

    Type de données : chaîne
    résultat.additionalCommittedItems.avertissements Liste des avertissements rencontrés lors du traitement de ce CI supplémentaire.

    Type de données : tableau d’objets

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    résultat.additionalCommittedItems.avertissements.erreur Type d’avertissement rencontré lors du traitement de ce CI supplémentaire.

    Type de données : chaîne
    résultat.additionalCommittedItems.warnings.message Un message d’avertissement s’est produit lors du traitement de ce CI supplémentaire.

    Type de données : chaîne
    résultat.additionalCommittedRelations Liste des CI de relation dépendante non inclus dans la liste du corps relations de la demande à insérer ou à mettre à jour.

    Type de données : tableau d’objets

    "additionalCommittedRelations": [
  {
    "className": "String",
    "operation": "String",
    "markers": [Array],
    "inputIndices": [Array],
    "mergedPayloadIds": [Array]
  }
]
    result.additionalCommittedRelations.className Le sys_class_name de ce CI de relation dépendante supplémentaire.
    Seule valeur prise en charge :
    • cmdb_rel_ci : table des relations CI.

    Type de données : chaîne
    result.additionalCommittedRelations.errorCount Nombre d’erreurs rencontrées lors du traitement de ce CI de relation dépendante supplémentaire.

    Type de données : nombre
    résultat.additionalCommittedRelations.errors Liste des erreurs rencontrées lors du traitement de ce CI de relation dépendante supplémentaire.

    Type de données : tableau d’objets

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    résultat.additionalCommittedRelations.errors.error Type d’erreur rencontrée lors du traitement de ce CI de relation dépendante supplémentaire.

    Type de données : chaîne
    résultat.additionalCommittedRelations.errors.message Un message d’erreur s’est produit pendant le traitement de ce CI de relation dépendante supplémentaire.

    Type de données : chaîne
    result.additionalCommittedRelations.inputIndices Liste des valeurs d’index pour les objets CI de relation dépendante dans le tableau du 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 Liste des valeurs de marqueur à usage interne.

    Type de données : tableau

    "markers": []
    result.additionalCommittedRelations.mergedPayloadIds Liste des valeurs de sys_id pour les charges utiles partielles de la table Charges utiles partielles IRE [cmdb_ire_partial_payloads] CMDB qui ont été fusionnées pendant le traitement de ce CI de relation dépendante supplémentaire.

    Type de données : tableau

    "mergedPayloadIds": [
  "String"
]
    résultat.additionalCommittedRelations.operation Opération effectuée pour ce CI de relation dépendante supplémentaire.
    Valeurs possibles :
    • INSÉRER : le CI de relation dépendant 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_ire_incomplete_payloads] CMDB.
    • 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_ire_partial_payloads] CMDB.
    • NO_CHANGE : Aucune opération n’est effectuée pour le CI de relation dépendant.
    • 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 Liste des CI inclus dans le tableau du corps items de la demande.

    Type de données : tableau d’objets

    "items": [
  {
    "additionalRelatedItems": [Array],
    "className": "String",
    "duplicateLookupIndices": {Object},
    "errorCount": Number,
    "errors": [Array],
    "identificationAttempts": [Array],
    "identifierEntrySysId": "String",
    "info": [Array],
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloadIds": [Array],
    "operation": "String",
    "relatedItems": [Array],
    "relatedSysIds": [Array],
    "sysId": "String",
    "warnings": [Array]
  }
]
    result.items.additionalRelatedItems Liste des CI associés (CI de recherche de table) de la table Charges utiles partielles IRE [cmdb_ire_partial_payloads] de la CMDB.

    Type de données : tableau d’objets

    "additionalRelatedItems": [
  {
    "className": "String",
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloadIds": [Array],
    "sysId": "String"
  }
]
    result.items.additionalRelatedItems.className sys_class_name de l’élément connexe.

    Type de données : chaîne
    result.items.additionalRelatedItems.inputIndex Liste des valeurs d’index pour les CI du tableau du corps items de la demande qui correspondent à cet élément connexe.

    Type de données : tableau

    "inputIndices": [
    Number
]
    result.items.additionalRelatedItems.markers Liste des valeurs de marqueur à usage interne.

    Type de données : tableau

    "markers": []
    result.items.additionalRelatedItems.mergedPayloadIds Liste des valeurs de sys_id pour les charges utiles partielles de la table Charges utiles partielles IRE [cmdb_ire_partial_payloads] de la CMDB qui ont été fusionnées pendant le traitement de cet élément connexe.

    Type de données : tableau

    "mergedPayloadIds": [
  "String"
]
    result.items.additionalRelatedItems.sysId Sys_id de ce CI connexe.

    Type de données : chaîne
    result.items.className Sys_class_name de ce CI.

    Type de données : chaîne
    résultat.éléments.duplicateLookupIndex Objet contenant des tableaux de valeurs d’index pour items.lookup les éléments du tableau qui font référence au même CI associé.

    Le nom du tableau indique le premier élément du tableau du corps items.lookup de la demande qui fait référence à un CI associé donné. Ses valeurs sont l’ensemble des éléments supplémentaires du même tableau qui font référence au même CI associé.

    Type de données : objet

    Cet exemple montre un cas où le deuxième élément du items.lookup tableau fait référence au même CI connexe qu’un élément ultérieur de ce tableau :

    "duplicateLookupIndices": [
  "2": [Array]
]
    result.items.errorCount Nombre d’erreurs rencontrées lors du traitement de ce CI.

    Type de données : nombre
    résultat.éléments.erreurs Liste des erreurs rencontrées lors du traitement de ce CI.

    Type de données : tableau d’objets

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    résultat.éléments.erreurs.erreur Type d’erreur rencontrée lors du traitement de ce CI.

    Type de données : chaîne
    résultat.éléments.erreurs.message Un message d’erreur s’est produit lors du traitement de ce CI.

    Type de données : chaîne
    result.items.identificationAttempts Liste des tentatives d’identification effectuées pour ce CI.
    Type de données : tableau d’objets
    "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 :
    • CORRESPONDANT : 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’identificateurs 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’identificateurs.
    • 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 Liste des attributs d’entrée d’identificateur CI utilisés au cours de 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 Liste des attributs d’entrée d’identificateur CI utilisés au cours de 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. Pour plus de détails, voir errors.

    Type de données : chaîne
    result.items.info Liste d’informations supplémentaires sur le traitement de l’élément.

    Type de données : tableau d’objets

    "info": [
  {
    "code": "String",
    "message": "String",
    "ruleSysId": "String"
  }
]
    resultats.éléments.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 IRE ignore la reclassification en raison de la règle de restriction de reclassification. Cette valeur est vide si la reclassification est ignorée en raison d’une charge utile ou d’un marqueur global.

    Type de données : chaîne
    result.items.inputIndex Liste des valeurs d’index pour les CI du tableau du corps items de la demande qui correspondent à ce CI.

    Type de données : tableau d’objets

    "inputIndices": [
  {
    Number
  }
]
    résultat.éléments.marqueurs Liste des valeurs de marqueur à usage interne.

    Type de données : tableau

    "markers": []
    result.items.mergedPayloadIds Liste des valeurs sys_id des charges utiles partielles de la table Charges utiles partielles IRE [cmdb_ire_partial_payloads] de la CMDB qui ont été fusionnées pendant le traitement de ce CI.

    Type de données : tableau

    "mergedPayloadIds": [
  "String"
]
    résultat.éléments.opération Opération exécutée pour ce CI.
    Valeurs possibles :
    • DELETE : un CI existant est supprimé de la table cible.
    • INSERT : le CI est inséré dans la table cible en tant que nouvel enregistrement.
    • NO_CHANGE : Aucune opération n’est effectuée sur 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 (ancienne classe).
    • 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 une classe 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 Liste des CI associés (CI de recherche de table) à partir du tableau du corps items.lookup de la demande.

    Type de données : tableau d’objets

    "relatedItems": [
  {
    "className": "String",
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloadIds": [Array],
    "sysId": "String"
  }
]
    result.items.relatedItems.className sys_class_name de l’élément connexe.

    Type de données : chaîne
    result.items.relatedItems.inputIndex Liste des valeurs d’index pour les CI et des é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 d’objets

    "inputIndices": [
  {
    "mainIndex": Number,
    "subIndex": Number
  }
]
    result.items.relatedItems.inputIndices.mainIndex Valeur d’index du tableau du corps items de la demande qui correspond au parent CI de l’élément connexe.

    Type de données : nombre
    result.items.relatedItems.inputIndices.subIndex Valeur d’index du tableau du corps items.lookup de la demande qui correspond à l’élément connexe.

    Type de données : nombre
    result.items.relatedItems.markers Liste des valeurs de marqueur à usage interne.

    Type de données : tableau

    "markers": []
    result.items.relatedItems.mergedPayloadIds Liste des valeurs de sys_id des entrées de la table Charges utiles partielles IRE [cmdb_ire_partial_payloads] CMDB qui ont été fusionnées dans ce CI pendant le traitement.

    Type de données : tableau

    "mergedPayloadIds": [
  "String"
]
    result.items.relatedSysIds Liste des valeurs sys_id pour les éléments connexes (éléments de recherche de table) à partir du tableau du corps items.lookup de la demande.

    Type de données : tableau

    Valeurs notables :
    • nul : aucune sys_id n’a été identifiée pour cet élément connexe.
    "relatedSysIds": [
    Number,
    Number
]
    result.items.sysId Sys_id trouvé pour ce CI par identification.
    Valeurs notables :
    • Inconnu : échec de l’identification de ce CI. Consultez errors pour en savoir plus.

    Type de données : chaîne
    résultat.éléments.avertissements Liste des avertissements rencontrés lors du traitement de ce CI.

    Type de données : tableau d’objets

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    résultat.éléments.avertissements.erreur Type d’avertissement rencontré pendant le traitement de ce CI.

    Type de données : chaîne
    résultat.éléments.avertissements.message Message d’avertissement rencontré pendant le 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 Liste des CI de relation dépendante du tableau du corps relations de la demande.

    Type de données : tableau d’objets

    "relations": [
  {
    "className": "String",
    "errorCount": Number,
    "errors": [Array],
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloadIds": [Array],
    "operation": "String",
    "warnings": [Array]
  }
]
    result.relations.className Le sys_class_name de ce CI de relation dépendante.
    Seule valeur prise en charge :
    • cmdb_rel_ci : table des relations CI.

    Type de données : chaîne
    result.relations.errorCount Nombre d’erreurs rencontrées lors du traitement de ce CI de relation dépendante.

    Type de données : nombre
    résultat.relations.erreurs Liste des erreurs rencontrées lors du traitement de ce CI de relation dépendante.

    Type de données : tableau d’objets

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    résultat.relations.erreurs.erreur Type d’erreur rencontrée lors du traitement de ce CI de relation dépendante.

    Type de données : chaîne
    résultat.relations.erreurs.message Message d’erreur rencontré pendant le traitement de ce CI de relation dépendante.

    Type de données : chaîne
    résultat.relations.inputIndex Liste des valeurs d’index pour les objets CI de relation dépendante dans le tableau du corps relations de la demande qui correspondent à ce CI de relation dépendante.

    Type de données : tableau

    "inputIndices": [
  Number
]
    result.relations.marqueurs Liste des valeurs de marqueur à usage interne.

    Type de données : tableau

    "markers": []
    result.relations.mergedPayloadIds Liste des valeurs de sys_id pour les charges utiles partielles de la table Charges utiles partielles IRE [cmdb_ire_partial_payloads] CMDB qui ont été fusionnées pendant le traitement de ce CI de relation dépendante.

    Type de données : tableau

    "mergedPayloadIds": [
  "String"
]
    Résultat.Relations.Opération Opération effectuée pour ce CI de relation dépendante.
    Valeurs possibles :
    • INSÉRER : le CI de relation dépendante a été inséré dans la table cible en tant que nouvel enregistrement.
    • INSERT_AS_INCOMPLETE : Le CI de relation dépendante comportait des erreurs et a été inséré dans la table Charges utiles incomplètes IRE [cmdb_ire_incomplete_payloads] CMDB.
    • INSERT_AS_PARTIAL : Le CI de relation dépendante comportait des erreurs et a été inséré dans la table Charges utiles partielles IRE [cmdb_ire_partial_payloads] CMDB.
    • NO_CHANGE : Aucune opération n’a été effectuée pour le CI de relation dépendant.
    • 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 Liste des avertissements rencontrés lors du traitement de ce CI de relation dépendante.

    Type de données : tableau d’objets

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    résultat.relations.avertissements.erreur Type d’avertissement rencontré pendant le traitement de ce CI de relation dépendante.

    Type de données : chaîne
    résultat.relations.avertissements.message Message d’avertissement rencontré pendant le 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 de numéros de série et d’éléments connexes de carte réseau) et un commutateur IP, avec une relation dépendante de la connexion IP entre eux.

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

    Le CI de serveur Linux est identifié via une recherche de règle matérielle 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 Serveur Linux [cmdb_ci_linux_server]. Le commutateur IP est identifié de la même manière via une règle matérielle, recherchez son nom dans la table Matériel et met à jour un CI existant dans la table Commutateur IP [cmdb_ci_ip_switch]. Enfin, la relation dépendante de la connexion IP entre le serveur et le commutateur est insérée en tant que nouvel enregistrement dans la table Relation 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

    Insère ou met à jour des éléments de configuration (CI) dans le en CMDB 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 mettre à jour directement le CMDB .

    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 élément présentant un avertissement ou une erreur, indique si une opération d’élément est INSERT_AS_PARTIAL ou INSERT_INCOMPLETE.
      • Renvoie la sys_ids de charges utiles partielles qui ont été fusionnées avec des 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 séparée par des virgules de paires nom-valeur 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 de déduplication et générer des options IRE améliorées de résumé :

    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é de charges utiles partielles.

    Pour plus d’informations sur les options IRE améliorées, consultez Moteur Identification et réconciliation (IRE).

    Valeurs valides pour chaque paire nom-valeur :
    • vrai : activez cette option IRE améliorée.
    • false : désactivez cette option IRE améliorée.

    Type de données : chaîne
    sysparm_data_source Source des informations du CI. Elle doit être l’une des valeurs de choix définies pour le champ discovery_source de la table d’éléments de configuration [cmdb_ci].

    Type de données : chaîne

    Par défaut : insérez la charge utile de l’API dans la table des charges utiles incomplètes.
    Tableau 9. Paramètres de corps de demande (XML ou JSON)
    Nom Description
    Éléments Liste des CI à créer ou mettre à jour.

    Type de données : tableau d’objets

    "items": [
  {
    "className": "String",
    "internal_id": "String",
    "lookup": [Array],
    "related": [Array],
    "settings": {Object},
    "sys_object_source_info": {Object},
    "values": {Object}
  }
]
    items.className Requis. Le sys_class_name (nom de classe/table) du CI à créer ou à mettre à jour. Cette valeur peut être n’importe quelle CMDB table, telle que cmdb_ci_linux_server ou cmdb_ci_win_server.

    Type de données : chaîne
    items.internal_id Identificateur unique de cet élément dans cette charge utile. Peut avoir n’importe quelle valeur, mais doit être unique dans la charge utile.

    Type de données : chaîne
    items.lookup 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 d’éléments de configuration [cmdb_ci].

    Type de données : Tableau désactivé Objets

    "lookup": [
  {
    "className": "String",
    "internal_id": "String",
    "sys_object_source_info": {Object},
    "values": {Object}
  }
]
    items.lookup.className Requis. Le nom de la sys_class_name ou de la 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 avoir 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 envoyant 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 de 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 du 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 UTC Date et heure auxquelles le CI a été analysé.

    Type de données : chaîne

    Format : JJ-MM-AAAA hh :mm :ss
    éléments.recherche.valeurs Objet décrivant les champs de cet élément de recherche sous forme de paires nom/valeur, où le nom est le nom de 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, en fonction d’une table connexe qui fait référence au CI de niveau supérieur en cours d’identification. Les règles de la table Entrée connexe [cmdb_related_entry] définissent quel type d’enregistrements peut figurer dans ce tableau.

    La table connexe peut étendre ou non la table d’éléments de configuration [cmdb_ci]. Ces enregistrements ne sont pas utilisés pour identifier l’élément de configuration.

    Type de données : tableau d’objets

    "related": [
  {
    "className": "String",
    "internal_id": "String",
    "sys_object_source_info": {Object},
    "values": {Object}
  }
]
    items.related.className Requis. 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 de cet élément connexe dans cette charge utile. Peut avoir 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 envoyant cet élément associé. À 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 : JJ-MM-AAAA hh :mm :ss
    éléments.valeurs.connexes Objet décrivant les champs à créer ou mettre à jour pour cet élément connexe sous forme de paires nom/valeur, où le nom est le nom du champ. Pour un champ de référence, la valeur doit être le sys_id référencé.

    Type de données : objet

    Les noms et 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 reclassification qui correspond à la classe de l’élément de charge utile.
    Valeurs valides :
    • true : ignorer l’exécution de la règle.
    • false : exécuter la règle.

    Valeur par défaut : false
    items.settings.updateWithoutDowngrade Marqueur indiquant si la mise à jour et le passage à une version antérieure sont autorisés pour ce CI.
    Valeurs valides :
    • vrai : Mettez à jour l’élément, mais le passage à une version antérieure n’est pas autorisé.
    • faux : la mise à jour et le passage à une version antérieure de l’élément sont autorisés.

    Type de données : booléennes

    Valeur par défaut : false
    items.settings.updateWithoutSwitch Marqueur indiquant si ce CI peut être mis à jour et sa classe commutée.
    Valeurs valides :
    • vrai : Mettez à 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 Marqueur indiquant si la mise à jour et la mise à niveau sont autorisées pour ce CI.
    Valeurs valides :
    • vrai : Mettez à jour l’élément, mais la mise à niveau n’est pas autorisée.
    • faux : 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_object_source_info Objet décrivant un identificateur 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 envoyant 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 de 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 du 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 UTC Date et heure auxquelles le CI a été analysé.

    Type de données : chaîne

    Format : JJ-MM-AAAA hh :mm :ss
    éléments.valeurs Objet décrivant les champs à créer ou mettre à jour pour ce CI sous forme de paires nom/valeur, où le nom est le nom de 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 Liste de référence entre deux éléments de la charge utile.

    Type de données : tableau d’objets

    "referenceItems": [
  {
    "referenced": "String",
    "referencedBy": "String",
    "referenceField": "String"
  }
]
    referenceItems.referenced Défini internal_id pour l’élément référencé par un autre élément.

    Type de données : chaîne
    referenceItems.referencedBy Défini internal_id pour l’élément qui fait référence à un autre élément.

    Type de données : chaîne
    referenceItems.referenceField Nom du champ de référence dans la classe/la table de l’élément referencedBy .

    Type de données : chaîne
    Relations Liste des relations entre deux éléments définis dans la charge utile.
    Un objet de ce tableau peut utiliser l’un des deux formats suivants :
    • L’objet peut définir une relation entre deux éléments de niveau supérieur (uniquement) à l’aide parentchild de paires nom-valeur, les valeurs représentant les index d’élément du tableau de charge items utile.
    • 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, les valeurs représentant internal_id les valeurs définies pour ces éléments.

    Type de données : tableau d’objets

    "relations": [
  {
    "child": Number,
    "parent": Number,
    "sys_rel_source_info": {Object},
    "type": "String"
  }
]
    "relations": [
  {
    "child_id": "String",
    "parent_id": "String",
    "sys_rel_source_info": {Object},
    "type": "String"
  }
]
    relations.enfant Index 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 De internal_id l’élément 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 De internal_id l’élément parent dans la relation.

    Type de données : chaîne
    relations.sys_rel_source_info Informations sur la source de découverte pour la relation. Pour les relations de non-dépendance, ces informations figurent dans la table Sources de relations [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écouverte.

    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écouverte/analyse au sein de la source de découverte.

    Par défaut : « INCONNU » est stocké dans la colonne source_feed lors de la création d’un enregistrement dans sys_rel_source table.
    relations.type Type de relation existant entre les éléments 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 la liste des en-têtes généraux utilisés dans l’API REST, consultez En-têtes d’API REST pris en charge.

    Tableau 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 la liste des codes d’état possibles utilisés dans l’API REST, consultez Codes de réponse HTTP de l’API REST.

    Tableau 12. Codes d'état
    Code d'état Description
    200 Réussi. La demande a été 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.

    Le détail du message d’erreur « Chunk [...] is not a valid entry » indique que le paramètre de requête n’est options pas au 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] n’est pas une entrée valide » dans le détail du message.

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

    Nom Description
    résultat Liste des résultats produits par la requête.

    Type de données : tableau

    "result": [
  "additionalCommittedItems": [Array],
  "additionalCommittedRelations": [Array],
  "items": [Array],
  "relations": [Array]
]
    résultat.additionalCommittedItems Liste des CI non inclus dans le tableau du corps items de la demande à insérer ou à mettre à jour.

    Type de données : tableau d’objets

    "additionalCommittedItems": [
  {
    "className": "String",
    "errorCount": Number,
    "identificationAttempts": [Array],
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloads": [Array],
    "operation": "String",
    "sysId": "String"
  }
]
    result.additionalCommittedItems.className sys_class_name de ce CI supplémentaire.

    Type de données : chaîne
    result.additionalCommittedItems.errorCount Nombre d’erreurs rencontrées lors du traitement de ce CI supplémentaire.

    Type de données : nombre
    résultat.additionalCommittedItems.errors Liste des erreurs rencontrées lors du traitement de ce CI supplémentaire.

    Type de données : tableau d’objets

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    résultat.additionalCommittedItems.errors.error Type d’erreur rencontrée lors du traitement de ce CI supplémentaire.

    Type de données : chaîne
    résultat.élémentscommittedssupplémentaires.erreurs.message Un message d’erreur s’est produit lors du traitement de ce CI supplémentaire.

    Type de données : chaîne
    result.additionalCommittedItems.identificationAttempts Liste des tentatives effectuées pour identifier ce CI supplémentaire.
    Type de données : tableau d’objets
    "identificationAttempts": [
  {
    "attemptResult": "String",
    "attributes": [Array],
    "hybridEntryCiAttributes": [Array],
    "identiferName": "String",
    "searchOnTable": [Array]
  }
]
    résultat.additionalCommittedItems.identificationAttempts.attemptResult Résultat de cette tentative d’identification de CI supplémentaire.
    Valeurs possibles :
    • CORRESPONDANT : 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’identificateurs 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’identificateurs.
    • 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
    résultat.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 Liste des attributs d’entrée d’identificateur de CI utilisés au cours de cette tentative d’identification de CI supplémentaire.

    Type de données : tableau

    Les noms et types d’attributs dépendent des données du corps de la demande et de l’identificateur utilisé, par exemple :

    "hybridEntryCiAttributes": [
  "name": "String",
  "serial_number": "String"
]
    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
    résultat.additionalCommittedItems.inputIndex Liste des valeurs d’index pour les CI du tableau du corps items de la demande qui correspondent à ce CI supplémentaire.

    Type de données : tableau d’objets

    "inputIndices": [
  {
    Number
  }
]
    résultat.additionalCommittedItems.markers Liste des valeurs de marqueur à usage interne.

    Type de données : tableau

    "markers": []
    résultat.additionalCommittedItems.mergedPayloads Liste des valeurs de sys_id pour les charges utiles partielles de la table Charges utiles partielles IRE [cmdb_ire_partial_payloads] 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 exécutée pour ce CI supplémentaire.
    Valeurs possibles :
    • DELETE : un CI existant est supprimé de la table cible.
    • INSERT : le CI supplémentaire est inséré dans la table cible en tant que nouvel enregistrement.
    • NO_CHANGE : Aucune opération n’est effectuée pour le CI supplémentaire.
    • 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 (ancienne classe).
    • 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 une classe 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 Sys_id trouvé pour ce CI supplémentaire via l’identification.

    Valeurs notables : Inconnu : échec de l’identification de ce CI supplémentaire. Consultez errors pour en savoir plus.

    Type de données : chaîne
    résultat.additionalCommittedItems.avertissements Liste des avertissements rencontrés lors du traitement de ce CI supplémentaire.

    Type de données : tableau d’objets

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    résultat.additionalCommittedItems.avertissements.erreur Type d’avertissement rencontré lors du traitement de ce CI supplémentaire.

    Type de données : chaîne
    résultat.additionalCommittedItems.warnings.message Un message d’avertissement s’est produit lors du traitement de ce CI supplémentaire.

    Type de données : chaîne
    résultat.additionalCommittedRelations Liste des CI de relation dépendante non inclus dans la liste du corps relations de la demande à insérer ou à mettre à jour.

    Type de données : tableau d’objets

    "additionalCommittedRelations": [
  {
    "className": "String",
    "operation": "String",
    "markers": [Array],
    "inputIndices": [Array],
    "mergedPayloadIds": [Array]
  }
]
    result.additionalCommittedRelations.className Le sys_class_name de ce CI de relation dépendante supplémentaire.
    Seule valeur prise en charge :
    • cmdb_rel_ci : table des relations CI.

    Type de données : chaîne
    result.additionalCommittedRelations.errorCount Nombre d’erreurs rencontrées lors du traitement de ce CI de relation dépendante supplémentaire.

    Type de données : nombre
    résultat.additionalCommittedRelations.errors Liste des erreurs rencontrées lors du traitement de ce CI de relation dépendante supplémentaire.

    Type de données : tableau d’objets

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    résultat.additionalCommittedRelations.errors.error Type d’erreur rencontrée lors du traitement de ce CI de relation dépendante supplémentaire.

    Type de données : chaîne
    résultat.additionalCommittedRelations.errors.message Un message d’erreur s’est produit pendant le traitement de ce CI de relation dépendante supplémentaire.

    Type de données : chaîne
    result.additionalCommittedRelations.inputIndices Liste des valeurs d’index pour les objets CI de relation dépendante dans le tableau du 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 Liste des valeurs de marqueur à usage interne.

    Type de données : tableau

    "markers": []
    result.additionalCommittedRelations.mergedPayloadIds Liste des valeurs de sys_id pour les charges utiles partielles de la table Charges utiles partielles IRE [cmdb_ire_partial_payloads] CMDB qui ont été fusionnées pendant le traitement de ce CI de relation dépendante supplémentaire.

    Type de données : tableau

    "mergedPayloadIds": [
  "String"
]
    résultat.additionalCommittedRelations.operation Opération effectuée pour ce CI de relation dépendante supplémentaire.
    Valeurs possibles :
    • INSÉRER : le CI de relation dépendant 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_ire_incomplete_payloads] CMDB.
    • 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_ire_partial_payloads] CMDB.
    • NO_CHANGE : Aucune opération n’est effectuée pour le CI de relation dépendant.
    • 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 Liste des CI inclus dans le tableau du corps items de la demande.

    Type de données : tableau d’objets

    "items": [
  {
    "additionalRelatedItems": [Array],
    "className": "String",
    "duplicateLookupIndices": {Object},
    "errorCount": Number,
    "errors": [Array],
    "identificationAttempts": [Array],
    "identifierEntrySysId": "String",
    "info": [Array],
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloadIds": [Array],
    "operation": "String",
    "relatedItems": [Array],
    "relatedSysIds": [Array],
    "sysId": "String",
    "warnings": [Array]
  }
]
    result.items.additionalRelatedItems Liste des CI associés (CI de recherche de table) de la table Charges utiles partielles IRE [cmdb_ire_partial_payloads] de la CMDB.

    Type de données : tableau d’objets

    "additionalRelatedItems": [
  {
    "className": "String",
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloadIds": [Array],
    "sysId": "String"
  }
]
    result.items.additionalRelatedItems.className sys_class_name de l’élément connexe.

    Type de données : chaîne
    result.items.additionalRelatedItems.inputIndex Liste des valeurs d’index pour les CI du tableau du corps items de la demande qui correspondent à cet élément connexe.

    Type de données : tableau

    "inputIndices": [
    Number
]
    result.items.additionalRelatedItems.markers Liste des valeurs de marqueur à usage interne.

    Type de données : tableau

    "markers": []
    result.items.additionalRelatedItems.mergedPayloadIds Liste des valeurs de sys_id pour les charges utiles partielles de la table Charges utiles partielles IRE [cmdb_ire_partial_payloads] de la CMDB qui ont été fusionnées pendant le traitement de cet élément connexe.

    Type de données : tableau

    "mergedPayloadIds": [
  "String"
]
    result.items.additionalRelatedItems.sysId Sys_id de ce CI connexe.

    Type de données : chaîne
    result.items.className Sys_class_name de ce CI.

    Type de données : chaîne
    résultat.éléments.duplicateLookupIndex Objet contenant des tableaux de valeurs d’index pour items.lookup les éléments du tableau qui font référence au même CI associé.

    Le nom du tableau indique le premier élément du tableau du corps items.lookup de la demande qui fait référence à un CI associé donné. Ses valeurs sont l’ensemble des éléments supplémentaires du même tableau qui font référence au même CI associé.

    Type de données : objet

    Cet exemple montre un cas où le deuxième élément du items.lookup tableau fait référence au même CI connexe qu’un élément ultérieur de ce tableau :

    "duplicateLookupIndices": [
  "2": [Array]
]
    result.items.errorCount Nombre d’erreurs rencontrées lors du traitement de ce CI.

    Type de données : nombre
    résultat.éléments.erreurs Liste des erreurs rencontrées lors du traitement de ce CI.

    Type de données : tableau d’objets

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    résultat.éléments.erreurs.erreur Type d’erreur rencontrée lors du traitement de ce CI.

    Type de données : chaîne
    résultat.éléments.erreurs.message Un message d’erreur s’est produit lors du traitement de ce CI.

    Type de données : chaîne
    result.items.identificationAttempts Liste des tentatives d’identification effectuées pour ce CI.
    Type de données : tableau d’objets
    "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 :
    • CORRESPONDANT : 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’identificateurs 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’identificateurs.
    • 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 Liste des attributs d’entrée d’identificateur CI utilisés au cours de 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 Liste des attributs d’entrée d’identificateur CI utilisés au cours de 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. Pour plus de détails, voir errors.

    Type de données : chaîne
    result.items.info Liste d’informations supplémentaires sur le traitement de l’élément.

    Type de données : tableau d’objets

    "info": [
  {
    "code": "String",
    "message": "String",
    "ruleSysId": "String"
  }
]
    resultats.éléments.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 IRE ignore la reclassification en raison de la règle de restriction de reclassification. Cette valeur est vide si la reclassification est ignorée en raison d’une charge utile ou d’un marqueur global.

    Type de données : chaîne
    result.items.inputIndex Liste des valeurs d’index pour les CI du tableau du corps items de la demande qui correspondent à ce CI.

    Type de données : tableau d’objets

    "inputIndices": [
  {
    Number
  }
]
    résultat.éléments.marqueurs Liste des valeurs de marqueur à usage interne.

    Type de données : tableau

    "markers": []
    result.items.mergedPayloadIds Liste des valeurs sys_id des charges utiles partielles de la table Charges utiles partielles IRE [cmdb_ire_partial_payloads] de la CMDB qui ont été fusionnées pendant le traitement de ce CI.

    Type de données : tableau

    "mergedPayloadIds": [
  "String"
]
    résultat.éléments.opération Opération exécutée pour ce CI.
    Valeurs possibles :
    • DELETE : un CI existant est supprimé de la table cible.
    • INSERT : le CI est inséré dans la table cible en tant que nouvel enregistrement.
    • NO_CHANGE : Aucune opération n’est effectuée sur 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 (ancienne classe).
    • 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 une classe 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 Liste des CI associés (CI de recherche de table) à partir du tableau du corps items.lookup de la demande.

    Type de données : tableau d’objets

    "relatedItems": [
  {
    "className": "String",
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloadIds": [Array],
    "sysId": "String"
  }
]
    result.items.relatedItems.className sys_class_name de l’élément connexe.

    Type de données : chaîne
    result.items.relatedItems.inputIndex Liste des valeurs d’index pour les CI et des é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 d’objets

    "inputIndices": [
  {
    "mainIndex": Number,
    "subIndex": Number
  }
]
    result.items.relatedItems.inputIndices.mainIndex Valeur d’index du tableau du corps items de la demande qui correspond au parent CI de l’élément connexe.

    Type de données : nombre
    result.items.relatedItems.inputIndices.subIndex Valeur d’index du tableau du corps items.lookup de la demande qui correspond à l’élément connexe.

    Type de données : nombre
    result.items.relatedItems.markers Liste des valeurs de marqueur à usage interne.

    Type de données : tableau

    "markers": []
    result.items.relatedItems.mergedPayloadIds Liste des valeurs de sys_id des entrées de la table Charges utiles partielles IRE [cmdb_ire_partial_payloads] CMDB qui ont été fusionnées dans ce CI pendant le traitement.

    Type de données : tableau

    "mergedPayloadIds": [
  "String"
]
    result.items.relatedSysIds Liste des valeurs sys_id pour les éléments connexes (éléments de recherche de table) à partir du tableau du corps items.lookup de la demande.

    Type de données : tableau

    Valeurs notables :
    • nul : aucune sys_id n’a été identifiée pour cet élément connexe.
    "relatedSysIds": [
    Number,
    Number
]
    result.items.sysId Sys_id trouvé pour ce CI par identification.
    Valeurs notables :
    • Inconnu : échec de l’identification de ce CI. Consultez errors pour en savoir plus.

    Type de données : chaîne
    résultat.éléments.avertissements Liste des avertissements rencontrés lors du traitement de ce CI.

    Type de données : tableau d’objets

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    résultat.éléments.avertissements.erreur Type d’avertissement rencontré pendant le traitement de ce CI.

    Type de données : chaîne
    résultat.éléments.avertissements.message Message d’avertissement rencontré pendant le 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 Liste des CI de relation dépendante du tableau du corps relations de la demande.

    Type de données : tableau d’objets

    "relations": [
  {
    "className": "String",
    "errorCount": Number,
    "errors": [Array],
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloadIds": [Array],
    "operation": "String",
    "warnings": [Array]
  }
]
    result.relations.className Le sys_class_name de ce CI de relation dépendante.
    Seule valeur prise en charge :
    • cmdb_rel_ci : table des relations CI.

    Type de données : chaîne
    result.relations.errorCount Nombre d’erreurs rencontrées lors du traitement de ce CI de relation dépendante.

    Type de données : nombre
    résultat.relations.erreurs Liste des erreurs rencontrées lors du traitement de ce CI de relation dépendante.

    Type de données : tableau d’objets

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    résultat.relations.erreurs.erreur Type d’erreur rencontrée lors du traitement de ce CI de relation dépendante.

    Type de données : chaîne
    résultat.relations.erreurs.message Message d’erreur rencontré pendant le traitement de ce CI de relation dépendante.

    Type de données : chaîne
    résultat.relations.inputIndex Liste des valeurs d’index pour les objets CI de relation dépendante dans le tableau du corps relations de la demande qui correspondent à ce CI de relation dépendante.

    Type de données : tableau

    "inputIndices": [
  Number
]
    result.relations.marqueurs Liste des valeurs de marqueur à usage interne.

    Type de données : tableau

    "markers": []
    result.relations.mergedPayloadIds Liste des valeurs de sys_id pour les charges utiles partielles de la table Charges utiles partielles IRE [cmdb_ire_partial_payloads] CMDB qui ont été fusionnées pendant le traitement de ce CI de relation dépendante.

    Type de données : tableau

    "mergedPayloadIds": [
  "String"
]
    Résultat.Relations.Opération Opération effectuée pour ce CI de relation dépendante.
    Valeurs possibles :
    • INSÉRER : le CI de relation dépendante a été inséré dans la table cible en tant que nouvel enregistrement.
    • INSERT_AS_INCOMPLETE : Le CI de relation dépendante comportait des erreurs et a été inséré dans la table Charges utiles incomplètes IRE [cmdb_ire_incomplete_payloads] CMDB.
    • INSERT_AS_PARTIAL : Le CI de relation dépendante comportait des erreurs et a été inséré dans la table Charges utiles partielles IRE [cmdb_ire_partial_payloads] CMDB.
    • NO_CHANGE : Aucune opération n’a été effectuée pour le CI de relation dépendant.
    • 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 Liste des avertissements rencontrés lors du traitement de ce CI de relation dépendante.

    Type de données : tableau d’objets

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    résultat.relations.avertissements.erreur Type d’avertissement rencontré pendant le traitement de ce CI de relation dépendante.

    Type de données : chaîne
    résultat.relations.avertissements.message Message d’avertissement rencontré pendant le traitement de ce CI de relation dépendante.

    Type de données : chaîne

    Demande cURL

    Soumettre 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_ire_partial_payloads] CMDB.

    {
  "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 résumé activée.

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

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

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

    Identification et 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 demande) au Identification et réconciliation : POST /now/identifyreconcile point de terminaison.

    Utilisez le point de terminaison à la Identification et réconciliation : POST /now/identifyreconcile/enhanced place si vous devez spécifier des options IRE améliorées. Pour plus d’informations 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/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 Source des informations du CI. Elle doit être l’une des valeurs de choix définies pour le champ discovery_source de la table d’éléments de configuration [cmdb_ci].

    Type de données : chaîne

    Par défaut : insérez la charge utile de l’API dans la table des charges utiles incomplètes.
    Tableau 15. Paramètres de corps de demande (XML ou JSON)
    Nom Description
    Éléments Liste des CI à créer ou mettre à jour.

    Type de données : tableau d’objets

    "items": [
  {
    "className": "String",
    "internal_id": "String",
    "lookup": [Array],
    "related": [Array],
    "settings": {Object},
    "sys_object_source_info": {Object},
    "values": {Object}
  }
]
    items.className Requis. Le sys_class_name (nom de classe/table) du CI à créer ou à mettre à jour. Cette valeur peut être n’importe quelle CMDB table, telle que cmdb_ci_linux_server ou cmdb_ci_win_server.

    Type de données : chaîne
    items.internal_id Identificateur unique de cet élément dans cette charge utile. Peut avoir n’importe quelle valeur, mais doit être unique dans la charge utile.

    Type de données : chaîne
    items.lookup 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 d’éléments de configuration [cmdb_ci].

    Type de données : Tableau désactivé Objets

    "lookup": [
  {
    "className": "String",
    "internal_id": "String",
    "sys_object_source_info": {Object},
    "values": {Object}
  }
]
    items.lookup.className Requis. Le nom de la sys_class_name ou de la 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 avoir 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 envoyant 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 de 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 du 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 UTC Date et heure auxquelles le CI a été analysé.

    Type de données : chaîne

    Format : JJ-MM-AAAA hh :mm :ss
    éléments.recherche.valeurs Objet décrivant les champs de cet élément de recherche sous forme de paires nom/valeur, où le nom est le nom de 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, en fonction d’une table connexe qui fait référence au CI de niveau supérieur en cours d’identification. Les règles de la table Entrée connexe [cmdb_related_entry] définissent quel type d’enregistrements peut figurer dans ce tableau.

    La table connexe peut étendre ou non la table d’éléments de configuration [cmdb_ci]. Ces enregistrements ne sont pas utilisés pour identifier l’élément de configuration.

    Type de données : tableau d’objets

    "related": [
  {
    "className": "String",
    "internal_id": "String",
    "sys_object_source_info": {Object},
    "values": {Object}
  }
]
    items.related.className Requis. 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 de cet élément connexe dans cette charge utile. Peut avoir 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 envoyant cet élément associé. À 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 : JJ-MM-AAAA hh :mm :ss
    éléments.valeurs.connexes Objet décrivant les champs à créer ou mettre à jour pour cet élément connexe sous forme de paires nom/valeur, où le nom est le nom du champ. Pour un champ de référence, la valeur doit être le sys_id référencé.

    Type de données : objet

    Les noms et 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 reclassification qui correspond à la classe de l’élément de charge utile.
    Valeurs valides :
    • true : ignorer l’exécution de la règle.
    • false : exécuter la règle.

    Valeur par défaut : false
    items.settings.updateWithoutDowngrade Marqueur indiquant si la mise à jour et le passage à une version antérieure sont autorisés pour ce CI.
    Valeurs valides :
    • vrai : Mettez à jour l’élément, mais le passage à une version antérieure n’est pas autorisé.
    • faux : la mise à jour et le passage à une version antérieure de l’élément sont autorisés.

    Type de données : booléennes

    Valeur par défaut : false
    items.settings.updateWithoutSwitch Marqueur indiquant si ce CI peut être mis à jour et sa classe commutée.
    Valeurs valides :
    • vrai : Mettez à 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 Marqueur indiquant si la mise à jour et la mise à niveau sont autorisées pour ce CI.
    Valeurs valides :
    • vrai : Mettez à jour l’élément, mais la mise à niveau n’est pas autorisée.
    • faux : 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_object_source_info Objet décrivant un identificateur 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 envoyant 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 de 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 du 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 UTC Date et heure auxquelles le CI a été analysé.

    Type de données : chaîne

    Format : JJ-MM-AAAA hh :mm :ss
    éléments.valeurs Objet décrivant les champs à créer ou mettre à jour pour ce CI sous forme de paires nom/valeur, où le nom est le nom de 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 Liste de référence entre deux éléments de la charge utile.

    Type de données : tableau d’objets

    "referenceItems": [
  {
    "referenced": "String",
    "referencedBy": "String",
    "referenceField": "String"
  }
]
    referenceItems.referenced Défini internal_id pour l’élément référencé par un autre élément.

    Type de données : chaîne
    referenceItems.referencedBy Défini internal_id pour l’élément qui fait référence à un autre élément.

    Type de données : chaîne
    referenceItems.referenceField Nom du champ de référence dans la classe/la table de l’élément referencedBy .

    Type de données : chaîne
    Relations Liste des relations entre deux éléments définis dans la charge utile.
    Un objet de ce tableau peut utiliser l’un des deux formats suivants :
    • L’objet peut définir une relation entre deux éléments de niveau supérieur (uniquement) à l’aide parentchild de paires nom-valeur, les valeurs représentant les index d’élément du tableau de charge items utile.
    • 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, les valeurs représentant internal_id les valeurs définies pour ces éléments.

    Type de données : tableau d’objets

    "relations": [
  {
    "child": Number,
    "parent": Number,
    "sys_rel_source_info": {Object},
    "type": "String"
  }
]
    "relations": [
  {
    "child_id": "String",
    "parent_id": "String",
    "sys_rel_source_info": {Object},
    "type": "String"
  }
]
    relations.enfant Index 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 De internal_id l’élément 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 De internal_id l’élément parent dans la relation.

    Type de données : chaîne
    relations.sys_rel_source_info Informations sur la source de découverte pour la relation. Pour les relations de non-dépendance, ces informations figurent dans la table Sources de relations [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écouverte.

    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écouverte/analyse au sein de la source de découverte.

    Par défaut : « INCONNU » est stocké dans la colonne source_feed lors de la création d’un enregistrement dans sys_rel_source table.
    relations.type Type de relation existant entre les éléments 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 la liste des en-têtes généraux utilisés dans l’API REST, consultez En-têtes d’API REST pris en charge.

    Tableau 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 la liste des codes d’état possibles utilisés dans l’API REST, consultez Codes de réponse HTTP de l’API REST.

    Tableau 18. Codes d'état
    Code d'état Description
    200 Réussi. La demande a été 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 du corps de réponse (JSON ou XML)

    Nom Description
    résultat Liste des résultats produits par la requête.

    Type de données : tableau

    "result": [
  "additionalCommittedItems": [Array],
  "additionalCommittedRelations": [Array],
  "items": [Array],
  "relations": [Array]
]
    résultat.additionalCommittedItems Liste des CI non inclus dans le tableau du corps items de la demande à insérer ou à mettre à jour.

    Type de données : tableau d’objets

    "additionalCommittedItems": [
  {
    "className": "String",
    "errorCount": Number,
    "identificationAttempts": [Array],
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloads": [Array],
    "operation": "String",
    "sysId": "String"
  }
]
    result.additionalCommittedItems.className sys_class_name de ce CI supplémentaire.

    Type de données : chaîne
    result.additionalCommittedItems.errorCount Nombre d’erreurs rencontrées lors du traitement de ce CI supplémentaire.

    Type de données : nombre
    résultat.additionalCommittedItems.errors Liste des erreurs rencontrées lors du traitement de ce CI supplémentaire.

    Type de données : tableau d’objets

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    résultat.additionalCommittedItems.errors.error Type d’erreur rencontrée lors du traitement de ce CI supplémentaire.

    Type de données : chaîne
    résultat.élémentscommittedssupplémentaires.erreurs.message Un message d’erreur s’est produit lors du traitement de ce CI supplémentaire.

    Type de données : chaîne
    result.additionalCommittedItems.identificationAttempts Liste des tentatives effectuées pour identifier ce CI supplémentaire.
    Type de données : tableau d’objets
    "identificationAttempts": [
  {
    "attemptResult": "String",
    "attributes": [Array],
    "hybridEntryCiAttributes": [Array],
    "identiferName": "String",
    "searchOnTable": [Array]
  }
]
    résultat.additionalCommittedItems.identificationAttempts.attemptResult Résultat de cette tentative d’identification de CI supplémentaire.
    Valeurs possibles :
    • CORRESPONDANT : 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’identificateurs 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’identificateurs.
    • 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
    résultat.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 Liste des attributs d’entrée d’identificateur de CI utilisés au cours de cette tentative d’identification de CI supplémentaire.

    Type de données : tableau

    Les noms et types d’attributs dépendent des données du corps de la demande et de l’identificateur utilisé, par exemple :

    "hybridEntryCiAttributes": [
  "name": "String",
  "serial_number": "String"
]
    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
    résultat.additionalCommittedItems.inputIndex Liste des valeurs d’index pour les CI du tableau du corps items de la demande qui correspondent à ce CI supplémentaire.

    Type de données : tableau d’objets

    "inputIndices": [
  {
    Number
  }
]
    résultat.additionalCommittedItems.markers Liste des valeurs de marqueur à usage interne.

    Type de données : tableau

    "markers": []
    résultat.additionalCommittedItems.mergedPayloads Liste des valeurs de sys_id pour les charges utiles partielles de la table Charges utiles partielles IRE [cmdb_ire_partial_payloads] 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 exécutée pour ce CI supplémentaire.
    Valeurs possibles :
    • DELETE : un CI existant est supprimé de la table cible.
    • INSERT : le CI supplémentaire est inséré dans la table cible en tant que nouvel enregistrement.
    • NO_CHANGE : Aucune opération n’est effectuée pour le CI supplémentaire.
    • 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 (ancienne classe).
    • 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 une classe 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 Sys_id trouvé pour ce CI supplémentaire via l’identification.

    Valeurs notables : Inconnu : échec de l’identification de ce CI supplémentaire. Consultez errors pour en savoir plus.

    Type de données : chaîne
    résultat.additionalCommittedItems.avertissements Liste des avertissements rencontrés lors du traitement de ce CI supplémentaire.

    Type de données : tableau d’objets

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    résultat.additionalCommittedItems.avertissements.erreur Type d’avertissement rencontré lors du traitement de ce CI supplémentaire.

    Type de données : chaîne
    résultat.additionalCommittedItems.warnings.message Un message d’avertissement s’est produit lors du traitement de ce CI supplémentaire.

    Type de données : chaîne
    résultat.additionalCommittedRelations Liste des CI de relation dépendante non inclus dans la liste du corps relations de la demande à insérer ou à mettre à jour.

    Type de données : tableau d’objets

    "additionalCommittedRelations": [
  {
    "className": "String",
    "operation": "String",
    "markers": [Array],
    "inputIndices": [Array],
    "mergedPayloadIds": [Array]
  }
]
    result.additionalCommittedRelations.className Le sys_class_name de ce CI de relation dépendante supplémentaire.
    Seule valeur prise en charge :
    • cmdb_rel_ci : table des relations CI.

    Type de données : chaîne
    result.additionalCommittedRelations.errorCount Nombre d’erreurs rencontrées lors du traitement de ce CI de relation dépendante supplémentaire.

    Type de données : nombre
    résultat.additionalCommittedRelations.errors Liste des erreurs rencontrées lors du traitement de ce CI de relation dépendante supplémentaire.

    Type de données : tableau d’objets

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    résultat.additionalCommittedRelations.errors.error Type d’erreur rencontrée lors du traitement de ce CI de relation dépendante supplémentaire.

    Type de données : chaîne
    résultat.additionalCommittedRelations.errors.message Un message d’erreur s’est produit pendant le traitement de ce CI de relation dépendante supplémentaire.

    Type de données : chaîne
    result.additionalCommittedRelations.inputIndices Liste des valeurs d’index pour les objets CI de relation dépendante dans le tableau du 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 Liste des valeurs de marqueur à usage interne.

    Type de données : tableau

    "markers": []
    result.additionalCommittedRelations.mergedPayloadIds Liste des valeurs de sys_id pour les charges utiles partielles de la table Charges utiles partielles IRE [cmdb_ire_partial_payloads] CMDB qui ont été fusionnées pendant le traitement de ce CI de relation dépendante supplémentaire.

    Type de données : tableau

    "mergedPayloadIds": [
  "String"
]
    résultat.additionalCommittedRelations.operation Opération effectuée pour ce CI de relation dépendante supplémentaire.
    Valeurs possibles :
    • INSÉRER : le CI de relation dépendant 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_ire_incomplete_payloads] CMDB.
    • 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_ire_partial_payloads] CMDB.
    • NO_CHANGE : Aucune opération n’est effectuée pour le CI de relation dépendant.
    • 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 Liste des CI inclus dans le tableau du corps items de la demande.

    Type de données : tableau d’objets

    "items": [
  {
    "additionalRelatedItems": [Array],
    "className": "String",
    "duplicateLookupIndices": {Object},
    "errorCount": Number,
    "errors": [Array],
    "identificationAttempts": [Array],
    "identifierEntrySysId": "String",
    "info": [Array],
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloadIds": [Array],
    "operation": "String",
    "relatedItems": [Array],
    "relatedSysIds": [Array],
    "sysId": "String",
    "warnings": [Array]
  }
]
    result.items.additionalRelatedItems Liste des CI associés (CI de recherche de table) de la table Charges utiles partielles IRE [cmdb_ire_partial_payloads] de la CMDB.

    Type de données : tableau d’objets

    "additionalRelatedItems": [
  {
    "className": "String",
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloadIds": [Array],
    "sysId": "String"
  }
]
    result.items.additionalRelatedItems.className sys_class_name de l’élément connexe.

    Type de données : chaîne
    result.items.additionalRelatedItems.inputIndex Liste des valeurs d’index pour les CI du tableau du corps items de la demande qui correspondent à cet élément connexe.

    Type de données : tableau

    "inputIndices": [
    Number
]
    result.items.additionalRelatedItems.markers Liste des valeurs de marqueur à usage interne.

    Type de données : tableau

    "markers": []
    result.items.additionalRelatedItems.mergedPayloadIds Liste des valeurs de sys_id pour les charges utiles partielles de la table Charges utiles partielles IRE [cmdb_ire_partial_payloads] de la CMDB qui ont été fusionnées pendant le traitement de cet élément connexe.

    Type de données : tableau

    "mergedPayloadIds": [
  "String"
]
    result.items.additionalRelatedItems.sysId Sys_id de ce CI connexe.

    Type de données : chaîne
    result.items.className Sys_class_name de ce CI.

    Type de données : chaîne
    résultat.éléments.duplicateLookupIndex Objet contenant des tableaux de valeurs d’index pour items.lookup les éléments du tableau qui font référence au même CI associé.

    Le nom du tableau indique le premier élément du tableau du corps items.lookup de la demande qui fait référence à un CI associé donné. Ses valeurs sont l’ensemble des éléments supplémentaires du même tableau qui font référence au même CI associé.

    Type de données : objet

    Cet exemple montre un cas où le deuxième élément du items.lookup tableau fait référence au même CI connexe qu’un élément ultérieur de ce tableau :

    "duplicateLookupIndices": [
  "2": [Array]
]
    result.items.errorCount Nombre d’erreurs rencontrées lors du traitement de ce CI.

    Type de données : nombre
    résultat.éléments.erreurs Liste des erreurs rencontrées lors du traitement de ce CI.

    Type de données : tableau d’objets

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    résultat.éléments.erreurs.erreur Type d’erreur rencontrée lors du traitement de ce CI.

    Type de données : chaîne
    résultat.éléments.erreurs.message Un message d’erreur s’est produit lors du traitement de ce CI.

    Type de données : chaîne
    result.items.identificationAttempts Liste des tentatives d’identification effectuées pour ce CI.
    Type de données : tableau d’objets
    "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 :
    • CORRESPONDANT : 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’identificateurs 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’identificateurs.
    • 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 Liste des attributs d’entrée d’identificateur CI utilisés au cours de 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 Liste des attributs d’entrée d’identificateur CI utilisés au cours de 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. Pour plus de détails, voir errors.

    Type de données : chaîne
    result.items.info Liste d’informations supplémentaires sur le traitement de l’élément.

    Type de données : tableau d’objets

    "info": [
  {
    "code": "String",
    "message": "String",
    "ruleSysId": "String"
  }
]
    resultats.éléments.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 IRE ignore la reclassification en raison de la règle de restriction de reclassification. Cette valeur est vide si la reclassification est ignorée en raison d’une charge utile ou d’un marqueur global.

    Type de données : chaîne
    result.items.inputIndex Liste des valeurs d’index pour les CI du tableau du corps items de la demande qui correspondent à ce CI.

    Type de données : tableau d’objets

    "inputIndices": [
  {
    Number
  }
]
    résultat.éléments.marqueurs Liste des valeurs de marqueur à usage interne.

    Type de données : tableau

    "markers": []
    result.items.mergedPayloadIds Liste des valeurs sys_id des charges utiles partielles de la table Charges utiles partielles IRE [cmdb_ire_partial_payloads] de la CMDB qui ont été fusionnées pendant le traitement de ce CI.

    Type de données : tableau

    "mergedPayloadIds": [
  "String"
]
    résultat.éléments.opération Opération exécutée pour ce CI.
    Valeurs possibles :
    • DELETE : un CI existant est supprimé de la table cible.
    • INSERT : le CI est inséré dans la table cible en tant que nouvel enregistrement.
    • NO_CHANGE : Aucune opération n’est effectuée sur 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 (ancienne classe).
    • 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 une classe 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 Liste des CI associés (CI de recherche de table) à partir du tableau du corps items.lookup de la demande.

    Type de données : tableau d’objets

    "relatedItems": [
  {
    "className": "String",
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloadIds": [Array],
    "sysId": "String"
  }
]
    result.items.relatedItems.className sys_class_name de l’élément connexe.

    Type de données : chaîne
    result.items.relatedItems.inputIndex Liste des valeurs d’index pour les CI et des é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 d’objets

    "inputIndices": [
  {
    "mainIndex": Number,
    "subIndex": Number
  }
]
    result.items.relatedItems.inputIndices.mainIndex Valeur d’index du tableau du corps items de la demande qui correspond au parent CI de l’élément connexe.

    Type de données : nombre
    result.items.relatedItems.inputIndices.subIndex Valeur d’index du tableau du corps items.lookup de la demande qui correspond à l’élément connexe.

    Type de données : nombre
    result.items.relatedItems.markers Liste des valeurs de marqueur à usage interne.

    Type de données : tableau

    "markers": []
    result.items.relatedItems.mergedPayloadIds Liste des valeurs de sys_id des entrées de la table Charges utiles partielles IRE [cmdb_ire_partial_payloads] CMDB qui ont été fusionnées dans ce CI pendant le traitement.

    Type de données : tableau

    "mergedPayloadIds": [
  "String"
]
    result.items.relatedSysIds Liste des valeurs sys_id pour les éléments connexes (éléments de recherche de table) à partir du tableau du corps items.lookup de la demande.

    Type de données : tableau

    Valeurs notables :
    • nul : aucune sys_id n’a été identifiée pour cet élément connexe.
    "relatedSysIds": [
    Number,
    Number
]
    result.items.sysId Sys_id trouvé pour ce CI par identification.
    Valeurs notables :
    • Inconnu : échec de l’identification de ce CI. Consultez errors pour en savoir plus.

    Type de données : chaîne
    résultat.éléments.avertissements Liste des avertissements rencontrés lors du traitement de ce CI.

    Type de données : tableau d’objets

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    résultat.éléments.avertissements.erreur Type d’avertissement rencontré pendant le traitement de ce CI.

    Type de données : chaîne
    résultat.éléments.avertissements.message Message d’avertissement rencontré pendant le 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 Liste des CI de relation dépendante du tableau du corps relations de la demande.

    Type de données : tableau d’objets

    "relations": [
  {
    "className": "String",
    "errorCount": Number,
    "errors": [Array],
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloadIds": [Array],
    "operation": "String",
    "warnings": [Array]
  }
]
    result.relations.className Le sys_class_name de ce CI de relation dépendante.
    Seule valeur prise en charge :
    • cmdb_rel_ci : table des relations CI.

    Type de données : chaîne
    result.relations.errorCount Nombre d’erreurs rencontrées lors du traitement de ce CI de relation dépendante.

    Type de données : nombre
    résultat.relations.erreurs Liste des erreurs rencontrées lors du traitement de ce CI de relation dépendante.

    Type de données : tableau d’objets

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    résultat.relations.erreurs.erreur Type d’erreur rencontrée lors du traitement de ce CI de relation dépendante.

    Type de données : chaîne
    résultat.relations.erreurs.message Message d’erreur rencontré pendant le traitement de ce CI de relation dépendante.

    Type de données : chaîne
    résultat.relations.inputIndex Liste des valeurs d’index pour les objets CI de relation dépendante dans le tableau du corps relations de la demande qui correspondent à ce CI de relation dépendante.

    Type de données : tableau

    "inputIndices": [
  Number
]
    result.relations.marqueurs Liste des valeurs de marqueur à usage interne.

    Type de données : tableau

    "markers": []
    result.relations.mergedPayloadIds Liste des valeurs de sys_id pour les charges utiles partielles de la table Charges utiles partielles IRE [cmdb_ire_partial_payloads] CMDB qui ont été fusionnées pendant le traitement de ce CI de relation dépendante.

    Type de données : tableau

    "mergedPayloadIds": [
  "String"
]
    Résultat.Relations.Opération Opération effectuée pour ce CI de relation dépendante.
    Valeurs possibles :
    • INSÉRER : le CI de relation dépendante a été inséré dans la table cible en tant que nouvel enregistrement.
    • INSERT_AS_INCOMPLETE : Le CI de relation dépendante comportait des erreurs et a été inséré dans la table Charges utiles incomplètes IRE [cmdb_ire_incomplete_payloads] CMDB.
    • INSERT_AS_PARTIAL : Le CI de relation dépendante comportait des erreurs et a été inséré dans la table Charges utiles partielles IRE [cmdb_ire_partial_payloads] CMDB.
    • NO_CHANGE : Aucune opération n’a été effectuée pour le CI de relation dépendant.
    • 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 Liste des avertissements rencontrés lors du traitement de ce CI de relation dépendante.

    Type de données : tableau d’objets

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    résultat.relations.avertissements.erreur Type d’avertissement rencontré pendant le traitement de ce CI de relation dépendante.

    Type de données : chaîne
    résultat.relations.avertissements.message Message d’avertissement rencontré pendant le traitement de ce CI de relation dépendante.

    Type de données : chaîne

    Demande cURL

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

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

    Le CI de serveur Linux est identifié via une recherche de règle matérielle 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 Serveur Linux [cmdb_ci_linux_server]. Le commutateur IP est identifié de la même manière via une règle matérielle, recherchez son nom dans la table Matériel et met à jour un CI existant dans la table Commutateur IP [cmdb_ci_ip_switch]. Enfin, la relation de connexion IP entre le serveur et le commutateur est insérée en tant que nouvel enregistrement dans la table Relation 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 demande) au Identification et réconciliation : POST /now/identifyreconcile/enhanced 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 élément présentant un avertissement ou une erreur, indique si une opération d’élément est INSERT_AS_PARTIAL ou INSERT_INCOMPLETE.
      • Renvoie la sys_ids de charges utiles partielles qui ont été fusionnées avec des 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 séparée par des virgules de paires nom-valeur 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 de déduplication et générer des options IRE améliorées de résumé :

    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é de charges utiles partielles.

    Pour plus d’informations sur les options IRE améliorées, consultez Moteur Identification et réconciliation (IRE).

    Valeurs valides pour chaque paire nom-valeur :
    • vrai : activez cette option IRE améliorée.
    • false : désactivez cette option IRE améliorée.

    Type de données : chaîne
    sysparm_data_source Source des informations du CI. Elle doit être l’une des valeurs de choix définies pour le champ discovery_source de la table d’éléments de configuration [cmdb_ci].

    Type de données : chaîne

    Par défaut : insérez la charge utile de l’API dans la table des charges utiles incomplètes.
    Tableau 21. Paramètres de corps de demande (XML ou JSON)
    Nom Description
    Éléments Liste des CI à créer ou mettre à jour.

    Type de données : tableau d’objets

    "items": [
  {
    "className": "String",
    "internal_id": "String",
    "lookup": [Array],
    "related": [Array],
    "settings": {Object},
    "sys_object_source_info": {Object},
    "values": {Object}
  }
]
    items.className Requis. Le sys_class_name (nom de classe/table) du CI à créer ou à mettre à jour. Cette valeur peut être n’importe quelle CMDB table, telle que cmdb_ci_linux_server ou cmdb_ci_win_server.

    Type de données : chaîne
    items.internal_id Identificateur unique de cet élément dans cette charge utile. Peut avoir n’importe quelle valeur, mais doit être unique dans la charge utile.

    Type de données : chaîne
    items.lookup 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 d’éléments de configuration [cmdb_ci].

    Type de données : Tableau désactivé Objets

    "lookup": [
  {
    "className": "String",
    "internal_id": "String",
    "sys_object_source_info": {Object},
    "values": {Object}
  }
]
    items.lookup.className Requis. Le nom de la sys_class_name ou de la 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 avoir 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 envoyant 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 de 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 du 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 UTC Date et heure auxquelles le CI a été analysé.

    Type de données : chaîne

    Format : JJ-MM-AAAA hh :mm :ss
    éléments.recherche.valeurs Objet décrivant les champs de cet élément de recherche sous forme de paires nom/valeur, où le nom est le nom de 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, en fonction d’une table connexe qui fait référence au CI de niveau supérieur en cours d’identification. Les règles de la table Entrée connexe [cmdb_related_entry] définissent quel type d’enregistrements peut figurer dans ce tableau.

    La table connexe peut étendre ou non la table d’éléments de configuration [cmdb_ci]. Ces enregistrements ne sont pas utilisés pour identifier l’élément de configuration.

    Type de données : tableau d’objets

    "related": [
  {
    "className": "String",
    "internal_id": "String",
    "sys_object_source_info": {Object},
    "values": {Object}
  }
]
    items.related.className Requis. 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 de cet élément connexe dans cette charge utile. Peut avoir 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 envoyant cet élément associé. À 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 : JJ-MM-AAAA hh :mm :ss
    éléments.valeurs.connexes Objet décrivant les champs à créer ou mettre à jour pour cet élément connexe sous forme de paires nom/valeur, où le nom est le nom du champ. Pour un champ de référence, la valeur doit être le sys_id référencé.

    Type de données : objet

    Les noms et 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 reclassification qui correspond à la classe de l’élément de charge utile.
    Valeurs valides :
    • true : ignorer l’exécution de la règle.
    • false : exécuter la règle.

    Valeur par défaut : false
    items.settings.updateWithoutDowngrade Marqueur indiquant si la mise à jour et le passage à une version antérieure sont autorisés pour ce CI.
    Valeurs valides :
    • vrai : Mettez à jour l’élément, mais le passage à une version antérieure n’est pas autorisé.
    • faux : la mise à jour et le passage à une version antérieure de l’élément sont autorisés.

    Type de données : booléennes

    Valeur par défaut : false
    items.settings.updateWithoutSwitch Marqueur indiquant si ce CI peut être mis à jour et sa classe commutée.
    Valeurs valides :
    • vrai : Mettez à 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 Marqueur indiquant si la mise à jour et la mise à niveau sont autorisées pour ce CI.
    Valeurs valides :
    • vrai : Mettez à jour l’élément, mais la mise à niveau n’est pas autorisée.
    • faux : 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_object_source_info Objet décrivant un identificateur 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 envoyant 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 de 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 du 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 UTC Date et heure auxquelles le CI a été analysé.

    Type de données : chaîne

    Format : JJ-MM-AAAA hh :mm :ss
    éléments.valeurs Objet décrivant les champs à créer ou mettre à jour pour ce CI sous forme de paires nom/valeur, où le nom est le nom de 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 Liste de référence entre deux éléments de la charge utile.

    Type de données : tableau d’objets

    "referenceItems": [
  {
    "referenced": "String",
    "referencedBy": "String",
    "referenceField": "String"
  }
]
    referenceItems.referenced Défini internal_id pour l’élément référencé par un autre élément.

    Type de données : chaîne
    referenceItems.referencedBy Défini internal_id pour l’élément qui fait référence à un autre élément.

    Type de données : chaîne
    referenceItems.referenceField Nom du champ de référence dans la classe/la table de l’élément referencedBy .

    Type de données : chaîne
    Relations Liste des relations entre deux éléments définis dans la charge utile.
    Un objet de ce tableau peut utiliser l’un des deux formats suivants :
    • L’objet peut définir une relation entre deux éléments de niveau supérieur (uniquement) à l’aide parentchild de paires nom-valeur, les valeurs représentant les index d’élément du tableau de charge items utile.
    • 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, les valeurs représentant internal_id les valeurs définies pour ces éléments.

    Type de données : tableau d’objets

    "relations": [
  {
    "child": Number,
    "parent": Number,
    "sys_rel_source_info": {Object},
    "type": "String"
  }
]
    "relations": [
  {
    "child_id": "String",
    "parent_id": "String",
    "sys_rel_source_info": {Object},
    "type": "String"
  }
]
    relations.enfant Index 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 De internal_id l’élément 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 De internal_id l’élément parent dans la relation.

    Type de données : chaîne
    relations.sys_rel_source_info Informations sur la source de découverte pour la relation. Pour les relations de non-dépendance, ces informations figurent dans la table Sources de relations [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écouverte.

    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écouverte/analyse au sein de la source de découverte.

    Par défaut : « INCONNU » est stocké dans la colonne source_feed lors de la création d’un enregistrement dans sys_rel_source table.
    relations.type Type de relation existant entre les éléments 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 la liste des en-têtes généraux utilisés dans l’API REST, consultez En-têtes d’API REST pris en charge.

    Tableau 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 la liste des codes d’état possibles utilisés dans l’API REST, consultez Codes de réponse HTTP de l’API REST.

    Tableau 24. Codes d'état
    Code d'état Description
    200 Réussi. La demande a été 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.

    Le détail du message d’erreur « Chunk [...] is not a valid entry » indique que le paramètre de requête n’est options pas au 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] n’est pas une entrée valide » dans le détail du message.

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

    Nom Description
    résultat Liste des résultats produits par la requête.

    Type de données : tableau

    "result": [
  "additionalCommittedItems": [Array],
  "additionalCommittedRelations": [Array],
  "items": [Array],
  "relations": [Array]
]
    résultat.additionalCommittedItems Liste des CI non inclus dans le tableau du corps items de la demande à insérer ou à mettre à jour.

    Type de données : tableau d’objets

    "additionalCommittedItems": [
  {
    "className": "String",
    "errorCount": Number,
    "identificationAttempts": [Array],
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloads": [Array],
    "operation": "String",
    "sysId": "String"
  }
]
    result.additionalCommittedItems.className sys_class_name de ce CI supplémentaire.

    Type de données : chaîne
    result.additionalCommittedItems.errorCount Nombre d’erreurs rencontrées lors du traitement de ce CI supplémentaire.

    Type de données : nombre
    résultat.additionalCommittedItems.errors Liste des erreurs rencontrées lors du traitement de ce CI supplémentaire.

    Type de données : tableau d’objets

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    résultat.additionalCommittedItems.errors.error Type d’erreur rencontrée lors du traitement de ce CI supplémentaire.

    Type de données : chaîne
    résultat.élémentscommittedssupplémentaires.erreurs.message Un message d’erreur s’est produit lors du traitement de ce CI supplémentaire.

    Type de données : chaîne
    result.additionalCommittedItems.identificationAttempts Liste des tentatives effectuées pour identifier ce CI supplémentaire.
    Type de données : tableau d’objets
    "identificationAttempts": [
  {
    "attemptResult": "String",
    "attributes": [Array],
    "hybridEntryCiAttributes": [Array],
    "identiferName": "String",
    "searchOnTable": [Array]
  }
]
    résultat.additionalCommittedItems.identificationAttempts.attemptResult Résultat de cette tentative d’identification de CI supplémentaire.
    Valeurs possibles :
    • CORRESPONDANT : 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’identificateurs 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’identificateurs.
    • 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
    résultat.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 Liste des attributs d’entrée d’identificateur de CI utilisés au cours de cette tentative d’identification de CI supplémentaire.

    Type de données : tableau

    Les noms et types d’attributs dépendent des données du corps de la demande et de l’identificateur utilisé, par exemple :

    "hybridEntryCiAttributes": [
  "name": "String",
  "serial_number": "String"
]
    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
    résultat.additionalCommittedItems.inputIndex Liste des valeurs d’index pour les CI du tableau du corps items de la demande qui correspondent à ce CI supplémentaire.

    Type de données : tableau d’objets

    "inputIndices": [
  {
    Number
  }
]
    résultat.additionalCommittedItems.markers Liste des valeurs de marqueur à usage interne.

    Type de données : tableau

    "markers": []
    résultat.additionalCommittedItems.mergedPayloads Liste des valeurs de sys_id pour les charges utiles partielles de la table Charges utiles partielles IRE [cmdb_ire_partial_payloads] 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 exécutée pour ce CI supplémentaire.
    Valeurs possibles :
    • DELETE : un CI existant est supprimé de la table cible.
    • INSERT : le CI supplémentaire est inséré dans la table cible en tant que nouvel enregistrement.
    • NO_CHANGE : Aucune opération n’est effectuée pour le CI supplémentaire.
    • 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 (ancienne classe).
    • 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 une classe 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 Sys_id trouvé pour ce CI supplémentaire via l’identification.

    Valeurs notables : Inconnu : échec de l’identification de ce CI supplémentaire. Consultez errors pour en savoir plus.

    Type de données : chaîne
    résultat.additionalCommittedItems.avertissements Liste des avertissements rencontrés lors du traitement de ce CI supplémentaire.

    Type de données : tableau d’objets

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    résultat.additionalCommittedItems.avertissements.erreur Type d’avertissement rencontré lors du traitement de ce CI supplémentaire.

    Type de données : chaîne
    résultat.additionalCommittedItems.warnings.message Un message d’avertissement s’est produit lors du traitement de ce CI supplémentaire.

    Type de données : chaîne
    résultat.additionalCommittedRelations Liste des CI de relation dépendante non inclus dans la liste du corps relations de la demande à insérer ou à mettre à jour.

    Type de données : tableau d’objets

    "additionalCommittedRelations": [
  {
    "className": "String",
    "operation": "String",
    "markers": [Array],
    "inputIndices": [Array],
    "mergedPayloadIds": [Array]
  }
]
    result.additionalCommittedRelations.className Le sys_class_name de ce CI de relation dépendante supplémentaire.
    Seule valeur prise en charge :
    • cmdb_rel_ci : table des relations CI.

    Type de données : chaîne
    result.additionalCommittedRelations.errorCount Nombre d’erreurs rencontrées lors du traitement de ce CI de relation dépendante supplémentaire.

    Type de données : nombre
    résultat.additionalCommittedRelations.errors Liste des erreurs rencontrées lors du traitement de ce CI de relation dépendante supplémentaire.

    Type de données : tableau d’objets

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    résultat.additionalCommittedRelations.errors.error Type d’erreur rencontrée lors du traitement de ce CI de relation dépendante supplémentaire.

    Type de données : chaîne
    résultat.additionalCommittedRelations.errors.message Un message d’erreur s’est produit pendant le traitement de ce CI de relation dépendante supplémentaire.

    Type de données : chaîne
    result.additionalCommittedRelations.inputIndices Liste des valeurs d’index pour les objets CI de relation dépendante dans le tableau du 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 Liste des valeurs de marqueur à usage interne.

    Type de données : tableau

    "markers": []
    result.additionalCommittedRelations.mergedPayloadIds Liste des valeurs de sys_id pour les charges utiles partielles de la table Charges utiles partielles IRE [cmdb_ire_partial_payloads] CMDB qui ont été fusionnées pendant le traitement de ce CI de relation dépendante supplémentaire.

    Type de données : tableau

    "mergedPayloadIds": [
  "String"
]
    résultat.additionalCommittedRelations.operation Opération effectuée pour ce CI de relation dépendante supplémentaire.
    Valeurs possibles :
    • INSÉRER : le CI de relation dépendant 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_ire_incomplete_payloads] CMDB.
    • 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_ire_partial_payloads] CMDB.
    • NO_CHANGE : Aucune opération n’est effectuée pour le CI de relation dépendant.
    • 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 Liste des CI inclus dans le tableau du corps items de la demande.

    Type de données : tableau d’objets

    "items": [
  {
    "additionalRelatedItems": [Array],
    "className": "String",
    "duplicateLookupIndices": {Object},
    "errorCount": Number,
    "errors": [Array],
    "identificationAttempts": [Array],
    "identifierEntrySysId": "String",
    "info": [Array],
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloadIds": [Array],
    "operation": "String",
    "relatedItems": [Array],
    "relatedSysIds": [Array],
    "sysId": "String",
    "warnings": [Array]
  }
]
    result.items.additionalRelatedItems Liste des CI associés (CI de recherche de table) de la table Charges utiles partielles IRE [cmdb_ire_partial_payloads] de la CMDB.

    Type de données : tableau d’objets

    "additionalRelatedItems": [
  {
    "className": "String",
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloadIds": [Array],
    "sysId": "String"
  }
]
    result.items.additionalRelatedItems.className sys_class_name de l’élément connexe.

    Type de données : chaîne
    result.items.additionalRelatedItems.inputIndex Liste des valeurs d’index pour les CI du tableau du corps items de la demande qui correspondent à cet élément connexe.

    Type de données : tableau

    "inputIndices": [
    Number
]
    result.items.additionalRelatedItems.markers Liste des valeurs de marqueur à usage interne.

    Type de données : tableau

    "markers": []
    result.items.additionalRelatedItems.mergedPayloadIds Liste des valeurs de sys_id pour les charges utiles partielles de la table Charges utiles partielles IRE [cmdb_ire_partial_payloads] de la CMDB qui ont été fusionnées pendant le traitement de cet élément connexe.

    Type de données : tableau

    "mergedPayloadIds": [
  "String"
]
    result.items.additionalRelatedItems.sysId Sys_id de ce CI connexe.

    Type de données : chaîne
    result.items.className Sys_class_name de ce CI.

    Type de données : chaîne
    résultat.éléments.duplicateLookupIndex Objet contenant des tableaux de valeurs d’index pour items.lookup les éléments du tableau qui font référence au même CI associé.

    Le nom du tableau indique le premier élément du tableau du corps items.lookup de la demande qui fait référence à un CI associé donné. Ses valeurs sont l’ensemble des éléments supplémentaires du même tableau qui font référence au même CI associé.

    Type de données : objet

    Cet exemple montre un cas où le deuxième élément du items.lookup tableau fait référence au même CI connexe qu’un élément ultérieur de ce tableau :

    "duplicateLookupIndices": [
  "2": [Array]
]
    result.items.errorCount Nombre d’erreurs rencontrées lors du traitement de ce CI.

    Type de données : nombre
    résultat.éléments.erreurs Liste des erreurs rencontrées lors du traitement de ce CI.

    Type de données : tableau d’objets

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    résultat.éléments.erreurs.erreur Type d’erreur rencontrée lors du traitement de ce CI.

    Type de données : chaîne
    résultat.éléments.erreurs.message Un message d’erreur s’est produit lors du traitement de ce CI.

    Type de données : chaîne
    result.items.identificationAttempts Liste des tentatives d’identification effectuées pour ce CI.
    Type de données : tableau d’objets
    "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 :
    • CORRESPONDANT : 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’identificateurs 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’identificateurs.
    • 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 Liste des attributs d’entrée d’identificateur CI utilisés au cours de 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 Liste des attributs d’entrée d’identificateur CI utilisés au cours de 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. Pour plus de détails, voir errors.

    Type de données : chaîne
    result.items.info Liste d’informations supplémentaires sur le traitement de l’élément.

    Type de données : tableau d’objets

    "info": [
  {
    "code": "String",
    "message": "String",
    "ruleSysId": "String"
  }
]
    resultats.éléments.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 IRE ignore la reclassification en raison de la règle de restriction de reclassification. Cette valeur est vide si la reclassification est ignorée en raison d’une charge utile ou d’un marqueur global.

    Type de données : chaîne
    result.items.inputIndex Liste des valeurs d’index pour les CI du tableau du corps items de la demande qui correspondent à ce CI.

    Type de données : tableau d’objets

    "inputIndices": [
  {
    Number
  }
]
    résultat.éléments.marqueurs Liste des valeurs de marqueur à usage interne.

    Type de données : tableau

    "markers": []
    result.items.mergedPayloadIds Liste des valeurs sys_id des charges utiles partielles de la table Charges utiles partielles IRE [cmdb_ire_partial_payloads] de la CMDB qui ont été fusionnées pendant le traitement de ce CI.

    Type de données : tableau

    "mergedPayloadIds": [
  "String"
]
    résultat.éléments.opération Opération exécutée pour ce CI.
    Valeurs possibles :
    • DELETE : un CI existant est supprimé de la table cible.
    • INSERT : le CI est inséré dans la table cible en tant que nouvel enregistrement.
    • NO_CHANGE : Aucune opération n’est effectuée sur 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 (ancienne classe).
    • 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 une classe 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 Liste des CI associés (CI de recherche de table) à partir du tableau du corps items.lookup de la demande.

    Type de données : tableau d’objets

    "relatedItems": [
  {
    "className": "String",
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloadIds": [Array],
    "sysId": "String"
  }
]
    result.items.relatedItems.className sys_class_name de l’élément connexe.

    Type de données : chaîne
    result.items.relatedItems.inputIndex Liste des valeurs d’index pour les CI et des é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 d’objets

    "inputIndices": [
  {
    "mainIndex": Number,
    "subIndex": Number
  }
]
    result.items.relatedItems.inputIndices.mainIndex Valeur d’index du tableau du corps items de la demande qui correspond au parent CI de l’élément connexe.

    Type de données : nombre
    result.items.relatedItems.inputIndices.subIndex Valeur d’index du tableau du corps items.lookup de la demande qui correspond à l’élément connexe.

    Type de données : nombre
    result.items.relatedItems.markers Liste des valeurs de marqueur à usage interne.

    Type de données : tableau

    "markers": []
    result.items.relatedItems.mergedPayloadIds Liste des valeurs de sys_id des entrées de la table Charges utiles partielles IRE [cmdb_ire_partial_payloads] CMDB qui ont été fusionnées dans ce CI pendant le traitement.

    Type de données : tableau

    "mergedPayloadIds": [
  "String"
]
    result.items.relatedSysIds Liste des valeurs sys_id pour les éléments connexes (éléments de recherche de table) à partir du tableau du corps items.lookup de la demande.

    Type de données : tableau

    Valeurs notables :
    • nul : aucune sys_id n’a été identifiée pour cet élément connexe.
    "relatedSysIds": [
    Number,
    Number
]
    result.items.sysId Sys_id trouvé pour ce CI par identification.
    Valeurs notables :
    • Inconnu : échec de l’identification de ce CI. Consultez errors pour en savoir plus.

    Type de données : chaîne
    résultat.éléments.avertissements Liste des avertissements rencontrés lors du traitement de ce CI.

    Type de données : tableau d’objets

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    résultat.éléments.avertissements.erreur Type d’avertissement rencontré pendant le traitement de ce CI.

    Type de données : chaîne
    résultat.éléments.avertissements.message Message d’avertissement rencontré pendant le 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 Liste des CI de relation dépendante du tableau du corps relations de la demande.

    Type de données : tableau d’objets

    "relations": [
  {
    "className": "String",
    "errorCount": Number,
    "errors": [Array],
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloadIds": [Array],
    "operation": "String",
    "warnings": [Array]
  }
]
    result.relations.className Le sys_class_name de ce CI de relation dépendante.
    Seule valeur prise en charge :
    • cmdb_rel_ci : table des relations CI.

    Type de données : chaîne
    result.relations.errorCount Nombre d’erreurs rencontrées lors du traitement de ce CI de relation dépendante.

    Type de données : nombre
    résultat.relations.erreurs Liste des erreurs rencontrées lors du traitement de ce CI de relation dépendante.

    Type de données : tableau d’objets

    "errors": [
  {
    "error": "String",
    "message": "String"
  }
]
    résultat.relations.erreurs.erreur Type d’erreur rencontrée lors du traitement de ce CI de relation dépendante.

    Type de données : chaîne
    résultat.relations.erreurs.message Message d’erreur rencontré pendant le traitement de ce CI de relation dépendante.

    Type de données : chaîne
    résultat.relations.inputIndex Liste des valeurs d’index pour les objets CI de relation dépendante dans le tableau du corps relations de la demande qui correspondent à ce CI de relation dépendante.

    Type de données : tableau

    "inputIndices": [
  Number
]
    result.relations.marqueurs Liste des valeurs de marqueur à usage interne.

    Type de données : tableau

    "markers": []
    result.relations.mergedPayloadIds Liste des valeurs de sys_id pour les charges utiles partielles de la table Charges utiles partielles IRE [cmdb_ire_partial_payloads] CMDB qui ont été fusionnées pendant le traitement de ce CI de relation dépendante.

    Type de données : tableau

    "mergedPayloadIds": [
  "String"
]
    Résultat.Relations.Opération Opération effectuée pour ce CI de relation dépendante.
    Valeurs possibles :
    • INSÉRER : le CI de relation dépendante a été inséré dans la table cible en tant que nouvel enregistrement.
    • INSERT_AS_INCOMPLETE : Le CI de relation dépendante comportait des erreurs et a été inséré dans la table Charges utiles incomplètes IRE [cmdb_ire_incomplete_payloads] CMDB.
    • INSERT_AS_PARTIAL : Le CI de relation dépendante comportait des erreurs et a été inséré dans la table Charges utiles partielles IRE [cmdb_ire_partial_payloads] CMDB.
    • NO_CHANGE : Aucune opération n’a été effectuée pour le CI de relation dépendant.
    • 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 Liste des avertissements rencontrés lors du traitement de ce CI de relation dépendante.

    Type de données : tableau d’objets

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    résultat.relations.avertissements.erreur Type d’avertissement rencontré pendant le traitement de ce CI de relation dépendante.

    Type de données : chaîne
    résultat.relations.avertissements.message Message d’avertissement rencontré pendant le 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_ire_partial_payloads] CMDB.

    {
  "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ète la description du CI de l’ordinateur, avec l’option IRE amélioré de génération de résumé activée.

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

    La réponse indique que le CI d’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
      }
    }
  }
}