Container images
Container images is the assessed-image-list collection for this CID —
GetCombinedImages, DeleteImageDetails (SOURCE
DeleteImageDetails, PEP 8 delete_image_details),
GetImageAssessmentReport (SOURCE GetImageAssessmentReport,
PEP 8 get_assessment), GetReportByReference (SOURCE
GetReportByReference, PEP 8 get_report_by_reference), and
GetReportByScanId (SOURCE GetReportByScanID, PEP 8
get_report_by_id), ImageMatchesPolicy (SOURCE
ImageMatchesPolicy, PEP 8 image_matches_policy), and
LaunchExportJob (SOURCE LaunchExportJob, PEP 8
launch_export_job), QueryExportJobs (SOURCE
QueryExportJobs, PEP 8 query_export_jobs), ReadExportJobs
(SOURCE ReadExportJobs, PEP 8 read_export_jobs), DownloadExportFile
(SOURCE DownloadExportFile, PEP 8 download_export_file), PolicyChecks
(SOURCE PolicyChecks, PEP 8 check_prevention_policies), and
AggregateImageAssessmentHistory (SOURCE
AggregateImageAssessmentHistory, PEP 8 aggregate_assessment_history), and
AggregateImageCount (SOURCE AggregateImageCount, PEP 8
aggregate_count), and AggregateImageCountByBaseOS (SOURCE
AggregateImageCountByBaseOS, PEP 8 aggregate_count_by_base_os), and
AggregateImageCountByState (SOURCE
AggregateImageCountByState, PEP 8 aggregate_count_by_state), and
CombinedBaseImages (SOURCE CombinedBaseImages, PEP 8
get_combined_base_images), and
CombinedImageByVulnerabilityCount (SOURCE
CombinedImageByVulnerabilityCount, PEP 8
get_combined_images_by_vulnerability_count), and
CombinedImageDetail (SOURCE CombinedImageDetail, PEP 8
get_combined_detail), and
CombinedImageIssuesSummary (SOURCE CombinedImageIssuesSummary, PEP 8
get_combined_issues_summary), and
CombinedImageVulnerabilitySummary (SOURCE CombinedImageVulnerabilitySummary, PEP 8
get_combined_vulnerabilities_summary), and
CreateBaseImagesEntities (SOURCE CreateBaseImagesEntities, PEP 8
create_base_images), and
DeleteBaseImages (SOURCE DeleteBaseImages, PEP 8
delete_base_images), and
ReadCombinedImagesExport (SOURCE ReadCombinedImagesExport, PEP 8
read_combined_export). The path is
GET /container-security/combined/image-assessment/images/v1. The Read
image assessment history path is
GET /container-security/aggregates/images/assessment-history/v1
(distinct from GET combined image-assessment, GET
/container-security/aggregates/images/count/v1, GET
/container-security/aggregates/images/count-by-os-distribution/v1, GET
/container-security/aggregates/images/count-by-state/v1, GET
/container-security/aggregates/images/count-by-distinct/v1, GET
/container-security/aggregates/images/most-used/v1, GET
/container-security/aggregates/vulnerabilities/count-by-severity/v1,
GET /container-security/combined/base-images/v1,
GET /container-security/combined/images/by-vulnerability-count/v1,
GET /container-security/combined/images/detail/v1, and GET /container-security/combined/images/issues-summary/v1, and GET /container-security/combined/images/vulnerabilities-summary/v1, and POST /container-security/entities/base-images/v1, and DELETE /container-security/entities/base-images/v1, and GET /container-security/combined/images/export/v1, and Image assessment policies / remaining cloud). The Read
image count path is
GET /container-security/aggregates/images/count/v1
(distinct from GET combined image-assessment, GET
/container-security/aggregates/images/assessment-history/v1, GET
/container-security/aggregates/images/count-by-os-distribution/v1, GET
/container-security/aggregates/images/count-by-state/v1, GET
/container-security/aggregates/images/count-by-distinct/v1, GET
/container-security/aggregates/images/most-used/v1, GET
/container-security/aggregates/vulnerabilities/count/v1,
GET /container-security/combined/base-images/v1,
GET /container-security/combined/images/by-vulnerability-count/v1,
GET /container-security/combined/images/detail/v1, and GET /container-security/combined/images/issues-summary/v1, and GET /container-security/combined/images/vulnerabilities-summary/v1, and POST /container-security/entities/base-images/v1, and DELETE /container-security/entities/base-images/v1, and GET /container-security/combined/images/export/v1, and Image assessment policies / remaining cloud). The Read
image count by base OS path is
GET /container-security/aggregates/images/count-by-os-distribution/v1
(distinct from GET combined image-assessment, GET assessment-history, GET
count, GET /container-security/aggregates/images/count-by-state/v1, GET
/container-security/aggregates/images/count-by-distinct/v1, GET
/container-security/aggregates/images/most-used/v1, GET
/container-security/combined/base-images/v1, GET
/container-security/combined/images/by-vulnerability-count/v1, GET /container-security/combined/images/detail/v1, and GET /container-security/combined/images/issues-summary/v1, and GET /container-security/combined/images/vulnerabilities-summary/v1, and POST /container-security/entities/base-images/v1, and DELETE /container-security/entities/base-images/v1, and GET /container-security/combined/images/export/v1, and Image assessment policies / remaining cloud). The Read
image count by state path is
GET /container-security/aggregates/images/count-by-state/v1
(distinct from GET combined image-assessment, GET assessment-history, GET
count, GET count-by-os-distribution, GET
/container-security/aggregates/images/count-by-distinct/v1, GET
/container-security/aggregates/images/most-used/v1, GET
/container-security/combined/base-images/v1, GET
/container-security/combined/images/by-vulnerability-count/v1, GET /container-security/combined/images/detail/v1, and GET /container-security/combined/images/issues-summary/v1, and GET /container-security/combined/images/vulnerabilities-summary/v1, and POST /container-security/entities/base-images/v1, and DELETE /container-security/entities/base-images/v1, and GET /container-security/combined/images/export/v1, and Image assessment policies / remaining cloud). The Read combined base images path is
GET /container-security/combined/base-images/v1
(distinct from GET combined image-assessment, GET aggregates, GET
/container-security/combined/images/by-vulnerability-count/v1, GET /container-security/combined/images/detail/v1, and GET /container-security/combined/images/issues-summary/v1, and GET /container-security/combined/images/vulnerabilities-summary/v1, and POST /container-security/entities/base-images/v1, and DELETE /container-security/entities/base-images/v1, and GET /container-security/combined/images/export/v1, and Image assessment policies / remaining cloud). The Read images by vulnerability count path is
GET /container-security/combined/images/by-vulnerability-count/v1
(distinct from GET combined image-assessment, GET combined base-images,
GET aggregates, GET /container-security/combined/images/detail/v1, and GET /container-security/combined/images/issues-summary/v1, and GET /container-security/combined/images/vulnerabilities-summary/v1, and POST /container-security/entities/base-images/v1, and DELETE /container-security/entities/base-images/v1, and GET /container-security/combined/images/export/v1, and Image assessment policies / remaining cloud). The
Read combined image detail path is
GET /container-security/combined/images/detail/v1
(distinct from GET combined image-assessment, GET combined base-images,
GET by-vulnerability-count, and GET /container-security/combined/images/issues-summary/v1, and GET /container-security/combined/images/vulnerabilities-summary/v1, and POST /container-security/entities/base-images/v1, and DELETE /container-security/entities/base-images/v1, and GET /container-security/combined/images/export/v1, and Image assessment policies / remaining cloud). The
Read combined image issues summary path is
GET /container-security/combined/images/issues-summary/v1
(distinct from GET combined image-assessment, GET combined base-images,
GET by-vulnerability-count, GET combined image detail, and GET /container-security/combined/images/vulnerabilities-summary/v1, and POST /container-security/entities/base-images/v1, and DELETE /container-security/entities/base-images/v1, and GET /container-security/combined/images/export/v1, and Image assessment policies / remaining cloud). The
Read combined image vulnerability summary path is
GET /container-security/combined/images/vulnerabilities-summary/v1
(distinct from GET combined image-assessment, GET combined base-images,
GET by-vulnerability-count, GET combined image detail, GET combined image issues summary, and POST /container-security/entities/base-images/v1, and DELETE /container-security/entities/base-images/v1, and GET /container-security/combined/images/export/v1, and Image assessment policies / remaining cloud). The
Create base image path is
POST /container-security/entities/base-images/v1
(distinct from GET combined image-assessment, GET combined base-images,
GET by-vulnerability-count, GET combined image detail, GET combined image issues summary, GET combined image vulnerability summary, and DELETE /container-security/entities/base-images/v1, and GET /container-security/combined/images/export/v1, and Image assessment policies / remaining cloud). The
Delete base images path is
DELETE /container-security/entities/base-images/v1
(distinct from DELETE /container-security/entities/images/v1, POST /container-security/entities/base-images/v1, GET combined base-images, and GET /container-security/combined/images/export/v1, and Image assessment policies / remaining cloud). The
Read combined images export path is
GET /container-security/combined/images/export/v1
(distinct from GET combined image-assessment, GET combined images/detail, GET combined base-images, Launch export, and Image assessment policies / remaining cloud). The
Delete path is DELETE /container-security/entities/images/v1 (distinct
from GET combined image-assessment, GET entities reports, registry
POST/GET, and Kubernetes). The Get assessment path is
GET /container-security/entities/reports/v1 (distinct from GET
combined image-assessment, DELETE entities images, SOURCE /reports
(not a clone route), GetReportByReference v2, and GetReportByScanId v2
{uuid}). The Get report by
reference path is GET /container-security/entities/reports/v2 (distinct
from GET reports v1, GET combined image-assessment, DELETE entities
images, SOURCE /image-assessment/entities/reports/v2 (not a clone
route), and GetReportByScanId v2 {uuid}). The Get report by scan path
is GET /container-security/entities/reports/v2/{uuid} (distinct from
GET reports v1, GET reports v2 query image_id, GET combined
image-assessment, DELETE entities images, and SOURCE
/image-assessment/entities/reports/v2/{uuid} (not a clone route)).
The Check policy path is
GET /container-security/entities/policy-checks/v1 (distinct from GET
policy-checks v2, GET reports, HEAD inventory, GET credentials, SOURCE
/policy-checks (not a clone route), and SOURCE
/image-assessment/entities/policy-checks/v2 (not a clone route)).
The Launch export path is
POST /container-security/entities/exports/v1 (distinct from GET
policy-checks v1, GET policy-checks v2, GET reports, HEAD inventory,
GET /container-security/queries/exports/v1 (QueryExportJobs), GET
/container-security/entities/exports/v1 (ReadExportJobs), GET
/container-security/entities/exports/files/v1 (DownloadExportFile)).
The Query export jobs path is
GET /container-security/queries/exports/v1 (distinct from POST
/container-security/entities/exports/v1 (LaunchExportJob), GET
/container-security/entities/exports/v1 (ReadExportJobs), GET
/container-security/entities/exports/files/v1 (DownloadExportFile)).
SOURCE raw JSON array is not the clone envelope.
The Read export jobs path is
GET /container-security/entities/exports/v1 (distinct from POST
/container-security/entities/exports/v1 (LaunchExportJob), GET
/container-security/queries/exports/v1 (QueryExportJobs), GET
/container-security/entities/exports/files/v1 (DownloadExportFile)).
The Download export file path is
GET /container-security/entities/exports/files/v1 (distinct from POST
/container-security/entities/exports/v1 (LaunchExportJob), GET
/container-security/entities/exports/v1 (ReadExportJobs), GET
/container-security/queries/exports/v1 (QueryExportJobs)).
SOURCE raw file bytes are not the clone envelope.
The Check prevention path is
GET /container-security/entities/policy-checks/v2 (distinct from GET
policy-checks v1 (ImageMatchesPolicy), GET reports, HEAD inventory,
POST exports, SOURCE /image-assessment/entities/policy-checks/v2
(not a clone route)).
SOURCE /images/{image_id} is not a clone route. SOURCE
/reports is not a clone route. SOURCE
/image-assessment/entities/reports/v2 is not a clone route. SOURCE
/image-assessment/entities/reports/v2/{uuid} is not a clone route.
SOURCE /policy-checks is not a clone route. SOURCE
/image-assessment/entities/policy-checks/v2 is not a clone route.
Image assessment policies / remaining cloud, remaining Container
Images ops (export, summaries) and other
cloud/container collections are not implemented (not yet). This is
not Kubernetes (/kubernetes-protection/…) and not Cloud AWS
(/cloud-connect-cspm-aws/…). Combined container vulnerabilities is a
separate collection:
Container vulnerabilities. Container
registries is a separate collection:
Container registries. 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.
Container images does use FQL (unlike Kubernetes and CSPM AWS).
DELETE uses required query image_id. Extra unused keys are ignored.
Clone success is JSON MSA 200 ContainerImage. Distinct from GET
combined image-assessment, GET entities reports, registry POST/GET, and
Kubernetes. SOURCE /images/{image_id} is not a clone route. DELETE
does not cascade container vulnerability rows. GET assessment uses
required query image_id. Extra unused keys are ignored. Clone success
is JSON MSA 200 ContainerImage. Distinct from GET combined
image-assessment, DELETE entities images, SOURCE /reports (not a
clone route), and GetReportByReference v2. GET report by reference uses
required query image_id. Extra unused keys are ignored. Clone success
is JSON MSA 200 ContainerImage. Distinct from GET reports v1, GET
combined image-assessment, DELETE entities images, and SOURCE
/image-assessment/entities/reports/v2 (not a clone route). GET report
by scan uses required path uuid (clone uuid = image_id). Extra unused
keys are ignored. Clone success is JSON MSA 200 ContainerImage.
Distinct from GET reports v1, GET reports v2 query image_id, GET
combined image-assessment, DELETE entities images, and SOURCE
/image-assessment/entities/reports/v2/{uuid} (not a clone route).
GET check policy uses required query repository and tag. Extra unused
keys are ignored. Clone success is JSON MSA 200 ContainerImage.
Empty match is 200 empty resources. Distinct from GET policy-checks
v2, GET reports, HEAD inventory, GET credentials, SOURCE /policy-checks
(not a clone route), and SOURCE
/image-assessment/entities/policy-checks/v2 (not a clone route). POST
launch export uses required JSON
resource. format is csv or json (default json). Extra unused
keys including expand_vulnerabilities, fql, and sort are ignored.
Clone success is JSON MSA 200 ContainerExportJob. Distinct from
GET policy-checks v1, GET policy-checks v2, GET reports, HEAD inventory,
GET /container-security/queries/exports/v1 (QueryExportJobs), GET
/container-security/entities/exports/v1 (ReadExportJobs), GET
/container-security/entities/exports/files/v1 (DownloadExportFile).
GET query export jobs uses optional query filter (FQL resource and
status). Extra unused keys including parameters are ignored. Cap
100. Empty match is 200 empty resources. Clone success is JSON
MSA 200 string ids. SOURCE raw JSON array is not the clone
envelope. Distinct from POST /container-security/entities/exports/v1
(LaunchExportJob), GET /container-security/entities/exports/v1
(ReadExportJobs), GET /container-security/entities/exports/files/v1
(DownloadExportFile). GET read export jobs uses required query
ids (max 100). Extra unused keys including parameters are
ignored. Unknown ids are skipped. Empty match is 200 empty
resources. Clone success is JSON MSA 200 ContainerExportJob.
Distinct from POST /container-security/entities/exports/v1
(LaunchExportJob), GET /container-security/queries/exports/v1
(QueryExportJobs), GET /container-security/entities/exports/files/v1
(DownloadExportFile). GET download export file uses required query
id. Extra unused keys including parameters are ignored. Unknown
id is 404. Clone success is JSON MSA 200 filename+content.
SOURCE raw file bytes are not the clone envelope. Distinct from POST
/container-security/entities/exports/v1 (LaunchExportJob), GET
/container-security/entities/exports/v1 (ReadExportJobs), GET
/container-security/queries/exports/v1 (QueryExportJobs). GET check prevention uses
required query repository and tag. Extra unused keys are ignored.
Clone success is JSON MSA 200 ContainerPreventionCheck. Empty
match is 200 empty resources. Distinct from GET policy-checks v1
(ImageMatchesPolicy), GET reports, HEAD inventory, POST exports, SOURCE
/image-assessment/entities/policy-checks/v2 (not a clone route). GET
image count ignores extra unused parameters and filter. Clone
success is JSON MSA 200 count + cid. Distinct from GET combined
image-assessment, GET assessment-history, GET
aggregates/images/count-by-os-distribution, GET
aggregates/images/count-by-state, GET
aggregates/images/count-by-distinct, GET aggregates/images/most-used,
GET vulnerability count, GET combined/base-images, GET combined/images/by-vulnerability-count, GET /container-security/combined/images/detail/v1, and GET /container-security/combined/images/issues-summary/v1, and GET /container-security/combined/images/vulnerabilities-summary/v1, and POST /container-security/entities/base-images/v1, and DELETE /container-security/entities/base-images/v1, and GET /container-security/combined/images/export/v1, and Image assessment policies / remaining cloud.
GET image count by base OS ignores extra unused parameters and
filter. Clone success is JSON MSA 200 name + count + cid.
Distinct from GET combined image-assessment, GET assessment-history,
GET count, GET aggregates/images/count-by-state, GET
aggregates/images/count-by-distinct, GET
aggregates/images/most-used, GET combined/base-images, GET combined/images/by-vulnerability-count, GET /container-security/combined/images/detail/v1, and GET /container-security/combined/images/issues-summary/v1, and GET /container-security/combined/images/vulnerabilities-summary/v1, and POST /container-security/entities/base-images/v1, and DELETE /container-security/entities/base-images/v1, and GET /container-security/combined/images/export/v1, and Image assessment policies / remaining cloud.
GET image count by state ignores extra unused parameters and
filter. Clone success is JSON MSA 200 name + count + cid.
Distinct from GET combined image-assessment, GET assessment-history,
GET count, GET count-by-os-distribution, GET aggregates/images/count-by-distinct, GET
aggregates/images/most-used, GET combined/base-images, GET combined/images/by-vulnerability-count, GET /container-security/combined/images/detail/v1, and GET /container-security/combined/images/issues-summary/v1, and GET /container-security/combined/images/vulnerabilities-summary/v1, and POST /container-security/entities/base-images/v1, and DELETE /container-security/entities/base-images/v1, and GET /container-security/combined/images/export/v1, and Image assessment policies / remaining cloud.
GET combined base images ignores extra unused parameters and
filter. Clone success is JSON MSA 200 image_id + registry +
repository + tag + image_digest + cid. Distinct from GET
combined image-assessment, GET aggregates, GET combined/images/by-vulnerability-count, GET /container-security/combined/images/detail/v1, and GET /container-security/combined/images/issues-summary/v1, and GET /container-security/combined/images/vulnerabilities-summary/v1, and POST /container-security/entities/base-images/v1, and DELETE /container-security/entities/base-images/v1, and GET /container-security/combined/images/export/v1, and Image assessment policies / remaining cloud.
GET images by vulnerability count ignores extra unused parameters,
filter, limit, and offset. Clone success is JSON MSA 200
image_id + registry + repository + tag + vulnerability_count +
cid. Distinct from GET combined image-assessment, GET combined
base-images, GET aggregates, GET /container-security/combined/images/detail/v1, and GET /container-security/combined/images/issues-summary/v1, and GET /container-security/combined/images/vulnerabilities-summary/v1, and POST /container-security/entities/base-images/v1, and DELETE /container-security/entities/base-images/v1, and GET /container-security/combined/images/export/v1, and Image assessment policies / remaining cloud.
GET combined image detail ignores extra unused parameters,
filter, with_config, sort, limit, and offset. Clone success is JSON MSA 200
image_id + registry + repository + tag + digest + base_os +
cid. Distinct from GET combined image-assessment, GET combined
base-images, GET by-vulnerability-count, and GET /container-security/combined/images/issues-summary/v1, and GET /container-security/combined/images/vulnerabilities-summary/v1, and POST /container-security/entities/base-images/v1, and DELETE /container-security/entities/base-images/v1, and GET /container-security/combined/images/export/v1, and Image assessment policies / remaining cloud.
GET combined image issues summary ignores extra unused parameters,
cid, registry, repository, tag, image_digest, and
include_base_image_vuln. Clone success is JSON MSA 200
image_id + known_issues + is_dca_run + zero_day_impacted +
cid. Distinct from GET combined image-assessment, GET combined
base-images, GET by-vulnerability-count, GET combined image detail, and GET /container-security/combined/images/vulnerabilities-summary/v1, and POST /container-security/entities/base-images/v1, and DELETE /container-security/entities/base-images/v1, and GET /container-security/combined/images/export/v1, and Image assessment policies / remaining cloud.
GET combined image vulnerability summary ignores extra unused parameters,
cid, registry, repository, tag, image_digest, and
include_base_image_vuln. Clone success is JSON MSA 200
image_id + total_vulnerabilities + cid. Distinct from GET combined
image-assessment, GET combined base-images, GET by-vulnerability-count,
GET combined image detail, GET combined image issues summary, and POST /container-security/entities/base-images/v1, and DELETE /container-security/entities/base-images/v1, and GET /container-security/combined/images/export/v1, and Image assessment policies / remaining cloud.
POST create base images ignores extra unused parameters and
base_images. Clone success is JSON MSA 200
image_id + registry + repository + tag + image_digest +
cid. Distinct from GET combined image-assessment, GET combined
base-images, GET combined image vulnerability summary, and DELETE /container-security/entities/base-images/v1, and GET /container-security/combined/images/export/v1, and Image assessment policies / remaining cloud.
SOURCE {} is not the clone envelope. Duplicate image_id is 400.
Required image_id, registry, repository, tag, image_digest.
DELETE base images uses required query ids. Extra unused parameters
are ignored. Clone success is JSON MSA 200
image_id + registry + repository + tag + image_digest +
cid. Distinct from DELETE /container-security/entities/images/v1 and
POST /container-security/entities/base-images/v1. SOURCE {} is not
the clone envelope. Unknown ids is 404. Required ids.
GET combined images export ignores extra unused filter,
expand_vulnerabilities, expand_detections, limit, offset,
sort, and parameters. Clone success is JSON MSA 200
image_id + registry + repository + tag + architecture +
image_digest + cid + base_os. Distinct from GET combined
image-assessment, GET combined images/detail, GET combined
base-images, Launch export, and Image assessment policies / remaining cloud.
SOURCE array is not the clone envelope.
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(GET list, GET assessment, GET report by reference, GET report by scan, GET check policy, POST launch export, GET query export jobs, GET read export jobs, GET download export file, GET prevention check, GET image assessment history, GET image count, GET image count by base OS, GET image count by state, GET combined base images, GET images by vulnerability count, GET combined image detail, GET combined image issues summary, GET combined image vulnerability summary, GET combined images export) orfalcon-container-image:write(DELETE, POST create base images, DELETE base images)
A session cookie bypasses OAuth scopes. Seed client cs-local-hosts
(hosts:read only) cannot list images, get assessment, get report by
reference, get report by scan, check policy, launch export, query
export jobs, read export jobs, download export file, check prevention,
read image assessment history, read image count, read image count by
base OS, read image count by state, read combined base images, read images by
vulnerability count, read combined image detail, read combined
image issues summary, read combined image vulnerability summary, read combined images export, delete images, create base images, or delete base images
(403).
falcon-container-image:read can list images, get assessment, get
report by reference, get report by scan, check policy, launch export,
query export jobs, read export jobs, download export file, check prevention,
read image assessment history, read image count, read image count
by base OS, read image count by state, read combined base images, read
images by vulnerability count, read combined image detail, and
read combined image issues summary, and read combined image
vulnerability summary, and read combined images export and
cannot DELETE, POST create base images, or DELETE base images (403).
GetCombinedImages, GetImageAssessmentReport, GetReportByReference,
GetReportByScanId, ImageMatchesPolicy, LaunchExportJob, QueryExportJobs,
ReadExportJobs, DownloadExportFile, PolicyChecks, AggregateImageAssessmentHistory, AggregateImageCount, AggregateImageCountByBaseOS, AggregateImageCountByState, CombinedBaseImages, CombinedImageByVulnerabilityCount, CombinedImageDetail, CombinedImageIssuesSummary, CombinedImageVulnerabilitySummary, and ReadCombinedImagesExport stay
falcon-container-image:read. DeleteImageDetails, CreateBaseImagesEntities, and DeleteBaseImages stay
falcon-container-image:write. Unit tests use a client named
cs-local-cimg with falcon-container-image:read; that client can
list images, get assessment, get report by reference, get report by
scan, check policy, launch export, query export jobs, read export
jobs, download export file, check prevention, read image
assessment history, read image count, read image count by base OS, read image count by state, read combined base images, read images by vulnerability count, read combined image detail, and read combined image issues summary, and read combined image vulnerability summary, and read combined images export and cannot DELETE, POST create base images, or DELETE base images (403).
Unit tests use a client named cs-local-cimgw with
falcon-container-image:write; that client can DELETE, POST create base images, and DELETE base images and
cannot GET assessment, GET report by reference, GET report by scan,
GET check policy, POST launch export, GET query export jobs, GET read
export jobs, GET download export file, GET prevention check, GET
image assessment history, GET image count, GET image count by base OS, GET image count by state, GET combined base images, GET images by vulnerability count, GET combined image detail, GET combined image issues summary, GET combined image vulnerability summary, or GET combined images export (403).
It is not in the production seed.
There is no seeded production client with falcon-container-image:read
or falcon-container-image:write — use the console cookie, or a client
you created with that scope. Missing or revoked token → 401.
HTTP paths
| Method | Path | Use |
|---|---|---|
GET | /container-security/combined/image-assessment/images/v1 | List images. Query: filter, sort, limit, offset. |
DELETE | /container-security/entities/images/v1?image_id= | Delete an image. RPC DeleteImageDetails. SOURCE DeleteImageDetails. PEP 8 delete_image_details. Query image_id. Distinct from GET combined image-assessment, GET entities reports, registry POST/GET, and Kubernetes. SOURCE /images/{image_id} is not a clone route. Success 200 MSA ContainerImage. Extra unused keys ignored. Required image_id. falcon-container-image:write. Does not cascade vulnerabilities. |
GET | /container-security/entities/reports/v1?image_id= | Get assessment. RPC GetImageAssessmentReport. SOURCE GetImageAssessmentReport. PEP 8 get_assessment. Query image_id. Distinct from GET combined image-assessment, DELETE entities images, SOURCE /reports (not a clone route), GetReportByReference v2, GetReportByScanId v2 {uuid}. Success 200 MSA ContainerImage. Extra unused keys ignored. Required image_id. falcon-container-image:read. Does not mutate. |
GET | /container-security/entities/reports/v2?image_id= | Get report by reference. RPC GetReportByReference. SOURCE GetReportByReference. PEP 8 get_report_by_reference. Query image_id. Distinct from GET reports v1, GET combined image-assessment, DELETE entities images, SOURCE /image-assessment/entities/reports/v2 (not a clone route), GetReportByScanId v2 {uuid}. Success 200 MSA ContainerImage. Extra unused keys ignored. Required image_id. falcon-container-image:read. Does not mutate. |
GET | /container-security/entities/reports/v2/{uuid} | Get report by scan. RPC GetReportByScanId. SOURCE GetReportByScanID. PEP 8 get_report_by_id. Path uuid (clone uuid = image_id). Distinct from GET reports v1, GET reports v2 query image_id, GET combined image-assessment, DELETE entities images, SOURCE /image-assessment/entities/reports/v2/{uuid} (not a clone route). Success 200 MSA ContainerImage. Extra unused keys ignored. Required path uuid. falcon-container-image:read. Does not mutate. |
GET | /container-security/entities/policy-checks/v1?repository=&tag= | Check policy. RPC ImageMatchesPolicy. SOURCE ImageMatchesPolicy. PEP 8 image_matches_policy. Query repository, tag. Distinct from GET policy-checks v2, GET reports, HEAD inventory, GET credentials, SOURCE /policy-checks (not a clone route), SOURCE /image-assessment/entities/policy-checks/v2 (not a clone route). Success 200 MSA ContainerImage. Extra unused keys ignored. Required repository and tag. Empty match 200 empty resources. falcon-container-image:read. Does not mutate. |
POST | /container-security/entities/exports/v1 | Launch export. RPC LaunchExportJob. SOURCE LaunchExportJob. PEP 8 launch_export_job. Body JSON {resource, format}. Distinct from GET policy-checks v1, GET policy-checks v2, GET reports, HEAD inventory, GET /container-security/queries/exports/v1 (QueryExportJobs), GET /container-security/entities/exports/v1 (ReadExportJobs), GET /container-security/entities/exports/files/v1 (DownloadExportFile). Success 200 MSA ContainerExportJob. Extra unused keys ignored. Required resource. format csv or json default json. falcon-container-image:read. |
GET | /container-security/queries/exports/v1 | Query export jobs. RPC QueryExportJobs. SOURCE QueryExportJobs. PEP 8 query_export_jobs. Query filter. Distinct from POST /container-security/entities/exports/v1 (LaunchExportJob), GET /container-security/entities/exports/v1 (ReadExportJobs), GET /container-security/entities/exports/files/v1 (DownloadExportFile). Success 200 MSA string ids. Extra unused parameters ignored. Optional FQL resource/status. Cap 100. Empty match 200 empty resources. SOURCE raw JSON array is not the clone envelope. falcon-container-image:read. Does not mutate. |
GET | /container-security/entities/exports/v1?ids= | Read export jobs. RPC ReadExportJobs. SOURCE ReadExportJobs. PEP 8 read_export_jobs. Query ids. Distinct from POST /container-security/entities/exports/v1 (LaunchExportJob), GET /container-security/queries/exports/v1 (QueryExportJobs), GET /container-security/entities/exports/files/v1 (DownloadExportFile). Success 200 MSA ContainerExportJob. Extra unused parameters ignored. Required ids (max 100). Unknown skipped. Empty match 200 empty resources. falcon-container-image:read. Does not mutate. |
GET | /container-security/entities/exports/files/v1?id= | Download export file. RPC DownloadExportFile. SOURCE DownloadExportFile. PEP 8 download_export_file. Query id. Distinct from POST /container-security/entities/exports/v1 (LaunchExportJob), GET /container-security/entities/exports/v1 (ReadExportJobs), GET /container-security/queries/exports/v1 (QueryExportJobs). Success 200 MSA filename+content. Extra unused parameters ignored. Required id. Unknown 404. SOURCE raw file bytes are not the clone envelope. falcon-container-image:read. Does not mutate. |
GET | /container-security/entities/policy-checks/v2?repository=&tag= | Check prevention. RPC PolicyChecks. SOURCE PolicyChecks. PEP 8 check_prevention_policies. Query repository, tag. Distinct from GET policy-checks v1 (ImageMatchesPolicy), GET reports, HEAD inventory, POST exports, SOURCE /image-assessment/entities/policy-checks/v2 (not a clone route). Success 200 MSA ContainerPreventionCheck. Extra unused keys ignored. Required repository and tag. Empty match 200 empty resources. falcon-container-image:read. Does not mutate. |
GET | /container-security/aggregates/images/assessment-history/v1 | Read image assessment history. RPC AggregateImageAssessmentHistory. SOURCE AggregateImageAssessmentHistory. PEP 8 aggregate_assessment_history. Extra unused parameters and filter ignored. Distinct from GET /container-security/combined/image-assessment/images/v1, GET /container-security/aggregates/images/count/v1, GET /container-security/aggregates/images/count-by-os-distribution/v1, GET /container-security/aggregates/images/count-by-state/v1, GET /container-security/aggregates/images/count-by-distinct/v1, GET /container-security/aggregates/images/most-used/v1, GET /container-security/aggregates/vulnerabilities/count-by-severity/v1, GET /container-security/combined/base-images/v1, GET /container-security/combined/images/by-vulnerability-count/v1, GET /container-security/combined/images/detail/v1, and GET /container-security/combined/images/issues-summary/v1, and GET /container-security/combined/images/vulnerabilities-summary/v1, and POST /container-security/entities/base-images/v1, and DELETE /container-security/entities/base-images/v1, and GET /container-security/combined/images/export/v1, and Image assessment policies / remaining cloud. Success 200 MSA name + count + cid. falcon-container-image:read. Does not mutate. |
GET | /container-security/aggregates/images/count/v1 | Read image count. RPC AggregateImageCount. SOURCE AggregateImageCount. PEP 8 aggregate_count. Extra unused parameters and filter ignored. Distinct from GET /container-security/combined/image-assessment/images/v1, GET /container-security/aggregates/images/assessment-history/v1, GET /container-security/aggregates/images/count-by-os-distribution/v1, GET /container-security/aggregates/images/count-by-state/v1, GET /container-security/aggregates/images/count-by-distinct/v1, GET /container-security/aggregates/images/most-used/v1, GET /container-security/aggregates/vulnerabilities/count/v1, GET /container-security/combined/base-images/v1, GET /container-security/combined/images/by-vulnerability-count/v1, GET /container-security/combined/images/detail/v1, and GET /container-security/combined/images/issues-summary/v1, and GET /container-security/combined/images/vulnerabilities-summary/v1, and POST /container-security/entities/base-images/v1, and DELETE /container-security/entities/base-images/v1, and GET /container-security/combined/images/export/v1, and Image assessment policies / remaining cloud. Success 200 MSA count + cid. falcon-container-image:read. Does not mutate. |
GET | /container-security/aggregates/images/count-by-os-distribution/v1 | Read image count by base OS. RPC AggregateImageCountByBaseOS. SOURCE AggregateImageCountByBaseOS. PEP 8 aggregate_count_by_base_os. Extra unused parameters and filter ignored. Distinct from GET combined image-assessment, GET assessment-history, GET count, GET /container-security/aggregates/images/count-by-state/v1, GET /container-security/aggregates/images/count-by-distinct/v1, GET /container-security/aggregates/images/most-used/v1, GET /container-security/combined/base-images/v1, GET /container-security/combined/images/by-vulnerability-count/v1, GET /container-security/combined/images/detail/v1, and GET /container-security/combined/images/issues-summary/v1, and GET /container-security/combined/images/vulnerabilities-summary/v1, and POST /container-security/entities/base-images/v1, and DELETE /container-security/entities/base-images/v1, and GET /container-security/combined/images/export/v1, and Image assessment policies / remaining cloud. Success 200 MSA name + count + cid. falcon-container-image:read. Does not mutate. |
GET | /container-security/aggregates/images/count-by-state/v1 | Read image count by state. RPC AggregateImageCountByState. SOURCE AggregateImageCountByState. PEP 8 aggregate_count_by_state. Extra unused parameters and filter ignored. Distinct from GET combined image-assessment, GET assessment-history, GET count, GET count-by-os-distribution, GET /container-security/aggregates/images/count-by-distinct/v1, GET /container-security/aggregates/images/most-used/v1, GET /container-security/combined/base-images/v1, GET /container-security/combined/images/by-vulnerability-count/v1, GET /container-security/combined/images/detail/v1, and GET /container-security/combined/images/issues-summary/v1, and GET /container-security/combined/images/vulnerabilities-summary/v1, and POST /container-security/entities/base-images/v1, and DELETE /container-security/entities/base-images/v1, and GET /container-security/combined/images/export/v1, and Image assessment policies / remaining cloud. Success 200 MSA name + count + cid. falcon-container-image:read. Does not mutate. |
GET | /container-security/combined/base-images/v1 | Read combined base images. RPC CombinedBaseImages. SOURCE CombinedBaseImages. PEP 8 get_combined_base_images. Extra unused parameters and filter ignored. Distinct from GET combined image-assessment, GET aggregates, GET combined/images/by-vulnerability-count, GET /container-security/combined/images/detail/v1, and GET /container-security/combined/images/issues-summary/v1, and GET /container-security/combined/images/vulnerabilities-summary/v1, and POST /container-security/entities/base-images/v1, and DELETE /container-security/entities/base-images/v1, and GET /container-security/combined/images/export/v1, and Image assessment policies / remaining cloud. Success 200 MSA image_id + registry + repository + tag + image_digest + cid. falcon-container-image:read. Does not mutate. |
GET | /container-security/combined/images/by-vulnerability-count/v1 | Read images by vulnerability count. RPC CombinedImageByVulnerabilityCount. SOURCE CombinedImageByVulnerabilityCount. PEP 8 get_combined_images_by_vulnerability_count. Extra unused parameters, filter, limit, and offset ignored. Distinct from GET combined image-assessment, GET combined base-images, GET aggregates, GET /container-security/combined/images/detail/v1, and GET /container-security/combined/images/issues-summary/v1, and GET /container-security/combined/images/vulnerabilities-summary/v1, and POST /container-security/entities/base-images/v1, and DELETE /container-security/entities/base-images/v1, and GET /container-security/combined/images/export/v1, and Image assessment policies / remaining cloud. Success 200 MSA image_id + registry + repository + tag + vulnerability_count + cid. falcon-container-image:read. Does not mutate. |
GET | /container-security/combined/images/detail/v1 | Read combined image detail. RPC CombinedImageDetail. SOURCE CombinedImageDetail. PEP 8 get_combined_detail. Extra unused parameters, filter, with_config, sort, limit, and offset ignored. Distinct from GET combined image-assessment, GET combined base-images, GET by-vulnerability-count, and GET /container-security/combined/images/issues-summary/v1, and GET /container-security/combined/images/vulnerabilities-summary/v1, and POST /container-security/entities/base-images/v1, and DELETE /container-security/entities/base-images/v1, and GET /container-security/combined/images/export/v1, and Image assessment policies / remaining cloud. Success 200 MSA image_id + registry + repository + tag + digest + base_os + cid. falcon-container-image:read. Does not mutate. |
GET | /container-security/combined/images/issues-summary/v1 | Read combined image issues summary. RPC CombinedImageIssuesSummary. SOURCE CombinedImageIssuesSummary. PEP 8 get_combined_issues_summary. Extra unused parameters, cid, registry, repository, tag, image_digest, and include_base_image_vuln ignored. Distinct from GET combined image-assessment, GET combined base-images, GET by-vulnerability-count, GET combined image detail, and GET /container-security/combined/images/vulnerabilities-summary/v1, and POST /container-security/entities/base-images/v1, and DELETE /container-security/entities/base-images/v1, and GET /container-security/combined/images/export/v1, and Image assessment policies / remaining cloud. Success 200 MSA image_id + known_issues + is_dca_run + zero_day_impacted + cid. falcon-container-image:read. Does not mutate. |
GET | /container-security/combined/images/vulnerabilities-summary/v1 | Read combined image vulnerability summary. RPC CombinedImageVulnerabilitySummary. SOURCE CombinedImageVulnerabilitySummary. PEP 8 get_combined_vulnerabilities_summary. Extra unused parameters, cid, registry, repository, tag, image_digest, and include_base_image_vuln ignored. Distinct from GET combined image-assessment, GET combined base-images, GET by-vulnerability-count, GET combined image detail, GET combined image issues summary, and POST /container-security/entities/base-images/v1, and DELETE /container-security/entities/base-images/v1, and GET /container-security/combined/images/export/v1, and Image assessment policies / remaining cloud. Success 200 MSA image_id + total_vulnerabilities + cid. falcon-container-image:read. Does not mutate. |
POST | /container-security/entities/base-images/v1 | Create base image. RPC CreateBaseImagesEntities. SOURCE CreateBaseImagesEntities. PEP 8 create_base_images. Body JSON {image_id, registry, repository, tag, image_digest}. Extra unused parameters and base_images ignored. Distinct from GET combined image-assessment, GET combined base-images, GET combined image vulnerability summary, and DELETE /container-security/entities/base-images/v1, and GET /container-security/combined/images/export/v1, and Image assessment policies / remaining cloud. Success 200 MSA image_id + registry + repository + tag + image_digest + cid. Required image_id, registry, repository, tag, image_digest. Duplicate image_id 400. SOURCE {} is not the clone envelope. falcon-container-image:write. |
DELETE | /container-security/entities/base-images/v1?ids= | Delete base images. RPC DeleteBaseImages. SOURCE DeleteBaseImages. PEP 8 delete_base_images. Query ids. Extra unused parameters ignored. Distinct from DELETE /container-security/entities/images/v1, POST /container-security/entities/base-images/v1. Success 200 MSA image_id + registry + repository + tag + image_digest + cid. Required ids. Unknown id 404. SOURCE {} is not the clone envelope. falcon-container-image:write. |
GET | /container-security/combined/images/export/v1 | Read combined images export. RPC ReadCombinedImagesExport. SOURCE ReadCombinedImagesExport. PEP 8 read_combined_export. Extra unused filter, expand_vulnerabilities, expand_detections, limit, offset, sort, and parameters ignored. Distinct from GET combined image-assessment, GET combined images/detail, GET combined base-images, Launch export, and Image assessment policies / remaining cloud. Success 200 MSA image_id + registry + repository + tag + architecture + image_digest + cid + base_os. SOURCE array is not the clone envelope. falcon-container-image:read. Does not mutate. |
Empty filter returns every image in this CID. Allowed FQL properties:
image_id, registry, repository, tag. Unknown property or invalid
filter → 400. limit and offset must be ≥ 0 else 400. Omitted
limit defaults to 100 (capped at 100). Default sort is
repository.asc then tag.asc.
JSON is SOURCE snake_case: image_id, registry, repository, tag,
architecture, image_digest, cid. Export jobs use id,
resource, format, status, cid. Query export jobs returns MSA
string ids (job id only). SOURCE raw JSON array is not the clone
envelope. Read export jobs returns MSA ContainerExportJob rows.
Download export file returns MSA ContainerExportFile rows (id,
format, filename, content, cid). SOURCE raw file bytes are
not the clone envelope.
Prevention checks use action,
deny, evaluated_at, image_id, registry, repository, tag,
architecture, policy_type, cid. Image count uses count, cid.
Image count by base OS uses name, count, cid.
Image count by state uses name, count, cid.
Combined base images use image_id, registry, repository, tag,
image_digest, cid.
Images by vulnerability count use image_id, registry, repository, tag,
vulnerability_count, cid.
Combined image detail uses image_id, registry, repository, tag,
digest, base_os, cid.
Combined image issues summary uses image_id, known_issues,
is_dca_run, zero_day_impacted, cid.
Combined image vulnerability summary uses image_id, total_vulnerabilities,
cid.
Create base images use image_id, registry, repository, tag,
image_digest, cid. SOURCE {} is not the clone envelope.
Delete base images use image_id, registry, repository, tag,
image_digest, cid. SOURCE {} is not the clone envelope.
Combined images export uses image_id, registry, repository, tag,
architecture, image_digest, cid, base_os. SOURCE array is not
the clone envelope.
DELETE query image_id on /entities/images/v1 (distinct from GET
combined image-assessment, GET entities reports, registry POST/GET, and
Kubernetes). Missing image_id → 400 image_id is required. Unknown
image_id → 404. Extra unused query keys are ignored. Clone success
is 200 MSA ContainerImage. DELETE image_id=img-lab-2 returns that
row then removes it. GET combined after DELETE omits img-lab-2;
img-lab-1 remains. DELETE does not cascade container
vulnerability rows. falcon-container-image:read on DELETE → 403.
cs-local-hosts on DELETE → 403. SOURCE /images/{image_id} is
not a clone route. This is not GET combined image-assessment,
not GET entities reports, not registry POST/GET, and not
Kubernetes.
GET assessment query image_id on /entities/reports/v1 (distinct from
GET combined image-assessment, DELETE entities images, SOURCE /reports
(not a clone route), GetReportByReference v2, and GetReportByScanId v2
{uuid}). Missing image_id →
400 image_id is required. Unknown image_id → 404
unknown image id. Extra unused query keys including digest,
repository, tag, and parameters are ignored. Clone success is
200 MSA ContainerImage. GET image_id=img-lab-1 returns that row
(lab/api:1.0.0) matching GET combined fields. GET assessment does
not mutate. falcon-container-image:write only (cs-local-cimgw)
on GET assessment → 403. cs-local-hosts on GET assessment →
403. SOURCE /reports is not a clone route. This is not GET
combined image-assessment, not DELETE entities images, not
GetReportByReference v2, and not GetReportByScanId v2 {uuid}.
GET report by reference query image_id on /entities/reports/v2
(distinct from GET reports v1, GET combined image-assessment, DELETE
entities images, SOURCE /image-assessment/entities/reports/v2
(not a clone route), and GetReportByScanId v2 {uuid}). Missing
image_id → 400 image_id is required. Unknown image_id →
404 unknown image id. Extra unused query keys including
registry, repository, tag, digest, architecture,
report_format, and parameters are ignored. Clone success is
200 MSA ContainerImage. GET image_id=img-lab-1 returns that row
(lab/api:1.0.0) matching GET combined fields. GET report by
reference does not mutate. falcon-container-image:write only
(cs-local-cimgw) on GET report by reference → 403.
cs-local-hosts on GET report by reference → 403. SOURCE
/image-assessment/entities/reports/v2 is not a clone route. This
is not GET reports v1, not GET combined image-assessment,
not DELETE entities images, and not GetReportByScanId v2
{uuid}.
GET report by scan path uuid on /entities/reports/v2/{uuid}
(distinct from GET reports v1, GET reports v2 query image_id, GET
combined image-assessment, DELETE entities images, and SOURCE
/image-assessment/entities/reports/v2/{uuid} (not a clone route)).
Clone uuid = image_id. Missing or blank uuid → 400 uuid is required. Unknown uuid → 404 unknown uuid. Extra unused query
keys including report_format and parameters are ignored. Clone
success is 200 MSA ContainerImage. GET uuid=img-lab-1 returns that
row (lab/api:1.0.0) matching GET combined fields. GET report by scan
does not mutate. falcon-container-image:write only
(cs-local-cimgw) on GET report by scan → 403. cs-local-hosts on
GET report by scan → 403. SOURCE
/image-assessment/entities/reports/v2/{uuid} is not a clone route.
This is not GET reports v1, not GET reports v2 query image_id,
not GET combined image-assessment, and not DELETE entities
images.
GET check policy query repository and tag on
/entities/policy-checks/v1 (distinct from GET policy-checks v2, GET
reports, HEAD inventory, GET credentials, SOURCE /policy-checks
(not a clone route), and SOURCE
/image-assessment/entities/policy-checks/v2 (not a clone route)).
Missing repository → 400 repository is required. Missing tag
→ 400 tag is required. Extra unused query keys including
parameters are ignored. Clone success is 200 MSA ContainerImage.
GET repository=lab/api&tag=1.0.0 returns img-lab-1
(lab/api:1.0.0) matching GET combined fields. Unknown pair → 200
empty resources. GET check policy does not mutate.
falcon-container-image:write only (cs-local-cimgw) on GET check
policy → 403. cs-local-hosts on GET check policy → 403. SOURCE
/policy-checks is not a clone route. SOURCE
/image-assessment/entities/policy-checks/v2 is not a clone route.
This is not GET policy-checks v2, not GET reports, not HEAD
inventory, and not GET credentials.
POST launch export JSON {resource, format} on /entities/exports/v1
(distinct from GET policy-checks v1, GET policy-checks v2, GET reports,
HEAD inventory, GET /container-security/queries/exports/v1
(QueryExportJobs), GET /container-security/entities/exports/v1
(ReadExportJobs), GET
/container-security/entities/exports/files/v1 (DownloadExportFile)).
Missing
resource → 400 resource is required. Empty format defaults to
json. format not csv or json → 400 format must be csv or json. Extra unused body keys including expand_vulnerabilities, fql,
and sort are ignored. Clone success is 200 MSA
ContainerExportJob. POST resource=images / format=json returns a
job with resource images, format json, status ready, cid
cid-local-1. falcon-container-image:write only (cs-local-cimgw) on
POST launch export → 403. cs-local-hosts on POST launch export →
403. This is not GET policy-checks v1, not GET policy-checks
v2, not GET reports, not HEAD inventory, not GET
/container-security/queries/exports/v1 (QueryExportJobs), not GET
/container-security/entities/exports/v1 (ReadExportJobs), and
not GET /container-security/entities/exports/files/v1
(DownloadExportFile).
GET query export jobs optional filter on /queries/exports/v1
(distinct from POST /container-security/entities/exports/v1
(LaunchExportJob), GET /container-security/entities/exports/v1
(ReadExportJobs), GET /container-security/entities/exports/files/v1
(DownloadExportFile)). Extra unused query keys including
parameters are ignored. Clone success is 200 MSA string ids.
SOURCE raw JSON array is not the clone envelope. Empty filter
lists persisted jobs (cap 100, newest id first). Optional FQL
resource and status only. Invalid filter → 400. GET
filter=resource:'images' returns the launched job id. Unknown match →
200 empty resources. GET query export jobs does not mutate.
falcon-container-image:write only (cs-local-cimgw) on GET query
export jobs → 403. cs-local-hosts on GET query export jobs →
403. This is not POST /container-security/entities/exports/v1,
not GET /container-security/entities/exports/v1, and not GET
/container-security/entities/exports/files/v1.
GET read export jobs required ids on /entities/exports/v1
(distinct from POST /container-security/entities/exports/v1
(LaunchExportJob), GET /container-security/queries/exports/v1
(QueryExportJobs), GET /container-security/entities/exports/files/v1
(DownloadExportFile)). Extra unused query keys including
parameters are ignored. Clone success is 200 MSA
ContainerExportJob. Missing ids → 400 ids is required. More
than 100 ids → 400 ids must not exceed 100. Unknown ids are
skipped. None known → 200 empty resources. GET ids= of a launched
job returns that job (resource images, format json, status ready,
cid cid-local-1). GET read export jobs does not mutate.
falcon-container-image:write only (cs-local-cimgw) on GET read
export jobs → 403. cs-local-hosts on GET read export jobs →
403. This is not POST /container-security/entities/exports/v1,
not GET /container-security/queries/exports/v1, and not GET
/container-security/entities/exports/files/v1.
GET download export file required id on /entities/exports/files/v1
(distinct from POST /container-security/entities/exports/v1
(LaunchExportJob), GET /container-security/entities/exports/v1
(ReadExportJobs), GET /container-security/queries/exports/v1
(QueryExportJobs)). Extra unused query keys including parameters are
ignored. Clone success is 200 MSA filename+content. SOURCE raw file
bytes are not the clone envelope. Missing id → 400 id is required. Unknown id → 404 export job not found. GET id= of
a launched job returns that file (filename export-{id}.json, format
json, cid cid-local-1, content includes that id). GET download
export file does not mutate.
falcon-container-image:write only (cs-local-cimgw) on GET download
export file → 403. cs-local-hosts on GET download export file →
403. This is not POST /container-security/entities/exports/v1,
not GET /container-security/entities/exports/v1, and not GET
/container-security/queries/exports/v1.
GET check prevention query repository and tag on
/entities/policy-checks/v2 (distinct from GET policy-checks v1
(ImageMatchesPolicy), GET reports, HEAD inventory, POST exports, SOURCE
/image-assessment/entities/policy-checks/v2 (not a clone route)).
Missing repository → 400 repository is required. Missing tag
→ 400 tag is required. Extra unused query keys including
parameters are ignored. Clone success is 200 MSA
ContainerPreventionCheck. GET repository=lab/api&tag=1.0.0 returns
img-lab-1 with action allow, deny false, policy type
prevention, cid cid-local-1. Unknown pair → 200 empty
resources. GET check prevention does not mutate.
falcon-container-image:write only (cs-local-cimgw) on GET check
prevention → 403. cs-local-hosts on GET check prevention →
403. SOURCE /image-assessment/entities/policy-checks/v2 is not
a clone route. This is not GET policy-checks v1, not GET
reports, not HEAD inventory, and not POST exports.
This is not Kubernetes, Cloud AWS, or the HelloService template.
Kubernetes uses /kubernetes-protection/entities/kubernetes/clusters/v1:
Kubernetes. CSPM AWS uses
/cloud-connect-cspm-aws/entities/account/v1:
CSPM AWS. Combined container vulnerabilities uses
/container-security/combined/vulnerabilities/v1:
Container vulnerabilities. Container
registries uses /container-security/queries/registries/v1 and
/container-security/entities/registries/v1:
Container registries. Image assessment policies / remaining cloud and other cloud collections
are not implemented (not yet).
Seed images
image_id | registry | repository | tag | architecture | image_digest |
|---|---|---|---|---|---|
img-lab-1 | docker.io | lab/api | 1.0.0 | amd64 | sha256:labapi01 |
img-lab-2 | docker.io | lab/worker | latest | arm64 | sha256:labworker02 |
cid is cid-local-1. Empty filters return both.
filter=repository:'lab/api' returns img-lab-1. DELETE
image_id=img-lab-2 removes that row. GET combined after DELETE
omits img-lab-2; img-lab-1 remains. Combined vulnerabilities for
img-lab-2 are not deleted. GET reports image_id=img-lab-1
returns that row (lab/api:1.0.0) matching GET combined fields. GET
reports v2 image_id=img-lab-1 returns that row (lab/api:1.0.0)
matching GET combined fields. GET reports v2 {uuid} img-lab-1
returns that row (lab/api:1.0.0) matching GET combined fields. GET
policy-checks repository=lab/api&tag=1.0.0 returns img-lab-1
(lab/api:1.0.0) matching GET combined fields. Unknown pair returns
empty resources. POST exports resource=images / format=json returns
a job with resource images, format json, status ready, cid
cid-local-1. GET queries/exports filter=resource:'images' returns
that job id (MSA string resources). Empty filter lists persisted jobs
(cap 100). Unknown filter match returns empty resources. GET
entities/exports ids= of that exp- id returns the job (MSA
ContainerExportJob). Unknown ids are skipped. None known returns empty
resources. GET entities/exports/files id= of that exp- id returns
the file (MSA filename+content, filename export-{id}.json). Unknown
id is 404. GET
policy-checks v2 repository=lab/api&tag=1.0.0
returns img-lab-1 with action allow, deny false, policy type
prevention, cid cid-local-1. Unknown pair returns empty resources.
GET aggregates/images/count returns one resource count 2 and cid
cid-local-1. GET aggregates/images/count-by-os-distribution returns
name alpine then ubuntu each with count 1 and cid
cid-local-1. GET aggregates/images/count-by-state returns
name running then stopped each with count 1 and cid
cid-local-1. GET combined/base-images returns image_id base-lab-1
then base-lab-2 each with cid cid-local-1. base-lab-1 is registry
docker.io repository library/ubuntu tag 22.04 digest
sha256:baseubuntu01. base-lab-2 is registry ghcr.io repository
lab/runtime tag 1.2.0 digest sha256:baseruntime02.
GET combined/images/by-vulnerability-count returns image_id img-lab-1
then img-lab-2 each with vulnerability_count 1 and cid cid-local-1.
GET combined/images/detail returns image_id img-lab-1 then img-lab-2
each with cid cid-local-1. img-lab-1 is digest sha256:labapi01
base_os ubuntu. img-lab-2 is digest sha256:labworker02
base_os alpine.
GET combined/images/issues-summary returns image_id img-lab-1 then
img-lab-2 each with known_issues 1, is_dca_run false,
zero_day_impacted false, and cid cid-local-1.
GET combined/images/vulnerabilities-summary returns image_id img-lab-1 then
img-lab-2 each with total_vulnerabilities 1 and cid cid-local-1.
POST entities/base-images image_id=base-lab-3 registry docker.io
repository lab/created tag 0.1.0 digest sha256:labcreated03 returns
that row with cid cid-local-1. GET combined/base-images after POST
includes base-lab-3. Duplicate image_id is 400. SOURCE {} is
not the clone envelope.
DELETE entities/base-images ids=base-lab-2 returns that row with cid
cid-local-1. GET combined/base-images after DELETE omits base-lab-2.
Unknown ids is 404. Extra unused parameters ignored. SOURCE {}
is not the clone envelope.
GET combined/images/export returns image_id img-lab-1 then
img-lab-2 each with cid cid-local-1. Extra unused filter,
expand_vulnerabilities, expand_detections, limit, offset,
sort, and parameters ignored. SOURCE array is not the clone
envelope.
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 images (cookie)
Empty filters return at least the two seed ids, including img-lab-1:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/combined/image-assessment/images/v1'
filter=repository:'lab/api' returns img-lab-1:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/combined/image-assessment/images/v1?filter=repository:%27lab/api%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/combined/image-assessment/images/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/combined/image-assessment/images/v1'
Image assessment policies / remaining cloud
and other cloud collections are not implemented (not yet).
Kubernetes is a separate collection:
Kubernetes. CSPM AWS is a separate collection:
CSPM AWS. Combined container vulnerabilities is a
separate collection:
Container vulnerabilities. Container
registries is a separate collection:
Container registries. This is not
the HelloService template (GET /api/hello).
Delete image (cookie)
DELETE image_id=img-lab-2 on /entities/images/v1 returns that image.
Success is 200 MSA ContainerImage. GET combined after DELETE omits
img-lab-2; img-lab-1 remains. This is not GET combined
image-assessment, not GET entities reports, not registry
POST/GET, and not Kubernetes. SOURCE /images/{image_id} is not
a clone route. Extra unused query keys including foo are ignored.
DELETE does not cascade container vulnerability rows:
curl -sS -X DELETE -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/entities/images/v1?image_id=img-lab-2&foo=bar'
GET combined after DELETE omits img-lab-2:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/combined/image-assessment/images/v1'
Missing image_id is 400:
curl -sS -o /dev/null -w '%{http_code}\n' \
-X DELETE -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/entities/images/v1'
Unknown image_id is 404:
curl -sS -o /dev/null -w '%{http_code}\n' \
-X DELETE -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/entities/images/v1?image_id=img-missing'
cs-local-hosts (hosts:read only) is 403 on DELETE:
TOKEN='<access_token from cs-local-hosts>'
curl -sS -o /dev/null -w '%{http_code}\n' \
-X DELETE -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
'http://127.0.0.1:8088/container-security/entities/images/v1?image_id=img-lab-2'
falcon-container-image:read (cs-local-cimg) is 403 on DELETE:
TOKEN='<access_token from cs-local-cimg>'
curl -sS -o /dev/null -w '%{http_code}\n' \
-X DELETE -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
'http://127.0.0.1:8088/container-security/entities/images/v1?image_id=img-lab-2'
No cookie and no Bearer is 401 on DELETE:
curl -sS -o /dev/null -w '%{http_code}\n' \
-X DELETE -H 'Host: crowdstrike-api.localhost' \
'http://127.0.0.1:8088/container-security/entities/images/v1?image_id=img-lab-2'
Image assessment policies / remaining cloud
and other cloud collections are not implemented (not yet). Container
registries is a separate collection:
Container registries. Combined container
vulnerabilities is a separate collection:
Container vulnerabilities. This is not
Kubernetes. This is not the HelloService template (GET /api/hello).
Get assessment (cookie)
GET image_id=img-lab-1 on /entities/reports/v1 returns that image
(lab/api:1.0.0). Success is 200 MSA ContainerImage matching GET
combined fields. This is not GET combined image-assessment, not
DELETE entities images, not SOURCE /reports (not a clone route),
not GetReportByReference v2, and not GetReportByScanId v2
{uuid}. Extra unused query keys including
digest, repository, tag, parameters, and foo are ignored. GET
assessment does not mutate:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/entities/reports/v1?image_id=img-lab-1&digest=x&repository=y&tag=z¶meters=p&foo=bar'
GET combined after GET assessment still includes img-lab-1:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/combined/image-assessment/images/v1'
Missing image_id 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/entities/reports/v1'
Unknown image_id is 404:
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/entities/reports/v1?image_id=img-missing'
cs-local-hosts (hosts:read only) is 403 on GET assessment:
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/entities/reports/v1?image_id=img-lab-1'
falcon-container-image:write (cs-local-cimgw) is 403 on GET
assessment:
TOKEN='<access_token from cs-local-cimgw>'
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/entities/reports/v1?image_id=img-lab-1'
No cookie and no Bearer is 401 on GET assessment:
curl -sS -o /dev/null -w '%{http_code}\n' \
-H 'Host: crowdstrike-api.localhost' \
'http://127.0.0.1:8088/container-security/entities/reports/v1?image_id=img-lab-1'
Image assessment policies / remaining cloud
and other cloud collections are not implemented (not yet). Container
registries is a separate collection:
Container registries. Combined container
vulnerabilities is a separate collection:
Container vulnerabilities. This is not
Kubernetes. This is not the HelloService template (GET /api/hello).
Get report by reference (cookie)
GET image_id=img-lab-1 on /entities/reports/v2 returns that image
(lab/api:1.0.0). Success is 200 MSA ContainerImage matching GET
combined fields. This is not GET reports v1, not GET combined
image-assessment, not DELETE entities images, not SOURCE
/image-assessment/entities/reports/v2 (not a clone route), and not
GetReportByScanId v2 {uuid}. Extra unused
query keys including registry, repository, tag, digest,
architecture, report_format, parameters, and foo are ignored.
GET report by reference does not mutate:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/entities/reports/v2?image_id=img-lab-1®istry=x&repository=y&tag=z&digest=d&architecture=a&report_format=json¶meters=p&foo=bar'
GET combined after GET report by reference still includes img-lab-1:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/combined/image-assessment/images/v1'
Missing image_id 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/entities/reports/v2'
Unknown image_id is 404:
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/entities/reports/v2?image_id=img-missing'
cs-local-hosts (hosts:read only) is 403 on GET report by
reference:
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/entities/reports/v2?image_id=img-lab-1'
falcon-container-image:write (cs-local-cimgw) is 403 on GET
report by reference:
TOKEN='<access_token from cs-local-cimgw>'
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/entities/reports/v2?image_id=img-lab-1'
No cookie and no Bearer is 401 on GET report by reference:
curl -sS -o /dev/null -w '%{http_code}\n' \
-H 'Host: crowdstrike-api.localhost' \
'http://127.0.0.1:8088/container-security/entities/reports/v2?image_id=img-lab-1'
Image assessment policies / remaining cloud
and other cloud collections are not implemented (not yet). Container
registries is a separate collection:
Container registries. Combined container
vulnerabilities is a separate collection:
Container vulnerabilities. This is not
Kubernetes. This is not the HelloService template (GET /api/hello).
Get report by scan (cookie)
GET uuid=img-lab-1 on /entities/reports/v2/{uuid} returns that image
(lab/api:1.0.0). Success is 200 MSA ContainerImage matching GET
combined fields. This is not GET reports v1, not GET reports v2
query image_id, not GET combined image-assessment, not DELETE
entities images, and not SOURCE
/image-assessment/entities/reports/v2/{uuid} (not a clone route). Extra
unused query keys including report_format, parameters, and foo are
ignored. GET report by scan does not mutate:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/entities/reports/v2/img-lab-1?report_format=json¶meters=p&foo=bar'
GET combined after GET report by scan still includes img-lab-1:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/combined/image-assessment/images/v1'
Blank uuid 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/entities/reports/v2/%20'
Unknown uuid is 404:
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/entities/reports/v2/img-missing'
cs-local-hosts (hosts:read only) is 403 on GET report by scan:
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/entities/reports/v2/img-lab-1'
falcon-container-image:write (cs-local-cimgw) is 403 on GET
report by scan:
TOKEN='<access_token from cs-local-cimgw>'
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/entities/reports/v2/img-lab-1'
No cookie and no Bearer is 401 on GET report by scan:
curl -sS -o /dev/null -w '%{http_code}\n' \
-H 'Host: crowdstrike-api.localhost' \
'http://127.0.0.1:8088/container-security/entities/reports/v2/img-lab-1'
Image assessment policies / remaining cloud
and other cloud collections are not implemented (not yet). Container
registries is a separate collection:
Container registries. Combined container
vulnerabilities is a separate collection:
Container vulnerabilities. This is not
Kubernetes. This is not the HelloService template (GET /api/hello).
Check policy (cookie)
GET repository=lab/api&tag=1.0.0 on /entities/policy-checks/v1
returns img-lab-1 (lab/api:1.0.0). Success is 200 MSA
ContainerImage matching GET combined fields. This is not GET
policy-checks v2, not GET reports, not HEAD inventory, not
GET credentials, not SOURCE /policy-checks (not a clone route),
and not SOURCE /image-assessment/entities/policy-checks/v2 (not a
clone route). Extra unused query keys including parameters and foo
are ignored. Unknown pair returns 200 empty resources. GET check
policy does not mutate:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/entities/policy-checks/v1?repository=lab/api&tag=1.0.0¶meters=p&foo=bar'
GET combined after GET check policy still includes img-lab-1:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/combined/image-assessment/images/v1'
Missing repository 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/entities/policy-checks/v1?tag=1.0.0'
Missing tag 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/entities/policy-checks/v1?repository=lab/api'
Unknown pair is 200 empty resources:
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/entities/policy-checks/v1?repository=missing/repo&tag=missing'
cs-local-hosts (hosts:read only) is 403 on GET check policy:
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/entities/policy-checks/v1?repository=lab/api&tag=1.0.0'
falcon-container-image:write (cs-local-cimgw) is 403 on GET
check policy:
TOKEN='<access_token from cs-local-cimgw>'
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/entities/policy-checks/v1?repository=lab/api&tag=1.0.0'
No cookie and no Bearer is 401 on GET check policy:
curl -sS -o /dev/null -w '%{http_code}\n' \
-H 'Host: crowdstrike-api.localhost' \
'http://127.0.0.1:8088/container-security/entities/policy-checks/v1?repository=lab/api&tag=1.0.0'
Image assessment policies / remaining cloud
and other cloud collections are not implemented (not yet). Container
registries is a separate collection:
Container registries. Combined container
vulnerabilities is a separate collection:
Container vulnerabilities. This is not
Kubernetes. This is not the HelloService template (GET /api/hello).
Launch export (cookie)
POST resource=images / format=json on /entities/exports/v1 returns
a job with resource images, format json, status ready, cid
cid-local-1. Success is 200 MSA ContainerExportJob. This is
not GET policy-checks v1, not GET policy-checks v2, not GET
reports, not HEAD inventory, not GET
/container-security/queries/exports/v1 (QueryExportJobs), not GET
/container-security/entities/exports/v1 (ReadExportJobs), and
not GET /container-security/entities/exports/files/v1
(DownloadExportFile). Extra unused body keys including
expand_vulnerabilities, fql, and sort are ignored:
curl -sS -X POST -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
-H 'Content-Type: application/json' \
-d '{"resource":"images","format":"json","expand_vulnerabilities":true,"fql":"x","sort":"y"}' \
'http://127.0.0.1:8088/container-security/entities/exports/v1'
Missing resource is 400:
curl -sS -o /dev/null -w '%{http_code}\n' \
-X POST -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
-H 'Content-Type: application/json' \
-d '{"format":"json"}' \
'http://127.0.0.1:8088/container-security/entities/exports/v1'
cs-local-hosts (hosts:read only) is 403 on POST launch export:
TOKEN='<access_token from cs-local-hosts>'
curl -sS -o /dev/null -w '%{http_code}\n' \
-X POST -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
-H 'Content-Type: application/json' \
-d '{"resource":"images","format":"json"}' \
'http://127.0.0.1:8088/container-security/entities/exports/v1'
falcon-container-image:write (cs-local-cimgw) is 403 on POST
launch export:
TOKEN='<access_token from cs-local-cimgw>'
curl -sS -o /dev/null -w '%{http_code}\n' \
-X POST -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
-H 'Content-Type: application/json' \
-d '{"resource":"images","format":"json"}' \
'http://127.0.0.1:8088/container-security/entities/exports/v1'
No cookie and no Bearer is 401 on POST launch export:
curl -sS -o /dev/null -w '%{http_code}\n' \
-X POST -H 'Host: crowdstrike-api.localhost' \
-H 'Content-Type: application/json' \
-d '{"resource":"images","format":"json"}' \
'http://127.0.0.1:8088/container-security/entities/exports/v1'
Image assessment policies / remaining cloud
and other cloud collections are not implemented (not yet). Container
registries is a separate collection:
Container registries. Combined container
vulnerabilities is a separate collection:
Container vulnerabilities. This is not
Kubernetes. This is not the HelloService template (GET /api/hello).
Query export jobs (cookie)
Launch export first so a job id exists. GET filter=resource:'images'
on /queries/exports/v1 returns that job id. Success is 200 MSA
string ids. Cap 100. SOURCE raw JSON array is not the clone
envelope. This is not POST /container-security/entities/exports/v1
(LaunchExportJob), not GET /container-security/entities/exports/v1
(ReadExportJobs), and not GET
/container-security/entities/exports/files/v1 (DownloadExportFile). Extra unused query keys including parameters and foo are
ignored. Empty match returns 200 empty resources. GET query export
jobs does not mutate:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/queries/exports/v1?filter=resource:%27images%27¶meters=p&foo=bar'
GET combined after GET query export jobs still includes img-lab-1:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/combined/image-assessment/images/v1'
Invalid FQL 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/queries/exports/v1?filter=bogus:%27x%27'
Empty match is 200 empty resources:
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/queries/exports/v1?filter=resource:%27no-such-resource%27'
cs-local-hosts (hosts:read only) is 403 on GET query export
jobs:
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/queries/exports/v1?filter=resource:%27images%27'
falcon-container-image:write (cs-local-cimgw) is 403 on GET
query export jobs:
TOKEN='<access_token from cs-local-cimgw>'
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/queries/exports/v1?filter=resource:%27images%27'
No cookie and no Bearer is 401 on GET query export jobs:
curl -sS -o /dev/null -w '%{http_code}\n' \
-H 'Host: crowdstrike-api.localhost' \
'http://127.0.0.1:8088/container-security/queries/exports/v1?filter=resource:%27images%27'
Image assessment policies / remaining cloud
and other cloud collections are not implemented (not yet). Container
registries is a separate collection:
Container registries. Combined container
vulnerabilities is a separate collection:
Container vulnerabilities. This is not
Kubernetes. This is not the HelloService template (GET /api/hello).
Read export jobs (cookie)
Launch export first so an exp- id exists (or Query export jobs). GET
ids= of that id on /entities/exports/v1 returns that job. Success is
200 MSA ContainerExportJob. Required ids (max 100). This is
not POST /container-security/entities/exports/v1
(LaunchExportJob), not GET /container-security/queries/exports/v1
(QueryExportJobs), and not GET
/container-security/entities/exports/files/v1 (DownloadExportFile). Extra unused query keys including parameters and foo are
ignored. Unknown ids are skipped. Empty match returns 200 empty
resources. GET read export jobs does not mutate:
ID='<exp- id from Launch export or Query export jobs>'
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
"http://127.0.0.1:8088/container-security/entities/exports/v1?ids=${ID}¶meters=p&foo=bar"
GET combined after GET read export jobs still includes img-lab-1:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/combined/image-assessment/images/v1'
Missing ids 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/entities/exports/v1'
Unknown ids is 200 empty resources:
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/entities/exports/v1?ids=exp-missing'
cs-local-hosts (hosts:read only) is 403 on GET read export
jobs:
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/entities/exports/v1?ids=exp-missing'
falcon-container-image:write (cs-local-cimgw) is 403 on GET
read export jobs:
TOKEN='<access_token from cs-local-cimgw>'
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/entities/exports/v1?ids=exp-missing'
No cookie and no Bearer is 401 on GET read export jobs:
curl -sS -o /dev/null -w '%{http_code}\n' \
-H 'Host: crowdstrike-api.localhost' \
'http://127.0.0.1:8088/container-security/entities/exports/v1?ids=exp-missing'
Image assessment policies / remaining cloud
and other cloud collections are not implemented (not yet). Container
registries is a separate collection:
Container registries. Combined container
vulnerabilities is a separate collection:
Container vulnerabilities. This is not
Kubernetes. This is not the HelloService template (GET /api/hello).
Download export file (cookie)
Launch export first so an exp- id exists. GET id= of that id on
/entities/exports/files/v1 returns that file. Success is 200 MSA
filename+content. Required id. SOURCE raw file bytes are not the
clone envelope. This is not POST
/container-security/entities/exports/v1 (LaunchExportJob), not GET
/container-security/entities/exports/v1 (ReadExportJobs), and not
GET /container-security/queries/exports/v1 (QueryExportJobs). Extra
unused query keys including parameters and foo are ignored. Unknown
id is 404. GET download export file does not mutate:
ID='<exp- id from Launch export>'
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
"http://127.0.0.1:8088/container-security/entities/exports/files/v1?id=${ID}¶meters=p&foo=bar"
GET combined after GET download export file still includes img-lab-1:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/combined/image-assessment/images/v1'
Missing id 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/entities/exports/files/v1'
Unknown id is 404:
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/entities/exports/files/v1?id=exp-missing'
cs-local-hosts (hosts:read only) is 403 on GET download export
file:
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/entities/exports/files/v1?id=exp-missing'
falcon-container-image:write (cs-local-cimgw) is 403 on GET
download export file:
TOKEN='<access_token from cs-local-cimgw>'
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/entities/exports/files/v1?id=exp-missing'
No cookie and no Bearer is 401 on GET download export file:
curl -sS -o /dev/null -w '%{http_code}\n' \
-H 'Host: crowdstrike-api.localhost' \
'http://127.0.0.1:8088/container-security/entities/exports/files/v1?id=exp-missing'
Image assessment policies / remaining cloud
and other cloud collections are not implemented (not yet). Container
registries is a separate collection:
Container registries. Combined container
vulnerabilities is a separate collection:
Container vulnerabilities. This is not
Kubernetes. This is not the HelloService template (GET /api/hello).
Check prevention (cookie)
GET repository=lab/api&tag=1.0.0 on /entities/policy-checks/v2
returns img-lab-1 with action allow, deny false, policy type
prevention, and CID cid-local-1. Success is 200 MSA
ContainerPreventionCheck. This is not GET policy-checks v1, not
GET reports, not HEAD inventory, not POST exports, and not
SOURCE /image-assessment/entities/policy-checks/v2 (not a clone
route). Extra unused query keys including parameters and foo are
ignored. Unknown pair returns 200 empty resources. GET check
prevention does not mutate:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/entities/policy-checks/v2?repository=lab/api&tag=1.0.0¶meters=p&foo=bar'
GET combined after GET check prevention still includes img-lab-1:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/combined/image-assessment/images/v1'
Missing repository 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/entities/policy-checks/v2?tag=1.0.0'
Missing tag 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/entities/policy-checks/v2?repository=lab/api'
Unknown pair is 200 empty resources:
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/entities/policy-checks/v2?repository=missing/repo&tag=missing'
cs-local-hosts (hosts:read only) is 403 on GET check prevention:
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/entities/policy-checks/v2?repository=lab/api&tag=1.0.0'
falcon-container-image:write (cs-local-cimgw) is 403 on GET
check prevention:
TOKEN='<access_token from cs-local-cimgw>'
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/entities/policy-checks/v2?repository=lab/api&tag=1.0.0'
No cookie and no Bearer is 401 on GET check prevention:
curl -sS -o /dev/null -w '%{http_code}\n' \
-H 'Host: crowdstrike-api.localhost' \
'http://127.0.0.1:8088/container-security/entities/policy-checks/v2?repository=lab/api&tag=1.0.0'
Image assessment policies / remaining cloud
and other cloud collections are not implemented (not yet). Container
registries is a separate collection:
Container registries. Combined container
vulnerabilities is a separate collection:
Container vulnerabilities. This is not
Kubernetes. This is not the HelloService template (GET /api/hello).
Read image assessment history (cookie)
GET on /aggregates/images/assessment-history/v1 returns
name 2024-06-02T00:00:00Z then 2024-01-15T00:00:00Z each with count 1
and cid cid-local-1. Success is
200 MSA name + count + cid. Extra unused query keys
including parameters and filter are ignored. This is
not GET /container-security/combined/image-assessment/images/v1.
This is not GET /container-security/aggregates/images/count/v1.
This is not GET /container-security/aggregates/images/count-by-os-distribution/v1.
This is not GET /container-security/aggregates/images/count-by-state/v1.
This is not GET /container-security/aggregates/images/count-by-distinct/v1.
This is not GET /container-security/aggregates/images/most-used/v1.
This is not GET /container-security/aggregates/vulnerabilities/count-by-severity/v1.
This is not GET /container-security/combined/base-images/v1.
This is not GET /container-security/combined/images/by-vulnerability-count/v1.
This is not GET /container-security/combined/images/detail/v1.
This is not GET /container-security/combined/images/issues-summary/v1.
This is not GET /container-security/combined/images/vulnerabilities-summary/v1.
This is not POST /container-security/entities/base-images/v1.
This is not DELETE /container-security/entities/base-images/v1.
This is not GET /container-security/combined/images/export/v1.
This is not Image assessment policies / remaining cloud.
GET assessment history does not mutate:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/aggregates/images/assessment-history/v1?parameters=x&filter=bogus:%27x%27'
GET combined after GET assessment history still includes
img-lab-1 and img-lab-2:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/combined/image-assessment/images/v1'
GET count-by-severity after GET assessment history still includes
name high then medium:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/aggregates/vulnerabilities/count-by-severity/v1'
cs-local-hosts (hosts:read only) is 403 on GET
assessment history:
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/images/assessment-history/v1'
cs-local-cimg (falcon-container-image:read) is 200 on GET
assessment history:
TOKEN='<access_token from cs-local-cimg>'
curl -sS -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
'http://127.0.0.1:8088/container-security/aggregates/images/assessment-history/v1'
falcon-container-image:write (cs-local-cimgw) is 403 on GET
assessment history:
TOKEN='<access_token from cs-local-cimgw>'
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/images/assessment-history/v1'
cs-local-fcliw is 403 on GET assessment history:
TOKEN='<access_token from cs-local-fcliw>'
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/images/assessment-history/v1'
No cookie and no Bearer is 401 on GET assessment history:
curl -sS -o /dev/null -w '%{http_code}\n' \
-H 'Host: crowdstrike-api.localhost' \
'http://127.0.0.1:8088/container-security/aggregates/images/assessment-history/v1'
Image assessment policies / remaining cloud
and other cloud collections are not implemented (not yet). Container
registries is a separate collection:
Container registries. Combined container
vulnerabilities is a separate collection:
Container vulnerabilities. This is not
Kubernetes. This is not the HelloService template (GET /api/hello).
Read image count (cookie)
GET on /aggregates/images/count/v1 returns count 2 and cid
cid-local-1. Success is
200 MSA count + cid. Extra unused query keys
including parameters and filter are ignored. This is
not GET /container-security/combined/image-assessment/images/v1.
This is not GET /container-security/aggregates/images/assessment-history/v1.
This is not GET /container-security/aggregates/images/count-by-os-distribution/v1.
This is not GET /container-security/aggregates/images/count-by-state/v1.
This is not GET /container-security/aggregates/images/count-by-distinct/v1.
This is not GET /container-security/aggregates/images/most-used/v1.
This is not GET /container-security/aggregates/vulnerabilities/count/v1.
This is not GET /container-security/combined/base-images/v1.
This is not GET /container-security/combined/images/by-vulnerability-count/v1.
This is not GET /container-security/combined/images/detail/v1.
This is not GET /container-security/combined/images/issues-summary/v1.
This is not GET /container-security/combined/images/vulnerabilities-summary/v1.
This is not POST /container-security/entities/base-images/v1.
This is not DELETE /container-security/entities/base-images/v1.
This is not GET /container-security/combined/images/export/v1.
This is not Image assessment policies / remaining cloud.
GET image count does not mutate:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/aggregates/images/count/v1?parameters=x&filter=bogus:%27x%27'
GET combined after GET image count still includes
img-lab-1 and img-lab-2:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/combined/image-assessment/images/v1'
GET assessment history after GET image count still includes
name 2024-06-02T00:00:00Z then 2024-01-15T00:00:00Z:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/aggregates/images/assessment-history/v1'
cs-local-hosts (hosts:read only) is 403 on GET
image count:
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/images/count/v1'
cs-local-cimg (falcon-container-image:read) is 200 on GET
image count:
TOKEN='<access_token from cs-local-cimg>'
curl -sS -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
'http://127.0.0.1:8088/container-security/aggregates/images/count/v1'
falcon-container-image:write (cs-local-cimgw) is 403 on GET
image count:
TOKEN='<access_token from cs-local-cimgw>'
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/images/count/v1'
cs-local-fcliw is 403 on GET image count:
TOKEN='<access_token from cs-local-fcliw>'
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/images/count/v1'
No cookie and no Bearer is 401 on GET image count:
curl -sS -o /dev/null -w '%{http_code}\n' \
-H 'Host: crowdstrike-api.localhost' \
'http://127.0.0.1:8088/container-security/aggregates/images/count/v1'
Image assessment policies / remaining cloud
and other cloud collections are not implemented (not yet). Container
registries is a separate collection:
Container registries. Combined container
vulnerabilities is a separate collection:
Container vulnerabilities. This is not
Kubernetes. This is not the HelloService template (GET /api/hello).
Read image count by base OS (cookie)
GET on /aggregates/images/count-by-os-distribution/v1 returns
name alpine then ubuntu each with count 1
and cid cid-local-1. Success is
200 MSA name + count + cid. Extra unused query keys
including parameters and filter are ignored. This is
not GET /container-security/combined/image-assessment/images/v1.
This is not GET /container-security/aggregates/images/assessment-history/v1.
This is not GET /container-security/aggregates/images/count/v1.
This is not GET /container-security/aggregates/images/count-by-state/v1.
This is not GET /container-security/aggregates/images/count-by-distinct/v1.
This is not GET /container-security/aggregates/images/most-used/v1.
This is not GET /container-security/combined/base-images/v1.
This is not GET /container-security/combined/images/by-vulnerability-count/v1.
This is not GET /container-security/combined/images/detail/v1.
This is not GET /container-security/combined/images/issues-summary/v1.
This is not GET /container-security/combined/images/vulnerabilities-summary/v1.
This is not POST /container-security/entities/base-images/v1.
This is not DELETE /container-security/entities/base-images/v1.
This is not GET /container-security/combined/images/export/v1.
This is not Image assessment policies / remaining cloud.
GET image count by base OS does not mutate:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/aggregates/images/count-by-os-distribution/v1?parameters=x&filter=bogus:%27x%27'
GET combined after GET image count by base OS still includes
img-lab-1 and img-lab-2:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/combined/image-assessment/images/v1'
GET image count after GET image count by base OS still includes
count 2:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/aggregates/images/count/v1'
cs-local-hosts (hosts:read only) is 403 on GET
image count by base OS:
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/images/count-by-os-distribution/v1'
cs-local-cimg (falcon-container-image:read) is 200 on GET
image count by base OS:
TOKEN='<access_token from cs-local-cimg>'
curl -sS -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
'http://127.0.0.1:8088/container-security/aggregates/images/count-by-os-distribution/v1'
falcon-container-image:write (cs-local-cimgw) is 403 on GET
image count by base OS:
TOKEN='<access_token from cs-local-cimgw>'
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/images/count-by-os-distribution/v1'
cs-local-fcliw is 403 on GET image count by base OS:
TOKEN='<access_token from cs-local-fcliw>'
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/images/count-by-os-distribution/v1'
No cookie and no Bearer is 401 on GET image count by base OS:
curl -sS -o /dev/null -w '%{http_code}\n' \
-H 'Host: crowdstrike-api.localhost' \
'http://127.0.0.1:8088/container-security/aggregates/images/count-by-os-distribution/v1'
Image assessment policies / remaining cloud
and other cloud collections are not implemented (not yet). Container
registries is a separate collection:
Container registries. Combined container
vulnerabilities is a separate collection:
Container vulnerabilities. This is not
Kubernetes. This is not the HelloService template (GET /api/hello).
Read image count by state (cookie)
GET on /aggregates/images/count-by-state/v1 returns
name running then stopped each with count 1
and cid cid-local-1. Success is
200 MSA name + count + cid. Extra unused query keys
including parameters and filter are ignored. This is
not GET /container-security/combined/image-assessment/images/v1.
This is not GET /container-security/aggregates/images/assessment-history/v1.
This is not GET /container-security/aggregates/images/count/v1.
This is not GET /container-security/aggregates/images/count-by-os-distribution/v1.
This is not GET /container-security/aggregates/images/count-by-distinct/v1.
This is not GET /container-security/aggregates/images/most-used/v1.
This is not GET /container-security/combined/base-images/v1.
This is not GET /container-security/combined/images/by-vulnerability-count/v1.
This is not GET /container-security/combined/images/detail/v1.
This is not GET /container-security/combined/images/issues-summary/v1.
This is not GET /container-security/combined/images/vulnerabilities-summary/v1.
This is not POST /container-security/entities/base-images/v1.
This is not DELETE /container-security/entities/base-images/v1.
This is not GET /container-security/combined/images/export/v1.
This is not Image assessment policies / remaining cloud.
GET image count by state does not mutate:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/aggregates/images/count-by-state/v1?parameters=x&filter=bogus:%27x%27'
GET combined after GET image count by state still includes
img-lab-1 and img-lab-2:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/combined/image-assessment/images/v1'
GET image count by base OS after GET image count by state still includes
name alpine then ubuntu:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/aggregates/images/count-by-os-distribution/v1'
cs-local-hosts (hosts:read only) is 403 on GET
image count by state:
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/images/count-by-state/v1'
cs-local-cimg (falcon-container-image:read) is 200 on GET
image count by state:
TOKEN='<access_token from cs-local-cimg>'
curl -sS -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
'http://127.0.0.1:8088/container-security/aggregates/images/count-by-state/v1'
falcon-container-image:write (cs-local-cimgw) is 403 on GET
image count by state:
TOKEN='<access_token from cs-local-cimgw>'
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/images/count-by-state/v1'
cs-local-fcliw is 403 on GET image count by state:
TOKEN='<access_token from cs-local-fcliw>'
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/images/count-by-state/v1'
No cookie and no Bearer is 401 on GET image count by state:
curl -sS -o /dev/null -w '%{http_code}\n' \
-H 'Host: crowdstrike-api.localhost' \
'http://127.0.0.1:8088/container-security/aggregates/images/count-by-state/v1'
Image assessment policies / remaining cloud
and other cloud collections are not implemented (not yet). Container
registries is a separate collection:
Container registries. Combined container
vulnerabilities is a separate collection:
Container vulnerabilities. This is not
Kubernetes. This is not the HelloService template (GET /api/hello).
Read combined base images (cookie)
GET on /combined/base-images/v1 returns image_id base-lab-1 then
base-lab-2. base-lab-1 is registry docker.io repository
library/ubuntu tag 22.04 digest sha256:baseubuntu01 cid
cid-local-1. base-lab-2 is registry ghcr.io repository
lab/runtime tag 1.2.0 digest sha256:baseruntime02 cid
cid-local-1. Success is 200 MSA image_id + registry +
repository + tag + image_digest + cid. Extra unused query keys
including parameters and filter are ignored. This is
not GET /container-security/combined/image-assessment/images/v1.
This is not GET /container-security/aggregates/images/assessment-history/v1.
This is not GET /container-security/aggregates/images/count/v1.
This is not GET /container-security/aggregates/images/count-by-os-distribution/v1.
This is not GET /container-security/aggregates/images/count-by-state/v1.
This is not GET /container-security/combined/images/by-vulnerability-count/v1.
This is not GET /container-security/combined/images/detail/v1.
This is not GET /container-security/combined/images/issues-summary/v1.
This is not GET /container-security/combined/images/vulnerabilities-summary/v1.
This is not POST /container-security/entities/base-images/v1.
This is not DELETE /container-security/entities/base-images/v1.
This is not GET /container-security/combined/images/export/v1.
This is not Image assessment policies / remaining cloud.
GET combined base images does not mutate:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/combined/base-images/v1?parameters=x&filter=bogus:%27x%27'
GET combined after GET combined base images still includes
img-lab-1 and img-lab-2:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/combined/image-assessment/images/v1'
GET image count by state after GET combined base images still includes
name running then stopped:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/aggregates/images/count-by-state/v1'
cs-local-hosts (hosts:read only) is 403 on GET
combined base images:
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/combined/base-images/v1'
cs-local-cimg (falcon-container-image:read) is 200 on GET
combined base images:
TOKEN='<access_token from cs-local-cimg>'
curl -sS -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
'http://127.0.0.1:8088/container-security/combined/base-images/v1'
falcon-container-image:write (cs-local-cimgw) is 403 on GET
combined base images:
TOKEN='<access_token from cs-local-cimgw>'
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/combined/base-images/v1'
cs-local-fcliw is 403 on GET combined base images:
TOKEN='<access_token from cs-local-fcliw>'
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/combined/base-images/v1'
No cookie and no Bearer is 401 on GET combined base images:
curl -sS -o /dev/null -w '%{http_code}\n' \
-H 'Host: crowdstrike-api.localhost' \
'http://127.0.0.1:8088/container-security/combined/base-images/v1'
Image assessment policies / remaining cloud
and other cloud collections are not implemented (not yet). Container
registries is a separate collection:
Container registries. Combined container
vulnerabilities is a separate collection:
Container vulnerabilities. This is not
Kubernetes. This is not the HelloService template (GET /api/hello).
Read images by vulnerability count (cookie)
GET on /combined/images/by-vulnerability-count/v1 returns image_id
img-lab-1 then img-lab-2 each with vulnerability_count 1 and
cid cid-local-1. Success is 200 MSA image_id + registry +
repository + tag + vulnerability_count + cid. Extra unused query
keys including parameters, filter, limit, and offset are ignored.
This is not GET /container-security/combined/image-assessment/images/v1.
This is not GET /container-security/combined/base-images/v1.
This is not GET /container-security/aggregates/images/assessment-history/v1.
This is not GET /container-security/aggregates/images/count/v1.
This is not GET /container-security/aggregates/images/count-by-os-distribution/v1.
This is not GET /container-security/aggregates/images/count-by-state/v1.
This is not GET /container-security/combined/images/detail/v1.
This is not GET /container-security/combined/images/issues-summary/v1.
This is not GET /container-security/combined/images/vulnerabilities-summary/v1.
This is not POST /container-security/entities/base-images/v1.
This is not DELETE /container-security/entities/base-images/v1.
This is not GET /container-security/combined/images/export/v1.
This is not Image assessment policies / remaining cloud.
GET images by vulnerability count does not mutate:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/combined/images/by-vulnerability-count/v1?parameters=x&filter=bogus:%27x%27&limit=1&offset=1'
GET combined after GET images by vulnerability count still includes
img-lab-1 and img-lab-2:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/combined/image-assessment/images/v1'
GET combined base images after GET images by vulnerability count still
includes base-lab-1 then base-lab-2:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/combined/base-images/v1'
cs-local-hosts (hosts:read only) is 403 on GET
images by vulnerability count:
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/combined/images/by-vulnerability-count/v1'
cs-local-cimg (falcon-container-image:read) is 200 on GET
images by vulnerability count:
TOKEN='<access_token from cs-local-cimg>'
curl -sS -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
'http://127.0.0.1:8088/container-security/combined/images/by-vulnerability-count/v1'
falcon-container-image:write (cs-local-cimgw) is 403 on GET
images by vulnerability count:
TOKEN='<access_token from cs-local-cimgw>'
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/combined/images/by-vulnerability-count/v1'
cs-local-fcliw is 403 on GET images by vulnerability count:
TOKEN='<access_token from cs-local-fcliw>'
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/combined/images/by-vulnerability-count/v1'
No cookie and no Bearer is 401 on GET images by vulnerability count:
curl -sS -o /dev/null -w '%{http_code}\n' \
-H 'Host: crowdstrike-api.localhost' \
'http://127.0.0.1:8088/container-security/combined/images/by-vulnerability-count/v1'
Image assessment policies / remaining cloud
and other cloud collections are not implemented (not yet). Container
registries is a separate collection:
Container registries. Combined container
vulnerabilities is a separate collection:
Container vulnerabilities. This is not
Kubernetes. This is not the HelloService template (GET /api/hello).
Read combined image detail (cookie)
GET on /combined/images/detail/v1 returns image_id img-lab-1 then
img-lab-2. img-lab-1 is digest sha256:labapi01 base_os ubuntu
cid cid-local-1. img-lab-2 is digest sha256:labworker02 base_os
alpine cid cid-local-1. Success is 200 MSA image_id +
registry + repository + tag + digest + base_os + cid. Extra
unused query keys including parameters, filter, with_config,
sort, limit, and offset are ignored.
This is not GET /container-security/combined/image-assessment/images/v1.
This is not GET /container-security/combined/base-images/v1.
This is not GET /container-security/combined/images/by-vulnerability-count/v1.
This is not GET /container-security/combined/images/issues-summary/v1.
This is not GET /container-security/combined/images/vulnerabilities-summary/v1.
This is not POST /container-security/entities/base-images/v1.
This is not DELETE /container-security/entities/base-images/v1.
This is not GET /container-security/combined/images/export/v1.
This is not Image assessment policies / remaining cloud.
GET combined image detail does not mutate:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/combined/images/detail/v1?parameters=x&filter=bogus:%27x%27&with_config=true&sort=tag.asc&limit=1&offset=1'
GET combined after GET combined image detail still includes
img-lab-1 and img-lab-2:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/combined/image-assessment/images/v1'
GET images by vulnerability count after GET combined image detail still
includes img-lab-1 then img-lab-2:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/combined/images/by-vulnerability-count/v1'
cs-local-hosts (hosts:read only) is 403 on GET
combined image detail:
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/combined/images/detail/v1'
cs-local-cimg (falcon-container-image:read) is 200 on GET
combined image detail:
TOKEN='<access_token from cs-local-cimg>'
curl -sS -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
'http://127.0.0.1:8088/container-security/combined/images/detail/v1'
falcon-container-image:write (cs-local-cimgw) is 403 on GET
combined image detail:
TOKEN='<access_token from cs-local-cimgw>'
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/combined/images/detail/v1'
cs-local-fcliw is 403 on GET combined image detail:
TOKEN='<access_token from cs-local-fcliw>'
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/combined/images/detail/v1'
No cookie and no Bearer is 401 on GET combined image detail:
curl -sS -o /dev/null -w '%{http_code}\n' \
-H 'Host: crowdstrike-api.localhost' \
'http://127.0.0.1:8088/container-security/combined/images/detail/v1'
Image assessment policies / remaining cloud
and other cloud collections are not implemented (not yet). Container
registries is a separate collection:
Container registries. Combined container
vulnerabilities is a separate collection:
Container vulnerabilities. This is not
Kubernetes. This is not the HelloService template (GET /api/hello).
Read combined image issues summary (cookie)
GET on /combined/images/issues-summary/v1 returns image_id
img-lab-1 then img-lab-2 each with known_issues 1.
is_dca_run false. zero_day_impacted false. cid cid-local-1.
Success is 200 MSA image_id + known_issues + is_dca_run +
zero_day_impacted + cid. Extra unused query keys including
parameters, cid, registry, repository, tag, image_digest,
and include_base_image_vuln are ignored.
This is not GET /container-security/combined/image-assessment/images/v1.
This is not GET /container-security/combined/base-images/v1.
This is not GET /container-security/combined/images/by-vulnerability-count/v1.
This is not GET /container-security/combined/images/detail/v1.
This is not GET /container-security/combined/images/vulnerabilities-summary/v1.
This is not POST /container-security/entities/base-images/v1.
This is not DELETE /container-security/entities/base-images/v1.
This is not GET /container-security/combined/images/export/v1.
This is not Image assessment policies / remaining cloud.
GET combined image issues summary does not mutate:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/combined/images/issues-summary/v1?parameters=x&cid=other®istry=docker.io&repository=lab/api&tag=1.0.0&image_digest=sha256:labapi01&include_base_image_vuln=true'
GET combined after GET combined image issues summary still includes
img-lab-1 and img-lab-2:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/combined/image-assessment/images/v1'
GET images by vulnerability count after GET combined image issues summary still
includes img-lab-1 then img-lab-2:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/combined/images/by-vulnerability-count/v1'
GET combined image detail after GET combined image issues summary still
includes img-lab-1 then img-lab-2:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/combined/images/detail/v1'
cs-local-hosts (hosts:read only) is 403 on GET
combined image issues summary:
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/combined/images/issues-summary/v1'
cs-local-cimg (falcon-container-image:read) is 200 on GET
combined image issues summary:
TOKEN='<access_token from cs-local-cimg>'
curl -sS -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
'http://127.0.0.1:8088/container-security/combined/images/issues-summary/v1'
falcon-container-image:write (cs-local-cimgw) is 403 on GET
combined image issues summary:
TOKEN='<access_token from cs-local-cimgw>'
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/combined/images/issues-summary/v1'
cs-local-fcliw is 403 on GET combined image issues summary:
TOKEN='<access_token from cs-local-fcliw>'
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/combined/images/issues-summary/v1'
No cookie and no Bearer is 401 on GET combined image issues summary:
curl -sS -o /dev/null -w '%{http_code}\n' \
-H 'Host: crowdstrike-api.localhost' \
'http://127.0.0.1:8088/container-security/combined/images/issues-summary/v1'
Image assessment policies / remaining cloud
and other cloud collections are not implemented (not yet). Container
registries is a separate collection:
Container registries. Combined container
vulnerabilities is a separate collection:
Container vulnerabilities. This is not
Kubernetes. This is not the HelloService template (GET /api/hello).
Read combined image vulnerability summary (cookie)
GET on /combined/images/vulnerabilities-summary/v1 returns image_id
img-lab-1 then img-lab-2 each with total_vulnerabilities 1.
cid cid-local-1.
Success is 200 MSA image_id + total_vulnerabilities + cid. Extra unused query keys including
parameters, cid, registry, repository, tag, image_digest,
and include_base_image_vuln are ignored.
This is not GET /container-security/combined/image-assessment/images/v1.
This is not GET /container-security/combined/base-images/v1.
This is not GET /container-security/combined/images/by-vulnerability-count/v1.
This is not GET /container-security/combined/images/detail/v1.
This is not GET /container-security/combined/images/issues-summary/v1.
This is not POST /container-security/entities/base-images/v1.
This is not DELETE /container-security/entities/base-images/v1.
This is not GET /container-security/combined/images/export/v1.
This is not Image assessment policies / remaining cloud.
GET combined image vulnerability summary does not mutate:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/combined/images/vulnerabilities-summary/v1?parameters=x&cid=other®istry=docker.io&repository=lab/api&tag=1.0.0&image_digest=sha256:labapi01&include_base_image_vuln=true'
GET combined after GET combined image vulnerability summary still includes
img-lab-1 and img-lab-2:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/combined/image-assessment/images/v1'
GET images by vulnerability count after GET combined image vulnerability summary still
includes img-lab-1 then img-lab-2:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/combined/images/by-vulnerability-count/v1'
GET combined image detail after GET combined image vulnerability summary still
includes img-lab-1 then img-lab-2:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/combined/images/detail/v1'
GET combined image issues summary after GET combined image vulnerability summary still
includes img-lab-1 then img-lab-2:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/combined/images/issues-summary/v1'
cs-local-hosts (hosts:read only) is 403 on GET
combined image vulnerability summary:
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/combined/images/vulnerabilities-summary/v1'
cs-local-cimg (falcon-container-image:read) is 200 on GET
combined image vulnerability summary:
TOKEN='<access_token from cs-local-cimg>'
curl -sS -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
'http://127.0.0.1:8088/container-security/combined/images/vulnerabilities-summary/v1'
falcon-container-image:write (cs-local-cimgw) is 403 on GET
combined image vulnerability summary:
TOKEN='<access_token from cs-local-cimgw>'
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/combined/images/vulnerabilities-summary/v1'
cs-local-fcliw is 403 on GET combined image vulnerability summary:
TOKEN='<access_token from cs-local-fcliw>'
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/combined/images/vulnerabilities-summary/v1'
No cookie and no Bearer is 401 on GET combined image vulnerability summary:
curl -sS -o /dev/null -w '%{http_code}\n' \
-H 'Host: crowdstrike-api.localhost' \
'http://127.0.0.1:8088/container-security/combined/images/vulnerabilities-summary/v1'
Image assessment policies / remaining cloud
and other cloud collections are not implemented (not yet). Container
registries is a separate collection:
Container registries. Combined container
vulnerabilities is a separate collection:
Container vulnerabilities. This is not
Kubernetes. This is not the HelloService template (GET /api/hello).
Create base image (cookie)
POST image_id=base-lab-3 registry docker.io repository lab/created
tag 0.1.0 digest sha256:labcreated03 on /entities/base-images/v1
returns that row with cid cid-local-1. Success is 200 MSA
image_id + registry + repository + tag + image_digest + cid.
Required image_id, registry, repository, tag, image_digest.
Extra unused body keys including parameters and base_images are
ignored. SOURCE {} is not the clone envelope.
This is not GET /container-security/combined/base-images/v1.
This is not GET /container-security/combined/image-assessment/images/v1.
This is not GET /container-security/combined/images/vulnerabilities-summary/v1.
This is not DELETE /container-security/entities/base-images/v1.
This is not GET /container-security/combined/images/export/v1.
This is not Image assessment policies / remaining cloud.
curl -sS -X POST -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
-H 'Content-Type: application/json' \
-d '{"image_id":"base-lab-3","registry":"docker.io","repository":"lab/created","tag":"0.1.0","image_digest":"sha256:labcreated03","parameters":"x","base_images":"ignored"}' \
'http://127.0.0.1:8088/container-security/entities/base-images/v1'
GET combined base images after POST includes base-lab-3:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/combined/base-images/v1'
GET combined image-assessment after POST still includes img-lab-1 and
img-lab-2:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/combined/image-assessment/images/v1'
GET combined image vulnerability summary after POST still includes
img-lab-1 then img-lab-2:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/combined/images/vulnerabilities-summary/v1'
Missing image_id is 400:
curl -sS -o /dev/null -w '%{http_code}\n' \
-X POST -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
-H 'Content-Type: application/json' \
-d '{"registry":"docker.io","repository":"lab/created","tag":"0.1.0","image_digest":"sha256:labcreated03"}' \
'http://127.0.0.1:8088/container-security/entities/base-images/v1'
Duplicate image_id is 400:
curl -sS -o /dev/null -w '%{http_code}\n' \
-X POST -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
-H 'Content-Type: application/json' \
-d '{"image_id":"base-lab-3","registry":"docker.io","repository":"lab/created","tag":"0.1.0","image_digest":"sha256:labcreated03"}' \
'http://127.0.0.1:8088/container-security/entities/base-images/v1'
cs-local-hosts (hosts:read only) is 403 on POST create base
images:
TOKEN='<access_token from cs-local-hosts>'
curl -sS -o /dev/null -w '%{http_code}\n' \
-X POST -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
-H 'Content-Type: application/json' \
-d '{"image_id":"base-lab-3","registry":"docker.io","repository":"lab/created","tag":"0.1.0","image_digest":"sha256:labcreated03"}' \
'http://127.0.0.1:8088/container-security/entities/base-images/v1'
cs-local-cimg (falcon-container-image:read) is 403 on POST
create base images:
TOKEN='<access_token from cs-local-cimg>'
curl -sS -o /dev/null -w '%{http_code}\n' \
-X POST -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
-H 'Content-Type: application/json' \
-d '{"image_id":"base-lab-3","registry":"docker.io","repository":"lab/created","tag":"0.1.0","image_digest":"sha256:labcreated03"}' \
'http://127.0.0.1:8088/container-security/entities/base-images/v1'
falcon-container-image:write (cs-local-cimgw) is 200 on POST
create base images:
TOKEN='<access_token from cs-local-cimgw>'
curl -sS -X POST -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
-H 'Content-Type: application/json' \
-d '{"image_id":"base-lab-3","registry":"docker.io","repository":"lab/created","tag":"0.1.0","image_digest":"sha256:labcreated03"}' \
'http://127.0.0.1:8088/container-security/entities/base-images/v1'
cs-local-fcliw is 403 on POST create base images:
TOKEN='<access_token from cs-local-fcliw>'
curl -sS -o /dev/null -w '%{http_code}\n' \
-X POST -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
-H 'Content-Type: application/json' \
-d '{"image_id":"base-lab-3","registry":"docker.io","repository":"lab/created","tag":"0.1.0","image_digest":"sha256:labcreated03"}' \
'http://127.0.0.1:8088/container-security/entities/base-images/v1'
No cookie and no Bearer is 401 on POST create base images:
curl -sS -o /dev/null -w '%{http_code}\n' \
-X POST -H 'Host: crowdstrike-api.localhost' \
-H 'Content-Type: application/json' \
-d '{"image_id":"base-lab-3","registry":"docker.io","repository":"lab/created","tag":"0.1.0","image_digest":"sha256:labcreated03"}' \
'http://127.0.0.1:8088/container-security/entities/base-images/v1'
Image assessment policies / remaining cloud
and other cloud collections are not implemented (not yet). Container
registries is a separate collection:
Container registries. Combined container
vulnerabilities is a separate collection:
Container vulnerabilities. This is not
Kubernetes. This is not the HelloService template (GET /api/hello).
Delete base images (cookie)
DELETE ids=base-lab-2 on /entities/base-images/v1 returns that row
with cid cid-local-1. Success is 200 MSA image_id + registry +
repository + tag + image_digest + cid. Required ids. Extra
unused query keys including parameters are ignored. SOURCE {} is
not the clone envelope. Unknown ids is 404. GET combined
base-images after DELETE omits base-lab-2. GET combined
image-assessment after DELETE still 200. POST
/container-security/entities/base-images/v1 still 200 after this
DELETE. This is not DELETE /container-security/entities/images/v1.
This is not POST /container-security/entities/base-images/v1.
This is not GET /container-security/combined/images/export/v1.
This is not Image assessment policies / remaining cloud.
curl -sS -X DELETE -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/entities/base-images/v1?ids=base-lab-2¶meters=x'
GET combined base images after DELETE omits base-lab-2:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/combined/base-images/v1'
GET combined image-assessment after DELETE still includes img-lab-1
and img-lab-2:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/combined/image-assessment/images/v1'
Missing ids is 400:
curl -sS -o /dev/null -w '%{http_code}\n' \
-X DELETE -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/entities/base-images/v1'
Unknown ids is 404:
curl -sS -o /dev/null -w '%{http_code}\n' \
-X DELETE -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/entities/base-images/v1?ids=base-missing'
cs-local-hosts (hosts:read only) is 403 on DELETE base images:
TOKEN='<access_token from cs-local-hosts>'
curl -sS -o /dev/null -w '%{http_code}\n' \
-X DELETE -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
'http://127.0.0.1:8088/container-security/entities/base-images/v1?ids=base-lab-2'
cs-local-cimg (falcon-container-image:read) is 403 on DELETE
base images:
TOKEN='<access_token from cs-local-cimg>'
curl -sS -o /dev/null -w '%{http_code}\n' \
-X DELETE -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
'http://127.0.0.1:8088/container-security/entities/base-images/v1?ids=base-lab-2'
falcon-container-image:write (cs-local-cimgw) is 200 on DELETE
base images:
TOKEN='<access_token from cs-local-cimgw>'
curl -sS -X DELETE -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
'http://127.0.0.1:8088/container-security/entities/base-images/v1?ids=base-lab-2'
cs-local-fcliw is 403 on DELETE base images:
TOKEN='<access_token from cs-local-fcliw>'
curl -sS -o /dev/null -w '%{http_code}\n' \
-X DELETE -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
'http://127.0.0.1:8088/container-security/entities/base-images/v1?ids=base-lab-2'
No cookie and no Bearer is 401 on DELETE base images:
curl -sS -o /dev/null -w '%{http_code}\n' \
-X DELETE -H 'Host: crowdstrike-api.localhost' \
'http://127.0.0.1:8088/container-security/entities/base-images/v1?ids=base-lab-2'
Image assessment policies / remaining cloud
and other cloud collections are not implemented (not yet). Container
registries is a separate collection:
Container registries. Combined container
vulnerabilities is a separate collection:
Container vulnerabilities. This is not
Kubernetes. This is not the HelloService template (GET /api/hello).
Read combined images export (cookie)
GET on /combined/images/export/v1 returns image_id img-lab-1 then
img-lab-2. img-lab-1 is registry docker.io repository lab/api
tag 1.0.0 architecture amd64 digest sha256:labapi01 base_os
ubuntu cid cid-local-1. img-lab-2 is registry docker.io
repository lab/worker tag latest architecture arm64 digest
sha256:labworker02 base_os alpine cid cid-local-1. Success is
200 MSA image_id + registry + repository + tag +
architecture + image_digest + cid + base_os. Extra unused query
keys including filter, expand_vulnerabilities, expand_detections,
limit, offset, sort, and parameters are ignored. SOURCE array is
not the clone envelope.
This is not GET /container-security/combined/image-assessment/images/v1.
This is not GET /container-security/combined/images/detail/v1.
This is not GET /container-security/combined/base-images/v1.
This is not POST /container-security/entities/exports/v1.
This is not Image assessment policies / remaining cloud.
GET combined images export does not mutate:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/combined/images/export/v1?filter=bogus:%27x%27&expand_vulnerabilities=true&expand_detections=true&limit=1&offset=1&sort=tag.asc¶meters=x'
GET combined after GET combined images export still includes
img-lab-1 and img-lab-2:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/combined/image-assessment/images/v1'
GET combined base images after GET combined images export still
includes base-lab-1 then base-lab-2:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/combined/base-images/v1'
GET combined image detail after GET combined images export still
includes img-lab-1 then img-lab-2:
curl -sS -H 'Host: crowdstrike-api.localhost' -b cookies.txt \
'http://127.0.0.1:8088/container-security/combined/images/detail/v1'
cs-local-hosts (hosts:read only) is 403 on GET
combined images export:
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/combined/images/export/v1'
cs-local-cimg (falcon-container-image:read) is 200 on GET
combined images export:
TOKEN='<access_token from cs-local-cimg>'
curl -sS -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
'http://127.0.0.1:8088/container-security/combined/images/export/v1'
falcon-container-image:write (cs-local-cimgw) is 403 on GET
combined images export:
TOKEN='<access_token from cs-local-cimgw>'
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/combined/images/export/v1'
cs-local-fcliw is 403 on GET combined images export:
TOKEN='<access_token from cs-local-fcliw>'
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/combined/images/export/v1'
No cookie and no Bearer is 401 on GET combined images export:
curl -sS -o /dev/null -w '%{http_code}\n' \
-H 'Host: crowdstrike-api.localhost' \
'http://127.0.0.1:8088/container-security/combined/images/export/v1'
Image assessment policies / remaining cloud
and other cloud collections are not implemented (not yet). Container
registries is a separate collection:
Container registries. Combined container
vulnerabilities is a separate collection:
Container vulnerabilities. This is not
Kubernetes. 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/combined/image-assessment/images/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. GetCombinedImages stays falcon-container-image:read.
Delete (Bearer)
TOKEN='<access_token from a client with falcon-container-image:write>'
curl -sS -X DELETE -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
'http://127.0.0.1:8088/container-security/entities/images/v1?image_id=img-lab-2'
falcon-container-image:write → 200 on DELETE (including unit-test
client cs-local-cimgw). A token without that scope (including
hosts:read only, e.g. cs-local-hosts, or
falcon-container-image:read, e.g. cs-local-cimg) → 403. Missing
or revoked token → 401. There is no seeded production client with
falcon-container-image:write — use the console cookie, or a client
you created with that scope. DeleteImageDetails stays
falcon-container-image:write. PEP 8 delete_image_details. Distinct
from GET combined image-assessment, GET entities reports, registry
POST/GET, and Kubernetes. SOURCE /images/{image_id} is not a clone
route. DELETE does not cascade container vulnerability rows.
Get assessment (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/entities/reports/v1?image_id=img-lab-1'
falcon-container-image:read → 200 on GET assessment (including
unit-test client cs-local-cimg). A token without that scope (including
hosts:read only, e.g. cs-local-hosts, or write-only
falcon-container-image:write, e.g. cs-local-cimgw) → 403. Missing
or revoked token → 401. There is no seeded production client with
falcon-container-image:read — use the console cookie, or a client
you created with that scope. GetImageAssessmentReport stays
falcon-container-image:read. SOURCE GetImageAssessmentReport.
PEP 8 get_assessment. Distinct from GET combined image-assessment,
DELETE entities images, SOURCE /reports (not a clone route),
GetReportByReference v2, and GetReportByScanId v2 {uuid}. Extra unused
keys ignored. Required query
image_id. GET assessment does not mutate.
Get report by reference (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/entities/reports/v2?image_id=img-lab-1'
falcon-container-image:read → 200 on GET report by reference
(including unit-test client cs-local-cimg). A token without that scope
(including hosts:read only, e.g. cs-local-hosts, or write-only
falcon-container-image:write, e.g. cs-local-cimgw) → 403. Missing
or revoked token → 401. There is no seeded production client with
falcon-container-image:read — use the console cookie, or a client
you created with that scope. GetReportByReference stays
falcon-container-image:read. SOURCE GetReportByReference. PEP 8
get_report_by_reference. Distinct from GET reports v1, GET combined
image-assessment, DELETE entities images, SOURCE
/image-assessment/entities/reports/v2 (not a clone route), and
GetReportByScanId v2 {uuid}. Extra unused keys ignored. Required query
image_id. GET report by reference does not mutate.
Get report by scan (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/entities/reports/v2/img-lab-1'
falcon-container-image:read → 200 on GET report by scan (including
unit-test client cs-local-cimg). A token without that scope (including
hosts:read only, e.g. cs-local-hosts, or write-only
falcon-container-image:write, e.g. cs-local-cimgw) → 403. Missing
or revoked token → 401. There is no seeded production client with
falcon-container-image:read — use the console cookie, or a client
you created with that scope. GetReportByScanId stays
falcon-container-image:read. SOURCE GetReportByScanID. PEP 8
get_report_by_id. Distinct from GET reports v1, GET reports v2 query
image_id, GET combined image-assessment, DELETE entities images, and
SOURCE /image-assessment/entities/reports/v2/{uuid} (not a clone
route). Extra unused keys ignored. Required path uuid (clone uuid =
image_id). GET report by scan does not mutate.
Check policy (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/entities/policy-checks/v1?repository=lab/api&tag=1.0.0'
falcon-container-image:read → 200 on GET check policy (including
unit-test client cs-local-cimg). A token without that scope (including
hosts:read only, e.g. cs-local-hosts, or write-only
falcon-container-image:write, e.g. cs-local-cimgw) → 403. Missing
or revoked token → 401. There is no seeded production client with
falcon-container-image:read — use the console cookie, or a client
you created with that scope. ImageMatchesPolicy stays
falcon-container-image:read. SOURCE ImageMatchesPolicy. PEP 8
image_matches_policy. Distinct from GET policy-checks v2, GET reports,
HEAD inventory, GET credentials, SOURCE /policy-checks (not a clone
route), and SOURCE /image-assessment/entities/policy-checks/v2 (not a
clone route). Extra unused keys ignored. Required query repository
and tag. Empty match 200 empty resources. GET check policy does
not mutate.
Launch export (Bearer)
TOKEN='<access_token from a client with falcon-container-image:read>'
curl -sS -X POST -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
-H 'Content-Type: application/json' \
-d '{"resource":"images","format":"json"}' \
'http://127.0.0.1:8088/container-security/entities/exports/v1'
falcon-container-image:read → 200 on POST launch export (including
unit-test client cs-local-cimg). A token without that scope (including
hosts:read only, e.g. cs-local-hosts, or write-only
falcon-container-image:write, e.g. cs-local-cimgw) → 403. Missing
or revoked token → 401. There is no seeded production client with
falcon-container-image:read — use the console cookie, or a client
you created with that scope. LaunchExportJob stays
falcon-container-image:read. SOURCE LaunchExportJob. PEP 8
launch_export_job. Distinct from GET policy-checks v1, GET
policy-checks v2, GET reports, HEAD inventory, GET
/container-security/queries/exports/v1 (QueryExportJobs), GET
/container-security/entities/exports/v1 (ReadExportJobs), GET
/container-security/entities/exports/files/v1 (DownloadExportFile).
Extra unused keys ignored. Required
resource. format csv or json default json.
Query export jobs (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/queries/exports/v1?filter=resource:%27images%27'
falcon-container-image:read → 200 on GET query export jobs
(including unit-test client cs-local-cimg). A token without that scope
(including hosts:read only, e.g. cs-local-hosts, or write-only
falcon-container-image:write, e.g. cs-local-cimgw) → 403. Missing
or revoked token → 401. There is no seeded production client with
falcon-container-image:read — use the console cookie, or a client
you created with that scope. QueryExportJobs stays
falcon-container-image:read. SOURCE QueryExportJobs. PEP 8
query_export_jobs. Distinct from POST
/container-security/entities/exports/v1 (LaunchExportJob), GET
/container-security/entities/exports/v1 (ReadExportJobs), GET
/container-security/entities/exports/files/v1 (DownloadExportFile).
Extra unused parameters ignored. Optional FQL resource/status.
Cap 100. Empty match 200 empty resources. SOURCE raw JSON array is
not the clone envelope. GET query export jobs does not mutate.
Read export jobs (Bearer)
TOKEN='<access_token from a client with falcon-container-image:read>'
ID='<exp- id from Launch export or Query export jobs>'
curl -sS -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
"http://127.0.0.1:8088/container-security/entities/exports/v1?ids=${ID}"
falcon-container-image:read → 200 on GET read export jobs
(including unit-test client cs-local-cimg). A token without that scope
(including hosts:read only, e.g. cs-local-hosts, or write-only
falcon-container-image:write, e.g. cs-local-cimgw) → 403. Missing
or revoked token → 401. There is no seeded production client with
falcon-container-image:read — use the console cookie, or a client
you created with that scope. ReadExportJobs stays
falcon-container-image:read. SOURCE ReadExportJobs. PEP 8
read_export_jobs. Distinct from POST
/container-security/entities/exports/v1 (LaunchExportJob), GET
/container-security/queries/exports/v1 (QueryExportJobs), GET
/container-security/entities/exports/files/v1 (DownloadExportFile).
Extra unused parameters ignored. Required ids (max 100). Unknown
skipped. Empty match 200 empty resources. GET read export jobs does
not mutate.
Download export file (Bearer)
TOKEN='<access_token from a client with falcon-container-image:read>'
ID='<exp- id from Launch export>'
curl -sS -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
"http://127.0.0.1:8088/container-security/entities/exports/files/v1?id=${ID}"
falcon-container-image:read → 200 on GET download export file
(including unit-test client cs-local-cimg). A token without that scope
(including hosts:read only, e.g. cs-local-hosts, or write-only
falcon-container-image:write, e.g. cs-local-cimgw) → 403. Missing
or revoked token → 401. There is no seeded production client with
falcon-container-image:read — use the console cookie, or a client
you created with that scope. DownloadExportFile stays
falcon-container-image:read. SOURCE DownloadExportFile. PEP 8
download_export_file. Distinct from POST
/container-security/entities/exports/v1 (LaunchExportJob), GET
/container-security/entities/exports/v1 (ReadExportJobs), GET
/container-security/queries/exports/v1 (QueryExportJobs). Extra unused
parameters ignored. Required id. Unknown 404. SOURCE raw file
bytes are not the clone envelope. GET download export file does
not mutate.
Check prevention (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/entities/policy-checks/v2?repository=lab/api&tag=1.0.0'
falcon-container-image:read → 200 on GET check prevention
(including unit-test client cs-local-cimg). A token without that scope
(including hosts:read only, e.g. cs-local-hosts, or write-only
falcon-container-image:write, e.g. cs-local-cimgw) → 403. Missing
or revoked token → 401. There is no seeded production client with
falcon-container-image:read — use the console cookie, or a client
you created with that scope. PolicyChecks stays
falcon-container-image:read. SOURCE PolicyChecks. PEP 8
check_prevention_policies. Distinct from GET policy-checks v1
(ImageMatchesPolicy), GET reports, HEAD inventory, POST exports, SOURCE
/image-assessment/entities/policy-checks/v2 (not a clone route). Extra
unused keys ignored. Required query repository and tag. Empty match
200 empty resources. GET check prevention does not mutate.
Read image assessment history (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/images/assessment-history/v1'
falcon-container-image:read → 200 on GET assessment history
(including unit-test client cs-local-cimg). A token without that scope
(including hosts:read only, e.g. cs-local-hosts, or write-only
falcon-container-image:write, e.g. cs-local-cimgw) → 403. Missing
or revoked token → 401. There is no seeded production client with
falcon-container-image:read — use the console cookie, or a client
you created with that scope. AggregateImageAssessmentHistory stays
falcon-container-image:read. SOURCE AggregateImageAssessmentHistory.
PEP 8 aggregate_assessment_history. Distinct from GET combined
image-assessment, GET aggregates/images/count, GET
aggregates/images/count-by-os-distribution, GET
aggregates/images/count-by-state, GET
aggregates/images/count-by-distinct, GET
aggregates/images/most-used, GET vulnerability count-by-severity, GET
combined/base-images, GET combined/images/by-vulnerability-count, and
GET /container-security/combined/images/issues-summary/v1, and GET /container-security/combined/images/vulnerabilities-summary/v1, and POST /container-security/entities/base-images/v1, and DELETE /container-security/entities/base-images/v1, and GET /container-security/combined/images/export/v1, and Image assessment policies / remaining cloud. Extra unused parameters and filter
ignored. Success 200 MSA name + count + cid. GET assessment
history does not mutate.
Read image count (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/images/count/v1'
falcon-container-image:read → 200 on GET image count
(including unit-test client cs-local-cimg). A token without that scope
(including hosts:read only, e.g. cs-local-hosts, or write-only
falcon-container-image:write, e.g. cs-local-cimgw) → 403. Missing
or revoked token → 401. There is no seeded production client with
falcon-container-image:read — use the console cookie, or a client
you created with that scope. AggregateImageCount stays
falcon-container-image:read. SOURCE AggregateImageCount.
PEP 8 aggregate_count. Distinct from GET combined
image-assessment, GET assessment-history, GET
aggregates/images/count-by-os-distribution, GET
aggregates/images/count-by-state, GET
aggregates/images/count-by-distinct, GET
aggregates/images/most-used, GET vulnerability count, GET
combined/base-images, GET combined/images/by-vulnerability-count, and
GET /container-security/combined/images/issues-summary/v1, and GET /container-security/combined/images/vulnerabilities-summary/v1, and POST /container-security/entities/base-images/v1, and DELETE /container-security/entities/base-images/v1, and GET /container-security/combined/images/export/v1, and Image assessment policies / remaining cloud. Extra unused parameters and filter
ignored. Success 200 MSA count + cid. GET image count
does not mutate.
Read image count by base OS (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/images/count-by-os-distribution/v1'
falcon-container-image:read → 200 on GET image count by base OS
(including unit-test client cs-local-cimg). A token without that scope
(including hosts:read only, e.g. cs-local-hosts, or write-only
falcon-container-image:write, e.g. cs-local-cimgw) → 403. Missing
or revoked token → 401. There is no seeded production client with
falcon-container-image:read — use the console cookie, or a client
you created with that scope. AggregateImageCountByBaseOS stays
falcon-container-image:read. SOURCE AggregateImageCountByBaseOS.
PEP 8 aggregate_count_by_base_os. Distinct from GET combined
image-assessment, GET assessment-history, GET count, GET
aggregates/images/count-by-state, GET
aggregates/images/count-by-distinct, GET
aggregates/images/most-used, GET combined/base-images, GET combined/images/by-vulnerability-count, and
GET /container-security/combined/images/issues-summary/v1, and GET /container-security/combined/images/vulnerabilities-summary/v1, and POST /container-security/entities/base-images/v1, and DELETE /container-security/entities/base-images/v1, and GET /container-security/combined/images/export/v1, and Image assessment policies / remaining cloud. Extra unused parameters and filter
ignored. Success 200 MSA name + count + cid. GET image count
by base OS does not mutate.
Read image count by state (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/images/count-by-state/v1'
falcon-container-image:read → 200 on GET image count by state
(including unit-test client cs-local-cimg). A token without that scope
(including hosts:read only, e.g. cs-local-hosts, or write-only
falcon-container-image:write, e.g. cs-local-cimgw) → 403. Missing
or revoked token → 401. There is no seeded production client with
falcon-container-image:read — use the console cookie, or a client
you created with that scope. AggregateImageCountByState stays
falcon-container-image:read. SOURCE AggregateImageCountByState.
PEP 8 aggregate_count_by_state. Distinct from GET combined
image-assessment, GET assessment-history, GET count, GET
count-by-os-distribution, GET
aggregates/images/count-by-distinct, GET
aggregates/images/most-used, GET combined/base-images, GET combined/images/by-vulnerability-count, and
GET /container-security/combined/images/issues-summary/v1, and GET /container-security/combined/images/vulnerabilities-summary/v1, and POST /container-security/entities/base-images/v1, and DELETE /container-security/entities/base-images/v1, and GET /container-security/combined/images/export/v1, and Image assessment policies / remaining cloud. Extra unused parameters and filter
ignored. Success 200 MSA name + count + cid. GET image count
by state does not mutate.
Read combined base images (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/combined/base-images/v1'
falcon-container-image:read → 200 on GET combined base images
(including unit-test client cs-local-cimg). A token without that scope
(including hosts:read only, e.g. cs-local-hosts, or write-only
falcon-container-image:write, e.g. cs-local-cimgw) → 403. Missing
or revoked token → 401. There is no seeded production client with
falcon-container-image:read — use the console cookie, or a client
you created with that scope. CombinedBaseImages stays
falcon-container-image:read. SOURCE CombinedBaseImages.
PEP 8 get_combined_base_images. Distinct from GET combined
image-assessment, GET aggregates, GET combined/images/by-vulnerability-count, GET /container-security/combined/images/detail/v1, and GET /container-security/combined/images/issues-summary/v1, and GET /container-security/combined/images/vulnerabilities-summary/v1, and POST /container-security/entities/base-images/v1, and DELETE /container-security/entities/base-images/v1, and GET /container-security/combined/images/export/v1, and Image assessment policies / remaining cloud. Extra unused parameters and filter
ignored. Success 200 MSA image_id + registry + repository +
tag + image_digest + cid. GET combined base images does
not mutate.
Read images by vulnerability count (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/combined/images/by-vulnerability-count/v1'
falcon-container-image:read → 200 on GET images by vulnerability count
(including unit-test client cs-local-cimg). A token without that scope
(including hosts:read only, e.g. cs-local-hosts, or write-only
falcon-container-image:write, e.g. cs-local-cimgw) → 403. Missing
or revoked token → 401. There is no seeded production client with
falcon-container-image:read — use the console cookie, or a client
you created with that scope. CombinedImageByVulnerabilityCount stays
falcon-container-image:read. SOURCE CombinedImageByVulnerabilityCount.
PEP 8 get_combined_images_by_vulnerability_count. Distinct from GET
combined image-assessment, GET combined base-images, GET aggregates, GET combined/images/detail, and
GET /container-security/combined/images/issues-summary/v1, and GET /container-security/combined/images/vulnerabilities-summary/v1, and POST /container-security/entities/base-images/v1, and DELETE /container-security/entities/base-images/v1, and GET /container-security/combined/images/export/v1, and Image assessment policies / remaining cloud. Extra unused parameters, filter,
limit, and offset ignored. Success 200 MSA image_id +
registry + repository + tag + vulnerability_count + cid. GET
images by vulnerability count does not mutate.
Read combined image detail (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/combined/images/detail/v1'
falcon-container-image:read → 200 on GET combined image detail
(including unit-test client cs-local-cimg). A token without that scope
(including hosts:read only, e.g. cs-local-hosts, or write-only
falcon-container-image:write, e.g. cs-local-cimgw) → 403. Missing
or revoked token → 401. There is no seeded production client with
falcon-container-image:read — use the console cookie, or a client
you created with that scope. CombinedImageDetail stays
falcon-container-image:read. SOURCE CombinedImageDetail.
PEP 8 get_combined_detail. Distinct from GET
combined image-assessment, GET combined base-images, GET by-vulnerability-count, and
GET /container-security/combined/images/issues-summary/v1, and GET /container-security/combined/images/vulnerabilities-summary/v1, and POST /container-security/entities/base-images/v1, and DELETE /container-security/entities/base-images/v1, and GET /container-security/combined/images/export/v1, and Image assessment policies / remaining cloud. Extra unused parameters, filter,
with_config, sort, limit, and offset ignored. Success 200 MSA image_id +
registry + repository + tag + digest + base_os + cid. GET
combined image detail does not mutate.
Read combined image issues summary (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/combined/images/issues-summary/v1'
falcon-container-image:read → 200 on GET combined image issues summary
(including unit-test client cs-local-cimg). A token without that scope
(including hosts:read only, e.g. cs-local-hosts, or write-only
falcon-container-image:write, e.g. cs-local-cimgw) → 403. Missing
or revoked token → 401. There is no seeded production client with
falcon-container-image:read — use the console cookie, or a client
you created with that scope. CombinedImageIssuesSummary stays
falcon-container-image:read. SOURCE CombinedImageIssuesSummary.
PEP 8 get_combined_issues_summary. Distinct from GET
combined image-assessment, GET combined base-images, GET by-vulnerability-count, GET combined image detail, and
GET /container-security/combined/images/vulnerabilities-summary/v1, and POST /container-security/entities/base-images/v1, and DELETE /container-security/entities/base-images/v1, and GET /container-security/combined/images/export/v1, and Image assessment policies / remaining cloud. Extra unused parameters, cid,
registry, repository, tag, image_digest, and include_base_image_vuln
ignored. Success 200 MSA image_id + known_issues + is_dca_run +
zero_day_impacted + cid. GET combined image issues summary does not
mutate.
Read combined image vulnerability summary (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/combined/images/vulnerabilities-summary/v1'
falcon-container-image:read → 200 on GET combined image vulnerability summary
(including unit-test client cs-local-cimg). A token without that scope
(including hosts:read only, e.g. cs-local-hosts, or write-only
falcon-container-image:write, e.g. cs-local-cimgw) → 403. Missing
or revoked token → 401. There is no seeded production client with
falcon-container-image:read — use the console cookie, or a client
you created with that scope. CombinedImageVulnerabilitySummary stays
falcon-container-image:read. SOURCE CombinedImageVulnerabilitySummary.
PEP 8 get_combined_vulnerabilities_summary. Distinct from GET
combined image-assessment, GET combined base-images, GET by-vulnerability-count, GET combined image detail, GET combined image issues summary, and POST /container-security/entities/base-images/v1, and DELETE /container-security/entities/base-images/v1, and GET /container-security/combined/images/export/v1, and Image assessment policies / remaining cloud. Extra unused parameters, cid,
registry, repository, tag, image_digest, and include_base_image_vuln
ignored. Success 200 MSA image_id + total_vulnerabilities +
cid. GET combined image vulnerability summary does not
mutate.
Create base image (Bearer)
TOKEN='<access_token from a client with falcon-container-image:write>'
curl -sS -X POST -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
-H 'Content-Type: application/json' \
-d '{"image_id":"base-lab-3","registry":"docker.io","repository":"lab/created","tag":"0.1.0","image_digest":"sha256:labcreated03"}' \
'http://127.0.0.1:8088/container-security/entities/base-images/v1'
falcon-container-image:write → 200 on POST create base images
(including unit-test client cs-local-cimgw). A token without that scope
(including hosts:read only, e.g. cs-local-hosts, read-only
falcon-container-image:read, e.g. cs-local-cimg, or CLI-write
cs-local-fcliw) → 403. Missing or revoked token → 401. There is
no seeded production client with falcon-container-image:write — use
the console cookie, or a client you created with that scope.
CreateBaseImagesEntities stays falcon-container-image:write. SOURCE
CreateBaseImagesEntities. PEP 8 create_base_images. Distinct from GET
combined image-assessment, GET combined base-images, GET combined image
vulnerability summary, and DELETE /container-security/entities/base-images/v1, and GET /container-security/combined/images/export/v1, and Image assessment policies / remaining cloud. Extra unused
parameters and base_images ignored. Required image_id, registry,
repository, tag, image_digest. Duplicate image_id 400.
Success 200 MSA image_id + registry + repository + tag +
image_digest + cid. SOURCE {} is not the clone envelope.
Delete base images (Bearer)
TOKEN='<access_token from a client with falcon-container-image:write>'
curl -sS -X DELETE -H 'Host: crowdstrike-api.localhost' \
-H "Authorization: Bearer ${TOKEN}" \
'http://127.0.0.1:8088/container-security/entities/base-images/v1?ids=base-lab-2'
falcon-container-image:write → 200 on DELETE base images
(including unit-test client cs-local-cimgw). A token without that scope
(including hosts:read only, e.g. cs-local-hosts, read-only
falcon-container-image:read, e.g. cs-local-cimg, or CLI-write
cs-local-fcliw) → 403. Missing or revoked token → 401. There is
no seeded production client with falcon-container-image:write — use
the console cookie, or a client you created with that scope.
DeleteBaseImages stays falcon-container-image:write. SOURCE
DeleteBaseImages. PEP 8 delete_base_images. Distinct from DELETE
/container-security/entities/images/v1 and POST
/container-security/entities/base-images/v1. Extra unused parameters
ignored. Required ids. Unknown ids 404. Success 200 MSA
image_id + registry + repository + tag + image_digest + cid.
SOURCE {} is not the clone envelope.
Read combined images export (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/combined/images/export/v1'
falcon-container-image:read → 200 on GET combined images export
(including unit-test client cs-local-cimg). A token without that scope
(including hosts:read only, e.g. cs-local-hosts, or write-only
falcon-container-image:write, e.g. cs-local-cimgw) → 403. Missing
or revoked token → 401. There is no seeded production client with
falcon-container-image:read — use the console cookie, or a client
you created with that scope. ReadCombinedImagesExport stays
falcon-container-image:read. SOURCE ReadCombinedImagesExport.
PEP 8 read_combined_export. Distinct from GET combined
image-assessment, GET combined images/detail, GET combined
base-images, Launch export, and Image assessment policies / remaining cloud.
Extra unused filter, expand_vulnerabilities, expand_detections,
limit, offset, sort, and parameters ignored. Success 200 MSA
image_id + registry + repository + tag + architecture +
image_digest + cid + base_os. SOURCE array is not the clone
envelope. GET combined images export does not mutate.
OAuth2 mint/revoke: OAuth2. Accessible scopes: API clients.