QueryDeviceServiceData - IoT Platform - Alibaba Cloud Documentation Center

Mengkueri catatan panggilan layanan dari perangkat tertentu.

Catatan penggunaan

Anda hanya dapat mengkueri catatan panggilan layanan selama 30 hari terakhir.

Catatan Masa penyimpanan catatan panggilan layanan dihitung sejak hari layanan tersebut dipanggil.

Batas QPS

Anda dapat memanggil operasi API ini hingga 50 kali per detik per akun.

Catatan Pengguna RAM dari suatu Akun Alibaba Cloud berbagi kuota akun tersebut.

Debugging

OpenAPI Explorer secara otomatis menghitung nilai signature. Untuk kenyamanan Anda, kami menyarankan agar Anda memanggil operasi ini di OpenAPI Explorer. OpenAPI Explorer secara dinamis menghasilkan contoh kode untuk berbagai SDK.

Parameter permintaan

Parameter	Type	Wajib	Contoh	Deskripsi
Action	String	Ya	QueryDeviceServiceData	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke QueryDeviceServiceData.
EndTime	Long	Ya	1579249499000	Akhir rentang waktu untuk dikueri. Nilainya berupa Unix timestamp. Satuan: milidetik. Contoh: 1579249499000.
StartTime	Long	Ya	1579249499000	Awal rentang waktu untuk dikueri. Nilainya berupa Unix timestamp. Satuan: milidetik. Contoh: 1579249499000.
IotInstanceId	String	Tidak	iot_instc_pu***_c-v64********	ID instans. Anda dapat melihat ID instans pada halaman Overview di Konsol IoT Platform. Penting Jika instans Anda memiliki ID, Anda harus menentukan ID tersebut untuk parameter ini. Jika tidak, pemanggilan akan gagal. Jika halaman Overview atau ID tidak dihasilkan untuk instans Anda, Anda tidak perlu mengonfigurasi parameter ini. Untuk informasi lebih lanjut, lihat Overview.
IotId	String	Tidak	Q7uOhVRdZRRlDnTLv****00100	ID perangkat. ID ini merupakan pengenal unik yang dikeluarkan oleh IoT Platform untuk perangkat tersebut. Penting Parameter IotId menentukan GUID untuk perangkat. Nilai parameter IotId setara dengan kombinasi nilai parameter ProductKey dan DeviceName. Jika Anda menentukan nilai untuk parameter ini, Anda tidak perlu mengonfigurasi parameter ProductKey atau DeviceName. Jika Anda menentukan nilai untuk parameter IotId, ProductKey, dan DeviceName, nilai parameter IotId akan didahulukan.
ProductKey	String	Tidak	a1BwAGV****	ProductKey produk tempat perangkat tersebut terdaftar. Penting Jika Anda menentukan nilai untuk parameter ini, Anda harus mengonfigurasi parameter DeviceName.
DeviceName	String	Tidak	light	DeviceName perangkat tersebut. Penting Jika Anda menentukan nilai untuk parameter ini, Anda harus mengonfigurasi parameter ProductKey.
Identifier	String	Tidak	Set	Pengenal layanan. identifier layanan yang dipanggil. Anda dapat melihat pengenal layanan pada tab Define Feature di Konsol IoT Platform. Anda juga dapat memanggil operasi QueryThingModel untuk melihat pengenal layanan tersebut. Catatan Jika layanan bernama testService termasuk dalam modul kustom bernama testFb, Anda dapat mengatur parameter ini menjadi testFb:testService. Modul kustom ini bukan modul default. Jika Anda tidak menentukan nilai untuk parameter ini, sistem akan mengkueri semua data layanan dari modul default.
Asc	Integer	No.	0	Urutan pengurutan catatan panggilan layanan yang dikembalikan. Nilai yang valid: 0: urutan kronologis terbalik 1: urutan kronologis
PageSize	Integer	Tidak	10	Jumlah entri yang dikembalikan per halaman. Nilai yang valid: 1 hingga 50.

Selain parameter permintaan khusus operasi di atas, Anda harus mengonfigurasi parameter permintaan umum saat memanggil operasi ini. Untuk informasi lebih lanjut tentang parameter permintaan umum, lihat Parameter Umum.

Parameter respons

Parameter	Type	Contoh	Deskripsi
Code	String	iot.system.SystemException	Kode kesalahan yang dikembalikan jika pemanggilan gagal. Untuk informasi lebih lanjut, lihat Kode Kesalahan.
Data	Struct		Catatan panggilan layanan yang dikembalikan jika pemanggilan berhasil.
List	Array of ServiceInfo		Array catatan panggilan layanan. Setiap elemen merepresentasikan satu catatan panggilan layanan.
ServiceInfo
Identifier	String	Set	Pengenal layanan.
InputData	String	{\"LightAdjustLevel\":123}	Parameter input layanan. Nilainya berupa string dalam format MAP. Sintaks: `key:value`.
Name	String	Set_Temperature	Nama layanan.
OutputData	String	{\"code\":200,\"data\":{},\"id\":\"100686\",\"message\":\"success\",\"version\":\"1.0\"}	Parameter output layanan. Nilainya berupa string dalam format MAP. Sintaks: `key:value`.
Time	String	1579249499000	Waktu layanan dipanggil.
NextTime	Long	1579335899000	Waktu mulai catatan panggilan layanan pada halaman berikutnya. Jika Anda memanggil operasi QueryDeviceServiceData untuk mengkueri catatan panggilan layanan pada halaman berikutnya, Anda harus mengatur parameter StartTime ke nilai parameter ini.
NextValid	Boolean	true	Menunjukkan apakah halaman berikutnya tersedia. true false Jika nilai kembali parameter NextValid adalah true, Anda dapat menggunakan nilai parameter NextTime sebagai nilai parameter StartTime saat mengkueri hasil halaman berikutnya.
ErrorMessage	String	A system exception occurred.	Pesan kesalahan yang dikembalikan jika pemanggilan gagal.
RequestId	String	E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565	ID permintaan. ID ini secara unik mengidentifikasi permintaan tersebut.
Success	Boolean	true	Menunjukkan apakah pemanggilan berhasil. Nilai yang valid: true: Pemanggilan berhasil. false: Pemanggilan gagal.

Contoh

Contoh permintaan

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

Contoh respons sukses

XML format

<QueryDeviceServiceDataResponse>
  <Data>
        <NextValid>true</NextValid>
        <NextTime>1517315865197</NextTime>
        <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>
</QueryDeviceServiceDataResponse>

JSON format

{
  "Data": {
    "NextValid": true, 
    "NextTime": 1517315865197, 
    "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
}

Kode kesalahan

Untuk daftar kode kesalahan, lihat Service error codes.