IoT Platform:QueryProductList

Catatan penggunaan

Jika nilai CurrentPage yang Anda tentukan lebih besar daripada nilai PageCount saat memanggil operasi QueryProductList, maka ProductInfo akan kosong. Dalam kasus ini, Anda dapat menentukan nilai baru untuk CurrentPage dan PageSize berdasarkan nilai Total yang dikembalikan, lalu memanggil kembali operasi tersebut untuk mengambil daftar produk.

Sebagai contoh, jika nilai Total yang dikembalikan adalah 20 dan nilai PageSize yang Anda tetapkan adalah 5, maka nilai PageCount yang dikembalikan adalah 4, dihitung dengan rumus: 20 ÷ 5 = 4. Jika Anda menetapkan nilai CurrentPage sebesar 1, 2, 3, atau 4, ProductInfo tidak akan kosong. Namun, jika Anda menetapkan nilai CurrentPage lebih dari 4—misalnya 5—maka ProductInfo akan kosong karena tidak ada data pada halaman tersebut.

Contoh respons sukses:

{
  "RequestId": "62F56B4D-9CBC-518A-8414-CC91BB83FD04",
  "Data": {
    "PageCount": 4,
    "PageSize": 5,
    "CurrentPage": 5,
    "Total": 20,
    "List": {
      "ProductInfo": []
    }
  },
  "Code": "",
  "Success": true
}

Batas QPS

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

  Catatan

  Pengguna RAM dari Akun Alibaba Cloud berbagi kuota akun tersebut.

• Jika hasil perkalian antara nilai CurrentPage dan PageSize lebih besar dari atau sama dengan 100.000, QPS operasi ini akan berkurang.

  Dalam kasus ini, setiap Akun Alibaba Cloud hanya dapat menjalankan maksimal 2 QPS.

Parameter permintaan

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

Parameter respons

Contoh

Contoh permintaan

https://iot.cn-shanghai.aliyuncs.com/?Action=QueryProductList
&CurrentPage=1
&PageSize=2
&ResourceGroupId=rg-acfmxazb4ph****
&<Common request parameters>

Contoh respons sukses

XML format

<QueryProductListResponse>
  <Data>
        <PageCount>92</PageCount>
        <PageSize>2</PageSize>
        <List>
              <ProductInfo>
                    <DataFormat>1</DataFormat>
                    <ProductKey>a1A0D4t****</ProductKey>
                    <NodeType>0</NodeType>
                    <ProductName>Street light</ProductName>
                    <DeviceCount>1</DeviceCount>
                    <GmtCreate>1569233025000</GmtCreate>
                    <AuthType>secret</AuthType>
              </ProductInfo>
              <ProductInfo>
                    <DataFormat>1</DataFormat>
                    <ProductKey>a1dEvuQ****</ProductKey>
                    <NodeType>0</NodeType>
                    <ProductName>Custom sub-device</ProductName>
                    <DeviceCount>0</DeviceCount>
                    <GmtCreate>1568690432000</GmtCreate>
                    <AuthType>secret</AuthType>
              </ProductInfo>
        </List>
        <CurrentPage>1</CurrentPage>
        <Total>184</Total>
  </Data>
  <RequestId>4B4ECF2C-6222-42EC-A4B5-C12202E71CEA</RequestId>
  <Success>true</Success>
</QueryProductListResponse>

JSON format

{
  "Data": {
    "PageCount": 92, 
    "PageSize": 2, 
    "List": {
      "ProductInfo": [
        {
          "DataFormat": 1, 
          "ProductKey": "a1A0D4t****", 
          "NodeType": 0, 
          "ProductName": "Street light", 
          "DeviceCount": 1, 
          "GmtCreate": 1569233025000, 
          "AuthType": "secret"
        }, 
        {
          "DataFormat": 1, 
          "ProductKey": "a1dEvuQ****", 
          "NodeType": 0, 
          "ProductName": "Custom sub-device", 
          "DeviceCount": 0, 
          "GmtCreate": 1568690432000,
          "AuthType": "secret"
        }
      ]
    }, 
    "CurrentPage": 1, 
    "Total": 184
  }, 
  "RequestId": "4B4ECF2C-6222-42EC-A4B5-C12202E71CEA", 
  "Success": true
}

Kode kesalahan

Untuk daftar kode kesalahan, lihat Service error codes.