Bulk Device Updates - SCCM Devices
PUT/pub/v4.0/device/bulkUpdate?updateSource=sccm
Bulk device updates for sccm devices
Request
Query Parameters
customerid stringrequired
The customer ID specifies the API call
tenantid stringrequired
The tenant ID specifies the API call
updateSource stringrequired
Source of integration
- application/json
Body
required
- Array [
- ]
devicelist object[]required
devices
deviceid string
Required field
serialNumber string
vendor string
model string
diskEncryptionStatus string
windowsInstalledPatches string
windowsInstalledSoftware string
windowsGUID string
sccmSite string
sccmDomain string
Responses
- 200
- 4XX
- 5XX
Successful Response
- application/json
- Schema
- Example (from schema)
- resolveSecurityAlertResponseExample
Schema
api string
The path used to call the IoT Security API: “device/bulkupdate”
ver string
The version of the IoT Security API: “v4.0”
code string
The code number indicating success: 1
message string
The message indicating success: “OK”
updatedDeviceNum integer
The number of devices that IoT Security successfully updated
{
"api": "string",
"ver": "string",
"code": "string",
"message": "string",
"updatedDeviceNum": 0
}
{
"api": "device/bulkUpdate",
"ver": "v4.0",
"code": 1,
"message": "OK",
"updatedDeviceNum": 5
}
Client Error Response
- application/json
- Schema
- Example (from schema)
- Bad Request
- Forbidden access
- Too many requests
Schema
code string
STATUS_CODE
msg string
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
- application/json
- Schema
- Example (from schema)
- resolveSecurityAlertResponseExample
Schema
code string
STATUS_CODE
msg string
GENERAL_MESSAGE
{
"code": "string",
"msg": "string"
}
{
"code": 500,
"msg": "Internal server error. A unified status for API communication type errors."
}
Loading...