調(diào)用該接口查詢指定設(shè)備本身調(diào)用的原始服務(wù)（通過和未通過物模型校驗的所有服務(wù)）記錄。

使用說明

  • 華東2（上海）、華北2（北京）和華南1（深圳）地域的標(biāo)準(zhǔn)型和尊享型企業(yè)版實例：僅可查詢存儲時效內(nèi)的數(shù)據(jù)。數(shù)據(jù)存儲時效，請參見存儲配置。
  • 其他地域和實例：僅可查詢最近30天內(nèi)的服務(wù)數(shù)據(jù)。
說明 數(shù)據(jù)存儲時間從調(diào)用服務(wù)當(dāng)日開始計算。

QPS限制

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

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

調(diào)試

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

請求參數(shù)

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

系統(tǒng)規(guī)定參數(shù)。取值：QueryDeviceOriginalServiceData。
Asc Integer 是 0

指定返回結(jié)果中，服務(wù)調(diào)用記錄按時間排序的方式。取值：

  • 0：倒序。
  • 1：正序。
說明 StartTime必須小于EndTime，系統(tǒng)會根據(jù)排序方式自動轉(zhuǎn)換。
EndTime Long 是 1579249499000

要查詢的服務(wù)調(diào)用記錄的結(jié)束時間。取值為毫秒值時間戳。
Identifier String 是 Set

要查詢的服務(wù)標(biāo)識符。

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

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

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

實例ID。您可在物聯(lián)網(wǎng)平臺控制臺的實例概覽頁面，查看當(dāng)前實例的ID。

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

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

要查詢設(shè)備所屬的產(chǎn)品ProductKey。

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

要查詢的設(shè)備名稱。

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

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

要查詢的設(shè)備ID。物聯(lián)網(wǎng)平臺為該設(shè)備頒發(fā)的ID，設(shè)備的唯一標(biāo)識符。

重要 IotId作為設(shè)備唯一標(biāo)識符，和ProductKey與DeviceName組合是一一對應(yīng)的關(guān)系。如果傳入該參數(shù)，則無需傳入ProductKey和DeviceName。如果您同時傳入IotId和ProductKey與DeviceName組合，則以IotId為準(zhǔn)。

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

返回數(shù)據(jù)

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

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

調(diào)用成功時，返回的設(shè)備服務(wù)調(diào)用記錄。
List Array of ServiceInfo

服務(wù)調(diào)用記錄集合。每個元素代表一個服務(wù)調(diào)用記錄。服務(wù)信息請參見ServiceInfo下參數(shù)。
ServiceInfo
Identifier String Set

服務(wù)標(biāo)識符。
InputData String {\"LightAdjustLevel\":123}

服務(wù)的輸入?yún)?shù)，MAP格式的字符串，結(jié)構(gòu)為key:value。
Name String 設(shè)置溫度

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

服務(wù)的輸出參數(shù)，MAP格式的字符串，結(jié)構(gòu)為key:value。
Time String 1579249499000

調(diào)用服務(wù)的時間。
NextPageToken String Bo***x44Qx

下一頁標(biāo)識。
NextValid Boolean true

是否有下一頁屬性記錄。

  • true：有。
  • false：沒有。

返回NextValid為true時，可以將NextPageToken的值作為下次查詢的NextPageToken，繼續(xù)查詢本次查詢不顯示的數(shù)據(jù)。
ErrorMessage String 系統(tǒng)異常

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

阿里云為該請求生成的唯一標(biāo)識符。
Success Boolean true

是否調(diào)用成功。

  • true：調(diào)用成功。
  • false：調(diào)用失敗。

示例

請求示例

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

正常返回示例

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
}

錯誤碼

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