Search Devices in a Benchmark Set
POST {{cb_url}}/compliance/assessment/api/v1/orgs/{{cb_org_key}}/benchmark_sets/{{cb_benchmark_set_id}}/inventory/devices/_search
Get the Device Summary from Inventory for devices in a Benchmark Set.
RBAC Permissions Required
Permission (.notation name) | Operation(s) |
---|---|
complianceAssessment.data | READ |
Request Schema
{
"query": "<string>",
"rows": "<integer>",
"start": "<integer>",
"criteria": {
"<fieldname>": [
"<string>"
]},
"exclusions": {
"<fieldname>": [
"<string>"
]},
"sort": [
{
"field": "<string>",
"order": "<string>"
}
]
}
Request Body
{"query"=>"windows", "rows"=>20, "start"=>0, "criteria"=>{"os_type"=>["WINDOWS"]}, "exclusions"=>{"cis_version"=>["1.4.0"]}, "sort"=>[{"field"=>"create_time", "order"=>"DESC"}]}
RESPONSES
status: OK
{"num_found":4568,"results":[{"device_id":12345678,"device_name":"TEST\\DEMO-MACHINE","host_name":null,"os_version":"Windows Server 2019 x64","reason":"ASSESSMENT_SCHEDULED","sensor_version":"3.9.0","last_checkin_time":"2023-12-19T08:37:03.126Z","deployment_type":"WORKLOAD"}]}