Cloud Connector Devices

UpdateDevicesConfigurationValue

POST
/cc/v1/devices/configuration/actions/set

Change configuration values on a device, such as setting how often a device records and reports sensor readings.

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 changes configuration values on a device.

The request body changes configuration values on a device.

accountidentifier?

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

resourceidentifier?

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

configuration?

List of the field names and values to set.

Response Body

application/json

curl -X POST "https://example.com/cc/v1/devices/configuration/actions/set" \  -H "Content-Type: application/json" \  -d '{    "accountidentifier": {      "billingaccountid": "1223334444-00001"    },    "resourceidentifier": {      "imei": "864508030147323"    },    "configuration": {      "frequency": "Low"    }  }'
{  "action": "set",  "createdon": "2019-02-14T01:41:03.619217664Z",  "deviceid": "8461f530-2e31-6e87-e357-6c38251d4d01",  "fields": {    "configuration": {      "frequency": "Low"    }  },  "foreignid": "e1f15861-7de7-69cb-ed7d-b4a92e091bc4",  "id": "05c12adc-50c0-6ebb-feb0-b9f9637a1dba",  "kind": "ts.event.configuration",  "lastupdated": "2019-02-14T01:41:03.619217727Z",  "name": "SetConfigurationReq",  "state": "pending",  "transactionid": "1d38aae7-558d-4cb9-8269-e8d4c0519045",  "version": "1.0"}