Notifiche di integrazioni gestite - Integrazioni gestite per AWS IoT Device Management
Configura notifiche di integrazioni gestite

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Notifiche di integrazioni gestite

Notifiche di integrazioni gestite Gestisci tutte le notifiche ai clienti facilitando la comunicazione in tempo reale per fornire aggiornamenti e approfondimenti sui loro dispositivi. Che si tratti di notificare ai clienti gli eventi del dispositivo, il ciclo di vita del dispositivo o lo stato del dispositivo, le notifiche relative alle integrazioni gestite svolgono un ruolo fondamentale nel miglioramento dell'esperienza complessiva del cliente. Fornendo informazioni utilizzabili, i clienti possono prendere decisioni informate e ottimizzare l'utilizzo delle risorse.

Configura notifiche di integrazioni gestite

Per configurare le notifiche di integrazioni gestite, segui questi passaggi:

  1. Crea un flusso di dati Amazon Kinesis

    Per creare un flusso di dati Kinesis, segui i passaggi descritti in Creare e gestire flussi di dati Kinesis.

    Attualmente, solo i flussi di dati di Amazon Kinesis sono supportati come opzione per una destinazione gestita dal cliente per le notifiche di integrazioni gestite.

  2. Crea un ruolo di accesso allo stream di Amazon Kinesis

    Crea un ruolo di AWS Identity and Access Management accesso con l'autorizzazione ad accedere allo stream Kinesis che hai appena creato

    Per ulteriori informazioni, consulta la creazione di ruoli IAM nella Guida per l'AWS Identity and Access Managementutente.

  3. Concedi all'utente le autorizzazioni per chiamare l'API CreateDestination

    La seguente politica definisce i requisiti per l'utente per chiamare l'CreateDestinationAPI. Se non è impostata, la chiamata all'CreateDestinationAPI avrà esito negativo.

    Consulta Concedere a un utente le autorizzazioni per passare un ruolo a un AWS servizio nella Guida per l'AWS Identity and Access Managementutente per ottenere le autorizzazioni passrole per le integrazioni gestite. 

    
{
      "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. Chiama l'API CreateDestination

    Dopo aver creato il flusso di dati di Amazon Kinesis e il ruolo di accesso allo stream, chiama l'CreateDestinationAPI per creare una destinazione gestita dal cliente a cui verranno indirizzate le notifiche delle integrazioni gestite. Per il deliveryDestinationArn parametro, usa il nuovo arn flusso di dati di Amazon Kinesis.

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

  5. Chiama l'API CreateNotificationConfiguration

    Infine, creerai la configurazione di notifica che ti informerà del tipo di evento scelto instradando una notifica verso la destinazione gestita dal cliente rappresentata dal tuo flusso di dati Amazon Kinesis. Chiama l'CreateNotificationConfigurationAPI per creare la configurazione delle notifiche. Nel destinationName parametro, utilizzate lo stesso nome di destinazione creato inizialmente quando avete creato la destinazione gestita dal cliente utilizzando l'CreateDestinationAPI.

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

Tipi di eventi monitorati con integrazioni gestite

Di seguito sono riportati i tipi di eventi monitorati con notifiche di integrazioni gestite:

  • DEVICE_COMMAND

    • Lo stato del comando SendManagedThingAPI. I valori validi sono succeeded o 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

    • La richiesta di comando da Web Real-Time Communication (WebRTC).

      Lo standard WebRTC consente la comunicazione tra due peer. Questi peer possono trasmettere video, audio e dati arbitrari in tempo reale. Le integrazioni gestite supportano WebRTC per abilitare questi tipi di streaming tra un'applicazione mobile del cliente e il dispositivo di un utente finale. Per ulteriori informazioni sullo standard WebRTC, vedere 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

    • Lo stato di rilevamento del dispositivo.

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

    • Una notifica del verificarsi di un evento relativo al dispositivo.

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

    • Lo stato del ciclo di vita del dispositivo.

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

    • Una notifica OTA del dispositivo.

  • DEVICE_STATE

    • Una notifica quando lo stato di un dispositivo è stato aggiornato.

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