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 de MQTT
Los temas de MQTT identifican los AWS IoT mensajes. AWS IoT los clientes identifican los mensajes que publican asignando nombres a los temas de los mensajes. Los clientes identifican los mensajes a los que desean suscribirse (recibir) registrando un filtro de temas con AWS IoT Core. El agente de mensajes de utiliza nombres y filtros de temas para dirigir los mensajes de los clientes de publicación a los clientes de suscripción.
El agente de mensajes utiliza los temas para identificar los mensajes enviados mediante MQTT y enviados mediante HTTP al [URL del mensaje HTTPS](http.md#httpurl).
Aunque AWS IoT admite algunos [temas de sistema reservados](reserved-topics.md), la mayoría de los temas de MQTT los crea y gestiona usted, el diseñador del sistema. AWS IoT utiliza los temas para identificar los mensajes recibidos de los clientes de publicación y seleccionar los mensajes que se van a enviar a los clientes suscritos, tal y como se describe en las siguientes secciones. Antes de crear un espacio de nombres de temas para el sistema, consulte las características de los temas de MQTT para crear la jerarquía de nombres de temas que funcione mejor con su sistema de IoT.
## Nombres de temas
Los nombres de los temas y los filtros de temas son cadenas codificadas por UTF-8. Pueden representar una jerarquía de información utilizando el carácter de barra diagonal (/) para separar los niveles de la jerarquía. Por ejemplo, este nombre de tema podría referirse a un sensor de temperatura en la sala 1:
+ `sensor/temperature/room1`
En este ejemplo, también puede haber otros tipos de sensores en otras salas con nombres de temas como:
+ `sensor/temperature/room2`
+ `sensor/humidity/room1`
+ `sensor/humidity/room2`
**nota**
Cuando considere los nombres de los temas para los mensajes de su sistema, tenga en cuenta:
Los nombres de temas y los filtros de temas distinguen entre mayúsculas y minúsculas.
Los nombres de los temas no deben contener información de identificación personal.
Los nombres de tema que comienzan por \$1 son [temas reservados](reserved-topics.md) que debe utilizar únicamente AWS IoT Core.
AWS IoT Core no puedo enviar ni recibir mensajes entre Cuenta de AWS nosotros o regiones.
Para obtener más información sobre cómo diseñar los nombres de los temas y el espacio de nombres, consulte nuestro documento técnico, [Diseño de temas 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 ver ejemplos de cómo las aplicaciones pueden publicar y suscribirse a mensajes, empiece por [Cómo empezar con AWS IoT Core los tutoriales](iot-gs.md) y [SDK de dispositivos, SDK para móviles y cliente de dispositivo de AWS IoT](iot-sdks.md).
**importante**
El espacio de nombres del tema está limitado a una región Cuenta de AWS y. Por ejemplo, el `sensor/temp/room1` tema utilizado por un usuario Cuenta de AWS de una región es distinto del `sensor/temp/room1` tema utilizado por la misma AWS cuenta en otra región o utilizado por cualquier otra cuenta Cuenta de AWS en cualquier región.
## ARN de tema
Todos los temas 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/application/topic/device/sensor` es un ARN del tema ` application/topic/device/sensor`.
## Filtros de nombres de temas
Los clientes suscriptores registran filtros de nombres de temas con el agente de mensajes para especificar los temas de mensajes que el agente de mensajes debe enviarles. Un filtro de nombre de tema puede ser un único nombre de tema para suscribirse a un único nombre de tema o puede incluir caracteres comodín para suscribirse a varios nombres de tema a la vez.
Los clientes de publicación no pueden utilizar caracteres comodín en los nombres de tema que publican.
En la tabla siguiente se enumeran los caracteres comodín que se pueden utilizar en un filtro de temas.
**Comodines de tema**
| Carácter comodín | Coincide | Notas |
| --- | --- | --- |
| \$1 | Todas las cadenas en y por debajo de su nivel en la jerarquía de temas. | Debe ser el último carácter del filtro de temas. Debe ser el único carácter en su nivel de jerarquía de temas. Se puede utilizar en un filtro de temas que también contiene el carácter comodín \$1. |
| \$1 | Cualquier cadena en el nivel que contiene el carácter. | Debe ser el único carácter en su nivel de jerarquía de temas. Se puede utilizar en varios niveles de un filtro de tema. |
Uso de comodines con los ejemplos de nombres de tema de sensor anteriores:
+ Una suscripción a `sensor/#` recibe los mensajes publicados en `sensor/`, `sensor/temperature` y `sensor/temperature/room1`, pero no los mensajes publicados en `sensor`.
+ Una suscripción a `sensor/+/room1` recibe mensajes publicados en `sensor/temperature/room1` y `sensor/humidity/room1`, pero no mensajes enviados a `sensor/temperature/room2` o `sensor/humidity/room2`.
### ARN de filtro de temas
Todos los filtros de temas ARNs (Amazon Resource Names) tienen el siguiente formulario:
```
arn:aws:iot:aws-region:AWS-account-ID:topicfilter/TopicFilter
```
Por ejemplo, `arn:aws:iot:us-west-2:123EXAMPLE456:topicfilter/application/topic/+/sensor` es un ARN del filtro de tema ` application/topic/+/sensor`.
# Carga de mensajes MQTT
La carga útil de mensajes que se envía en tus mensajes MQTT no viene especificada por AWS IoT, a menos que sea para uno de los. [Temas reservados](reserved-topics.md) Para adaptarse a las necesidades de su aplicación, le recomendamos que defina la carga de mensajes para sus temas dentro de las restricciones de [AWS IoT Core Service Quotas para Protocolos](https://docs.aws.amazon.com/general/latest/gr/iot-core.html#iot-protocol-limits).
El uso de un formato JSON para la carga útil de los mensajes permite al motor de AWS IoT reglas analizar los mensajes y aplicarles consultas SQL. Si su aplicación no requiere que el motor de reglas aplique consultas SQL a las cargas útiles de sus mensajes, puede utilizar cualquier formato de datos que requiera su aplicación. Para obtener información sobre las limitaciones y los caracteres reservados de un documento JSON utilizado en las consultas SQL, consulte [Extensiones JSON](iot-sql-json.md).
Para obtener más información sobre el diseño de los temas de MQTT y sus correspondientes cargas de mensajes, consulte [Diseño de temas de MQTT](https://docs.aws.amazon.com/whitepapers/latest/designing-mqtt-topics-aws-iot-core/designing-mqtt-topics-aws-iot-core.html) para AWS IoT Core.
Si el límite de tamaño de un mensaje supera las cuotas de servicio, se producirá un `CLIENT_ERROR` con motivo `PAYLOAD_LIMIT_EXCEEDED` y “La carga útil del mensaje supera el límite de tamaño para el tipo de mensaje.” Para obtener más información sobre el límite de tamaño de los mensajes, consulte [Límites y cuotas del agente de mensajes AWS IoT Core](https://docs.aws.amazon.com//general/latest/gr/iot-core.html#message-broker-limits.html).
# Temas reservados
Los temas que comienzan con un signo de dólar (\$1) 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
| Topic | Operaciones de cliente permitidas | Description (Descripción) |
| --- | --- | --- |
| \$1 aws/sitewise/asset *assetModelId* -models/ /assets/ /properties/ *assetId* *propertyId* | 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](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/interact-with-other-services.html) 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 (CBOR) y en notación de JavaScript objetos (JSON), según el *payload-format* tema. AWS IoT Device Defender los temas solo admiten la publicación en MQTT.
| *payload-format* | Tipo de datos de formato de respuesta |
| --- | --- |
| cbor | Concise Binary Object Representation (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](https://docs.aws.amazon.com/iot-device-defender/latest/devguide/detect-device-side-metrics.html#DetectMetricsMessages).
| Topic | Operaciones permitidas | Description (Descripción) |
| --- | --- | --- |
| \$1aws/things/ /defender/metrics/ *thingName* *payload-format* | 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](https://docs.aws.amazon.com/iot-device-defender/latest/devguide/detect-device-side-metrics.html#DetectMetricsMessages). |
| \$1aws/things/ /defender/metrics/ /accepted *thingName* *payload-format* | Suscribirse | AWS IoT publica en este tema después de que un agente publique correctamente un mensaje en \$1aws/things/ /defender/metrics/. AWS IoT Device Defender *thingName* *payload-format* Para obtener más información, consulte [Envío de métricas desde dispositivos](https://docs.aws.amazon.com/iot-device-defender/latest/devguide/detect-device-side-metrics.html#DetectMetricsMessages). |
| \$1aws/things/ /defender/metrics/ /rejected *thingName* *payload-format* | Suscribirse | AWS IoT publica en este tema después de que un agente publique un mensaje fallido en \$1aws/things/ /defender/metrics/. AWS IoT Device Defender *thingName* *payload-format* Para obtener más información, consulte [Envío de métricas desde dispositivos](https://docs.aws.amazon.com/iot-device-defender/latest/devguide/detect-device-side-metrics.html#DetectMetricsMessages). |
## 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 el GNSS, la conexión Wi-Fi, 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 Ubicación del dispositivo](device-location.md) y [Resolución de la ubicación del dispositivo mediante los temas de ubicación del AWS IoT Core dispositivo (MQTT)](device-location-reserved-topics.md).
| Topic | Operaciones permitidas | Description (Descripción) |
| --- | --- | --- |
| \$1aws/device\$1location/ /get\$1position\$1estimate *customer\$1device\$1id* | 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 |
| \$1aws/device\$1location/ /get\$1position\$1estimate/accepted *customer\$1device\$1id* | Suscribirse | AWS IoT Core Device Location publica este tema después de haber resuelto correctamente la ubicación del dispositivo. |
| \$1aws/device\$1location/ /get\$1position\$1estimate/rejected *customer\$1device\$1id* | 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. En la tabla se muestran los distintos AWS IoT eventos y sus temas reservados.
| Topic | Operaciones de cliente permitidas | Description (Descripción) |
| --- | --- | --- |
| \$1aws/events/certificates/registered/*caCertificateId* | Suscribirse | AWS IoT publica este mensaje cuando registra AWS IoT automáticamente un certificado y cuando un cliente presenta un certificado con el `PENDING_ACTIVATION` estado. Para obtener más información, consulte [Configurar la primera conexión de un cliente para el registro automático](auto-register-device-cert.md#configure-auto-reg-first-connect). |
| \$1aws/events/job/*jobID*/cancelado | Suscribirse | AWS IoT publica este mensaje cuando se cancela un trabajo. Para obtener más información, consulte [Eventos de trabajos](events-jobs.md). |
| \$1aws/events/job/jobID/cancellation\$1in\$1progress | 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](events-jobs.md). |
| \$1aws/events/job/*jobID*/completado | Suscribirse | AWS IoT publica este mensaje cuando se ha completado un trabajo. Para obtener más información, consulte [Eventos de trabajos](events-jobs.md). |
| \$1aws/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](events-jobs.md). |
| \$1aws/events/job/jobID/deletion\$1in\$1progress | Suscribirse | AWS IoT publica este mensaje cuando se está eliminando un trabajo. Para obtener más información, consulte [Eventos de trabajos](events-jobs.md). |
| \$1aws/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](events-jobs.md). |
| \$1aws/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](events-jobs.md). |
| \$1aws/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](events-jobs.md). |
| \$1aws/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](events-jobs.md). |
| \$1aws/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](events-jobs.md). |
| \$1aws/events/jobExecution/jobID/succeeded | 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](events-jobs.md). |
| \$1aws/events/jobExecution/jobID/timed\$1out | 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](events-jobs.md). |
| \$1aws/events/presence/connected/*clientId* | Suscribirse | AWS IoT publica este tema cuando se conecta un cliente MQTT con el ID de cliente especificado. AWS IoT Para obtener más información, consulte [Eventos de conexión/desconexión](life-cycle-events.md#connect-disconnect). |
| \$1aws/events/presence/disconnected/*clientId* | Suscribirse | AWS IoT publica este tema cuando un cliente MQTT con el ID de cliente especificado se desconecta a. AWS IoT Para obtener más información, consulte [Eventos de conexión/desconexión](life-cycle-events.md#connect-disconnect). |
| \$1aws/events/subscriptions/subscribed/*clientId* | Suscribirse | AWS IoT publica en este tema cuando un cliente de MQTT con el ID de cliente especificado se suscribe a un tema de MQTT. Para obtener más información, consulte [Eventos de suscripción/cancelación de suscripción](life-cycle-events.md#subscribe-unsubscribe-events). |
| \$1aws/events/subscriptions/unsubscribed/*clientId* | Suscribirse | AWS IoT publica en este tema cuando un cliente de MQTT con el ID de cliente especificado cancela su suscripción a un tema de MQTT. Para obtener más información, consulte [Eventos de suscripción/cancelación de suscripción](life-cycle-events.md#subscribe-unsubscribe-events). |
| \$1//created aws/events/thing *thingName* | Suscribirse | AWS IoT publica en este tema cuando se crea la *thingName* cosa. Para obtener más información, consulte [Eventos de registro](registry-events.md). |
| \$1aws/events/thing/*thingName*/updated | Suscribirse | AWS IoT publica en este tema cuando *thingName* se actualiza. Para obtener más información, consulte [Eventos de registro](registry-events.md). |
| \$1aws/events/thing/*thingName*/eliminado | Suscribirse | AWS IoT publica en este tema cuando se elimina la *thingName* cosa. Para obtener más información, consulte [Eventos de registro](registry-events.md). |
| \$1aws/events/thingGroup/*thingGroupName*/created | Suscribirse | AWS IoT publica en este tema cuando *thingGroupName* se crea el grupo de cosas. Para obtener más información, consulte [Eventos de registro](registry-events.md). |
| \$1aws/events/thingGroup/*thingGroupName*/updated | Suscribirse | AWS IoT publica en este tema cuando se *thingGroupName* actualiza el grupo de cosas. Para obtener más información, consulte [Eventos de registro](registry-events.md). |
| \$1aws/events/thingGroup/*thingGroupName*/eliminado | Suscribirse | AWS IoT publica en este tema cuando *thingGroupName* se elimina un grupo de cosas. Para obtener más información, consulte [Eventos de registro](registry-events.md). |
| \$1aws/events/thingType/*thingTypeName*/created | Suscribirse | AWS IoT publica en este tema cuando se crea el tipo de *thingTypeName* cosa. Para obtener más información, consulte [Eventos de registro](registry-events.md). |
| \$1aws/events/thingType/*thingTypeName*/updated | Suscribirse | AWS IoT publica en este tema cuando se actualiza el tipo de *thingTypeName* cosa. Para obtener más información, consulte [Eventos de registro](registry-events.md). |
| \$1aws/events/thingType/*thingTypeName*/eliminado | Suscribirse | AWS IoT publica en este tema cuando se elimina el tipo de *thingTypeName* cosa. Para obtener más información, consulte [Eventos de registro](registry-events.md). |
| \$1aws/events/thingTypeAssociation/thing/*thingName*/*thingTypeName* | Suscribirse | AWS IoT publica en este tema cuando algo *thingName* está asociado o disociado de un tipo *thingTypeName* de cosa. Para obtener más información, consulte [Eventos de registro](registry-events.md). |
| \$1aws/events/thingGroupMembership/thingGroup//thing/ *thingGroupName* /added *thingName* | Suscribirse | AWS IoT publica en este tema cuando *thingName* se agrega algo al grupo de cosas. *thingGroupName* Para obtener más información, consulte [Eventos de registro](registry-events.md). |
| \$1aws/events/thingGroupMembership/thingGroup/*thingGroupName*/thing/ /removed *thingName* | Suscribirse | AWS IoT publica en este tema cuando *thingName* se elimina algo del grupo de cosas. *thingGroupName* Para obtener más información, consulte [Eventos de registro](registry-events.md). |
| \$1aws/events/thingGroupHierarchy/thingGroup//*parentThingGroupName*childThingGroup/*childThingGroupName*/agregado | Suscribirse | AWS IoT publica en este tema cuando *childThingGroupName* se agrega un grupo de cosas al grupo *parentThingGroupName* de cosas. Para obtener más información, consulte [Eventos de registro](registry-events.md). |
| \$1aws/events/thingGroupHierarchy/thingGroup/*parentThingGroupName*childThingGroup/*childThingGroupName*/eliminado | Suscribirse | AWS IoT publica en este tema cuando *childThingGroupName* se elimina un grupo de cosas del grupo *parentThingGroupName* de cosas. Para obtener más información, consulte [Eventos de registro](registry-events.md). |
## 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 en notación *payload-format* de JavaScript objetos (JSON), según el tema.
| *payload-format* | Tipo de datos de formato de respuesta |
| --- | --- |
| cbor | Concise Binary Object Representation (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](fleet-provision-api.md).
| Topic | Operaciones de cliente permitidas | Description (Descripción) |
| --- | --- | --- |
| \$1aws/certificates/create/*payload-format* | Publish | Publique en este tema para crear un certificado a partir de una solicitud de firma de certificado (CSR). |
| \$1aws/certificates/create/*payload-format*/aceptado | Suscribirse, recibir | AWS IoT publica en este tema tras una llamada exitosa a \$1aws/certificates/create/*payload-format*. |
| \$1aws/certificates/create/*payload-format*/rechazado | Suscribirse, recibir | AWS IoT publica en este tema después de una llamada fallida a \$1aws/certificates/create/*payload-format*. |
| \$1 aws/certificates/create -from-csr/ *payload-format* | Publish | Publica en este tema para crear un certificado a partir de una CSR. |
| \$1 aws/certificates/create -from-csr/ /aceptado *payload-format* | Suscribirse, recibir | AWS IoT publica en este tema una llamada exitosa a \$1 -from-csr/. aws/certificates/create *payload-format* |
| \$1 -from-csr/ /rejected aws/certificates/create *payload-format* | Suscribirse, recibir | AWS IoT publica en este tema una llamada fallida a \$1 -from-csr/. aws/certificates/create *payload-format* |
| *templateName*\$1aws/provisioning-templates/ /provision/ *payload-format* | Publish | Publique en este tema para registrar un objeto. |
| \$1aws/provisioning-templates/ /provision/ *templateName* /accepted *payload-format* | Suscribirse, recibir | AWS IoT publica en este tema tras una llamada exitosa a \$1aws/provisioning-templates/ /provision/. *templateName* *payload-format* |
| \$1aws/provisioning-templates/ /provision/ /rejected *templateName* *payload-format* | Suscribirse, recibir | AWS IoT publica en este tema tras una llamada fallida a \$1aws/provisioning-templates/ /provision/. *templateName* *payload-format* |
## 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](iot-events.md) para recibir cualquier evento en la nube.
Para obtener más información, consulte [Operaciones de la API MQTT de dispositivos de Jobs](jobs-mqtt-api.md).
| Topic | Operaciones de cliente permitidas | Description (Descripción) |
| --- | --- | --- |
| \$1aws/things/ /jobs/get *thingName* | Publish | Los dispositivos publican un mensaje en este tema para realizar una solicitud `GetPendingJobExecutions`. Para obtener más información, consulte [Operaciones de la API MQTT de dispositivos de Jobs](jobs-mqtt-api.md). |
| *thingName*\$1aws/cosas//jobs/get/accepted | Suscribirse, recibir | Los dispositivos se suscriben a este tema para recibir respuestas correctas de una solicitud `GetPendingJobExecutions`. Para obtener más información, consulte [Operaciones de la API MQTT de dispositivos de Jobs](jobs-mqtt-api.md). |
| *thingName*\$1aws/cosas//jobs/get/rejected | Suscribirse, recibir | Los dispositivos se suscriben a este tema para recibir una respuesta cuando se rechaza una solicitud `GetPendingJobExecutions`. Para obtener más información, consulte [Operaciones de la API MQTT de dispositivos de Jobs](jobs-mqtt-api.md). |
| \$1aws/things/ /jobs/start-next *thingName* | Publish | Los dispositivos publican un mensaje en este tema para realizar una solicitud `StartNextPendingJobExecution`. Para obtener más información, consulte [Operaciones de la API MQTT de dispositivos de Jobs](jobs-mqtt-api.md). |
| *thingName*\$1aws/cosas//jobs/start-next/accepted | Suscribirse, recibir | Los dispositivos se suscriben a este tema para recibir respuestas correctas a una solicitud `StartNextPendingJobExecution`. Para obtener más información, consulte [Operaciones de la API MQTT de dispositivos de Jobs](jobs-mqtt-api.md). |
| *thingName*\$1aws/cosas//jobs/start-next/rejected | Suscribirse, recibir | Los dispositivos se suscriben a este tema para recibir una respuesta cuando se rechaza una solicitud `StartNextPendingJobExecution`. Para obtener más información, consulte [Operaciones de la API MQTT de dispositivos de Jobs](jobs-mqtt-api.md). |
| \$1aws/cosas/ /jobs/ /get *thingName* *jobId* | Publish | Los dispositivos publican un mensaje en este tema para realizar una solicitud `DescribeJobExecution`. Para obtener más información, consulte [Operaciones de la API MQTT de dispositivos de Jobs](jobs-mqtt-api.md). |
| \$1aws/things/ /jobs/ *thingName* /get/accepted *jobId* | Suscribirse, recibir | Los dispositivos se suscriben a este tema para recibir respuestas correctas a una solicitud `DescribeJobExecution`. Para obtener más información, consulte [Operaciones de la API MQTT de dispositivos de Jobs](jobs-mqtt-api.md). |
| \$1aws/things/ /jobs/ *thingName* /get/rejected *jobId* | Suscribirse, recibir | Los dispositivos se suscriben a este tema para recibir una respuesta cuando se rechaza una solicitud `DescribeJobExecution`. Para obtener más información, consulte [Operaciones de la API MQTT de dispositivos de Jobs](jobs-mqtt-api.md). |
| \$1aws/things/ /jobs/ *thingName* /update *jobId* | Publish | Los dispositivos publican un mensaje en este tema para realizar una solicitud `UpdateJobExecution`. Para obtener más información, consulte [Operaciones de la API MQTT de dispositivos de Jobs](jobs-mqtt-api.md). |
| \$1aws/things/ /jobs/ *thingName* /update/accepted *jobId* | Suscribirse, recibir | Los dispositivos se suscriben a este tema para recibir respuestas correctas a una solicitud `UpdateJobExecution`. Para obtener más información, consulte [Operaciones de la API MQTT de dispositivos de Jobs](jobs-mqtt-api.md). Nota Solo el dispositivo que publica en \$1aws/things/ /jobs/ /update recibe mensajes sobre este tema. *thingName* *jobId* |
| \$1aws/things/ /jobs/ /update/rejected *thingName* *jobId* | Suscribirse, recibir | Los dispositivos se suscriben a este tema para recibir una respuesta cuando se rechaza una solicitud `UpdateJobExecution`. Para obtener más información, consulte [Operaciones de la API MQTT de dispositivos de Jobs](jobs-mqtt-api.md). Nota Solo el dispositivo que publica en \$1aws/things/ /jobs/ /update recibe mensajes sobre este tema. *thingName* *jobId* |
| \$1aws/things/ /jobs/notify *thingName* | 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 [Operaciones de la API MQTT de dispositivos de Jobs](jobs-mqtt-api.md). |
| \$1aws/things/ /jobs/notify-next *thingName* | 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 [Operaciones de la API MQTT de dispositivos de Jobs](jobs-mqtt-api.md). |
| \$1/aws/events/job/completado *jobId* | 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](events-jobs.md). |
| \$1aws/events/job//cancelado *jobId* | 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](events-jobs.md). |
| \$1aws/events/job//eliminado *jobId* | 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](events-jobs.md). |
| \$1aws/events/job/*jobId*/cancelación\$1en curso | 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](events-jobs.md). |
| \$1aws/events/job/*jobId*/eliminación\$1en curso | 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](events-jobs.md). |
| \$1 aws/events/jobExecution*jobId*//conseguido | 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](events-jobs.md). |
| \$1aws/events/jobExecution//falló *jobId* | 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](events-jobs.md). |
| \$1aws/events/jobExecution//rechazado *jobId* | 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](events-jobs.md). |
| \$1aws/events/jobExecution//cancelado *jobId* | 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](events-jobs.md). |
| \$1aws/events/jobExecution//timed\$1out *jobId* | 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](events-jobs.md). |
| \$1 aws/events/jobExecution*jobId*//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](events-jobs.md). |
| \$1aws/events/jobExecution//eliminado *jobId* | 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](events-jobs.md). |
## 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.
| Topic | Operaciones de cliente permitidas | Description (Descripción) |
| --- | --- | --- |
| \$1aws/commands///executions/ /request/ ** ** ** ** \$1aws/commands//****/executions/ /request ** | 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 la API `StartCommandExecution`. En este caso, ** pueden ser cosas de IoT o clientes MQTT, y ** pueden ser el nombre de la cosa IoT o el ID de cliente MQTT. |
| \$1aws/commands/ //executions/ /response/ ** ** ** ** | Publish | Los dispositivos utilizan la API de MQTT `UpdateCommandExecution` para publicar un mensaje en este tema sobre la ejecución de comandos. El mensaje se publica como respuesta a la solicitud de iniciar la ejecución de un comando desde la consola o mediante la API `StartCommandExecution`. El mensaje publicado utilizará JSON o CBOR como. ** |
| \$1aws/commands///executions/ /response/accepted/ ** ** ** ** \$1aws/commands//****/executions/ /response/accepted ** | Suscribirse, recibir | Si el servicio en la nube procesó correctamente el resultado de la ejecución del comando, AWS IoT Device Management publicará una respuesta en el tema /accepted. |
| \$1aws/commands//****/executions/ ** /response/rechected/ ** \$1aws/commands//****/executions/ /response/rejected ** | Publish | Si el servicio en la nube no pudo procesar el resultado de la ejecución del comando, AWS IoT Device Management publicará una respuesta en el tema /rejected. |
## Temas de reglas
| Topic | Operaciones de cliente permitidas | Description (Descripción) |
| --- | --- | --- |
| \$1aws/rules/ *ruleName* | 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](iot-basic-ingest.md). |
## Temas de tunelización segura
| Topic | Operaciones de cliente permitidas | Description (Descripción) |
| --- | --- | --- |
| \$1aws/things/ /tunnels/notify *thing-name* | 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](configure-remote-device.md#agent-snippet). |
## 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 |
| --- | --- |
| \$1aws/things/ /shadow thingName | Sombra sin nombre (clásica) |
| thingName\$1aws/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.
| Topic | Operaciones de cliente permitidas | Description (Descripción) |
| --- | --- | --- |
| *ShadowTopicPrefix*/eliminar | Publicar/suscribirse | Un dispositivo o una aplicación publica en este tema para eliminar una sombra. Para obtener más información, consulte [/delete](device-shadow-mqtt.md#delete-pub-sub-topic). |
| *ShadowTopicPrefix*/eliminar/aceptado | 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](device-shadow-mqtt.md#delete-accepted-pub-sub-topic). |
| *ShadowTopicPrefix*/eliminar/rechazado | 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](device-shadow-mqtt.md#delete-rejected-pub-sub-topic). |
| *ShadowTopicPrefix*/get | 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 [Temas MQTT de sombra de dispositivo](device-shadow-mqtt.md). |
| *ShadowTopicPrefix*/get/accepted | 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](device-shadow-mqtt.md#get-accepted-pub-sub-topic). |
| *ShadowTopicPrefix*/get/rejected | 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](device-shadow-mqtt.md#get-rejected-pub-sub-topic). |
| *ShadowTopicPrefix*/actualizar | Publicar/suscribirse | Un objeto o una aplicación publica en este tema para actualizar una sombra. Para obtener más información, consulte [/update](device-shadow-mqtt.md#update-pub-sub-topic). |
| *ShadowTopicPrefix*/update/aceptado | 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](device-shadow-mqtt.md#update-accepted-pub-sub-topic). |
| *ShadowTopicPrefix*/update/rechazado | 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](device-shadow-mqtt.md#update-rejected-pub-sub-topic). |
| *ShadowTopicPrefix*/update/delta | 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](device-shadow-mqtt.md#update-delta-pub-sub-topic). |
| *ShadowTopicPrefix*/update/documents | 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](device-shadow-mqtt.md#update-documents-pub-sub-topic). |
## Temas relacionados con la entrega de archivos basada en MQTT
**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 en notación *payload-format* de JavaScript objetos (JSON), según el tema.
| *payload-format* | Tipo de datos de formato de respuesta |
| --- | --- |
| cbor | Concise Binary Object Representation (Representación concisa de objetos binarios, CBOR) |
| json | JavaScript Notación de objetos (JSON) |
| Topic | Operaciones de cliente permitidas | Description (Descripción) |
| --- | --- | --- |
| \$1aws/things/ /streams/ /data/ *ThingName* *StreamId* *payload-format* | Suscribirse, recibir | AWS La entrega de archivos basada en MQTT 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 dispositivos](mqtt-based-file-delivery-in-devices.md). |
| \$1aws/things/ /streams/ /get/ *ThingName* *StreamId* *payload-format* | 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 dispositivos](mqtt-based-file-delivery-in-devices.md). |
| \$1aws/things/ /streams/ /description/ *ThingName* *StreamId* *payload-format* | Suscribirse, recibir | AWS La entrega de archivos basada en MQTT 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 dispositivos](mqtt-based-file-delivery-in-devices.md). |
| \$1aws/things/ /streams/ /describe/ *ThingName* *StreamId* *payload-format* | 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 dispositivos](mqtt-based-file-delivery-in-devices.md). |
| \$1aws/things/ /streams/ /rejected/ *ThingName* *StreamId* *payload-format* | Suscribirse, recibir | AWS La entrega de archivos basada en MQTT 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 dispositivos](mqtt-based-file-delivery-in-devices.md). |
## Temas reservados
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 un ARN del tema reservado `$aws/things/thingName/jobs/get/accepted`.