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

Modifica una regla específica.

Límites

Cada cuenta de Alibaba Cloud admite un máximo de 50 consultas por segundo (QPS).

Nota

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

Depuración

Alibaba Cloud proporciona OpenAPI Explorer para simplificar el uso de la API. OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, se recomienda llamar a esta operación desde OpenAPI Explorer. Esta herramienta 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í	UpdateRule	La operación que desea ejecutar. Establezca el valor en UpdateRule.
RuleId	Long	Sí	100000	El ID de la regla que desea modificar. Inicie sesión en la consola de IoT Platform y seleccione Rules > Data Forwarding para consultar el ID de la regla. También puede llamar a la operación ListRule y consultar el ID de la regla en la respuesta.
IotInstanceId	String	No	iot-cn-0pp1n8t****	El ID de la instancia. Consulte el ID de la instancia en la página Overview de la consola de IoT Platform. Importante Si su instancia tiene un ID, debe configurar este parámetro. De lo contrario, la llamada fallará. Si su instancia no tiene página de Overview o ID, no es necesario establecer este parámetro. Para obtener más información, consulte Descripción general.
Select	String	No	deviceName() as deviceName, items.Humidity.value as Humidity, items.Temperature.value as Temperature	La instrucción SQL SELECT por ejecutar. Para obtener más información, consulte Expresiones SQL. Nota Especifique el contenido posterior a la palabra clave SELECT para este parámetro. Por ejemplo, si la instrucción SELECT es `SELECT a,b,c`, especifique `a,b,c` para este parámetro.
ShortTopic	String	No	+/thing/event/property/post	El tema al que se aplica esta regla. Sintaxis: `${deviceName}/topicShortName`. `${deviceName}` especifica el nombre del dispositivo y `topicShortName` especifica el nombre personalizado del tema. Temas de comunicación básica o temas de comunicación basados en Thing Specification Language (TSL). Sintaxis: `${deviceName}/topicShortName`. Puede reemplazar `${deviceName}` con el comodín `+`. El 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 los 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 los datos históricos de evento 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. `/edge/driver/${driver_id}/point_post`: envía datos de paso directo desde Link IoT Edge. `${driver_id}` especifica el ID del controlador que utiliza un dispositivo para acceder a Link IoT Edge. `${packageId}/${jobId}/ota/job/status`: envía los estados de los lotes de actualización OTA. Este 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. Temas personalizados. Ejemplo: `${deviceName}/user/get`. Llame a la operación QueryProductTopic para consultar todos los temas personalizados del producto. Cuando especifique un tema personalizado, puede usar los comodines `+` y `#`. Puede reemplazar `${deviceName}` con el comodín `+`. El 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 sin importar los valores especificados para los campos posteriores a `/user`. Para obtener más información sobre el uso de comodines, consulte Comodines en temas. Tema utilizado para enviar cambios de estado del dispositivo: `${deviceName}`. Puede utilizar el comodín `+`. En este caso, se envían los cambios de estado de todos los dispositivos del producto.
Where	String	No	Temperature>35	La condición para activar la regla. Para obtener más información, consulte Expresiones SQL. Nota Especifique el contenido posterior a la palabra clave WHERE para este parámetro. Por ejemplo, si la instrucción WHERE es `WHERE a>10`, especifique `a>10` para este parámetro.
ProductKey	String	No	aladaeW****	La ProductKey del producto al que se aplica la regla.
Name	String	No	test_2	El nombre de la regla. Debe tener entre 1 y 30 caracteres de longitud, y puede contener letras, dígitos, guiones bajos (_) y guiones (-).
RuleDesc	String	No	test	La descripción de la regla. Puede tener hasta 100 caracteres de longitud.
TopicType	Integer	No	1	0: Tema de comunicación básica o basado en TSL. 1: Tema personalizado. 2: Tema utilizado para enviar cambios de estado del dispositivo. Sintaxis: `/as/mqtt/status/${productKey}/${deviceName}`.
Topic	String	No	/sys/g18l***/device1/thing/event/property/post	El tema completo al que se aplica la regla. Si especifica este parámetro, no es necesario especificar los parámetros ProductKey, ShortTopic y TopicType.

Además de los parámetros de solicitud específicos de la operación anteriores, debe especificar 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	9A2F243E-17FE-4846-BAB5-D02A25155AC4	El ID de la solicitud.
Success	Boolean	true	Indica si la llamada se realizó correctamente. true: La llamada se realizó correctamente. false: La llamada falló.

Ejemplos

Solicitudes de ejemplo

https://iot.cn-shanghai.aliyuncs.com/?Action=UpdateRule
&RuleId=100000
&Name=test_2
&ProductKey=aladaeW****
&ShortTopic=+/thing/event/property/post
&Select=deviceName() as deviceName, items.Humidity.value as Humidity, items.Temperature.value as Temperature
&RuleDesc=test
&Where=a>10
&TopicType=1
&<Common request parameters>

Respuestas correctas de ejemplo

Formato XML

<UpdateRuleResponse>
      <RequestId>9A2F243E-17FE-4874-QBB5-D02A25155AC8</RequestId>
      <Success>true</Success>
</UpdateRuleResponse>

Formato JSON

{
    "RequestId":"9A2F243E-17FE-4846-BAB5-D02A25155AC4",
    "Success":true
}

Códigos de error

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