MQTTtemas - AWS IoT Core

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.

MQTTtemas

MQTTlos temas identifican AWS IoT los mensajes. AWS IoT los clientes identifican los mensajes que publican asignándoles nombres de temas. 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 MQTT y HTTP enviados medianteHTTPSmensaje URL.

Si bien AWS IoT admite algunos temas reservados del sistema, usted, el diseñador del sistema, crea y administra la mayoría de los MQTT temas. 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 su sistema, revise las características de los MQTT temas para crear la jerarquía de nombres de temas que mejor se adapte a su sistema de IoT.

Nombres de temas

Los nombres de los temas y los filtros de temas son UTF 8 cadenas codificadas. 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 $ son temas reservados que debe utilizar únicamente AWS IoT Core.

  • AWS IoT Core no puedo enviar ni recibir mensajes entre Cuenta de AWS s 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ñar temas para. MQTT AWS IoT Core

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 y AWS IoT SDK de dispositivo, SDK para dispositivos móviles y AWS IoT cliente de dispositivo.

importante

El espacio de nombres de los temas está limitado a una región y. Cuenta de AWS 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.

Tema ARN

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 una ARN para el tema application/topic/device/sensor.

Filtros de temas

Los clientes suscriptores registran filtros de temas con el agente de mensajes de para especificar los temas de mensajes que el agente de mensajes debe enviarles. Un filtro 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
# 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 +.

+ 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.

Filtro de tema ARN

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 filtro ARN para el tema application/topic/+/sensor.