QueryDeviceOriginalPropertyStatus - IoT Platform - Centre de documentation Alibaba Cloud

Limites

Chaque compte Alibaba Cloud peut exécuter un maximum de 50 requêtes par seconde (QPS).

Remarque

Les utilisateurs Resource Access Management (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'utiliser OpenAPI Explorer pour appeler cette opération. OpenAPI Explorer génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

Parameter	Type	Required	Example	Description
Action	String	Yes	QueryDeviceOriginalPropertyStatus	Opération à effectuer. Définissez la valeur sur QueryDeviceOriginalPropertyStatus.
Asc	Integer	Yes	0	Ordre de tri des données de propriété. Valeurs valides : 0 : ordre chronologique inverse. 1 : ordre chronologique.
PageSize	Integer	Yes	10	Nombre d'entrées à renvoyer par page. Valeurs valides : 1 à 50.
IotInstanceId	String	No	iot_instc_pu***_c-v64********	ID de l'instance. Vous pouvez consulter l'ID de l'instance sur la page Overview de la console IoT Platform. Important Si votre instance possède un ID, vous devez configurer ce paramètre. À défaut, l'appel échoue. Si votre instance ne possède pas de page Overview ou d'ID, il n'est pas nécessaire de définir ce paramètre. Pour plus d'informations, consultez Overview.
ProductKey	String	No	a1BwAGV****	ProductKey du produit auquel appartient l'appareil. Remarque Si vous spécifiez ce paramètre, vous devez également spécifier le paramètre DeviceName.
DeviceName	String	No	light	Nom de l'appareil. Remarque Si vous spécifiez ce paramètre, vous devez également spécifier le paramètre ProductKey.
NextPageToken	String	No	Bo***x44Qx	Jeton pour la page suivante. Si une page suivante existe, incluez cette valeur dans la requête suivante.
IotId	String	No	Q7uOhVRdZRRlDnTLv****00100	Identifiant unique de l'appareil, généré par IoT Platform. Remarque Si vous spécifiez ce paramètre, il n'est pas nécessaire de spécifier les paramètres ProductKey ou DeviceName. Le paramètre IotId spécifie un identifiant unique pour l'appareil et correspond à une combinaison des paramètres ProductKey et DeviceName. Si vous spécifiez simultanément le paramètre IotId et la combinaison des paramètres ProductKey et DeviceName, le paramètre IotId est prioritaire.

En plus des paramètres de requête spécifiques à l'opération, vous devez spécifier les paramètres de requête communs lors de l'appel de cette opération. Pour plus d'informations, consultez Common request parameters.

Paramètres de réponse

Parameter	Type	Example	Description
Code	String	iot.common.InvalidPageParams	Code d'erreur renvoyé en cas d'échec. Pour plus d'informations, consultez les codes d'erreur.
Data	Struct		Données renvoyées en cas de succès. Pour plus d'informations, consultez les paramètres du paramètre List.
List	Array of PropertyStatusDataInfo		Tableau des informations de propriété. Les informations relatives à chaque propriété sont indiquées par le paramètre PropertyStatusInfo.
PropertyStatusDataInfo
Identifier	String	Temperture	Identifiant de la propriété.
Time	Long	1517553572362	Heure de la dernière modification de la propriété, en millisecondes.
Value	String	26	Valeur de la propriété.
NextPageToken	String	Bo***x44Qx	Jeton pour la page suivante.
NextValid	Boolean	true	Indique si la page suivante existe. true : La page suivante existe. false : La page suivante n'existe pas. Si la valeur true est renvoyée, incluez la valeur du paramètre NextPageToken dans la requête suivante pour récupérer les données restantes.
ErrorMessage	String	A system exception has occurred.	Message d'erreur renvoyé en cas d'échec.
RequestId	String	E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565	ID de la requête.
Success	Boolean	true	Indique si l'appel a réussi. true : L'appel a réussi. false : L'appel a échoué.

Exemples

Exemples de requêtes

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

Exemples de réponses réussies

Format 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>

Format 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
}

Codes d'erreur

Pour obtenir la liste des codes d'erreur, visitez le API Error Center.