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_consolefromCreateSession(POST /identity/entities/sessions/v1) Authorization: Bearerwithsnapshot:read(GET) orsnapshot: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
| Method | Path | Use |
|---|---|---|
GET | /snapshots/combined/deployments/v1 | List 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/v1 | Launch 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
id | account_id | asset_identifier | cloud_provider | region | status |
|---|---|---|---|---|---|
snap-i-lab-1 | acct-snap-1 | i-lab-1 | aws | us-east-1 | completed |
snap-i-lab-2 | acct-snap-1 | i-lab-2 | aws | us-west-2 | pending |
List returns snap-i-lab-1 then snap-i-lab-2 in id order.
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'
ReadDeploymentsCombined (cookie)
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.
CreateDeploymentEntity (cookie)
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.
Related
- D4C registration — D4C AWS accounts
- API reference
The other six snapshot ops are not implemented (not yet). Next leftover is p10hd Drift indicators. This is not D4C registration.