Este endpoint actualiza los campos de una Variable especificados en el cuerpo.
Solicitud HTTP
Para actualizar uno o más atributos específicos de una Variable, haz una petición PATCH a la siguiente URL:
HTTP Method | URL |
---|---|
PATCH |
|
Para actualizar uno o más atributos específicos de una Variable en un Device, haz una petición PATCH a la siguiente URL:
HTTP Method | URL |
---|---|
PATCH |
|
Parámetros de ruta
Parameter | Type | Description |
---|---|---|
| String | The id of the Variable |
Parámetros de consulta
Parameter | Type | Use | Description |
---|---|---|---|
| String | Authentication | Authentication Token can optionally be sent as a query parameter. |
Parámetros de cuerpo
Parameter | Type | Required? | Description |
---|---|---|---|
label | String | No | The API label of Variable |
name | String | No | Name of the Variable |
description | String | No | Description of Variable |
tags | String Array | No | Variable tags |
properties | Object | No | Variable properties |
icon | String | No | Icon of Variable |
unit | String | No | Unit of Variable. |
syntheticExpression | String | No | Synthetic Expression of Variable |
Cabecera
Parameter | Required? | Description |
---|---|---|
| Yes | Authentication Token of account |
$ curl -X PATCH 'https://api.netux.com/api/v2.0/variables/<variable_id>' \
-H 'Content-Type: application/json' \
-H 'X-Auth-Token: oaXBo6ODhIjPsusNRPUGIK4d72bc73' \
-d '{
"label": "variable2",
"name": "Variable 2",
"description": "my variable 2",
"tags": ["blue", "yellow"],
"properties": {},
"icon": "trash",
"unit": "meters"
}'
Respuesta
Devuelve un objeto Variable con la Variable actualizada.
{
"createdAt": "2019-12-18T14:38:38.354415Z",
"syntheticExpression": "",
"description": "my variable 2",
"device": {
"id": "6e309da44fc8455a9cceb5aa",
"label": "first-device",
"name": "First Device",
"url": "https://api.netux.com/api/v2.0/devices/6e309da44fc8455a9cceb5aa"
},
"icon": "trash",
"id": "5dfa39ee1a9ca53020c69391",
"label": "variable2",
"lastActivity": null,
"lastValue": {},
"name": "Variable 2",
"properties": {},
"tags": ["blue", "yellow"],
"type": "raw",
"unit": "meters",
"url": "https://api.netux.com/api/v2.0/variables/5dfa39ee1a9ca53020c69391",
"valuesUrl": "https://api.netux.com/api/v2.0/variables/5dfa39ee1a9ca53020c69391/values"
}
{
"code": 400001,
"message": "Validation Error.",
"detail": {
....
}
}
{
"code": 401001,
"message": "Authentication credentials were not provided.",
"detail": "Authentication credentials were not provided."
}