QueryDevicePropertiesData - IoT Platform: Central de Documentação do Alibaba Cloud

Consulta múltiplas propriedades enviadas por um dispositivo em um período especificado.

Limites

É possível consultar no máximo 10 propriedades por vez, com limite de 100 registros para cada propriedade.
A consulta abrange dados de propriedades gerados nos últimos 30 dias.

Nota
O período de retenção de um registro de propriedade é contado a partir do dia em que o registro foi gerado.
Cada conta Alibaba Cloud pode executar no máximo 10 consultas por segundo (QPS).

Nota
Os usuários RAM de uma conta Alibaba Cloud compartilham a cota dessa conta.

Observações de uso

Ao chamar esta operação para consultar registros de propriedades em um período específico, a quantidade de registros de uma propriedade em determinado momento pode atingir o limite. Esse limite é definido pelo parâmetro PageSize. Nessa situação, a consulta é interrompida e alguns registros de outras propriedades podem não ser retornados. Verifique se todos os registros de uma propriedade foram retornados por meio do parâmetro de resposta NextValid:

Se o valor do parâmetro NextValid for true, existem registros não recuperados no período indicado pelos parâmetros NextTime e EndTime.

Utilize

o valor do parâmetro de resposta

NextTime

como valor do parâmetro de solicitação StartTime e chame esta operação novamente para consultar os registros restantes. Repita a chamada quantas vezes forem necessárias até que o valor do parâmetro

NextValid

seja false.

Nota
Para recuperar todos os registros de propriedades dentro de um período especificado, defina o parâmetro

PageSize

com o valor máximo. Em seguida, chame esta operação repetidamente até que o valor do parâmetro

NextValid

seja false.
Caso o valor do parâmetro NextValid seja false, todos os registros de propriedades foram retornados.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros de solicitação

Parameter	Type	Required	Example	Description
Action	String	Yes	QueryDevicePropertiesData	A operação a ser executada. Defina o valor como QueryDevicePropertiesData.
Asc	Integer	Yes	0	A ordem de classificação dos registros de propriedade retornados. Valores válidos: 0: ordem cronológica inversa. Neste caso, o horário especificado pelo parâmetro StartTime deve ser posterior ao horário especificado pelo parâmetro EndTime. 1: ordem cronológica. Neste caso, o horário especificado pelo parâmetro StartTime deve ser anterior ao horário especificado pelo parâmetro EndTime.
DeviceName	String	Yes	airconditioning	O DeviceName do dispositivo.
EndTime	Long	Yes	1579249499000	O fim do intervalo de tempo a ser consultado. O valor é um timestamp de 13 dígitos em milissegundos, por exemplo, 1579249499000.
Identifier.N	RepeatList	Yes	temperature	Os identificadores das propriedades. Os identificadores de propriedade devem ser únicos. Visualize os identificadores de propriedade no console do IoT Platform. Acesse a aba Define Feature da página Product Details. Alternativamente, chame a operação QueryThingModel e verifique os identificadores de propriedade nos dados TSL retornados. Nota Se uma propriedade chamada temperature pertencer a um módulo personalizado chamado testFb, defina este parâmetro como testFb:temperature. O módulo personalizado não é o módulo padrão.
PageSize	Integer	Yes	10	O número máximo de registros retornado para cada propriedade. Valor máximo: 100. A quantidade de registros retornados para qualquer propriedade não pode exceder esse limite.
ProductKey	String	Yes	a1BwAGV****	O ProductKey do produto ao qual o dispositivo pertence.
StartTime	Long	Yes	1579249499000	O início do intervalo de tempo a ser consultado. O valor é um timestamp de 13 dígitos em milissegundos, por exemplo, 1579249499000.
IotInstanceId	String	No	iot_instc_pu***_c-v64********	O ID da instância. Visualize o ID da instância na página Overview no console do IoT Platform. Importante Se sua instância possuir um ID, configure este parâmetro obrigatoriamente. A chamada falhará caso ele não seja definido. Se sua instância não tiver uma página Overview ou ID, não é necessário definir este parâmetro. Para mais informações, consulte Overview.
IotId	String	No	Q7uOhVRdZRRlDnTLv****00100	O ID do dispositivo. Este ID é emitido pelo IoT Platform. Nota O parâmetro IotId é um identificador globalmente único (GUID) e corresponde à combinação dos parâmetros ProductKey e DeviceName. Se você especificar o parâmetro IotId e a combinação dos parâmetros ProductKey e DeviceName simultaneamente, o parâmetro IotId terá prioridade.

Além dos parâmetros de solicitação específicos desta operação, especifique os parâmetros de solicitação comuns ao chamá-la. Para mais informações, consulte Parâmetros de solicitação comuns.

Parâmetros de resposta

Parameter	Type	Example	Description
Code	String	iot.system.SystemException	O código de erro retornado se a chamada falhar. Para mais informações, consulte Códigos de erro.
ErrorMessage	String	A system exception occurred.	A mensagem de erro retornada se a chamada falhar.
NextTime	Long	1579249499000	O horário inicial para consulta na próxima página. Utilize o valor do parâmetro NextTime como valor do parâmetro StartTime ao consultar a próxima página de resultados.
NextValid	Boolean	true	Indica se existe uma próxima página. true: Existe uma próxima página. false: Não existe uma próxima página. Se o valor retornado do parâmetro NextValid for true, utilize o valor do parâmetro NextTime como valor do parâmetro StartTime ao consultar a próxima página de resultados.
PropertyDataInfos	Array of PropertyDataInfo		A lista de registros de propriedades retornada se a chamada for bem-sucedida. Para mais informações, consulte PropertyDataInfo.
PropertyDataInfo
Identifier	String	temperature	O identificador da propriedade.
List	Array of PropertyInfo		A lista de registros de propriedades.
PropertyInfo
Time	Long	1579249499000	O horário em que a propriedade foi enviada. O valor é um timestamp em milissegundos, como 1579249499000.
Value	String	21,3	O valor da propriedade.
RequestId	String	E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565	O ID da solicitação.
Success	Boolean	true	Indica se a chamada foi bem-sucedida. true: A chamada foi bem-sucedida. false: A chamada falhou.

Exemplos

Exemplos de solicitações

https://iot.cn-shanghai.aliyuncs.com/?Action=QueryDevicePropertiesData
&Asc=0
&DeviceName=water
&EndTime=1540115948152
&Identifier.1=Temperature
&Identifier.2=Humidity
&PageSize=100
&ProductKey=a1bd***
&StartTime=1540116010723
&<Common request parameters>

Exemplos de respostas de sucesso

XML format

<QueryDevicePropertiesData>
  <NextValid>false</NextValid>
  <RequestId>CC4CAC00-ED4C-4004-9E8D-E8B4A78552FA</RequestId>
  <PropertyDataInfos>
        <PropertyDataInfo>
              <List>
                    <PropertyInfo>
                          <Value>32.46</Value>
                          <Time>1579249151178</Time>
                    </PropertyInfo>
              </List>
              <Identifier>Temperature</Identifier>
        </PropertyDataInfo>
        <PropertyDataInfo>
              <List>
                    <PropertyInfo>
                          <Value>48</Value>
                          <Time>1579249151178</Time>
                    </PropertyInfo>
              </List>
              <Identifier>Humidity</Identifier>
        </PropertyDataInfo>
  </PropertyDataInfos>
  <Success>true</Success>
</QueryDevicePropertiesData>

Formato JSON

{
  "NextValid": false, 
  "RequestId": "CC4CAC00-ED4C-4004-9E8D-E8B4A78552FA", 
  "PropertyDataInfos": {
    "PropertyDataInfo": [
      {
        "List": {
          "PropertyInfo": [
            {
              "Value": "32.46", 
              "Time": 1579249151178
            }
          ]
        }, 
        "Identifier": "Temperature"
      }, 
      {
        "List": {
          "PropertyInfo": [
            {
              "Value": "48", 
              "Time": 1579249151178
            }
          ]
        }, 
        "Identifier": "Humidity"
      }
    ]
  }, 
  "Success": true
}

Códigos de erro

Para obter uma lista de códigos de erro, visite o API Error Center.