Skip to main content

K8s IOM dates

Kubernetes IOM counts by date is the Kubernetes-IOM-date-count collection for this CID — ReadKubernetesIomByDateRange. The path is GET /container-security/aggregates/kubernetes-ioms/count-by-date/v1. Remaining Kubernetes Protection mutations / Image assessment policies / remaining cloud are not implemented (not yet). ReadClusterCombinedV2 is not implemented. This is not combined Kubernetes IOM entities SearchAndReadKubernetesIomEntities (/container-security/combined/kubernetes-ioms/v1): K8s IOMs. This is not Kubernetes cluster counts by date ReadClustersByDateRangeCount (/container-security/aggregates/clusters/count-by-date/v1): K8s cluster dates. This is not Kubernetes container counts by date ReadContainersByDateRangeCount (/container-security/aggregates/containers/count-by-date/v1): K8s container dates. This is not Kubernetes deployment counts by date ReadDeploymentsByDateRangeCount (/container-security/aggregates/deployments/count-by-date/v1): K8s deployment dates. This is not Kubernetes distinct container image counts ReadDistinctContainerImageCount (/container-security/aggregates/images/count-by-distinct/v1): K8s distinct images. This is not the HelloService template sample (GET /api/hello).

This collection is not CrowdStrike production. It does not call Falcon cloud. It is not CrowdStrike Falcon Container Image cloud.

RPC field notes: ContainerImagesService. REST schemas: API reference. Filter syntax: FQL. Kubernetes IOM counts by date does use FQL (unlike Kubernetes clusters and combined cloud clusters).

These curls use Host: crowdstrike-api.localhost against Compose Traefik on :8088. If the hostname already resolves to Traefik, you can omit the Host header and call http://crowdstrike-api.localhost instead.

Auth​

Every call needs a console session or a Bearer token:

  • Cookie cs_console from CreateSession (POST /identity/entities/sessions/v1)
  • Authorization: Bearer with falcon-container-image:read

A session cookie bypasses OAuth scopes. Seed client cs-local-hosts (hosts:read only) cannot list IOM counts by date (403) — it is missing falcon-container-image:read. Unit tests use a client named cs-local-cimg with falcon-container-image:read; that client can list IOM counts by date. It is not in the production seed. Use the console cookie, or a client you created with that scope. Missing or revoked token → 401. This RPC does not use kubernetes-protection:read.

HTTP paths​

MethodPathUse
GET/container-security/aggregates/kubernetes-ioms/count-by-date/v1List Kubernetes IOM counts by date. Query: filter, limit, offset.

Empty filter returns every IOM-date-count row in this CID. Allowed FQL properties: label, cid. Unknown property or invalid filter → 400. limit and offset must be ≥ 0 else 400. Omitted limit defaults to 100 (capped at 200). Empty sort is ignored. Default sort is label.asc.

JSON is DESIGN snake_case flattened fields (three fields this slice): label, count, cid.

This is not combined Kubernetes IOM entities SearchAndReadKubernetesIomEntities, Kubernetes cluster counts by date ReadClustersByDateRangeCount, Kubernetes container counts by date ReadContainersByDateRangeCount, Kubernetes deployment counts by date ReadDeploymentsByDateRangeCount, Kubernetes distinct container image counts ReadDistinctContainerImageCount, or the HelloService template. Combined Kubernetes IOM entities uses /container-security/combined/kubernetes-ioms/v1: K8s IOMs. Kubernetes cluster counts by date uses /container-security/aggregates/clusters/count-by-date/v1: K8s cluster dates. Kubernetes container counts by date uses /container-security/aggregates/containers/count-by-date/v1: K8s container dates. Kubernetes deployment counts by date uses /container-security/aggregates/deployments/count-by-date/v1: K8s deployment dates. Kubernetes distinct container image counts uses /container-security/aggregates/images/count-by-distinct/v1: K8s distinct images. Remaining Kubernetes Protection mutations / Image assessment policies / remaining cloud are not implemented (not yet).

Seed IOM counts by date​

labelcount
2026-08-011
2026-09-012

cid is cid-local-1. Empty filters return both (label ASC: 2026-08-01 then 2026-09-01). filter=label:'2026-09-01' returns 2026-09-01 (count 2). filter=label:'2026-08-01' returns 2026-08-01 (count 1).

curl -sS -c cookies.txt -H 'Host: crowdstrike-api.localhost' \
-H 'Content-Type: application/json' \
-d '{"email":"[email protected]","password":"FalconLocal!1","cloud":"us-1"}' \
http://127.0.0.1:8088/identity/entities/sessions/v1

Empty filters return at least the two seed labels, including 2026-08-01 and 2026-09-01:

curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/aggregates/kubernetes-ioms/count-by-date/v1'

filter=label:'2026-09-01' returns 2026-09-01 (count 2):

curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/aggregates/kubernetes-ioms/count-by-date/v1?filter=label:%272026-09-01%27'

Unknown FQL property is 400:

curl -sS -o /dev/null -w '%{http_code}\n' \
-H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/aggregates/kubernetes-ioms/count-by-date/v1?filter=bogus:%27x%27'

No cookie and no Bearer is 401:

curl -sS -o /dev/null -w '%{http_code}\n' \
-H 'Host: crowdstrike-api.localhost' \
'http://127.0.0.1:8088/container-security/aggregates/kubernetes-ioms/count-by-date/v1'

cs-local-hosts (hosts:read only, missing falcon-container-image:read) is 403:

TOKEN='<access_token from cs-local-hosts>'
curl -sS -o /dev/null -w '%{http_code}\n' \
-H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
'http://127.0.0.1:8088/container-security/aggregates/kubernetes-ioms/count-by-date/v1'

Remaining Kubernetes Protection mutations / Image assessment policies / remaining cloud are not implemented (not yet). Combined Kubernetes IOMs is a separate collection: K8s IOMs. Kubernetes cluster dates is a separate collection: K8s cluster dates. Kubernetes container dates is a separate collection: K8s container dates. Kubernetes deployment dates is a separate collection: K8s deployment dates. Kubernetes distinct images is a separate collection: K8s distinct images. This is not the HelloService template (GET /api/hello).

List (Bearer)​

TOKEN='<access_token from a client with falcon-container-image:read>'
curl -sS -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
'http://127.0.0.1:8088/container-security/aggregates/kubernetes-ioms/count-by-date/v1'

falcon-container-image:read → 200 (including unit-test client cs-local-cimg). A token without that scope (including hosts:read only, e.g. cs-local-hosts) → 403. Missing or revoked token → 401. This RPC does not use kubernetes-protection:read.

OAuth2 mint/revoke: OAuth2. Accessible scopes: API clients.