AWS IoT Wireless イベント通知

AWS IoT Wireless では、AWS IoT Core にオンボードした LoRaWAN および Sidewalk デバイスのイベントを通知させるメッセージを発行できます。例えば、アカウント内の Sidewalk デバイスがプロビジョニングまたは登録されたときなどのイベントの通知を受けることができます。

イベントをリソースに通知する方法

イベント通知は、特定のイベントが発生したときに発行されます。例えば、Sidewalk デバイスのプロビジョニング時にイベントが生成されます。各イベントによって、単一のイベント通知が送信されます。イベント通知は、MQTT を介して JSON ペイロードを使用して発行されます。ペイロードのコンテンツは、イベントの種類によって異なります。

注記

イベント通知は少なくとも 1 回発行されます。複数回発行されることもあります。イベント通知の順序は保証されません。

イベントタイプとリソースタイプ

次の表に、通知を受け取るさまざまなイベントのタイプを示します。イベントタイプは、リソースタイプがワイヤレスデバイス、ワイヤレスゲートウェイまたは Sidewalk アカウントのいずれであるかによって異なります。次のセクションで説明するように、特定のタイプのすべてのリソースに適用されるリソースレベルで、または選択したリソースに対して、リソースのイベントを有効にすることもできます。さまざまなイベントタイプの詳細については、「LoRaWAN リソースのイベント通知」および「Sidewalk リソースのイベント通知」を参照してください。

リソースに基づくイベントタイプ
リソース	リソースタイプ	イベントタイプ
ワイヤレスデバイス	LoRaWAN	参加
	Sidewalk	デバイス登録状態 近接
ワイヤレスゲートウェイ	LoRaWAN	接続ステータス
Sidewalk アカウント	Sidewalk	デバイス登録状態 近接

ワイヤレスイベント通知を受信するためのポリシー

イベント通知を受信するには、デバイスが AWS IoT デバイスゲートウェイに接続し、MQTT イベントトピックをサブスクライブできるようにする適切なポリシーを使用する必要があります。また、適切なトピックフィルターを受信登録する必要があります。

以下は、さまざまなワイヤレスイベントの通知を受信するために必要なポリシーの例です。

{
    "Version":"2012-10-17",
    "Statement":[{
        "Effect":"Allow",
        "Action":[
            "iot:Subscribe",
            "iot:Receive"
        ],
        "Resource":[
            "arn:aws:iotwireless:region:account:/$aws/iotwireless/events/join/*",
            "arn:aws:iotwireless:region:account:/$aws/iotwireless/events/connection_status/*"
            "arn:aws:iotwireless:region:account:/$aws/iotwireless/events/device_registration_state/*", 
            "arn:aws:iotwireless:region:account:/$aws/iotwireless/events/proximity/*"
        ]
    }]
}

ワイヤレスイベントの MQTT トピックの形式

ワイヤレスリソースのイベントの通知を送信するために、AWS IoT はドル記号 ($) で始まる MQTT 予約済みトピックを使用します。これらの予約済みのトピックを発行しサブスクライブできます。ただし、ドル記号で始まる新しいトピックを作成することはできません。

注記

MQTT トピックは、AWS アカウント に固有で、arn:aws:iotwireless:aws-region:AWS-account-ID:topic/Topic の形式を使用します。詳細については、AWS IoT デベロッパーガイドの「MQTT トピック」を参照してください。

ワイヤレスデバイス用に予約された MQTT トピックは、次の形式を使用します。

• リソースレベルのトピック

  これらのトピックは、AWS IoT Wireless にオンボーディングした AWS アカウント の特定のタイプのすべてのリソースに適用されます。

  $aws/iotwireless/events/{eventName}/{eventType}/{resourceType}/resources

• 識別子レベルのトピック

  これらのトピックは、リソース識別子で指定された、AWS IoT Wireless にオンボーディングした AWS アカウント の特定のタイプの選択されたリソースに適用されます。

  $aws/iotwireless/events/{eventName}/{eventType}/{resourceType}/{resourceIdentifierType}/{resourceID}/{id}

リソースレベルおよび識別子レベルのトピックの詳細については、「イベント設定」を参照してください。

次の表は、さまざまなイベントの MQTT トピックの例を示しています。

イベントと MQTT トピック
イベント	MQTT トピック	メモ
Sidewalk デバイスの登録状態	リソースレベルのトピック $aws/iotwireless/events/device_registration_state/{eventType}/sidewalk/wireless_devices 識別子レベルのトピック $aws/iotwireless/events/device_registration_state/{eventType}/sidewalk/{resourceType}/{resourceID}/{id}	{eventType} は、registered か provisioned のいずれかとなります。 {resourceType} は、sidewalk_accounts か wireless_devices のいずれかとなります。 {resourceID} は、sidewalk_accounts の場合は amazon_id、wireless_devices の場合は wireless_device_id となります。
Sidewalk 近接	リソースレベルのトピック $aws/iotwireless/events/proximity/{eventType}/sidewalk/wireless_devices 識別子レベルのトピック $aws/iotwireless/events/proximity/{eventType}/sidewalk/{resourceType}/{resourceID}/{id}	{eventType} は、beacon_discovered か beacon_lost のいずれかとなります。 {resourceType} は、sidewalk_accounts か wireless_devices のいずれかとなります。 {resourceID} は、sidewalk_accounts の場合は amazon_id、wireless_devices の場合は wireless_device_id となります。
LoRaWAN 参加	リソースレベルのトピック $aws/iotwireless/events/join/{eventType}/lorawan/wireless_devices 識別子レベルのトピック $aws/iotwireless/events/join/{eventType}/lorawan/wireless_devices/{resourceID}/{id}	{eventType} は、join_req_0_received、join_req_2_received、join_accepted のいずれかとなります。 {resourceID} は、wireless_device_id か dev_eui のいずれかとなります。
LoRaWAN ゲートウェイ接続ステータス	リソースレベルのトピック $aws/iotwireless/events/join/{eventType}/lorawan/wireless_gateways 識別子レベルのトピック $aws/iotwireless/events/join/{eventType}/lorawan/wireless_gateways/{resourceID}/{id}	{eventType} は、connected か disconnected のいずれかとなります。 {resourceID} は、wireless_gateway_id か gateway_eui のいずれかとなります。

さまざまなイベントの詳細については、「LoRaWAN リソースのイベント通知」および「Sidewalk リソースのイベント通知」を参照してください。

これらのトピックをサブスクライブしている場合は、いずれかのイベント通知トピックにメッセージが発行されると通知されます。詳細については、AWS IoT デベロッパーガイドの「MQTT 予約済みトピック」を参照してください。

ワイヤレスイベントの料金

イベントのサブスクリプションと通知の受信に関する料金については、「AWS IoT Core の料金」を参照してください。