DiscoveryAPI : dans le champ d’application

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

    • La classe DiscoveryAPI fournit des méthodes qui lancent une détection rapide d’une adresse IPv4 unique et renvoient des résumés des statuts de détection précédemment lancés pour un seul élément de configuration (CI) ou pour tous les CI analysés.

    Cette classe s’exécute dans l’espace de noms sn_discovery .

    DiscoveryAPI : discoverIpAddress(String ipAddress, String application, String source)

    Détecte une adresse IPv4 spécifiée.

    Un MID Server est sélectionné automatiquement, en fonction de l'adresse IP fournie ou de l'application spécifiée.

    Tableau 1. Paramètres
    Nom Type Description
    l'application Chaîne Facultatif. Application configurée pour le Serveur MID.

    Pour définir un source paramètre mais pas un application paramètre, utilisez « NULL » comme espace réservé.

    Par défaut : découverte
    ipAddress Chaîne Adresse IP à détecter.
    source Chaîne Facultatif. Source de la découverte. Cette même valeur s’affiche dans le champ facultatif Source de l’enregistrement Statut de découverte, qui indique comment la découverte a été déclenchée.

    Par défaut : Discovery_API
    Tableau 2. Renvoie
    Type Description
    Chaîne Enregistrement du statut de découverte sys_id.
    Les exceptions suivantes peuvent être levées lors de la sélection de Serveur MID :
    • NoSuitableMidServerFoundException: aucun serveur MID approprié n’est disponible pour cette découverte
    • BadArgumentException: argument non valide détecté lors de la sélection de Serveur MID
    		 
    var sysid = sn_discovery.DiscoveryAPI.discoverIpAddress("11.23.125.39");

    DiscoveryAPI : reportCiIpAddressStatus(Objet ipAddress, objet discoveryStatusSysId)

    Utilisé pour renvoyer un résumé du statut de découverte d’un élément de configuration compte tenu de l’état spécifique sys_id et de l’adresse IPv4.

    Les exceptions suivantes peuvent être levées :
    • DiscoveryStatusNotFoundException: affiche ce message : Le statut de découverte avec l’ID système « < valeur non valide > » n’existe pas
    • DiscoveryDeviceHistoryNotFoundException: l’ID système de l’historique des appareils avec statut de découverte « < valeur non valide > » et ipAddress « < valeur non valide> » n’existent pas
    • IllegalArgumentException (arguments d’entrée non valides) : cette exception d’argument empêche les valeurs d’entrée d’être nulles.
      • L’ID système du statut de découverte ne peut pas être nul
      • ipAddress ne peut pas être nul
    • IllegalArgumentException (valeurs stockées dans la base de données) : Cette exception d’argument empêche que des données erronées soient renvoyées à l’appelant en cas de valeurs d’attribut incorrectes.
      • La propriété État du statut de découverte ne peut pas être nulle
      • La propriété « source » de l’historique des appareils ne peut pas être nulle
      • La propriété « problèmes » de l’historique de l’appareil n’est pas un entier : < valeur non valide >
      • La propriété « problèmes » de l’historique de l’appareil ne peut pas être inférieure à 0 : <valeur non valide>
    Tableau 3. Paramètres
    Nom Type Description
    ipAddress chaîne Adresse IPv4 analysée.
    discoveryStatusSysId chaîne Le sys_id de l’enregistrement du statut de découverte pour l’adresse IP qui a été analysée.
    Tableau 4. Renvoie
    Type Description
    tableau Tableau JavaScript d’objets ReportCiStatusOutputJS immuables. 
    var ipResultObj = sn_discovery.DiscoveryAPI.reportCiIpAddressStatus(ipAddress, discoveryStatus);

    DiscoveryAPI : reportCiStatus(Object discoveryStatusSysId)

    Utilisé pour renvoyer un résumé d’un statut de découverte CI compte tenu d’un sys_id de statut de découverte spécifique.

    Les exceptions suivantes peuvent être levées :
    • DiscoveryStatusNotFoundException: le statut de découverte avec l’ID système « < valeur non valide > » n’existe pas
    • DiscoveryDeviceHistoryNotFoundException: l’ID système de l’historique des appareils avec statut de découverte « < valeur non valide > » et ipAddress « < valeur non valide> » n’existent pas
    • IllegalArgumentException (arguments d’entrée non valides) : cette exception d’argument empêche les valeurs d’entrée d’être nulles.
      • L’ID système du statut de découverte ne peut pas être nul
      • ipAddress ne peut pas être nul
    • IllegalArgumentException (valeurs stockées dans la base de données) : Cette exception d’argument impose des conditions POST sur les valeurs d’accès à la base de données.
      • La propriété État du statut de découverte ne peut pas être nulle
      • La propriété « source » de l’historique des appareils ne peut pas être nulle
      • La propriété « problèmes » de l’historique de l’appareil n’est pas un entier : < valeur non valide >
      • La propriété « problèmes » de l’historique de l’appareil ne peut pas être inférieure à 0 : <valeur non valide>
    Tableau 5. Paramètres
    Nom Type Description
    sys_id chaîne La sys_id d’un enregistrement du statut de découverte.
    Tableau 6. Renvoie
    Type Description
    tableau Tableau JavaScript d’objets ReportCiStatusOutputJS immuables. 
    var ipResultObjArray = sn_discovery.DiscoveryAPI.reportCiStatus(discoveryStatus);
for(var idx=0; idx < ipResultObjArray.length; idx++) {    
var ipResultObj = ipResultObjArray[idx];