POST /protocols/bacnet/local/objects/write-property-multiple
Write multiple points in one request. This reduces the amount of network traffic required to transmit data.
This resource supports three Content-types:
In the Body request, you need to specify the encode attribute (asn or text).
All fields are required.
The response body will show the same data as the one sent, except in the case of an error, which will be printed in the response.
The value element must be sent every time as a String even if it's a numeric value.
If this parameter is not in the request, the Application/Json will be chosen by default.
There are multiple possible values (according the resource):
The first two are the most often used.
There are multiple possible values according the resource:
If this parameter is not present during the request, and error 415 Unsupported Media Type will be thrown.
The Content-Length entity-header field indicates the size of the entity-body.
Object Name: PropertyReference
Property Name | Type | Description | Method |
---|---|---|---|
Type required |
String | This property is the name of the object type. | POST |
Instance required |
Integer | This property is the object's instance. | POST |
Property required |
String | This property is the object's property name | POST |
Priority optional |
Integer | This property is the index used to read a table property value. Use -1 if there is no array index. |
POST |
Message | String | This property refers to the property value recovered. | POST |
Value required |
String | This property is used during a write property multiple to write the value. | POST |
Object Name: WritePropertyMultiple
Property Name | Type | Description | Method |
---|---|---|---|
encode | String | This property is used to indicate which type is needed to recover the values, or the type you are writing the values from/in the device :
|
POST |
PropertyReferences | Array <PropertyReference> |
This object is an array of PropertyReference object. | POST |
URL Example: https://0.0.0.0/api/rest/v1/protocols/bacnet/local/objects/write-property-multiple
{
"encode": "text",
"propertyReferences": [
{
"type": "device",
"instance": 254001,
"property": "objectName",
"value": "ECY-S1000-CD4C93"
},
{
"type": "device",
"instance": 254001,
"property": "description",
"value": "AHU Control"
}
]
}
URL Example: https://0.0.0.0/api/rest/v1/protocols/bacnet/local/objects/write-property-multiple
<?xml version="1.0" encoding="utf-8"?>
<PropertyReferences encode="text">
<PropertyReference instance="254001" type="device" property="objectName">ECY-S1000-CD4C93</PropertyReference>
<PropertyReference instance="254001" type="device" property="description">AHU Control</PropertyReference>
</PropertyReferences>
URL Example: https://0.0.0.0/api/rest/v1/protocols/bacnet/local/objects/write-property-multiple
{
"encode": "text",
"propertyReferences": [
{
"type": "device",
"instance": 254001,
"property": "objectName",
"value": "ECY-S1000-CD4C93"
},
{
"type": "device",
"instance": 254001,
"property": "description",
"value": "AHU Control"
}
]
}
URL Example: https://0.0.0.0/api/rest/v1/protocols/bacnet/local/objects/write-property-multiple
<?xml version="1.0" encoding="utf-8"?>
<PropertyReferences encode="text">
<PropertyReference instance="254001" type="device" property="objectName">ECY-S1000-CD4C93</PropertyReference>
<PropertyReference instance="254001" type="device" property="description">AHU Control</PropertyReference>
</PropertyReferences>