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á.
Os tópicos que começam com um cifrão ($) 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 | Descrição |
---|---|---|
$ aws/sitewise/asset -models/ /assets/ /properties/ |
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 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 JavaScript Object Notation (JSON), dependendo payload-format
do tópico. AWS IoT Device Defender os tópicos só oferecem suporte à MQTT publicação.
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.
Tópico | Operações permitidas | Descrição |
---|---|---|
|
Publicar |
AWS IoT Device Defender os agentes publicam métricas para esse tópico. Para obter mais informações, consulte Enviar métricas de dispositivos. |
$aws/things/ /defender/metrics/ /accepted |
Assinar |
AWS IoT publica neste tópico depois que um AWS IoT Device Defender agente publica uma mensagem bem-sucedida em |
$aws/things/ /defender/metrics/ /rejeitado |
Assinar |
AWS IoT publica neste tópico depois que um AWS IoT Device Defender agente publica uma mensagem malsucedida em $aws/things/ /defender/metrics/. |
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 Wi-FiGNSS, 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 ter 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/ /get_position_estimate |
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. |
$ aws/device_location/ /get_position_estimate/accepted |
Assinar |
AWS IoT Core A localização do dispositivo é publicada neste tópico depois de resolver a localização do dispositivo com êxito. |
$ aws/device_location/ /get_position_estimate/rejeitado |
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 | Descrição |
---|---|---|
$aws/events/certificates/registered/ |
Assinar |
AWS IoT publica essa mensagem ao registrar AWS IoT automaticamente um certificado e quando um cliente apresenta um certificado com o |
$aws/events/job/ |
Assinar |
AWS IoT publica essa mensagem quando um trabalho é cancelado. Para obter mais informações, consulte Eventos de trabalho. |
$aws/events/job/jobID /cancelamento_em_andamento |
Assinar |
AWS IoT publica essa mensagem quando um cancelamento de trabalho está em andamento. Para obter mais informações, consulte Eventos de trabalho. |
$aws/events/job/ |
Assinar |
AWS IoT publica essa mensagem quando um trabalho é concluído. Para obter mais informações, consulte Eventos de trabalho. |
$aws/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. |
$aws/events/job/jobID /deletion_in_progress |
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. |
$aws/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. |
$aws/events/jobExecution/jobID /excluído |
Assinar |
AWS IoT publica essa mensagem quando a execução de um trabalho é excluída. Para obter mais informações, consulte Eventos de trabalho. |
$aws/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. |
$aws/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. |
$aws/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. |
$aws/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. |
$aws/events/jobExecution/jobID /timed_out |
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. |
$aws/events/presence/connected/ |
Assinar |
AWS IoT publica neste tópico quando um MQTT cliente com a ID de cliente especificada se conecta a. AWS IoT Para obter mais informações, consulte Eventos de conexão/desconexão. |
$aws/events/presence/disconnected/ |
Assinar |
AWS IoT publica neste tópico quando um MQTT cliente com a ID de cliente especificada se desconecta a. AWS IoT Para obter mais informações, consulte Eventos de conexão/desconexão. |
$aws/events/subscriptions/subscribed/ |
Assinar |
AWS IoT publica neste tópico quando um MQTT cliente com o ID de cliente especificado se inscreve em um MQTT tópico. Para obter mais informações, consulte Eventos de assinatura/cancelamento de assinatura. |
$aws/events/subscriptions/unsubscribed/ |
Assinar |
AWS IoT publica neste tópico quando um MQTT cliente 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. |
$aws/events/thing/ |
Assinar |
AWS IoT publica neste tópico quando a |
$aws/events/thing/ |
Assinar |
AWS IoT publica neste tópico quando a |
$aws/events/thing/ |
Assinar |
AWS IoT publica neste tópico quando a |
$aws/events/thingGroup/ |
Assinar |
AWS IoT publica neste tópico quando um grupo de coisas |
$aws/events/thingGroup/ |
Assinar |
AWS IoT publica neste tópico quando o grupo de coisas |
$aws/events/thingGroup/ |
Assinar |
AWS IoT publica neste tópico quando um grupo de coisas |
$aws/events/thingType/ |
Assinar |
AWS IoT publica neste tópico quando o tipo de |
$aws/events/thingType/ |
Assinar |
AWS IoT publica neste tópico quando o tipo de |
$aws/events/thingType/ |
Assinar |
AWS IoT publica neste tópico quando o tipo de |
$aws/events/thingTypeAssociation/thing/ |
Assinar |
AWS IoT publica neste tópico quando algo |
$aws/events/thingGroupMembership/thingGroup/ |
Assinar |
AWS IoT publica neste tópico quando algo |
$aws/events/thingGroupMembership/thingGroup/ |
Assinar |
AWS IoT publica neste tópico quando algo |
$aws/events/thingGroupHierarchy/thingGroup// |
Assinar |
AWS IoT publica neste tópico quando um grupo de coisas |
$aws/events/thingGroupHierarchy/thingGroup// |
Assinar |
AWS IoT publica neste tópico quando o grupo de coisas |
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 JavaScript Object Notation (JSON), dependendo payload-format
do tópico.
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.
Tópico | Operações do cliente permitidas | Descrição |
---|---|---|
$aws/certificates/create/ |
Publicar |
Publique neste tópico para criar um certificado a partir de uma solicitação de assinatura de certificado (CSR). |
$aws/certificates/create/ |
Assine, receba |
AWS IoT publica neste tópico após uma chamada bem-sucedida para $aws/certificates/create/ |
$aws/certificates/create/ |
Assine, receba |
AWS IoT publica neste tópico após uma chamada malsucedida para $aws/certificates/create/. |
$ aws/certificates/create -de-csr/ |
Publicar |
Publica neste tópico para criar um certificado a partir de umCSR. |
$ aws/certificates/create |
Assine, receba |
AWS IoT publica neste tópico uma chamada bem-sucedida para $ aws/certificates/create |
$ aws/certificates/create |
Assine, receba |
AWS IoT publica neste tópico uma chamada malsucedida para $ aws/certificates/create -from-csr/. |
$aws/provisioning-templates/ /provision/ |
Publicar |
Publique nesse tópico para registrar um objeto. |
$aws/provisioning-templates/ /provision/ /accepted |
Assine, receba |
AWS IoT publica neste tópico após uma chamada bem-sucedida para |
$aws/provisioning-templates/ /provision/ /rejeitado |
Assine, receba |
AWS IoT publica neste tópico após uma chamada malsucedida para |
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 no lado da nuvem.
Para obter mais informações, consulte MQTTAPIOperações de dispositivos de tarefas.
Tópico | Operações do cliente permitidas | Descrição |
---|---|---|
$ |
Publicar |
Os dispositivos publicam uma mensagem neste tópico para fazer uma solicitação |
$ aws/coisas// |
Assine, receba |
Os dispositivos se inscrevem nesse tópico para receber respostas bem-sucedidas de uma solicitação |
$ aws/coisas// |
Assine, receba |
Os dispositivos assinam este tópico para receber uma resposta quando uma solicitação |
|
Publicar |
Os dispositivos publicam uma mensagem neste tópico para fazer uma solicitação |
$ aws/coisas// |
Assine, receba |
Os dispositivos assinam este tópico para receber respostas bem-sucedidas para uma solicitação |
$ aws/coisas// |
Assine, receba |
Os dispositivos assinam este tópico para receber uma resposta quando uma solicitação |
$aws/things/ /jobs/ /get |
Publicar |
Os dispositivos publicam uma mensagem neste tópico para fazer uma solicitação |
$aws/things/ /jobs/ /get/accepted |
Assine, receba |
Os dispositivos assinam este tópico para receber respostas bem-sucedidas para uma solicitação |
$aws/things/ /jobs/ /get/rejeitado |
Assine, receba |
Os dispositivos assinam este tópico para receber uma resposta quando uma solicitação |
$aws/things/ /jobs/ /update |
Publicar |
Os dispositivos publicam uma mensagem neste tópico para fazer uma solicitação |
$aws/things/ /jobs/ /update/accepted |
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/ /jobs/ /update/rejeitado |
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/ |
|
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 MQTTAPIOperações de dispositivos de tarefas. |
|
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 MQTTAPIOperações de dispositivos de tarefas. |
$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 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 | Descrição |
---|---|---|
$aws/commands///executions/ /request/ $aws/commands///executions/ /request |
Assine, receba |
Os dispositivos recebem uma mensagem sobre esse tópico quando uma solicitação é feita para iniciar a execução de um comando no console ou usando |
$aws/commands///executions/ /response/ |
Publicar |
Os dispositivos usam o |
$aws/commands///executions/ /response/ $aws/commands///executions/ /response/accepted |
Assine, receba |
Se o serviço de nuvem tiver processado com êxito o resultado da execução do comando, AWS IoT Device Management publicará uma resposta ao tópico /aceito. |
$aws/commands///executions/ /response/ $aws/commands///executions/ /response/rejeitado |
Publicar |
Se o serviço de nuvem falhar ao processar o resultado da execução do comando, AWS IoT Device Management publicará uma resposta ao tópico /rejeitado. |
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 |
---|---|---|
|
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. |
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 $aws/things/ /shadow |
Sombra sem nome (clássica) |
$aws/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 | 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 MQTTTópicos do Device Shadow. |
|
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 |
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. |
MQTTtópicos de entrega de arquivos baseados em
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 JavaScript Object Notation (JSON), dependendo payload-format
do tópico.
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 | Descrição |
---|---|---|
$ aws/things/ /streams/ /data/ |
Assine, receba |
AWS MQTTa entrega de arquivos baseada é 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/ /streams/ /get/ |
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. |
$aws/things/ /streams/ /description/ |
Assine, receba |
AWS MQTTa entrega de arquivos baseada é 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. |
$ aws/things/ /streams/ /describe/ |
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. |
$aws/things/ /streams/ /rejeted/ |
Assine, receba |
AWS MQTTa entrega baseada em arquivos é 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. |
Tópico reservado ARN
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
.