QueryDeviceOriginalPropertyData - IoT Platform - Centre de documentation Alibaba Cloud

Notes d'utilisation

Vous ne pouvez interroger que les enregistrements de propriétés générés au cours des 30 derniers jours.

Remarque

Les données d'une propriété sont stockées à compter du jour de leur génération.

Limites de QPS

Vous pouvez appeler cette opération jusqu'à 50 fois par seconde par compte.

Remarque

Les utilisateurs RAM d'un compte Alibaba Cloud partagent le quota de ce compte.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. OpenAPI Explorer génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

Paramètre	Type	Obligatoire	Exemple	Description
Action	String	Oui	QueryDeviceOriginalPropertyData	L'opération à effectuer. Définissez la valeur sur QueryDeviceOriginalPropertyData.
Asc	Integer	Oui	0	L'ordre de tri des enregistrements de propriétés renvoyés. Valeurs possibles : 0 : ordre décroissant. 1 : ordre croissant. Remarque L'heure de début doit être antérieure à l'heure de fin. Le système trie les enregistrements renvoyés selon l'ordre spécifié.
EndTime	Long	Oui	1579249499000	La fin de la plage de temps à interroger. La valeur doit être un horodatage de 13 chiffres.
Identifier	String	Oui	temperature	L'identifiant de la propriété. Si une vérification faible est utilisée, vous pouvez consulter l'identifiant d'une propriété d'appareil dans l'onglet Définir une fonctionnalité de la page Détails du produit dans la console IoT Platform. Vous pouvez également appeler l'opération QueryThingModel pour afficher l'identifiant de la propriété dans les données TSL renvoyées. Si aucune vérification n'est utilisée, la valeur doit correspondre à l'identifiant personnalisé soumis par l'appareil.
PageSize	Integer	Oui	10	Le nombre maximal d'enregistrements à renvoyer pour chaque propriété. Valeur maximale : 100. Le nombre d'enregistrements renvoyés pour une seule propriété ne peut pas dépasser cette limite.
StartTime	Long	Oui	1569249488000	Le début de la plage de temps à interroger. La valeur doit être un horodatage de 13 chiffres.
IotInstanceId	String	Non	iot_instc_pu*_c-v64	L'ID de l'instance. Vous pouvez afficher l'ID de l'instance sur la page Aperçu de la console IoT Platform. Important Si votre instance possède un ID, vous devez spécifier ce paramètre. Sinon, l'appel échouera. Si aucune page Aperçu ni aucun ID n'est généré pour votre instance, vous n'avez pas besoin de spécifier ce paramètre. Pour plus d'informations, consultez la section Aperçu.
ProductKey	String	Non	a1BwAGV****	Le ProductKey du produit auquel l'appareil appartient. Important Si vous spécifiez une valeur pour ce paramètre, vous devez également spécifier le paramètre DeviceName.
DeviceName	String	Non	light	Le DeviceName de l'appareil. Important Si vous spécifiez une valeur pour ce paramètre, vous devez également spécifier le paramètre ProductKey.
NextPageToken	String	Non	Bo***x44Qx	Le jeton utilisé pour récupérer la page suivante des résultats de requête. Si la page suivante existe, ce paramètre est renvoyé. Incluez cette valeur dans la requête suivante pour récupérer des résultats supplémentaires.
IotId	String	Non	Q7uOhVRdZRRlDnTLv****00100	L'identifiant unique de l'appareil, émis par IoT Platform. Important Le paramètre IotId spécifie un identifiant unique pour l'appareil. La valeur du paramètre IotId équivaut à une combinaison des paramètres ProductKey et DeviceName.N. Si vous spécifiez le paramètre IotId, vous n'avez pas besoin de spécifier les paramètres ProductKey ou DeviceName.N. Si vous spécifiez les paramètres IotId, ProductKey et DeviceName.N, la valeur de IotId est prioritaire.

En plus des paramètres de requête spécifiques à l'opération mentionnés précédemment, vous devez spécifier les paramètres de requête communs lorsque vous appelez cette opération. Pour plus d'informations, consultez la section Paramètres communs.

Paramètres de réponse

Paramètre	Type	Exemple	Description
Code	String	iot.device.InvalidIoTId	Le code d'erreur renvoyé en cas d'échec de l'appel. Pour plus d'informations, consultez la section Codes d'erreur.
Data	Struct		Les enregistrements de propriétés renvoyés en cas de réussite de l'appel.
List	Array of PropertyInfo		La liste des propriétés. Chaque élément représente une propriété.
PropertyInfo
Time	String	1516541885630	L'heure de modification de la propriété.
Value	String	{\"data\":32.43}	La valeur de la propriété.
NextValid	Boolean	true	Indique si la page suivante existe. true : la page suivante existe. false : la page suivante n'existe pas. Si true est renvoyé pour NextValid, incluez la valeur de NextPageToken dans la requête suivante pour récupérer les données restantes.
nextPageToken	String	Bo***x44Qx	Le jeton utilisé pour récupérer la page suivante des résultats de requête.
ErrorMessage	String	A system exception occurred.	Le message d'erreur renvoyé en cas d'échec de l'appel.
RequestId	String	E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565	L'ID de la requête.
Success	Boolean	true	Indique si l'appel a réussi. Valeurs possibles : true : l'appel a réussi. false : l'appel a échoué.

Exemples

Exemples de requêtes

http(s)://iot.cn-shanghai.aliyuncs.com/?Action=QueryDeviceOriginalPropertyData
&Asc=0
&EndTime=1579249499000
&Identifier=temperature
&PageSize=10
&StartTime=1569249488000
&IotId=Q7uOhVRdZRRlDnTLv****00100
&<Common request parameters>

Exemples de réponses réussies

Format XML

<QueryDeviceOriginalPropertyDataResponse>
  <RequestId>DD8EE383-F007-5647-8B6B-0C52FAC3E7F2</RequestId>
  <Data>
        <NextValid>true</NextValid>
        <nextPageToken>MTcxMjc0N***********</nextPageToken>
        <List>
              <PropertyInfo>
                    <Value>{"data":31.26}</Value>
                    <Time>1712747043556</Time>
              </PropertyInfo>
              <PropertyInfo>
                    <Value>{"data":32.43}</Value>
                    <Time>1712747043108</Time>
              </PropertyInfo>
              <PropertyInfo>
                    <Value>{"data":30.58}</Value>
                    <Time>1712747042619</Time>
              </PropertyInfo>
              <PropertyInfo>
                    <Value>{"data":32.49}</Value>
                    <Time>1712747042182</Time>
              </PropertyInfo>
              <PropertyInfo>
                    <Value>{"data":30.66}</Value>
                    <Time>1712747041731</Time>
              </PropertyInfo>
        </List>
  </Data>
  <Code></Code>
  <Success>true</Success>
</QueryDeviceOriginalPropertyDataResponse>

Format JSON

{
  "RequestId": "DD8EE383-F007-5647-8B6B-0C52FAC3E7F2",
  "Data": {
    "NextValid": true,
    "nextPageToken": "MTcxMjc0N***********",
    "List": {
      "PropertyInfo": [
        {
          "Value": "{\"data\":31.26}",
          "Time": 1712747043556
        },
        {
          "Value": "{\"data\":32.43}",
          "Time": 1712747043108
        },
        {
          "Value": "{\"data\":30.58}",
          "Time": 1712747042619
        },
        {
          "Value": "{\"data\":32.49}",
          "Time": 1712747042182
        },
        {
          "Value": "{\"data\":30.66}",
          "Time": 1712747041731
        }
      ]
    }
  },
  "Code": "",
  "Success": true
}

Codes d'erreur

Pour obtenir la liste des codes d'erreur, consultez la section Codes d'erreur de service.