デバイスイベントの設定(ユースケース)
この例をモデルとして使用して、導入中のデバイスでデバイスイベントが発生したときに警告するWebhookを作成します。
このユースケースでは、アクセスポイント(AP)などのデバイスが設定されたしきい値よりも長くクラウドから切断されるたびにWebhook通知を受け取るようにしたいとします。この通知を設定するには、 Device Events Webhookを設定する必要があります。Webhookを作成する手順については、「 APIからWebhookを作成する 」または「 ジュニパー MistポータルでWebhookを追加する 」を参照してください。
正確なデバイスとそれぞれの問題に注意を向けることができるため、 Device Events の通知を受け取ると便利です。たとえば、デバイスがオフラインになると、そのイベントがトリガーされるたびに、クラウドはWebhook通知をホストされたシステムに直接送信します。システムはイベントを解析し、このイベントをトリガーとして使用して自動化を実行できます。
注:
Device EventsWebhookトピックを設定すると、AP、ゲートウェイ、スイッチに影響を与えるイベントが通知されます。このトピックには、
ap_offline、
device_down、
switch_down、
device_restarted、
gateway_down、
switch_restartedなどのイベントが含まれます。
この例では、デバイスがオフラインになるたびに、ジュニパー Mist は指定された URL への Webhook POST を作成します。受信リクエストペイロードには、イベントのorg_id、site_id、mac、device_name、タイムスタンプなどの詳細が含まれています。JSON ペイロードは次のようになります。
curl -X POST \
--url 'https://api.mist.com/webhook_example/_device_events_' \
-H 'Content-Type: application/json' \
--data-raw '{
"events": [
{
"ap": "5c5b350e55c8",
"ap_name": "ap_name6",
"audit_id": "78c04fa6-cfb4-46a0-9aa5-3681ba4f3897",
"device_name": "device_name4",
"device_type": "ap",
"ev_type": "notice",
"mac": "mac2",
"reason": "device offline",
"site_name": "office",
"text": "offline",
"type": "ap_offline"
}
],
"topic": "device_events"
}'