Skip to content

Container Vulnerabilities

The Container Vulnerabilities service collection provides operations for aggregating and retrieving container vulnerability data. Query vulnerability counts grouped by various criteria, retrieve detailed vulnerability information for images, and get combined vulnerability data filtered by FQL expressions.

LanguageLast Update
Pythonv1.5.2
PowerShellv2.2.9
Gov0.20.0
TypeScriptv0.6.0
Rustv0.7.0
Rubyv1.2.0
OperationDescription
ReadVulnerabilityCountByActivelyExploited
read_vulnerability_counts_by_active_exploited
Aggregate count of vulnerabilities grouped by actively exploited
ReadVulnerabilityCountByCPSRating
read_vulnerability_counts_by_cps_rating
Aggregate count of vulnerabilities grouped by csp_rating
ReadVulnerabilityCountByCVSSScore
read_vulnerability_counts_by_cvss_score
Aggregate count of vulnerabilities grouped by cvss score
ReadVulnerabilityCountBySeverity
read_vulnerability_counts_by_severity
Aggregate count of vulnerabilities grouped by severity
ReadVulnerabilityCount
read_vulnerability_count
Aggregate count of vulnerabilities
ReadVulnerabilitiesByImageCount
read_vulnerabilities_by_count
Retrieve top x vulnerabilities with the most impacted images
ReadVulnerabilitiesPublicationDate
read_vulnerabilities_by_pub_date
Retrieve top x vulnerabilities with the most recent publication date
ReadCombinedVulnerabilitiesDetails
read_combined_vulnerability_detail
Retrieve vulnerability details related to an image
ReadCombinedVulnerabilitiesInfo
read_combined_vulnerabilities_info
Retrieve vulnerability and package related info for this customer
ReadCombinedVulnerabilities
read_combined_vulnerabilities
Retrieve vulnerability and aggregate data filtered by the provided FQL

Aggregate count of vulnerabilities grouped by actively exploited

GET /container-security/aggregates/vulnerabilities/count-by-actively-exploited/v1
Scope Falcon Container Image: READ Consumes · Produces application/json
PEP 8 read_vulnerability_counts_by_active_exploited
NameTypeData typeDescription
filterquerystringFilter vulnerabilities using a query in Falcon Query Language (FQL). Supported filters: ai_related,base_os,cid,container_id,container_running_status,containers_impacted_range,cps_rating,cve_id,cvss_score,description,exploited_status,exploited_status_name,fix_status,image_digest,image_id,images_impacted_range,include_base_image_vuln,index_digest,package_name_version,registry,repository,severity,tag
limitqueryintegerThe upper-bound on the number of records to retrieve.
offsetqueryintegerThe offset from where to begin.
parametersquerydictionaryFull query string parameters payload in JSON format. Not required if using other keywords.
from falconpy import ContainerVulnerabilities
falcon = ContainerVulnerabilities(client_id=CLIENT_ID,
client_secret=CLIENT_SECRET
)
response = falcon.read_vulnerability_counts_by_active_exploited(filter="string",
limit=integer,
offset=integer)
print(response)

Aggregate count of vulnerabilities grouped by csp_rating

GET /container-security/aggregates/vulnerabilities/count-by-cps-rating/v1
Scope Falcon Container Image: READ Consumes · Produces application/json
PEP 8 read_vulnerability_counts_by_cps_rating
NameTypeData typeDescription
filterquerystringFilter vulnerabilities using a query in Falcon Query Language (FQL). Supported filters: ai_related,base_os,cid,container_id,container_running_status,containers_impacted_range,cps_rating,cve_id,cvss_score,description,exploited_status,exploited_status_name,fix_status,image_digest,image_id,images_impacted_range,include_base_image_vuln,index_digest,package_name_version,registry,repository,severity,tag
limitqueryintegerThe upper-bound on the number of records to retrieve.
offsetqueryintegerThe offset from where to begin.
parametersquerydictionaryFull query string parameters payload in JSON format. Not required if using other keywords.
from falconpy import ContainerVulnerabilities
falcon = ContainerVulnerabilities(client_id=CLIENT_ID,
client_secret=CLIENT_SECRET
)
response = falcon.read_vulnerability_counts_by_cps_rating(filter="string",
limit=integer,
offset=integer)
print(response)

Aggregate count of vulnerabilities grouped by cvss score

GET /container-security/aggregates/vulnerabilities/count-by-cvss-score/v1
Scope Falcon Container Image: READ Consumes · Produces application/json
PEP 8 read_vulnerability_counts_by_cvss_score
NameTypeData typeDescription
filterquerystringFilter vulnerabilities using a query in Falcon Query Language (FQL). Supported filters: ai_related,base_os,cid,container_id,container_running_status,containers_impacted_range,cps_rating,cve_id,cvss_score,description,exploited_status,exploited_status_name,fix_status,image_digest,image_id,images_impacted_range,include_base_image_vuln,index_digest,package_name_version,registry,repository,severity,tag
limitqueryintegerThe upper-bound on the number of records to retrieve.
offsetqueryintegerThe offset from where to begin.
parametersquerydictionaryFull query string parameters payload in JSON format. Not required if using other keywords.
from falconpy import ContainerVulnerabilities
falcon = ContainerVulnerabilities(client_id=CLIENT_ID,
client_secret=CLIENT_SECRET
)
response = falcon.read_vulnerability_counts_by_cvss_score(filter="string",
limit=integer,
offset=integer)
print(response)

Aggregate count of vulnerabilities grouped by severity

GET /container-security/aggregates/vulnerabilities/count-by-severity/v1
Scope Falcon Container Image: READ Consumes · Produces application/json
PEP 8 read_vulnerability_counts_by_severity
NameTypeData typeDescription
filterquerystringFilter vulnerabilities using a query in Falcon Query Language (FQL). Supported filters: ai_related,base_os,cid,container_id,container_running_status,containers_impacted_range,cps_rating,cve_id,cvss_score,description,exploited_status,exploited_status_name,fix_status,image_digest,image_id,images_impacted_range,include_base_image_vuln,index_digest,package_name_version,registry,repository,severity,tag
limitqueryintegerThe upper-bound on the number of records to retrieve.
offsetqueryintegerThe offset from where to begin.
parametersquerydictionaryFull query string parameters payload in JSON format. Not required if using other keywords.
from falconpy import ContainerVulnerabilities
falcon = ContainerVulnerabilities(client_id=CLIENT_ID,
client_secret=CLIENT_SECRET
)
response = falcon.read_vulnerability_counts_by_severity(filter="string",
limit="string",
offset="string")
print(response)

Aggregate count of vulnerabilities

GET /container-security/aggregates/vulnerabilities/count/v1
Scope Falcon Container Image: READ Consumes · Produces application/json
PEP 8 read_vulnerability_count
NameTypeData typeDescription
filterquerystringFilter vulnerabilities using a query in Falcon Query Language (FQL). Supported filters: ai_related,base_os,cid,container_id,container_running_status,containers_impacted_range,cps_rating,cve_id,cvss_score,description,exploited_status,exploited_status_name,fix_status,image_digest,image_id,images_impacted_range,include_base_image_vuln,index_digest,package_name_version,registry,repository,severity,tag
limitqueryintegerThe upper-bound on the number of records to retrieve.
offsetqueryintegerThe offset from where to begin.
parametersquerydictionaryFull query string parameters payload in JSON format. Not required if using other keywords.
from falconpy import ContainerVulnerabilities
falcon = ContainerVulnerabilities(client_id=CLIENT_ID,
client_secret=CLIENT_SECRET
)
response = falcon.read_vulnerability_count(filter="string",
limit=integer,
offset=integer)
print(response)

Retrieve top x vulnerabilities with the most impacted images

GET /container-security/combined/vulnerabilities/by-image-count/v1
Scope Falcon Container Image: READ Consumes · Produces application/json
PEP 8 read_vulnerabilities_by_count
NameTypeData typeDescription
filterquerystringFilter vulnerabilities using a query in Falcon Query Language (FQL). Supported filters: cid,cve_id,registry,repository,tag
limitqueryintegerThe upper-bound on the number of records to retrieve.
offsetqueryintegerThe offset from where to begin.
parametersquerydictionaryFull query string parameters payload in JSON format. Not required if using other keywords.
from falconpy import ContainerVulnerabilities
falcon = ContainerVulnerabilities(client_id=CLIENT_ID,
client_secret=CLIENT_SECRET
)
response = falcon.read_vulnerabilities_by_count(filter="string",
limit=integer,
offset=integer)
print(response)

Retrieve top x vulnerabilities with the most recent publication date

GET /container-security/combined/vulnerabilities/by-published-date/v1
Scope Falcon Container Image: READ Consumes · Produces application/json
PEP 8 read_vulnerabilities_by_pub_date
NameTypeData typeDescription
filterquerystringFilter vulnerabilities using a query in Falcon Query Language (FQL). Supported filters: cid,cve_id,registry,repository,tag
limitqueryintegerThe upper-bound on the number of records to retrieve.
offsetqueryintegerThe offset from where to begin.
parametersquerydictionaryFull query string parameters payload in JSON format. Not required if using other keywords.
from falconpy import ContainerVulnerabilities
falcon = ContainerVulnerabilities(client_id=CLIENT_ID,
client_secret=CLIENT_SECRET
)
response = falcon.read_vulnerabilities_by_pub_date(filter="string",
limit=integer,
offset=integer)
print(response)

Retrieve vulnerability details related to an image

GET /container-security/combined/vulnerabilities/details/v1
Scope Falcon Container Image: READ Consumes · Produces application/json
PEP 8 read_combined_vulnerability_detail
NameTypeData typeDescription
idquerystringImage UUID
filterquerystringFilter the vulnerabilities using a query in Falcon Query Language (FQL). Supported vulnerability filters: cid,cps_rating,cve_id,cvss_score,exploited_status,exploited_status_name,include_base_image_vuln,is_zero_day,remediation_available,severity
limitqueryintegerThe upper-bound on the number of records to retrieve. Default: 5000
offsetqueryintegerThe offset from where to begin.
parametersquerydictionaryFull query string parameters payload in JSON format. Not required if using other keywords.
from falconpy import ContainerVulnerabilities
falcon = ContainerVulnerabilities(client_id=CLIENT_ID,
client_secret=CLIENT_SECRET
)
response = falcon.read_combined_vulnerability_detail(id="string",
filter="string",
limit=integer,
offset=integer)
print(response)

Retrieve vulnerability and package related info for this customer

GET /container-security/combined/vulnerabilities/info/v1
Scope Falcon Container Image: READ Consumes · Produces application/json
PEP 8 read_combined_vulnerabilities_info
NameTypeData typeDescription
cve_idquerystringVulnerability CVE ID
limitqueryintegerThe upper-bound on the number of records to retrieve.
offsetqueryintegerThe offset from where to begin.
parametersquerydictionaryFull query string parameters payload in JSON format. Not required if using other keywords.
from falconpy import ContainerVulnerabilities
falcon = ContainerVulnerabilities(client_id=CLIENT_ID,
client_secret=CLIENT_SECRET
)
response = falcon.read_combined_vulnerabilities_info(cve_id="string",
limit=integer,
offset=integer)
print(response)

Retrieve vulnerability and aggregate data filtered by the provided FQL

GET /container-security/combined/vulnerabilities/v1
Scope Falcon Container Image: READ Consumes · Produces application/json
PEP 8 read_combined_vulnerabilities
NameTypeData typeDescription
filterquerystringFilter vulnerabilities using a query in Falcon Query Language (FQL). Supported filters: ai_related,base_os,cid,container_id,container_running_status,containers_impacted_range,cps_rating,cve_id,cvss_score,description,exploited_status,exploited_status_name,fix_status,image_digest,image_id,images_impacted_range,include_base_image_vuln,index_digest,package_name_version,registry,repository,severity,tag
limitqueryintegerThe upper-bound on the number of records to retrieve.
offsetqueryintegerThe offset from where to begin.
parametersquerydictionaryFull query string parameters payload in JSON format. Not required if using other keywords.
sortquerystringThe fields to sort the records on. Supported columns: [cps_current_rating cve_id cvss_score description images_impacted packages_impacted severity]
from falconpy import ContainerVulnerabilities
falcon = ContainerVulnerabilities(client_id=CLIENT_ID,
client_secret=CLIENT_SECRET
)
response = falcon.read_combined_vulnerabilities(filter="string",
limit=integer,
offset=integer,
sort="string")
print(response)