Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Temas reservados
Los temas que comienzan con un signo de dólar ($) están reservados para su uso exclusivo AWS IoT. Puede suscribirse y publicar en estos temas reservados según lo permitan; sin embargo, no puede crear nuevos temas que comiencen por un signo de dólar. Las operaciones de publicación o suscripción no admitidas a temas reservados pueden dar como resultado que se termine la conexión.
Temas del modelo de activos
Tema | Operaciones de cliente permitidas | Descripción |
---|---|---|
$ aws/sitewise/asset |
Suscribirse |
AWS IoT SiteWise publica notificaciones de propiedades de activos sobre este tema. Para obtener más información, consulte Interacción con otros AWS servicios en la Guía del AWS IoT SiteWise usuario. |
AWS IoT Device Defender temas
Estos mensajes admiten búferes de respuesta en formato de representación concisa de objetos binarios (JSON) y en notación payload-format
de JavaScript objetos (), según el tema. CBOR AWS IoT Device Defender los temas solo admiten la MQTT publicación.
payload-format |
Tipo de datos de formato de respuesta |
---|---|
cbor | Representación concisa de objetos binarios (CBOR) |
json | JavaScript Notación de objetos (JSON) |
Para obtener más información, consulte Envío de métricas desde dispositivos.
Tema | Operaciones permitidas | Descripción |
---|---|---|
$aws/things/ /defender/metrics/ |
Publish |
AWS IoT Device Defender los agentes publican métricas sobre este tema. Para obtener más información, consulte Envío de métricas desde dispositivos. |
$aws/things/ /defender/metrics/ /accepted |
Suscribirse |
AWS IoT publica en este tema después de que un agente publique correctamente un mensaje en $aws/things/ /defender/metrics/. AWS IoT Device Defender |
$aws/things/ /defender/metrics/ /rejected |
Suscribirse |
AWS IoT publica en este tema después de que un agente publique un mensaje fallido en $aws/things/ /defender/metrics/. AWS IoT Device Defender |
AWS IoT Core Temas de ubicación de dispositivos
AWS IoT Core La ubicación del dispositivo puede resolver los datos de medición de su dispositivo y proporcionar una ubicación estimada de sus dispositivos de IoT. Los datos de medición del dispositivo pueden incluir la conexión WiFiGNSS, la red móvil y la dirección IP. AWS IoT Core A continuación, la ubicación del dispositivo elige el tipo de medición que proporciona la mejor precisión y resuelve la información de ubicación del dispositivo. Para obtener más información, consulte AWS IoT Core Device Location y Resolución de la ubicación del dispositivo mediante los temas de MQTT de AWS IoT Core Device Location.
Tema | Operaciones permitidas | Descripción |
---|---|---|
$aws/device_location/ /get_position_estimate |
Publish |
Un dispositivo publica sobre este tema para que los datos de medición sin procesar escaneados se resuelvan según la ubicación del dispositivo. AWS IoT Core |
$aws/device_location/ /get_position_estimate/accepted |
Suscribirse |
AWS IoT Core Device Location publica este tema después de haber resuelto correctamente la ubicación del dispositivo. |
$aws/device_location/ /get_position_estimate/rejected |
Suscribirse |
AWS IoT Core La ubicación del dispositivo publica este tema cuando no puede resolver la ubicación del dispositivo correctamente debido a errores 4xx. |
Temas de eventos
Los mensajes de eventos se publican cuando se producen determinados eventos. Por ejemplo, el registro genera eventos cuando se agregan, actualizan o eliminan objetos. La tabla muestra los distintos AWS IoT eventos y sus temas reservados.
Tema | Operaciones de cliente permitidas | Descripción |
---|---|---|
$aws/events/certificates/registered/ |
Suscribirse |
AWS IoT publica este mensaje cuando registra AWS IoT automáticamente un certificado y cuando un cliente presenta un certificado con el |
$aws/events/job/ |
Suscribirse |
AWS IoT publica este mensaje cuando se cancela un trabajo. Para obtener más información, consulte Eventos de trabajos. |
$aws/events/job/jobID /cancellation_in_progress |
Suscribirse |
AWS IoT publica este mensaje cuando hay una cancelación de trabajo en curso. Para obtener más información, consulte Eventos de trabajos. |
$aws/events/job/ |
Suscribirse |
AWS IoT publica este mensaje cuando se ha completado un trabajo. Para obtener más información, consulte Eventos de trabajos. |
$aws/events/job/jobID /eliminado |
Suscribirse |
AWS IoT publica este mensaje cuando se elimina un trabajo. Para obtener más información, consulte Eventos de trabajos. |
$aws/events/job/jobID /deletion_in_progress |
Suscribirse |
AWS IoT publica este mensaje cuando se está eliminando un trabajo. Para obtener más información, consulte Eventos de trabajos. |
$aws/events/jobExecution/jobID /cancelado |
Suscribirse |
AWS IoT publica este mensaje cuando se cancela la ejecución de un trabajo. Para obtener más información, consulte Eventos de trabajos. |
$aws/events/jobExecution/jobID /eliminado |
Suscribirse |
AWS IoT publica este mensaje cuando se elimina la ejecución de un trabajo. Para obtener más información, consulte Eventos de trabajos. |
$aws/events/jobExecution/jobID /failed |
Suscribirse |
AWS IoT publica este mensaje cuando se produce un error en la ejecución de un trabajo. Para obtener más información, consulte Eventos de trabajos. |
$aws/events/jobExecution/jobID /rejected |
Suscribirse |
AWS IoT publica este mensaje cuando se rechaza la ejecución de un trabajo. Para obtener más información, consulte Eventos de trabajos. |
$aws/events/jobExecution/jobID /removed |
Suscribirse |
AWS IoT publica este mensaje cuando se elimina una ejecución de trabajo. Para obtener más información, consulte Eventos de trabajos. |
$aws/events/jobExecution/jobID /successful |
Suscribirse |
AWS IoT publica este mensaje cuando la ejecución de un trabajo se ha realizado correctamente. Para obtener más información, consulte Eventos de trabajos. |
$aws/events/jobExecution/jobID /timed_out |
Suscribirse |
AWS IoT publica este mensaje cuando se agota el tiempo de espera de una ejecución de un trabajo. Para obtener más información, consulte Eventos de trabajos. |
$aws/events/presence/connected/ |
Suscribirse |
AWS IoT publica este tema cuando un MQTT cliente con el ID de cliente especificado se conecta a AWS IoT. Para obtener más información, consulte Eventos de conexión/desconexión. |
$aws/events/presence/disconnected/ |
Suscribirse |
AWS IoT publica en este tema cuando un MQTT cliente con el ID de cliente especificado se desconecta a AWS IoT. Para obtener más información, consulte Eventos de conexión/desconexión. |
$aws/events/subscriptions/subscribed/ |
Suscribirse |
AWS IoT publica en este tema cuando un MQTT cliente con el ID de cliente especificado se suscribe a un MQTT tema. Para obtener más información, consulte Eventos de suscripción/cancelación de suscripción. |
$aws/events/subscriptions/unsubscribed/ |
Suscribirse |
AWS IoT publica en este tema cuando un MQTT cliente con el ID de cliente especificado cancela su suscripción a un tema. MQTT Para obtener más información, consulte Eventos de suscripción/cancelación de suscripción. |
$//created aws/events/thing |
Suscribirse |
AWS IoT publica en este tema cuando se crea la |
$aws/events/thing/ |
Suscribirse |
AWS IoT publica en este tema cuando |
$aws/events/thing/ |
Suscribirse |
AWS IoT publica en este tema cuando se elimina la |
$aws/events/thingGroup/ |
Suscribirse |
AWS IoT publica en este tema cuando |
$aws/events/thingGroup/ |
Suscribirse |
AWS IoT publica en este tema cuando se |
$aws/events/thingGroup/ |
Suscribirse |
AWS IoT publica en este tema cuando |
$aws/events/thingType/ |
Suscribirse |
AWS IoT publica en este tema cuando se crea el tipo de |
$aws/events/thingType/ |
Suscribirse |
AWS IoT publica en este tema cuando se actualiza el tipo de |
$aws/events/thingType/ |
Suscribirse |
AWS IoT publica en este tema cuando se elimina el tipo de |
$aws/events/thingTypeAssociation/thing/ |
Suscribirse |
AWS IoT publica en este tema cuando algo |
$aws/events/thingGroupMembership/thingGroup//thing/ |
Suscribirse |
AWS IoT publica en este tema cuando |
$aws/events/thingGroupMembership/thingGroup/ |
Suscribirse |
AWS IoT publica en este tema cuando |
$aws/events/thingGroupHierarchy/thingGroup// |
Suscribirse |
AWS IoT publica en este tema cuando |
$aws/events/thingGroupHierarchy/thingGroup/ |
Suscribirse |
AWS IoT publica en este tema cuando |
Temas de aprovisionamiento de flotas
nota
Las operaciones de cliente indicadas como Recibir en esta tabla indican los temas que se AWS IoT publican directamente para el cliente que los solicitó, independientemente de que el cliente esté suscrito al tema o no. Los clientes deben esperar recibir estos mensajes de respuesta aunque no estén suscritos a ellos. Estos mensajes de respuesta no pasan por el agente de mensajes y otros clientes o reglas no pueden suscribirse a ellos.
Estos mensajes admiten búferes de respuesta en formato de representación concisa de objetos binarios (CBOR) y notación de JavaScript objetos (JSON), según el payload-format
tema.
payload-format |
Tipo de datos de formato de respuesta |
---|---|
cbor | Representación concisa de objetos binarios () CBOR |
json | JavaScript Notación de objetos (JSON) |
Para obtener más información, consulte API de MQTT de aprovisionamiento de dispositivos.
Tema | Operaciones de cliente permitidas | Descripción |
---|---|---|
$aws/certificates/create/ |
Publish |
Publique en este tema para crear un certificado a partir de una solicitud de firma de certificado (CSR). |
$aws/certificates/create/ |
Suscribirse, recibir |
AWS IoT publica en este tema tras una llamada exitosa a $aws/certificates/create/ |
$aws/certificates/create/ |
Suscribirse, recibir |
AWS IoT publica en este tema después de una llamada fallida a $aws/certificates/create/ |
$ aws/certificates/create -from-csr/ |
Publish |
Publica en este tema para crear un certificado a partir de un. CSR |
$ aws/certificates/create -from-csr/ /accepted |
Suscribirse, recibir |
AWS IoT publica en este tema una llamada exitosa a $ -from-csr/. aws/certificates/create |
$ -from-csr/ /rejected aws/certificates/create |
Suscribirse, recibir |
AWS IoT publica en este tema una llamada fallida a $ -from-csr/. aws/certificates/create |
|
Publish |
Publique en este tema para registrar un objeto. |
$aws/provisioning-templates/ /provision/ |
Suscribirse, recibir |
AWS IoT publica en este tema tras una llamada exitosa a $aws/provisioning-templates/ /provision/. |
$aws/provisioning-templates/ /provision/ /rejected |
Suscribirse, recibir |
AWS IoT publica en este tema tras una llamada fallida a $aws/provisioning-templates/ /provision/. |
Temas de trabajos
nota
Las operaciones de cliente indicadas como Recibir en esta tabla indican los temas que se AWS IoT publican directamente para el cliente que los solicitó, independientemente de que el cliente esté suscrito al tema o no. Los clientes deben esperar recibir estos mensajes de respuesta aunque no estén suscritos a ellos.
Estos mensajes de respuesta no pasan por el agente de mensajes y otros clientes o reglas no pueden suscribirse a ellos. Para suscribirse a los mensajes relacionados con la actividad de trabajos, utilice los temas notify
y notify-next
.
Al suscribirse a los temas de tareas y eventos jobExecution
de su solución de monitoreo de flota, primero debe habilitar los eventos de tareas y ejecución de tareas para recibir cualquier evento en la nube.
Para obtener más información, consulte Realiza las MQTT API operaciones del dispositivo.
Tema | Operaciones de cliente permitidas | Descripción |
---|---|---|
$aws/things/ /jobs/get |
Publish |
Los dispositivos publican un mensaje en este tema para realizar una solicitud |
|
Suscribirse, recibir |
Los dispositivos se suscriben a este tema para recibir respuestas correctas de una solicitud |
|
Suscribirse, recibir |
Los dispositivos se suscriben a este tema para recibir una respuesta cuando se rechaza una solicitud |
$aws/things/ /jobs/start-next |
Publish |
Los dispositivos publican un mensaje en este tema para realizar una solicitud |
|
Suscribirse, recibir |
Los dispositivos se suscriben a este tema para recibir respuestas correctas a una solicitud |
|
Suscribirse, recibir |
Los dispositivos se suscriben a este tema para recibir una respuesta cuando se rechaza una solicitud |
$aws/cosas/ /jobs/ /get |
Publish |
Los dispositivos publican un mensaje en este tema para realizar una solicitud |
$aws/things/ /jobs/ |
Suscribirse, recibir |
Los dispositivos se suscriben a este tema para recibir respuestas correctas a una solicitud |
$aws/things/ /jobs/ |
Suscribirse, recibir |
Los dispositivos se suscriben a este tema para recibir una respuesta cuando se rechaza una solicitud |
$aws/things/ /jobs/ |
Publish |
Los dispositivos publican un mensaje en este tema para realizar una solicitud |
$aws/things/ /jobs/ |
Suscribirse, recibir |
Los dispositivos se suscriben a este tema para recibir respuestas correctas a una solicitud NotaSolo el dispositivo que publica en $aws/things/ /jobs/ /update recibe mensajes sobre este tema. |
$aws/things/ /jobs/ /update/rejected |
Suscribirse, recibir |
Los dispositivos se suscriben a este tema para recibir una respuesta cuando se rechaza una solicitud NotaSolo el dispositivo que publica en $aws/things/ /jobs/ /update recibe mensajes sobre este tema. |
$aws/things/ /jobs/notify |
Suscribirse, recibir |
Los dispositivos se suscriben a este tema para recibir notificaciones cuando la ejecución de un trabajo se añade o elimina de la lista de ejecuciones pendientes de un objeto. Para obtener más información, consulte Realiza las MQTT API operaciones del dispositivo. |
$aws/things/ /jobs/notify-next |
Suscribirse, recibir |
Los dispositivos se suscriben a este tema para recibir notificaciones cuando cambia la siguiente ejecución de un trabajo pendiente para el objeto. Para obtener más información, consulte Realiza las MQTT API operaciones del dispositivo. |
$/aws/events/job/completado |
Suscribirse |
El servicio de trabajos publica un evento sobre este tema cuando se completa un trabajo. Para obtener más información, consulte Eventos de trabajos. |
$aws/events/job//cancelado |
Suscribirse |
El servicio de trabajos publica un evento sobre este tema cuando se cancela un trabajo. Para obtener más información, consulte Eventos de trabajos. |
$aws/events/job//eliminado |
Suscribirse |
El servicio de trabajos publica un evento sobre este tema cuando se elimina un trabajo. Para obtener más información, consulte Eventos de trabajos. |
$aws/events/job/ |
Suscribirse |
El servicio de trabajos publica un evento sobre este tema cuando se inicia la cancelación de un trabajo. Para obtener más información, consulte Eventos de trabajos. |
$aws/events/job/ |
Suscribirse |
El servicio de trabajos publica un evento sobre este tema cuando se inicia la eliminación de un trabajo. Para obtener más información, consulte Eventos de trabajos. |
$aws/events/jobExecution/ |
Suscribirse |
El servicio de trabajos publica un evento sobre este tema cuando la ejecución del trabajo se ejecuta satisfactoriamente. Para obtener más información, consulte Eventos de trabajos. |
$aws/events/jobExecution//falló |
Suscribirse |
El servicio de trabajos publica un evento sobre este tema cuando la ejecución de un trabajo produce un error. Para obtener más información, consulte Eventos de trabajos. |
$aws/events/jobExecution//rechazado |
Suscribirse |
El servicio de trabajos publica un evento sobre este tema cuando se rechaza una ejecución de un trabajo. Para obtener más información, consulte Eventos de trabajos. |
$aws/events/jobExecution//cancelado |
Suscribirse |
El servicio de trabajos publica un evento sobre este tema cuando se cancela la ejecución de un trabajo. Para obtener más información, consulte Eventos de trabajos. |
$aws/events/jobExecution//timed_out |
Suscribirse |
El servicio de trabajos publica un evento sobre este tema cuando se agota el tiempo de espera de ejecución de un trabajo. Para obtener más información, consulte Eventos de trabajos. |
$ aws/events/jobExecution |
Suscribirse |
El servicio de trabajos publica un evento sobre este tema cuando se elimina la ejecución de un trabajo. Para obtener más información, consulte Eventos de trabajos. |
$aws/events/jobExecution//eliminado |
Suscribirse |
El servicio de trabajos publica un evento sobre este tema cuando se elimina la ejecución de un trabajo. Para obtener más información, consulte Eventos de trabajos. |
Temas de comandos
nota
Las operaciones de cliente indicadas como Recibir en esta tabla indican los temas que se AWS IoT publican directamente para el cliente que los solicitó, independientemente de que el cliente esté suscrito al tema o no. Los clientes deben esperar recibir estos mensajes de respuesta aunque no estén suscritos a ellos.
Estos mensajes de respuesta no pasan por el agente de mensajes y otros clientes o reglas no pueden suscribirse a ellos.
Tema | Operaciones de cliente permitidas | Descripción |
---|---|---|
$aws/commands///executions/ /request/ $aws/commands// |
Suscribirse, recibir |
Los dispositivos reciben un mensaje sobre este tema cuando se solicita iniciar la ejecución de un comando desde la consola o mediante. |
$aws/commands///executions/ /response/ |
Publish |
Los dispositivos utilizan el para publicar un mensaje sobre la |
$aws/commands///executions/ /response/ $aws/commands// |
Suscribirse, recibir |
Si el servicio en la nube procesó correctamente el resultado de la ejecución del comando, publica una respuesta al tema /accepted. AWS IoT Device Management |
$aws/commands///executions/ /response/ /rejected $aws/commands// |
Publish |
Si el servicio en la nube no pudo procesar el resultado de la ejecución del comando, publica una respuesta al tema /rechazad. AWS IoT Device Management |
Temas de reglas
Tema | Operaciones de cliente permitidas | Descripción |
---|---|---|
$aws/rules/ |
Publish |
Los dispositivos o las aplicaciones publican en este tema para activar reglas directamente. Para obtener más información, consulte Reducción de los costes de mensajería con Basic Ingest. |
Temas de tunelización segura
Tema | Operaciones de cliente permitidas | Descripción |
---|---|---|
$aws/things/ /tunnels/notify |
Suscribirse |
AWS IoT publica este mensaje para que un agente de IoT inicie un proxy local en el dispositivo remoto. Para obtener más información, consulte Fragmento de agente de IoT. |
Temas de sombra
Las sombras con nombre y sin nombre utilizan los temas de esta sección. Los temas utilizados por cada uno solo difieren en el prefijo del tema. Esta tabla muestra el prefijo de tema utilizado por cada tipo de sombra.
Valor de ShadowTopicPrefix |
Tipo de sombra |
---|---|
$aws/things/ /shadow thingName |
Sombra sin nombre (clásica) |
thingName $aws/cosas/ /shadow/name/ shadowName |
Sombra con nombre |
Para crear un tema completo, seleccione el tipo de sombra al que desee hacer referencia, sustitúyala y, si procede, ShadowTopicPrefix
por sus valores correspondientes thingName
y shadowName
añádala al código auxiliar del tema, tal y como se muestra en la siguiente tabla. Recuerde que los temas distinguen entre mayúsculas y minúsculas.
Tema | Operaciones de cliente permitidas | Descripción |
---|---|---|
|
Publicar/suscribirse |
Un dispositivo o una aplicación publica en este tema para eliminar una sombra. Para obtener más información, consulte /delete. |
|
Suscribirse |
El servicio Device Shadow envía mensajes a este tema cuando se elimina una sombra. Para obtener más información, consulte /delete/accepted. |
|
Suscribirse |
El servicio Device Shadow envía mensajes a este tema cuando se rechaza una solicitud para eliminar una sombra. Para obtener más información, consulte /delete/rejected. |
|
Publicar/suscribirse |
Una aplicación o un objeto publica un mensaje vacío en este tema para obtener una sombra. Para obtener más información, consulte MQTTTemas sobre Device Shadow. |
|
Suscribirse |
El servicio Device Shadow envía mensajes a este tema cuando se realiza correctamente una solicitud de una sombra. Para obtener más información, consulte /get/accepted. |
|
Suscribirse |
El servicio Device Shadow envía mensajes a este tema cuando se rechaza una solicitud de una sombra. Para obtener más información, consulte /get/rejected. |
|
Publicar/suscribirse |
Un objeto o una aplicación publica en este tema para actualizar una sombra. Para obtener más información, consulte /update. |
|
Suscribirse |
El servicio Device Shadow envía mensajes a este tema cuando se realiza correctamente una actualización en una sombra. Para obtener más información, consulte /update/accepted. |
|
Suscribirse |
El servicio Device Shadow envía mensajes a este tema cuando se rechaza una actualización en una sombra. Para obtener más información, consulte /update/rejected. |
|
Suscribirse |
El servicio Device Shadow envía mensajes a este tema cuando se detecta una diferencia entre las secciones para los estados reported y desired de una sombra. Para obtener más información, consulte /update/delta. |
|
Suscribirse |
AWS IoT publica un documento estatal sobre este tema cada vez que se realiza correctamente una actualización de la sombra. Para obtener más información, consulte /update/documents. |
MQTTtemas basados en la entrega de archivos
nota
Las operaciones de cliente indicadas como Recibir en esta tabla indican los temas que se AWS IoT publican directamente para el cliente que los solicitó, independientemente de que el cliente esté suscrito al tema o no. Los clientes deben esperar recibir estos mensajes de respuesta aunque no estén suscritos a ellos. Estos mensajes de respuesta no pasan por el agente de mensajes y otros clientes o reglas no pueden suscribirse a ellos.
Estos mensajes admiten búferes de respuesta en formato de representación concisa de objetos binarios (CBOR) y notación de JavaScript objetos (JSON), según el payload-format
tema.
payload-format |
Tipo de datos de formato de respuesta |
---|---|
cbor | Representación concisa de objetos binarios () CBOR |
json | JavaScript Notación de objetos (JSON) |
Tema | Operaciones de cliente permitidas | Descripción |
---|---|---|
$aws/things/ /streams/ /data/ |
Suscribirse, recibir |
AWS MQTTLa entrega de archivos basada en archivos se publica en este tema si se acepta la solicitud «» de un dispositivo. GetStream La carga útil contiene los datos de la transmisión. Para obtener más información, consulte Uso de la entrega de archivos AWS IoT basada en MQTT en los dispositivos. |
$aws/things/ /streams/ /get/ |
Publish |
Un dispositivo publica en este tema para realizar una solicitud «». GetStream Para obtener más información, consulte Uso de la entrega de archivos AWS IoT basada en MQTT en los dispositivos. |
$aws/things/ /streams/ /description/ |
Suscribirse, recibir |
AWS MQTTLa entrega de archivos basada en archivos se publica en este tema si se acepta la solicitud «» de un dispositivo. DescribeStream La carga útil contiene la descripción del flujo. Para obtener más información, consulte Uso de la entrega de archivos AWS IoT basada en MQTT en los dispositivos. |
$aws/things/ /streams/ /describe/ |
Publish |
Un dispositivo publica en este tema para realizar una solicitud «». DescribeStream Para obtener más información, consulte Uso de la entrega de archivos AWS IoT basada en MQTT en los dispositivos. |
$aws/things/ /streams/ /rejected/ |
Suscribirse, recibir |
AWS MQTTLa entrega de archivos basada en archivos se publica en este tema si se rechaza una solicitud «» o «» de un dispositivo. DescribeStream GetStream Para obtener más información, consulte Uso de la entrega de archivos AWS IoT basada en MQTT en los dispositivos. |
Tema reservado ARN
Todos los temas reservados ARNs (Amazon Resource Names) tienen el siguiente formulario:
arn:aws:iot:
aws-region
:AWS-account-ID
:topic/Topic
Por ejemplo, arn:aws:iot:us-west-2:123EXAMPLE456:topic/$aws/things/thingName/jobs/get/accepted
es ARN para el tema reservado$aws/things/thingName/jobs/get/accepted
.