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

Consulta todas las acciones de reenvío de datos configuradas para una regla específica. Cuando se activa la regla, los datos pueden reenviarse a distintos destinos según las acciones configuradas.

Límites de QPS

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

Nota

Los usuarios de Resource Access Management (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 mayor 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 de dato	Obligatorio	Ejemplo	Descripción
Action	String	Sí	ListRuleActions	La operación que desea ejecutar. Establezca el valor en ListRuleActions.
RuleId	Long	Sí	10000	El ID de la regla. Inicie sesión en la consola de IoT Platform y vaya a la página de detalles de la instancia que desea gestionar. En la página de detalles de la instancia, seleccione Rules Engine > Data Forwarding para obtener el ID de la regla. También puede llamar a la operación ListRule para consultar el valor del parámetro Id en la respuesta.
IotInstanceId	String	No	iot_instc_pu***_c-v64********	El ID de la instancia. En la página Overview de la consola de IoT Platform, puede consultar el ID de la instancia. Importante Si su instancia tiene un ID, debe especificarlo en este parámetro. De lo contrario, la llamada fallará. Si la página Overview o el ID de la instancia no se muestran en la consola de IoT Platform, no es necesario configurar este parámetro. Para más información sobre la instancia, consulte Descripción general.

Además de los parámetros de solicitud específicos de la operación mencionados a continuación, debe especificar los parámetros de solicitud comunes al llamar a esta operación. Para más información sobre los parámetros de solicitud comunes, consulte Parámetros comunes.

Parámetros de respuesta

Parámetro	Tipo de dato	Ejemplo	Descripción
Code	String	iot.system.SystemException	El código de error devuelto si la llamada falla. Para más información sobre los códigos de error, consulte Códigos de error.
ErrorMessage	String	A system exception occurred.	El mensaje de error devuelto si la llamada falla.
RequestId	String	22254BDB-3DC1-4643-8D1B-EE0437EF09A9	El ID de la solicitud.
RuleActionList	Array of RuleActionInfo		Si la llamada es exitosa, se devuelven todas las acciones de reenvío de datos configuradas para la regla especificada. Para más información sobre los datos devueltos, consulte el siguiente parámetro RuleActionInfo.
RuleActionInfo
Configuration	String	{\"endPoint\":\"http://ShanghaiRegion.cn-shanghai.ots.aliyuncs.com\",\"instanceName\":\"ShanghaiRegion\",\"primaryKeys\":[{\"columnName\":\"temperature\",\"columnType\":\"INTEGER\",\"columnValue\":\"${deviceName}\"}],\"regionName\":\"cn-shanghai\",\"role\":{\"roleArn\":\"acs:ram::1231579085****:role/aliyuniotaccessingotsrole\",\"roleName\":\"AliyunIOTAccessingOTSRole\"},\"tableName\":\"iottest\",\"uid\":\"1231579085****\"}	La configuración del destino de datos.
ErrorActionFlag	Boolean	false	Indica si el destino de datos se utiliza para recibir datos de operaciones con errores. Estos son datos cuyo reenvío falló dos veces consecutivas. true: Este destino se utiliza para recibir datos de operaciones con errores. false: Este destino no se utiliza para recibir datos de operaciones con errores.
Id	Long	139099	El ID de la acción mediante la cual se reenvían los datos al destino.
RuleId	Long	10000	El ID de la regla en la que se basa el reenvío de datos al destino.
Status	String	NORMAL	El estado de la acción de reenvío de datos. Valores válidos: INIT: La acción se está configurando. NORMAL: La configuración está completa y la acción puede ejecutarse correctamente. INVALID: Los datos de configuración no son válidos y la acción no se puede ejecutar. SHORTCUT: Ocurrió una excepción y la acción de reenvío de datos se detuvo.
Type	String	OTS	El tipo de acción mediante la cual se reenvían los datos a un destino. Valores válidos: REPUBLISH: Los datos se reenvían a un tema. OTS: Los datos se almacenan en Tablestore. MNS: Los datos se reenvían a Message Service (MNS). ONS: Los datos se reenvían a Message Queue for Apache RocketMQ. TSDB: Los datos se almacenan en Time Series Database. FC: Los datos se reenvían a Function Compute. RDS: Los datos se reenvían a ApsaraDB RDS. AMQP: Los datos se reenvían a un grupo de consumidores de Advanced Message Queuing Protocol (AMQP).
Success	Boolean	true	Indica si la llamada fue exitosa. true: La llamada fue exitosa. false: La llamada falló.

Ejemplos

Solicitudes de ejemplo

https://iot.cn-shanghai.aliyuncs.com/?Action=ListRuleActions
&RuleId=10000
&<Common request parameters>

Respuesta exitosa de ejemplo

Formato XML

<ListRuleActionsResponse>
  <RuleActionList>
        <RuleActionInfo>
              <Type>OTS</Type>
              <RuleId>10000</RuleId>
              <Id>139099</Id>
              <Status>NORMAL</Status>
              <Configuration>{"endPoint":"http://ShanghaiRegion.cn-shanghai.ots.aliyuncs.com","instanceName":"ShanghaiRegion","primaryKeys":[{"columnName":"temperature","columnType":"INTEGER","columnValue":"${deviceName}"}],"regionName":"cn-shanghai","role":{"roleArn":"acs:ram::1231579085******:role/aliyuniotaccessingotsrole","roleName":"AliyunIOTAccessingOTSRole"},"tableName":"iottest","uid":"1231579085******"}</Configuration>
              <ErrorActionFlag>false</ErrorActionFlag>
        </RuleActionInfo>
        <RuleActionInfo>
              <Type>REPUBLISH</Type>
              <RuleId>152323</RuleId>
              <Id>142401</Id>
              <Status>NORMAL</Status>
              <Configuration>{"topic":"/sys/a1zSA28H***/device/thing/service/property/set","topicType":0,"uid":"1231579085******"}</Configuration>
              <ErrorActionFlag>false</ErrorActionFlag>
        </RuleActionInfo>
  </RuleActionList>
  <RequestId>22254BDB-3DC1-4643-8D1B-EE0437EF09A9</RequestId>
  <Success>true</Success>
</ListRuleActionsResponse>

Formato JSON

{
  "RuleActionList": {
    "RuleActionInfo": [
      {
        "Type": "OTS", 
        "RuleId": 10000, 
        "Id": 139099, 
        "Status":"NORMAL",
        "Configuration": "{\"endPoint\":\"http://ShanghaiRegion.cn-shanghai.ots.aliyuncs.com\",\"instanceName\":\"ShanghaiRegion\",\"primaryKeys\":[{\"columnName\":\"temperature\",\"columnType\":\"INTEGER\",\"columnValue\":\"${deviceName}\"}],\"regionName\":\"cn-shanghai\",\"role\":{\"roleArn\":\"acs:ram::1231579085******:role/aliyuniotaccessingotsrole\",\"roleName\":\"AliyunIOTAccessingOTSRole\"},\"tableName\":\"iottest\",\"uid\":\"1231579085******\"}", 
        "ErrorActionFlag": false
      }, 
      {
        "Type": "REPUBLISH", 
        "RuleId": 152323, 
        "Id": 142401, 
        "Status": "NORMAL",
        "Configuration": "{\"topic\":\"/sys/a1zSA28H***/device/thing/service/property/set\",\"topicType\":0,\"uid\":\"1231579085******\"}", 
        "ErrorActionFlag": false
      }
    ]
  }, 
  "RequestId": "22254BDB-3DC1-4643-8D1B-EE0437EF09A9", 
  "Success": true
}

Códigos de error

Para consultar la lista de códigos de error, visite el Centro de errores.