Get Image Facets
POST {{cb_url}}/containers/v1beta/orgs/{{cb_org_key}}/inventory/images/_facet
Get facets that can be used to guide other image inventory queries.
RBAC Permissions Required
Permission (.notation name) | Operation(s) |
---|---|
workloads.container.image | READ, CREATE |
Request Schema
{
"query": "<string>",
"terms": {
"fields": [
"<string>"
]
},
"criteria": {
"workloads": [
{
"cluster": "<string>",
"kind": "<string>",
"name": "<string>",
"namespace": "<string>"
}
],
"vulnerabilities": [
"<string>"
],
"fixes": [
"<string>"
],
"scan_status": [
"<string>"
],
"clusters": [
"<string>"
],
"namespaces": [
"<string>",
"<string>"
],
"cves": [
{
"cve": "<string>",
"package": "<string>",
"type": "<string>"
}
],
"registries": [
"<string>"
],
"repositories": [
"<string>"
],
"is_running": <boolean>
}
}
Request Body
{"query"=>"", "criteria"=>{"is_running"=>true}, "terms"=>{"fields"=>["scan_status", "reputations", "vulnerabilities", "fixes", "namespaces", "clusters", "repositories"], "rows"=>50}}
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
Content-Type | string | ||
Accept | string |
RESPONSES
status: OK
{"terms":[{"field":"scan_status","values":[{"name":"SCANNED","total":72},{"name":"SCAN_FAILED","total":1},{"name":"NOT_SCANNED","total":14}]},{"field":"fixes","values":[{"name":"AVAILABLE_FIXES","total":65},{"name":"NO_FIXES_AVAILABLE","total":6}]},{"field":"clusters","values":[{"name":"demo:cluster-one","total":60},{"name":"test:testing-cluster-one","total":36}]},{"field":"namespaces","values":[{"name":"demo-namespace","total":14},{"name":"testing-namespace","total":3}]},{"field":"reputations","values":[]},{"field":"repositories","values":[{"name":"demoartifactory/cluster-scanner","total":1}]},{"field":"vulnerabilities","values":[{"name":"CRITICAL","total":53},{"name":"HIGH","total":58},{"name":"MEDIUM","total":55},{"name":"LOW","total":52},{"name":"UNKNOWN","total":12},{"name":"NO_VULNERABILITIES","total":3}]}]}