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 reservados
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 |
|---|---|---|
|
|
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 do formato da carga útil do tópico. AWS IoT Device Defender os tópicos suportam somente a publicação em MQTT.
formato da carga útil |
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 Envio de métricas de dispositivos.
| Tópico | Operações permitidas | Descrição |
|---|---|---|
|
$aws/things/ |
Publicar |
AWS IoT Device Defender os agentes publicam métricas para esse tópico. Para obter mais informações, consulte Envio de métricas de dispositivos. |
|
$aws/things/ |
Assinar |
AWS IoT |
|
$aws/things/ |
Assinar |
AWS IoT |
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 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 AWS IoT Core do dispositivo. |
|
$aws/device_location/ |
Assinar |
AWS IoT Core A localização do dispositivo é publicada neste tópico depois de resolver a localização do dispositivo com êxito. |
|
|
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
nota
Para obter mais informações sobre tópicos reservados do MQTT para eventos de LoRa WAN, consulte Eventos de status de conexão.
| Tópico | Operações do cliente permitidas | Descrição |
|---|---|---|
|
$aws/eventos/certificados/registrados/ |
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 ter mais informações, consulte Eventos de trabalho. |
$aws/events/job/jobId/cancellation_in_progress |
Assinar |
AWS IoT publica essa mensagem quando um cancelamento de trabalho está em andamento. Para ter mais informações, consulte Eventos de trabalho. |
|
$aws/events/job/ |
Assinar |
AWS IoT publica essa mensagem quando um trabalho é concluído. Para ter mais informações, consulte Eventos de trabalho. |
$aws/events/job/jobId/deleted |
Assinar |
AWS IoT publica essa mensagem quando um trabalho é excluído. Para ter 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 ter mais informações, consulte Eventos de trabalho. |
$aws/events/jobExecution/jobId/canceled |
Assinar |
AWS IoT publica essa mensagem quando a execução de um trabalho é cancelada. Para ter mais informações, consulte Eventos de trabalho. |
$aws/events/jobExecution/jobId/deleted |
Assinar |
AWS IoT publica essa mensagem quando a execução de um trabalho é excluída. Para ter mais informações, consulte Eventos de trabalho. |
$aws/events/jobExecution/jobId/failed |
Assinar |
AWS IoT publica essa mensagem quando a execução de um trabalho falha. Para ter mais informações, consulte Eventos de trabalho. |
$aws/events/jobExecution/jobId/rejected |
Assinar |
AWS IoT publica essa mensagem quando a execução de um trabalho é rejeitada. Para ter mais informações, consulte Eventos de trabalho. |
$aws/events/jobExecution/jobId/removed |
Assinar |
AWS IoT publica essa mensagem quando a execução de um trabalho é removida. Para ter mais informações, consulte Eventos de trabalho. |
$aws/events/jobExecution/jobId/succeeded |
Assinar |
AWS IoT publica essa mensagem quando a execução de um trabalho é bem-sucedida. Para ter 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 ter mais informações, consulte Eventos de trabalho. |
|
$aws/events/presence/connected/ |
Assinar |
AWS IoT publica neste tópico quando um cliente MQTT com o ID do cliente especificado se conecta a. AWS IoT Para ter mais informações, consulte Eventos de conexão/desconexão. |
|
$aws/events/presence/disconnected/ |
Assinar |
AWS IoT publica neste tópico quando um cliente MQTT com a ID de cliente especificada se desconecta a. AWS IoT Para ter mais informações, consulte Eventos de conexão/desconexão. |
|
$aws/events/subscriptions/subscribed/ |
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 ter mais informações, consulte Eventos de assinatura/cancelamento de assinatura. |
|
$aws/events/subscriptions/unsubscribed/ |
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 ter mais informações, consulte Eventos de assinatura/cancelamento de assinatura. |
|
$aws/events/thing/ |
Assinar |
AWS IoT publica neste tópico quando a coisa |
|
$aws/events/thing/ |
Assinar |
AWS IoT publica neste tópico quando o |
|
$aws/events/thing/ |
Assinar |
AWS IoT publica neste tópico quando a coisa |
|
|
Assinar |
AWS IoT publica neste tópico quando um grupo de coisas |
|
|
Assinar |
AWS IoT publica neste tópico quando o grupo de coisas |
|
|
Assinar |
AWS IoT publica neste tópico quando um grupo de coisas |
|
$aws/events/ThingType/ /created |
Assinar |
AWS IoT publica neste tópico quando o tipo de |
|
$aws/events/ThingType/ /updated |
Assinar |
AWS IoT publica neste tópico quando o tipo de |
|
$aws/events/ThingType/ /excluído |
Assinar |
AWS IoT publica neste tópico quando o tipo de |
|
|
Assinar |
AWS IoT publica neste tópico quando a coisa |
|
|
Assinar |
AWS IoT publica neste tópico quando thing |
|
|
Assinar |
AWS IoT publica neste tópico quando thing |
|
thingGroupHierarchy |
Assinar |
AWS IoT |
|
thingGroupHierarchy |
Assinar |
AWS IoT |
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 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 | JavaScript Notação de objeto (JSON) |
Para ter 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 |
AWS IoT |
|
$aws/certificates/create/ |
Assine, receba |
AWS IoT |
|
create-from-csr |
Publicar |
Publica nesse tópico para criar um certificado a partir de uma CSR. |
|
|
Assine, receba |
AWS IoT |
|
|
Assine, receba |
AWS IoT |
|
$aws/provisioning-templates/ |
Publicar |
Publique nesse tópico para registrar um objeto. |
|
$aws/provisioning-templates/ |
Assine, receba |
AWS IoT |
|
$aws/provisioning-templates/ |
Assine, receba |
AWS IoT |
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 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 ter 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 ter 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 ter 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 ter 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 ter 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 ter 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 ter 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 ter 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 ter 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 ter 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 ter 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 ter 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 ter 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 ter 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 ter 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 |
AWS IoT publica essa mensagem para que um agente de IoT inicie um proxy local no dispositivo remoto. Para ter 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.
ShadowTopicPrefix value |
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 ShadowTopicPrefixtipo de sombra ao qual você deseja se referir, substitua ThingName e, se aplicável, ShadoWame, por seus valores correspondentes e, em seguida, anexe-os 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 ter 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 |
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. |
Tópicos de entrega de arquivos baseados em MQTT
Essas mensagens oferecem suporte a buffers de resposta no formato Concise Binary Object Representation (CBOR) e JavaScript Object Notation (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 | JavaScript Notação de objeto (JSON) |
| Tópico | Operações do cliente permitidas | Descrição |
|---|---|---|
|
|
Assinar |
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 ter mais informações, consulte Usando a entrega de arquivos AWS IoT baseada em MQTT em dispositivos. |
|
|
Publicar |
Um dispositivo publica neste tópico para realizar uma solicitação GetStream "”. Para ter mais informações, consulte Usando a entrega de arquivos AWS IoT baseada em MQTT em dispositivos. |
|
|
Assinar |
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 ter mais informações, consulte Usando a entrega de arquivos AWS IoT baseada em MQTT em dispositivos. |
|
|
Publicar |
Um dispositivo publica neste tópico para realizar uma solicitação DescribeStream "”. Para ter mais informações, consulte Usando a entrega de arquivos AWS IoT baseada em MQTT em dispositivos. |
|
|
Assinar |
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 ter mais informações, consulte Usando a 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.
