StartDiscovery : global

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 2 minutes de lecture

    • L’API StartDiscovery fournit des méthodes pour démarrer les tâches de détection.

    Utilisez cette API pendant la phase d’analyse de détection.

    StartDiscovery : addAdditionalIP(état de la chaîne, adresse IP de chaîne, capteur de chaîne)

    Ajoute une adresse IP (ou une liste d’adresses IP séparées par des virgules) à une détection existante (utilisée par la détection de réseaux).

    Tableau 1. Paramètres
    Nom Type Description
    statut Chaîne État de détection
    ip Chaîne Une adresse IP ou une liste d’adresses IP séparées par des virgules.
    Capteur Chaîne Le capteur de détection
    Tableau 2. Renvoie
    Type Description
    nul

    StartDiscovery : discoverFromSchedule(String ip, booléen samePhase, String sensor)

    Gère la détection des appareils (de base ou avancé) à partir d’un calendrier.

    Tableau 3. Paramètres
    Nom Type Description
    ip Chaîne Une adresse IP ou une liste d’adresses IP séparées par des virgules.
    La même phase Booléen
    Capteur Chaîne Le capteur de détection
    Tableau 4. Renvoie
    Type Description
    nul

    StartDiscovery : getCancelScript()

    Renvoie le script d’annulation.

    Tableau 5. Paramètres
    Nom Type Description
    Aucun
    Tableau 6. Renvoie
    Type Description
    Chaîne Le script d’annulation

    StartDiscovery : scheduleCancelJob()

    Si le calendrier spécifie une heure d’annulation, le cas échéant, planifie une tâche pour annuler la détection.

    Tableau 7. Paramètres
    Nom Type Description
    Aucun
    Tableau 8. Renvoie
    Type Description
    nul

    L’exemple suivant montre comment utiliser la méthode scheduleCancelJob() pour annuler une tâche de détection actuelle.

    var discoveryScheduleGR = new GlideRecord('discovery_schedule'); // Create a discovery schedule Gliderecord
discoveryScheduleGR.get('name', 'Disco'); // Put the discovery schedule job name

var discoverySchedule = new DiscoverySchedule(discoveryScheduleGR); 
var discoveryStatusSysId = new StartDiscovery().startFromIP(discoverySchedule, '172.167.31.231'); // Initiate discovery
gs.info(discoveryStatusSysId); // Display the sys_id of the discovery status record

discoveryStatusSysId.scheduleCancelJob(); // Schedule a cancel job, located in the sys_trigger table

    Sortie :

    Operation	Table		Row Count
insert		discovery_result	1
update		discovery_status	1
insert		sys_trigger	     1
insert		discovery_status	1
*** Script: Fired started event for: undefined Disco
*** Script: Scheduling Discovery DIS0010023 for cancellation at 2022-02-13 16:42:44
*** Script: 1828b05f1b6d811070cb96c6b04bcb53

    StartDiscovery : startFromIP(calendrier DiscoverySchedule, chaîne ip)

    Démarre une détection pour une seule adresse IP à l’aide du calendrier spécifié pour obtenir des informations telles que les MID Servers et les comportements.

    Tableau 9. Paramètres
    Nom Type Description
    schedule Calendrier de détection Instance DiscoverySchedule pour le calendrier à utiliser.
    ip Chaîne Adresse IP à détecter.

    Format : chaîne au format à points
    Tableau 10. Renvoie
    Type Description
    Chaîne Sys_id de l’enregistrement d’état créé.

    Cet exemple utilise la méthode startFromIP() pour obtenir l’enregistrement qui contient les informations de détection.

    // Get a discovery schedule gliderecord
var discoveryScheduleGR = new GlideRecord('discovery_schedule'); 
discoveryScheduleGR.get('name', 'Discover Management Range 172.x.x.x');

// Create a DiscoverySchedule object to get information such as MID servers and behaviors
var discoverySchedule = new DiscoverySchedule(discoveryScheduleGR); 
var discoveryStatusSysId = new StartDiscovery().startFromIP(discoverySchedule, '172.1.1.10');
 
// Sys_id of the genterated status record
gs.info(discoveryStatusSysId);

    Sortie :

    9d3c1197c611228701cd1d94bc32d76d

    StartDiscovery : startFromSchedule (planification GlideRecord, tâche GlideRecord)

    Invoqué par le script include de détection pour lancer une détection planifiée (ou détecter maintenant).

    Tableau 11. Paramètres
    Nom Type Description
    schedule GlideRecord Instance de discovery_schedule sur laquelle cette détection est basée.
    tâche GlideRecord L’instance de sys_trigger qui a déclenché cette détection.
    Tableau 12. Renvoie
    Type Description
    nul