Queries the period of time for which the video files of specified IP cameras can be stored in IoT Platform.


OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String No QueryDeviceRecordLifeCycle

The operation that you want to perform. Set the value to QueryDeviceRecordLifeCycle.

DeviceList.N RepeatList Yes ["C47T6xwp6ms4bNlkHRWCg4****", "d7XmBoJhAr88C6PelXDF00****"]

The IDs of the IP cameras. IoT Platform allocates an ID to each IP camera to uniquely identify the IP camera.

You can call the QueryDeviceDetail operation of IoT Platform to query the ID of the IP camera.

In addition to the preceding operation-specific request parameters, you must configure common request parameters when you call this operation. For more information about common request parameters, see Common parameters.

Response parameters

Parameter Type Example Description
Code Integer 200

The response code.

  • 200: The call was successful.
  • Other codes: The call failed. For more information about error codes, see Error codes.
Data Array of Data

The query result.

Day Integer 7

The period of time for which the video files of the IP camera can be stored in IoT Platform.

IotId String C47T6xwp6ms4bNlkHRWCg4****

The ID of the IP camera.

ErrorMessage String InvalidParameters

The error message returned if the call fails.

RequestId String 06DC77A0-4622-42DB-9EE0-25FIOHS82JK1

The ID of the request.

Success Boolean true

Indicates whether the call was successful.

  • true: The call was successful.
  • false: The call failed.


Sample requests

&DeviceList.2=["C47T6xwp6ms4bNlkHRWCg4****", "d7XmBoJhAr88C6PelXDF00****"]
&<Common request parameters>

Sample success responses

XML format


JSON format

    "RequestId": "06DC77A0-4622-42DB-9EE0-25FIOHS82JK1",
    "Data": {
        "IotId": "C47T6xwp6ms4bNlkHRWCg4****",
        "Day": 7
    "ErrorMessage": "InvalidParameters",
    "Code": 200,
    "Success": true

Error codes

For a list of error codes, see Service error codes.