QueryDeviceStatistics - IoT Platform - Alibaba Cloud Documentation Center

Menampilkan statistik perangkat, termasuk jumlah perangkat online, jumlah perangkat yang diaktifkan, dan jumlah total perangkat yang dibuat.

Batasan

Setiap Akun Alibaba Cloud dapat menjalankan maksimal 50 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 ini untuk berbagai SDK.

Parameter permintaan

Parameter	Type	Wajib	Contoh	Deskripsi
Action	String	Ya	QueryDeviceStatistics	Operasi yang ingin Anda lakukan. Tetapkan nilai ke QueryDeviceStatistics.
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 mengonfigurasi parameter ini. Jika Anda tidak mengatur parameter ini, pemanggilan akan gagal. Jika instans Anda tidak memiliki halaman Overview atau ID, Anda tidak perlu mengatur parameter ini. Untuk informasi selengkapnya, lihat Overview.
ProductKey	String	Tidak	a1BwAGV****	KunciProduk dari Produk tempat Perangkat tersebut berada. Jika Anda menentukan parameter ini, statistik Perangkat di bawah Produk tersebut akan dikembalikan. Jika Anda juga menentukan GroupId, statistik Perangkat yang dibuat di bawah Produk tersebut dan ditambahkan ke kelompok akan dikembalikan. Jika Anda tidak menentukan parameter ini maupun GroupId, statistik semua Perangkat dalam akun saat ini akan dikembalikan.
GroupId	String	Tidak	W16X8Tvdosec****	ID kelompok tempat perangkat tersebut berada. Jika Anda menentukan parameter ini, statistik perangkat yang ditambahkan ke kelompok tersebut akan dikembalikan. Jika Anda juga menentukan ProductKey, statistik perangkat yang dibuat di bawah produk tersebut dan ditambahkan ke kelompok tersebut akan dikembalikan. Jika Anda tidak menentukan parameter ini maupun ProductKey, statistik semua perangkat dalam akun saat ini akan dikembalikan.

Selain parameter permintaan spesifik operasi di atas, Anda harus menentukan parameter permintaan umum saat memanggil operasi ini. Untuk informasi selengkapnya, lihat Parameter permintaan umum.

Parameter respons

Parameter	Type	Contoh	Deskripsi
Code	String	iot.system.SystemException	Kode kesalahan yang dikembalikan jika panggilan gagal. Untuk informasi selengkapnya, lihat Error codes.
Data	Struct		Statistik perangkat yang dikembalikan jika panggilan berhasil.
activeCount	Long	10	Jumlah perangkat yang diaktifkan.
deviceCount	Long	100	Jumlah total perangkat.
onlineCount	Long	10	Jumlah perangkat online.
ErrorMessage	String	A system exception occurred.	Pesan error yang dikembalikan jika panggilan gagal.
RequestId	String	E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565	ID dari permintaan tersebut.
Success	Boolean	true	Menunjukkan apakah panggilan berhasil atau tidak. true: Panggilan berhasil. false: Panggilan gagal.

Contoh

Permintaan contoh

https://iot.cn-shanghai.aliyuncs.com/?Action=QueryDeviceStatistics
&ProductKey=a1BwAGV****
&<Common request parameters>

Respons sukses contoh

XML format

<QueryDeviceStatisticsResponse>
  <Data>
        <deviceCount>2</deviceCount>
        <activeCount>2</activeCount>
        <onlineCount>0</onlineCount>
  </Data>
  <RequestId>8AC026D2-6F16-4719-A396-969D63DCA138</RequestId>
  <Success>true</Success>
</QueryDeviceStatisticsResponse>

JSON format

{
    "Data": {
        "deviceCount": 2,
        "activeCount": 2,
        "onlineCount": 0
    },
    "RequestId": "8AC026D2-6F16-4719-A396-969D63DCA138",
    "Success": true
}

Kode kesalahan

Untuk daftar kode kesalahan, kunjungi API Error Center.