DiscoveryAPI : incluse dans le périmètre

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 3 minutes de lecture

    • La classe DiscoveryAPI fournit des méthodes qui lancent une découverte rapide d’une adresse IPv4 unique et renvoient des résumés des statuts de découverte 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 serveur MID 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 apparaît 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 d’un serveur MID :
    • NoSuitableMidServerFoundException: aucun serveur MID approprié n’est disponible pour cette découverte
    • BadArgumentException: argument non valide détecté pendant la sélection du 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 en fonction de l’état spécifique sys_id et de l’adresse IPv4.

    Les exceptions suivantes peuvent être lancées :
    • DiscoveryStatusNotFoundException: affiche ce message : Le statut de découverte avec l’ID système « < valeur non valide > » n’existe pas.
    • DiscoveryDeviceHistoryNotFoundException: l’historique des appareils avec l’ID système du statut de découverte « < valeur non valide > » et ipAddress « < valeur non valide > » n’existe 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 nombre entier : < valeur non valide >
      • La propriété « problèmes » de l’historique des appareils 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 L’sys_id de l’enregistrement du statut de découverte de l’adresse IP analysée.
    Tableau 4. Renvoie
    Type Description
    tableau Tableau JavaScript d’objets ReportCiStatusOutputJS immuables. 
    var ipResultObj = sn_discovery.DiscoveryAPI.reportCiIpAddressStatus(ipAddress, discoveryStatus);

    DiscoveryAPI : reportCiStatus(Objet discoveryStatusSysId)

    Utilisé pour renvoyer un résumé d’un statut de découverte de CI en fonction d’une sys_id de statut de découverte spécifique.

    Les exceptions suivantes peuvent être lancées :
    • DiscoveryStatusNotFoundException: le statut de découverte avec l’ID système « < valeur non valide > » n’existe pas
    • DiscoveryDeviceHistoryNotFoundException: l’historique des appareils avec l’ID système du statut de découverte « < valeur non valide > » et ipAddress « < valeur non valide > » n’existe 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 aux 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 nombre entier : < valeur non valide >
      • La propriété « problèmes » de l’historique des appareils ne peut pas être inférieure à 0 : <valeur non valide>
    Tableau 5. Paramètres
    Nom Type Description
    sys_id chaîne sys_id d’un enregistrement de 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];