---
sourceDocument: Xanadu IT Operations Management
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/xanadu/it-operations-management

 Release :

    - xanadu

ft:locale :

    - ja-JP

ft:publication_title :

    - Xanadu IT Operations Management

ft:clusterId :

    - itom

bundleId :

    - itom

workflow :

    - Technology


---

# API がライブエージェントに関連付けられていることの確認

# API がライブエージェントに関連付けられていることの確認 {#ariaid-title1}

* リリースバージョン: Xanadu
* 
* 更新日 2024年08月01日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：1分

AgentNowHandler.hasAgent API を呼び出して、CI がライブエージェントに関連付けられているかどうかを判断します。API は CI の sys_id を取得し、true/false の結果を返します。
hasAgent() メソッドは、CI の sys_id を文字列パラメーターとして受け取り、CI が次のいずれかの条件を満たす場合に true を返します。

* CI は `sn_agent_cmdb_ci_agent` で、このエージェントはアライブになっている。
* CI はホスト (拡張 `cmdb_ci_hardware`) で、ライブエージェントに関連付けられている。
* CI はアプリケーション (拡張 `cmdb_ci_appl`) で、ライブエージェントに関連付けられたホストとの Runs on 関係がある。

{#acc-api-live-agent__ul_yvz_tsg_3kb}

例：

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