Todos los productos
Search
Centro de documentos

IoT Platform:Habilitar, deshabilitar o eliminar un subdispositivo

Última actualización: Sep 03, 2026

Los dispositivos gateway pueden habilitar, deshabilitar o eliminar subdispositivos.

Deshabilitar un subdispositivo

A continuación se muestran los topics que se utilizan cuando IoT Platform envía solicitudes a un dispositivo y el dispositivo responde a IoT Platform:

  • Topic de solicitud:/sys/${productKey}/${deviceName}/thing/disable.

  • Topic de respuesta:/sys/${productKey}/${deviceName}/thing/disable_reply.

Un dispositivo gateway puede deshabilitar un subdispositivo mediante los topics anteriores. IoT Platform envía un mensaje al topic de solicitud de forma asíncrona para indicar al dispositivo gateway que deshabilite un subdispositivo. El subdispositivo se suscribe al topic de solicitud a través del dispositivo gateway y, de este modo, obtiene el mensaje del topic de solicitud.

Ejemplo de solicitud en formato JSON de Alink:

{
  "id": "123",
  "version": "1.0",
  "params": {},
  "method": "thing.disable"
}

Ejemplo de respuesta en formato JSON de Alink:

{
  "id": "123",
  "code": 200,
  "data": {}
}

La siguiente tabla describe los parámetros.

Parámetro

Tipo

Descripción

id

String

El ID del mensaje. Valores válidos: de 0 a 4294967295. Cada ID de mensaje debe ser único para el dispositivo.

version

String

La versión del protocolo. Valor válido: 1.0.

params

Object

Los parámetros de la solicitud. Puede dejar vacío el parámetro params.

method

String

El método de la solicitud. Valor válido: thing.disable.

code

Integer

El código de estado en la respuesta. Para más información, consulte General device-side codes.

Habilitar un subdispositivo deshabilitado

A continuación se muestran los topics que se utilizan cuando IoT Platform envía solicitudes a un dispositivo y el dispositivo responde a IoT Platform:

Importante
  • Después de que un subdispositivo gateway se conecta a IoT Platform mediante MQTT, debe suscribirse a los topics a través del dispositivo gateway para poder recibir mensajes. Si un subdispositivo está deshabilitado, se encuentra en estado sin conexión y no puede obtener mensajes de los topics a los que está suscrito. Un subdispositivo gateway deshabilitado no se puede habilitar con los siguientes topics. Para habilitarlo, modifique la relación topológica. Para más información sobre los topics, consulte Notify a gateway of a topology relationship change.

  • Cuando un dispositivo se conecta a IoT Platform mediante IoT as Bridge SDK, puede recibir mensajes descendentes sin necesidad de suscribirse a topics. Si un subdispositivo está deshabilitado, utilice los siguientes topics para habilitarlo:

  • Topic de solicitud:/sys/${productKey}/${deviceName}/thing/enable.

  • Topic de respuesta:/sys/${productKey}/${deviceName}/thing/enable_reply.

Un dispositivo gateway puede habilitar un subdispositivo deshabilitado mediante los topics anteriores. IoT Platform envía un mensaje al topic de solicitud de forma asíncrona para indicar al dispositivo gateway que habilite un subdispositivo. El subdispositivo se suscribe al topic de solicitud y obtiene el mensaje correspondiente.

Ejemplo de solicitud en formato JSON de Alink:

{
  "id": "123",
  "version": "1.0",
  "params": {},
  "method": "thing.enable"
}

Ejemplo de respuesta en formato JSON de Alink:

{
  "id": "123",
  "code": 200,
  "data": {}
}

Descripción de parámetros

Parámetro

Tipo

Descripción

id

String

El ID del mensaje. Valores válidos: de 0 a 4294967295. Cada ID de mensaje debe ser único para el dispositivo.

version

String

La versión del protocolo. Valor válido: 1.0.

params

Object

Los parámetros de la solicitud. Puede dejar vacío el parámetro params.

method

String

El método de la solicitud. Valor válido: thing.enable.

code

Integer

El código de estado en la respuesta. Para más información, consulte Common codes returned by devices.

Eliminar un subdispositivo

Importante

Un dispositivo gateway puede eliminar un subdispositivo conectado a IoT Platform. Para más información sobre los efectos que ocurren tras eliminar un subdispositivo, consulte

Delete a device

.

A continuación se muestran los topics que se utilizan cuando IoT Platform envía solicitudes a un dispositivo y el dispositivo responde a IoT Platform:

  • Topic de solicitud:/sys/${productKey}/${deviceName}/thing/delete.

  • Topic de respuesta:/sys/${productKey}/${deviceName}/thing/delete_reply.

Un dispositivo gateway puede eliminar un subdispositivo mediante los topics anteriores. IoT Platform envía un mensaje al topic de solicitud de forma asíncrona para indicar al dispositivo gateway que elimine un subdispositivo. El subdispositivo se suscribe al topic de solicitud a través del dispositivo gateway y, de este modo, obtiene el mensaje del topic de solicitud.

Ejemplo de solicitud en formato JSON de Alink:

{
  "id": "123",
  "version": "1.0",
  "params": {},
  "method": "thing.delete"
}

Ejemplo de respuesta en formato JSON de Alink:

{
  "id": "123",
  "code": 200,
  "data": {}
}

La siguiente tabla describe los parámetros.

Parámetro

Tipo

Descripción

id

String

El ID del mensaje. Valores válidos: de 0 a 4294967295. Cada ID de mensaje debe ser único para el dispositivo.

version

String

La versión del protocolo. Valor válido: 1.0.

params

Object

Los parámetros de la solicitud. Puede dejar vacío el parámetro params.

method

String

El método de la solicitud. Valor válido: thing.delete.

code

String

El código de estado en la respuesta. Para más información, consulte Common codes returned by devices.