QueryDevicesHotStorageDataStatus - IoT Platform - Centro de documentación de Alibaba Cloud

Consulta datos de instantáneas del 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 lectura por segundo del 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

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, le recomendamos invocar esta operación desde OpenAPI Explorer.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	QueryDevicesHotStorageDataStatus	La operación que desea ejecutar. Establezca el valor en QueryDevicesHotStorageDataStatus.
Asc	Integer	Sí	0	El orden de clasificación de los registros de datos devueltos. Valores válidos: 0: orden cronológico inverso. 1: orden cronológico.
IotInstanceId	String	Sí	iot-2w****	El ID de la instancia. Consulte el ID de la instancia en la página descripción general de la consola de IoT Platform.
PageSize	Integer	Sí	10	El número de entradas por página. Valores válidos: de 1 a 50.
UserTopic	String	Sí	user/a/b	El nombre del tema personalizado al que pertenecen los datos que desea consultar. Especifique los demás niveles requeridos por el tema personalizado después del nivel `user`. Para obtener más información, consulte Uso de temas personalizados.
ProductKey	String	No	a1BwAGV****	La clave ProductKey del producto al que pertenece el dispositivo. Importante Si especifica este parámetro, también debe especificar DeviceName.
DeviceName	String	No	device1	El DeviceName del dispositivo. Importante Si especifica este parámetro, también debe especificar ProductKey.
NextPageToken	String	No	Bo***x44Qx	El token para la siguiente página de resultados. No es necesario especificar este parámetro en la primera solicitud. Para solicitudes posteriores, establezca este parámetro con el valor NextPageToken devuelto en la respuesta anterior.
IotId	String	No	y4u2weAI****HMle1234	El 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.

Además de los parámetros de solicitud específicos de la operación mencionados anteriormente, debe especificar los parámetros de solicitud comunes al invocar 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	El código de error devuelto si la solicitud falló. Para obtener más información, consulte la sección Códigos de error de este tema.
Data	Struct		Los datos devueltos si la solicitud se completó correctamente.
List	Array of PropertyStatusDataInfo		Las instantáneas consultadas.
PropertyStatusDataInfo
Identifier	String	Temperture	El identificador del campo.
Time	Long	1517553572362	La marca de tiempo del valor del campo. El valor es una marca de tiempo UNIX en milisegundos.
Value	String	22	El valor del campo.
NextPageToken	String	Bo***x44Qx	Un token de paginación. Úselo en la siguiente solicitud para recuperar una nueva página de resultados.
NextValid	Boolean	true	Indica si existe la siguiente página. Valores válidos: true false Si se devuelve true, use el valor NextPageToken devuelto en la siguiente solicitud para recuperar los resultados restantes.
ErrorMessage	String	A system exception occurred.	El mensaje de error devuelto si la solicitud falló.
RequestId	String	E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565	El ID de la solicitud.
Success	Boolean	true	Indica si la solicitud se completó correctamente. Valores válidos: true false

Ejemplos

Solicitudes de ejemplo

http(s)://iot.cn-shanghai.aliyuncs.com/?Action=QueryDevicesHotStorageDataStatus
&Asc=0
&IotInstanceId=iot-2w****
&PageSize=10
&UserTopic=user/a***/b***
$ProductKey=a1BwAGV****
$DeviceName=device1
&<Common request parameters>

Respuestas exitosas de ejemplo

XML formato

<QueryDevicesHotStorageDataStatusResponse>
  <RequestId>E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565</RequestId>
  <Data>
        <NextValid>true</NextValid>
        <NextPageToken>Bo***x44Qx</NextPageToken>
        <List>
              <PropertyStatusDataInfo>
                    <Identifier>Temperture</Identifier>
                    <Value>22</Value>
                    <Time>1517553572362</Time>
              </PropertyStatusDataInfo>
        </List>
  </Data>
  <Success>true</Success>
</QueryDevicesHotStorageDataStatusResponse>

JSON formato

{
    "RequestId": "E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565",
    "Data": {
        "NextValid": true,
        "NextPageToken": "Bo***x44Qx",
        "List": {
            "PropertyStatusDataInfo": [{
                "Identifier": "Temperture",
                "Value": 22,
                "Time": 1517553572362
            }]
        }
    },
    "Success": true
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	iot.device.PageTokenIsIllegal	The paging token is invalid.	El valor de NextPageToken no es válido.
400	iot.prod.NotExistedProduct	The specified product does not exist.	El producto especificado no existe.
400	iot.device.InvalidTimeBucket	The specified time range is invalid.	El intervalo de tiempo especificado no es válido.
400	iot.common.InvalidPageParams	The specified pagination size or pagination parameter is invalid.	El tamaño de página o el número de página especificado no es válido.
400	iot.prod.NullProductKey	The ProductKey parameter cannot be empty.	No se especificó ProductKey.
400	Iot.Device.NotExistedDevice	The device does not exist.	El dispositivo no existe o no está activado.
400	iot.device.InvalidFormattedDeviceName	The DeviceName format is invalid.	El formato de DeviceName no es válido.
400	iot.prod.InvalidFormattedProductkey	The ProductKey format is invalid.	El formato de ProductKey no es válido.
400	iot.system.IllegalRequest	The request parameter is invalid.	Uno o más parámetros de la solicitud no son válidos.
400	iot.device.InvalidIoTId	The specified device ID is invalid.	El ID del dispositivo no es válido.
400	iot.device.NullDeviceName	The DeviceName parameter cannot be empty.	No se especificó DeviceName.
400	iot.storage.HotStorageIopsReadNotEnough	The timeline storage read IOPS is not enough.	Los IOPS de lectura del almacenamiento de datos de series temporales son insuficientes.

Para obtener una lista de códigos de error, consulte Códigos de error del servicio.