WriteDevicesHotStorageData - IoT Platform - Centre de documentation Alibaba Cloud

Notes d'utilisation

Cette opération est disponible uniquement pour les instances Enterprise Edition Standard et Exclusive.

Limites

Le débit d'écriture par seconde du stockage de données de séries temporelles dépend de la valeur Time-series Data Storage IOPS spécifiée lors de l'achat de l'instance Enterprise Edition. Pour plus d'informations, consultez les rubriques Acheter des instances Enterprise Edition.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Par commodité, nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. OpenAPI Explorer génère dynamiquement l'exemple de code de l'opération pour différents SDK.

Paramètres de requête

Paramètre	Type	Obligatoire	Exemple	Description
Action	String	Oui	WriteDevicesHotStorageData	Opération à effectuer. Définissez la valeur sur WriteDevicesHotStorageData.
IotInstanceId	String	Oui	iot-2w****	ID de l'instance. Vous pouvez afficher l'ID d'instance sur la page Aperçu de la console IoT Platform.
Items	String	Oui	{ "Power": { "value": "on", "time": 1524448722000 }, "WF": { "value": 23.6, "time": 1524448722000 } }	Données à écrire, spécifiées sous forme d'objet JSON. `{ "key1": { "value":xxx1 "time":yyy1 }, "key2": { "value":xxx2 "time":yyy2 } }` key1 et key2 : identifiants de champ. La valeur de Items peut contenir plusieurs champs. value : valeur du champ. Les types de données suivants sont pris en charge : INT32, FLOAT, DOUBLE, TEXT, DATE, BOOLEAN, ENUM, STRUCT et ARRAY. Pour plus d'informations, consultez la rubrique Types de données pris en charge. time : horodatage de la valeur de champ. Spécifiez un horodatage UNIX représentant le nombre de millisecondes écoulées depuis le 1er janvier 1970, 00:00:00 UTC.
UserTopic	String	Oui	user/a/b	Nom de la rubrique personnalisée. Ajoutez des niveaux supplémentaires après le niveau `user` selon vos besoins. Pour plus d'informations, consultez la rubrique Utiliser des rubriques personnalisées.
ProductKey	String	Non	a1BwAGV****	ProductKey du produit auquel appartient l'appareil. Important Si vous spécifiez ce paramètre, vous devez également spécifier DeviceName.
DeviceName	String	Non	device1	DeviceName de l'appareil. Important Si vous spécifiez ce paramètre, vous devez également spécifier ProductKey.
IotId	String	Non	y4u2weAI****HMle1234	ID de l'appareil. Important IotId spécifie un GUID pour l'appareil. La valeur de IotId équivaut à la combinaison des valeurs de ProductKey et de DeviceName. Si vous spécifiez ce paramètre, il n'est pas nécessaire de spécifier ProductKey ou DeviceName. Si vous spécifiez IotId, ProductKey et DeviceName, la valeur de IotId est prioritaire.

Vous devez également spécifier les paramètres de requête communs lorsque vous appelez cette opération. Pour plus d'informations, consultez la rubrique Paramètres communs.

Paramètres de réponse

Paramètre	Type	Exemple	Description
Code	String	iot.system.SystemException	Code d'erreur renvoyé si la requête échoue. Pour plus d'informations, consultez la section Codes d'erreur de cette rubrique.
ErrorMessage	String	A system exception occurred.	Message d'erreur renvoyé si la requête échoue.
RequestId	String	E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565	ID de la requête.
Success	Boolean	true	Indique si la requête a abouti. Valeurs possibles : true false

Exemples

Exemple de requête

http(s)://iot.cn-shanghai.aliyuncs.com/?Action=WriteDevicesHotStorageData
&IotInstanceId=iot-2w****
&Items={ "Power": { "value": "on", "time": 1524448722000 }, "WF": { "value": 23.6, "time": 1524448722000 } }
&UserTopic=user/a***/b***
$ProductKey=a1BwAGV****
$DeviceName=device1
&<Common request parameters>

Exemple de réponse réussie

XML format

<WriteDevicesHotStorageDataResponse>
  <RequestId>E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565</RequestId>
  <Success>true</Success>
</WriteDevicesHotStorageDataResponse>

JSON format

{
    "RequestId": "E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565",
    "Success": true
}

Codes d'erreur

Code d'état HTTP	Code d'erreur	Message d'erreur	Description
400	iot.device.InvalidFormattedDeviceName	The DeviceName format is invalid.	Le format de DeviceName n'est pas valide.
400	iot.device.NullDeviceName	The DeviceName parameter cannot be empty.	DeviceName n'est pas spécifié.
400	iot.device.SetDevicePropertyFailed	An error occurred while setting the device properties.	Échec de la configuration des propriétés de l'appareil.
400	iot.prod.InvalidFormattedProductkey	The ProductKey format is invalid.	Le format de ProductKey n'est pas valide.
400	iot.prod.NotExistedProduct	The specified product does not exist.	Le produit spécifié n'existe pas.
400	iot.prod.NullProductKey	The ProductKey parameter cannot be empty.	ProductKey n'est pas spécifié.
400	iot.check.InvalidFormattedParameter	The parameter format is invalid.	Le format d'un ou de plusieurs paramètres n'est pas valide.
400	iot.messagebroker.HALFCONN	The specified operation has failed. The device is in an inactive status.	Échec de la détection du signal de présence lorsque l'appareil est inactif.
400	iot.messagebroker.OFFLINE	The specified operation has failed. The device is offline.	Échec de la connexion de l'appareil à IoT Platform lorsque l'appareil est hors ligne.
400	iot.prod.QueryProductAbilitiesFailed	An error occurred while querying the product features.	Échec de l'obtention des fonctionnalités du produit.
400	iot.system.IllegalRequest	The request parameter is invalid.	Un ou plusieurs paramètres de requête ne sont pas valides.
400	iot.dataalgo.ScriptMethodNotFound	Method is not found in script.	La méthode n'existe pas dans le script.
400	iot.dataalgo.ScriptExecutionTimeout	Script execution timeout.	Une erreur de délai d'attente s'est produite lors de l'exécution du script.
400	iot.dataalgo.ScriptExecutionOomException	Script execution is out of memory.	La limite d'utilisation de la mémoire est dépassée lors de l'exécution du script.
400	Iot.Device.NotExistedDevice	The device does not exist.	L'appareil n'existe pas ou n'est pas activé.
400	iot.device.InvalidIoTId	The specified device ID is invalid.	L'ID de l'appareil n'est pas valide.
400	iot.dataalgo.ScriptExecutionException	Script execution exception.	Une exception s'est produite lors de l'exécution du script.
400	iot.prod.QueryPropertyNotFound	Query property not found.	Les propriétés interrogées n'existent pas.
400	iot.dataalgo.ScriptDataFormatException	Script function result format is incorrect.	Le format du script n'est pas valide.
400	iot.dataalgo.ScriptRelationNotExist	Script relation not exist.	La relation de script n'existe pas.
400	iot.tsl.TslParseError	TSLlParseError: %s.	Une erreur d'analyse du langage de spécification des objets (%s) s'est produite.
400	iot.tsl.InvalidFormattedTslError	The TSL format is invalid.	Le format des données TSL n'est pas valide.
400	iot.tsl.InvalidHistoryTimestampError	The history timestamp is invalid.	L'horodatage spécifié n'est pas valide.
400	iot.storage.HotStorageCapacityNotEnough	The timeline storage capacity not enough.	La capacité de stockage de données de séries temporelles est insuffisante.
400	iot.storage.HotStorageIopsWriteNotEnough	The timeline storage write IOPS is not enough.	Les IOPS d'écriture du stockage de données de séries temporelles sont insuffisants.

Pour obtenir la liste des codes d'erreur, consultez la rubrique Codes d'erreur du service.