Escribe datos de temas personalizados desde dispositivos hacia el almacenamiento de datos de series temporales.
Notas de uso
Esta operación solo está disponible para instancias de las ediciones Standard y Exclusive Enterprise Edition.
Límites
El throughput de escritura por segundo para el almacenamiento de datos de series temporales depende del valor de Time-series Data Storage IOPS especificado al adquirir la instancia Enterprise Edition. Para obtener más información, consulte Adquirir instancias Enterprise Edition.
Depuración
Parámetros de solicitud
|
Parámetro |
Tipo |
Obligatorio |
Ejemplo |
Descripción |
|
Action |
String |
Sí |
WriteDevicesHotStorageData |
La operación que desea ejecutar. Establezca el valor en WriteDevicesHotStorageData. |
|
IotInstanceId |
String |
Sí |
iot-2w**** |
ID de la instancia. Consulte el ID de la instancia en la página Overview de la consola de IoT Platform. |
|
Items |
String |
Sí |
{ "Power": { "value": "on", "time": 1524448722000 }, "WF": { "value": 23.6, "time": 1524448722000 } } |
Datos que se escribirán, especificados como un objeto JSON.
|
|
UserTopic |
String |
Sí |
user/a/b |
Nombre del tema personalizado. Especifique niveles adicionales después del nivel Para obtener más información, consulte Uso de temas personalizados. |
|
ProductKey |
String |
No |
a1BwAGV**** |
ProductKey del producto al que pertenece el dispositivo. Importante
Si especifica este parámetro, también debe especificar DeviceName. |
|
DeviceName |
String |
No |
device1 |
DeviceName del dispositivo. Importante
Si especifica este parámetro, también debe especificar ProductKey. |
|
IotId |
String |
No |
y4u2weAI****HMle1234 |
ID del dispositivo. Importante
IotId especifica un GUID para el dispositivo. El valor de IotId equivale a la combinación de los valores de ProductKey y DeviceName. Si especifica este parámetro, no necesita especificar ProductKey ni DeviceName. Si especifica IotId, ProductKey y DeviceName, el valor de IotId tiene prioridad. |
También debe especificar los parámetros de solicitud comunes al llamar a esta operación. Para obtener más información, consulte Parámetros comunes.
Parámetros de respuesta
|
Parámetro |
Tipo |
Ejemplo |
Descripción |
|
Code |
String |
iot.system.SystemException |
Código de error devuelto si la solicitud falla. Para obtener más información, consulte la sección Códigos de error de este tema. |
|
ErrorMessage |
String |
A system exception occurred. |
Mensaje de error devuelto si la solicitud falla. |
|
RequestId |
String |
E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565 |
ID de la solicitud. |
|
Success |
Boolean |
true |
Indica si la solicitud se realizó correctamente. Valores válidos:
|
Ejemplos
Solicitudes de ejemplo
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>Respuestas exitosas de ejemplo
Formato XML
<WriteDevicesHotStorageDataResponse>
<RequestId>E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565</RequestId>
<Success>true</Success>
</WriteDevicesHotStorageDataResponse>Formato JSON
{
"RequestId": "E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565",
"Success": true
}Códigos de error
|
Código de estado HTTP |
Código de error |
Mensaje de error |
Descripción |
|
400 |
iot.device.InvalidFormattedDeviceName |
The DeviceName format is invalid. |
El formato de DeviceName no es válido. |
|
400 |
iot.device.NullDeviceName |
The DeviceName parameter cannot be empty. |
No se especificó DeviceName. |
|
400 |
iot.device.SetDevicePropertyFailed |
An error occurred while setting the device properties. |
El sistema no pudo configurar las propiedades del dispositivo. |
|
400 |
iot.prod.InvalidFormattedProductkey |
The ProductKey format is invalid. |
El formato de ProductKey no es válido. |
|
400 |
iot.prod.NotExistedProduct |
The specified product does not exist. |
El producto especificado no existe. |
|
400 |
iot.prod.NullProductKey |
The ProductKey parameter cannot be empty. |
No se especificó ProductKey. |
|
400 |
iot.check.InvalidFormattedParameter |
The parameter format is invalid. |
Los formatos de uno o más parámetros no son válidos. |
|
400 |
iot.messagebroker.HALFCONN |
The specified operation has failed. The device is in an inactive status. |
No se detectó el latido mientras el dispositivo estaba inactivo. |
|
400 |
iot.messagebroker.OFFLINE |
The specified operation has failed. The device is offline. |
El sistema no pudo conectar el dispositivo a IoT Platform porque estaba desconectado. |
|
400 |
iot.prod.QueryProductAbilitiesFailed |
An error occurred while querying the product features. |
El sistema no pudo obtener las funciones del producto. |
|
400 |
iot.system.IllegalRequest |
The request parameter is invalid. |
Uno o más parámetros de la solicitud no son válidos. |
|
400 |
iot.dataalgo.ScriptMethodNotFound |
Method is not found in script. |
El método no existe en el script. |
|
400 |
iot.dataalgo.ScriptExecutionTimeout |
Script execution timeout. |
Ocurrió un error de tiempo de espera durante la ejecución del script. |
|
400 |
iot.dataalgo.ScriptExecutionOomException |
Script execution is out of memory. |
Se excedió el límite de uso de memoria durante la ejecución del script. |
|
400 |
Iot.Device.NotExistedDevice |
The device does not exist. |
El dispositivo no existe o no está activado. |
|
400 |
iot.device.InvalidIoTId |
The specified device ID is invalid. |
El ID del dispositivo no es válido. |
|
400 |
iot.dataalgo.ScriptExecutionException |
Script execution exception. |
Ocurrió una excepción durante la ejecución del script. |
|
400 |
iot.prod.QueryPropertyNotFound |
Query property not found. |
Las propiedades consultadas no existen. |
|
400 |
iot.dataalgo.ScriptDataFormatException |
Script function result format is incorrect. |
El formato del script no es válido. |
|
400 |
iot.dataalgo.ScriptRelationNotExist |
Script relation not exist. |
La relación del script no existe. |
|
400 |
iot.tsl.TslParseError |
TSLlParseError: %s. |
Ocurrió el error de análisis de Thing Specification Language (TSL) %s. |
|
400 |
iot.tsl.InvalidFormattedTslError |
The TSL format is invalid. |
El formato de los datos TSL no es válido. |
|
400 |
iot.tsl.InvalidHistoryTimestampError |
The history timestamp is invalid. |
La marca de tiempo especificada no es válida. |
|
400 |
iot.storage.HotStorageCapacityNotEnough |
The timeline storage capacity not enough. |
La capacidad del almacenamiento de datos de series temporales es insuficiente. |
|
400 |
iot.storage.HotStorageIopsWriteNotEnough |
The timeline storage write IOPS is not enough. |
Los IOPS de escritura del almacenamiento de datos de series temporales son insuficientes. |
Para consultar una lista de códigos de error, visite Códigos de error del servicio.