Skip to main content

Cloud snapshots

Cloud snapshots is the snapshot scan-job collection for this CID — ReadDeploymentsCombined (PEP 8 search_scan_jobs) and CreateDeploymentEntity (PEP 8 launch_scan_job). The path is GET /snapshots/combined/deployments/v1 and POST /snapshots/entities/deployments/v1. The other six snapshot ops are not implemented. Next leftover is p10he Unidentified containers. This is not D4C registration (/cloud-connect-aws/…): D4C registration. 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 Cloud or Horizon.

RPC field notes: CloudSnapshotsService. REST schemas: API reference. Unused query keys filter, limit, offset, sort, and parameters are ignored. Extra unused parameters are ignored.

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 snapshot:read (GET) or snapshot:write (POST)

A session cookie bypasses OAuth scopes and can list and launch. Seed client cs-local-hosts (hosts:read only) cannot list or launch (403). Unit tests use a client named cs-local-snap with snapshot:read; that client can list and cannot launch (403). Unit tests use a client named cs-local-snapw with snapshot:write; that client can launch and cannot list (403). Those clients are tests only; compose uses the session cookie. ReadDeploymentsCombined stays snapshot:read. CreateDeploymentEntity stays snapshot:write. There is no seeded production client with snapshot:read or snapshot:write — use the console cookie, or a client you created with that scope. Missing or revoked token → 401.

HTTP paths​

MethodPathUse
GET/snapshots/combined/deployments/v1List snapshot scan jobs. RPC ReadDeploymentsCombined. PEP 8 search_scan_jobs. snapshot:read. Extra unused query filter, limit, offset, sort, parameters ignored. Success 200 MSA resources (id, account_id, asset_identifier, cloud_provider, region, status). Order by id ascending. Distinct from D4C registration. Other six snapshot ops are not implemented.
POST/snapshots/entities/deployments/v1Launch snapshot scan job. RPC CreateDeploymentEntity. PEP 8 launch_scan_job. snapshot:write. Body JSON resources[] with account_id, asset_identifier, cloud_provider, region. Success 201 MSA one resource with those keys, id snap- plus asset_identifier, and status pending. Missing resources → 400. Missing asset_identifier → 400. Duplicate asset_identifier → 409. Distinct from GET this collection and D4C registration.

Empty query params on GET return every job in this CID. Default sort is id ascending. Empty store → empty resources, still 200.

JSON is snake_case MSA. Clone GET success is 200. Clone POST success is 201.

The other six snapshot ops are not implemented. Next leftover is p10he Unidentified containers.

Seed jobs​

idaccount_idasset_identifiercloud_providerregionstatus
snap-i-lab-1acct-snap-1i-lab-1awsus-east-1completed
snap-i-lab-2acct-snap-1i-lab-2awsus-west-2pending

List returns snap-i-lab-1 then snap-i-lab-2 in id order.

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'
curl -sS -b cookies.txt -H 'Host: crowdstrike-api.localhost' \
'http://127.0.0.1:8088/snapshots/combined/deployments/v1'

Success returns snap-i-lab-1 then snap-i-lab-2.

curl -sS -b cookies.txt -H 'Host: crowdstrike-api.localhost' \
-H 'Content-Type: application/json' \
-d '{"resources":[{"account_id":"acct-snap-1","asset_identifier":"i-lab-new","cloud_provider":"aws","region":"eu-central-1"}]}' \
'http://127.0.0.1:8088/snapshots/entities/deployments/v1'

Success 201 returns snap-i-lab-new with status pending.

The other six snapshot ops are not implemented (not yet). Next leftover is p10hd Drift indicators. This is not D4C registration.