As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Tópicos do MQTT
Os tópicos do MQTT identificam AWS IoT mensagens. AWS IoT os clientes identificam as mensagens que publicam dando nomes de tópicos às mensagens. Os clientes identificam as mensagens que desejam assinar (receber) registrando um filtro de tópico com o AWS IoT Core. O agente de mensagens usa nomes de tópicos e filtros de tópicos para rotear mensagens de clientes de publicação a clientes assinatura.
O agente de mensagens usa tópicos para identificar mensagens enviadas usando MQTT e HTTP para o [URL da mensagem HTTPS](http.md#httpurl).
Embora AWS IoT ofereça suporte a alguns [tópicos reservados do sistema](reserved-topics.md), a maioria dos tópicos do MQTT é criada e gerenciada por você, o designer do sistema. AWS IoT usa tópicos para identificar mensagens recebidas de clientes de publicação e selecionar mensagens para enviar aos clientes assinantes, conforme descrito nas seções a seguir. Antes de criar um namespace de tópico para seu sistema, revise as características dos tópicos MQTT para criar a hierarquia de nomes de tópicos que funciona melhor para seu sistema de IoT.
## Nomes de tópicos
Os nomes de tópicos e os filtros de tópicos são strings codificadas em UTF-8. Eles podem representar uma hierarquia de informações usando o caractere barra (/) para separar os níveis da hierarquia. Por exemplo, o nome deste tópico pode se referir a um sensor de temperatura no compartimento 1:
+ `sensor/temperature/room1`
Neste exemplo, também pode haver outros tipos de sensores em outros compartimentos com nomes de tópicos, como:
+ `sensor/temperature/room2`
+ `sensor/humidity/room1`
+ `sensor/humidity/room2`
**nota**
Ao considerar os nomes de tópicos para as mensagens no sistema, lembre-se de que:
Os nomes de tópicos e os filtros de tópico diferenciam letras maiúsculas de minúsculas.
Os nomes de tópicos não devem conter informações de identificação pessoal.
Os nomes de tópicos que começam com \$1 são [tópicos reservados](reserved-topics.md) para serem usados somente pelo AWS IoT Core.
AWS IoT Core não consigo enviar ou receber mensagens entre Conta da AWS s ou regiões.
Para obter mais informações sobre como criar seus nomes de tópicos e namespace, consulte nosso whitepaper, [Projetando tópicos em MQTT para AWS IoT Core](https://docs.aws.amazon.com/whitepapers/latest/designing-mqtt-topics-aws-iot-core/designing-mqtt-topics-aws-iot-core.html).
Para exemplos de como os aplicativos podem publicar e assinar mensagens, comece com [Introdução aos AWS IoT Core tutoriais](iot-gs.md) e [AWS IoT Device SDKs, Mobile SDKs e AWS IoT Device Client](iot-sdks.md).
**Importante**
O namespace do tópico é limitado a uma região Conta da AWS e. Por exemplo, o `sensor/temp/room1` tópico usado por um Conta da AWS em uma região é diferente do `sensor/temp/room1` tópico usado pela mesma AWS conta em outra região ou usado por qualquer outra Conta da AWS em qualquer região.
## Tópico ARN
Todos os tópicos ARNs (Amazon Resource Names) têm o seguinte formato:
```
arn:aws:iot:aws-region:AWS-account-ID:topic/Topic
```
Por exemplo, `arn:aws:iot:us-west-2:123EXAMPLE456:topic/application/topic/device/sensor` é um ARN para o tópico ` application/topic/device/sensor`.
## Filtros de nomes de tópicos
Os clientes assinantes registram filtros de tópico no agente de mensagens a fim de especificar os tópicos que o agente de mensagens deve enviar a eles. Um filtro de nome de tópico pode corresponder a apenas um tópico ou incluir caracteres curinga para permitir a assinatura de vários nomes de tópico simultaneamente.
Os clientes de publicação não podem usar caracteres curinga nos nomes de tópicos que publicam.
A tabela a seguir lista os caracteres curinga que podem ser usados em um filtro de tópico.
**Curingas de tópicos**
| Caractere curinga | Correspondências | Observações |
| --- | --- | --- |
| \$1 | Todas as strings de caracteres em e abaixo de seu nível na hierarquia de tópicos. | Deve ser o último caractere no filtro de tópico. Deve ser o único caractere no nível da hierarquia de tópicos. Pode ser usado em um filtro de tópico que também contém o caractere curinga \$1. |
| \$1 | Qualquer string no nível que contém o caractere. | Deve ser o único caractere no nível da hierarquia de tópicos. Pode ser usado em vários níveis de um filtro de tópico. |
Exemplos de uso de curingas com o nome de tópico do sensor anterior:
+ Uma assinatura de `sensor/#` recebe mensagens publicadas em `sensor/`, `sensor/temperature`, `sensor/temperature/room1`, mas não mensagens publicadas em `sensor`.
+ Uma assinatura de `sensor/+/room1` recebe mensagens publicadas em `sensor/temperature/room1` e `sensor/humidity/room1`, mas não mensagens enviadas para `sensor/temperature/room2` ou `sensor/humidity/room2`.
### ARN do filtro do tópico
Todos os filtros de tópicos ARNs (Amazon Resource Names) têm o seguinte formato:
```
arn:aws:iot:aws-region:AWS-account-ID:topicfilter/TopicFilter
```
Por exemplo, `arn:aws:iot:us-west-2:123EXAMPLE456:topicfilter/application/topic/+/sensor` é um ARN para o filtro de tópicos` application/topic/+/sensor`.
# Carga útil da mensagem do MQTT
A carga útil da mensagem enviada em suas mensagens do MQTT não é especificada por AWS IoT, a menos que seja para uma das. [Tópicos reservados](reserved-topics.md) Para acomodar as necessidades do seu aplicativo, recomendamos que você defina a carga útil da mensagem para seus tópicos dentro das restrições das [AWS IoT Core Service Quotas para protocolos](https://docs.aws.amazon.com/general/latest/gr/iot-core.html#iot-protocol-limits).
Usar um formato JSON para sua carga de mensagens permite que o mecanismo de AWS IoT regras analise suas mensagens e aplique consultas SQL a elas. Se seu aplicativo não precisar do mecanismo de regras para aplicar consultas SQL às cargas úteis de mensagens, você poderá usar qualquer formato de dados que seu aplicativo exija. Para obter informações sobre limitações e caracteres reservados em um documento JSON usado em consultas SQL, consulte [Extensões JSON](iot-sql-json.md).
Para obter mais informações sobre como criar seus tópicos do MQTT e suas cargas de mensagens correspondentes, consulte [Como criar tópicos do MQTT para AWS IoT Core](https://docs.aws.amazon.com/whitepapers/latest/designing-mqtt-topics-aws-iot-core/designing-mqtt-topics-aws-iot-core.html).
Se o limite de tamanho de uma mensagem exceder as service quotas, isso resultará em um `CLIENT_ERROR` motivo `PAYLOAD_LIMIT_EXCEEDED` e é exibida a mensagem “A carga útil da mensagem excede o limite de tamanho para o tipo de mensagem”. Para obter mais informações sobre o limite de tamanho de mensagens, consulte [AWS IoT Core limites e cotas do agente de mensagens](https://docs.aws.amazon.com//general/latest/gr/iot-core.html#message-broker-limits.html).
# Tópicos reservados
Os tópicos que começam com um cifrão (\$1) são reservados para uso por AWS IoT. É possível assinar e publicar nesses tópicos reservados conforme permitido. No entanto, não é possível criar tópicos que comecem com um cifrão. Operações de publicação ou assinatura sem suporte em tópicos reservados podem resultar no encerramento de uma conexão.
## Tópicos de modelos de ativos
| Tópico | Operações do cliente permitidas | Description |
| --- | --- | --- |
| \$1 aws/sitewise/asset -models/ /assets/ /properties/ *assetModelId* *assetId* *propertyId* | Assinar | AWS IoT SiteWise publica notificações de propriedades de ativos neste tópico. Para obter mais informações, consulte [Interagindo com outros AWS serviços](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/interact-with-other-services.html) no *Guia do AWS IoT SiteWise usuário*. |
## AWS IoT Device Defender tópicos
Essas mensagens oferecem suporte a buffers de resposta no formato Concise Binary Object Representation (CBOR) e em JavaScript Object Notation (JSON), dependendo do tópico. *payload-format* AWS IoT Device Defender os tópicos suportam somente a publicação em MQTT.
| *payload-format* | Tipo de dados do formato de resposta |
| --- | --- |
| cbor | Representação Concisa de Objetos Binários (CBOR) |
| json | JavaScript Notação de objeto (JSON) |
Para obter mais informações, consulte [Enviar métricas de dispositivos](https://docs.aws.amazon.com/iot-device-defender/latest/devguide/detect-device-side-metrics.html#DetectMetricsMessages).
| Tópico | Operações permitidas | Description |
| --- | --- | --- |
| *thingName*\$1aws/things/ /defender/metrics/ *payload-format* | Publicar | AWS IoT Device Defender agentes publicam métricas para esse tópico. Para obter mais informações, consulte [Enviar métricas de dispositivos](https://docs.aws.amazon.com/iot-device-defender/latest/devguide/detect-device-side-metrics.html#DetectMetricsMessages). |
| \$1aws/things/ /defender/metrics/ /accepted *thingName* *payload-format* | Assinar | AWS IoT publica neste tópico depois que um AWS IoT Device Defender agente publica uma mensagem bem-sucedida em *thingName* \$1aws/things/ /defender/metrics/. *payload-format* Para obter mais informações, consulte [Enviar métricas de dispositivos](https://docs.aws.amazon.com/iot-device-defender/latest/devguide/detect-device-side-metrics.html#DetectMetricsMessages). |
| \$1aws/things/ /defender/metrics/ /rejeitado *thingName* *payload-format* | Assinar | AWS IoT publica neste tópico depois que um AWS IoT Device Defender agente publica uma mensagem malsucedida em \$1aws/things/ /defender/metrics/. *thingName* *payload-format* Para obter mais informações, consulte [Enviar métricas de dispositivos](https://docs.aws.amazon.com/iot-device-defender/latest/devguide/detect-device-side-metrics.html#DetectMetricsMessages). |
## AWS IoT Core Tópicos de localização do dispositivo
AWS IoT Core A localização do dispositivo pode resolver os dados de medição do seu dispositivo e fornecer uma localização estimada dos seus dispositivos de IoT. Os dados de medição do dispositivo podem incluir GNSS, Wi-Fi, celular e endereço IP. AWS IoT Core Em seguida, a localização do dispositivo escolhe o tipo de medição que fornece a melhor precisão e resolve as informações de localização do dispositivo. Para obter mais informações, consulte [AWS IoT Core Localização do dispositivo](device-location.md) e [Resolvendo a localização do dispositivo usando a localização do AWS IoT Core dispositivo (tópicos do MQTT)](device-location-reserved-topics.md).
| Tópico | Operações permitidas | Description |
| --- | --- | --- |
| \$1 aws/device\$1location/ /get\$1position\$1estimate *customer\$1device\$1id* | Publicar | Um dispositivo publica este tópico para que os dados brutos de medição digitalizados sejam resolvidos pela localização AWS IoT Core do dispositivo. |
| \$1 aws/device\$1location/ /get\$1position\$1estimate/accepted *customer\$1device\$1id* | Assinar | AWS IoT Core A localização do dispositivo é publicada neste tópico depois de resolver a localização do dispositivo com êxito. |
| \$1 aws/device\$1location/ /get\$1position\$1estimate/rejeitado *customer\$1device\$1id* | Assinar | AWS IoT Core A localização do dispositivo é publicada neste tópico quando não é possível resolver a localização do dispositivo com êxito devido a erros 4xx. |
## Tópicos de eventos
As mensagens de evento são publicadas quando determinados eventos acontecem. Por exemplo, os eventos são gerados pelo registro quando as objetos são adicionadas, atualizadas ou excluídas. A tabela mostra os vários AWS IoT eventos e seus tópicos reservados.
| Tópico | Operações do cliente permitidas | Description |
| --- | --- | --- |
| \$1aws/events/certificates/registered/*caCertificateId* | Assinar | AWS IoT publica essa mensagem ao registrar AWS IoT automaticamente um certificado e quando um cliente apresenta um certificado com o `PENDING_ACTIVATION` status. Para obter mais informações, consulte [Configurar a primeira conexão feita por um cliente para registro automático](auto-register-device-cert.md#configure-auto-reg-first-connect). |
| \$1aws/events/job/*jobID*/cancelado | Assinar | AWS IoT publica essa mensagem quando um trabalho é cancelado. Para obter mais informações, consulte [Eventos de trabalho](events-jobs.md). |
| \$1aws/events/job/jobID/cancelamento\$1em\$1andamento | Assinar | AWS IoT publica essa mensagem quando um cancelamento de trabalho está em andamento. Para obter mais informações, consulte [Eventos de trabalho](events-jobs.md). |
| \$1aws/events/job/*jobID*/concluído | Assinar | AWS IoT publica essa mensagem quando um trabalho é concluído. Para obter mais informações, consulte [Eventos de trabalho](events-jobs.md). |
| \$1aws/events/job/jobID/excluído | Assinar | AWS IoT publica essa mensagem quando um trabalho é excluído. Para obter mais informações, consulte [Eventos de trabalho](events-jobs.md). |
| \$1aws/events/job/jobID/deletion\$1in\$1progress | Assinar | AWS IoT publica essa mensagem quando a exclusão de um trabalho está em andamento. Para obter mais informações, consulte [Eventos de trabalho](events-jobs.md). |
| \$1aws/events/jobExecution/jobID/cancelado | Assinar | AWS IoT publica essa mensagem quando a execução de um trabalho é cancelada. Para obter mais informações, consulte [Eventos de trabalho](events-jobs.md). |
| \$1aws/events/jobExecution/jobID/excluído | Assinar | AWS IoT publica essa mensagem quando uma execução de trabalho é excluída. Para obter mais informações, consulte [Eventos de trabalho](events-jobs.md). |
| \$1aws/events/jobExecution/jobID/falhou | Assinar | AWS IoT publica essa mensagem quando a execução de um trabalho falha. Para obter mais informações, consulte [Eventos de trabalho](events-jobs.md). |
| \$1aws/events/jobExecution/jobID/rejeitado | Assinar | AWS IoT publica essa mensagem quando a execução de um trabalho é rejeitada. Para obter mais informações, consulte [Eventos de trabalho](events-jobs.md). |
| \$1aws/events/jobExecution/jobID/removido | Assinar | AWS IoT publica essa mensagem quando a execução de um trabalho é removida. Para obter mais informações, consulte [Eventos de trabalho](events-jobs.md). |
| \$1aws/events/jobExecution/jobID/foi bem sucedido | Assinar | AWS IoT publica essa mensagem quando a execução de um trabalho é bem-sucedida. Para obter mais informações, consulte [Eventos de trabalho](events-jobs.md). |
| \$1aws/events/jobExecution/jobID/timed\$1out | Assinar | AWS IoT publica essa mensagem quando a execução de um trabalho atinge o tempo limite. Para obter mais informações, consulte [Eventos de trabalho](events-jobs.md). |
| \$1aws/events/presence/connected/*clientId* | Assinar | AWS IoT publica neste tópico quando um cliente MQTT com o ID do cliente especificado se conecta a. AWS IoT Para obter mais informações, consulte [Eventos de conexão/desconexão](life-cycle-events.md#connect-disconnect). |
| \$1aws/events/presence/disconnected/*clientId* | Assinar | AWS IoT publica neste tópico quando um cliente MQTT com a ID de cliente especificada se desconecta a. AWS IoT Para obter mais informações, consulte [Eventos de conexão/desconexão](life-cycle-events.md#connect-disconnect). |
| \$1aws/events/subscriptions/subscribed/*clientId* | Assinar | AWS IoT publica neste tópico quando um cliente MQTT com o ID de cliente especificado se inscreve em um tópico do MQTT. Para obter mais informações, consulte [Eventos de assinatura/cancelamento de assinatura](life-cycle-events.md#subscribe-unsubscribe-events). |
| \$1aws/events/subscriptions/unsubscribed/*clientId* | Assinar | AWS IoT publica neste tópico quando um cliente MQTT com o ID de cliente especificado cancela a assinatura de um tópico MQTT. Para obter mais informações, consulte [Eventos de assinatura/cancelamento de assinatura](life-cycle-events.md#subscribe-unsubscribe-events). |
| \$1aws/events/thing/*thingName*/criado | Assinar | AWS IoT publica neste tópico quando a *thingName* coisa é criada. Para obter mais informações, consulte [Eventos de registro](registry-events.md). |
| \$1aws/events/thing/*thingName*/atualizado | Assinar | AWS IoT publica neste tópico quando a *thingName* coisa é atualizada. Para obter mais informações, consulte [Eventos de registro](registry-events.md). |
| \$1aws/events/thing/*thingName*/excluído | Assinar | AWS IoT publica neste tópico quando a *thingName* coisa é excluída. Para obter mais informações, consulte [Eventos de registro](registry-events.md). |
| \$1aws/events/thingGroup/*thingGroupName*/criado | Assinar | AWS IoT publica neste tópico quando um grupo de coisas *thingGroupName* é criado. Para obter mais informações, consulte [Eventos de registro](registry-events.md). |
| \$1aws/events/thingGroup/*thingGroupName*/atualizado | Assinar | AWS IoT publica neste tópico quando o grupo de coisas *thingGroupName* é atualizado. Para obter mais informações, consulte [Eventos de registro](registry-events.md). |
| \$1aws/events/thingGroup/*thingGroupName*/excluído | Assinar | AWS IoT publica neste tópico quando um grupo de coisas *thingGroupName* é excluído. Para obter mais informações, consulte [Eventos de registro](registry-events.md). |
| \$1aws/events/thingType/*thingTypeName*/criado | Assinar | AWS IoT publica neste tópico quando o tipo de *thingTypeName* coisa é criado. Para obter mais informações, consulte [Eventos de registro](registry-events.md). |
| \$1aws/events/thingType/*thingTypeName*/atualizado | Assinar | AWS IoT publica neste tópico quando o tipo de *thingTypeName* coisa é atualizado. Para obter mais informações, consulte [Eventos de registro](registry-events.md). |
| \$1aws/events/thingType/*thingTypeName*/excluído | Assinar | AWS IoT publica neste tópico quando o tipo de *thingTypeName* coisa é excluído. Para obter mais informações, consulte [Eventos de registro](registry-events.md). |
| \$1aws/events/thingTypeAssociation/thing/*thingName*/*thingTypeName* | Assinar | AWS IoT publica neste tópico quando algo *thingName* está associado ou desassociado do tipo de coisa. *thingTypeName* Para obter mais informações, consulte [Eventos de registro](registry-events.md). |
| \$1aws/events/thingGroupMembership/thingGroup/*thingGroupName*/thing/ /adicionado *thingName* | Assinar | AWS IoT publica neste tópico quando algo *thingName* é adicionado ao grupo *thingGroupName* de coisas. Para obter mais informações, consulte [Eventos de registro](registry-events.md). |
| \$1aws/events/thingGroupMembership/thingGroup/*thingGroupName*/thing/ /removido *thingName* | Assinar | AWS IoT publica neste tópico quando algo *thingName* é removido do grupo *thingGroupName* de coisas. Para obter mais informações, consulte [Eventos de registro](registry-events.md). |
| \$1aws/events/thingGroupHierarchy/thingGroup//*parentThingGroupName*childThingGroup/*childThingGroupName*/adicionado | Assinar | AWS IoT publica neste tópico quando um grupo de coisas *childThingGroupName* é adicionado ao grupo *parentThingGroupName* de coisas. Para obter mais informações, consulte [Eventos de registro](registry-events.md). |
| \$1aws/events/thingGroupHierarchy/thingGroup//*parentThingGroupName*childThingGroup/*childThingGroupName*/removido | Assinar | AWS IoT publica neste tópico quando o grupo de coisas *childThingGroupName* é removido do grupo *parentThingGroupName* de coisas. Para obter mais informações, consulte [Eventos de registro](registry-events.md). |
## Tópicos de provisionamento de frota
**nota**
As operações do cliente anotadas como **Receber** nesta tabela indicam tópicos que AWS IoT são publicados diretamente no cliente que os solicitou, independentemente de o cliente ter se inscrito no tópico ou não. Os clientes devem esperar receber essas mensagens de resposta mesmo que não sejam assinantes delas. Essas mensagens de resposta não passam pelo agente de mensagens e não podem ser assinadas por outros clientes ou regras.
Essas mensagens oferecem suporte a buffers de resposta no formato Concise Binary Object Representation (CBOR) e em JavaScript Object Notation (JSON), dependendo do tópico. *payload-format*
| *payload-format* | Tipo de dados do formato de resposta |
| --- | --- |
| cbor | Representação Concisa de Objetos Binários (CBOR) |
| json | JavaScript Notação de objeto (JSON) |
Para obter mais informações, consulte [API MQTT de provisionamento de dispositivos](fleet-provision-api.md).
| Tópico | Operações do cliente permitidas | Description |
| --- | --- | --- |
| \$1aws/certificates/create/*payload-format* | Publicar | Publique nesse tópico para criar um certificado usando uma solicitação de assinatura de certificado (CSR). |
| \$1aws/certificates/create/*payload-format*/aceito | Assine, receba | AWS IoT publica neste tópico após uma chamada bem-sucedida para \$1aws/certificates/create/*payload-format*. |
| \$1aws/certificates/create/*payload-format*/rejeitado | Assine, receba | AWS IoT publica neste tópico após uma chamada malsucedida para \$1aws/certificates/create/. *payload-format* |
| \$1 aws/certificates/create -de-csr/ *payload-format* | Publicar | Publica nesse tópico para criar um certificado a partir de uma CSR. |
| \$1 aws/certificates/create *payload-format* -from-csr/ /aceito | Assine, receba | AWS IoT publica neste tópico uma chamada bem-sucedida para \$1 aws/certificates/create *payload-format* -from-csr/. |
| \$1 aws/certificates/create *payload-format* -from-csr/ /rejeitado | Assine, receba | AWS IoT publica neste tópico uma chamada malsucedida para \$1 aws/certificates/create -from-csr/. *payload-format* |
| \$1aws/provisioning-templates/ /provision/ *templateName* *payload-format* | Publicar | Publique nesse tópico para registrar um objeto. |
| \$1aws/provisioning-templates/ /provision/ /accepted *templateName* *payload-format* | Assine, receba | AWS IoT publica neste tópico após uma chamada bem-sucedida para *templateName* \$1aws/provisioning-templates/ /provision/. *payload-format* |
| \$1aws/provisioning-templates/ /provision/ /rejeitado *templateName* *payload-format* | Assine, receba | AWS IoT publica neste tópico após uma chamada malsucedida para *templateName* \$1aws/provisioning-templates/ /provision/. *payload-format* |
## Tópicos de trabalhos
**nota**
As operações do cliente anotadas como **Receber** nesta tabela indicam tópicos que AWS IoT são publicados diretamente no cliente que os solicitou, independentemente de o cliente ter se inscrito no tópico ou não. Os clientes devem esperar receber essas mensagens de resposta mesmo que não sejam assinantes delas.
Essas mensagens de resposta não passam pelo agente de mensagens e não podem ser assinadas por outros clientes ou regras. Para assinar mensagens relacionadas a atividades de trabalhos, use os tópicos `notify` e `notify-next`.
Ao assinar os tópicos de tarefas e `jobExecution` eventos de sua solução de monitoramento de frota, você deve primeiro habilitar os eventos de [tarefas e execução de tarefas para receber quaisquer eventos](iot-events.md) no lado da nuvem.
Para obter mais informações, consulte [Operações da API MQTT do dispositivo de trabalhos](jobs-mqtt-api.md).
| Tópico | Operações do cliente permitidas | Description |
| --- | --- | --- |
| \$1 *thingName* aws/things/ /jobs/get | Publicar | Os dispositivos publicam uma mensagem neste tópico para fazer uma solicitação `GetPendingJobExecutions`. Para obter mais informações, consulte [Operações da API MQTT do dispositivo de trabalhos](jobs-mqtt-api.md). |
| \$1 aws/coisas//*thingName*jobs/get/accepted | Assine, receba | Os dispositivos se inscrevem nesse tópico para receber respostas bem-sucedidas de uma solicitação `GetPendingJobExecutions`. Para obter mais informações, consulte [Operações da API MQTT do dispositivo de trabalhos](jobs-mqtt-api.md). |
| \$1 aws/coisas//*thingName*jobs/get/rejected | Assine, receba | Os dispositivos assinam este tópico para receber uma resposta quando uma solicitação `GetPendingJobExecutions` é rejeitada. Para obter mais informações, consulte [Operações da API MQTT do dispositivo de trabalhos](jobs-mqtt-api.md). |
| *thingName*\$1aws/things/ /jobs/start-next | Publicar | Os dispositivos publicam uma mensagem neste tópico para fazer uma solicitação `StartNextPendingJobExecution`. Para obter mais informações, consulte [Operações da API MQTT do dispositivo de trabalhos](jobs-mqtt-api.md). |
| \$1 aws/coisas//*thingName*jobs/start-next/accepted | Assine, receba | Os dispositivos assinam este tópico para receber respostas bem-sucedidas para uma solicitação `StartNextPendingJobExecution`. Para obter mais informações, consulte [Operações da API MQTT do dispositivo de trabalhos](jobs-mqtt-api.md). |
| \$1 aws/coisas//*thingName*jobs/start-next/rejected | Assine, receba | Os dispositivos assinam este tópico para receber uma resposta quando uma solicitação `StartNextPendingJobExecution` é rejeitada. Para obter mais informações, consulte [Operações da API MQTT do dispositivo de trabalhos](jobs-mqtt-api.md). |
| \$1aws/things/ /jobs/ /get *thingName* *jobId* | Publicar | Os dispositivos publicam uma mensagem neste tópico para fazer uma solicitação `DescribeJobExecution`. Para obter mais informações, consulte [Operações da API MQTT do dispositivo de trabalhos](jobs-mqtt-api.md). |
| \$1aws/things/ /jobs/ /get/accepted *thingName* *jobId* | Assine, receba | Os dispositivos assinam este tópico para receber respostas bem-sucedidas para uma solicitação `DescribeJobExecution`. Para obter mais informações, consulte [Operações da API MQTT do dispositivo de trabalhos](jobs-mqtt-api.md). |
| \$1aws/things/ /jobs/ /get/rejeitado *thingName* *jobId* | Assine, receba | Os dispositivos assinam este tópico para receber uma resposta quando uma solicitação `DescribeJobExecution` é rejeitada. Para obter mais informações, consulte [Operações da API MQTT do dispositivo de trabalhos](jobs-mqtt-api.md). |
| \$1aws/things/ /jobs/ /update *thingName* *jobId* | Publicar | Os dispositivos publicam uma mensagem neste tópico para fazer uma solicitação `UpdateJobExecution`. Para obter mais informações, consulte [Operações da API MQTT do dispositivo de trabalhos](jobs-mqtt-api.md). |
| \$1aws/things/ /jobs/ /update/accepted *thingName* *jobId* | Assine, receba | Os dispositivos assinam este tópico para receber respostas de êxito de uma solicitação `UpdateJobExecution`. Para obter mais informações, consulte [Operações da API MQTT do dispositivo de trabalhos](jobs-mqtt-api.md). Observação Somente o dispositivo que publica em \$1aws/things/ *thingName* /jobs/ *jobId* /update recebe mensagens sobre esse tópico. |
| \$1aws/things/ /jobs/ /update/rejeitado *thingName* *jobId* | Assine, receba | Os dispositivos assinam este tópico para receber uma resposta quando uma solicitação `UpdateJobExecution` é rejeitada. Para obter mais informações, consulte [Operações da API MQTT do dispositivo de trabalhos](jobs-mqtt-api.md). Observação Somente o dispositivo que publica em \$1aws/things/ *thingName* /jobs/ *jobId* /update recebe mensagens sobre esse tópico. |
| *thingName*\$1aws/things/ /jobs/notify | Assine, receba | Os dispositivos assinam este tópico para receber notificações quando uma execução de tarefa é adicionada à lista de execuções pendentes de um objeto ou removida dela. Para obter mais informações, consulte [Operações da API MQTT do dispositivo de trabalhos](jobs-mqtt-api.md). |
| *thingName*\$1aws/things/ /jobs/notify-next | Assine, receba | Os dispositivos assinam este tópico para receber notificações quando a próxima execução de tarefa pendente para o objeto é alterada. Para obter mais informações, consulte [Operações da API MQTT do dispositivo de trabalhos](jobs-mqtt-api.md). |
| \$1aws/events/job/*jobId*/concluído | Assinar | O serviço Tarefas publica um evento neste tópico quando uma tarefa é concluída. Para obter mais informações, consulte [Eventos de trabalho](events-jobs.md). |
| \$1aws/events/job/*jobId*/cancelado | Assinar | O serviço Tarefas publica um evento neste tópico quando uma tarefa é cancelada. Para obter mais informações, consulte [Eventos de trabalho](events-jobs.md). |
| \$1aws/events/job/*jobId*/excluído | Assinar | O serviço Tarefas publica um evento neste tópico quando uma tarefa é excluída. Para obter mais informações, consulte [Eventos de trabalho](events-jobs.md). |
| \$1aws/events/job/*jobId*/cancelamento\$1em\$1andamento | Assinar | O serviço Tarefas publica um evento neste tópico quando o cancelamento de uma tarefa começa. Para obter mais informações, consulte [Eventos de trabalho](events-jobs.md). |
| \$1aws/events/job/*jobId*/deletion\$1in\$1progress | Assinar | O serviço Tarefas publica um evento neste tópico quando a exclusão de tarefa começa. Para obter mais informações, consulte [Eventos de trabalho](events-jobs.md). |
| \$1aws/events/jobExecution/*jobId*/foi bem sucedido | Assinar | O serviço Tarefas publica um evento neste tópico quando a execução da tarefa é bem-sucedida. Para obter mais informações, consulte [Eventos de trabalho](events-jobs.md). |
| \$1aws/events/jobExecution/*jobId*/falhou | Assinar | O serviço Tarefas publica um evento neste tópico quando uma execução de tarefa falha. Para obter mais informações, consulte [Eventos de trabalho](events-jobs.md). |
| \$1aws/events/jobExecution/*jobId*/rejeitado | Assinar | O serviço Tarefas publica um evento neste tópico quando uma execução de tarefa é rejeitada. Para obter mais informações, consulte [Eventos de trabalho](events-jobs.md). |
| \$1aws/events/jobExecution/*jobId*/cancelado | Assinar | O serviço Tarefas publica um evento neste tópico quando a execução de uma tarefa é cancelada. Para obter mais informações, consulte [Eventos de trabalho](events-jobs.md). |
| \$1aws/events/jobExecution/*jobId*/timed\$1out | Assinar | O serviço Tarefas publica um evento neste tópico quando a execução de uma tarefa atinge o tempo limite. Para obter mais informações, consulte [Eventos de trabalho](events-jobs.md). |
| \$1aws/events/jobExecution/*jobId*/removido | Assinar | O serviço Tarefas publica um evento neste tópico quando a execução de uma tarefa é removida. Para obter mais informações, consulte [Eventos de trabalho](events-jobs.md). |
| \$1aws/events/jobExecution/*jobId*/excluído | Assinar | O serviço Tarefas publica um evento neste tópico quando a execução de uma tarefa é excluída. Para obter mais informações, consulte [Eventos de trabalho](events-jobs.md). |
## Tópicos de comandos
**nota**
As operações do cliente anotadas como **Receber** nesta tabela indicam tópicos que AWS IoT são publicados diretamente no cliente que os solicitou, independentemente de o cliente ter se inscrito no tópico ou não. Os clientes devem esperar receber essas mensagens de resposta mesmo que não sejam assinantes delas.
Essas mensagens de resposta não passam pelo agente de mensagens e não podem ser assinadas por outros clientes ou regras.
| Tópico | Operações do cliente permitidas | Description |
| --- | --- | --- |
| \$1aws/commands///executions/ /request/ ** ** ** ** \$1aws/commands///executions/ /request ** ** ** | Assine, receba | Os dispositivos recebem uma mensagem sobre esse tópico quando é feita uma solicitação para iniciar uma execução de comando no console ou usando a API `StartCommandExecution`. Nesse caso, ** podem ser coisas de IoT ou clientes MQTT e ** podem ser o nome da coisa de IoT ou o ID do cliente MQTT. |
| \$1aws/commands///executions/ /response/ ** ** ** ** | Publicar | Os dispositivos usam a API `UpdateCommandExecution` do MQTT para publicar uma mensagem nesse tópico sobre a execução do comando. A mensagem é publicada como uma resposta à solicitação para iniciar uma execução de comando no console ou usando a API `StartCommandExecution`. A mensagem publicada usará JSON ou CBOR como o. ** |
| \$1aws/commands///executions/ /response/accepted/ ** ** ** ** \$1aws/commands///executions/ /response/accepted ** ** ** | Assine, receba | Se o serviço de nuvem tiver processado com êxito o resultado da execução do comando, o AWS IoT Device Management publicará uma resposta no tópico /accepted. |
| \$1aws/commands///executions/ /response/rejected/ ** ** ** ** \$1aws/commands///executions/ /response/rejeitado ** ** ** | Publicar | Se o serviço de nuvem não conseguir processar o resultado da execução do comando, o AWS IoT Device Management publicará uma resposta no tópico /rejected. |
## Tópicos de regras
| Tópico | Operações do cliente permitidas | Description |
| --- | --- | --- |
| \$1 aws/rules/ *ruleName* | Publicar | Um dispositivo ou um aplicativo faz publicações nesse tópico para acionar regras diretamente. Para obter mais informações, consulte [Reduzir custos do sistema de mensagens com Ingestão básica](iot-basic-ingest.md). |
## Proteger tópicos de túneis
| Tópico | Operações do cliente permitidas | Description |
| --- | --- | --- |
| *thing-name*\$1aws/things/ /tunnels/notify | Assinar | AWS IoT publica essa mensagem para que um agente de IoT inicie um proxy local no dispositivo remoto. Para obter mais informações, consulte [Snippet de atendente de IoT](configure-remote-device.md#agent-snippet). |
## Tópicos de sombra
Os tópicos desta seção são usados por sombras nomeadas e sem nome. Os tópicos usados por cada uma diferem apenas no prefixo do tópico. Esta tabela mostra o prefixo do tópico usado em cada tipo de sombra.
| Valor do *ShadowTopicPrefix* | Tipo de sombra |
| --- | --- |
| thingName\$1aws/things/ /shadow | Sombra sem nome (clássica) |
| \$1aws/things/ /shadow/name/ thingName shadowName | Sombra nomeada |
Para criar um tópico completo, selecione o *ShadowTopicPrefix* tipo de sombra ao qual você deseja se referir, substitua *thingName* e, se aplicável,*shadowName*, pelos valores correspondentes e, em seguida, anexe-o ao esboço do tópico, conforme mostrado na tabela a seguir. Lembre-se de que os tópicos diferenciam maiúsculas de minúsculas.
| Tópico | Operações do cliente permitidas | Description |
| --- | --- | --- |
| *ShadowTopicPrefix*/excluir | Publicar/assinar | Um dispositivo ou um aplicativo faz publicações nesse tópico para excluir uma sombra. Para obter mais informações, consulte [/delete](device-shadow-mqtt.md#delete-pub-sub-topic). |
| *ShadowTopicPrefix*/excluir/aceito | Assinar | O serviço Sombra do dispositivo envia mensagens para esse tópico quando uma sombra é excluída. Para obter mais informações, consulte [/delete/accepted](device-shadow-mqtt.md#delete-accepted-pub-sub-topic). |
| *ShadowTopicPrefix*/excluir/rejeitado | Assinar | O serviço Sombra do dispositivo envia mensagens para esse tópico quando uma solicitação de exclusão de uma sombra é rejeitada. Para obter mais informações, consulte [/delete/rejected](device-shadow-mqtt.md#delete-rejected-pub-sub-topic). |
| *ShadowTopicPrefix*/obter | Publicar/assinar | Um aplicativo ou um objeto publica uma mensagem vazia nesse tópico para obter uma sombra. Para obter mais informações, consulte [Tópicos MQTT da Sombra do Dispositivo](device-shadow-mqtt.md). |
| *ShadowTopicPrefix*/obter/aceito | Assinar | O serviço Sombra do dispositivo envia mensagens para esse tópico quando uma solicitação para uma sombra é feita com êxito. Para obter mais informações, consulte [/get/accepted](device-shadow-mqtt.md#get-accepted-pub-sub-topic). |
| *ShadowTopicPrefix*/get/rejeitado | Assinar | O serviço Sombra do dispositivo envia mensagens para esse tópico quando uma solicitação de sombra é rejeitada. Para obter mais informações, consulte [/get/rejected](device-shadow-mqtt.md#get-rejected-pub-sub-topic). |
| *ShadowTopicPrefix*/atualizar | Publicar/assinar | Umo objeto ou um aplicativo faz publicações nesse tópico para atualizar uma sombra. Para obter mais informações, consulte [/update](device-shadow-mqtt.md#update-pub-sub-topic). |
| *ShadowTopicPrefix*/update/aceito | Assinar | O serviço Sombra do dispositivo envia mensagens para esse tópico quando uma atualização é feita com êxito em uma sombra. Para obter mais informações, consulte [/update/accepted](device-shadow-mqtt.md#update-accepted-pub-sub-topic). |
| *ShadowTopicPrefix*/update/rejeitado | Assinar | O serviço Sombra do dispositivo envia mensagens para esse tópico quando a atualização de uma sombra é rejeitada. Para obter mais informações, consulte [/update/rejected](device-shadow-mqtt.md#update-rejected-pub-sub-topic). |
| *ShadowTopicPrefix*/update/delta | Assinar | O serviço Sombra do dispositivo envia mensagens para esse tópico quando uma diferença é detectada entre as seções desejadas e relatadas de uma sombra. Para obter mais informações, consulte [/update/delta](device-shadow-mqtt.md#update-delta-pub-sub-topic). |
| *ShadowTopicPrefix*/update/documents | Assinar | AWS IoT publica um documento de estado para esse tópico sempre que uma atualização na sombra for executada com êxito. Para obter mais informações, consulte [/update/documents](device-shadow-mqtt.md#update-documents-pub-sub-topic). |
## Tópicos de entrega de arquivos baseados em MQTT
**nota**
As operações do cliente anotadas como **Receber** nesta tabela indicam tópicos que AWS IoT são publicados diretamente no cliente que os solicitou, independentemente de o cliente ter se inscrito no tópico ou não. Os clientes devem esperar receber essas mensagens de resposta mesmo que não sejam assinantes delas. Essas mensagens de resposta não passam pelo agente de mensagens e não podem ser assinadas por outros clientes ou regras.
Essas mensagens oferecem suporte a buffers de resposta no formato Concise Binary Object Representation (CBOR) e em JavaScript Object Notation (JSON), dependendo do tópico. *payload-format*
| *payload-format* | Tipo de dados do formato de resposta |
| --- | --- |
| cbor | Representação Concisa de Objetos Binários (CBOR) |
| json | JavaScript Notação de objeto (JSON) |
| Tópico | Operações do cliente permitidas | Description |
| --- | --- | --- |
| \$1 aws/things/ /streams/ /data/ *ThingName* *StreamId* *payload-format* | Assine, receba | AWS A entrega de arquivos baseada em MQTT é publicada neste tópico se a solicitação "GetStream" de um dispositivo for aceita. A carga útil contém os dados do fluxo. Para obter mais informações, consulte [Usando a entrega de arquivos AWS IoT baseada em MQTT em dispositivos](mqtt-based-file-delivery-in-devices.md). |
| \$1 aws/things/ /streams/ /get/ *ThingName* *StreamId* *payload-format* | Publicar | Um dispositivo publica neste tópico para realizar uma solicitação GetStream "”. Para obter mais informações, consulte [Usando a entrega de arquivos AWS IoT baseada em MQTT em dispositivos](mqtt-based-file-delivery-in-devices.md). |
| \$1aws/things/ /streams/ /description/ *ThingName* *StreamId* *payload-format* | Assine, receba | AWS A entrega de arquivos baseada em MQTT é publicada neste tópico se a solicitação "DescribeStream" de um dispositivo for aceita. A carga útil contém a descrição do fluxo. Para obter mais informações, consulte [Usando a entrega de arquivos AWS IoT baseada em MQTT em dispositivos](mqtt-based-file-delivery-in-devices.md). |
| \$1 aws/things/ /streams/ /describe/ *ThingName* *StreamId* *payload-format* | Publicar | Um dispositivo publica neste tópico para realizar uma solicitação DescribeStream "”. Para obter mais informações, consulte [Usando a entrega de arquivos AWS IoT baseada em MQTT em dispositivos](mqtt-based-file-delivery-in-devices.md). |
| \$1aws/things/ /streams/ /rejeted/ *ThingName* *StreamId* *payload-format* | Assine, receba | AWS A entrega de arquivos baseada em MQTT é publicada neste tópico se uma solicitação "DescribeStream" ou "GetStream" de um dispositivo for rejeitada. Para obter mais informações, consulte [Usando a entrega de arquivos AWS IoT baseada em MQTT em dispositivos](mqtt-based-file-delivery-in-devices.md). |
## ARN de tópicos reservados
Todos os tópicos reservados ARNs (Amazon Resource Names) têm o seguinte formato:
```
arn:aws:iot:aws-region:AWS-account-ID:topic/Topic
```
Por exemplo, `arn:aws:iot:us-west-2:123EXAMPLE456:topic/$aws/things/thingName/jobs/get/accepted` é um ARN para o tópico reservado `$aws/things/thingName/jobs/get/accepted`.