---
sourceDocument: Gestion des opérations IT Australie
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/it-operations-management

 Release :

    - australia

ft:locale :

    - fr-FR

ft:publication_title :

    - Gestion des opérations IT Australie

ft:clusterId :

    - itom

bundleId :

    - itom

workflow :

    - Technology


---

# Vérifier que l'API est associée à un agent actif

# Vérifier que l'API est associée à un agent actif {#ariaid-title1}

* Rversion finale: Australia
* 
* Mis à jour 12 mars 2026
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute de lecture

Appelez l'API AgentNowHandler.hasAgent pour déterminer si le CI est associé à un agent actif. L'API obtient une sys_id du CI et renvoie un résultat vrai/faux.
La méthode hasAgent() prend une sys_id du CI en tant que paramètre de chaîne et renvoie la valeur true lorsque le CI remplit l'une des conditions suivantes :

* Le CI est `sn_agent_cmdb_ci_agent` et cet agent est en cours d'exécution.
* Le CI est un hôte (étend `cmdb_ci_hardware`) et est associé à un agent actif.
* Le CI est une application (étend `cmdb_ci_appl`) et a une relation d'exécution à un hôte associé à un agent actif.

{#acc-api-live-agent__ul_yvz_tsg_3kb}

Par exemple :

    var agentNow = new sn_agent.AgentNowHandler(); 
    gs.info('Agent assocation with CI? ' + 
    agentNow.hasAgent('158279505372b30034b8ddeeff7b1270'); // sys_id of agent