CreateDataSourceItem - IoT Platform - Centro de documentación de Alibaba Cloud

Agrega un tema a un origen de datos en el motor de reglas.

Notas de uso

Antes de llamar a la operación CreateDataSourceItem, debe crear un origen de datos. Para obtener más información, consulte "Paso 1 a Paso 6" en el tema Crear un origen de datos. A continuación, siga estos pasos para consultar el ID del origen de datos: inicie sesión en la consola de IoT Platform y haga clic en el nombre de la instancia a la que pertenece el origen de datos. Elija Rules Engine > Data Forwarding. En la pestaña Data Source, consulte el ID of the data source.

Límites de QPS

Cada cuenta de Alibaba Cloud admite hasta 10 consultas por segundo (QPS).

Nota

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

Depuración

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

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	CreateDataSourceItem	La operación que desea ejecutar. Establezca el valor en CreateDataSourceItem.
DataSourceId	Long	Sí	1002	El ID del origen de datos.
Topic	String	Sí	/as/mqtt/status/gy***z/+	El tema que desea agregar al origen de datos en el motor de reglas. Formato: `/${productKey}/${deviceName}/topicShortName`. `${productKey}` especifica el ProductKey del producto al que pertenece un dispositivo. `${deviceName}` especifica el nombre del dispositivo. `topicShortName` especifica el nombre personalizado del tema. El formato de los temas de comunicación básica o de comunicación TSL es `/${productKey}/${deviceName}/topicShortName`. Puede reemplazar `${deviceName}` con el comodín `+`. Este comodín indica que el tema se aplica a todos los dispositivos del producto. Valores válidos de `topicShortName`: `/thing/event/property/post`: envía los datos de propiedad de un dispositivo. `/thing/event/${tsl.event.identifier}/post`: envía los datos de evento de un dispositivo. `${tsl.event.identifier}` especifica el identificador de un evento en el modelo TSL. `/thing/lifecycle`: envía cambios en el ciclo de vida del dispositivo. `/thing/downlink/reply/message`: envía una respuesta a una solicitud de IoT Platform. `/thing/list/found`: envía datos cuando una puerta de enlace detecta un nuevo subdispositivo. `/thing/topo/lifecycle`: envía cambios en la topología del dispositivo. `/thing/event/property/history/post`: envía datos históricos de propiedad de un dispositivo. `/thing/event/${tsl.event.identifier}/post`: envía datos históricos de eventos de un dispositivo. `${tsl.event.identifier}` especifica el identificador de un evento en el TSL. `/ota/upgrade`: envía estados de actualización OTA. `/ota/version/post`: envía versiones de módulos OTA. `/thing/deviceinfo/update`: envía cambios en las etiquetas del dispositivo. `${packageId}/${jobId}/ota/job/status`: envía el estado de cada lote de actualización OTA. Este tema es un tema de comunicación básica. `${packageId}` especifica el ID del paquete de actualización. `${jobId}` especifica el ID del lote de actualización. El formato de los temas personalizados es `/${productKey}/${deviceName}/user/#`. Ejemplo: `/${productKey}/${deviceName}/user/get`. Puede llamar a la operación QueryProductTopic para consultar todos los temas personalizados del producto. Al especificar un tema personalizado, puede usar los comodines `+` y `#`. Puede reemplazar `${deviceName}` con el comodín `+`. Este comodín indica que el tema se aplica a todos los dispositivos del producto. Puede reemplazar los campos posteriores a ${deviceName} con `/user/#`. El comodín `#` indica que el tema se aplica a todos los campos posteriores a `/user`. El formato de los temas que se usan para enviar cambios de estado del dispositivo es `/as/mqtt/status/${productKey}/${deviceName}`. Puede usar el comodín `+`. En este caso, se envían los cambios de estado de todos los dispositivos del producto. Para obtener más información sobre cómo usar comodines, consulte Comodines en temas. Para obtener más información sobre los formatos de datos de los temas, consulte Formatos de datos.
IotInstanceId	String	No	iot-0pp1n8t***	El ID de la instancia. Puede consultar el ID de la instancia en la página Overview de la consola de IoT Platform. Importante Si su instancia tiene un ID, debe especificarlo en este parámetro. De lo contrario, la llamada fallará. Si no se generó ninguna página Overview ni ningún ID para su instancia, no necesita configurar este parámetro. Para obtener más información, consulte Descripción general.

Además de los parámetros de solicitud específicos de la operación anteriores, debe configurar parámetros de solicitud comunes al llamar a esta operación. Para obtener más información, consulte 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. Para obtener más información, consulte Códigos de error.
ErrorMessage	String	A system exception occurred.	El mensaje de error devuelto si la llamada falla.
RequestId	String	E4C0FF92-2A86-41DB-92D3-73B60310D25E	El ID de la solicitud.
Success	Boolean	true	Indica si la llamada fue exitosa. true: La llamada fue exitosa. false: La llamada falló.

Ejemplos

Solicitudes de ejemplo

http(s)://iot.cn-shanghai.aliyuncs.com/?Action=CreateDataSourceItem
&DataSourceId=1002
&Topic=/as/mqtt/status/gy***z/+
&<Common request parameters>

Respuestas exitosas de ejemplo

Formato XML

<CreateDataSourceItemResponse>
  <RequestId>E4C0FF92-2A86-41DB-92D3-73B60310D25E</RequestId>
  <Success>true</Success>
</CreateDataSourceItemResponse>

Formato JSON

{
    "RequestId": "E4C0FF92-2A86-41DB-92D3-73B60310D25E",
    "Success": true
}

Códigos de error

HttpCode	Código de error	Mensaje de error	Descripción
400	iot.prod.NotExistedProduct	The specified product does not exist.	Mensaje de error devuelto porque el producto especificado no existe.
400	iot.system.SystemException	An internal error occurred. Try again later.	Mensaje de error devuelto debido a una excepción del sistema.
400	iot.common.InvalidFormattedParameter	The parameter format is invalid.	Mensaje de error devuelto porque el formato del parámetro no es válido.

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