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à.
# Argomenti MQTT
Gli argomenti MQTT identificano i AWS IoT messaggi. AWS IoT i client identificano i messaggi che pubblicano assegnando ai messaggi i nomi degli argomenti. I client identificano i messaggi a cui si desidera effettuare la sottoscrizione (ricevere) registrando un filtro argomento con AWS IoT Core. Il broker di messaggi usa nomi e filtri argomento per instradare messaggi dai client di pubblicazione ai client di sottoscrizione.
Il broker di messaggi utilizza argomenti per identificare messaggi inviati tramite MQTT e inviati tramite HTTP a [URL del messaggio HTTPS](http.md#httpurl).
Sebbene AWS IoT supporti alcuni [argomenti di sistema riservati](reserved-topics.md), la maggior parte degli argomenti MQTT viene creata e gestita dall'utente, il progettista del sistema. AWS IoT utilizza gli argomenti per identificare i messaggi ricevuti dai client di pubblicazione e selezionare i messaggi da inviare ai client abbonati, come descritto nelle sezioni seguenti. Prima di creare uno spazio dei nomi degli argomenti per il sistema, esaminare le caratteristiche degli argomenti MQTT per creare la gerarchia dei nomi degli argomenti più adatta al sistema IoT.
## Nomi argomento
I nomi degli argomenti e i filtri degli argomenti sono stringhe codificate in UTF-8. Possono rappresentare una gerarchia di informazioni utilizzando il carattere barra (/) per separare i livelli della gerarchia. Ad esempio, il nome di questo argomento potrebbe riferirsi a un sensore di temperatura nella stanza 1:
+ `sensor/temperature/room1`
In questo esempio, potrebbero esserci altri tipi di sensori in altre stanze con nomi di argomenti come:
+ `sensor/temperature/room2`
+ `sensor/humidity/room1`
+ `sensor/humidity/room2`
**Nota**
Considerando i nomi degli argomenti per i messaggi nel sistema, tieni presente:
I nomi degli argomenti e i filtri degli argomenti distinguono tra maiuscole e minuscole.
I nomi degli argomenti non devono contenere informazioni di identificazione personale.
I nomi degli argomenti che iniziano con \$1 sono [argomenti riservati](reserved-topics.md)che possono essere utilizzati solo da AWS IoT Core.
AWS IoT Core non posso inviare o ricevere messaggi tra Account AWS s o regioni.
Per ulteriori informazioni sulla progettazione dei nomi degli argomenti e dello spazio dei nomi, consulta il nostro whitepaper [Progettazione di argomenti MQTT per AWS IoT Core](https://docs.aws.amazon.com/whitepapers/latest/designing-mqtt-topics-aws-iot-core/designing-mqtt-topics-aws-iot-core.html).
Per esempi di come le app possono pubblicare e sottoscrivere messaggi, inizia con [Guida introduttiva ai AWS IoT Core tutorial](iot-gs.md) e [AWS IoT Client per dispositivi SDKs SDKs, dispositivi mobili e AWS IoT dispositivi mobili](iot-sdks.md).
**Importante**
Lo spazio dei nomi degli argomenti è limitato a una regione Account AWS and. Ad esempio, l'`sensor/temp/room1`argomento utilizzato da una Account AWS regione è distinto dall'`sensor/temp/room1`argomento utilizzato dallo stesso AWS account in un'altra regione o utilizzato da qualsiasi altro Account AWS in qualsiasi regione.
## Topic ARN (ARN argomento)
Tutti gli argomenti ARNs (Amazon Resource Names) hanno il seguente formato:
```
arn:aws:iot:aws-region:AWS-account-ID:topic/Topic
```
Ad esempio `arn:aws:iot:us-west-2:123EXAMPLE456:topic/application/topic/device/sensor` è un ARN per l'argomento ` application/topic/device/sensor`.
## Filtri per i nomi degli argomenti
I clienti abbonati registrano i filtri dei nomi degli argomenti con il broker di messaggi per specificare gli argomenti dei messaggi che il broker dei messaggi deve inviare loro. Un filtro per i nomi di argomento può essere un singolo nome di argomento per sottoscrivere un singolo nome di argomento oppure può includere caratteri jolly per sottoscrivere più nomi di argomento contemporaneamente.
I client di pubblicazione non possono utilizzare caratteri jolly nei nomi degli argomenti che pubblicano.
Nella tabella seguente sono elencati i caratteri jolly che possono essere utilizzati in un filtro argomento.
**Caratteri jolly per gli argomenti**
| Carattere jolly. | Corrispondenze | Note |
| --- | --- | --- |
| \$1 | Tutte le stringhe al livello e al di sotto del livello nella gerarchia degli argomenti. | Deve essere l'ultimo carattere nel filtro argomento. Deve essere l'unico carattere nel suo livello della gerarchia degli argomenti. Può essere utilizzato in un filtro argomento che contiene anche il carattere jolly \$1. |
| \$1 | Qualsiasi stringa nel livello che contiene il carattere. | Deve essere l'unico carattere nel suo livello della gerarchia degli argomenti. Può essere utilizzato in più livelli di un filtro argomento. |
Utilizzo di caratteri jolly con gli esempi di nomi dell'argomento del sensore precedenti:
+ Una sottoscrizione di `sensor/#` riceve i messaggi pubblicati in `sensor/`, `sensor/temperature` e `sensor/temperature/room1`, ma non i messaggi pubblicati in `sensor`.
+ Una sottoscrizione a `sensor/+/room1` riceve i messaggi pubblicati a `sensor/temperature/room1` e `sensor/humidity/room1`, ma non messaggi inviati a `sensor/temperature/room2` o `sensor/humidity/room2`.
### ARN del filtro argomenti
Il filtro per tutti gli argomenti ARNs (Amazon Resource Names) ha la seguente forma:
```
arn:aws:iot:aws-region:AWS-account-ID:topicfilter/TopicFilter
```
Ad esempio, `arn:aws:iot:us-west-2:123EXAMPLE456:topicfilter/application/topic/+/sensor` è un ARN per il filtro argomento` application/topic/+/sensor`.
# Payload del messaggio MQTT
Il payload dei messaggi che viene inviato nei tuoi messaggi MQTT non è specificato da AWS IoT, a meno che non sia per uno dei. [Argomenti riservati](reserved-topics.md) Per soddisfare le esigenze della tua applicazione, ti consigliamo di definire il payload dei messaggi per gli argomenti entro i vincoli di [AWS IoT Core Service Quotas per i protocolli](https://docs.aws.amazon.com/general/latest/gr/iot-core.html#iot-protocol-limits).
L'utilizzo di un formato JSON per il payload dei messaggi consente al motore di AWS IoT regole di analizzare i messaggi e applicare ad essi query SQL. Se l'applicazione non richiede che il motore delle regole applichi query SQL ai payload dei messaggi, è possibile utilizzare qualsiasi formato di dati richiesto dall'applicazione. Per informazioni sulle limitazioni e sui caratteri riservati in un documento JSON utilizzato nelle query SQL, consulta [Estensioni JSON](iot-sql-json.md).
Per ulteriori informazioni sulla progettazione degli argomenti MQTT e dei relativi payload dei messaggi, consulta [Progettazione di argomenti MQTT per AWS IoT Core](https://docs.aws.amazon.com/whitepapers/latest/designing-mqtt-topics-aws-iot-core/designing-mqtt-topics-aws-iot-core.html).
Se un limite di dimensioni del messaggio supera le quote di servizio, restituirà un `CLIENT_ERROR` con motivo `PAYLOAD_LIMIT_EXCEEDED` e il messaggio "Message payload exceeds size limit for message type" ("Il payload del messaggio supera il limite di dimensione per il tipo di messaggio"). Per ulteriori informazioni sul limite delle dimensioni dei messaggi, consulta la sezione [Limiti e quote del broker di messaggi AWS IoT Core](https://docs.aws.amazon.com//general/latest/gr/iot-core.html#message-broker-limits.html).
# Argomenti riservati
Gli argomenti che iniziano con il simbolo del dollaro (\$1) sono riservati a AWS IoT. È possibile effettuare la sottoscrizione e la pubblicazione di questi argomenti riservati, tuttavia non è possibile creare nuovi argomenti che inizino con il simbolo del dollaro. Le operazioni di pubblicazione o sottoscrizione non supportate di argomenti riservati possono causare la chiusura della connessione.
## Argomenti del modello di asset
| Topic | Operazioni client consentite | Description |
| --- | --- | --- |
| \$1 aws/sitewise/asset -models/ /assets/ *assetModelId* /properties/ *assetId* *propertyId* | Subscribe | AWS IoT SiteWise pubblica notifiche sulle proprietà degli asset relative a questo argomento. Per ulteriori informazioni, consulta [Interazione con altri AWS servizi nella Guida](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/interact-with-other-services.html) per l'*AWS IoT SiteWise utente*. |
## AWS IoT Device Defender argomenti
Questi messaggi supportano i buffer di risposta in formato Concise Binary Object Representation (CBOR) e JavaScript Object Notation (JSON), a seconda dell'argomento. *payload-format* AWS IoT Device Defender gli argomenti supportano solo la pubblicazione in formato MQTT.
| *payload-format* | Tipo di dati del formato della risposta |
| --- | --- |
| cbor | Concise Binary Object Representation (CBOR) |
| json | JavaScript Notazione di oggetti (JSON) |
Per ulteriori informazioni, consulta [Invio di metriche dai dispositivi](https://docs.aws.amazon.com/iot-device-defender/latest/devguide/detect-device-side-metrics.html#DetectMetricsMessages).
| Topic | Operazioni consentite | Description |
| --- | --- | --- |
| \$1aws/things/ *thingName* /defender/metrics/ *payload-format* | Pubblica | AWS IoT Device Defender gli agenti pubblicano le metriche relative a questo argomento. Per ulteriori informazioni, consulta [Invio di metriche dai dispositivi](https://docs.aws.amazon.com/iot-device-defender/latest/devguide/detect-device-side-metrics.html#DetectMetricsMessages). |
| \$1aws/things/ /defender/metrics/ /accepted *thingName* *payload-format* | Subscribe | AWS IoT viene pubblicato su questo argomento dopo che un agente ha pubblicato con successo un messaggio su \$1aws/things/ /defender/metrics/. AWS IoT Device Defender *thingName* *payload-format* Per ulteriori informazioni[, consulta](https://docs.aws.amazon.com/iot-device-defender/latest/devguide/detect-device-side-metrics.html#DetectMetricsMessages) Invio di metriche dai dispositivi. |
| \$1aws/things/ /defender/metrics/ /rejected *thingName* *payload-format* | Subscribe | AWS IoT viene pubblicato su questo argomento dopo che un agente ha pubblicato un messaggio non riuscito su \$1aws/things/ /defender/metrics/. AWS IoT Device Defender *thingName* *payload-format* Per ulteriori informazioni[, consulta](https://docs.aws.amazon.com/iot-device-defender/latest/devguide/detect-device-side-metrics.html#DetectMetricsMessages) Invio di metriche dai dispositivi. |
## AWS IoT Core Argomenti sulla posizione dei dispositivi
AWS IoT Core Device Location può risolvere i dati di misurazione dal dispositivo e fornire una posizione stimata dei dispositivi IoT. I dati di misurazione del dispositivo possono includere GNSS, Wi-Fi, rete cellulare e indirizzo IP. AWS IoT Core Device Location sceglie quindi il tipo di misurazione che offre la massima precisione e risolve le informazioni sulla posizione del dispositivo. Per ulteriori informazioni, consultare [AWS IoT Core Ubicazione del dispositivo](device-location.md) e [Risoluzione della posizione del dispositivo utilizzando gli argomenti MQTT di AWS IoT Core Device Location](device-location-reserved-topics.md).
| Topic | Operazioni consentite | Description |
| --- | --- | --- |
| \$1aws/device\$1location/ /get\$1position\$1estimate *customer\$1device\$1id* | Pubblica | Un dispositivo pubblica su questo argomento per ottenere i dati di misurazione grezzi scansionati da risolvere tramite Device Location. AWS IoT Core |
| \$1aws/device\$1location/ /get\$1position\$1estimate/accepted *customer\$1device\$1id* | Subscribe | AWS IoT Core Device Location viene pubblicato su questo argomento dopo aver risolto correttamente la posizione del dispositivo. |
| \$1aws/device\$1location/ /get\$1position\$1estimate/rejected *customer\$1device\$1id* | Subscribe | AWS IoT Core Device Location viene pubblicato su questo argomento quando non è in grado di risolvere correttamente la posizione del dispositivo a causa di errori 4xx. |
## Argomenti di eventi
I messaggi relativi agli eventi vengono pubblicati quando si verificano determinati eventi. Ad esempio, vengono generati eventi dal registro quando vengono aggiunti, aggiornati o eliminati oggetti. La tabella mostra i vari AWS IoT eventi e i relativi argomenti riservati.
| Topic | Operazioni client consentite | Description |
| --- | --- | --- |
| \$1aws/events/certificates/registered/*caCertificateId* | Subscribe | AWS IoT pubblica questo messaggio quando registra AWS IoT automaticamente un certificato e quando un client presenta un certificato con lo `PENDING_ACTIVATION` stato. Per ulteriori informazioni, consulta [Configurare la prima connessione da parte di un client per la registrazione automatica](auto-register-device-cert.md#configure-auto-reg-first-connect). |
| \$1/aws/events/job/annullato *jobID* | Subscribe | AWS IoT pubblica questo messaggio quando un lavoro viene annullato. Per ulteriori informazioni, consulta [Eventi del servizio Jobs](events-jobs.md). |
| \$1//cancellazione\$1in corso aws/events/job jobID | Subscribe | AWS IoT pubblica questo messaggio quando è in corso l'annullamento di un lavoro. Per ulteriori informazioni, consulta [Eventi del servizio Jobs](events-jobs.md). |
| \$1aws/events/job//completato *jobID* | Subscribe | AWS IoT pubblica questo messaggio quando un lavoro è completato. Per ulteriori informazioni, consulta [Eventi del servizio Jobs](events-jobs.md). |
| \$1aws/events/job//cancellato jobID | Subscribe | AWS IoT pubblica questo messaggio quando viene eliminato un lavoro. Per ulteriori informazioni, consulta [Eventi del servizio Jobs](events-jobs.md). |
| \$1aws/events/job/jobID/deletion\$1in\$1progress | Subscribe | AWS IoT pubblica questo messaggio quando è in corso l'eliminazione di un lavoro. Per ulteriori informazioni, consulta [Eventi del servizio Jobs](events-jobs.md). |
| \$1aws/events/jobExecution/jobID/annullato | Subscribe | AWS IoT pubblica questo messaggio quando l'esecuzione di un lavoro viene annullata. Per ulteriori informazioni, consulta [Eventi del servizio Jobs](events-jobs.md). |
| \$1//eliminato aws/events/jobExecution jobID | Subscribe | AWS IoT pubblica questo messaggio quando viene eliminata l'esecuzione di un lavoro. Per ulteriori informazioni, consulta [Eventi del servizio Jobs](events-jobs.md). |
| \$1aws/events/jobExecution/jobID/non riuscito | Subscribe | AWS IoT pubblica questo messaggio quando l'esecuzione di un lavoro non è riuscita. Per ulteriori informazioni, consulta [Eventi del servizio Jobs](events-jobs.md). |
| \$1aws/events/jobExecution//rifiutato jobID | Subscribe | AWS IoT pubblica questo messaggio quando l'esecuzione di un lavoro è stata rifiutata. Per ulteriori informazioni, consulta [Eventi del servizio Jobs](events-jobs.md). |
| \$1aws/events/jobExecution//rimosso jobID | Subscribe | AWS IoT pubblica questo messaggio quando è stata rimossa l'esecuzione di un lavoro. Per ulteriori informazioni, consulta [Eventi del servizio Jobs](events-jobs.md). |
| \$1aws/events/jobExecution//riuscito jobID | Subscribe | AWS IoT pubblica questo messaggio quando l'esecuzione di un lavoro è riuscita. Per ulteriori informazioni, consulta [Eventi del servizio Jobs](events-jobs.md). |
| \$1//timed\$1out aws/events/jobExecution jobID | Subscribe | AWS IoT pubblica questo messaggio quando scade il timeout dell'esecuzione di un job. Per ulteriori informazioni, consulta [Eventi del servizio Jobs](events-jobs.md). |
| \$1aws/events/presence/connected/*clientId* | Subscribe | AWS IoT pubblica su questo argomento quando un client MQTT con l'ID client specificato si connette a. AWS IoT Per ulteriori informazioni, consulta [Eventi di connessione/disconnessione](life-cycle-events.md#connect-disconnect). |
| \$1aws/events/presence/disconnected/*clientId* | Subscribe | AWS IoT pubblica su questo argomento quando un client MQTT con l'ID client specificato si disconnette a. AWS IoT Per ulteriori informazioni, consulta [Eventi di connessione/disconnessione](life-cycle-events.md#connect-disconnect). |
| \$1aws/events/subscriptions/subscribed/*clientId* | Subscribe | AWS IoT pubblica su questo argomento quando un client MQTT con l'ID client specificato sottoscrive un argomento MQTT. Per ulteriori informazioni, consulta [Eventi di sottoscrizione/annullamento della sottoscrizione](life-cycle-events.md#subscribe-unsubscribe-events). |
| \$1aws/events/subscriptions/unsubscribed/*clientId* | Subscribe | AWS IoT pubblica su questo argomento quando un client MQTT con l'ID client specificato annulla l'iscrizione a un argomento MQTT. Per ulteriori informazioni, consulta [Eventi di sottoscrizione/annullamento della sottoscrizione](life-cycle-events.md#subscribe-unsubscribe-events). |
| \$1//creato aws/events/thing *thingName* | Subscribe | AWS IoT pubblica su questo argomento quando l'*thingName*oggetto viene creato. Per ulteriori informazioni, consulta [Eventi del registro](registry-events.md). |
| \$1aws/events/thing//aggiornato *thingName* | Subscribe | AWS IoT viene pubblicato su questo argomento quando l'*thingName*elemento viene aggiornato. Per ulteriori informazioni, consulta [Eventi del registro](registry-events.md). |
| \$1aws/events/thing//eliminato *thingName* | Subscribe | AWS IoT pubblica su questo argomento quando l'*thingName*elemento viene eliminato. Per ulteriori informazioni, consulta [Eventi del registro](registry-events.md). |
| \$1aws/events/thingGroup//created *thingGroupName* | Subscribe | AWS IoT pubblica su questo argomento quando viene creato il gruppo di oggetti*thingGroupName*. Per ulteriori informazioni, consulta [Eventi del registro](registry-events.md). |
| \$1aws/events/thingGroup//aggiornato *thingGroupName* | Subscribe | AWS IoT pubblica su questo argomento quando il gruppo di cose *thingGroupName* viene aggiornato. Per ulteriori informazioni, consulta [Eventi del registro](registry-events.md). |
| \$1aws/events/thingGroup//eliminato *thingGroupName* | Subscribe | AWS IoT pubblica su questo argomento quando il gruppo di oggetti *thingGroupName* viene eliminato. Per ulteriori informazioni, consulta [Eventi del registro](registry-events.md). |
| \$1aws/events/thingType//created *thingTypeName* | Subscribe | AWS IoT pubblica su questo argomento quando viene creato il tipo di *thingTypeName* oggetto. Per ulteriori informazioni, consulta [Eventi del registro](registry-events.md). |
| \$1aws/events/thingType//aggiornato *thingTypeName* | Subscribe | AWS IoT viene pubblicato su questo argomento quando il tipo di *thingTypeName* oggetto viene aggiornato. Per ulteriori informazioni, consulta [Eventi del registro](registry-events.md). |
| \$1aws/events/thingType//eliminato *thingTypeName* | Subscribe | AWS IoT pubblica su questo argomento quando il tipo di *thingTypeName* oggetto viene eliminato. Per ulteriori informazioni, consulta [Eventi del registro](registry-events.md). |
| \$1aws/events/thingTypeAssociation/thing/*thingName*/*thingTypeName* | Subscribe | AWS IoT pubblica su questo argomento quando l'oggetto *thingName* è associato o dissociato dal tipo di oggetto. *thingTypeName* Per ulteriori informazioni, consulta [Eventi del registro](registry-events.md). |
| \$1aws/events/thingGroupMembership/thingGroup//thing/ /added *thingGroupName* *thingName* | Subscribe | AWS IoT pubblica su questo argomento quando un oggetto *thingName* viene aggiunto al gruppo di oggetti. *thingGroupName* Per ulteriori informazioni, consulta [Eventi del registro](registry-events.md). |
| \$1aws/events/thingGroupMembership/thingGroup//thing/ *thingGroupName* /rimosso *thingName* | Subscribe | AWS IoT pubblica su questo argomento quando un oggetto *thingName* viene rimosso dal gruppo di oggetti. *thingGroupName* Per ulteriori informazioni, consulta [Eventi del registro](registry-events.md). |
| \$1aws/events/thingGroupHierarchy/thingGroup/*parentThingGroupName*childThingGroup//aggiunto *childThingGroupName* | Subscribe | AWS IoT pubblica su questo argomento quando il gruppo di oggetti *childThingGroupName* viene aggiunto al gruppo di oggetti. *parentThingGroupName* Per ulteriori informazioni, consulta [Eventi del registro](registry-events.md). |
| \$1aws/events/thingGroupHierarchy/thingGroup/*parentThingGroupName*childThingGroup//rimosso *childThingGroupName* | Subscribe | AWS IoT pubblica su questo argomento quando il gruppo di oggetti *childThingGroupName* viene rimosso dal gruppo di oggetti. *parentThingGroupName* Per ulteriori informazioni, consulta [Eventi del registro](registry-events.md). |
## Argomenti relativi al provisioning del parco istanze
**Nota**
Le operazioni client contrassegnate come **Receive** in questa tabella indicano gli argomenti che vengono AWS IoT pubblicati direttamente sul client che li ha richiesti, indipendentemente dal fatto che il client abbia sottoscritto l'argomento o meno. I clienti dovrebbero aspettarsi di ricevere questi messaggi di risposta anche se non si sono abbonati a loro. Questi messaggi di risposta non passano attraverso il broker di messaggi e non possono essere sottoscritti da altri client o regole.
Questi messaggi supportano i buffer di risposta in formato Concise Binary Object Representation (CBOR) e JavaScript Object Notation (JSON), a seconda dell'argomento. *payload-format*
| *payload-format* | Tipo di dati del formato della risposta |
| --- | --- |
| cbor | Concise Binary Object Representation (CBOR) |
| json | JavaScript Notazione di oggetti (JSON) |
Per ulteriori informazioni, consulta [API MQTT di provisioning del dispositivo](fleet-provision-api.md).
| Topic | Operazioni client consentite | Description |
| --- | --- | --- |
| \$1aws/certificates/create/*payload-format* | Pubblica | Pubblicare in questo argomento per creare un certificato da una richiesta di firma del certificato (CSR). |
| \$1//accettato aws/certificates/create *payload-format* | Sottoscriviti, Ricevi | AWS IoT pubblica su questo argomento dopo una chiamata riuscita a \$1aws/certificates/create/. *payload-format* |
| \$1aws/certificates/create//rifiutato *payload-format* | Sottoscriviti, Ricevi | AWS IoT pubblica su questo argomento dopo una chiamata non riuscita a \$1/. aws/certificates/create *payload-format* |
| \$1 -from-csr/ aws/certificates/create *payload-format* | Pubblica | Pubblica in questo argomento per creare un certificato da una CSR. |
| \$1 aws/certificates/create -from-csr/ /accettato *payload-format* | Sottoscriviti, Ricevi | AWS IoT pubblica su questo argomento una chiamata riuscita a \$1 -from-csr/. aws/certificates/create *payload-format* |
| \$1 -from-csr/ /rejected aws/certificates/create *payload-format* | Sottoscriviti, Ricevi | AWS IoT pubblica su questo argomento una chiamata non riuscita a \$1 -from-csr/. aws/certificates/create *payload-format* |
| *templateName*\$1aws/provisioning-templates/ /provision/ *payload-format* | Pubblica | Pubblica in questo argomento per registrare un oggetto. |
| \$1aws/provisioning-templates/ *templateName* /provision/ /accepted *payload-format* | Sottoscriviti, Ricevi | AWS IoT pubblica su questo argomento dopo una chiamata riuscita a \$1aws/provisioning-templates/ /provision/. *templateName* *payload-format* |
| \$1aws/provisioning-templates/ /provision/ /rejected *templateName* *payload-format* | Sottoscriviti, Ricevi | AWS IoT pubblica su questo argomento dopo una chiamata non riuscita a \$1aws/provisioning-templates/ /provision/. *templateName* *payload-format* |
## Argomenti di processo
**Nota**
**Le operazioni client indicate come Receive in questa tabella indicano gli argomenti che vengono AWS IoT pubblicati direttamente sul client che li ha richiesti, indipendentemente dal fatto che il client abbia sottoscritto l'argomento o meno.** I clienti dovrebbero aspettarsi di ricevere questi messaggi di risposta anche se non si sono abbonati a loro.
Questi messaggi di risposta 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à di lavoro, utilizza il `notify` e gli argomenti `notify-next`.
Quando si sottoscrive il processo e argomenti di evento `jobExecution` per la tua soluzione di monitoraggio del parco istanze, devi prima abilitare [eventi di processo e di esecuzione di processi](iot-events.md) per ricevere eventi sul lato cloud.
Per ulteriori informazioni, consulta [Operazioni API MQTT del dispositivo dei processi](jobs-mqtt-api.md).
| Topic | Operazioni client consentite | Description |
| --- | --- | --- |
| \$1aws/things/ /jobs/get *thingName* | Pubblica | I dispositivi pubblicano un messaggio in questo argomento per effettuare una richiesta `GetPendingJobExecutions`. Per ulteriori informazioni, consulta [Operazioni API MQTT del dispositivo dei processi](jobs-mqtt-api.md). |
| \$1aws/cose/ *thingName* jobs/get/accepted | Sottoscriviti, Ricevi | I dispositivi si sottoscrivono a questo argomento per ricevere risposte corrette da una richiesta `GetPendingJobExecutions`. Per ulteriori informazioni, consulta [Operazioni API MQTT del dispositivo dei processi](jobs-mqtt-api.md). |
| *thingName*\$1aws/cose//jobs/get/rejected | Sottoscriviti, Ricevi | I dispositivi sottoscrivono questo argomento per ricevere una risposta quando una richiesta `GetPendingJobExecutions` viene rifiutata. Per ulteriori informazioni, consulta [Operazioni API MQTT del dispositivo dei processi](jobs-mqtt-api.md). |
| \$1aws/things/ *thingName* /jobs/start-next | Pubblica | I dispositivi pubblicano un messaggio in questo argomento per effettuare una richiesta `StartNextPendingJobExecution`. Per ulteriori informazioni, consulta [Operazioni API MQTT del dispositivo dei processi](jobs-mqtt-api.md). |
| \$1 aws/cose/ *thingName* jobs/start-next/accepted | Sottoscriviti, Ricevi | I dispositivi si sottoscrivono a questo argomento per ricevere risposte corrette per una richiesta `StartNextPendingJobExecution`. Per ulteriori informazioni, consulta [Operazioni API MQTT del dispositivo dei processi](jobs-mqtt-api.md). |
| *thingName*\$1aws/cose//jobs/start-next/rejected | Sottoscriviti, Ricevi | I dispositivi sottoscrivono questo argomento per ricevere una risposta quando una richiesta `StartNextPendingJobExecution` viene rifiutata. Per ulteriori informazioni, consulta [Operazioni API MQTT del dispositivo dei processi](jobs-mqtt-api.md). |
| \$1aws/things/ /jobs/ /get *thingName* *jobId* | Pubblica | I dispositivi pubblicano un messaggio in questo argomento per effettuare una richiesta `DescribeJobExecution`. Per ulteriori informazioni, consulta [Operazioni API MQTT del dispositivo dei processi](jobs-mqtt-api.md). |
| \$1aws/things/ /jobs/ *thingName* /get/accepted *jobId* | Sottoscriviti, Ricevi | I dispositivi si sottoscrivono a questo argomento per ricevere risposte corrette per una richiesta `DescribeJobExecution`. Per ulteriori informazioni, consulta [Operazioni API MQTT del dispositivo dei processi](jobs-mqtt-api.md). |
| \$1aws/things/ /jobs/ *thingName* /get/rejected *jobId* | Sottoscriviti, Ricevi | I dispositivi sottoscrivono questo argomento per ricevere una risposta quando una richiesta `DescribeJobExecution` viene rifiutata. Per ulteriori informazioni, consulta [Operazioni API MQTT del dispositivo dei processi](jobs-mqtt-api.md). |
| \$1aws/things/ /jobs/ *thingName* /update *jobId* | Pubblica | I dispositivi pubblicano un messaggio in questo argomento per effettuare una richiesta `UpdateJobExecution`. Per ulteriori informazioni, consulta [Operazioni API MQTT del dispositivo dei processi](jobs-mqtt-api.md). |
| \$1aws/things/ /jobs/ *thingName* /update/accepted *jobId* | Sottoscriviti, Ricevi | I dispositivi si sottoscrivono a questo argomento per ricevere risposte corrette per una richiesta `UpdateJobExecution`. Per ulteriori informazioni, consulta [Operazioni API MQTT del dispositivo dei processi](jobs-mqtt-api.md). Nota Solo il dispositivo che pubblica su \$1aws/things/ /jobs/ /update riceve messaggi su questo argomento. *thingName* *jobId* |
| \$1aws/things/ /jobs/ /update/rejected *thingName* *jobId* | Sottoscriviti, Ricevi | I dispositivi sottoscrivono questo argomento per ricevere una risposta quando una richiesta `UpdateJobExecution` viene rifiutata. Per ulteriori informazioni, consulta [Operazioni API MQTT del dispositivo dei processi](jobs-mqtt-api.md). Nota Solo il dispositivo che pubblica su \$1aws/things/ /jobs/ /update riceve messaggi su questo argomento. *thingName* *jobId* |
| \$1aws/things/ /jobs/notify *thingName* | Sottoscriviti, Ricevi | I dispositivi si sottoscrivono a questo argomento per ricevere notifiche quando viene aggiunta o rimossa l'esecuzione di un lavoro nell'elenco di esecuzioni in sospeso per una cosa. Per ulteriori informazioni, consulta [Operazioni API MQTT del dispositivo dei processi](jobs-mqtt-api.md). |
| \$1aws/things/ /jobs/notify-next *thingName* | Sottoscriviti, Ricevi | I dispositivi si sottoscrivono a questo argomento per ricevere notifiche quando viene modificata la successiva esecuzione del processo in sospeso per la cosa. Per ulteriori informazioni, consulta [Operazioni API MQTT del dispositivo dei processi](jobs-mqtt-api.md). |
| \$1//completato aws/events/job *jobId* | Subscribe | Il servizio Jobs pubblica un evento in questo argomento al termine di un processo. Per ulteriori informazioni, consulta [Eventi del servizio Jobs](events-jobs.md). |
| \$1aws/events/job/*jobId*/annullato | Subscribe | Il servizio Jobs pubblica un evento in questo argomento quando un processo viene annullato. Per ulteriori informazioni, consulta [Eventi del servizio Jobs](events-jobs.md). |
| \$1//eliminato aws/events/job *jobId* | Subscribe | Il servizio Jobs pubblica un evento su questo argomento quando un lavoro viene cancellato. Per ulteriori informazioni, consulta [Eventi del servizio Jobs](events-jobs.md). |
| \$1aws/events/job/*jobId*/cancellazione\$1in corso | Subscribe | Il servizio Jobs pubblica un evento in questo argomento quando inizia l'annullamento del processo. Per ulteriori informazioni, consulta [Eventi del servizio Jobs](events-jobs.md). |
| \$1aws/events/job/*jobId*/eliminazione\$1in corso | Subscribe | Il servizio Jobs pubblica un evento in questo argomento quando inizia l'eliminazione di un processo. Per ulteriori informazioni, consulta [Eventi del servizio Jobs](events-jobs.md). |
| \$1 aws/events/jobExecution*jobId*//successo | Subscribe | Il servizio Jobs pubblica un evento in questo argomento quando l'esecuzione del processo ha esito positivo. Per ulteriori informazioni, consulta [Eventi del servizio Jobs](events-jobs.md). |
| \$1/aws/events/jobExecution/non riuscito *jobId* | Subscribe | Il servizio Jobs pubblica un evento in questo argomento quando l'esecuzione di un processo non riesce. Per ulteriori informazioni, consulta [Eventi del servizio Jobs](events-jobs.md). |
| \$1aws/events/jobExecution//rifiutato *jobId* | Subscribe | Il servizio Jobs pubblica un evento in questo argomento quando viene respinta l'esecuzione di un processo. Per ulteriori informazioni, consulta [Eventi del servizio Jobs](events-jobs.md). |
| \$1aws/events/jobExecution/*jobId*/annullato | Subscribe | Il servizio Jobs pubblica un evento in questo argomento quando viene annullata l'esecuzione di un processo. Per ulteriori informazioni, consulta [Eventi del servizio Jobs](events-jobs.md). |
| \$1//time\$1out aws/events/jobExecution *jobId* | Subscribe | Il servizio Jobs pubblica un evento in questo argomento quando si verifica il timeout dell'esecuzione di un processo. Per ulteriori informazioni, consulta [Eventi del servizio Jobs](events-jobs.md). |
| \$1 aws/events/jobExecution*jobId*//rimosso | Subscribe | Il servizio Jobs pubblica un evento in questo argomento quando viene rimossa l'esecuzione di un processo. Per ulteriori informazioni, consulta [Eventi del servizio Jobs](events-jobs.md). |
| \$1aws/events/jobExecution//eliminato *jobId* | Subscribe | Il servizio Jobs pubblica un evento in questo argomento quando viene eliminata l'esecuzione di un processo. Per ulteriori informazioni, consulta [Eventi del servizio Jobs](events-jobs.md). |
## Argomenti sui comandi
**Nota**
Le operazioni client indicate come **Receive** in questa tabella indicano gli argomenti che vengono AWS IoT pubblicati direttamente sul client che li ha richiesti, indipendentemente dal fatto che il client abbia sottoscritto l'argomento o meno. I clienti dovrebbero aspettarsi di ricevere questi messaggi di risposta anche se non si sono abbonati a loro.
Questi messaggi di risposta non passano attraverso il broker di messaggi e non possono essere sottoscritti da altri client o regole.
| Topic | Operazioni client consentite | Description |
| --- | --- | --- |
| \$1aws/commands/ /executions/ /request/ ** ** ** ** \$1aws/comandi/ ** ** /esecuzioni/ /richiesta ** | Sottoscriviti, Ricevi | I dispositivi ricevono un messaggio su questo argomento quando viene effettuata una richiesta per avviare l'esecuzione di un comando dalla console o utilizzando l'API. `StartCommandExecution` In questo caso, ** possono essere oggetti IoT o client MQTT e ** possono essere il nome dell'oggetto IoT o l'ID del client MQTT. |
| \$1aws/commands///esecuzioni/ /response/ ** ** ** ** | Pubblica | I dispositivi utilizzano l'API `UpdateCommandExecution` MQTT per pubblicare un messaggio su questo argomento sull'esecuzione del comando. Il messaggio viene pubblicato come risposta alla richiesta di avviare l'esecuzione di un comando dalla console o utilizzando l'`StartCommandExecution`API. Il messaggio pubblicato utilizzerà JSON o CBOR come. ** |
| \$1aws/commands///executions/ /response/accepted/ ** ** ** ** \$1aws/comandi/ ** ** /esecuzioni/ /response/accepted ** | Sottoscriviti, Ricevi | Se il servizio cloud ha elaborato correttamente il risultato dell'esecuzione del comando, pubblica una risposta all'argomento /accepted. AWS IoT Device Management |
| \$1aws/commands///executions/ /response/rejected/ ** ** ** ** \$1aws/comandi/ ** ** /esecuzioni/ /response/rejected ** | Pubblica | Se il servizio cloud non è riuscito a elaborare il risultato dell'esecuzione del comando, pubblica una risposta all'argomento /rejecte. AWS IoT Device Management |
## Argomenti di regole
| Topic | Operazioni client consentite | Description |
| --- | --- | --- |
| \$1aws/regole/ *ruleName* | Pubblica | Un dispositivo o un'applicazione pubblica su questo argomento per arrivare le regole direttamente. Per ulteriori informazioni, consulta [Riduzione dei costi di messaggistica con Basic Ingest](iot-basic-ingest.md). |
## Argomenti di tunneling sicuro
| Topic | Operazioni client consentite | Description |
| --- | --- | --- |
| \$1aws/things/ /tunnels/notify *thing-name* | Subscribe | AWS IoT pubblica questo messaggio per consentire a un agente IoT di avviare un proxy locale sul dispositivo remoto. Per ulteriori informazioni, consulta [Snippet dell'agente IoT](configure-remote-device.md#agent-snippet). |
## Argomenti copie shadow
Gli argomenti di questa sezione vengono utilizzati da copie shadow con nome e senza nome. Gli argomenti utilizzati da ciascuno differiscono solo nel prefisso dell'argomento. Questa tabella mostra il prefisso dell'argomento utilizzato da ogni tipo di copia shadow.
| *ShadowTopicPrefix* value | Tipo di copia shadow |
| --- | --- |
| \$1aws/things/ /shadow thingName | Copia shadow senza nome (classica) |
| \$1aws/things/ thingName /shadow/name/ shadowName | Copia shadow con nome |
Per creare un argomento completo, seleziona il *ShadowTopicPrefix* tipo di ombra a cui vuoi fare riferimento, sostituiscilo *thingName* e, se applicabile, con i valori corrispondenti*shadowName*, quindi aggiungilo con lo stub dell'argomento come mostrato nella tabella seguente. Ricorda che gli argomenti prevedono una distinzione tra lettere maiuscole e minuscole.
| Topic | Operazioni client consentite | Description |
| --- | --- | --- |
| *ShadowTopicPrefix*/elimina | Pubblicazione/Sottoscrizione | Un dispositivo o un'applicazione pubblica in questo argomento per eliminare una copia shadow. Per ulteriori informazioni, consulta [/delete](device-shadow-mqtt.md#delete-pub-sub-topic). |
| *ShadowTopicPrefix*/elimina/accettato | Subscribe | Il servizio Device Shadow invia messaggi a questo argomento quando viene eliminata una copia shadow. Per ulteriori informazioni, consulta [/delete/accepted](device-shadow-mqtt.md#delete-accepted-pub-sub-topic). |
| *ShadowTopicPrefix*/elimina/rifiutato | Subscribe | Il servizio Device Shadow invia messaggi a questo argomento quando viene rifiutata una richiesta di eliminazione di una copia shadow. Per ulteriori informazioni, consulta [/delete/rejected](device-shadow-mqtt.md#delete-rejected-pub-sub-topic). |
| *ShadowTopicPrefix*/ottenere | Pubblicazione/Sottoscrizione | Un'applicazione o un oggetto pubblica un messaggio vuoto in questo argomento per ottenere una copia shadow. Per ulteriori informazioni, consulta [Argomenti MQTT di Device Shadow](device-shadow-mqtt.md). |
| *ShadowTopicPrefix*/get/accepted | Subscribe | Il servizio Device Shadow invia messaggi a questo argomento quando viene effettuata correttamente una richiesta di una copia shadow. Per ulteriori informazioni, consulta [/get/accepted](device-shadow-mqtt.md#get-accepted-pub-sub-topic). |
| *ShadowTopicPrefix*/get/rejected | Subscribe | Il servizio Device Shadow invia messaggi a questo argomento quando viene rifiutata una richiesta di una copia shadow. Per ulteriori informazioni, consulta [/get/rejected](device-shadow-mqtt.md#get-rejected-pub-sub-topic). |
| *ShadowTopicPrefix*/aggiornare | Pubblicazione/Sottoscrizione | Un oggetto o un'applicazione pubblica in questo argomento per aggiornare una copia shadow. Per ulteriori informazioni, consulta [/update](device-shadow-mqtt.md#update-pub-sub-topic). |
| *ShadowTopicPrefix*/update/accettato | Subscribe | Il servizio Device Shadow invia messaggi a questo argomento quando viene effettuato correttamente un aggiornamento di una copia shadow. Per ulteriori informazioni, consulta [/update/accepted](device-shadow-mqtt.md#update-accepted-pub-sub-topic). |
| *ShadowTopicPrefix*/update/rifiutato | Subscribe | Il servizio Device Shadow invia messaggi a questo argomento quando viene rifiutato un aggiornamento di una copia shadow. Per ulteriori informazioni, consulta [/update/rejected](device-shadow-mqtt.md#update-rejected-pub-sub-topic). |
| *ShadowTopicPrefix*/update/delta | Subscribe | Il servizio Device Shadow invia messaggi a questo argomento quando viene rilevata una differenza tra le sezioni sullo stato segnalato e sullo stato desiderato di una copia shadow. Per ulteriori informazioni, consulta [/update/delta](device-shadow-mqtt.md#update-delta-pub-sub-topic). |
| *ShadowTopicPrefix*/aggiornamento/documenti | Subscribe | AWS IoT pubblica un documento di stato su questo argomento ogni volta che un aggiornamento dello shadow viene eseguito correttamente. Per ulteriori informazioni, consulta [/update/documents](device-shadow-mqtt.md#update-documents-pub-sub-topic). |
## Argomenti di distribuzione dei file basati su MQTT
**Nota**
Le operazioni client contrassegnate come **Receive** in questa tabella indicano gli argomenti che vengono AWS IoT pubblicati direttamente sul client che li ha richiesti, indipendentemente dal fatto che il client abbia sottoscritto l'argomento o meno. I clienti dovrebbero aspettarsi di ricevere questi messaggi di risposta anche se non si sono abbonati a loro. Questi messaggi di risposta non passano attraverso il broker di messaggi e non possono essere sottoscritti da altri client o regole.
Questi messaggi supportano i buffer di risposta in formato Concise Binary Object Representation (CBOR) e JavaScript Object Notation (JSON), a seconda dell'argomento. *payload-format*
| *payload-format* | Tipo di dati del formato della risposta |
| --- | --- |
| cbor | Concise Binary Object Representation (CBOR) |
| json | JavaScript Notazione di oggetti (JSON) |
| Topic | Operazioni client consentite | Description |
| --- | --- | --- |
| \$1aws/things/ *ThingName* /streams/ /data/ *StreamId* *payload-format* | Sottoscriviti, Ricevi | AWS La distribuzione di file basata su MQTT viene pubblicata su questo argomento se viene accettata la richiesta "" da un dispositivo. GetStream Il payload contiene i dati del flusso. Per ulteriori informazioni, consulta [Utilizzo della distribuzione di file AWS IoT basata su MQTT nei dispositivi](mqtt-based-file-delivery-in-devices.md). |
| \$1aws/things/ /streams/ /get/ *ThingName* *StreamId* *payload-format* | Pubblica | Un dispositivo pubblica su questo argomento per eseguire una richiesta "». GetStream Per ulteriori informazioni, consulta [Utilizzo della distribuzione di file AWS IoT basata su MQTT nei dispositivi](mqtt-based-file-delivery-in-devices.md). |
| \$1aws/things/ /streams/ *ThingName* /descrizione/ *StreamId* *payload-format* | Sottoscriviti, Ricevi | AWS La distribuzione di file basata su MQTT viene pubblicata su questo argomento se viene accettata la richiesta "" da un dispositivo. DescribeStream Il payload contiene la descrizione del flusso. Per ulteriori informazioni, consulta [Utilizzo della distribuzione di file AWS IoT basata su MQTT nei dispositivi](mqtt-based-file-delivery-in-devices.md). |
| \$1aws/things/ /streams/ /describe/ *ThingName* *StreamId* *payload-format* | Pubblica | Un dispositivo pubblica su questo argomento per eseguire una richiesta "». DescribeStream Per ulteriori informazioni, consulta [Utilizzo della distribuzione di file AWS IoT basata su MQTT nei dispositivi](mqtt-based-file-delivery-in-devices.md). |
| \$1aws/things/ /streams/ /rejected/ *ThingName* *StreamId* *payload-format* | Sottoscriviti, Ricevi | AWS La distribuzione di file basata su MQTT viene pubblicata su questo argomento se una richiesta "" o "" proveniente da un dispositivo viene rifiutata. DescribeStream GetStream Per ulteriori informazioni, consulta [Utilizzo della distribuzione di file AWS IoT basata su MQTT nei dispositivi](mqtt-based-file-delivery-in-devices.md). |
## ARN di argomenti riservati
Tutti gli argomenti riservati ARNs (Amazon Resource Names) hanno il seguente formato:
```
arn:aws:iot:aws-region:AWS-account-ID:topic/Topic
```
Ad esempio, `arn:aws:iot:us-west-2:123EXAMPLE456:topic/$aws/things/thingName/jobs/get/accepted` è un ARN per l'argomento riservato `$aws/things/thingName/jobs/get/accepted`.