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à.
Eventi del servizio Jobs
Il servizio AWS IoT Jobs pubblica su argomenti riservati del protocollo MQTT quando i lavori sono in sospeso, completati o annullati e quando un dispositivo segnala un esito positivo o negativo durante l'esecuzione di un lavoro. I dispositivi o le applicazioni di gestione e monitoraggio permettono di tenere traccia dello stato dei processi sottoscrivendo questi argomenti.
Come abilitare eventi processi
I messaggi di risposta del servizio AWS IoT Jobs non passano attraverso il broker di messaggi e non possono essere sottoscritti da altri client o regole. Per effettuare la sottoscrizione ai messaggi relativi all'attività del processo, utilizza gli argomenti notify e notify-next. Per ulteriori informazioni sugli argomenti dei processi, consulta Argomenti di processo.
Per ricevere notifiche sugli aggiornamenti dei lavori, abilita questi eventi di lavoro utilizzando o utilizzando l'API o la CLI. AWS Management Console Per ulteriori informazioni, consulta Abilita gli eventi per AWS IoT.
Come funzionano gli eventi di processo
Poiché l'eliminazione e l'annullamento di un processo potrebbero richiedere alcuni minuti, vengono inviati due messaggi per indicare l'inizio e la fine di una richiesta. Ad esempio, quando si avvia una richiesta di annullamento, viene inviato un messaggio all'argomento $aws/events/job/jobID/cancellation_in_progress. Quando la richiesta di annullamento è completa, viene inviato un messaggio all'argomento $aws/events/job/jobID/canceled.
Lo stesso processo si verifica per una richiesta di eliminazione di un processo. Le applicazioni di gestione e monitoraggio permettono di tenere traccia dello stato dei processi sottoscrivendo questi argomenti. Per ulteriori informazioni sulla pubblicazione e sulla sottoscrizione di argomenti MQTT, consulta Protocolli di dispositivo di comunicazione.
Tipi di eventi di processo
Di seguito vengono illustrati i diversi tipi di eventi di processo:
- Processo completato/annullato/eliminato
-
Il servizio AWS IoT Jobs pubblica un messaggio su un argomento MQTT quando un lavoro viene completato, annullato, eliminato o quando la cancellazione o l'eliminazione sono in corso:
-
$aws/events/job/jobID/completed -
$aws/events/job/jobID/canceled -
$aws/events/job/jobID/deleted -
$aws/events/job/jobID/cancellation_in_progress -
$aws/events/job/jobID/deletion_in_progress
Il messaggio
completedcontiene il seguente payload di esempio:{ "eventType": "JOB", "eventId": "7364ffd1-8b65-4824-85d5-6c14686c97c6", "timestamp": 1234567890, "operation": "completed", "jobId": "27450507-bf6f-4012-92af-bb8a1c8c4484", "status": "COMPLETED", "targetSelection": "SNAPSHOT|CONTINUOUS", "targets": [ "arn:aws:iot:us-east-1:123456789012:thing/a39f6f91-70cf-4bd2-a381-9c66df1a80d0", "arn:aws:iot:us-east-1:123456789012:thinggroup/2fc4c0a4-6e45-4525-a238-0fe8d3dd21bb" ], "description": "My Job Description", "completedAt": 1234567890123, "createdAt": 1234567890123, "lastUpdatedAt": 1234567890123, "jobProcessDetails": { "numberOfCanceledThings": 0, "numberOfRejectedThings": 0, "numberOfFailedThings": 0, "numberOfRemovedThings": 0, "numberOfSucceededThings": 3 } }Il messaggio
canceledcontiene il seguente payload di esempio.{ "eventType": "JOB", "eventId": "568d2ade-2e9c-46e6-a115-18afa1286b06", "timestamp": 1234567890, "operation": "canceled", "jobId": "4d2a531a-da2e-47bb-8b9e-ff5adcd53ef0", "status": "CANCELED", "targetSelection": "SNAPSHOT|CONTINUOUS", "targets": [ "arn:aws:iot:us-east-1:123456789012:thing/Thing0-947b9c0c-ff10-4a80-b4b3-cd33d0145a0f", "arn:aws:iot:us-east-1:123456789012:thinggroup/ThingGroup1-95c644d5-1621-41a6-9aa5-ad2de581d18f" ], "description": "My job description", "createdAt": 1234567890123, "lastUpdatedAt": 1234567890123 }Il messaggio
deletedcontiene il seguente payload di esempio.{ "eventType": "JOB", "eventId": "568d2ade-2e9c-46e6-a115-18afa1286b06", "timestamp": 1234567890, "operation": "deleted", "jobId": "4d2a531a-da2e-47bb-8b9e-ff5adcd53ef0", "status": "DELETED", "targetSelection": "SNAPSHOT|CONTINUOUS", "targets": [ "arn:aws:iot:us-east-1:123456789012:thing/Thing0-947b9c0c-ff10-4a80-b4b3-cd33d0145a0f", "arn:aws:iot:us-east-1:123456789012:thinggroup/ThingGroup1-95c644d5-1621-41a6-9aa5-ad2de581d18f" ], "description": "My job description", "createdAt": 1234567890123, "lastUpdatedAt": 1234567890123, "comment": "Comment for this operation" }Il messaggio
cancellation_in_progresscontiene il seguente payload di esempio:{ "eventType": "JOB", "eventId": "568d2ade-2e9c-46e6-a115-18afa1286b06", "timestamp": 1234567890, "operation": "cancellation_in_progress", "jobId": "4d2a531a-da2e-47bb-8b9e-ff5adcd53ef0", "status": "CANCELLATION_IN_PROGRESS", "targetSelection": "SNAPSHOT|CONTINUOUS", "targets": [ "arn:aws:iot:us-east-1:123456789012:thing/Thing0-947b9c0c-ff10-4a80-b4b3-cd33d0145a0f", "arn:aws:iot:us-east-1:123456789012:thinggroup/ThingGroup1-95c644d5-1621-41a6-9aa5-ad2de581d18f" ], "description": "My job description", "createdAt": 1234567890123, "lastUpdatedAt": 1234567890123, "comment": "Comment for this operation" }Il messaggio
deletion_in_progresscontiene il seguente payload di esempio:{ "eventType": "JOB", "eventId": "568d2ade-2e9c-46e6-a115-18afa1286b06", "timestamp": 1234567890, "operation": "deletion_in_progress", "jobId": "4d2a531a-da2e-47bb-8b9e-ff5adcd53ef0", "status": "DELETION_IN_PROGRESS", "targetSelection": "SNAPSHOT|CONTINUOUS", "targets": [ "arn:aws:iot:us-east-1:123456789012:thing/Thing0-947b9c0c-ff10-4a80-b4b3-cd33d0145a0f", "arn:aws:iot:us-east-1:123456789012:thinggroup/ThingGroup1-95c644d5-1621-41a6-9aa5-ad2de581d18f" ], "description": "My job description", "createdAt": 1234567890123, "lastUpdatedAt": 1234567890123, "comment": "Comment for this operation" } -
- Stato terminale dell'esecuzione del processo
-
Il servizio AWS IoT Jobs pubblica un messaggio quando un dispositivo aggiorna l'esecuzione di un lavoro allo stato del terminale:
-
$aws/events/jobExecution/jobID/succeeded -
$aws/events/jobExecution/jobID/failed -
$aws/events/jobExecution/jobID/rejected -
$aws/events/jobExecution/jobID/canceled -
$aws/events/jobExecution/jobID/timed_out -
$aws/events/jobExecution/jobID/removed -
$aws/events/jobExecution/jobID/deleted
Il messaggio contiene il seguente payload di esempio:
{ "eventType": "JOB_EXECUTION", "eventId": "cca89fa5-8a7f-4ced-8c20-5e653afb3572", "timestamp": 1234567890, "operation": "succeeded|failed|rejected|canceled|removed|timed_out", "jobId": "154b39e5-60b0-48a4-9b73-f6f8dd032d27", "thingArn": "arn:aws:iot:us-east-1:123456789012:myThing/6d639fbc-8f85-4a90-924d-a2867f8366a7", "status": "SUCCEEDED|FAILED|REJECTED|CANCELED|REMOVED|TIMED_OUT", "statusDetails": { "key": "value" } } -
