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

Consulta los registros de servicio originales que envía un dispositivo específico. Estos registros incluyen servicios verificados y no verificados por un modelo de Thing Specification Language (TSL) determinado.

Límites

Solo puede consultar los registros de llamadas de servicio generados en los últimos 30 días.

Nota

El periodo de almacenamiento de un registro de llamada de servicio se calcula a partir del día en que se invoca el servicio.

Cada cuenta de Alibaba Cloud puede ejecutar un máximo de 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 su comodidad, le recomendamos que invoque 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í	QueryDeviceOriginalServiceData	La operación que desea realizar. Establezca el valor en QueryDeviceOriginalServiceData.
Asc	Integer	Sí	0	El orden de clasificación de los registros de llamadas de servicio devueltos. Valores válidos: 0: descendente. 1: ascendente. Nota La hora de inicio debe ser anterior a la hora de finalización. El sistema clasifica los registros devueltos según el orden especificado.
EndTime	Long	Sí	1579249499000	El final del intervalo de tiempo que se va a consultar. El valor debe ser una marca de tiempo de 13 dígitos.
Identifier	String	Sí	Set	El identificador del servicio. Si se aplica la verificación de bajo nivel, puede seguir estos pasos para consultar el identificador de un evento de dispositivo: inicie sesión en la consola de IoT Platform y vaya a la pestaña Define Feature de la página Product Details. También puede invocar la operación QueryThingModel y consultar el identificador del servicio en los datos TSL devueltos. Si no se aplica ninguna verificación, el valor debe coincidir con el valor del identificador personalizado que envía el dispositivo.
PageSize	Integer	Sí	10	El número de entradas que se devolverán en cada página. Valor máximo: 50.
StartTime	Long	Sí	1579249498000	El inicio del intervalo de tiempo que se va a consultar. El valor debe ser una marca de tiempo de 13 dígitos.
IotInstanceId	String	No	iot_instc_pu***_c-v64********	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 configurar este parámetro. Si no establece este parámetro, la llamada fallará. Si su instancia no tiene página Overview ni ID, no necesita establecer este parámetro. Para obtener más información, consulte Descripción general.
ProductKey	String	No	a1BwAGV****	La clave ProductKey del producto al que pertenece el dispositivo. Nota Si especifica este parámetro, también debe especificar el parámetro DeviceName.
DeviceName	String	No	light	El nombre del dispositivo. Nota Si especifica este parámetro, también debe especificar el parámetro ProductKey.
NextPageToken	String	No	Bo***x44Qx	El identificador de la siguiente página. La respuesta a la primera solicitud contiene este parámetro, el cual se agregará a la siguiente solicitud.
IotId	String	No	Q7uOhVRdZRRlDnTLv****00100	El ID del dispositivo. Es el identificador único que IoT Platform generó para el dispositivo. Nota Si especifica este parámetro, no necesita especificar el parámetro ProductKey ni DeviceName. El parámetro IotId especifica un identificador único para el dispositivo y corresponde a una combinación de los parámetros ProductKey y DeviceName. Si especifica el parámetro IotId y una combinación de los parámetros ProductKey y DeviceName al mismo tiempo, el parámetro IotId tendrá prioridad.

Además de los parámetros de solicitud específicos de la operación anteriores, debe especificar parámetros de solicitud comunes al invocar esta operación de API. Para obtener más información sobre los parámetros de solicitud comunes, consulte Parámetros comunes.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
Code	String	iot.device.InvalidIoTId	El código de error devuelto si la llamada falla. Para obtener más información, consulte Códigos de error.
Data	Struct		Los registros de llamadas de servicio devueltos si la llamada es exitosa.
List	Array of ServiceInfo		La matriz de registros de llamadas de servicio. Cada elemento representa un registro de llamada de servicio. Para obtener más información sobre los detalles de un servicio, consulte los parámetros que pertenecen al parámetro ServiceInfo.
ServiceInfo
Identifier	String	Set	El identificador del servicio.
InputData	String	{\"LightAdjustLevel\":123}	El parámetro de entrada del servicio. El valor es una cadena en formato MAP. Sintaxis: clave:valor.
Name	String	Set_Temperature	El nombre del servicio.
OutputData	String	{\"code\":200,\"data\":{},\"id\":\"100686\",\"message\":\"success\",\"version\":\"1.0\"}	El parámetro de salida del servicio. El valor es una cadena en formato MAP. Sintaxis: clave:valor.
Time	String	1579249499000	La hora en que se invocó el servicio.
NextPageToken	String	Bo***x44Qx	El identificador de la siguiente página.
NextValid	Boolean	true	Indica si existe la siguiente página. true: La siguiente página existe. false: La siguiente página no existe. Si se devuelve el valor true, puede agregar el valor del parámetro NextPageToken a la siguiente solicitud. Esto le permite consultar los datos que no se incluyen en la consulta actual.
ErrorMessage	String	A system exception has occurred.	El mensaje de error devuelto si la llamada falla.
RequestId	String	E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565	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=QueryDeviceOriginalServiceData
&Asc=0
&EndTime=1579249499000
&Identifier=Set
&PageSize=10
&StartTime=1579249498000
&<Common request parameters>

Respuestas exitosas de ejemplo

Formato XML

<QueryDeviceOriginalServiceDataResponse>
  <Data>
        <NextValid>true</NextValid>
        <NextPageToken>Bo***x44Qx</NextPageToken>
        <List>
              <ServiceInfo>
                    <Name>set</Name>
                    <Time>1517315865198</Time>
                    <OutputData>{"code":200,"data":{},"id":"100686","message":"success","version":"1.0"}</OutputData>
                    <InputData>{"LightAdjustLevel":123}</InputData>
                    <Identifier>set</Identifier>
              </ServiceInfo>
        </List>
  </Data>
  <RequestId>A44C818E-FA7F-4765-B1E7-01D14AE01C6A</RequestId>
  <Success>true</Success>
</QueryDeviceOriginalServiceDataResponse>

Formato JSON

{
  "Data": {
    "NextValid": true, 
    "NextPageToken": "Bo***x44Qx", 
    "List": {
      "ServiceInfo": [
        {
          "Name": "set", 
          "Time": 1517315865198, 
          "OutputData": "{\"code\":200,\"data\":{},\"id\":\"100686\",\"message\":\"success\",\"version\":\"1.0\"}", 
          "InputData": "{\"LightAdjustLevel\":123}", 
          "Identifier": "set"
        }
      ]
    }
  }, 
  "RequestId": "A44C818E-FA7F-4765-B1E7-01D14AE01C6A", 
  "Success": true
}

Códigos de error

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