通知用に Amazon Kinesis をセットアップするマネージド統合通知をセットアップするマネージド統合でモニタリングされるイベントタイプ

マネージド統合の通知

Managed Integrations 通知は、デバイスからの更新と主要なインサイトを提供します。通知には、コネクタイベント、デバイスコマンド、ライフサイクルイベント、OTA (Over-the-Air) 更新、エラーレポートが含まれます。これらのインサイトは、自動化されたワークフローを作成したり、すぐにアクションを実行したり、トラブルシューティングのためにイベントデータを保存したりするための実用的な情報を提供します。

現在、マネージド統合通知の送信先としてサポートされているのは Amazon Kinesis データストリームのみです。通知を設定する前に、まず Amazon Kinesis データストリームをセットアップし、マネージドインテグレーションによるデータストリームへのアクセスを許可する必要があります。

通知用に Amazon Kinesis をセットアップする

Amazon Kinesis のセットアップ手順

Amazon Kinesis for Managed Integrations 通知を設定するには、次の手順に従います。

ステップ 1: Amazon Kinesis データストリームを作成する

Amazon Kinesis Data Stream は、大量のデータをリアルタイムで取り込み、永続的に保存し、データをアプリケーションで使用できるようにすることができます。

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

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

ステップ 2: アクセス許可ポリシーを作成する

Managed Integrations が Kinesis データストリームにアクセスできるようにするアクセス許可ポリシーを作成します。

アクセス許可ポリシーを作成するには

アクセス許可ポリシーを作成するには、以下のポリシーをコピーし、「JSON エディタを使用してポリシーを作成する」で説明されているステップに従います。
JSON
{ "Version":"2012-10-17", "Statement": [ { "Action": "kinesis:PutRecord", "Resource": "*", "Effect": "Allow" } ] }

ステップ 3: IAM ダッシュボードに移動し、ロールを選択する

IAM ダッシュボードを開き、ロールをクリックします。

IAM ダッシュボードに移動するには

IAM ダッシュボードを開き、ロールをクリックします。

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

ステップ 4: カスタム信頼ポリシーを使用する

カスタム信頼ポリシーを使用して、マネージド統合に Kinesis データストリームへのアクセスを許可できます。

カスタム信頼ポリシーを使用するには

新しいロールを作成し、カスタム信頼ポリシーを選択します。Next をクリックします。

次のポリシーでは、マネージド統合がロールを引き受けることを許可し、 Conditionステートメントは混乱した代理問題を防ぐのに役立ちます。

ステップ 5: アクセス許可ポリシーを適用する

ステップ 2 で作成したアクセス許可ポリシーをロールに追加します。

アクセス許可ポリシーを追加するには

アクセス許可の追加ページで、ステップ 2 で作成したアクセス許可ポリシーを検索して追加します。次へをクリックします。

ステップ 6: ロール名を入力する

ロール名を入力し、ロールの作成をクリックします。

マネージド統合通知をセットアップする

通知のセットアップ手順

ステップ 1: CreateDestination API を呼び出すアクセス許可をユーザーに付与する
ステップ 2: CreateDestination API を呼び出す
ステップ 3: CreateNotificationConfiguration API を呼び出す

Managed Integrations 通知を設定するには、次の手順に従います。

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

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

次のポリシーは、ユーザーが CreateDestination API を呼び出すための要件を定義します。

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

ステップ 2: CreateDestination API を呼び出す

CreateDestination API を呼び出す

Amazon Kinesis データストリームとストリームアクセスロールを作成したら、CreateDestination API を呼び出して、通知がルーティングされる通知先を作成します。DeliveryDestinationArn パラメータには、新しい Amazon Kinesis データストリームarnのを使用します。
```
{
    "DeliveryDestinationArn": "Your Kinesis arn"
    "DeliveryDestinationType": "KINESIS"
    "Name": "DestinationName"
    "ClientToken": "string"
    "RoleArn": "arn:aws:iam::accountID:role/ROLE_CREATED_IN_PREVIOUS_STEP"
}
```
注記
ClientToken はべき等性トークンです。同じクライアントトークンとパラメータを使用して最初に正常に完了したリクエストを再試行すると、それ以上のアクションを実行せずに再試行が成功します。

ステップ 3: CreateNotificationConfiguration API を呼び出す

CreateNotificationConfiguration API を呼び出す

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

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

以下は、 Managed Integrations 通知でモニタリングされるイベントタイプです。

DEVICE_COMMAND

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


{
              "version":"0",
              "messageId":"6a7e8feb-b491-4cf7-a9f1-bf3703467718",
              "messageType":"DEVICE_COMMAND",
              "source":"aws.iotmanagedintegrations",
              "customerAccountId":"123456789012",
              "timestamp":"1731623291671",
              "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":"1731623291671",
              "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":{
        "iotMiArrivalTimestamp":"2026-06-26T21:28:14.697Z",
        "endpoints":[{
          "endpointId":"1",
          "capabilities":[{
            "id":"aws.DoorLock",
            "name":"Door Lock",
            "version":"1.0",
            "properties":[{
              "name":"ActuatorEnabled",
              "value":"true"
            }]
          }]
        }]
      }
}
```
  DEVICE_EVENT ペイロードには次のフィールドが含まれます。
  - iotMiArrivalTimestamp、文字列 (ISO 8601): デバイスイベントがデバイスによって Managed Integrations に発行された日時を示すタイムスタンプ。このフィールドを使用して、イベントがデバイスによって生成された時点から Managed Integrations が受信した時点までのレイテンシーを決定します。
  - endpoints: デバイスエンドポイントとその更新された機能プロパティのリスト。
  外部メッセージエンベロープの timestampフィールドは、通知がいつ Kinesis に配信されたかを示します。ペイロードiotMiArrivalTimestampのは、イベントがいつ Managed Integrations に到着したかを示します。これらの 2 つのタイムスタンプは、イベント到着から通知配信までの処理レイテンシーがある場合に異なる場合があります。

DEVICE_LIFE_CYCLE

デバイスライフサイクルのステータス (オンボーディングステータスと接続/切断ステータスを含む) の変更を反映します。

オンボーディングステータスの更新イベント。


{ 
      "version": "1.0.0", 
      "messageId": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
      "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/a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"
        ],
      "payload": {
        "deviceDetails": {
          "id": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
          "arn": "arn:aws:iotmanagedintegrations:ca-central-1:123456789012:managed-thing/a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
          "createdAt": "2024-11-14T19:55:57.515841147Z",
          "updatedAt": "2024-11-14T19:55:57.515841559Z"
        },
        "status": "UNCLAIMED" 
      } 
}

デバイス接続ステータスイベント。


{
    "version": "1.0",
    "messageId": "a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6",
    "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/a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"
    ],
    "payload": {
        "managedThingId": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
        "managedThingArn": "arn:aws:iotmanagedintegrations:ca-central-1:123456789012:managed-thing/a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
        "clientId": "iotmi-example-client-id",
        "timestamp": "1768000475344",
        "eventType": "connected",
        "sessionIdentifier": "q1w2e3r4-t5y6-u7i8-o9p0-a1s2d3f4g5h6",
        "principalIdentifier": "z1x2c3v4b5n6m7a8s9d0f1g2h3j4k5l6p7o8i9u0y1t2r3e4w5q6a7z8x9c0v1b2",
        "ipAddress": "192.0.2.100",
        "versionNumber": "0"
    }
}

デバイスの切断ステータスイベント。


{
    "version": "1.0",
    "messageId": "b2n3m4a5-s6d7-f8g9-h0j1-k2l3z4x5c6v7",
    "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/a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"
    ],
    "payload": {
        "managedThingId": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
        "managedThingArn": "arn:aws:iotmanagedintegrations:ca-central-1:123456789012:managed-thing/a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
        "clientId": "iotmi-example-client-id",
        "timestamp": "1768000492431",
        "eventType": "disconnected",
        "sessionIdentifier": "p9o8i7u6-y5t4-r3e2-w1q0-m9n8b7v6c5x4",
        "principalIdentifier": "a1s2d3f4g5h6j7k8l9z0x1c2v3b4n5m6q7w8e9r0t1y2u3i4o5p6a7s8d9f0g1h2",
        "versionNumber": "0",
        "disconnectReason": "CLIENT_INITIATED_DISCONNECT"
    }
}

DEVICE_OTA

デバイス OTA 通知。


{
    "version": "1.0.0",
    "messageId": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
    "messageType": "DEVICE_OTA",
    "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/a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
        "arn:aws:iotmanagedintegrations:ca-central-1:123456789012:managed-thing/b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7",
        "arn:aws:iotmanagedintegrations:ca-central-1:123456789012:managed-thing/c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8"
    ],
    "payload": {
        "operation": "CREATE_OTA",
        "otaTaskId": "ota-job-abc123def456",
        "status": "IN_PROGRESS",
        "otaType": "ONE_TIME"
    }
}

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"
                }
              }
            ]}
          ]}
        ]}
      } 
}

ACCOUNT_ASSOCIATION

アカウントの関連付けの状態が IN_PROGRESS に変わったときの通知。


{
    "version": "1.0.0",
    "messageId": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
    "messageType": "ACCOUNT_ASSOCIATION",
    "source": "aws.iotmanagedintegrations",
    "customerAccountId": "123456789012",
    "timestamp": "2026-01-20T23:59:34.009284802Z",
    "region": "ca-central-1",
    "resources": ["arn:aws:iotmanagedintegrations:ca-central-1:123456789012:account-association/a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"],
    "payload": {
        "traceId": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
        "logLevel": "INFO",
        "resourceType": "account-association",
        "resourceId": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
        "connectorDestinationId": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
        "associationArn": "arn:aws:iotmanagedintegrations:ca-central-1:123456789012:account-association/a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
        "state": "ASSOCIATION_IN_PROGRESS",
        "isServiceError": false,
        "isCustomerError": false,
        "details": "AccountAssociation State is updated to IN_PROGRESS during StartAccountAssociationRefresh"
    }
}

アカウントの関連付けが正常に完了したときの通知。


{
    "version": "1.0.0",
    "messageId": "b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7",
    "messageType": "ACCOUNT_ASSOCIATION",
    "source": "aws.iotmanagedintegrations",
    "customerAccountId": "123456789012",
    "timestamp": "2026-01-20T23:59:44.672304821Z",
    "region": "ca-central-1",
    "resources": ["arn:aws:iotmanagedintegrations:ca-central-1:123456789012:account-association/b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7"],
    "payload": {
        "traceId": "b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7",
        "logLevel": "INFO",
        "resourceType": "account-association",
        "resourceId": "b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7",
        "connectorDestinationId": "b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7",
        "associationArn": "arn:aws:iotmanagedintegrations:ca-central-1:123456789012:account-association/b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7",
        "state": "ASSOCIATION_SUCCEEDED",
        "isServiceError": false,
        "isCustomerError": false,
        "details": "AccountAssociation has completed successfully"
    }
}

CONNECTOR_ERROR_REPORT

この通知は、成功しないレスポンスを返したコマンドやデバイス検出など、ユーザーに代わってリクエストの処理中に cloud-to-cloud (C2C) コネクタがエラーを報告すると送信されます。


{
    "version": "1.0.0",
    "messageId": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
    "messageType": "CONNECTOR_ERROR_REPORT",
    "source": "aws.iotmanagedintegrations",
    "customerAccountId": "123456789012",
    "timestamp": "2026-01-20T23:59:34.009284802Z",
    "region": "ca-central-1",
    "resources": [
        "arn:aws:iotmanagedintegrations:ca-central-1:123456789012:account-association/a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"
    ],
    "payload": {
        "statusCode": 0,
        "resourceType": "account-association",
        "resourceId": [
            "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"
        ],
        "associationArn": [
            "arn:aws:iotmanagedintegrations:ca-central-1:123456789012:account-association/a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"
        ],
        "connectorDestinationId": "b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7",
        "connectorDeviceId": "connectorDeviceId11597664a",
        "operation": "AWS.SendCommand",
        "operationVersion": "1.0",
        "traceId": "f4be7a5d55d34cc=_1",
        "logLevel": "ERROR",
        "message": "AWS.SendCommand operation failed during asynchronous invocation of the connector: Connector response exception: responseCode=xxx, responseMessage=Mocking a ValidationException with error code xxx",
        "managedThingId": "c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8"
    }
}

managedThingId フィールドは、リクエストに対して解決できる場合に含まれます。値のないフィールドはペイロードから省略されます。

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

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

ドキュメントの表記規則

IAM ポリシーでタグ付けする

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