IoT Platform:QueryProductList

使用上の注意

QueryProductList 操作の呼び出し時に、CurrentPage に指定した値が PageCount の値よりも大きい場合、ProductInfo は空になります。この場合、Total の戻り値に基づいて CurrentPage と PageSize の新しい値を指定し、QueryProductList 操作を呼び出してプロダクトを再度クエリできます。

たとえば、Total の戻り値が 20 で、PageSize に指定した値が 5 の場合、PageCount の戻り値は 4 になります。結果は、次の式を使用して計算されます。20 / 5 = 4。CurrentPage に 1、2、3、または 4 を指定した場合、ProductInfo は空ではありません。CurrentPage に 4 より大きい値、たとえば 5 を指定した場合、5 ページ目にデータが存在しないため、ProductInfo は空になります。

正常なレスポンスの例:

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

QPS 制限

• この操作は、アカウントごとに 1 秒あたり最大 50 回呼び出すことができます。

  説明

  Alibaba Cloud アカウントの RAM ユーザーは、アカウントのクォータを共有します。

• CurrentPage の値と PageSize の値の積が 100,000 以上の場合、この操作の QPS は減少します。

  この場合、各 Alibaba Cloud アカウントは最大 2 QPS を実行できます。

リクエストパラメーター

前述の操作固有のリクエストパラメーターに加えて、この操作を呼び出すときは、共通のリクエストパラメーターを設定する必要があります。共通リクエストパラメーターの詳細については、「共通パラメーター」をご参照ください。

レスポンスパラメーター

例

リクエストの例

https://iot.cn-shanghai.aliyuncs.com/?Action=QueryProductList
&CurrentPage=1
&PageSize=2
&ResourceGroupId=rg-acfmxazb4ph****
&<共通リクエストパラメーター>

正常なレスポンスの例

XML 形式

<QueryProductListResponse>
  <Data>
        <PageCount>92</PageCount>
        <PageSize>2</PageSize>
        <List>
              <ProductInfo>
                    <DataFormat>1</DataFormat>
                    <ProductKey>a1A0D4t****</ProductKey>
                    <NodeType>0</NodeType>
                    <ProductName>街灯</ProductName>
                    <DeviceCount>1</DeviceCount>
                    <GmtCreate>1569233025000</GmtCreate>
                    <AuthType>secret</AuthType>
              </ProductInfo>
              <ProductInfo>
                    <DataFormat>1</DataFormat>
                    <ProductKey>a1dEvuQ****</ProductKey>
                    <NodeType>0</NodeType>
                    <ProductName>カスタム サブデバイス</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 形式

{
  "Data": {
    "PageCount": 92, 
    "PageSize": 2, 
    "List": {
      "ProductInfo": [
        {
          "DataFormat": 1, 
          "ProductKey": "a1A0D4t****", 
          "NodeType": 0, 
          "ProductName": "街灯", 
          "DeviceCount": 1, 
          "GmtCreate": 1569233025000, 
          "AuthType": "secret"
        }, 
        {
          "DataFormat": 1, 
          "ProductKey": "a1dEvuQ****", 
          "NodeType": 0, 
          "ProductName": "カスタム サブデバイス", 
          "DeviceCount": 0, 
          "GmtCreate": 1568690432000,
          "AuthType": "secret"
        }
      ]
    }, 
    "CurrentPage": 1, 
    "Total": 184
  }, 
  "RequestId": "4B4ECF2C-6222-42EC-A4B5-C12202E71CEA", 
  "Success": true
}

エラーコード

エラーコードのリストについては、「サービスエラーコード」をご参照ください。