イベントハンドラーとは、監視対象がルールを満たした (ある状態になった) ことをトリガーにアクションを実行する機能です。たとえば、以下のように通信を管理したり通知を受けたりできます。監視対象には、IoT SIM、グループ、オペレーターなどがあり、以下の例では「IoT SIM」が監視対象です。
- IoT SIM のデータ通信量が月に 1 GiB (1024 MiB) を超えたら、IoT SIM のステータス を「休止中 (inactive)」にし、翌月 IoT SIM のステータスを「使用中 (active)」に戻す。
- IoT SIM のデータ通信量が 1 日 10 MiB を超えたら、メールで通知する。
- IoT SIM を取り付けた製品を出荷した後に初めて IoT SIM が通信を開始したときに、IoT SIM のステータス が「使用中 (active)」になったことを検知して AWS Lambda を呼び出す。
監視対象、ルール、アクションをひとまとめにして「イベント」と呼びます。イベントは、SORACOM ユーザーコンソール、SORACOM CLI、SORACOM API で指定できます。
カバレッジタイプを超えてサービスを利用することはできません
グローバルカバレッジと日本カバレッジでは、ほぼ同じ内容のサービスを提供していますが、完全に分離されています。そのため、カバレッジタイプ を超えてサービスを利用することはできません。たとえば、グローバルカバレッジの SORACOM IoT SIM と、日本カバレッジの特定地域向け IoT SIM に、同じイベントを設定する場合は、カバレッジタイプごとに同じイベントを作成してください。
約 5 分間隔で監視されます
イベントハンドラーは、約 5 分間隔で監視対象がルールを満たしているかどうかを判定しています。
セッション On/Off トリガー (Limited Preview)
IoT SIM のセッションが オンライン になったときや、オフライン になったときにアクションを実行できます。
セッション On/Off トリガーは Limited Preview です
セッション On/Off トリガーを利用するには、申請が必要です。詳しくは、セッション On/Off トリガー、IMEI ロックアクション イベントハンドラー LimitedPreview ご利用申請 を参照してください。
FAQ: Limited Preview とはどのような意味ですか? もあわせて確認してください。
IMEI ロックアクション (Limited Preview)
イベントハンドラーのアクションとして、IMEI ロックを利用できます。たとえば、IoT SIM を取り付けた製品を出荷した後に初めて IoT SIM が通信を開始したときに、そのデバイスの IMEI を指定して IMEI ロックを設定できます。
IMEI ロックアクションは Limited Preview です
IMEI ロックアクションを利用するには、申請が必要です。詳しくは、セッション On/Off トリガー、IMEI ロックアクション イベントハンドラー LimitedPreview ご利用申請 を参照してください。
FAQ: Limited Preview とはどのような意味ですか? もあわせて確認してください。