翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# イベントメッセージ
<a name="iot-events"></a>

このセクションには、モノまたはジョブが更新または変更された AWS IoT ときに によって発行されるメッセージに関する情報が含まれています。ディテクターを作成して、動作中の障害や変更がないかデバイスをモニタリングし、発生したときにアクションをトリガーできる AWS IoT Events サービスについては、「」を参照してください[AWS IoT Events](https://aws.amazon.com/iot-events)。

## イベントメッセージが生成される方法
<a name="iot-events-how"></a>

AWS IoT は、特定のイベントが発生したときにイベントメッセージを発行します。例えば、モノが追加、更新、または削除されると、イベントがレジストリによって生成されます。各イベントによって、単一のイベントメッセージが送信されます。イベントメッセージは、MQTT を介して JSON ペイロードを使用して公開されます。ペイロードのコンテンツは、イベントの種類によって異なります。

**注記**  
イベントメッセージは一度公開されることが保証されています。複数回発行することが可能です。イベントメッセージの順序は保証されません。

### イベントメッセージを受信するためのポリシー
<a name="iot-events-policy"></a>

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

以下に示しているのは、ライフサイクルイベントの受信に必要なポリシーの例です。

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "iot:Subscribe",
                "iot:Receive"
            ],
            "Resource": [
                "arn:aws:iot:{{us-east-1}}:123456789012:/$aws/events/*"
            ]
        }
    ]
}
```

## のイベントを有効にする AWS IoT
<a name="iot-events-enable"></a>

予約済みトピックのサブスクライバーがメッセージを受信する前に、 API AWS マネジメントコンソール または CLI を使用して、 または からイベントメッセージを有効にする必要があります。さまざまなオプションが管理するイベントメッセージの詳細については、[AWS IoT 「イベント設定表](#iot-events-settings-table)」を参照してください。
+ イベントメッセージを有効にするには、 AWS IoT コンソール[の設定](https://console.aws.amazon.com//iot/home#/settings)タブに移動し、**イベントベースのメッセージ**セクションでイベント**の管理**を選択します。管理したいイベントを指定ができます。
+ API または CLI を使用して発行されるイベントタイプを制御するには、[UpdateResourceEventConfiguration](https://docs.aws.amazon.com/iot/latest/apireference/API_UpdateEventConfigurations.html) API を呼び出すか、**update-event-configurations** CLI コマンドを使用します。例:。

  ```
  aws iot update-event-configurations --event-configurations "{\"THING\":{\"Enabled\": true}}"
  ```

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

現在のイベント設定は、[DescribeEventConfigurations](https://docs.aws.amazon.com/iot/latest/apireference/API_DescribeEventConfigurations.html) API を呼び出すか、**describe-event-configurations** CLI コマンドを使用することで取得できます。例 :

```
aws iot describe-event-configurations
```<a name="iot-events-settings-table"></a>

** AWS IoT イベント構成設定表**


|  イベントカテゴリ  (AWS IoT コンソール: 設定: イベントベースのメッセージ)  |  `eventConfigurations` キーバリュー (AWS CLI/API)  |    イベントメッセージのトピック  | 
| --- | --- | --- | 
| ( AWS CLI/API を使用してのみ設定可能) | `CA_CERTIFICATE` | `$aws/events/certificates/registered/{{caCertificateId}}` | 
| *( AWS CLI/API を使用してのみ設定可能)* | `CERTIFICATE` | `$aws/events/presence/connected/{{clientId}}` | 
| *( AWS CLI/API を使用してのみ設定可能)* | `CERTIFICATE` | `$aws/events/presence/disconnected/{{clientId}}` | 
| *( AWS CLI/API を使用してのみ設定可能)* | `CERTIFICATE` | `$aws/events/subscriptions/subscribed/{{clientId}}` | 
| *( AWS CLI/API を使用してのみ設定可能)* | `CERTIFICATE` | `$aws/events/subscriptions/unsubscribed/{{clientId}}` | 
| ジョブ完了、キャンセル済み | `JOB` | `$aws/events/job/{{jobID}}/canceled` | 
| ジョブ完了、キャンセル済み | `JOB` | `$aws/events/job/{{jobID}}/cancellation_in_progress` | 
| ジョブ完了、キャンセル済み | `JOB` | `$aws/events/job/{{jobID}}/completed` | 
| ジョブ完了、キャンセル済み | `JOB` | `$aws/events/job/{{jobID}}/deleted` | 
| ジョブ完了、キャンセル済み | `JOB` | `$aws/events/job/{{jobID}}/deletion_in_progress` | 
| ジョブ実行 : 成功、失敗、拒否、キャンセル、削除 | `JOB_EXECUTION` | `$aws/events/jobExecution/{{jobID}}/canceled` | 
| ジョブ実行 : 成功、失敗、拒否、キャンセル、削除 | `JOB_EXECUTION` | `$aws/events/jobExecution/{{jobID}}/deleted` | 
| ジョブ実行 : 成功、失敗、拒否、キャンセル、削除 | `JOB_EXECUTION` | `$aws/events/jobExecution/{{jobID}}/failed` | 
| ジョブ実行 : 成功、失敗、拒否、キャンセル、削除 | `JOB_EXECUTION` | `$aws/events/jobExecution/{{jobID}}/rejected` | 
| ジョブ実行 : 成功、失敗、拒否、キャンセル、削除 | `JOB_EXECUTION` | `$aws/events/jobExecution/{{jobID}}/removed` | 
| ジョブ実行 : 成功、失敗、拒否、キャンセル、削除 | `JOB_EXECUTION` | `$aws/events/jobExecution/{{jobID}}/succeeded` | 
| ジョブ実行 : 成功、失敗、拒否、キャンセル、削除 | `JOB_EXECUTION` | `$aws/events/jobExecution/{{jobID}}/timed_out` | 
| モノ : 作成、更新、削除 | `THING` | `$aws/events/thing/{{thingName}}/created` | 
| モノ : 作成、更新、削除 | `THING` | `$aws/events/thing/{{thingName}}/updated` | 
| モノ : 作成、更新、削除 | `THING` | `$aws/events/thing/{{thingName}}/deleted` | 
| モノグループ : 追加、削除 | `THING_GROUP` | `$aws/events/thingGroup/{{thingGroupName}}/created` | 
| モノグループ : 追加、削除 | `THING_GROUP` | `$aws/events/thingGroup/{{thingGroupName}}/updated` | 
| モノグループ : 追加、削除 | `THING_GROUP` | `$aws/events/thingGroup/{{thingGroupName}}/deleted` | 
| モノグループ階層 : 追加、削除 | `THING_GROUP_HIERARCHY` | `$aws/events/thingGroupHierarchy/thingGroup/{{parentThingGroupName}}/childThingGroup/{{childThingGroupName}}/added` | 
| モノグループ階層 : 追加、削除 | `THING_GROUP_HIERARCHY` | `$aws/events/thingGroupHierarchy/thingGroup/{{parentThingGroupName}}/childThingGroup/{{childThingGroupName}}/removed` | 
| モノグループメンバーシップ : 追加、削除 | `THING_GROUP_MEMBERSHIP` | `$aws/events/thingGroupMembership/thingGroup/{{thingGroupName}}/thing/{{thingName}}/added` | 
| モノグループメンバーシップ : 追加、削除 | `THING_GROUP_MEMBERSHIP` | `$aws/events/thingGroupMembership/thingGroup/{{thingGroupName}}/thing/{{thingName}}/removed` | 
| モノタイプ : 作成、更新、削除 | `THING_TYPE` | `$aws/events/thingType/{{thingTypeName}}/created` | 
| モノタイプ : 作成、更新、削除 | `THING_TYPE` | `$aws/events/thingType/{{thingTypeName}}/updated` | 
| モノタイプ : 作成、更新、削除 | `THING_TYPE` | `$aws/events/thingType/{{thingTypeName}}/deleted` | 
| モノタイプの関連付け : 追加、削除 | `THING_TYPE_ASSOCIATION` | `$aws/events/thingTypeAssociation/thing/{{thingName}}/thingType/{{thingTypeName}}/added`<br />`$aws/events/thingTypeAssociation/thing/{{thingName}}/thingType/{{thingTypeName}}/removed` |