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

Limites

Cada conta Alibaba Cloud pode executar no máximo 50 consultas por segundo (QPS).

Nota

Usuários do Resource Access Management (RAM) de uma conta Alibaba Cloud compartilham a cota dessa conta.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. A ferramenta também gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	QueryDeviceOriginalPropertyStatus	Operação a executar. Defina o valor como QueryDeviceOriginalPropertyStatus.
Asc	Integer	Sim	0	Ordem de classificação dos dados de propriedade. Valores válidos: 0: ordem cronológica inversa. 1: ordem cronológica.
PageSize	Integer	Sim	10	Número de entradas retornadas em cada página. Valores válidos: 1 a 50.
IotInstanceId	String	Não	iot_instc_pu***_c-v64********	ID da instância. Visualize o ID da instância na página Overview do console IoT Platform. Importante Se a instância tiver um ID, configure este parâmetro obrigatoriamente. Caso contrário, a chamada falhará. Se a instância não tiver uma página Overview ou ID, não defina este parâmetro. Para mais informações, consulte Visão geral.
ProductKey	String	Não	a1BwAGV****	O ProductKey do produto ao qual o dispositivo pertence. Nota Ao especificar este parâmetro, especifique também o parâmetro DeviceName.
DeviceName	String	Não	light	Nome do dispositivo. Nota Ao especificar este parâmetro, especifique também o parâmetro ProductKey.
NextPageToken	String	Não	Bo***x44Qx	Token da próxima página. Se houver outra página, inclua este valor na solicitação subsequente.
IotId	String	Não	Q7uOhVRdZRRlDnTLv****00100	Identificador único do dispositivo gerado pelo IoT Platform. Nota Se você especificar este parâmetro, não precisará especificar os parâmetros ProductKey ou DeviceName. O parâmetro IotId define um identificador exclusivo para o dispositivo e corresponde à combinação dos parâmetros ProductKey e DeviceName. Se você especificar simultaneamente o parâmetro IotId e a combinação dos parâmetros ProductKey e DeviceName, o parâmetro IotId terá precedência.

Além dos parâmetros específicos da operação, especifique os parâmetros comuns de solicitação ao chamar esta API. Para mais informações, consulte Parâmetros comuns de solicitação.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
Code	String	iot.common.InvalidPageParams	Código de erro retornado em caso de falha. Para mais informações, consulte Códigos de erro.
Data	Struct		Dados retornados em caso de sucesso. Para mais detalhes, consulte os parâmetros de List.
List	Array of PropertyStatusDataInfo		Array de informações de propriedade. As informações de cada propriedade são indicadas pelo parâmetro PropertyStatusInfo.
PropertyStatusDataInfo
Identifier	String	Temperture	Identificador da propriedade.
Time	Long	1517553572362	Horário da última modificação da propriedade, em milissegundos.
Value	String	26	Valor da propriedade.
NextPageToken	String	Bo***x44Qx	Token da próxima página.
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 retorno for true, inclua o valor de NextPageToken na próxima solicitação para recuperar os dados restantes.
ErrorMessage	String	A system exception has occurred.	Mensagem de erro retornada em caso de falha.
RequestId	String	E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565	ID da solicitação.
Success	Boolean	true	Indica se a chamada foi bem-sucedida. true: Chamada bem-sucedida. false: Falha na chamada.

Exemplos

Exemplos de solicitações

http(s)://iot.cn-shanghai.aliyuncs.com/? Action=QueryDeviceOriginalPropertyStatus
&Asc=0
&PageSize=10
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

<QueryDeviceOriginalPropertyStatusResponse>
  <Data>
        <NextValid>false</NextValid>
        <nextPageToken>Bo***x44Qx</nextPageToken>
        <List>
              <PropertyStatusInfo>
                    <Value>48</Value>
                    <Time>1579249151178</Time>
                    <Identifier>Humidity</Identifier>
              </PropertyStatusInfo>
              <PropertyStatusInfo>
                    <Value>32.46</Value>
                    <Time>1579249151178</Time>
                    <Identifier>Temperature</Identifier>
              </PropertyStatusInfo>
        </List>
  </Data>
  <RequestId>84BAD25B-9879-4BA1-9213-F576C6558D77</RequestId>
  <Success>true</Success>
</QueryDeviceOriginalPropertyStatusResponse>

Formato JSON

{
    "Data": {
        "NextValid": false, 
        "nextPageToken": "Bo***x44Qx", 
        "List": {
            "PropertyStatusInfo": [
                {
                    "Value": "48",
                    "Time": "1579249151178",
                    "Identifier": "Humidity"
                },
                {
                    "Value": "32.46",
                    "Time": "1579249151178",
                    "Identifier": "Temperature"
                }
            ]
        }
    },
    "RequestId": "84BAD25B-9879-4BA1-9213-F576C6558D77",
    "Success": true
}

Códigos de erro

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