Todos los productos
Search
Centro de documentos

IoT Platform:CreateTopicRouteTable

Última actualización: Sep 08, 2026

Crea relaciones de enrutamiento de mensajes entre temas.

Límites

  • Un tema de origen admite hasta 100 temas de destino.

  • El dispositivo propietario del tema de origen debe estar activado.

  • Los temas de origen y de destino solo admiten temas personalizados.

  • Límite de QPS por cuenta de Alibaba Cloud: 50.

    Nota

    Los usuarios de RAM comparten la cuota.

Depuración

Ejecute esta operación en OpenAPI Explorer, que calcula automáticamente las firmas y genera código de demostración del SDK.

Parámetros de solicitud

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

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

DstTopic.N RepeatList Sí /x7aWKW9****/deviceNameTest1/user/add

Los temas de destino que se suscriben al tema de origen especificado en SrcTopic. Use el formato de arreglo incluso para un solo tema. Ejemplos: DstTopic.1=/x7aWKW9**/deviceNameTest1/user/add y DstTopic.2=/x7aWKW9**/deviceNameTest2/user/delete.

SrcTopic String Sí /x7aWKW9****/testDataToDataHub/user/update

El tema de origen. Ejemplo: SrcTopic=/x7aWKW9 /testDataToDataHub/user/update.

IotInstanceId String No iot-cn-0pp1n8t****

El ID de la instancia. Disponible en la página Overview de la consola de IoT Platform.

Importante
  • Obligatorio si su instancia tiene un ID. Sin este parámetro, la llamada falla.
  • No es obligatorio si su instancia no tiene una página Overview ni un ID.

Descripción general.

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 cuando la llamada falla. Consulte Códigos de error.

ErrorMessage String iot.system.SystemException

El mensaje de error devuelto cuando la llamada falla.

FailureTopics List ["/2Fx7aWKW9****/FdeviceNameTest2/user/delete"]

Los temas cuyo enrutamiento falló.

IsAllSucceed Boolean true

Indica si se crearon todas las relaciones de enrutamiento de temas.

  • true: Todas las relaciones de enrutamiento se crearon correctamente.
  • false: Una o más relaciones de enrutamiento fallaron.
RequestId String FCC27691-9151-4B93-9622-9C90F30542EC

El ID de la solicitud.

Success Boolean true

Indica si la llamada se completó correctamente.

  • true: La llamada se completó correctamente.
  • false: La llamada falló.

Ejemplos

Ejemplos de solicitudes

https://iot.cn-shanghai.aliyuncs.com/?Action=CreateTopicRouteTable
&SrcTopic=%2Fx7aWKW9****%2FtestDataToDataHub%2Fuser%2Fupdate
&DstTopic.1=%2Fx7aWKW9****%2FdeviceNameTest1%2Fuser%2Fadd
&DstTopic.2=%2Fx7aWKW9****%2FdeviceNameTest2%2Fuser%2Fdelete
&<Common request parameters>

Ejemplos de respuestas correctas

Formato XML

<CreateTopicRouteTableResponse>
  <RequestId>32B9828A-25DD-48E2-8E26-D1664B341940</RequestId>
  <FailureTopics></FailureTopics>
  <Success>true</Success>
</CreateTopicRouteTableResponse>

Formato JSON

{
    "RequestId": "32B9828A-25DD-48E2-8E26-D1664B341940",
    "FailureTopics": {
        "Topic": []
    },
    "Success": true
}

Códigos de error

Consulte los códigos de error en el Centro de errores de API.