SearchDeviceEventHistory
Search device event history to find events that match criteria.Sensor readings, configuration changes, and other device data are all stored as events.
Authorization
thingspace_oauth VZ-M2M-Token This is the ThingSpace token, from Credentials and Tokens is used
In: header
M2M Session Token (How to generate an M2M session token?)
In: header
Request Body
application/json
The device identifier and fields to match in the search.
The device identifier and fields to match in the search.
The ID of the authenticating billing account, in the format {"billingaccountid":"1234567890-12345"}.
A comma-separated list of properties and comparator values to match against subscriptions in the ThingSpace account. See Working with Query Filters for more information. If the request does not include $selection, the response will include all subscriptions to which the requesting user has access.
The ID of the target to delete, in the format {"id": "dd1682d3-2d80-cefc-f3ee-25154800beff"}.
The maximum number of events to include in the response.
int32The maximum number of events to include in the response.
Response Body
application/json
curl -X POST "https://example.com/cc/v1/devices/fields/actions/history/search" \ -H "Content-Type: application/json" \ -d '{ "accountidentifier": { "billingaccountid": "1223334444-00001" }, "resourceidentifier": { "imei": "864508030084997" }, "$selection": { "kind": "ts.event.configuration" }, "$limitnumber": 2 }'{ "SearchDeviceEventHistory": [ { "action": "set", "createdon": "2019-02-21T02:05:25.270417481Z", "deviceid": "8461f530-2e31-6e87-e357-6c38251d4d01", "id": "e521b8ae-440d-6cc1-f687-7c80e085ff29", "kind": "ts.event.configuration", "lastupdated": "2019-02-21T02:05:25.394230017Z", "name": "SetConfigurationReq", "state": "update", "tagids": [ "4d110e4f-7a7c-6b26-eaac-31cc34c6e1d4", "cd81ed16-18ae-6c7d-eaba-2883b0395387" ], "transactionid": "c7a0a8cf-6856-4733-93ea-69913650e4ca", "version": "1.0", "versionid": "270e4820-357d-11e9-9d6c-02420a470c06" }, { "action": "set", "createdon": "2019-02-21T01:58:45.163Z", "deviceid": "8461f530-2e31-6e87-e357-6c38251d4d01", "id": "25819e96-c4f2-6545-fb68-0e1d9662359f", "kind": "ts.event.configuration", "lastupdated": "2019-02-21T01:58:45.163Z", "state": "pending", "tagids": [ "4d110e4f-7a7c-6b26-eaac-31cc34c6e1d4", "cd81ed16-18ae-6c7d-eaba-2883b0395387" ], "transactionid": "c7a0a8cf-6856-4733-93ea-69913650e4ca", "version": "1.0", "versionid": "387fe2fe-357c-11e9-ae40-02420a49140a" } ]}SearchDevicesResourcesByPropertyValues POST
Search for devices by property values. Returns an array of all matching device resources.
SearchSensorReadings POST
Returns the readings of a specified sensor, with the most recent reading first. Sensor readings are stored as events; this request an array of events.