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

Consulta los datos de una propiedad en un dispositivo o nodo gemelo digital durante un periodo de tiempo específico.

Notas de uso

Si un dispositivo o nodo gemelo digital tiene varias propiedades, llame a esta operación varias veces para consultar los datos de cada una. Cada vez que ejecute la llamada, especifique un valor para el parámetro Identifier. También puede llamar a la operación QueryDevicePropertiesData y especificar varios valores para el parámetro Identifier para consultar los datos de las propiedades.

Límites

Solo se pueden consultar los datos de propiedades generados en los últimos 30 días.

Nota

Los datos de una propiedad se almacenan a partir del día en que se generan.

Límites de QPS

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

Nota

Los usuarios 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, ya que genera de forma dinámica el código de ejemplo de la operación para distintos SDK.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	QueryDevicePropertyData	Operación que desea ejecutar. Establezca el valor en QueryDevicePropertyData.
EndTime	Long	Sí	1579249499000	Final del intervalo de tiempo que se va a consultar. El valor del parámetro EndTime debe ser mayor que el del parámetro StartTime. Se expresa como marca de tiempo en milisegundos; por ejemplo, 1579249499000.
Asc	Integer	Sí	0	Orden en el que se devuelven los registros de propiedades. Valores válidos: 0: orden cronológico inverso 1: orden cronológico
Identifier	String	Sí	temperature	Identificador de la propiedad que desea consultar. Consulte el identificador de la propiedad en la pestaña Define Feature de la página Product Details, dentro de la consola de IoT Platform. Otra opción es llamar a la operación QueryThingModel y revisar el identificador en los datos TSL devueltos. Nota Si una propiedad llamada temperature pertenece a un módulo personalizado llamado testFb, establezca este parámetro en testFb:temperature. Este módulo personalizado no es el módulo predeterminado.
PageSize	Integer	Sí	10	Número de entradas que se devuelven en cada página. Valores válidos: de 1 a 50.
StartTime	Long	Sí	1579249499000	Inicio del intervalo de tiempo que se va a consultar. El valor del parámetro StartTime debe ser menor que el del parámetro EndTime. Se expresa como marca de tiempo en milisegundos; por ejemplo, 1579249499000.
IotInstanceId	String	No	iot-cn-0pp1n8t****	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, configure este parámetro; de lo contrario, la llamada fallará. Si su instancia no tiene una página Overview ni ID, no es necesario configurar este parámetro. Para más información, consulte Descripción general.
IotId	String	No	Q7uOhVRdZRRlDnTLv****00100	ID del dispositivo al que pertenece la propiedad.: Llame a la operación QueryDeviceInfo para consultar el ID del dispositivo. Importante Si especifica un valor para este parámetro, no es necesario indicar los parámetros ProductKey ni DeviceName. El parámetro IotId representa un identificador único global (GUID) del dispositivo y equivale a la combinación de los valores de ProductKey y DeviceName. Si indica tanto IotId como ProductKey y DeviceName, el valor de IotId tendrá prioridad.
ProductKey	String	No	a1BwAGV****	ProductKey del producto al que pertenece el dispositivo. Importante Si especifica un valor para este parámetro, también debe indicar el parámetro DeviceName.
DeviceName	String	No	airconditioning	Nombre del dispositivo. Importante Si especifica un valor para este parámetro, también debe indicar el parámetro ProductKey.

Además de los parámetros de solicitud específicos descritos anteriormente, debe incluir los parámetros de solicitud comunes al llamar a esta operación. Para 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	Código de error devuelto si la llamada falla. Para más información, consulte Códigos de error.
Data	Struct		Datos de la propiedad devueltos cuando la llamada es exitosa.
List	Array of PropertyInfo		Lista de registros de propiedades.
PropertyInfo
Time	String	1516541885630	Hora en la que se modificó la propiedad.
Value	String	2	Valor de la propiedad.
NextTime	Long	1579249499000	Hora de inicio de los registros de propiedades en la página siguiente. Si el parámetro Asc se establece en 0, utilice este valor en el parámetro EndTime al volver a llamar a la operación para consultar la página siguiente de registros. Si el parámetro Asc se establece en 1, utilice este valor en el parámetro StartTime al volver a llamar a la operación para consultar la página siguiente de registros.
NextValid	Boolean	true	Indica si existe una página siguiente. true: existe una página siguiente. Cuando NextValid devuelve true, también se incluye el valor del parámetro NextTime. Para más detalles, consulte la descripción del parámetro NextTime en este documento. false: no existe una página siguiente.
ErrorMessage	String	A system exception occurred.	Mensaje de error devuelto si la llamada falla.
RequestId	String	E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565	ID de la solicitud.
Success	Boolean	true	Indica si la llamada fue exitosa. true: la llamada fue exitosa. false: la llamada terminó con errores.

Ejemplos

Solicitudes de ejemplo

https://iot.cn-shanghai.aliyuncs.com/?Action=QueryDevicePropertyData
&ProductKey=a1BwAGV****
&DeviceName=device1
&Identifier=lightLevel
&StartTime=1516538300303
&EndTime=1516541900303
&PageSize=10
&Asc=1
&<Common request parameters>

Respuestas de ejemplo

Formato XML

<QueryDevicePropertyDataResponse>
  <Data>
        <NextValid>false</NextValid>
        <NextTime>1579249151177</NextTime>
        <List>
              <PropertyInfo>
                    <Value>32.46</Value>
                    <Time>1579249151178</Time>
              </PropertyInfo>
        </List>
  </Data>
  <RequestId>45391E10-446B-4986-863E-1BA8CC44748F</RequestId>
  <Success>true</Success>
</QueryDevicePropertyDataResponse>

Formato JSON

{
  "Data": {
    "NextValid": false, 
    "NextTime": 1579249151177, 
    "List": {
      "PropertyInfo": [
        {
          "Value": "32.46", 
          "Time": 1579249151178
        }
      ]
    }
  }, 
  "RequestId": "45391E10-446B-4986-863E-1BA8CC44748F", 
  "Success": true
}

Códigos de error

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