Cloud Connector Devices

SearchDevicesResourcesByPropertyValues

POST
/cc/v1/devices/actions/search

Search for devices by property values. Returns an array of all matching device resources.

Authorization

thingspace_oauth VZ-M2M-Token
AuthorizationBearer <token>

This is the ThingSpace token, from Credentials and Tokens is used

In: header

VZ-M2M-Token<token>

M2M Session Token (How to generate an M2M session token?)

In: header

Request Body

application/json

The request body specifies fields and values to match.

The request body specifies fields and values to match.

accountidentifier?

The ID of the authenticating billing account, in the format {"billingaccountid":"1234567890-12345"}.

$selection?

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.

resourceidentifier?

The ID of the target to delete, in the format {"id": "dd1682d3-2d80-cefc-f3ee-25154800beff"}.

Response Body

application/json

curl -X POST "https://example.com/cc/v1/devices/actions/search" \  -H "Content-Type: application/json" \  -d '{    "accountidentifier": {      "billingaccountid": "1223334444-00001"    },    "$selection": {      "iccid": "89148000003499233389"    }  }'
{  "DeviceProperty": [    {      "billingaccountid": "1223334444-00001",      "createdon": "2018-12-19T06:45:41.496Z",      "eventretention": "90",      "iccid": "20332350053095597842",      "id": "64612cb3-3685-6dad-fd2b-ea1adeb5a269",      "imei": "320778042285497",      "kind": "ts.device",      "lastupdated": "2018-12-19T06:45:41.508Z",      "providerid": "8a314f07-849e-6568-e3c1-8381c1f61bfc",      "refid": "20332350053095597842",      "refidtype": "iccid",      "state": "registered",      "version": "1.0",      "versionid": "b3cdaddb-0359-11e9-aba2-02420a4e1b0a"    }  ]}