Pemberitahuan integrasi terkelola - Integrasi terkelola untuk AWS IoT Device Management
Siapkan notifikasi integrasi terkelola

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Pemberitahuan integrasi terkelola

Pemberitahuan integrasi terkelola mengelola semua notifikasi kepada pelanggan yang memfasilitasi komunikasi waktu nyata untuk memberikan pembaruan dan wawasan di perangkat mereka. Baik itu memberi tahu pelanggan tentang peristiwa perangkat, siklus hidup perangkat, atau status perangkat, pemberitahuan integrasi terkelola memainkan peran penting dalam meningkatkan pengalaman pelanggan secara keseluruhan. Dengan memberikan informasi yang dapat ditindaklanjuti, pelanggan dapat membuat keputusan berdasarkan informasi dan mengoptimalkan pemanfaatan sumber daya.

Siapkan notifikasi integrasi terkelola

Untuk mengatur notifikasi integrasi terkelola, ikuti langkah-langkah berikut:

  1. Buat aliran data Amazon Kinesis

    Untuk membuat aliran data Kinesis, ikuti langkah-langkah yang diuraikan dalam Membuat dan mengelola aliran data Kinesis.

    Saat ini, hanya aliran data Amazon Kinesis yang didukung sebagai opsi untuk tujuan yang dikelola pelanggan untuk notifikasi integrasi terkelola.

  2. Buat peran akses aliran Amazon Kinesis

    Buat peran AWS Identity and Access Management akses yang memiliki izin untuk mengakses aliran Kinesis yang baru saja Anda buat

    Untuk informasi selengkapnya, lihat Pembuatan peran IAM di Panduan AWS Identity and Access ManagementPengguna.

  3. Berikan izin pengguna untuk memanggil API CreateDestination

    Kebijakan berikut menentukan persyaratan bagi pengguna untuk memanggil CreateDestinationAPI. Jika tidak disetel, panggilan ke CreateDestination API akan gagal.

    Lihat Memberikan izin pengguna untuk meneruskan peran ke AWS layanan di Panduan AWS Identity and Access ManagementPengguna untuk mendapatkan izin peran sandi ke integrasi terkelola. 

    
{
      "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":"*"
         }
      ]
}

  4. Panggil CreateDestination API

    Setelah Anda membuat aliran data Amazon Kinesis dan peran akses streaming, panggil CreateDestinationAPI untuk membuat tujuan yang dikelola pelanggan tempat notifikasi integrasi terkelola akan diarahkan. Untuk deliveryDestinationArn parameternya, gunakan arn aliran data Amazon Kinesis baru Anda.

    {
    "DeliveryDestinationArn": "Your Kinesis arn"
    "DeliveryDestinationType": "KINESIS"
    "Name": "DestinationName"
    "ClientToken": "Random string"
    "RoleArn": "arn:aws:iam::accountID:role/kinesis_stream_access_role"
}

  5. Panggil CreateNotificationConfiguration API

    Terakhir, Anda akan membuat konfigurasi notifikasi yang akan memberi tahu Anda tentang jenis acara yang dipilih dengan merutekan pemberitahuan ke tujuan yang dikelola pelanggan yang diwakili oleh aliran data Amazon Kinesis Anda. Panggil CreateNotificationConfigurationAPI untuk membuat konfigurasi notifikasi. Dalam destinationName parameter, gunakan nama tujuan yang sama seperti yang awalnya dibuat saat Anda membuat tujuan yang dikelola pelanggan menggunakan API. CreateDestination

    {
    "EventType": "DEVICE_EVENT"
    "DestinationName" // This name has to be identical to the name in createDestination API
    "ClientToken": "Random string"
}

Jenis acara dipantau dengan integrasi terkelola

Berikut ini adalah jenis acara yang dipantau dengan notifikasi integrasi terkelola:

  • DEVICE_COMMAND

    • Status perintah SendManagedThingAPI. Nilai yang valid adalah succeeded maupun 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

    • Permintaan perintah dari Web Real-Time Communication (WebRTC).

      Standar WebRTC memungkinkan komunikasi antara dua rekan. Rekan-rekan ini dapat mengirimkan video real-time, audio, dan data arbitrer. Integrasi terkelola mendukung WebRTC untuk mengaktifkan jenis streaming antara aplikasi seluler pelanggan dan perangkat pengguna akhir. Untuk informasi selengkapnya tentang standar WebRTC, lihat 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

    • Status penemuan perangkat.

      {
      "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

    • Pemberitahuan peristiwa perangkat yang terjadi.

      {
      "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

    • Status siklus hidup perangkat.

      { 
      "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

    • Pemberitahuan OTA perangkat.

  • DEVICE_STATE

    • Pemberitahuan saat status perangkat telah diperbarui.

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