Tópicos reservados
Os tópicos que começam com um cifrão ($) são reservados para uso pelo 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 | Descrição |
|---|---|---|
|
$aws/sitewise/asset-models/ |
Assinar |
O AWS IoT SiteWise publica notificações de propriedade de ativo neste tópico. Para obter mais informações, consulte a opção Interação com outros AWS serviços no AWS IoT SiteWise Guia do usuário. |
Tópicos do AWS IoT Device Defender
Essas mensagens oferecem suporte a buffers de resposta no formato Representação Concisa de Objetos Binários (CBOR) e Notação de Objetos para JavaScript (JSON), dependendo do formato da carga útil do tópico. Os tópicos do AWS IoT Device Defender são compatíveis apenas com publicações do tipo MQTT.
formato da carga útil |
Tipo de dados do formato de resposta |
|---|---|
| cbor | Representação Concisa de Objetos Binários (CBOR) |
| json | Notação de Objetos para JavaScript (JSON) |
Para obter mais informações, consulte Enviar métricas de dispositivos.
| Tópico | Operações permitidas | Descrição |
|---|---|---|
|
$aws/things/ |
Publicar |
Os atendentes do AWS IoT Device Defender publicam métricas neste tópico. Para obter mais informações, consulte Enviar métricas de dispositivos. |
|
$aws/things/ |
Assinar |
O AWS IoT publica neste tópico depois que um atendente do AWS IoT Device Defender publicar uma mensagem de ação bem-sucedida em $aws/things/ |
|
$aws/things/ |
Assinar |
O AWS IoT publica neste tópico depois que um atendente do AWS IoT Device Defender publicar uma mensagem de ação malsucedida em $aws/things/ |
Tópicos de localização do dispositivo AWS IoT Core
A localização do dispositivo AWS IoT Core 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 Local do dispositivo AWS IoT Core e Como resolver o local do dispositivo usando os tópicos MQTT do Local do dispositivo AWS IoT Core.
| Tópico | Operações permitidas | Descrição |
|---|---|---|
|
$aws/device_location/ |
Publicar |
Um dispositivo publica este tópico para que os dados brutos de medição digitalizados sejam resolvidos pela localização do dispositivo AWS IoT Core. |
|
$aws/device_location/ |
Assinar |
A localização do dispositivo AWS IoT Core é publicada neste tópico depois de resolver a localização do dispositivo com êxito. |
|
|
Assinar |
A localização do dispositivo AWS IoT Core é 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 eventos de AWS IoT e seus tópicos reservados.
| Tópico | Operações do cliente permitidas | Descrição |
|---|---|---|
|
$aws/events/certificates/registered/ |
Assinar |
O AWS IoT publica esta mensagem quando o AWS IoT registra automaticamente um certificado e quando um cliente apresenta um certificado com o status |
|
$aws/events/job/ |
Assinar |
AWS IoT publica essa mensagem quando uma tarefa é cancelada. Para obter mais informações, consulte Eventos de trabalho. |
$aws/events/job/jobId/cancellation_in_progress |
Assinar |
AWS IoT publica essa mensagem quando um cancelamento de tarefa está em andamento. Para obter mais informações, consulte Eventos de trabalho. |
|
$aws/events/job/ |
Assinar |
AWS IoT publica essa mensagem quando uma tarefa é concluída. Para obter mais informações, consulte Eventos de trabalho. |
$aws/events/job/jobId/deleted |
Assinar |
AWS IoT publica essa mensagem quando uma tarefa é excluída. Para obter mais informações, consulte Eventos de trabalho. |
$aws/events/job/jobId/deletion_in_progress |
Assinar |
AWS IoT publica essa mensagem quando a exclusão de uma tarefa está em andamento. Para obter mais informações, consulte Eventos de trabalho. |
$aws/events/jobExecution/jobId/canceled |
Assinar |
AWS IoT publica essa mensagem quando a execução de uma tarefa é cancelada. Para obter mais informações, consulte Eventos de trabalho. |
$aws/events/jobExecution/jobId/deleted |
Assinar |
AWS IoT publica essa mensagem quando a execução de uma tarefa é excluída. Para obter mais informações, consulte Eventos de trabalho. |
$aws/events/jobExecution/jobId/failed |
Assinar |
AWS IoT publica essa mensagem quando a execução de uma tarefa falha. Para obter mais informações, consulte Eventos de trabalho. |
$aws/events/jobExecution/jobId/rejected |
Assinar |
AWS IoT publica essa mensagem quando a execução de uma tarefa é rejeitada. Para obter mais informações, consulte Eventos de trabalho. |
$aws/events/jobExecution/jobId/removed |
Assinar |
AWS IoT publica essa mensagem quando a execução de uma tarefa é removida. Para obter mais informações, consulte Eventos de trabalho. |
$aws/events/jobExecution/jobId/succeeded |
Assinar |
AWS IoT publica essa mensagem quando a execução de uma tarefa é bem-sucedida. Para obter mais informações, consulte Eventos de trabalho. |
$aws/events/jobExecution/jobId/timed_out |
Assinar |
AWS IoT publica essa mensagem quando a execução de uma tarefa atinge o tempo limite. Para obter mais informações, consulte Eventos de trabalho. |
|
$aws/events/presence/connected/ |
Assinar |
A AWS IoT faz publicações nesse tópico quando um cliente MQTT com o ID do cliente especificado se conecta à AWS IoT. Para obter mais informações, consulte Eventos de conexão/desconexão. |
|
$aws/events/presence/disconnected/ |
Assinar |
A AWS IoT faz publicações nesse tópico quando um cliente MQTT com o ID do cliente especificado se desconecta à AWS IoT. Para obter mais informações, consulte Eventos de conexão/desconexão. |
|
$aws/events/subscriptions/subscribed/ |
Assinar |
A AWS IoT faz publicações nesse tópico quando um cliente MQTT com o ID do cliente especificado se inscreve em um tópico MQTT. Para obter mais informações, consulte Eventos de assinatura/cancelamento de assinatura. |
|
$aws/events/subscriptions/unsubscribed/ |
Assinar |
A AWS IoT faz publicações nesse tópico quando um cliente MQTT com o ID do cliente especificado cancela a assinatura em um tópico MQTT. Para obter mais informações, consulte Eventos de assinatura/cancelamento de assinatura. |
|
$aws/events/thing/ |
Assinar |
O AWS IoT publica neste tópico quando o objeto |
|
$aws/events/thing/ |
Assinar |
O AWS IoT publica neste tópico quando o objeto |
|
$aws/events/thing/ |
Assinar |
O AWS IoT publica neste tópico quando o objeto |
|
$aws/events/thingGroup/ |
Assinar |
O AWS IoT publica neste tópico quando o grupo de objetos |
|
$aws/events/thingGroup/ |
Assinar |
O AWS IoT publica neste tópico quando o grupo de objetos |
|
$aws/events/thingGroup/ |
Assinar |
O AWS IoT publica neste tópico quando o grupo de objetos |
|
$aws/events/thingType/ |
Assinar |
O AWS IoT publica neste tópico quando o tipo de objeto |
|
$aws/events/thingType/ |
Assinar |
O AWS IoT publica neste tópico quando o tipo de objeto |
|
$aws/events/thingType/ |
Assinar |
O AWS IoT publica neste tópico quando o tipo de objeto |
|
$aws/events/thingTypeAssociation/thing/ |
Assinar |
O AWS IoT publica neste tópico quando o objeto |
|
$aws/events/thingGroupMembership/thingGroup/ |
Assinar |
O AWS IoT publica neste tópico quando o objeto |
|
$aws/events/thingGroupMembership/thingGroup/ |
Assinar |
O AWS IoT publica neste tópico quando o objeto |
|
$aws/events/thingGroupHierarchy/thingGroup/ |
Assinar |
O AWS IoT publica neste tópico quando o grupo de objetos |
|
$aws/events/thingGroupHierarchy/thingGroup/ |
Assinar |
O AWS IoT publica neste tópico quando o grupo de objetos |
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 para o cliente que os solicitou, independentemente de o cliente ter assinado o 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 nos formatos Representação Concisa de Objetos Binários (CBOR) e Notação de Objetos para JavaScript (JSON), dependendo do formato da carga útil do tópico.
formato da carga útil |
Tipo de dados do formato de resposta |
|---|---|
| cbor | Representação Concisa de Objetos Binários (CBOR) |
| json | Notação de Objetos para JavaScript (JSON) |
Para obter mais informações, consulte API MQTT de provisionamento de dispositivos.
| Tópico | Operações do cliente permitidas | Descrição |
|---|---|---|
|
$aws/certificates/create/ |
Publicar |
Publique nesse tópico para criar um certificado usando uma solicitação de assinatura de certificado (CSR). |
|
$aws/certificates/create/ |
Assine, receba |
O AWS IoT publica nesse tópico após uma chamada bem-sucedida para $aws/certificates/create/ |
|
$aws/certificates/create/ |
Assine, receba |
AWS IoT publica nesse tópico após uma chamada malsucedida para $aws/certificates/create/ |
|
$aws/certificates/create-from-csr/ |
Publicar |
Publica nesse tópico para criar um certificado a partir de uma CSR. |
|
$aws/certificates/create-from-csr/ |
Assine, receba |
AWS IoT publica nesse tópico uma chamada bem-sucedida para $aws/certificates/create-from-csr/ |
|
$aws/certificates/create-from-csr/ |
Assine, receba |
AWS IoT publica nesse tópico uma chamada malsucedida para $aws/certificates/create-from-csr/ |
|
$aws/provisioning-templates/ |
Publicar |
Publique nesse tópico para registrar um objeto. |
|
$aws/provisioning-templates/ |
Assine, receba |
AWS IoT publica nesse tópico após uma chamada bem-sucedida para $aws/provisioning-templates/ |
|
$aws/provisioning-templates/ |
Assine, receba |
AWS IoT publica nesse tópico após uma chamada malsucedida para $aws/provisioning-templates/ |
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 para o cliente que os solicitou, independentemente de o cliente ter assinado o 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 no lado da nuvem.
Para obter mais informações, consulte Operações da API MQTT do dispositivo de trabalhos.
| Tópico | Operações do cliente permitidas | Descrição |
|---|---|---|
|
$aws/things/ |
Publicar |
Os dispositivos publicam uma mensagem neste tópico para fazer uma solicitação |
|
$aws/things/ |
Assine, receba |
Os dispositivos se inscrevem nesse tópico para receber respostas bem-sucedidas de uma solicitação |
|
$aws/things/ |
Assine, receba |
Os dispositivos assinam este tópico para receber uma resposta quando uma solicitação |
|
$aws/things/ |
Publicar |
Os dispositivos publicam uma mensagem neste tópico para fazer uma solicitação |
|
$aws/things/ |
Assine, receba |
Os dispositivos assinam este tópico para receber respostas bem-sucedidas para uma solicitação |
|
$aws/things/ |
Assine, receba |
Os dispositivos assinam este tópico para receber uma resposta quando uma solicitação |
|
$aws/things/ |
Publicar |
Os dispositivos publicam uma mensagem neste tópico para fazer uma solicitação |
|
$aws/things/ |
Assine, receba |
Os dispositivos assinam este tópico para receber respostas bem-sucedidas para uma solicitação |
|
$aws/things/ |
Assine, receba |
Os dispositivos assinam este tópico para receber uma resposta quando uma solicitação |
|
$aws/things/ |
Publicar |
Os dispositivos publicam uma mensagem neste tópico para fazer uma solicitação |
|
$aws/things/ |
Assine, receba |
Os dispositivos assinam este tópico para receber respostas de êxito de uma solicitação ObservaçãoSomente o dispositivo que publica em $aws/things/ |
|
$aws/things/ |
Assine, receba |
Os dispositivos assinam este tópico para receber uma resposta quando uma solicitação ObservaçãoSomente o dispositivo que publica em $aws/things/ |
|
$aws/things/ |
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. |
|
$aws/things/ |
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. |
|
$aws/events/job/ |
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. |
|
$aws/events/job/ |
Assinar |
O serviço Tarefas publica um evento neste tópico quando uma tarefa é cancelada. Para obter mais informações, consulte Eventos de trabalho. |
|
$aws/events/job/ |
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. |
|
$aws/events/job/ |
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. |
|
$aws/events/job/ |
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. |
|
$aws/events/jobExecution/ |
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. |
|
$aws/events/jobExecution/ |
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. |
|
$aws/events/jobExecution/ |
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. |
|
$aws/events/jobExecution/ |
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. |
|
$aws/events/jobExecution/ |
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. |
|
$aws/events/jobExecution/ |
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. |
|
$aws/events/jobExecution/ |
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. |
Tópicos de regras
| Tópico | Operações do cliente permitidas | Descrição |
|---|---|---|
|
$aws/rules/ |
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. |
Proteger tópicos de túneis
| Tópico | Operações do cliente permitidas | Descrição |
|---|---|---|
|
$aws/things/ |
Assinar |
O AWS IoT publica esta mensagem para que um atendente de IoT inicie um proxy local no dispositivo remoto. Para obter mais informações, consulte Snippet de atendente de IoT. |
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 de ShadowTopicPrefix |
Tipo de sombra |
|---|---|
$aws/things/thingName/shadow |
Sombra sem nome (clássica) |
$aws/things/thingName/shadow/name/shadowName |
Sombra nomeada |
Para criar um tópico completo, selecione o ShadowTopicPrefix do tipo de sombra ao qual você quer fazer referência, substitua as opções thingName, e shadowName se aplicável, por seus valores correspondentes e acrescente isso ao stub de tópico, conforme mostrado na seguinte tabela. Lembre-se de que os tópicos diferenciam maiúsculas de minúsculas.
| Tópico | Operações do cliente permitidas | Descrição |
|---|---|---|
|
|
Publicar/assinar |
Um dispositivo ou um aplicativo faz publicações nesse tópico para excluir uma sombra. Para obter mais informações, consulte /delete. |
|
|
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. |
|
|
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. |
|
|
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. |
|
|
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. |
|
|
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. |
|
|
Publicar/assinar |
Umo objeto ou um aplicativo faz publicações nesse tópico para atualizar uma sombra. Para obter mais informações, consulte /update. |
|
|
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. |
|
|
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. |
|
|
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. |
|
|
Assinar |
A AWS IoT publica um documento do estado nesse tópico sempre que a atualização de uma sombra é feita com êxito. Para obter mais informações, consulte /update/documents. |
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 para o cliente que os solicitou, independentemente de o cliente ter assinado o 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 nos formatos Representação Concisa de Objetos Binários (CBOR) e Notação de Objetos para JavaScript (JSON), dependendo do formato da carga útil do tópico.
formato da carga útil |
Tipo de dados do formato de resposta |
|---|---|
| cbor | Representação Concisa de Objetos Binários (CBOR) |
| json | Notação de Objetos para JavaScript (JSON) |
| Tópico | Operações do cliente permitidas | Descrição |
|---|---|---|
|
|
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 Uso da entrega de arquivos AWS IoT baseada em MQTT em dispositivos. |
|
$aws/things/ |
Publicar |
Um dispositivo publica neste tópico para realizar uma solicitação “GetStream”. Para obter mais informações, consulte Uso da entrega de arquivos AWS IoT baseada em MQTT em dispositivos. |
|
|
Assine, receba |
A entrega de arquivos baseada em MQTT AWS é 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 Uso da entrega de arquivos AWS IoT baseada em MQTT em dispositivos. |
|
|
Publicar |
Um dispositivo publica neste tópico para realizar uma solicitação “DescribeStream”. Para obter mais informações, consulte Uso da entrega de arquivos AWS IoT baseada em MQTT em dispositivos. |
|
|
Assine, receba |
A entrega de arquivos baseada em MQTT AWS é publicada neste tópico se uma solicitação “DescribeStream” ou “GetStream” de um dispositivo for rejeitada. Para obter mais informações, consulte Uso da entrega de arquivos AWS IoT baseada em MQTT em dispositivos. |
ARN de tópicos reservados
Todos os Nomes de Recursos do Amazon (ARNs) de tópicos reservados 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.
