マネージド統合通知

マネージド統合通知は、顧客へのすべての通知を管理し、デバイスに関する更新とインサイトを提供するためのリアルタイムの通信を促進します。デバイスイベント、デバイスライフサイクル、デバイス状態を顧客に通知するかどうかにかかわらず、マネージド統合通知はカスタマーエクスペリエンス全体を向上させる上で重要な役割を果たします。実用的な情報を提供することで、お客様は情報に基づいた意思決定を行い、リソース使用率を最適化できます。

マネージド統合通知を設定する

マネージド統合通知を設定するには、次の手順に従います。

Amazon Kinesis データストリームを作成する

Kinesis データストリームを作成するには、「Kinesis データストリームの作成と管理」で説明されているステップに従います。

現在、Amazon Kinesis データストリームのみが、マネージド統合通知のカスタマーマネージド送信先のオプションとしてサポートされています。
Amazon Kinesis ストリームアクセスロールを作成する

作成した Kinesis ストリームへのアクセス許可を持つ AWS Identity and Access Management アクセスロールを作成する

詳細については、「 AWS Identity and Access Managementユーザーガイド」の「IAM ロールの作成」を参照してください。

CreateDestination API を呼び出すアクセス許可をユーザーに付与する

次のポリシーは、ユーザーが CreateDestination API を呼び出すための要件を定義します。設定しない場合、CreateDestinationAPI への呼び出しは失敗します。

マネージド統合へのパスロール許可を取得するには、「ユーザーガイド」の「 AWS サービスにロールを渡すためのアクセス許可をユーザーに付与する」を参照してください。 AWS Identity and Access Management



{
      "Version":"2012-10-17",
      "Statement":[
         {
            "Effect":"Allow",
            "Action":"iam:PassRole",
            "Resource":"arn:aws:iam::accountID:role/kinesis_stream_access_role",
            "Condition":{
               "StringEquals":{
                  "iam:PassedToService":"iotmanagedintegrations.amazonaws.com"
               }
            }
         },
         {
            "Effect":"Allow",
            "Action":"iotmanagedintegrations:CreateDestination",
            "Resource":"*"
         }
      ]
}

CreateDestination API を呼び出す

Amazon Kinesis データストリームとストリームアクセスロールを作成したら、CreateDestination API を呼び出して、マネージド統合通知がルーティングされるカスタマーマネージド送信先を作成します。deliveryDestinationArn パラメータには、新しい Amazon Kinesis データストリームarnのを使用します。
```
{
    "DeliveryDestinationArn": "Your Kinesis arn"
    "DeliveryDestinationType": "KINESIS"
    "Name": "DestinationName"
    "ClientToken": "Random string"
    "RoleArn": "arn:aws:iam::accountID:role/kinesis_stream_access_role"
}
```
CreateNotificationConfiguration API を呼び出す

最後に、Amazon Kinesis データストリームで表されるカスタマー管理の宛先に通知をルーティングすることで、選択したイベントタイプを通知する通知設定を作成します。CreateNotificationConfiguration API を呼び出して、通知設定を作成します。destinationName パラメータでは、 CreateDestination API を使用してカスタマー管理の送信先を作成したときに最初に作成したのと同じ送信先名を使用します。
```
{
    "EventType": "DEVICE_EVENT"
    "DestinationName" // This name has to be identical to the name in createDestination API
    "ClientToken": "Random string"
}
```

マネージド統合でモニタリングされるイベントタイプ

マネージド統合通知でモニタリングされるイベントタイプは次のとおりです。

DEVICE_COMMAND

SendManagedThing API コマンドのステータス。有効な値はsucceededかfailedのどちらかです。


{
      "version":"0",
      "messageId":"6a7e8feb-b491-4cf7-a9f1-bf3703467718",
      "messageType":"DEVICE_EVENT",
      "source":"aws.iotmanagedintegrations",
      "customerAccountId":"123456789012",
      "timestamp":"2017-12-22T18:43:48Z",
      "region":"ca-central-1",
      "resources":[
        "arn:aws:iotmanagedintegrations:ca-central-1:123456789012:managed-thing/6a7e8feb-b491-4cf7-a9f1-bf3703467718"
      ],
      "payload":{
        "traceId":"1234567890abcdef0",
        "receivedAt":"2017-12-22T18:43:48Z",
        "executedAt":"2017-12-22T18:43:48Z",
        "result":"failed"
      }
}

DEVICE_COMMAND_REQUEST

Web Real-Time Communication (WebRTC) からのコマンドリクエスト。

WebRTC 標準では、2 つのピア間の通信が可能です。これらのピアは、リアルタイムの動画、オーディオ、および任意のデータを送信できます。マネージド統合は WebRTC をサポートし、顧客のモバイルアプリケーションとエンドユーザーのデバイス間のこれらのタイプのストリーミングを有効にします。WebRTC 標準の詳細については、WebRTC」を参照してください。


{
      "version":"0",
      "messageId":"6a7e8feb-b491-4cf7-a9f1-bf3703467718",
      "messageType":"DEVICE_COMMAND_REQUEST",
      "source":"aws.iotmanagedintegrations",
      "customerAccountId":"123456789012",
      "timestamp":"2017-12-22T18:43:48Z",
      "region":"ca-central-1",
      "resources":[
        "arn:aws:iotmanagedintegrations:ca-central-1:123456789012:managed-thing/6a7e8feb-b491-4cf7-a9f1-bf3703467718"
      ],
      "payload":{
        "endpoints":[{
          "endpointId":"1",
          "capabilities":[{
            "id":"aws.DoorLock",
            "name":"Door Lock",
            "version":"1.0"
          }]
        }]
      }
}

DEVICE_DISCOVERY_STATUS

デバイスの検出ステータス。


{
      "version":"0",
      "messageId":"6a7e8feb-b491-4cf7-a9f1-bf3703467718",
      "messageType":"DEVICE_DISCOVERY_STATUS",
      "source":"aws.iotmanagedintegrations",
      "customerAccountId":"123456789012",
      "timestamp":"2017-12-22T18:43:48Z",
      "region":"ca-central-1",
      "resources":[
        "arn:aws:iotmanagedintegrations:ca-central-1:123456789012:managed-thing/6a7e8feb-b491-4cf7-a9f1-bf3703467718"
      ],
      "payload":{
        "deviceCount": 1,
        "deviceDiscoveryId": "123",
        "status": "SUCCEEDED"
      }
}

DEVICE_EVENT

デバイスイベントの発生に関する通知。


{
      "version":"1.0",
      "messageId":"2ed545027bd347a2b855d28f94559940",
      "messageType":"DEVICE_EVENT",
      "source":"aws.iotmanagedintegrations",
      "customerAccountId":"123456789012",
      "timestamp":"1731630247280",
      "resources":[
        "/quit/1b15b39992f9460ba82c6c04595d1f4f"
      ],
      "payload":{
        "endpoints":[{
          "endpointId":"1",
          "capabilities":[{
            "id":"aws.DoorLock",
            "name":"Door Lock",
            "version":"1.0",
            "properties":[{
              "name":"ActuatorEnabled",
              "value":"true"
            }]
          }]
        }]
      }
}

DEVICE_LIFE_CYCLE

デバイスライフサイクルのステータス。


{ 
      "version": "1.0.0", 
      "messageId": "8d1e311a473f44f89d821531a0907b05",
      "messageType": "DEVICE_LIFE_CYCLE",
      "source": "aws.iotmanagedintegrations",
      "customerAccountId": "123456789012",
      "timestamp": "2024-11-14T19:55:57.568284645Z",
      "region": "ca-central-1",
      "resources": [
        "arn:aws:iotmanagedintegrations:ca-central-1:123456789012:managed-thing/d5c280b423a042f3933eed09cf408657"
        ],
      "payload": {
        "deviceDetails": {
          "id": "d5c280b423a042f3933eed09cf408657",
          "arn": "arn:aws:iotmanagedintegrations:ca-central-1:123456789012:managed-thing/d5c280b423a042f3933eed09cf408657",
          "createdAt": "2024-11-14T19:55:57.515841147Z",
          "updatedAt": "2024-11-14T19:55:57.515841559Z"
        },
        "status": "UNCLAIMED" 
      } 
}

DEVICE_OTA
- デバイス OTA 通知。

DEVICE_STATE

デバイスの状態が更新されたときの通知。


{ 
      "messageType": "DEVICE_STATE",
      "source": "aws.iotmanagedintegrations",
      "customerAccountId": "123456789012",
      "timestamp": "1731623291671",
      "resources": [
        "arn:aws:iotmanagedintegrations:ca-central-1:123456789012:managed-thing/61889008880012345678"
      ],
      "payload": {
        "addedStates": {
          "endpoints": [{
            "endpointId": "nonEndpointId",
            "capabilities": [{
              "id": "aws.OnOff",
              "name": "On/Off",
              "version": "1.0",
              "properties": [{
                "name": "OnOff",
                "value": {
                  "propertyValue": "\"onoff\"",
                  "lastChangedAt": "2024-06-11T01:38:09.000414Z"
                }
              }
            ]}
          ]}
        ]}
      } 
}

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

デバイスコマンドとイベント

Cloud-to-Cloud (C2C) コネクタ