K8s node dates
Kubernetes node counts by date is the
Kubernetes-node-date-count collection for this CID —
ReadNodesByDateRangeCount (PEP 8 read_node_counts_by_date_range). The path is
GET /container-security/aggregates/nodes/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
Kubernetes node counts by container engine ReadNodesByContainerEngineVersionCount
(/container-security/aggregates/nodes/count-by-container-engine-version/v1):
K8s node engines. This is not
Kubernetes namespace counts by date ReadNamespacesByDateRangeCount
(/container-security/aggregates/namespaces/count-by-date/v1):
K8s namespace dates. This is not
Kubernetes node counts ReadNodeCount
(/container-security/aggregates/nodes/count/v1):
K8s node count. 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 node 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_consolefromCreateSession(POST /identity/entities/sessions/v1) Authorization: Bearerwithfalcon-container-image:read
A session cookie bypasses OAuth scopes. Seed client cs-local-hosts
(hosts:read only) cannot list node 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 node 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
| Method | Path | Use |
|---|---|---|
GET | /container-security/aggregates/nodes/count-by-date/v1 | List Kubernetes node counts by date. Query: filter, limit, offset. |
Empty filter returns every node-count-by-date 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 nested SOURCE
{buckets, name}.
This is not Kubernetes node counts by container engine
ReadNodesByContainerEngineVersionCount, Kubernetes namespace counts by date
ReadNamespacesByDateRangeCount, Kubernetes node counts
ReadNodeCount, or the HelloService template.
Kubernetes node counts by container engine uses
/container-security/aggregates/nodes/count-by-container-engine-version/v1:
K8s node engines. Kubernetes
namespace counts by date uses
/container-security/aggregates/namespaces/count-by-date/v1:
K8s namespace dates. Kubernetes node counts uses
/container-security/aggregates/nodes/count/v1:
K8s node count. Remaining
Kubernetes Protection mutations / Image assessment policies / remaining cloud are not
implemented (not yet).
Seed node counts by date
label | count |
|---|---|
2026-08-01 | 1 |
2026-09-01 | 2 |
cid is cid-local-1. Empty GET returns 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).
Session cookie
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
List node counts by date (cookie)
Empty GET returns at least the two seed labels, including
2026-08-01 then 2026-09-01:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/aggregates/nodes/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/nodes/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/nodes/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/nodes/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/nodes/count-by-date/v1'
Remaining Kubernetes Protection mutations /
Image assessment policies / remaining cloud are not implemented (not yet). Kubernetes node engines
is a separate collection:
K8s node engines. Kubernetes namespace
dates is a separate collection:
K8s namespace dates. Kubernetes node count
is a separate collection:
K8s node count. 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/nodes/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.