Asigne etiquetas personalizadas a productos, dispositivos y grupos para categorizar recursos con características compartidas. Las etiquetas simplifican la búsqueda, agregación y gestión de recursos de IoT a gran escala.
Notas de uso
|
Etiqueta |
Descripción |
|
etiqueta de producto |
Describe los atributos compartidos por todos los dispositivos bajo el mismo producto. Por ejemplo, puede usar etiquetas para identificar al fabricante del producto, la organización, las dimensiones físicas o el sistema operativo. |
|
etiqueta de dispositivo |
Identifica un dispositivo por una característica específica, lo que permite categorizar, agregar y analizar dispositivos para una gestión unificada. Por ejemplo, puede asignar la etiqueta room:201 a un medidor inteligente en la Sala 201. |
|
etiqueta de grupo |
Describe los atributos compartidos por dispositivos y subgrupos dentro de un grupo, lo que habilita la gestión de dispositivos entre productos. Por ejemplo, puede etiquetar la región o el espacio donde se ubican los dispositivos de un grupo. |
Casos de uso
Realizar operaciones masivas mediante etiquetas
|
Etiqueta |
Ejemplo de operación |
|
etiqueta de producto |
Encuentre productos que comparten atributos comunes dentro de una instancia de IoT Platform según sus etiquetas. |
|
etiqueta de dispositivo |
Después de buscar los dispositivos objetivo según sus etiquetas, puede realizar las siguientes operaciones masivas:
|
|
etiqueta de grupo |
Encuentre grupos y subgrupos que comparten atributos comunes dentro de una instancia de IoT Platform según sus etiquetas. |
Gestionar etiquetas desde los dispositivos
Una vez implementada la gestión de etiquetas en sus dispositivos, estos pueden realizar las siguientes operaciones:
Reportar etiquetas: Cuando un dispositivo reporta sus etiquetas, IoT Platform agrega o actualiza automáticamente las etiquetas correspondientes del dispositivo en la consola.
Eliminar etiquetas: Un dispositivo envía una solicitud para eliminar sus etiquetas e IoT Platform las quita al recibirla.
Consultar etiquetas: Un dispositivo envía una solicitud para consultar sus etiquetas e IoT Platform devuelve la información solicitada al recibirla.
El Link SDK multilingüe para dispositivos de IoT Platform integra la función de etiquetado y transmite la información de las etiquetas dentro del sistema. Para ver ejemplos de código del Link SDK para dispositivos, consulte Device tags for device development. Para conocer los temas y formatos de datos utilizados en la gestión de etiquetas, consulte Alink protocol for device tags.
Reenviar información sobre cambios de etiquetas
Mediante el reenvío de mensajes, IoT Platform envía notificaciones sobre operaciones de etiquetas de dispositivos (agregar, actualizar, eliminar y borrar) a su servidor de aplicaciones u otros servicios de Alibaba Cloud. Para más información sobre cómo configurar el reenvío de mensajes, consulte Message forwarding. Para conocer el formato de los datos reenviados, consulte Device tag changes.
Requisitos previos
Ha iniciado sesión en la consola de IoT Platform.
-
Antes de agregar etiquetas, cree el producto, dispositivo o grupo correspondiente. Para más información, consulte los siguientes temas:
Contexto
La gestión de numerosos dispositivos de IoT suele requerir diferenciarlos y procesarlos en lotes. IoT Platform resuelve esto mediante su función de etiquetado. Asigne etiquetas a productos, dispositivos y grupos, y luego categorícelos y gestióneles según dichas etiquetas.
Límites
Las etiquetas de productos, dispositivos y grupos son pares clave-valor con el formato
Key:Value.La clave de etiqueta abc está reservada por IoT Platform. No establezca una
Keyde etiqueta como abc. Si configuraKey=abc, la etiqueta se filtrará automáticamente durante las búsquedas basadas en etiquetas.-
Las claves de etiqueta no distinguen entre mayúsculas y minúsculas. Sin embargo, IoT Platform y los datos reenviados mediante la función de reenvío de mensajes siempre utilizan el formato original de la
keyde la etiqueta.Incluso si elimina una etiqueta y luego la vuelve a agregar cambiando solo el uso de mayúsculas/minúsculas, la
keyen los datos reenviados conserva el formato original.Por ejemplo, si crea una etiqueta
ssid:1000y posteriormente la actualiza usandoSsid:1001, elValuese actualiza correctamente a 1001, pero los datos reenviados por el sistema seguirán usandossid:1001. Cada producto, dispositivo o grupo puede tener un máximo de 100 etiquetas.
Editar etiquetas en la consola
Editar etiquetas de producto
En la página Overview, localice la instancia que desea gestionar y haga clic en el ID o nombre de la instancia.
En la barra de navegación izquierda, seleccione .
-
En la página Products, localice el producto que desea etiquetar y haga clic en View en la columna Actions correspondiente.
La sección Tag Information muestra todas las etiquetas del producto.
Haga clic en Edit a la derecha de Tag Information.
-
En el cuadro de diálogo Edit Tag, introduzca la Tag Key y el Tag Value.
Haga clic en Delete para quitar una etiqueta existente, o haga clic en + Add Tag para agregar una nueva.
Parámetro
Descripción
tag key
Debe tener entre 1 y 30 caracteres de longitud y puede contener letras, dígitos y puntos (.).
tag value
Debe tener hasta 128 caracteres de longitud y puede contener caracteres chinos, caracteres japoneses, letras, dígitos, guiones bajos (_), guiones (-), dos puntos (:) y puntos (.). Cada carácter chino o japonés cuenta como dos caracteres.
(Opcional) Haga clic en Add Tag para agregar más etiquetas, o haga clic en Delete para quitar las etiquetas no deseadas.
Haga clic en Confirm.
Editar etiquetas de dispositivo
En la barra de navegación izquierda de la instancia objetivo, seleccione .
-
En la página Device, haga clic en View para el dispositivo que desea etiquetar.
La sección Tag Information muestra todas las etiquetas del dispositivo.
En la página Device Details, haga clic en Edit a la derecha de Tag Information.
-
En el cuadro de diálogo Edit Tag, haga clic en Add Tag e introduzca la tag key y el tag value.
Parámetro
Descripción
tag key
Debe tener entre 1 y 30 caracteres de longitud y puede contener letras, dígitos, barras diagonales (/), guiones bajos (_), guiones (-), signos de número (#), arrobas (@), signos de porcentaje (%), ampersands (&), asteriscos (*) y puntos (.).
tag value
Debe tener hasta 128 caracteres de longitud y puede contener caracteres chinos, caracteres japoneses, letras, dígitos, guiones bajos (_), guiones (-), signos de número (#), arrobas (@), signos de porcentaje (%), ampersands (&), dos puntos (:) y puntos (.). Cada carácter chino o japonés cuenta como dos caracteres.
(Opcional) Haga clic en Add Tag para agregar más etiquetas, o haga clic en Delete para quitar las etiquetas no deseadas.
Haga clic en Confirm.
Editar etiquetas de grupo
En la barra de navegación izquierda de la instancia objetivo, seleccione .
-
En la página Groups, localice el grupo al que desea agregar etiquetas y haga clic en View en la columna Actions correspondiente.
La sección Group Tags muestra todas las etiquetas del grupo.
Haga clic en Edit a la derecha de Tag Information.
-
En el cuadro de diálogo Edit Tag, introduzca la Tag Key y el Tag Value.
Haga clic en Delete para quitar una etiqueta existente, o haga clic en + Add Tag para agregar una nueva.
Parámetro
Descripción
tag key
Debe tener entre 1 y 30 caracteres de longitud y puede contener letras, dígitos y puntos (.).
tag value
Debe tener hasta 128 caracteres de longitud y puede contener caracteres chinos, caracteres japoneses, letras, dígitos, guiones bajos (_), guiones (-), dos puntos (:) y puntos (.). Cada carácter chino o japonés cuenta como dos caracteres.
(Opcional) Haga clic en Add Tag para agregar más etiquetas, o haga clic en Delete para quitar las etiquetas no deseadas.
Haga clic en OK.
Gestionar etiquetas con API del lado del servidor
IoT Platform proporciona API del lado del servidor para gestionar etiquetas en lotes y consultar productos, dispositivos y grupos según sus etiquetas.
Etiquetas de producto
|
Función |
API |
Descripción |
|
Editar etiquetas |
Crea etiquetas de producto. |
|
|
Actualiza etiquetas de producto. |
||
|
Elimina etiquetas de producto. |
||
|
Consultar etiquetas |
Consulta todas las etiquetas de un producto. |
|
|
Usar etiquetas |
Consulta productos por etiqueta. |
Etiquetas de dispositivo
|
Función |
API |
Descripción |
|
Editar etiquetas |
Establece etiquetas de dispositivo. |
|
|
Elimina etiquetas de dispositivo. |
||
|
Consultar etiquetas |
Consulta la lista de etiquetas de un dispositivo específico. |
|
|
Usar etiquetas |
Consulta dispositivos por etiqueta. |
Etiquetas de grupo
|
Función |
API |
Descripción |
|
Editar etiquetas |
Agrega, actualiza o elimina etiquetas de grupo. |
|
|
Consultar etiquetas |
Consulta la lista de etiquetas de un grupo. |
|
|
Usar etiquetas |
Consulta grupos de dispositivos por etiqueta. |