StartDiscovery - Global

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 2 min. de leitura
  • A inclusão de script StartDiscovery fornece métodos para iniciar trabalhos de descoberta.

    Use esta inclusão de script durante a fase de verificação de descoberta.

    StartDiscovery - addAdditionalIP (Status da cadeia de caracteres, IP da cadeia de caracteres, Sensor da cadeia de caracteres)

    Adiciona um IP (ou lista separada por vírgulas de IPs) a uma descoberta existente (usada pela descoberta de redes).

    Tabela 1. Parâmetros
    Nome Tipo Descrição
    status Cadeia de caracteres O status da descoberta
    ip Cadeia de caracteres Um endereço IP ou uma lista separada por vírgulas de endereços IP.
    sensor Cadeia de caracteres O sensor de descoberta
    Tabela 2. Retornos
    Tipo Descrição
    vazio

    StartDiscovery - discoveryFromSchedule (cadeia de caracteres ip, booliano samePhase, sensor de cadeia de caracteres)

    Lida com a descoberta de dispositivos (básicos ou avançados) a partir de uma programação.

    Tabela 3. Parâmetros
    Nome Tipo Descrição
    ip Cadeia de caracteres Um endereço IP ou uma lista separada por vírgulas de endereços IP.
    samePhase Booliano
    sensor Cadeia de caracteres O sensor de descoberta
    Tabela 4. Retornos
    Tipo Descrição
    vazio

    StartDiscovery – getCancelScript()

    Retorna o script de cancelamento.

    Tabela 5. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 6. Retorna
    Tipo Descrição
    Cadeia de caracteres O script de cancelamento

    StartDiscovery – scheduleCancelJob()

    Se a programação especificar um horário de cancelamento, se necessário, programará um trabalho para cancelar a descoberta.

    Tabela 7. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 8. Retorna
    Tipo Descrição
    vazio

    O exemplo a seguir mostra como usar o método scheduleCancelJob() para cancelar um trabalho de descoberta atual.

    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
    

    Saída:

    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 (programação DiscoverySchedule, cadeia de caracteres IP)

    Inicia uma descoberta para um único IP usando a programação especificada para obter informações como MID servers e comportamentos.

    Tabela 9. Parâmetros
    Nome Tipo Descrição
    programação DiscoverySchedule Instância DiscoverySchedule para a programação usar.
    ip Cadeia de caracteres Endereço IP a ser descoberto.

    Formato: cadeia de caracteres formatada com pontos

    Tabela 10. Retornos
    Tipo Descrição
    Cadeia de caracteres Sys_id do registro de status criado.

    Este exemplo usa o método startFromIP() para obter o registro que contém as informações de descoberta.

    // 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);

    Saída:

    9d3c1197c611228701cd1d94bc32d76d

    StartDiscovery - startFromSchedule (programação GlideRecord, trabalho GlideRecord)

    Invocado pela inclusão de script de descoberta para iniciar uma descoberta programada (ou descobrir agora).

    Tabela 11. Parâmetros
    Nome Tipo Descrição
    programação GlideRecord A instância de discovery_schedule na qual esta descoberta se baseia.
    trabalho GlideRecord A instância de sys_trigger que acionou esta descoberta.
    Tabela 12. Retornos
    Tipo Descrição
    vazio