Gets raw resources based on the provided IDs param. Maximum of 100 resources can be requested with this method. Use POST method with same path if more are required.
The maximum number of items to return. When not specified or 0, 20 is used. When larger than 10000, 10000 is used.
offset
query
integer
Offset returned controls. Use only one of 'offset' and 'after' parameter for paginating. 'offset' can only be used on offsets < 10,000. For paginating through the entire result set, use 'after' parameter
after
query
string
token-based pagination. use for paginating through an entire result set. Use only one of 'offset' and 'after' parameters for paginating
include_failing_iom_severity_counts
query
boolean
Include counts of failing IOMs by severity level
parameters
query
dictionary
Full query string parameters payload in JSON format.
Gets raw resources based on the provided IDs param. Maximum of 100 resources can be requested with this method.
PEP8 method name
get_assets
Endpoint
Method
Route
/cloud-security-assets/entities/resources/v1
Required Scope
Content-Type
Consumes: application/json
Produces: application/json
Keyword Arguments
Name
Service
Uber
Type
Data type
Description
ids
query
string or list of strings
List of assets to return (maximum 100 IDs allowed).
parameters
query
dictionary
Full query string parameters payload in JSON format.
Usage
Service class example (PEP8 syntax)
fromfalconpyimportCloudSecurityAssetsfalcon=CloudSecurityAssets(client_id=CLIENT_ID,
client_secret=CLIENT_SECRET
)
id_list='ID1,ID2,ID3'# Can also pass a list here: ['ID1', 'ID2', 'ID3']response=falcon.get_assets(ids=id_list)
print(response)
Service class example (Operation ID syntax)
fromfalconpyimportCloudSecurityAssetsfalcon=CloudSecurityAssets(client_id=CLIENT_ID,
client_secret=CLIENT_SECRET
)
id_list='ID1,ID2,ID3'# Can also pass a list here: ['ID1', 'ID2', 'ID3']response=falcon.cloud_security_assets_entities_get(ids=id_list)
print(response)
Uber class example
fromfalconpyimportAPIHarnessV2falcon=APIHarnessV2(client_id=CLIENT_ID,
client_secret=CLIENT_SECRET
)
id_list='ID1,ID2,ID3'# Can also pass a list here: ['ID1', 'ID2', 'ID3']response=falcon.command("cloud_security_assets_entities_get", ids=id_list)
print(response)
cloud_security_assets_queries
Gets a list of resource IDs for the given parameters, filters and sort criteria.
PEP8 method name
query_assets
Endpoint
Method
Route
/cloud-security-assets/queries/resources/v1
Required Scope
Content-Type
Consumes: application/json
Produces: application/json
Keyword Arguments
Name
Service
Uber
Type
Data type
Description
after
query
string
token-based pagination. use for paginating through an entire result set. Use only one of 'offset' and 'after' parameters for paginating
The field to sort on. Sortable fields include: account_id, account_name, active, cloud_provider, cluster_id, cluster_name, creation_time, data_classifications.found, data_classifications.scanned, first_seen, id, instance_id, instance_state, ioa_count, iom_count, managed_by, organization_Id, os_version, platform_name, publicly_exposed, region, resource_id, resource_name, resource_type, resource_type_name, service, service_category, ssm_managed, status, tenant_id, updated_at, vmware.guest_os_id, vmware.guest_os_version, vmware.host_system_name, vmware.host_type, vmware.instance_uuid, vmware.vm_host_name, vmware.vm_tools_status, and zone.
limit
query
integer
The maximum number of items to return. When not specified or 0, 500 is used. When larger than 1000, 1000 is used.
offset
query
integer
Offset returned assets. Use only one of 'offset' and 'after' parameter for paginating. 'offset' can only be used on offsets < 10,000. For paginating through the entire result set, use 'after' parameter
parameters
query
dictionary
Full query string parameters payload in JSON format.