Todos los productos
Search
Centro de documentos

IoT Platform:RemoveThingTopo

Última actualización: Sep 04, 2026

Elimina la relación topológica entre una puerta de enlace especificada y sus subdispositivos, o entre un subdispositivo y su puerta de enlace asociada.

Notas de uso

  • Si especifica una puerta de enlace, se eliminan las relaciones topológicas entre dicha puerta de enlace y todos los subdispositivos conectados.

  • Si especifica un subdispositivo, se elimina la relación topológica entre el subdispositivo y su puerta de enlace asociada.

Límites de QPS

Cada cuenta de Alibaba Cloud admite hasta 500 QPS.

Nota

Los usuarios de RAM comparten la cuota de la cuenta de Alibaba Cloud.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Se recomienda llamar a esta operación en OpenAPI Explorer, ya que genera dinámicamente código de ejemplo para diferentes SDK.

Parámetros de solicitud

Parámetro Tipo Obligatorio Ejemplo Descripción
Action String Sí RemoveThingTopo

La operación que se va a ejecutar. Establezca el valor en RemoveThingTopo.

IotInstanceId String No iot_instc_pu****_c*-v64********

El ID de la instancia. Busque el ID en la página Descripción general de la consola de IoT Platform.

Importante
  • Si su instancia tiene un ID, este parámetro es obligatorio. De lo contrario, la llamada fallará.
  • Si no se genera una página Descripción general o un ID para su instancia, omita este parámetro.

Descripción general.

ProductKey String No a1BwAGV****

La clave ProductKey del producto al que pertenece el dispositivo.

Nota Si especifica este parámetro, también debe especificar DeviceName.
DeviceName String No light

El nombre del dispositivo (DeviceName).

Nota Si especifica este parámetro, también debe especificar ProductKey.
IotId String No Q7uOhVRdZRRlDnTLv****00100

El ID del dispositivo, un identificador único global (GUID) emitido por IoT Platform.

Nota IotId es un GUID que corresponde a una combinación de ProductKey y DeviceName. Si especifica IotId, no necesita especificar ProductKey ni DeviceName. Si se especifica IotId junto con ProductKey y DeviceName, IotId tiene prioridad.

Esta operación también requiere los parámetros de solicitud comunes.

Parámetros de respuesta

Parámetro Tipo Ejemplo Descripción
Code String iot.system.SystemException

El código de error devuelto si la llamada falla. Códigos de error.

Data Boolean true

Indica si se eliminó la relación topológica.

  • true: La relación topológica se eliminó correctamente.
  • false: No se pudo eliminar la relación topológica.
ErrorMessage String A system exception occurred.

El mensaje de error devuelto si la llamada falla.

RequestId String E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565

El ID de la solicitud.

Success Boolean true

Indica si la llamada se realizó correctamente.

  • true: La llamada fue exitosa.
  • false: La llamada falló.

Ejemplos

Solicitudes de ejemplo

https://iot.cn-shanghai.aliyuncs.com/?Action=RemoveThingTopo
&ProductKey=a1bPo9p****
&DeviceName=device1
&<Common request parameters>

Respuestas exitosas de ejemplo

Formato XML

<RemoveThingTopoResponse>
  <Data>true</Data>
  <RequestId>098BEEF4-58F4-4181-A891-5D37DB6C4C3B</RequestId>
  <Success>true</Success>
</RemoveThingTopoResponse>

Formato JSON

{
    "Data": true,
    "RequestId": "098BEEF4-58F4-4181-A891-5D37DB6C4C3B",
    "Success": true
}

Códigos de error

Para obtener una lista de códigos de error, visite el Centro de errores de API.