API Identification et rapprochement

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 108 minutes de lecture

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

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

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

    Identification et réconciliation - POST /now/identifyreconcile

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

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

    Format d'URL

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

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

    Remarque :
    Les versions disponibles sont spécifiées dans l’explorateur d’API REST. Pour les API REST basées sur un script, des informations de version supplémentaires sont disponibles sur le formulaire Service REST scripté.

    Paramètres de demande pris en charge

    Tableau 1. Paramètres de chemin d'accès
    Nom Description
    api_version Facultatif. Version du point de terminaison auquel accéder. Par exemple, v1 ou v2. Spécifiez uniquement cette valeur pour utiliser une version de point de terminaison 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 sur le CI. Il doit s’agir de l’une des valeurs de choix définies pour le champ discovery_source de la table Élément de configuration [cmdb_ci].

    Type de données : chaîne

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

    Type de données : tableau d’objets

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

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

    Type de données : chaîne
    Recherche.Éléments Tableau d’objets dans lequel chaque objet décrit un enregistrement d’identification basé sur la recherche. Ces enregistrements sont utilisés pour identifier l’élément de configuration de niveau supérieur en fonction d’une table de recherche qui fait référence à la table Élément de configuration [cmdb_ci].

    Type de données : Tableau hors objets

    "lookup": [
  {
    "className": "String",
    "internal_id": "String",
    "sys_object_source_info": {Object},
    "values": {Object}
  }
]
    items.lookup.className Requis. Le nom de sys_class_name ou de classe/table du CI à créer ou à mettre à jour. Cette valeur peut être n’importe quelle CMDB classe/table, telle que cmdb_serial_number ou cmdb_ci_network_adapter, ou une classe nonCMDB hiérarchique.

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

    Type de données : chaîne
    items.lookup.sys_object_source_info Objet décrivant un identificateur de CI unique pour une source de données spécifiée. Différentes sources peuvent avoir des paires nom-valeur différentes pour le même CI.

    Type de données : objet

    "sys_object_source_info": {
  "source_feed": "String",
  "source_name": "String",  
  "source_native_key": "String",
  "source_recency_timestamp": "String"
}
    items.lookup.sys_object_source_info.source_feed Nom qui identifie de manière unique le flux qui envoie ce CI. À utiliser si la source peut avoir plusieurs flux.

    Type de données : chaîne
    items.lookup.sys_info_source_objet.nom_source Source de données des informations sur le CI. Cette valeur doit être l’une des valeurs de choix définies pour le champ discovery_source de la table Élément de configuration [cmdb_ci].

    Type de données : chaîne
    items.lookup.sys_object_source_info.source_native_key Clé/ID unique de la source pour le CI. Peut être n’importe quelle chaîne unique à l’élément.

    Type de données : chaîne
    items.lookup.sys_object_source_info.source_recency_timestamp Date et heure UTC auxquelles le CI a été analysé.

    Type de données : chaîne

    Format : JJ-MM-AAAA hh :mm :ss
    éléments.recherche.valeurs Objet décrivant les champs de cet élément de recherche sous forme de paires nom/valeur, où le nom est le nom du champ.

    Type de données : objet

    Les noms et 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 le type d’enregistrements qui peuvent se trouver 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 être 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 de CI unique pour une source de données spécifiée. Différentes sources peuvent avoir des paires nom-valeur différentes pour le même CI.

    Type de données : objet

    "sys_object_source_info": {
  "source_feed": "String",
  "source_name": "String",  
  "source_native_key": "String",
  "source_recency_timestamp": "String"
}
    items.related.sys_object_source_info.source_feed Nom qui identifie de manière unique le flux à l’origine de cet élément associé. À utiliser si la source peut avoir plusieurs flux.

    Type de données : chaîne
    items.related.sys_info_source_objet.nom_source Source de données pour les informations sur l’élément connexe. Cette valeur doit être l’une des valeurs de choix définies pour le champ discovery_source de la table Élément de configuration [cmdb_ci].

    Type de données : chaîne
    items.related.sys_object_source_info.source_native_key Clé/ID unique de la source pour l’élément connexe. Peut être n’importe quelle chaîne unique à l’élément.

    Type de données : chaîne
    items.related.sys_object_source_info.source_recency_timestamp Date et heure UTC auxquelles l’élément connexe a été analysé.

    Type de données : chaîne

    Format : JJ-MM-AAAA hh :mm :ss
    éléments.valeurs.connexes Objet décrivant les champs à créer ou mettre à jour pour cet élément associé 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.paramètres Objet contenant les paramètres définissant les types de mises à jour autorisés.

    Type de données : objet

    "settings": {
  "skipReclassificationRestrictionRules": Boolean,
  "updateWithoutDowngrade": Boolean,
  "updateWithoutSwitch": Boolean,
  "updateWithoutUpgrade": Boolean
}
    items.settings.skipReclassificationRestrictionRules Marqueur indiquant si IRE doit ignorer l’exécution de la règle de restriction de reclassification qui correspond à la classe de l’élément de charge utile.
    Valeurs valides :
    • vrai : ignorer l’exécution de la règle.
    • faux : exécutez la règle.

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

    Type de données : booléennes

    Valeur par défaut : false
    items.settings.updateWithoutSwitch Marqueur indiquant si ce CI peut être mis à jour et si sa classe peut être changée.
    Valeurs valides :
    • vrai : mettre à jour l’élément, mais le changement de classe n’est pas autorisé.
    • false : la mise à jour d’un objet 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 toutes deux autorisées pour ce CI.
    Valeurs valides :
    • vrai : mettre à jour l’élément, mais la mise à niveau n’est pas autorisée.
    • false : la mise à jour et la mise à niveau de l’élément sont autorisées.

    Type de données : booléennes

    Valeur par défaut : false
    items.sys_objet_source_info Objet décrivant un identificateur de CI unique.

    Type de données : objet

    "sys_object_source_info": {
  "source_feed": "String",
  "source_name": "String",  
  "source_native_key": "String",
  "source_recency_timestamp": "String"
}
    items.sys_object_source_info.source_feed Nom qui identifie de manière unique le flux qui envoie ce CI. À utiliser si la source peut avoir plusieurs flux.

    Type de données : chaîne
    nom_source items.sys_objet_source_nom_source Source de données des informations sur le CI. Cette valeur doit être l’une des valeurs de choix définies pour le champ discovery_source de la table Élément de configuration [cmdb_ci].

    Type de données : chaîne
    items.sys_object_source_info.source_native_key Clé/ID unique de la source pour le CI. Peut être n’importe quelle chaîne unique à l’élément.

    Type de données : chaîne
    items.sys_object_source_info.source_recency_timestamp Date et heure UTC auxquelles le CI a été analysé.

    Type de données : chaîne

    Format : 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. Les valeurs de chaque élément de référence sont renseignées avant d’identifier un CI à l’aide des règles IRE définies sur une classe.

    Type de données : tableau d’objets

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

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

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

    Type de données : chaîne
    Relations Liste des relations entre deux éléments définis dans la charge utile.
    Un objet de ce tableau peut utiliser l’un des deux formats suivants :
    • L’objet peut définir une relation entre deux éléments de niveau supérieur (uniquement) à l’aide parent des paires nom-valeur et child avec des valeurs représentant les index d’éléments du tableau de charge items utile.
    • L’objet peut définir une relation entre deux éléments quelconques, y compris les éléments de niveau supérieur, associés ou de recherche, à l’aide parent_id de paires clé/valeur et child_id avec des valeurs représentant internal_id les valeurs définies pour ces éléments.

    Type de données : tableau d’objets

    "relations": [
  {
    "child": Number,
    "parent": Number,
    "sys_rel_source_info": {Object},
    "type": "String"
  }
]
    "relations": [
  {
    "child_id": "String",
    "parent_id": "String",
    "sys_rel_source_info": {Object},
    "type": "String"
  }
]
    relations.enfant Index entier de l’objet CI dans le items tableau qui représente l’enfant dans la relation.

    Type de données : nombre
    relations.child_id L’élément internal_id enfant dans la relation.

    Type de données : chaîne
    relations.parent Index entier de l’objet CI dans le items tableau qui représente le parent dans la relation.

    Type de données : nombre
    relations.parent_id L’élément internal_id parent dans la relation.

    Type de données : chaîne
    relations.sys_rel_source_info Informations sur la source de découverte pour la relation. Pour les relations de non-dépendance, ces informations figurent dans la table Sources de relation [sys_rel_source].

    Type de données : objet

    "sys_rel_source_info": { 
  "source_name": "String", 
  "source_feed": "String" 
}
    relations.sys_rel_source_info.nom_source Nom de la source de découverte.

    Par défaut : source de découverte transmise dans le paramètre de méthode API.
    relations.sys_rel_source_info.source_feed Toute chaîne qui est une sous-découverte/analyse dans la source de découverte.

    Par défaut : « INCONNU » est stocké dans la colonne source_feed lors de la création d’un enregistrement dans sys_rel_source table.
    relations.type Type de relation existant entre les éléments parent et enfant. Il doit s’agir d’une valeur de champ de nom de la table Type de relation CI [cmdb_rel_type].

    Type de données : chaîne

    En-têtes

    Les en-têtes de demande et de réponse suivants s'appliquent à 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 la réponse (JSON ou XML)

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

    Type de données : tableau

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

    Type de données : tableau d’objets

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

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

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

    Type de données : tableau d’objets

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

    Type de données : chaîne
    result.additionalCommittedItems.errors.message Message d’erreur rencontré lors du traitement de ce CI supplémentaire.

    Type de données : chaîne
    résultat.additionalCommittedItems.identificationAttempts Liste des tentatives effectuées pour identifier ce CI supplémentaire.
    Type de données : tableau d’objets
    "identificationAttempts": [
  {
    "attemptResult": "String",
    "attributes": [Array],
    "hybridEntryCiAttributes": [Array],
    "identiferName": "String",
    "searchOnTable": [Array]
  }
]
    résultat.élémentssupplémentairescommis.tentatives.tentatives.résultat Résultat de cette tentative d’identification de CI supplémentaire.
    Valeurs possibles :
    • CORRESPONDANCE : identification réussie. Un CI unique a été trouvé dans la table de règles d’identificateur qui correspond exactement aux attributs spécifiés.
    • MULTI_MATCH : échec de l’identification avec une erreur. Des CI en double ont été trouvés dans la table des règles d’identificateur lors de la mise en correspondance avec les attributs spécifiés.
    • NO_MATCH : échec de l’identification. Aucun CI correspondant aux attributs spécifiés n’a été trouvé dans la table de règles d’identificateur.
    • IGNORÉ : identification non tentée. Les attributs requis pour cette recherche dans la table des règles d’identificateur n’étant pas fournis, la règle n’a donc pas été appliquée.

    Type de données : chaîne
    résultat.élémentssupplémentairesValidés.identificationTentatives.attributs Tableau des attributs d’entrée d’identificateur de CI utilisés au cours de cette tentative d’identification de CI supplémentaire.

    Type de données : tableau

    Les noms et les 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 les 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
    résultat.additionalCommittedItems.identificationAttempts.searchOnTable Nom de la table recherchée pour cette tentative d’identification de CI supplémentaire.

    Type de données : chaîne
    result.additionalCommittedItems.identifierEntrySysId Sys_id de la règle d’identificateur utilisée pour identifier ce CI supplémentaire.
    Valeurs notables :
    • Inconnu : échec de l’identification de ce CI supplémentaire. Consultez errors pour en savoir plus.

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

    Type de données : tableau d’objets

    "inputIndices": [
  {
    Number
  }
]
    résultat.additionalCommittedItems.markers Liste des valeurs du marqueur pour une utilisation interne.

    Type de données : tableau

    "markers": []
    résultat.additionalCommittedItems.mergedPayloads Liste des valeurs de sys_id des charges utiles partielles de la table Charges utiles partielles IRE CMDB [cmdb_ire_partial_payloads] qui ont été fusionnées pendant le traitement de ce CI supplémentaire.

    Type de données : tableau

    "mergedPayloadIds": [
  "String"
]
    résultat.élémentsCommitted.supplémentaires Opération exécutée pour ce CI supplémentaire.
    Valeurs possibles :
    • DELETE : un CI existant est supprimé de la table cible.
    • INSERT : le CI supplémentaire est inséré dans la table cible en tant que nouvel enregistrement.
    • NO_CHANGE : aucune opération n’est effectuée pour le CI supplémentaire.
    • MISE À JOUR : un CI existant dans la table cible est mis à jour.
    • UPDATE_WITH_DOWNGRADE : un CI existant dans la table cible est mis à jour et sa classe est remplacée par une classe plus générique (classe ancêtre).
    • UPDATE_WITH_SWITCH : un CI existant dans la table cible est mis à jour et sa classe est remplacée par une autre classe qui n’est pas une classe ancêtres ou descendantes.
    • 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.élémentsCommitted.avertissements Liste des avertissements rencontrés lors du traitement de ce CI supplémentaire.

    Type de données : tableau d’objets

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

    Type de données : chaîne
    résultat.élémentssupplémentairesengagés.avertissements.message Message d’avertissement rencontré lors du traitement de ce CI supplémentaire.

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

    Type de données : tableau d’objets

    "additionalCommittedRelations": [
  {
    "className": "String",
    "operation": "String",
    "markers": [Array],
    "inputIndices": [Array],
    "mergedPayloadIds": [Array]
  }
]
    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
    résultat.relationscommisessupplémentaires.errorCount Nombre d’erreurs rencontrées lors du traitement de ce CI de relation dépendante supplémentaire.

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

    Type de données : tableau d’objets

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

    Type de données : chaîne
    résultat.relations.commisessupplémentaires.erreurs.message Un message d’erreur est survenu lors du traitement de ce CI de relation dépendante supplémentaire.

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

    Type de données : tableau

    "inputIndices": [
  Number
]
    résultat.relationsengagementsupplémentaires.marqueurs Liste des valeurs du marqueur pour une utilisation interne.

    Type de données : tableau

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

    Type de données : tableau

    "mergedPayloadIds": [
  "String"
]
    résultat.relations.engagementsupplémentaires.opération Opération exécutée pour ce CI de relation dépendante supplémentaire.
    Valeurs possibles :
    • INSÉRER : le CI de relation dépendante est inséré dans la table cible en tant que nouvel enregistrement.
    • INSERT_AS_INCOMPLETE : CI de relation dépendante comportait des erreurs et est inséré dans la table Charges utiles incomplètes IRE CMDB [cmdb_ire_incomplete_payloads].
    • INSERT_AS_PARTIAL : CI de relation dépendante a connu des erreurs et est inséré dans la table Charges utiles partielles IRE CMDB [cmdb_ire_partial_payloads].
    • NO_CHANGE : aucune opération n’est effectuée pour le CI de relation dépendant.
    • MISE À JOUR : un CI de relation dépendante existant dans la table cible est mis à jour.

    Type de données : chaîne
    résultats.éléments Liste des CI inclus dans le tableau de corps items de la demande.

    Type de données : tableau d’objets

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

    Type de données : tableau d’objets

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

    Type de données : chaîne
    résultat.éléments.élémentsconnexes supplémentaires.index_entrée Liste des valeurs d’index pour les CI du tableau de corps items de la demande qui correspondent à cet élément associé.

    Type de données : tableau

    "inputIndices": [
    Number
]
    résultats.éléments.supplémentairesÉlémentsliés.marqueurs Liste des valeurs du marqueur pour une utilisation interne.

    Type de données : tableau

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

    Type de données : tableau

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

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

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

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

    Type de données : objet

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

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

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

    Type de données : tableau d’objets

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

    Type de données : chaîne
    Résultat.Éléments.Erreurs.Message Un message d’erreur est survenu lors du traitement de ce CI.

    Type de données : chaîne
    résultat.éléments.identificationtentatives Liste des tentatives d’identification de ce CI.
    Type de données : tableau d’objets
    "identificationAttempts": [
  {
    "attemptResult": "String",
    "attributes": [Array],
    "hybridEntryCiAttributes": [Array],
    "identiferName": "String",
    "searchOnTable": [Array]
  }
]
    résultat.éléments.identificationtentatives.résultat. Résultat de cette tentative d’identification de CI.
    Valeurs possibles :
    • CORRESPONDANCE : identification réussie. Un CI unique a été trouvé dans la table de règles d’identificateur qui correspond exactement aux attributs spécifiés.
    • MULTI_MATCH : échec de l’identification avec une erreur. Des CI en double ont été trouvés dans la table des règles d’identificateur lors de la mise en correspondance avec les attributs spécifiés.
    • NO_MATCH : échec de l’identification. Aucun CI correspondant aux attributs spécifiés n’a été trouvé dans la table de règles d’identificateur.
    • IGNORÉ : identification non tentée. Les attributs requis pour cette recherche dans la table des règles d’identificateur n’étant pas fournis, la règle n’a donc pas été appliquée.

    Type de données : chaîne
    résultat.éléments.tentativesd’identification.attributs Liste des attributs d’entrée d’identificateur de CI utilisés au cours de cette tentative d’identification de CI.

    Type de données : tableau

    Les noms et les 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 de CI utilisés au cours de cette tentative d’identification de CI.

    Type de données : tableau

    Les noms et les 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
    résultat.éléments.identificationtentatives.rechercherOnTable 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"
  }
]
    résultat.é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 pour lequel la reclassification a été ignorée.

    Type de données : chaîne
    result.items.info.ruleSysId Sys_id de la règle de restriction de reclassification correspondante. Applicable uniquement lorsque IRE ignore la reclassification en raison 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
    résultats.éléments.indexentrées Liste des valeurs d’index pour les CI du tableau de corps items de la demande qui correspondent à ce CI.

    Type de données : tableau d’objets

    "inputIndices": [
  {
    Number
  }
]
    résultats.éléments.marqueurs Liste des valeurs du marqueur pour une utilisation interne.

    Type de données : tableau

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

    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.
    • MISE À JOUR : un CI existant dans la table cible est mis à jour.
    • UPDATE_WITH_DOWNGRADE : un CI existant dans la table cible est mis à jour et sa classe est remplacée par une classe plus générique (classe ancêtre).
    • UPDATE_WITH_SWITCH : un CI existant dans la table cible est mis à jour et sa classe est remplacée par une autre classe qui n’est pas une classe ancêtres ou descendantes.
    • 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
    résultat.éléments.élémentsconnexes Liste des CI associés (CI de recherche de table) à partir du tableau de 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 Le sys_class_name de l’élément connexe.

    Type de données : chaîne
    résultats.éléments.élémentsconnexes.indexentrées 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 associé.

    Type de données : tableau d’objets

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

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

    Type de données : nombre
    résultat.éléments.élémentsconnexes.marqueurs Liste des valeurs du marqueur pour une utilisation interne.

    Type de données : tableau

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

    Type de données : tableau

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

    Type de données : tableau

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

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

    Type de données : tableau d’objets

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    Résultat.Éléments.Avertissements.Erreur Type d’avertissement rencontré lors du traitement de ce CI.

    Type de données : chaîne
    Résultat.Éléments.Avertissements.Message Message d’avertissement rencontré lors du traitement de ce CI.

    Type de données : chaîne
    résultat.logContextId ID de contexte signalé pour cette charge utile.

    Type de données : chaîne
    résultat.relations Liste des CI de relation dépendante du tableau de corps relations de la demande.

    Type de données : tableau d’objets

    "relations": [
  {
    "className": "String",
    "errorCount": Number,
    "errors": [Array],
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloadIds": [Array],
    "operation": "String",
    "warnings": [Array]
  }
]
    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é lors du traitement de ce CI de relation dépendante.

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

    Type de données : tableau

    "inputIndices": [
  Number
]
    résultat.relations.marqueurs Liste des valeurs du marqueur pour une utilisation interne.

    Type de données : tableau

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

    Type de données : tableau

    "mergedPayloadIds": [
  "String"
]
    résultat.relations.opération Opération exécutée pour ce CI de relation dé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 a connu des erreurs et a été inséré dans la table Charges utiles incomplètes IRE CMDB [cmdb_ire_incomplete_payloads].
    • INSERT_AS_PARTIAL : CI de relation dépendante a connu des erreurs et a été inséré dans la table Charges utiles partielles IRE CMDB [cmdb_ire_partial_payloads].
    • NO_CHANGE : aucune opération n’a été effectuée pour le CI de relation dépendante.
    • MISE À JOUR : un CI de relation dépendante existant dans la table cible a été mis à jour.

    Type de données : chaîne
    résultat.relations.avertissements Liste des avertissements rencontrés lors du traitement de ce CI de relation dépendante.

    Type de données : tableau d’objets

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    Résultat.Relations.Avertissements.Erreur Type d’avertissement rencontré lors du traitement de ce CI de relation dépendante.

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

    Type de données : chaîne

    Demande cURL

    Soumettez une charge utile contenant un serveur Linux (avec des recherches d’éléments connexes au numéro de série et à la 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 règle matérielle, recherchez son nom dans la table Matériel [cmdb_ci_hardware] et est traité comme une mise à jour d’un CI existant dans la table Serveur Linux [cmdb_ci_linux_server]. Le commutateur IP est identifié de la même manière via une règle matérielle, recherchez son nom dans la table Matériel et met à jour un CI existant dans la table Commutateur IP [cmdb_ci_ip_switch]. Enfin, la relation dépendante de la connexion IP entre le serveur et le commutateur est insérée en tant que nouvel enregistrement dans la table 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 - PUBLIER /now/identifyreconcile/enhanced

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

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

    Format d'URL

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

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

    Remarque :
    Les versions disponibles sont spécifiées dans l’explorateur d’API REST. Pour les API REST basées sur un script, des informations de version supplémentaires sont disponibles sur le formulaire Service REST scripté.

    Paramètres de demande pris en charge

    Tableau 7. Paramètres de chemin d'accès
    Nom Description
    api_version Facultatif. Version du point de terminaison auquel accéder. Par exemple, v1 ou v2. Spécifiez uniquement cette valeur pour utiliser une version de point de terminaison différente de la dernière.

    Type de données : chaîne
    Tableau 8. Paramètres de requête
    Nom Description
    options Liste de paires nom-valeur séparées par des virgules représentant les options IRE améliorées appliquées à la demande.

    Par exemple, pour remplacer les valeurs par défaut des charges utiles partielles, des validations partielles, dédupliquer les charges utiles et générer des options IRE améliorées de synthèse :

    partial_payloads :faux,partial_commits :faux,deduplicate_payloads :faux,generate_summary :vrai
    Remarque :
    Par défaut ou si partial_payloads est défini sur true, les deux partial_commits et deduplicate_payloads sont activés, même s’ils sont définis sur false, car ces fonctionnalités sont essentielles pour la fonctionnalité de charges utiles partielles.

    Pour en savoir plus sur les options IRE améliorées, consultez Moteur IRE (moteur Identification et rapprochement).

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

    Type de données : chaîne
    sysparm_data_source Source des informations sur le CI. Il doit s’agir de l’une des valeurs de choix définies pour le champ discovery_source de la table Élément de configuration [cmdb_ci].

    Type de données : chaîne

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

    Type de données : tableau d’objets

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

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

    Type de données : chaîne
    Recherche.Éléments Tableau d’objets dans lequel chaque objet décrit un enregistrement d’identification basé sur la recherche. Ces enregistrements sont utilisés pour identifier l’élément de configuration de niveau supérieur en fonction d’une table de recherche qui fait référence à la table Élément de configuration [cmdb_ci].

    Type de données : Tableau hors objets

    "lookup": [
  {
    "className": "String",
    "internal_id": "String",
    "sys_object_source_info": {Object},
    "values": {Object}
  }
]
    items.lookup.className Requis. Le nom de sys_class_name ou de classe/table du CI à créer ou à mettre à jour. Cette valeur peut être n’importe quelle CMDB classe/table, telle que cmdb_serial_number ou cmdb_ci_network_adapter, ou une classe nonCMDB hiérarchique.

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

    Type de données : chaîne
    items.lookup.sys_object_source_info Objet décrivant un identificateur de CI unique pour une source de données spécifiée. Différentes sources peuvent avoir des paires nom-valeur différentes pour le même CI.

    Type de données : objet

    "sys_object_source_info": {
  "source_feed": "String",
  "source_name": "String",  
  "source_native_key": "String",
  "source_recency_timestamp": "String"
}
    items.lookup.sys_object_source_info.source_feed Nom qui identifie de manière unique le flux qui envoie ce CI. À utiliser si la source peut avoir plusieurs flux.

    Type de données : chaîne
    items.lookup.sys_info_source_objet.nom_source Source de données des informations sur le CI. Cette valeur doit être l’une des valeurs de choix définies pour le champ discovery_source de la table Élément de configuration [cmdb_ci].

    Type de données : chaîne
    items.lookup.sys_object_source_info.source_native_key Clé/ID unique de la source pour le CI. Peut être n’importe quelle chaîne unique à l’élément.

    Type de données : chaîne
    items.lookup.sys_object_source_info.source_recency_timestamp Date et heure UTC auxquelles le CI a été analysé.

    Type de données : chaîne

    Format : JJ-MM-AAAA hh :mm :ss
    éléments.recherche.valeurs Objet décrivant les champs de cet élément de recherche sous forme de paires nom/valeur, où le nom est le nom du champ.

    Type de données : objet

    Les noms et 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 le type d’enregistrements qui peuvent se trouver 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 être 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 de CI unique pour une source de données spécifiée. Différentes sources peuvent avoir des paires nom-valeur différentes pour le même CI.

    Type de données : objet

    "sys_object_source_info": {
  "source_feed": "String",
  "source_name": "String",  
  "source_native_key": "String",
  "source_recency_timestamp": "String"
}
    items.related.sys_object_source_info.source_feed Nom qui identifie de manière unique le flux à l’origine de cet élément associé. À utiliser si la source peut avoir plusieurs flux.

    Type de données : chaîne
    items.related.sys_info_source_objet.nom_source Source de données pour les informations sur l’élément connexe. Cette valeur doit être l’une des valeurs de choix définies pour le champ discovery_source de la table Élément de configuration [cmdb_ci].

    Type de données : chaîne
    items.related.sys_object_source_info.source_native_key Clé/ID unique de la source pour l’élément connexe. Peut être n’importe quelle chaîne unique à l’élément.

    Type de données : chaîne
    items.related.sys_object_source_info.source_recency_timestamp Date et heure UTC auxquelles l’élément connexe a été analysé.

    Type de données : chaîne

    Format : JJ-MM-AAAA hh :mm :ss
    éléments.valeurs.connexes Objet décrivant les champs à créer ou mettre à jour pour cet élément associé 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.paramètres Objet contenant les paramètres définissant les types de mises à jour autorisés.

    Type de données : objet

    "settings": {
  "skipReclassificationRestrictionRules": Boolean,
  "updateWithoutDowngrade": Boolean,
  "updateWithoutSwitch": Boolean,
  "updateWithoutUpgrade": Boolean
}
    items.settings.skipReclassificationRestrictionRules Marqueur indiquant si IRE doit ignorer l’exécution de la règle de restriction de reclassification qui correspond à la classe de l’élément de charge utile.
    Valeurs valides :
    • vrai : ignorer l’exécution de la règle.
    • faux : exécutez la règle.

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

    Type de données : booléennes

    Valeur par défaut : false
    items.settings.updateWithoutSwitch Marqueur indiquant si ce CI peut être mis à jour et si sa classe peut être changée.
    Valeurs valides :
    • vrai : mettre à jour l’élément, mais le changement de classe n’est pas autorisé.
    • false : la mise à jour d’un objet 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 toutes deux autorisées pour ce CI.
    Valeurs valides :
    • vrai : mettre à jour l’élément, mais la mise à niveau n’est pas autorisée.
    • false : la mise à jour et la mise à niveau de l’élément sont autorisées.

    Type de données : booléennes

    Valeur par défaut : false
    items.sys_objet_source_info Objet décrivant un identificateur de CI unique.

    Type de données : objet

    "sys_object_source_info": {
  "source_feed": "String",
  "source_name": "String",  
  "source_native_key": "String",
  "source_recency_timestamp": "String"
}
    items.sys_object_source_info.source_feed Nom qui identifie de manière unique le flux qui envoie ce CI. À utiliser si la source peut avoir plusieurs flux.

    Type de données : chaîne
    nom_source items.sys_objet_source_nom_source Source de données des informations sur le CI. Cette valeur doit être l’une des valeurs de choix définies pour le champ discovery_source de la table Élément de configuration [cmdb_ci].

    Type de données : chaîne
    items.sys_object_source_info.source_native_key Clé/ID unique de la source pour le CI. Peut être n’importe quelle chaîne unique à l’élément.

    Type de données : chaîne
    items.sys_object_source_info.source_recency_timestamp Date et heure UTC auxquelles le CI a été analysé.

    Type de données : chaîne

    Format : 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. Les valeurs de chaque élément de référence sont renseignées avant d’identifier un CI à l’aide des règles IRE définies sur une classe.

    Type de données : tableau d’objets

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

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

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

    Type de données : chaîne
    Relations Liste des relations entre deux éléments définis dans la charge utile.
    Un objet de ce tableau peut utiliser l’un des deux formats suivants :
    • L’objet peut définir une relation entre deux éléments de niveau supérieur (uniquement) à l’aide parent des paires nom-valeur et child avec des valeurs représentant les index d’éléments du tableau de charge items utile.
    • L’objet peut définir une relation entre deux éléments quelconques, y compris les éléments de niveau supérieur, associés ou de recherche, à l’aide parent_id de paires clé/valeur et child_id avec des valeurs représentant internal_id les valeurs définies pour ces éléments.

    Type de données : tableau d’objets

    "relations": [
  {
    "child": Number,
    "parent": Number,
    "sys_rel_source_info": {Object},
    "type": "String"
  }
]
    "relations": [
  {
    "child_id": "String",
    "parent_id": "String",
    "sys_rel_source_info": {Object},
    "type": "String"
  }
]
    relations.enfant Index entier de l’objet CI dans le items tableau qui représente l’enfant dans la relation.

    Type de données : nombre
    relations.child_id L’élément internal_id enfant dans la relation.

    Type de données : chaîne
    relations.parent Index entier de l’objet CI dans le items tableau qui représente le parent dans la relation.

    Type de données : nombre
    relations.parent_id L’élément internal_id parent dans la relation.

    Type de données : chaîne
    relations.sys_rel_source_info Informations sur la source de découverte pour la relation. Pour les relations de non-dépendance, ces informations figurent dans la table Sources de relation [sys_rel_source].

    Type de données : objet

    "sys_rel_source_info": { 
  "source_name": "String", 
  "source_feed": "String" 
}
    relations.sys_rel_source_info.nom_source Nom de la source de découverte.

    Par défaut : source de découverte transmise dans le paramètre de méthode API.
    relations.sys_rel_source_info.source_feed Toute chaîne qui est une sous-découverte/analyse dans la source de découverte.

    Par défaut : « INCONNU » est stocké dans la colonne source_feed lors de la création d’un enregistrement dans sys_rel_source table.
    relations.type Type de relation existant entre les éléments parent et enfant. Il doit s’agir d’une valeur de champ de nom de la table Type de relation CI [cmdb_rel_type].

    Type de données : chaîne

    En-têtes

    Les en-têtes de demande et de réponse suivants s'appliquent à 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.

    Détails du message d’erreur « Le bloc [...] n’est pas une entrée valide » indique que le paramètre de options requête n’est pas dans le format de paire nom-valeur correct.

    Par exemple, la spécification d’un options paramètre de partiel produit un code d’état 500 avec « Chunk [partial] n’est pas une entrée valide » dans le détail du message.

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

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

    Type de données : tableau

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

    Type de données : tableau d’objets

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

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

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

    Type de données : tableau d’objets

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

    Type de données : chaîne
    result.additionalCommittedItems.errors.message Message d’erreur rencontré lors du traitement de ce CI supplémentaire.

    Type de données : chaîne
    résultat.additionalCommittedItems.identificationAttempts Liste des tentatives effectuées pour identifier ce CI supplémentaire.
    Type de données : tableau d’objets
    "identificationAttempts": [
  {
    "attemptResult": "String",
    "attributes": [Array],
    "hybridEntryCiAttributes": [Array],
    "identiferName": "String",
    "searchOnTable": [Array]
  }
]
    résultat.élémentssupplémentairescommis.tentatives.tentatives.résultat Résultat de cette tentative d’identification de CI supplémentaire.
    Valeurs possibles :
    • CORRESPONDANCE : identification réussie. Un CI unique a été trouvé dans la table de règles d’identificateur qui correspond exactement aux attributs spécifiés.
    • MULTI_MATCH : échec de l’identification avec une erreur. Des CI en double ont été trouvés dans la table des règles d’identificateur lors de la mise en correspondance avec les attributs spécifiés.
    • NO_MATCH : échec de l’identification. Aucun CI correspondant aux attributs spécifiés n’a été trouvé dans la table de règles d’identificateur.
    • IGNORÉ : identification non tentée. Les attributs requis pour cette recherche dans la table des règles d’identificateur n’étant pas fournis, la règle n’a donc pas été appliquée.

    Type de données : chaîne
    résultat.élémentssupplémentairesValidés.identificationTentatives.attributs Tableau des attributs d’entrée d’identificateur de CI utilisés au cours de cette tentative d’identification de CI supplémentaire.

    Type de données : tableau

    Les noms et les 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 les 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
    résultat.additionalCommittedItems.identificationAttempts.searchOnTable Nom de la table recherchée pour cette tentative d’identification de CI supplémentaire.

    Type de données : chaîne
    result.additionalCommittedItems.identifierEntrySysId Sys_id de la règle d’identificateur utilisée pour identifier ce CI supplémentaire.
    Valeurs notables :
    • Inconnu : échec de l’identification de ce CI supplémentaire. Consultez errors pour en savoir plus.

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

    Type de données : tableau d’objets

    "inputIndices": [
  {
    Number
  }
]
    résultat.additionalCommittedItems.markers Liste des valeurs du marqueur pour une utilisation interne.

    Type de données : tableau

    "markers": []
    résultat.additionalCommittedItems.mergedPayloads Liste des valeurs de sys_id des charges utiles partielles de la table Charges utiles partielles IRE CMDB [cmdb_ire_partial_payloads] qui ont été fusionnées pendant le traitement de ce CI supplémentaire.

    Type de données : tableau

    "mergedPayloadIds": [
  "String"
]
    résultat.élémentsCommitted.supplémentaires Opération exécutée pour ce CI supplémentaire.
    Valeurs possibles :
    • DELETE : un CI existant est supprimé de la table cible.
    • INSERT : le CI supplémentaire est inséré dans la table cible en tant que nouvel enregistrement.
    • NO_CHANGE : aucune opération n’est effectuée pour le CI supplémentaire.
    • MISE À JOUR : un CI existant dans la table cible est mis à jour.
    • UPDATE_WITH_DOWNGRADE : un CI existant dans la table cible est mis à jour et sa classe est remplacée par une classe plus générique (classe ancêtre).
    • UPDATE_WITH_SWITCH : un CI existant dans la table cible est mis à jour et sa classe est remplacée par une autre classe qui n’est pas une classe ancêtres ou descendantes.
    • 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.élémentsCommitted.avertissements Liste des avertissements rencontrés lors du traitement de ce CI supplémentaire.

    Type de données : tableau d’objets

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

    Type de données : chaîne
    résultat.élémentssupplémentairesengagés.avertissements.message Message d’avertissement rencontré lors du traitement de ce CI supplémentaire.

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

    Type de données : tableau d’objets

    "additionalCommittedRelations": [
  {
    "className": "String",
    "operation": "String",
    "markers": [Array],
    "inputIndices": [Array],
    "mergedPayloadIds": [Array]
  }
]
    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
    résultat.relationscommisessupplémentaires.errorCount Nombre d’erreurs rencontrées lors du traitement de ce CI de relation dépendante supplémentaire.

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

    Type de données : tableau d’objets

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

    Type de données : chaîne
    résultat.relations.commisessupplémentaires.erreurs.message Un message d’erreur est survenu lors du traitement de ce CI de relation dépendante supplémentaire.

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

    Type de données : tableau

    "inputIndices": [
  Number
]
    résultat.relationsengagementsupplémentaires.marqueurs Liste des valeurs du marqueur pour une utilisation interne.

    Type de données : tableau

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

    Type de données : tableau

    "mergedPayloadIds": [
  "String"
]
    résultat.relations.engagementsupplémentaires.opération Opération exécutée pour ce CI de relation dépendante supplémentaire.
    Valeurs possibles :
    • INSÉRER : le CI de relation dépendante est inséré dans la table cible en tant que nouvel enregistrement.
    • INSERT_AS_INCOMPLETE : CI de relation dépendante comportait des erreurs et est inséré dans la table Charges utiles incomplètes IRE CMDB [cmdb_ire_incomplete_payloads].
    • INSERT_AS_PARTIAL : CI de relation dépendante a connu des erreurs et est inséré dans la table Charges utiles partielles IRE CMDB [cmdb_ire_partial_payloads].
    • NO_CHANGE : aucune opération n’est effectuée pour le CI de relation dépendant.
    • MISE À JOUR : un CI de relation dépendante existant dans la table cible est mis à jour.

    Type de données : chaîne
    résultats.éléments Liste des CI inclus dans le tableau de corps items de la demande.

    Type de données : tableau d’objets

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

    Type de données : tableau d’objets

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

    Type de données : chaîne
    résultat.éléments.élémentsconnexes supplémentaires.index_entrée Liste des valeurs d’index pour les CI du tableau de corps items de la demande qui correspondent à cet élément associé.

    Type de données : tableau

    "inputIndices": [
    Number
]
    résultats.éléments.supplémentairesÉlémentsliés.marqueurs Liste des valeurs du marqueur pour une utilisation interne.

    Type de données : tableau

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

    Type de données : tableau

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

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

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

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

    Type de données : objet

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

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

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

    Type de données : tableau d’objets

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

    Type de données : chaîne
    Résultat.Éléments.Erreurs.Message Un message d’erreur est survenu lors du traitement de ce CI.

    Type de données : chaîne
    résultat.éléments.identificationtentatives Liste des tentatives d’identification de ce CI.
    Type de données : tableau d’objets
    "identificationAttempts": [
  {
    "attemptResult": "String",
    "attributes": [Array],
    "hybridEntryCiAttributes": [Array],
    "identiferName": "String",
    "searchOnTable": [Array]
  }
]
    résultat.éléments.identificationtentatives.résultat. Résultat de cette tentative d’identification de CI.
    Valeurs possibles :
    • CORRESPONDANCE : identification réussie. Un CI unique a été trouvé dans la table de règles d’identificateur qui correspond exactement aux attributs spécifiés.
    • MULTI_MATCH : échec de l’identification avec une erreur. Des CI en double ont été trouvés dans la table des règles d’identificateur lors de la mise en correspondance avec les attributs spécifiés.
    • NO_MATCH : échec de l’identification. Aucun CI correspondant aux attributs spécifiés n’a été trouvé dans la table de règles d’identificateur.
    • IGNORÉ : identification non tentée. Les attributs requis pour cette recherche dans la table des règles d’identificateur n’étant pas fournis, la règle n’a donc pas été appliquée.

    Type de données : chaîne
    résultat.éléments.tentativesd’identification.attributs Liste des attributs d’entrée d’identificateur de CI utilisés au cours de cette tentative d’identification de CI.

    Type de données : tableau

    Les noms et les 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 de CI utilisés au cours de cette tentative d’identification de CI.

    Type de données : tableau

    Les noms et les 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
    résultat.éléments.identificationtentatives.rechercherOnTable 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"
  }
]
    résultat.é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 pour lequel la reclassification a été ignorée.

    Type de données : chaîne
    result.items.info.ruleSysId Sys_id de la règle de restriction de reclassification correspondante. Applicable uniquement lorsque IRE ignore la reclassification en raison 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
    résultats.éléments.indexentrées Liste des valeurs d’index pour les CI du tableau de corps items de la demande qui correspondent à ce CI.

    Type de données : tableau d’objets

    "inputIndices": [
  {
    Number
  }
]
    résultats.éléments.marqueurs Liste des valeurs du marqueur pour une utilisation interne.

    Type de données : tableau

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

    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.
    • MISE À JOUR : un CI existant dans la table cible est mis à jour.
    • UPDATE_WITH_DOWNGRADE : un CI existant dans la table cible est mis à jour et sa classe est remplacée par une classe plus générique (classe ancêtre).
    • UPDATE_WITH_SWITCH : un CI existant dans la table cible est mis à jour et sa classe est remplacée par une autre classe qui n’est pas une classe ancêtres ou descendantes.
    • 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
    résultat.éléments.élémentsconnexes Liste des CI associés (CI de recherche de table) à partir du tableau de 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 Le sys_class_name de l’élément connexe.

    Type de données : chaîne
    résultats.éléments.élémentsconnexes.indexentrées 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 associé.

    Type de données : tableau d’objets

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

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

    Type de données : nombre
    résultat.éléments.élémentsconnexes.marqueurs Liste des valeurs du marqueur pour une utilisation interne.

    Type de données : tableau

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

    Type de données : tableau

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

    Type de données : tableau

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

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

    Type de données : tableau d’objets

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    Résultat.Éléments.Avertissements.Erreur Type d’avertissement rencontré lors du traitement de ce CI.

    Type de données : chaîne
    Résultat.Éléments.Avertissements.Message Message d’avertissement rencontré lors du traitement de ce CI.

    Type de données : chaîne
    résultat.logContextId ID de contexte signalé pour cette charge utile.

    Type de données : chaîne
    résultat.relations Liste des CI de relation dépendante du tableau de corps relations de la demande.

    Type de données : tableau d’objets

    "relations": [
  {
    "className": "String",
    "errorCount": Number,
    "errors": [Array],
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloadIds": [Array],
    "operation": "String",
    "warnings": [Array]
  }
]
    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é lors du traitement de ce CI de relation dépendante.

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

    Type de données : tableau

    "inputIndices": [
  Number
]
    résultat.relations.marqueurs Liste des valeurs du marqueur pour une utilisation interne.

    Type de données : tableau

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

    Type de données : tableau

    "mergedPayloadIds": [
  "String"
]
    résultat.relations.opération Opération exécutée pour ce CI de relation dé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 a connu des erreurs et a été inséré dans la table Charges utiles incomplètes IRE CMDB [cmdb_ire_incomplete_payloads].
    • INSERT_AS_PARTIAL : CI de relation dépendante a connu des erreurs et a été inséré dans la table Charges utiles partielles IRE CMDB [cmdb_ire_partial_payloads].
    • NO_CHANGE : aucune opération n’a été effectuée pour le CI de relation dépendante.
    • MISE À JOUR : un CI de relation dépendante existant dans la table cible a été mis à jour.

    Type de données : chaîne
    résultat.relations.avertissements Liste des avertissements rencontrés lors du traitement de ce CI de relation dépendante.

    Type de données : tableau d’objets

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    Résultat.Relations.Avertissements.Erreur Type d’avertissement rencontré lors du traitement de ce CI de relation dépendante.

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

    Type de données : chaîne

    Demande cURL

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

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

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

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

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

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

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

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

    Identification et réconciliation : PUBLIER /now/identifyreconcile/query

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

    Utilisez ce point de terminaison pour simuler la soumission d’une charge utile (corps de la demande) au point de Identification et réconciliation - POST /now/identifyreconcile terminaison.

    Utilisez le point de Identification et réconciliation - PUBLIER /now/identifyreconcile/enhanced terminaison à la place si vous devez spécifier les options IRE améliorées. Pour en savoir plus sur les options IRE améliorées, consultez Moteur IRE (moteur Identification et rapprochement).

    Format d'URL

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

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

    Remarque :
    Les versions disponibles sont spécifiées dans l’explorateur d’API REST. Pour les API REST basées sur un script, des informations de version supplémentaires sont disponibles sur le formulaire Service REST scripté.

    Paramètres de demande pris en charge

    Tableau 13. Paramètres de chemin d'accès
    Nom Description
    api_version Facultatif. Version du point de terminaison auquel accéder. Par exemple, v1 ou v2. Spécifiez uniquement cette valeur pour utiliser une version de point de terminaison 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 sur le CI. Il doit s’agir de l’une des valeurs de choix définies pour le champ discovery_source de la table Élément de configuration [cmdb_ci].

    Type de données : chaîne

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

    Type de données : tableau d’objets

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

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

    Type de données : chaîne
    Recherche.Éléments Tableau d’objets dans lequel chaque objet décrit un enregistrement d’identification basé sur la recherche. Ces enregistrements sont utilisés pour identifier l’élément de configuration de niveau supérieur en fonction d’une table de recherche qui fait référence à la table Élément de configuration [cmdb_ci].

    Type de données : Tableau hors objets

    "lookup": [
  {
    "className": "String",
    "internal_id": "String",
    "sys_object_source_info": {Object},
    "values": {Object}
  }
]
    items.lookup.className Requis. Le nom de sys_class_name ou de classe/table du CI à créer ou à mettre à jour. Cette valeur peut être n’importe quelle CMDB classe/table, telle que cmdb_serial_number ou cmdb_ci_network_adapter, ou une classe nonCMDB hiérarchique.

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

    Type de données : chaîne
    items.lookup.sys_object_source_info Objet décrivant un identificateur de CI unique pour une source de données spécifiée. Différentes sources peuvent avoir des paires nom-valeur différentes pour le même CI.

    Type de données : objet

    "sys_object_source_info": {
  "source_feed": "String",
  "source_name": "String",  
  "source_native_key": "String",
  "source_recency_timestamp": "String"
}
    items.lookup.sys_object_source_info.source_feed Nom qui identifie de manière unique le flux qui envoie ce CI. À utiliser si la source peut avoir plusieurs flux.

    Type de données : chaîne
    items.lookup.sys_info_source_objet.nom_source Source de données des informations sur le CI. Cette valeur doit être l’une des valeurs de choix définies pour le champ discovery_source de la table Élément de configuration [cmdb_ci].

    Type de données : chaîne
    items.lookup.sys_object_source_info.source_native_key Clé/ID unique de la source pour le CI. Peut être n’importe quelle chaîne unique à l’élément.

    Type de données : chaîne
    items.lookup.sys_object_source_info.source_recency_timestamp Date et heure UTC auxquelles le CI a été analysé.

    Type de données : chaîne

    Format : JJ-MM-AAAA hh :mm :ss
    éléments.recherche.valeurs Objet décrivant les champs de cet élément de recherche sous forme de paires nom/valeur, où le nom est le nom du champ.

    Type de données : objet

    Les noms et 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 le type d’enregistrements qui peuvent se trouver 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 être 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 de CI unique pour une source de données spécifiée. Différentes sources peuvent avoir des paires nom-valeur différentes pour le même CI.

    Type de données : objet

    "sys_object_source_info": {
  "source_feed": "String",
  "source_name": "String",  
  "source_native_key": "String",
  "source_recency_timestamp": "String"
}
    items.related.sys_object_source_info.source_feed Nom qui identifie de manière unique le flux à l’origine de cet élément associé. À utiliser si la source peut avoir plusieurs flux.

    Type de données : chaîne
    items.related.sys_info_source_objet.nom_source Source de données pour les informations sur l’élément connexe. Cette valeur doit être l’une des valeurs de choix définies pour le champ discovery_source de la table Élément de configuration [cmdb_ci].

    Type de données : chaîne
    items.related.sys_object_source_info.source_native_key Clé/ID unique de la source pour l’élément connexe. Peut être n’importe quelle chaîne unique à l’élément.

    Type de données : chaîne
    items.related.sys_object_source_info.source_recency_timestamp Date et heure UTC auxquelles l’élément connexe a été analysé.

    Type de données : chaîne

    Format : JJ-MM-AAAA hh :mm :ss
    éléments.valeurs.connexes Objet décrivant les champs à créer ou mettre à jour pour cet élément associé 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.paramètres Objet contenant les paramètres définissant les types de mises à jour autorisés.

    Type de données : objet

    "settings": {
  "skipReclassificationRestrictionRules": Boolean,
  "updateWithoutDowngrade": Boolean,
  "updateWithoutSwitch": Boolean,
  "updateWithoutUpgrade": Boolean
}
    items.settings.skipReclassificationRestrictionRules Marqueur indiquant si IRE doit ignorer l’exécution de la règle de restriction de reclassification qui correspond à la classe de l’élément de charge utile.
    Valeurs valides :
    • vrai : ignorer l’exécution de la règle.
    • faux : exécutez la règle.

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

    Type de données : booléennes

    Valeur par défaut : false
    items.settings.updateWithoutSwitch Marqueur indiquant si ce CI peut être mis à jour et si sa classe peut être changée.
    Valeurs valides :
    • vrai : mettre à jour l’élément, mais le changement de classe n’est pas autorisé.
    • false : la mise à jour d’un objet 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 toutes deux autorisées pour ce CI.
    Valeurs valides :
    • vrai : mettre à jour l’élément, mais la mise à niveau n’est pas autorisée.
    • false : la mise à jour et la mise à niveau de l’élément sont autorisées.

    Type de données : booléennes

    Valeur par défaut : false
    items.sys_objet_source_info Objet décrivant un identificateur de CI unique.

    Type de données : objet

    "sys_object_source_info": {
  "source_feed": "String",
  "source_name": "String",  
  "source_native_key": "String",
  "source_recency_timestamp": "String"
}
    items.sys_object_source_info.source_feed Nom qui identifie de manière unique le flux qui envoie ce CI. À utiliser si la source peut avoir plusieurs flux.

    Type de données : chaîne
    nom_source items.sys_objet_source_nom_source Source de données des informations sur le CI. Cette valeur doit être l’une des valeurs de choix définies pour le champ discovery_source de la table Élément de configuration [cmdb_ci].

    Type de données : chaîne
    items.sys_object_source_info.source_native_key Clé/ID unique de la source pour le CI. Peut être n’importe quelle chaîne unique à l’élément.

    Type de données : chaîne
    items.sys_object_source_info.source_recency_timestamp Date et heure UTC auxquelles le CI a été analysé.

    Type de données : chaîne

    Format : 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. Les valeurs de chaque élément de référence sont renseignées avant d’identifier un CI à l’aide des règles IRE définies sur une classe.

    Type de données : tableau d’objets

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

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

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

    Type de données : chaîne
    Relations Liste des relations entre deux éléments définis dans la charge utile.
    Un objet de ce tableau peut utiliser l’un des deux formats suivants :
    • L’objet peut définir une relation entre deux éléments de niveau supérieur (uniquement) à l’aide parent des paires nom-valeur et child avec des valeurs représentant les index d’éléments du tableau de charge items utile.
    • L’objet peut définir une relation entre deux éléments quelconques, y compris les éléments de niveau supérieur, associés ou de recherche, à l’aide parent_id de paires clé/valeur et child_id avec des valeurs représentant internal_id les valeurs définies pour ces éléments.

    Type de données : tableau d’objets

    "relations": [
  {
    "child": Number,
    "parent": Number,
    "sys_rel_source_info": {Object},
    "type": "String"
  }
]
    "relations": [
  {
    "child_id": "String",
    "parent_id": "String",
    "sys_rel_source_info": {Object},
    "type": "String"
  }
]
    relations.enfant Index entier de l’objet CI dans le items tableau qui représente l’enfant dans la relation.

    Type de données : nombre
    relations.child_id L’élément internal_id enfant dans la relation.

    Type de données : chaîne
    relations.parent Index entier de l’objet CI dans le items tableau qui représente le parent dans la relation.

    Type de données : nombre
    relations.parent_id L’élément internal_id parent dans la relation.

    Type de données : chaîne
    relations.sys_rel_source_info Informations sur la source de découverte pour la relation. Pour les relations de non-dépendance, ces informations figurent dans la table Sources de relation [sys_rel_source].

    Type de données : objet

    "sys_rel_source_info": { 
  "source_name": "String", 
  "source_feed": "String" 
}
    relations.sys_rel_source_info.nom_source Nom de la source de découverte.

    Par défaut : source de découverte transmise dans le paramètre de méthode API.
    relations.sys_rel_source_info.source_feed Toute chaîne qui est une sous-découverte/analyse dans la source de découverte.

    Par défaut : « INCONNU » est stocké dans la colonne source_feed lors de la création d’un enregistrement dans sys_rel_source table.
    relations.type Type de relation existant entre les éléments parent et enfant. Il doit s’agir d’une valeur de champ de nom de la table Type de relation CI [cmdb_rel_type].

    Type de données : chaîne

    En-têtes

    Les en-têtes de demande et de réponse suivants s'appliquent à 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 la réponse (JSON ou XML)

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

    Type de données : tableau

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

    Type de données : tableau d’objets

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

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

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

    Type de données : tableau d’objets

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

    Type de données : chaîne
    result.additionalCommittedItems.errors.message Message d’erreur rencontré lors du traitement de ce CI supplémentaire.

    Type de données : chaîne
    résultat.additionalCommittedItems.identificationAttempts Liste des tentatives effectuées pour identifier ce CI supplémentaire.
    Type de données : tableau d’objets
    "identificationAttempts": [
  {
    "attemptResult": "String",
    "attributes": [Array],
    "hybridEntryCiAttributes": [Array],
    "identiferName": "String",
    "searchOnTable": [Array]
  }
]
    résultat.élémentssupplémentairescommis.tentatives.tentatives.résultat Résultat de cette tentative d’identification de CI supplémentaire.
    Valeurs possibles :
    • CORRESPONDANCE : identification réussie. Un CI unique a été trouvé dans la table de règles d’identificateur qui correspond exactement aux attributs spécifiés.
    • MULTI_MATCH : échec de l’identification avec une erreur. Des CI en double ont été trouvés dans la table des règles d’identificateur lors de la mise en correspondance avec les attributs spécifiés.
    • NO_MATCH : échec de l’identification. Aucun CI correspondant aux attributs spécifiés n’a été trouvé dans la table de règles d’identificateur.
    • IGNORÉ : identification non tentée. Les attributs requis pour cette recherche dans la table des règles d’identificateur n’étant pas fournis, la règle n’a donc pas été appliquée.

    Type de données : chaîne
    résultat.élémentssupplémentairesValidés.identificationTentatives.attributs Tableau des attributs d’entrée d’identificateur de CI utilisés au cours de cette tentative d’identification de CI supplémentaire.

    Type de données : tableau

    Les noms et les 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 les 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
    résultat.additionalCommittedItems.identificationAttempts.searchOnTable Nom de la table recherchée pour cette tentative d’identification de CI supplémentaire.

    Type de données : chaîne
    result.additionalCommittedItems.identifierEntrySysId Sys_id de la règle d’identificateur utilisée pour identifier ce CI supplémentaire.
    Valeurs notables :
    • Inconnu : échec de l’identification de ce CI supplémentaire. Consultez errors pour en savoir plus.

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

    Type de données : tableau d’objets

    "inputIndices": [
  {
    Number
  }
]
    résultat.additionalCommittedItems.markers Liste des valeurs du marqueur pour une utilisation interne.

    Type de données : tableau

    "markers": []
    résultat.additionalCommittedItems.mergedPayloads Liste des valeurs de sys_id des charges utiles partielles de la table Charges utiles partielles IRE CMDB [cmdb_ire_partial_payloads] qui ont été fusionnées pendant le traitement de ce CI supplémentaire.

    Type de données : tableau

    "mergedPayloadIds": [
  "String"
]
    résultat.élémentsCommitted.supplémentaires Opération exécutée pour ce CI supplémentaire.
    Valeurs possibles :
    • DELETE : un CI existant est supprimé de la table cible.
    • INSERT : le CI supplémentaire est inséré dans la table cible en tant que nouvel enregistrement.
    • NO_CHANGE : aucune opération n’est effectuée pour le CI supplémentaire.
    • MISE À JOUR : un CI existant dans la table cible est mis à jour.
    • UPDATE_WITH_DOWNGRADE : un CI existant dans la table cible est mis à jour et sa classe est remplacée par une classe plus générique (classe ancêtre).
    • UPDATE_WITH_SWITCH : un CI existant dans la table cible est mis à jour et sa classe est remplacée par une autre classe qui n’est pas une classe ancêtres ou descendantes.
    • 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.élémentsCommitted.avertissements Liste des avertissements rencontrés lors du traitement de ce CI supplémentaire.

    Type de données : tableau d’objets

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

    Type de données : chaîne
    résultat.élémentssupplémentairesengagés.avertissements.message Message d’avertissement rencontré lors du traitement de ce CI supplémentaire.

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

    Type de données : tableau d’objets

    "additionalCommittedRelations": [
  {
    "className": "String",
    "operation": "String",
    "markers": [Array],
    "inputIndices": [Array],
    "mergedPayloadIds": [Array]
  }
]
    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
    résultat.relationscommisessupplémentaires.errorCount Nombre d’erreurs rencontrées lors du traitement de ce CI de relation dépendante supplémentaire.

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

    Type de données : tableau d’objets

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

    Type de données : chaîne
    résultat.relations.commisessupplémentaires.erreurs.message Un message d’erreur est survenu lors du traitement de ce CI de relation dépendante supplémentaire.

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

    Type de données : tableau

    "inputIndices": [
  Number
]
    résultat.relationsengagementsupplémentaires.marqueurs Liste des valeurs du marqueur pour une utilisation interne.

    Type de données : tableau

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

    Type de données : tableau

    "mergedPayloadIds": [
  "String"
]
    résultat.relations.engagementsupplémentaires.opération Opération exécutée pour ce CI de relation dépendante supplémentaire.
    Valeurs possibles :
    • INSÉRER : le CI de relation dépendante est inséré dans la table cible en tant que nouvel enregistrement.
    • INSERT_AS_INCOMPLETE : CI de relation dépendante comportait des erreurs et est inséré dans la table Charges utiles incomplètes IRE CMDB [cmdb_ire_incomplete_payloads].
    • INSERT_AS_PARTIAL : CI de relation dépendante a connu des erreurs et est inséré dans la table Charges utiles partielles IRE CMDB [cmdb_ire_partial_payloads].
    • NO_CHANGE : aucune opération n’est effectuée pour le CI de relation dépendant.
    • MISE À JOUR : un CI de relation dépendante existant dans la table cible est mis à jour.

    Type de données : chaîne
    résultats.éléments Liste des CI inclus dans le tableau de corps items de la demande.

    Type de données : tableau d’objets

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

    Type de données : tableau d’objets

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

    Type de données : chaîne
    résultat.éléments.élémentsconnexes supplémentaires.index_entrée Liste des valeurs d’index pour les CI du tableau de corps items de la demande qui correspondent à cet élément associé.

    Type de données : tableau

    "inputIndices": [
    Number
]
    résultats.éléments.supplémentairesÉlémentsliés.marqueurs Liste des valeurs du marqueur pour une utilisation interne.

    Type de données : tableau

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

    Type de données : tableau

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

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

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

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

    Type de données : objet

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

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

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

    Type de données : tableau d’objets

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

    Type de données : chaîne
    Résultat.Éléments.Erreurs.Message Un message d’erreur est survenu lors du traitement de ce CI.

    Type de données : chaîne
    résultat.éléments.identificationtentatives Liste des tentatives d’identification de ce CI.
    Type de données : tableau d’objets
    "identificationAttempts": [
  {
    "attemptResult": "String",
    "attributes": [Array],
    "hybridEntryCiAttributes": [Array],
    "identiferName": "String",
    "searchOnTable": [Array]
  }
]
    résultat.éléments.identificationtentatives.résultat. Résultat de cette tentative d’identification de CI.
    Valeurs possibles :
    • CORRESPONDANCE : identification réussie. Un CI unique a été trouvé dans la table de règles d’identificateur qui correspond exactement aux attributs spécifiés.
    • MULTI_MATCH : échec de l’identification avec une erreur. Des CI en double ont été trouvés dans la table des règles d’identificateur lors de la mise en correspondance avec les attributs spécifiés.
    • NO_MATCH : échec de l’identification. Aucun CI correspondant aux attributs spécifiés n’a été trouvé dans la table de règles d’identificateur.
    • IGNORÉ : identification non tentée. Les attributs requis pour cette recherche dans la table des règles d’identificateur n’étant pas fournis, la règle n’a donc pas été appliquée.

    Type de données : chaîne
    résultat.éléments.tentativesd’identification.attributs Liste des attributs d’entrée d’identificateur de CI utilisés au cours de cette tentative d’identification de CI.

    Type de données : tableau

    Les noms et les 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 de CI utilisés au cours de cette tentative d’identification de CI.

    Type de données : tableau

    Les noms et les 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
    résultat.éléments.identificationtentatives.rechercherOnTable 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"
  }
]
    résultat.é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 pour lequel la reclassification a été ignorée.

    Type de données : chaîne
    result.items.info.ruleSysId Sys_id de la règle de restriction de reclassification correspondante. Applicable uniquement lorsque IRE ignore la reclassification en raison 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
    résultats.éléments.indexentrées Liste des valeurs d’index pour les CI du tableau de corps items de la demande qui correspondent à ce CI.

    Type de données : tableau d’objets

    "inputIndices": [
  {
    Number
  }
]
    résultats.éléments.marqueurs Liste des valeurs du marqueur pour une utilisation interne.

    Type de données : tableau

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

    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.
    • MISE À JOUR : un CI existant dans la table cible est mis à jour.
    • UPDATE_WITH_DOWNGRADE : un CI existant dans la table cible est mis à jour et sa classe est remplacée par une classe plus générique (classe ancêtre).
    • UPDATE_WITH_SWITCH : un CI existant dans la table cible est mis à jour et sa classe est remplacée par une autre classe qui n’est pas une classe ancêtres ou descendantes.
    • 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
    résultat.éléments.élémentsconnexes Liste des CI associés (CI de recherche de table) à partir du tableau de 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 Le sys_class_name de l’élément connexe.

    Type de données : chaîne
    résultats.éléments.élémentsconnexes.indexentrées 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 associé.

    Type de données : tableau d’objets

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

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

    Type de données : nombre
    résultat.éléments.élémentsconnexes.marqueurs Liste des valeurs du marqueur pour une utilisation interne.

    Type de données : tableau

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

    Type de données : tableau

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

    Type de données : tableau

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

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

    Type de données : tableau d’objets

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    Résultat.Éléments.Avertissements.Erreur Type d’avertissement rencontré lors du traitement de ce CI.

    Type de données : chaîne
    Résultat.Éléments.Avertissements.Message Message d’avertissement rencontré lors du traitement de ce CI.

    Type de données : chaîne
    résultat.logContextId ID de contexte signalé pour cette charge utile.

    Type de données : chaîne
    résultat.relations Liste des CI de relation dépendante du tableau de corps relations de la demande.

    Type de données : tableau d’objets

    "relations": [
  {
    "className": "String",
    "errorCount": Number,
    "errors": [Array],
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloadIds": [Array],
    "operation": "String",
    "warnings": [Array]
  }
]
    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é lors du traitement de ce CI de relation dépendante.

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

    Type de données : tableau

    "inputIndices": [
  Number
]
    résultat.relations.marqueurs Liste des valeurs du marqueur pour une utilisation interne.

    Type de données : tableau

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

    Type de données : tableau

    "mergedPayloadIds": [
  "String"
]
    résultat.relations.opération Opération exécutée pour ce CI de relation dé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 a connu des erreurs et a été inséré dans la table Charges utiles incomplètes IRE CMDB [cmdb_ire_incomplete_payloads].
    • INSERT_AS_PARTIAL : CI de relation dépendante a connu des erreurs et a été inséré dans la table Charges utiles partielles IRE CMDB [cmdb_ire_partial_payloads].
    • NO_CHANGE : aucune opération n’a été effectuée pour le CI de relation dépendante.
    • MISE À JOUR : un CI de relation dépendante existant dans la table cible a été mis à jour.

    Type de données : chaîne
    résultat.relations.avertissements Liste des avertissements rencontrés lors du traitement de ce CI de relation dépendante.

    Type de données : tableau d’objets

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    Résultat.Relations.Avertissements.Erreur Type d’avertissement rencontré lors du traitement de ce CI de relation dépendante.

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

    Type de données : chaîne

    Demande cURL

    Simulez la soumission d’une charge utile contenant un serveur Linux (avec des recherches d’éléments connexes de numéro de série et 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 règle matérielle, recherchez son nom dans la table Matériel [cmdb_ci_hardware] et est traité comme une mise à jour d’un CI existant dans la table Serveur Linux [cmdb_ci_linux_server]. Le commutateur IP est identifié de la même manière via une règle matérielle, recherchez son nom dans la table Matériel et met à jour un CI existant dans la table Commutateur IP [cmdb_ci_ip_switch]. Enfin, la relation de connexion IP entre le serveur et le commutateur est insérée en tant que nouvel enregistrement dans la table 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 (insérer/mettre à jour) à effectuer avec la charge utile spécifiée (corps de la demande), sans valider les opérations dans la base de données.

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

    Cette méthode est similaire à la Identification et réconciliation : PUBLIER /now/identifyreconcile/query méthode, mais ajoute les fonctionnalités suivantes :
    • Charges utiles partielles
      • Si un élément présente un avertissement ou une erreur, indique si une opération d’élément est INSERT_AS_PARTIAL ou INSERT_INCOMPLETE.
      • Renvoie le sys_ids des charges utiles partielles qui ont été fusionnées avec des charges utiles partielles existantes.
    • Prend en charge la fonctionnalité de déduplication de la charge utile.
    • Génère un résumé.

    Format d'URL

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

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

    Remarque :
    Les versions disponibles sont spécifiées dans l’explorateur d’API REST. Pour les API REST basées sur un script, des informations de version supplémentaires sont disponibles sur le formulaire Service REST scripté.

    Paramètres de demande pris en charge

    Tableau 19. Paramètres de chemin d'accès
    Nom Description
    api_version Facultatif. Version du point de terminaison auquel accéder. Par exemple, v1 ou v2. Spécifiez uniquement cette valeur pour utiliser une version de point de terminaison différente de la dernière.

    Type de données : chaîne
    Tableau 20. Paramètres de requête
    Nom Description
    options Liste de paires nom-valeur séparées par des virgules représentant les options IRE améliorées appliquées à la demande.

    Par exemple, pour remplacer les valeurs par défaut des charges utiles partielles, des validations partielles, dédupliquer les charges utiles et générer des options IRE améliorées de synthèse :

    partial_payloads :faux,partial_commits :faux,deduplicate_payloads :faux,generate_summary :vrai
    Remarque :
    Par défaut ou si partial_payloads est défini sur true, les deux partial_commits et deduplicate_payloads sont activés, même s’ils sont définis sur false, car ces fonctionnalités sont essentielles pour la fonctionnalité de charges utiles partielles.

    Pour en savoir plus sur les options IRE améliorées, consultez Moteur IRE (moteur Identification et rapprochement).

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

    Type de données : chaîne
    sysparm_data_source Source des informations sur le CI. Il doit s’agir de l’une des valeurs de choix définies pour le champ discovery_source de la table Élément de configuration [cmdb_ci].

    Type de données : chaîne

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

    Type de données : tableau d’objets

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

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

    Type de données : chaîne
    Recherche.Éléments Tableau d’objets dans lequel chaque objet décrit un enregistrement d’identification basé sur la recherche. Ces enregistrements sont utilisés pour identifier l’élément de configuration de niveau supérieur en fonction d’une table de recherche qui fait référence à la table Élément de configuration [cmdb_ci].

    Type de données : Tableau hors objets

    "lookup": [
  {
    "className": "String",
    "internal_id": "String",
    "sys_object_source_info": {Object},
    "values": {Object}
  }
]
    items.lookup.className Requis. Le nom de sys_class_name ou de classe/table du CI à créer ou à mettre à jour. Cette valeur peut être n’importe quelle CMDB classe/table, telle que cmdb_serial_number ou cmdb_ci_network_adapter, ou une classe nonCMDB hiérarchique.

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

    Type de données : chaîne
    items.lookup.sys_object_source_info Objet décrivant un identificateur de CI unique pour une source de données spécifiée. Différentes sources peuvent avoir des paires nom-valeur différentes pour le même CI.

    Type de données : objet

    "sys_object_source_info": {
  "source_feed": "String",
  "source_name": "String",  
  "source_native_key": "String",
  "source_recency_timestamp": "String"
}
    items.lookup.sys_object_source_info.source_feed Nom qui identifie de manière unique le flux qui envoie ce CI. À utiliser si la source peut avoir plusieurs flux.

    Type de données : chaîne
    items.lookup.sys_info_source_objet.nom_source Source de données des informations sur le CI. Cette valeur doit être l’une des valeurs de choix définies pour le champ discovery_source de la table Élément de configuration [cmdb_ci].

    Type de données : chaîne
    items.lookup.sys_object_source_info.source_native_key Clé/ID unique de la source pour le CI. Peut être n’importe quelle chaîne unique à l’élément.

    Type de données : chaîne
    items.lookup.sys_object_source_info.source_recency_timestamp Date et heure UTC auxquelles le CI a été analysé.

    Type de données : chaîne

    Format : JJ-MM-AAAA hh :mm :ss
    éléments.recherche.valeurs Objet décrivant les champs de cet élément de recherche sous forme de paires nom/valeur, où le nom est le nom du champ.

    Type de données : objet

    Les noms et 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 le type d’enregistrements qui peuvent se trouver 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 être 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 de CI unique pour une source de données spécifiée. Différentes sources peuvent avoir des paires nom-valeur différentes pour le même CI.

    Type de données : objet

    "sys_object_source_info": {
  "source_feed": "String",
  "source_name": "String",  
  "source_native_key": "String",
  "source_recency_timestamp": "String"
}
    items.related.sys_object_source_info.source_feed Nom qui identifie de manière unique le flux à l’origine de cet élément associé. À utiliser si la source peut avoir plusieurs flux.

    Type de données : chaîne
    items.related.sys_info_source_objet.nom_source Source de données pour les informations sur l’élément connexe. Cette valeur doit être l’une des valeurs de choix définies pour le champ discovery_source de la table Élément de configuration [cmdb_ci].

    Type de données : chaîne
    items.related.sys_object_source_info.source_native_key Clé/ID unique de la source pour l’élément connexe. Peut être n’importe quelle chaîne unique à l’élément.

    Type de données : chaîne
    items.related.sys_object_source_info.source_recency_timestamp Date et heure UTC auxquelles l’élément connexe a été analysé.

    Type de données : chaîne

    Format : JJ-MM-AAAA hh :mm :ss
    éléments.valeurs.connexes Objet décrivant les champs à créer ou mettre à jour pour cet élément associé 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.paramètres Objet contenant les paramètres définissant les types de mises à jour autorisés.

    Type de données : objet

    "settings": {
  "skipReclassificationRestrictionRules": Boolean,
  "updateWithoutDowngrade": Boolean,
  "updateWithoutSwitch": Boolean,
  "updateWithoutUpgrade": Boolean
}
    items.settings.skipReclassificationRestrictionRules Marqueur indiquant si IRE doit ignorer l’exécution de la règle de restriction de reclassification qui correspond à la classe de l’élément de charge utile.
    Valeurs valides :
    • vrai : ignorer l’exécution de la règle.
    • faux : exécutez la règle.

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

    Type de données : booléennes

    Valeur par défaut : false
    items.settings.updateWithoutSwitch Marqueur indiquant si ce CI peut être mis à jour et si sa classe peut être changée.
    Valeurs valides :
    • vrai : mettre à jour l’élément, mais le changement de classe n’est pas autorisé.
    • false : la mise à jour d’un objet 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 toutes deux autorisées pour ce CI.
    Valeurs valides :
    • vrai : mettre à jour l’élément, mais la mise à niveau n’est pas autorisée.
    • false : la mise à jour et la mise à niveau de l’élément sont autorisées.

    Type de données : booléennes

    Valeur par défaut : false
    items.sys_objet_source_info Objet décrivant un identificateur de CI unique.

    Type de données : objet

    "sys_object_source_info": {
  "source_feed": "String",
  "source_name": "String",  
  "source_native_key": "String",
  "source_recency_timestamp": "String"
}
    items.sys_object_source_info.source_feed Nom qui identifie de manière unique le flux qui envoie ce CI. À utiliser si la source peut avoir plusieurs flux.

    Type de données : chaîne
    nom_source items.sys_objet_source_nom_source Source de données des informations sur le CI. Cette valeur doit être l’une des valeurs de choix définies pour le champ discovery_source de la table Élément de configuration [cmdb_ci].

    Type de données : chaîne
    items.sys_object_source_info.source_native_key Clé/ID unique de la source pour le CI. Peut être n’importe quelle chaîne unique à l’élément.

    Type de données : chaîne
    items.sys_object_source_info.source_recency_timestamp Date et heure UTC auxquelles le CI a été analysé.

    Type de données : chaîne

    Format : 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. Les valeurs de chaque élément de référence sont renseignées avant d’identifier un CI à l’aide des règles IRE définies sur une classe.

    Type de données : tableau d’objets

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

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

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

    Type de données : chaîne
    Relations Liste des relations entre deux éléments définis dans la charge utile.
    Un objet de ce tableau peut utiliser l’un des deux formats suivants :
    • L’objet peut définir une relation entre deux éléments de niveau supérieur (uniquement) à l’aide parent des paires nom-valeur et child avec des valeurs représentant les index d’éléments du tableau de charge items utile.
    • L’objet peut définir une relation entre deux éléments quelconques, y compris les éléments de niveau supérieur, associés ou de recherche, à l’aide parent_id de paires clé/valeur et child_id avec des valeurs représentant internal_id les valeurs définies pour ces éléments.

    Type de données : tableau d’objets

    "relations": [
  {
    "child": Number,
    "parent": Number,
    "sys_rel_source_info": {Object},
    "type": "String"
  }
]
    "relations": [
  {
    "child_id": "String",
    "parent_id": "String",
    "sys_rel_source_info": {Object},
    "type": "String"
  }
]
    relations.enfant Index entier de l’objet CI dans le items tableau qui représente l’enfant dans la relation.

    Type de données : nombre
    relations.child_id L’élément internal_id enfant dans la relation.

    Type de données : chaîne
    relations.parent Index entier de l’objet CI dans le items tableau qui représente le parent dans la relation.

    Type de données : nombre
    relations.parent_id L’élément internal_id parent dans la relation.

    Type de données : chaîne
    relations.sys_rel_source_info Informations sur la source de découverte pour la relation. Pour les relations de non-dépendance, ces informations figurent dans la table Sources de relation [sys_rel_source].

    Type de données : objet

    "sys_rel_source_info": { 
  "source_name": "String", 
  "source_feed": "String" 
}
    relations.sys_rel_source_info.nom_source Nom de la source de découverte.

    Par défaut : source de découverte transmise dans le paramètre de méthode API.
    relations.sys_rel_source_info.source_feed Toute chaîne qui est une sous-découverte/analyse dans la source de découverte.

    Par défaut : « INCONNU » est stocké dans la colonne source_feed lors de la création d’un enregistrement dans sys_rel_source table.
    relations.type Type de relation existant entre les éléments parent et enfant. Il doit s’agir d’une valeur de champ de nom de la table Type de relation CI [cmdb_rel_type].

    Type de données : chaîne

    En-têtes

    Les en-têtes de demande et de réponse suivants s'appliquent à 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.

    Détails du message d’erreur « Le bloc [...] n’est pas une entrée valide » indique que le paramètre de options requête n’est pas dans le format de paire nom-valeur correct.

    Par exemple, la spécification d’un options paramètre de partiel produit un code d’état 500 avec « Chunk [partial] n’est pas une entrée valide » dans le détail du message.

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

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

    Type de données : tableau

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

    Type de données : tableau d’objets

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

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

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

    Type de données : tableau d’objets

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

    Type de données : chaîne
    result.additionalCommittedItems.errors.message Message d’erreur rencontré lors du traitement de ce CI supplémentaire.

    Type de données : chaîne
    résultat.additionalCommittedItems.identificationAttempts Liste des tentatives effectuées pour identifier ce CI supplémentaire.
    Type de données : tableau d’objets
    "identificationAttempts": [
  {
    "attemptResult": "String",
    "attributes": [Array],
    "hybridEntryCiAttributes": [Array],
    "identiferName": "String",
    "searchOnTable": [Array]
  }
]
    résultat.élémentssupplémentairescommis.tentatives.tentatives.résultat Résultat de cette tentative d’identification de CI supplémentaire.
    Valeurs possibles :
    • CORRESPONDANCE : identification réussie. Un CI unique a été trouvé dans la table de règles d’identificateur qui correspond exactement aux attributs spécifiés.
    • MULTI_MATCH : échec de l’identification avec une erreur. Des CI en double ont été trouvés dans la table des règles d’identificateur lors de la mise en correspondance avec les attributs spécifiés.
    • NO_MATCH : échec de l’identification. Aucun CI correspondant aux attributs spécifiés n’a été trouvé dans la table de règles d’identificateur.
    • IGNORÉ : identification non tentée. Les attributs requis pour cette recherche dans la table des règles d’identificateur n’étant pas fournis, la règle n’a donc pas été appliquée.

    Type de données : chaîne
    résultat.élémentssupplémentairesValidés.identificationTentatives.attributs Tableau des attributs d’entrée d’identificateur de CI utilisés au cours de cette tentative d’identification de CI supplémentaire.

    Type de données : tableau

    Les noms et les 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 les 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
    résultat.additionalCommittedItems.identificationAttempts.searchOnTable Nom de la table recherchée pour cette tentative d’identification de CI supplémentaire.

    Type de données : chaîne
    result.additionalCommittedItems.identifierEntrySysId Sys_id de la règle d’identificateur utilisée pour identifier ce CI supplémentaire.
    Valeurs notables :
    • Inconnu : échec de l’identification de ce CI supplémentaire. Consultez errors pour en savoir plus.

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

    Type de données : tableau d’objets

    "inputIndices": [
  {
    Number
  }
]
    résultat.additionalCommittedItems.markers Liste des valeurs du marqueur pour une utilisation interne.

    Type de données : tableau

    "markers": []
    résultat.additionalCommittedItems.mergedPayloads Liste des valeurs de sys_id des charges utiles partielles de la table Charges utiles partielles IRE CMDB [cmdb_ire_partial_payloads] qui ont été fusionnées pendant le traitement de ce CI supplémentaire.

    Type de données : tableau

    "mergedPayloadIds": [
  "String"
]
    résultat.élémentsCommitted.supplémentaires Opération exécutée pour ce CI supplémentaire.
    Valeurs possibles :
    • DELETE : un CI existant est supprimé de la table cible.
    • INSERT : le CI supplémentaire est inséré dans la table cible en tant que nouvel enregistrement.
    • NO_CHANGE : aucune opération n’est effectuée pour le CI supplémentaire.
    • MISE À JOUR : un CI existant dans la table cible est mis à jour.
    • UPDATE_WITH_DOWNGRADE : un CI existant dans la table cible est mis à jour et sa classe est remplacée par une classe plus générique (classe ancêtre).
    • UPDATE_WITH_SWITCH : un CI existant dans la table cible est mis à jour et sa classe est remplacée par une autre classe qui n’est pas une classe ancêtres ou descendantes.
    • 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.élémentsCommitted.avertissements Liste des avertissements rencontrés lors du traitement de ce CI supplémentaire.

    Type de données : tableau d’objets

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

    Type de données : chaîne
    résultat.élémentssupplémentairesengagés.avertissements.message Message d’avertissement rencontré lors du traitement de ce CI supplémentaire.

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

    Type de données : tableau d’objets

    "additionalCommittedRelations": [
  {
    "className": "String",
    "operation": "String",
    "markers": [Array],
    "inputIndices": [Array],
    "mergedPayloadIds": [Array]
  }
]
    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
    résultat.relationscommisessupplémentaires.errorCount Nombre d’erreurs rencontrées lors du traitement de ce CI de relation dépendante supplémentaire.

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

    Type de données : tableau d’objets

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

    Type de données : chaîne
    résultat.relations.commisessupplémentaires.erreurs.message Un message d’erreur est survenu lors du traitement de ce CI de relation dépendante supplémentaire.

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

    Type de données : tableau

    "inputIndices": [
  Number
]
    résultat.relationsengagementsupplémentaires.marqueurs Liste des valeurs du marqueur pour une utilisation interne.

    Type de données : tableau

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

    Type de données : tableau

    "mergedPayloadIds": [
  "String"
]
    résultat.relations.engagementsupplémentaires.opération Opération exécutée pour ce CI de relation dépendante supplémentaire.
    Valeurs possibles :
    • INSÉRER : le CI de relation dépendante est inséré dans la table cible en tant que nouvel enregistrement.
    • INSERT_AS_INCOMPLETE : CI de relation dépendante comportait des erreurs et est inséré dans la table Charges utiles incomplètes IRE CMDB [cmdb_ire_incomplete_payloads].
    • INSERT_AS_PARTIAL : CI de relation dépendante a connu des erreurs et est inséré dans la table Charges utiles partielles IRE CMDB [cmdb_ire_partial_payloads].
    • NO_CHANGE : aucune opération n’est effectuée pour le CI de relation dépendant.
    • MISE À JOUR : un CI de relation dépendante existant dans la table cible est mis à jour.

    Type de données : chaîne
    résultats.éléments Liste des CI inclus dans le tableau de corps items de la demande.

    Type de données : tableau d’objets

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

    Type de données : tableau d’objets

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

    Type de données : chaîne
    résultat.éléments.élémentsconnexes supplémentaires.index_entrée Liste des valeurs d’index pour les CI du tableau de corps items de la demande qui correspondent à cet élément associé.

    Type de données : tableau

    "inputIndices": [
    Number
]
    résultats.éléments.supplémentairesÉlémentsliés.marqueurs Liste des valeurs du marqueur pour une utilisation interne.

    Type de données : tableau

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

    Type de données : tableau

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

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

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

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

    Type de données : objet

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

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

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

    Type de données : tableau d’objets

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

    Type de données : chaîne
    Résultat.Éléments.Erreurs.Message Un message d’erreur est survenu lors du traitement de ce CI.

    Type de données : chaîne
    résultat.éléments.identificationtentatives Liste des tentatives d’identification de ce CI.
    Type de données : tableau d’objets
    "identificationAttempts": [
  {
    "attemptResult": "String",
    "attributes": [Array],
    "hybridEntryCiAttributes": [Array],
    "identiferName": "String",
    "searchOnTable": [Array]
  }
]
    résultat.éléments.identificationtentatives.résultat. Résultat de cette tentative d’identification de CI.
    Valeurs possibles :
    • CORRESPONDANCE : identification réussie. Un CI unique a été trouvé dans la table de règles d’identificateur qui correspond exactement aux attributs spécifiés.
    • MULTI_MATCH : échec de l’identification avec une erreur. Des CI en double ont été trouvés dans la table des règles d’identificateur lors de la mise en correspondance avec les attributs spécifiés.
    • NO_MATCH : échec de l’identification. Aucun CI correspondant aux attributs spécifiés n’a été trouvé dans la table de règles d’identificateur.
    • IGNORÉ : identification non tentée. Les attributs requis pour cette recherche dans la table des règles d’identificateur n’étant pas fournis, la règle n’a donc pas été appliquée.

    Type de données : chaîne
    résultat.éléments.tentativesd’identification.attributs Liste des attributs d’entrée d’identificateur de CI utilisés au cours de cette tentative d’identification de CI.

    Type de données : tableau

    Les noms et les 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 de CI utilisés au cours de cette tentative d’identification de CI.

    Type de données : tableau

    Les noms et les 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
    résultat.éléments.identificationtentatives.rechercherOnTable 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"
  }
]
    résultat.é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 pour lequel la reclassification a été ignorée.

    Type de données : chaîne
    result.items.info.ruleSysId Sys_id de la règle de restriction de reclassification correspondante. Applicable uniquement lorsque IRE ignore la reclassification en raison 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
    résultats.éléments.indexentrées Liste des valeurs d’index pour les CI du tableau de corps items de la demande qui correspondent à ce CI.

    Type de données : tableau d’objets

    "inputIndices": [
  {
    Number
  }
]
    résultats.éléments.marqueurs Liste des valeurs du marqueur pour une utilisation interne.

    Type de données : tableau

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

    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.
    • MISE À JOUR : un CI existant dans la table cible est mis à jour.
    • UPDATE_WITH_DOWNGRADE : un CI existant dans la table cible est mis à jour et sa classe est remplacée par une classe plus générique (classe ancêtre).
    • UPDATE_WITH_SWITCH : un CI existant dans la table cible est mis à jour et sa classe est remplacée par une autre classe qui n’est pas une classe ancêtres ou descendantes.
    • 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
    résultat.éléments.élémentsconnexes Liste des CI associés (CI de recherche de table) à partir du tableau de 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 Le sys_class_name de l’élément connexe.

    Type de données : chaîne
    résultats.éléments.élémentsconnexes.indexentrées 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 associé.

    Type de données : tableau d’objets

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

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

    Type de données : nombre
    résultat.éléments.élémentsconnexes.marqueurs Liste des valeurs du marqueur pour une utilisation interne.

    Type de données : tableau

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

    Type de données : tableau

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

    Type de données : tableau

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

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

    Type de données : tableau d’objets

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    Résultat.Éléments.Avertissements.Erreur Type d’avertissement rencontré lors du traitement de ce CI.

    Type de données : chaîne
    Résultat.Éléments.Avertissements.Message Message d’avertissement rencontré lors du traitement de ce CI.

    Type de données : chaîne
    résultat.logContextId ID de contexte signalé pour cette charge utile.

    Type de données : chaîne
    résultat.relations Liste des CI de relation dépendante du tableau de corps relations de la demande.

    Type de données : tableau d’objets

    "relations": [
  {
    "className": "String",
    "errorCount": Number,
    "errors": [Array],
    "inputIndices": [Array],
    "markers": [Array],
    "mergedPayloadIds": [Array],
    "operation": "String",
    "warnings": [Array]
  }
]
    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é lors du traitement de ce CI de relation dépendante.

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

    Type de données : tableau

    "inputIndices": [
  Number
]
    résultat.relations.marqueurs Liste des valeurs du marqueur pour une utilisation interne.

    Type de données : tableau

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

    Type de données : tableau

    "mergedPayloadIds": [
  "String"
]
    résultat.relations.opération Opération exécutée pour ce CI de relation dé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 a connu des erreurs et a été inséré dans la table Charges utiles incomplètes IRE CMDB [cmdb_ire_incomplete_payloads].
    • INSERT_AS_PARTIAL : CI de relation dépendante a connu des erreurs et a été inséré dans la table Charges utiles partielles IRE CMDB [cmdb_ire_partial_payloads].
    • NO_CHANGE : aucune opération n’a été effectuée pour le CI de relation dépendante.
    • MISE À JOUR : un CI de relation dépendante existant dans la table cible a été mis à jour.

    Type de données : chaîne
    résultat.relations.avertissements Liste des avertissements rencontrés lors du traitement de ce CI de relation dépendante.

    Type de données : tableau d’objets

    "warnings": [
  {
    "error": "String",
    "message": "String"
  }
]
    Résultat.Relations.Avertissements.Erreur Type d’avertissement rencontré lors du traitement de ce CI de relation dépendante.

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

    Type de données : chaîne

    Demande cURL

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

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

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

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

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

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

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

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