QueryDeviceFileList - IoT Platform - Alibaba Cloud Documentation Center

Mengambil informasi semua file yang diunggah ke IoT Platform dari suatu perangkat.

Batasan

Informasi file yang dikembalikan oleh operasi ini tidak mencakup URL unduhan. Untuk mendapatkan URL unduhan suatu file, panggil QueryDeviceFile.
Setiap Akun Alibaba Cloud dapat menjalankan maksimal 500 permintaan per detik (QPS).
Catatan Pengguna RAM dari suatu Akun Alibaba Cloud berbagi kuota akun tersebut.

Debugging

Alibaba Cloud menyediakan OpenAPI Explorer untuk menyederhanakan penggunaan API. 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 operasi untuk berbagai SDK.

Parameter permintaan

Parameter	Type	Required	Example	Description
Action	String	Yes	QueryDeviceFileList	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke QueryDeviceFileList.
IotInstanceId	String	No	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 mengonfigurasi parameter ini. Jika Anda tidak menyetel parameter ini, pemanggilan akan gagal. Jika instans Anda tidak memiliki halaman Overview atau ID, Anda tidak perlu menyetel parameter ini. Untuk informasi selengkapnya, lihat Overview.
PageSize	Integer	No	10	Jumlah entri yang dikembalikan pada setiap halaman. Nilai maksimum: 200. Nilai default: 10.
ProductKey	String	No	a1BwAGV****	KunciProduk dari produk tempat perangkat tersebut terdaftar. Catatan Jika Anda menentukan parameter ini, Anda juga harus menentukan parameter DeviceName.
DeviceName	String	No	light	NamaPerangkat dari perangkat tersebut. Catatan Jika Anda menentukan parameter ini, Anda juga harus menentukan parameter ProductKey.
IotId	String	No	Q7uOhVRdZRRlDnTLv****00100	ID perangkat. ID perangkat dikeluarkan oleh IoT Platform. Catatan Jika Anda menentukan parameter ini, Anda tidak perlu menentukan ProductKey atau DeviceName. Parameter IotId menentukan identifier unik global (GUID) perangkat, yang berkorespondensi dengan kombinasi ProductKey dan DeviceName. Jika Anda menentukan baik IotId maupun kombinasi ProductKey dan DeviceName, IotId akan diutamakan.
CurrentPage	Integer	No	1	Nomor halaman yang akan dikembalikan. Halaman dimulai dari halaman 1. Nilai default: 1.

Selain parameter permintaan khusus operasi di atas, Anda harus menentukan parameter permintaan umum saat memanggil operasi ini. Untuk informasi selengkapnya, lihat Common request parameters.

Parameter respons

Parameter	Type	Example	Description
Code	String	iot.system.SystemException	Kode kesalahan yang dikembalikan jika pemanggilan gagal. Untuk informasi selengkapnya, lihat Error codes.
CurrentPage	Integer	1	Nomor halaman yang dikembalikan.
Data	Array of FileSummary		Informasi daftar file yang dikembalikan jika pemanggilan berhasil.
FileSummary
FileId	String	xL0G67MBLBDtkR7GCfT******	ID setiap file. ID tersebut merupakan pengidentifikasi unik untuk file tersebut.
Name	String	testFile2.txt	Nama file tersebut.
Size	String	1024000	Ukuran file. Satuan: KB.
UtcCreatedOn	String	2019-03-21T08:45:42.000Z	Waktu saat file dibuat.
ErrorMessage	String	A system exception occurred.	Pesan error yang dikembalikan jika panggilan gagal.
PageCount	Integer	1	Jumlah total halaman.
PageSize	Integer	10	Jumlah entri yang dikembalikan per halaman.
RequestId	String	E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565	ID permintaan.
Success	Boolean	true	Menunjukkan apakah panggilan berhasil atau tidak. true: Panggilan berhasil. false: Panggilan gagal.
Total	Integer	2	Jumlah total file.

Contoh

Contoh permintaan

https://iot.cn-shanghai.aliyuncs.com/?Action=QueryDeviceFileList
&ProductKey=a1BwAGV****
&DeviceName=deviceName1
&PageSize=10
&CurrentPage=1
&<Common request parameters>

Contoh respons sukses

XML format

<QueryDeviceFileListResponse>
  <PageCount>1</PageCount>
  <Data>
        <FileStoreSummary>
              <Name>testFile2.txt</Name>
              <FileId>xL0G67MBLBDtkR7GCfT******</FileId>
              <UtcCreatedOn>2019-03-21T08:45:42.000Z</UtcCreatedOn>
              <Size>102400</Size>
        </FileStoreSummary>
        <FileStoreSummary>
              <Name>testFile3.txt</Name>
              <FileId>6UCo1SqbqnQEoh9aKqD******</FileId>
              <UtcCreatedOn>2019-03-21T08:45:42.000Z</UtcCreatedOn>
              <Size>102400</Size>
        </FileStoreSummary>
        <FileStoreSummary>
              <Name>testFile1.txt</Name>
              <FileId>IhXXww3Eeu6uzSOSCyu******</FileId>
              <UtcCreatedOn>2019-03-21T08:45:40.000Z</UtcCreatedOn>
              <Size>102400</Size>
        </FileStoreSummary>
  </Data>
  <PageSize>10</PageSize>
  <RequestId>7C7BA526-826D-46AA-A45E-55D21E6D1583</RequestId>
  <CurrentPage>1</CurrentPage>
  <Success>true</Success>
  <Total>3</Total>
</QueryDeviceFileListResponse>

JSON format

{
  "PageCount": 1, 
  "Data": {
    "FileStoreSummary": [
      {
        "Name": "testFile2.txt", 
        "FileId": "xL0G67MBLBDtkR7GCfT******", 
        "UtcCreatedOn": "2019-03-21T08:45:42.000Z", 
        "Size": "102400"
      }, 
      {
        "Name": "testFile3.txt", 
        "FileId": "6UCo1SqbqnQEoh9aKqD******", 
        "UtcCreatedOn": "2019-03-21T08:45:42.000Z", 
        "Size": "102400"
      }, 
      {
        "Name": "testFile1.txt", 
        "FileId": "IhXXww3Eeu6uzSOSCyu******", 
        "UtcCreatedOn": "2019-03-21T08:45:40.000Z", 
        "Size": "102400"
      }
    ]
  }, 
  "PageSize": 10, 
  "RequestId": "7C7BA526-826D-46AA-A45E-55D21E6D1583", 
  "CurrentPage": 1, 
  "Success": true, 
  "Total": 3
}

Kode kesalahan

Untuk daftar kode kesalahan, kunjungi API Error Center.