調用該接口查詢指定設備本身調用的原始服務（通過和未通過物模型校驗的所有服務）記錄。

使用說明

  • 華東2（上海）、華北2（北京）和華南1（深圳）地域的標準型和尊享型企業版實例：僅可查詢存儲時效內的數據。數據存儲時效，請參見存儲配置。
  • 其他地域和實例：僅可查詢最近30天內的服務數據。
說明 數據存儲時間從調用服務當日開始計算。

QPS限制

單個阿里云賬號調用該接口的每秒請求數（QPS）最大限制為50。

說明 RAM用戶共享阿里云賬號配額。

調試

您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。

請求參數

名稱 類型 是否必選 示例值 描述
Action String 是 QueryDeviceOriginalServiceData

系統規定參數。取值：QueryDeviceOriginalServiceData。
Asc Integer 是 0

指定返回結果中，服務調用記錄按時間排序的方式。取值：

  • 0：倒序。
  • 1：正序。
說明 StartTime必須小于EndTime，系統會根據排序方式自動轉換。
EndTime Long 是 1579249499000

要查詢的服務調用記錄的結束時間。取值為毫秒值時間戳。
Identifier String 是 Set

要查詢的服務標識符。

  • 對于弱校驗，設備的服務Identifier，可在控制臺中設備所屬的產品的功能定義中查看；也可以調用QueryThingModel，從返回的物模型信息中查看。
  • 對于免校驗，必須與設備服務上報時自定義的identifier一致。
PageSize Integer 是 10

返回結果中每頁顯示的記錄數。數量限制：每頁最多可顯示50條。
StartTime Long 是 1579249498000

要查詢的服務調用記錄的開始時間。取值為毫秒值時間戳。
IotInstanceId String 否 iot_instc_pu****_c*-v64********

實例ID。您可在物聯網平臺控制臺的實例概覽頁面，查看當前實例的ID。

重要
  • 若有ID值，必須傳入該ID值，否則調用會失敗。
  • 若無實例概覽頁面或ID值，則無需傳入。

實例的更多信息，請參見實例概述。
ProductKey String 否 a1BwAGV****

要查詢設備所屬的產品ProductKey。

重要 如果傳入該參數，需同時傳入DeviceName。
DeviceName String 否 light

要查詢的設備名稱。

重要 如果傳入該參數，需同時傳入ProductKey。
NextPageToken String 否 Bo***x44Qx

下一頁標識。第一次請求，服務會返回此Token，第二次請求帶上即可。
IotId String 否 Q7uOhVRdZRRlDnTLv****00100

要查詢的設備ID。物聯網平臺為該設備頒發的ID，設備的唯一標識符。

重要 IotId作為設備唯一標識符，和ProductKey與DeviceName組合是一一對應的關系。如果傳入該參數，則無需傳入ProductKey和DeviceName。如果您同時傳入IotId和ProductKey與DeviceName組合，則以IotId為準。

調用API時，除了本文介紹的該API的特有請求參數，還需傳入公共請求參數。公共請求參數說明，請參見公共參數文檔。

返回數據

名稱 類型 示例值 描述
Code String iot.device.InvalidIoTId

調用失敗時，返回的錯誤碼。更多信息，請參見錯誤碼。
Data Struct

調用成功時，返回的設備服務調用記錄。
List Array of ServiceInfo

服務調用記錄集合。每個元素代表一個服務調用記錄。服務信息請參見ServiceInfo下參數。
ServiceInfo
Identifier String Set

服務標識符。
InputData String {\"LightAdjustLevel\":123}

服務的輸入參數，MAP格式的字符串，結構為key:value。
Name String 設置溫度

服務名稱。
OutputData String {\"code\":200,\"data\":{},\"id\":\"100686\",\"message\":\"success\",\"version\":\"1.0\"}

服務的輸出參數，MAP格式的字符串，結構為key:value。
Time String 1579249499000

調用服務的時間。
NextPageToken String Bo***x44Qx

下一頁標識。
NextValid Boolean true

是否有下一頁屬性記錄。

  • true：有。
  • false：沒有。

返回NextValid為true時，可以將NextPageToken的值作為下次查詢的NextPageToken，繼續查詢本次查詢不顯示的數據。
ErrorMessage String 系統異常

調用失敗時，返回的出錯信息。
RequestId String E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565

阿里云為該請求生成的唯一標識符。
Success Boolean true

是否調用成功。

  • true：調用成功。
  • false：調用失敗。

示例

請求示例

http(s)://iot.cn-shanghai.aliyuncs.com/?Action=QueryDeviceOriginalServiceData
&Asc=0
&EndTime=1579249499000
&Identifier=Set
&PageSize=10
&StartTime=1579249498000
&<公共請求參數>

正常返回示例

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>

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
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。