# AWS IoT Wireless イベント通知
<a name="iot-wireless-events"></a>

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

## イベントをリソースに通知する方法
<a name="iot-wireless-events-mqtt"></a>

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

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

### イベントタイプとリソースタイプ
<a name="iot-wireless-events-types"></a>

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


**リソースに基づくイベントタイプ**  
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/iot-wireless/latest/developerguide/iot-wireless-events.html)

### ワイヤレスイベント通知を受信するためのポリシー
<a name="iot-wireless-events-policy"></a>

イベント通知を受信するには、デバイスが 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 トピックの形式
<a name="iot-wireless-message-format"></a>

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

**注記**  
MQTT トピックは、AWS アカウント に固有で、`arn:aws:iotwireless:aws-region:AWS-account-ID:topic/Topic` の形式を使用します。詳細については、*AWS IoT デベロッパーガイド*の「[MQTT トピック](https://docs.aws.amazon.com/iot/latest/developerguide/topics.html)」を参照してください。

ワイヤレスデバイス用に予約された 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}`

リソースレベルおよび識別子レベルのトピックの詳細については、「[イベント設定](iot-wireless-control-events.md#iot-wireless-control-events-config)」を参照してください。

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


**イベントと MQTT トピック**  

| イベント | MQTT トピック | メモ | 
| --- | --- | --- | 
| Sidewalk デバイスの登録状態 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/iot-wireless/latest/developerguide/iot-wireless-events.html)  | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/iot-wireless/latest/developerguide/iot-wireless-events.html) | 
| Sidewalk 近接 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/iot-wireless/latest/developerguide/iot-wireless-events.html)  | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/iot-wireless/latest/developerguide/iot-wireless-events.html) | 
| LoRaWAN 参加 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/iot-wireless/latest/developerguide/iot-wireless-events.html)  | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/iot-wireless/latest/developerguide/iot-wireless-events.html) | 
| LoRaWAN ゲートウェイ接続ステータス |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/iot-wireless/latest/developerguide/iot-wireless-events.html)  | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/iot-wireless/latest/developerguide/iot-wireless-events.html) | 

さまざまなイベントの詳細については、「[LoRaWAN リソースのイベント通知](iot-lorawan-events.md)」および「[Sidewalk リソースのイベント通知](iot-sidewalk-events.md)」を参照してください。

これらのトピックをサブスクライブしている場合は、いずれかのイベント通知トピックにメッセージが発行されると通知されます。詳細については、*AWS IoT デベロッパーガイド*の「[MQTT 予約済みトピック](https://docs.aws.amazon.com/iot/latest/developerguide/reserved-topics.html)」を参照してください。

## ワイヤレスイベントの料金
<a name="iot-wireless-events-pricing"></a>

イベントのサブスクリプションと通知の受信に関する料金については、「[AWS IoT Core の料金](https://aws.amazon.com/iot-core/pricing/)」を参照してください。