ワイヤレスリソースのイベントを有効にする - AWS IoT Wireless

ワイヤレスリソースのイベントを有効にする

予約済みトピックのサブスクライバーがメッセージを受信できるようにするには、イベント通知を有効にする必要があります。これを行うには、AWS Management Console、AWS IoT Wireless API、または AWS CLI が使用できます。

イベント設定

特定のタイプに属するすべてのリソース、または個別のワイヤレスリソースのいずれかに通知を送信するようにイベントを設定できます。リソースタイプには、ワイヤレスゲートウェイ、Sidewalk パートナーアカウント、またはワイヤレスデバイス (LoRaWAN または Sidewalk デバイス) を使用できます。ワイヤレスデバイスで有効にできるイベントのタイプについては、「LoRaWAN リソースのイベントタイプ」および「Sidewalk リソースのイベントタイプ」を参照してください。

すべてのリソース

特定のリソースタイプに属する AWS アカウント 内のすべてのリソースが通知を受信するようにイベントを有効にすることができます。たとえば、AWS IoT Core for LoRaWAN でオンボーディングしたすべての LoRaWAN ゲートウェイの接続ステータスの変更を通知するイベントを有効にできます。これらのイベントをモニタリングすると、リソースフリート内の特定の LoRaWAN ゲートウェイが切断された場合や、AWS アカウント 内の多数の Sidewalk デバイスのビーコンが失われた場合などに通知を受け取るのに役立ちます。

個々のリソース

イベント設定に個々の LoRaWAN リソースおよび Sidewalk リソースを追加して、それらの通知を有効にすることもできます。これは、特定のタイプの個々のリソースをモニタリングするのに役立ちます。たとえば、選択した LoRaWANn および Sidewalk デバイスを設定に追加し、これらのリソースの参加またはデバイス登録状態イベントの通知を受信できます。

前提条件

LoRaWAN または Sidewalk リソースには、イベント通知の受信を許可する適切なポリシーが必要です。詳細については、「ワイヤレスイベント通知を受信するためのポリシー」を参照してください。

AWS Management Console を使用しての通知を有効にする

コンソールでイベントメッセージを有効にするには、AWS IoT コンソールの [Settings] (設定) タブに移動し、[LoRaWAN and Sidewalk event notification] (LoRaWAN および Sidewalk イベント通知) セクションに移動します。

特定のリソースタイプに属する AWS アカウント 内のすべてのリソースの通知を有効にして、それらをモニタリングできます。

すべてのリソースに対して通知を有効にするには
  1. [LoRaWAN and Sidewalk event notification] (LoRaWAN および Sidewalk イベント通知) セクションの [All resources] (すべてのリソース) タブで、[Action] (アクション) を選択してから [Manage events] (イベントの管理) を選択します。

  2. モニタリングするイベントを有効化してから、[Update events] (イベントの更新) を選択します。特定のイベントをモニタリングする必要がなくなった場合は、[Action] (アクション)、[Manage events] (イベントの管理) を選択して、これらのイベントを無効にします。

特定のリソースタイプに属する AWS アカウント 内の個々のリソースの通知を有効にして、それらをモニタリングすることもできます。

個々のリソースに対して通知を有効にするには
  1. [LoRaWAN and Sidewalk event notification] (LoRaWAN および Sidewalk イベント通知) セクションで、[Action] (アクション) を選択してから、[Add resources] (リソースを追加する) を選択します。

  2. 通知を受け取るリソースおよびイベントを選択します:

    1. [LoRaWAN resources] (LoRaWAN リソース) または [Sidewalk resources] (Sidewalk リソース) のどちらのイベントをモニタリングするかを選択します。

    2. リソースタイプに応じて、リソースに対して有効化するイベントを選択できます。その後、これらのイベントをサブスクライブして通知を受け取ることができます。選択内容:

      • [LoRaWAN resources] (LoRaWAN リソース): LoRaWAN デバイスの [join] (参加) イベントまたは LoRaWAN ゲートウェイの [connection status] (接続ステータス) イベントを有効にできます。

      • [Sidewalk resources] (Sidewalk リソース): Sidewalk パートナーアカウントと Sidewalk デバイスの [device registration state] (デバイス登録状態) または [proximity] (近接) イベント、あるいはその両方を有効にできます。

  3. 選択したリソースタイプとイベントに応じて、モニタリングするワイヤレスデバイスまたはゲートウェイを選択します。すべてのリソースを組み合わせて、最大 250 のリソースを選択できます。

  4. [Submit] (送信) を選択してリソースを追加します。

追加したリソースは、コンソールの [LoRaWAN and Sidewalk event notification] (LoRaWAN および Sidewalk イベント通知) セクションのリソースタイプのタブに MQTT トピックとともに表示されます。

  • [LoRaWAN join] (LoRaWAN 参加) イベントと Sidewalk デバイスのイベントは、コンソールの [Wireless devices] (ワイヤレスデバイス) セクションに表示されます。

  • LoRaWAN ゲートウェイの [Connection status] (接続ステータス) イベントは、[Wireless gateways] (ワイヤレスゲートウェイ) セクションに表示されます。

  • Sidewalk アカウントの [Device registration state] (デバイス登録状態) および [proximity] (近接) イベントは、[Sidewalk accounts] (Sidewalk アカウント) タブに表示されます。

MQTT クライアントを使用してトピックをサブスクライブする

すべてのリソースに対してイベントを有効にしたか、個々のリソースタイプに対してイベントを有効にしたかに応じて、有効にしたイベントはコンソールの [All resources] (すべてのリソース) タブまたは指定したリソースタイプのタブに MQTT トピックとともに表示されます。

  • MQTT トピックの 1 つを選択した場合は、MQTT クライアントにアクセスして、これらのトピックをサブスクライブしてメッセージを受信できます。

  • 複数のイベントを追加した場合は、複数のイベントトピックをサブスクライブして、それらの通知を受け取ることができます。複数のトピックをサブスクライブするには、トピックを選択し、[Action] (アクション) を選択してから、[Subscribe] (サブスクライブ) を選択します。

AWS CLI を使用しての通知を有効にする

AWS IoT Wireless API または AWS CLI を使用して、イベントを設定し、リソースを設定に追加できます。

すべてのリソースに対して通知を有効にする

UpdateEventConfigurationByResourceTypes API または update-event-configuration-by-resource-types CLI コマンドを使用して、特定のリソースタイプに属する AWS アカウント 内のすべてのリソースの通知を有効にし、それらをモニタリングできます。例:

aws iotwireless update-event-configuration-by-resource-types \ --cli-input-json input.json

input.json の内容

{ "DeviceRegistrationState": { "Sidewalk": { "AmazonIdEventTopic": "Enabled" } }, "ConnectionStatus": { "LoRaWAN": { "WirelessGatewayEventTopic": "Enabled" } } }
注記

二重引用符 (") はバックスラッシュ (\) でエスケープされます。

現在のイベント設定は、GetEventConfigurationByResourceTypes API を呼び出すか、get-event-configuration-by-resource-types CLI コマンドを使用して取得できます。例:

aws iotwireless get-event-configuration-by-resource-types
個々のリソースに対して通知を有効にする

イベント設定に個々のリソースを追加し、発行されるイベントを API または CLI を使用して制御するには、UpdateResourceEventConfiguration API を呼び出すか、update-resource-event-configuration CLI コマンドを使用します。例:

aws iotwireless update-resource-event-configuration \ --identifer 1ffd32c8-8130-4194-96df-622f072a315f \ --identifier-type WirelessDeviceId \ --cli-input-json input.json

input.json の内容

{ "Join": { "LoRaWAN": { "DevEuiEventTopic": "Disabled" }, "WirelessDeviceIdEventTopic": "Enabled" } }
注記

二重引用符 (") はバックスラッシュ (\) でエスケープされます。

現在のイベント設定は、GetResourceEventConfiguration API を呼び出すか、get-resource-event-configuration CLI コマンドを使用して取得できます。例:

aws iotwireless get-resource-event-configuration \ --identifier-type WirelessDeviceId \ --identifier 1ffd32c8-8130-4194-96df-622f072a315f
イベント設定を一覧表示する

また、AWS IoT Wireless API または AWS CLI を使用して、少なくとも 1 つのイベントトピックが有効になっているイベント設定を一覧表示することもできます。設定を一覧表示するには、ListEventConfigurations API オペレーション、または list-event-configurations CLI コマンドを使用します。例:

aws iotwireless list-event-configurations --resource-type WirelessDevice