Module d’extension de l’API de découverte

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 1 minute de lecture
  • Le module d’extension de l’API Découverte, qui fournit des API pour les applications incluses dans le périmètre, est chargé lorsque le module d’extension Découverte est activé.

    Des détails sur ces méthodes d’API de découverte sont disponibles sur le site .ServiceNow® Site Developer Ils sont répertoriés ici par classe.
    Remarque :
    Les méthodes d’API Java ne sont pas personnalisables.
    DiscoveryAPI : incluse dans le périmètre
    Les méthodes de cette classe 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 CI unique ou pour tous les CI analysés. Un serveur MID est sélectionné automatiquement, en fonction de l’adresse IP fournie ou de l’application spécifiée.
    • discoverIpAddress(): détecte une adresse IPv4 unique.
    • reportCiIpAddressStatus(): renvoie 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.
    • reportCiStatus(): renvoie un résumé d’un statut de découverte de CI en fonction d’un sys_id de statut de découverte spécifique.
    ReportCiStatusOutputJS
    Les méthodes sont des getters qui renvoient des propriétés d’objet spécifiques pour la méthode DiscoveryAPI reportCiIpAddressStatus , puis convertissent les informations en une chaîne JSON.
    • getCiOperationStatus(): utilisé pour renvoyer l’état du CI analysé.
    • getCmdbCI(): utilisé pour renvoyer la valeur du champ cmdb_ci de la table discovery_device_history pour le CI analysé.
    • getDiscoveryState(): utilisé pour renvoyer la valeur du champ État dans la table Statut de découverte [discovery_status].
    • getIpAddress(): utilisé pour renvoyer la valeur du champ source dans la table discovery_device_history pour le CI analysé.
    • getIssues(): utilisé pour renvoyer la valeur du champ Problèmes de la table discovery_device_history pour le CI analysé.
    • getIssuesLink(): utilisé pour renvoyer la valeur du champ issues_link dans la table discovery_device_history pour le CI analysé.
    • toJson(): utilisé pour sérialiser l’objet ReportCiStatusOutputJS .