---
sourceDocument: Referência de API do Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Referência de API do Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# StartDiscovery - Global

# StartDiscovery - Global {#ariaid-title1}

* Versão de lançamento: Xanadu
* 
* Atualizado 1 de ago. de 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 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) {#ariaid-title2}

Adiciona um IP (ou lista separada por vírgulas de IPs) a uma descoberta existente (usada pela descoberta de redes).
{#r_SDY-addAdditionalIP_S_S_S__table_zdv_1dv_tt__entry__3}

| 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 1. Parâmetros]

{#r_SDY-addAdditionalIP_S_S_S__table_zdv_1dv_tt} {#r_SDY-addAdditionalIP_S_S_S__table_a2v_1dv_tt__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 2. Retorna]

{#r_SDY-addAdditionalIP_S_S_S__table_a2v_1dv_tt}

## StartDiscovery - discoveryFromSchedule (cadeia de caracteres ip, booliano samePhase, sensor de cadeia de caracteres) {#ariaid-title3}

Lida com a descoberta de dispositivos (básicos ou avançados) a partir de uma programação.
{#r_SDY-discoverFromSchedule_S_B_S__table_cq1_xdv_tt__entry__3}

| 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 3. Parâmetros]

{#r_SDY-discoverFromSchedule_S_B_S__table_cq1_xdv_tt} {#r_SDY-discoverFromSchedule_S_B_S__table_dq1_xdv_tt__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 4. Retorna]

{#r_SDY-discoverFromSchedule_S_B_S__table_dq1_xdv_tt}

## StartDiscovery -- getCancelScript() {#ariaid-title4}

Retorna o script de cancelamento.
{#r_SDY-getCancelScript__table_idb_t2v_tt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 5. Parâmetros]

{#r_SDY-getCancelScript__table_idb_t2v_tt} {#r_SDY-getCancelScript__table_jdb_t2v_tt__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | O script de cancelamento |
[Tabela 6. Retorna]

{#r_SDY-getCancelScript__table_jdb_t2v_tt}

## StartDiscovery -- scheduleCancelJob() {#ariaid-title5}

Se a programação especificar um horário de cancelamento, se necessário, programará um trabalho para cancelar a descoberta.
{#r_SDY-scheduleCancelJob__table_smg_l2v_tt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 7. Parâmetros]

{#r_SDY-scheduleCancelJob__table_smg_l2v_tt} {#r_SDY-scheduleCancelJob__table_tmg_l2v_tt__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 8. Retorna]

{#r_SDY-scheduleCancelJob__table_tmg_l2v_tt}  
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) {#ariaid-title6}

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

| 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 9. Parâmetros]

{#r_SDY-startFromIP_DS_S__table_elc_1cv_tt} {#r_SDY-startFromIP_DS_S__table_flc_1cv_tt__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | Sys_id do registro de status criado. |
[Tabela 10. Retorna]

{#r_SDY-startFromIP_DS_S__table_flc_1cv_tt}  
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) {#ariaid-title7}

Invocado pela inclusão de script de descoberta para iniciar uma descoberta programada (ou descobrir agora).
{#r_SDY-startFromSchedule_GR_GR__table_fgm_jbv_tt__entry__3}

| 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 11. Parâmetros]

{#r_SDY-startFromSchedule_GR_GR__table_fgm_jbv_tt} {#r_SDY-startFromSchedule_GR_GR__table_ggm_jbv_tt__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 12. Retorna]

{#r_SDY-startFromSchedule_GR_GR__table_ggm_jbv_tt}