Bulk Device Updates - Custom Attribute
Update devices custom attributes values
Query Parameters
The customer ID to which the API call is directed
Possible values: [customAttribute
]
The source of the device information: Custom Attribute
Request Body required
- Array [
- ]
devicelist object[] required
Array of device custom attributes from users to update custom attribute values
The device ID, which IoT Security uses to identify and track a device.
The custom attribute name. The custom attribute should already exist in the IoT Security.
The value of the custom attribute.
- 200
- 4XX
- 5XX
Successful Response
Schema
The path used to call the IoT Security API: “device/bulkupdate”
The version of the IoT Security API: “v4.0”
The code number indicating success: 1
The message indicating success: “OK”
The number of attributes that IoT Security successfully updated
The cases that are not valid to update custom attribute
{
"api": "string",
"ver": "string",
"code": "string",
"message": "string",
"updatedAttributesNum": 0
}
{
"api": "device/bulkUpdate",
"ver": "v4.0",
"code": 1,
"message": "OK",
"updatedAttributesNum": 4,
"errorCases": {}
}
Client Error Response
Schema
STATUS_CODE
GENERAL_MESSAGE
{
"code": "string",
"msg": "string"
}
{
"code": 400,
"msg": "Bad Request. This occurs when an HTTP request contains an invalid query string."
}
{
"code": 403,
"msg": "Forbidden access. Either the provided API key is invalid or it does not have the required RBAC permissions to run this API."
}
{
"code": 429,
"msg": "Too many requests. The number of requests for device details for a single device exceeded the rate limit of 180 queries per minute per tenant."
}
Server Error Response
Schema
STATUS_CODE
GENERAL_MESSAGE
{
"code": "string",
"msg": "string"
}
{
"code": 500,
"msg": "Internal server error. A unified status for API communication type errors."
}