CrowdStrike Falcon CrowdStrike Subreddit

Using the ASPM service collection

Uber class support Service class support Documentation Version Page Updated

Table of Contents

Operation IDDescription
UpsertBusinessApplications
PEP8update_business_applications
Create or Update Business Applications
GetExecutorNodes
PEP8get_executor_nodes
Get all the relay nodes
UpdateExecutorNode
PEP8update_executor_node
Update an existing relay node
CreateExecutorNode
PEP8create_executor_node
Create a new relay node
DeleteExecutorNode
PEP8delete_node
Delete a relay node
GetIntegrationTasks
PEP8get_integration_tasks
Get all the integration tasks
CreateIntegrationTask
PEP8create_integration_task
Create new integration task.
UpdateIntegrationTask
PEP8update_integration_task
Update an existing integration task by its ID
DeleteIntegrationTask
PEP8delete_integration_task
Delete an existing integration task by its ID
RunIntegrationTask
PEP8run_integration_task
Run an integration task by its ID
GetIntegrationTypes
PEP8get_integration_types
Get all the integration types
GetIntegrations
PEP8get_integrations
Get a list of all the integrations
CreateIntegration
PEP8create_integration
Create a new integration
UpdateIntegration
PEP8update_integration
Update an existing integration by its ID
DeleteIntegration
PEP8delete_integration
Delete an existing integration by its ID
ExecuteQuery
PEP8execute_query
Execute a query. The syntax used is identical to that of the query page.
ServiceNowGetDeployments
PEP8get_servicenow_deployments
Retrieve ServiceNow deployments.
ServiceNowGetServices
PEP8get_servicenow_services
Retrieve ServiceNow services.
GetServicesCount
PEP8get_services_count
Get the total amount of existing services
GetServiceViolationTypes
PEP8get_service_violation_types
Get the different types of violation
GetTags
PEP8get_tags
Get all the tags
UpsertTags
PEP8update_tags
Create new or update existing tag. You can update unique tags table or regular tags table
DeleteTags
PEP8delete_tags
Remove existing tags

UpsertBusinessApplications

Create or Update Business Applications

PEP8 method name

update_business_applications

Endpoint

MethodRoute
PUT/aspm-api-gateway/api/v1/business_applications

Required Scope

aspm-analyst:write

Content-Type

  • Consumes: application/json
  • Produces: application/json

Keyword Arguments

NameServiceUberTypeData typeDescription
bodyService Class SupportUber Class SupportbodydictionaryFull body payload in JSON format.
nameService Class SupportUber Class SupportbodystringApplication name.
persistent_signatureService Class SupportUber Class Supportbodystring or list of stringsSignature to persist.

Usage

Service class example (PEP8 syntax)
from falconpy import ASPM

falcon = ASPM(client_id=CLIENT_ID,
              client_secret=CLIENT_SECRET
              )

response = falcon.update_business_applications(name="string", persistent_signature="string")
print(response)
Service class example (Operation ID syntax)
from falconpy import ASPM

falcon = ASPM(client_id=CLIENT_ID,
              client_secret=CLIENT_SECRET
              )

response = falcon.UpsertBusinessApplications(name="string", persistent_signature="string")
print(response)
Uber class example
from falconpy import APIHarnessV2

falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

body_payload = {
    "name": "string",
    "persistentSignatures": [
        "string"
    ]
}

response = falcon.command("UpsertBusinessApplications", body=body_payload)
print(response)

GetExecutorNodes

Get all the relay nodes

PEP8 method name

get_executor_nodes

Endpoint

MethodRoute
GET/aspm-api-gateway/api/v1/executor_nodes

Required Scope

aspm-admin:read

Content-Type

  • Consumes: application/json
  • Produces: application/json

Keyword Arguments

NameServiceUberTypeData typeDescription
node_typeService Class SupportUber Class SupportquerystringRelay node type.
integration_typeService Class SupportUber Class SupportquerystringIntegration type.
parametersService Class SupportUber Class SupportquerydictionaryFull query string parameters payload in JSON format.

Usage

Service class example (PEP8 syntax)
from falconpy import ASPM

falcon = ASPM(client_id=CLIENT_ID,
              client_secret=CLIENT_SECRET
              )

response = falcon.get_executor_nodes(node_type="string", integration_type="string")
print(response)
Service class example (Operation ID syntax)
from falconpy import ASPM

falcon = ASPM(client_id=CLIENT_ID,
              client_secret=CLIENT_SECRET
              )

response = falcon.GetExecutorNodes(node_type="string", integration_type="string")
print(response)
Uber class example
from falconpy import APIHarnessV2

falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

response = falcon.command("GetExecutorNodes", node_type="string", integration_type="string")
print(response)

UpdateExecutorNode

Update an existing relay node

PEP8 method name

update_executor_node

Endpoint

MethodRoute
PUT/aspm-api-gateway/api/v1/executor_nodes

Required Scope

aspm-admin:write

Content-Type

  • Consumes: application/json
  • Produces: application/json

Keyword Arguments

NameServiceUberTypeData typeDescription
bodyService Class SupportUber Class SupportbodydictionaryFull body payload in JSON format.
additional_headerService Class SupportUber Class SupportbodystringAdditional headers.
current_aws_arnService Class SupportUber Class SupportbodystringAWS ARN.
dashboard_urlService Class SupportUber Class SupportbodystringDashboard URL address.
last_health_checkService Class SupportUber Class SupportbodyintegerLast health check.
nameService Class SupportUber Class SupportbodystringNode name.
node_typeService Class SupportUber Class SupportbodystringNode type.
passwordService Class SupportUber Class SupportbodystringPassword.
pod_settingsService Class SupportUber Class SupportbodydictionaryPod settings.
proxy_addressService Class SupportUber Class SupportbodystringProxy server address.
typeService Class SupportUber Class SupportbodystringType.
use_jobsService Class SupportUber Class SupportbodybooleanFlag indicating if jobs should be used.
usernameService Class SupportUber Class SupportbodystringUsername.

Usage

Service class example (PEP8 syntax)
from falconpy import ASPM

falcon = ASPM(client_id=CLIENT_ID,
              client_secret=CLIENT_SECRET
              )

pod_set = {
    "imageAddress": "string",
    "imagePullSecrets": [
        "string"
    ],
    "podLabels": [
        {
            "key": "string",
            "value": "string"
        }
    ]
}

response = falcon.create_executor_node(additional_header="string",
                                       current_aws_arn="string",
                                       dashboard_url="string",
                                       last_health_check=integer,
                                       name="string",
                                       node_type="string",
                                       password="string",
                                       pod_settings=pod_set,
                                       proxy_address="string",
                                       type="string",
                                       use_jobs=boolean,
                                       username="string"
                                       )
print(response)
Service class example (Operation ID syntax)
from falconpy import ASPM

falcon = ASPM(client_id=CLIENT_ID,
              client_secret=CLIENT_SECRET
              )

pod_set = {
    "imageAddress": "string",
    "imagePullSecrets": [
        "string"
    ],
    "podLabels": [
        {
            "key": "string",
            "value": "string"
        }
    ]
}

response = falcon.CreateExecutorNode(additional_header="string",
                                     current_aws_arn="string",
                                     dashboard_url="string",
                                     last_health_check=integer,
                                     name="string",
                                     node_type="string",
                                     password="string",
                                     pod_settings=pod_set,
                                     proxy_address="string",
                                     type="string",
                                     use_jobs=boolean,
                                     username="string"
                                     )
print(response)
Uber class example
from falconpy import APIHarnessV2

falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

body_payload = {
  "additional_header": "string",
  "current_aws_arn": "string",
  "dashboard_url": "string",
  "last_health_check": 0,
  "name": "string",
  "node_type": "string",
  "password": "string",
  "pod_settings": {
    "imageAddress": "string",
    "imagePullSecrets": [
      "string"
    ],
    "podLabels": [
      {
        "key": "string",
        "value": "string"
      }
    ]
  },
  "proxy_address": "string",
  "type": "string",
  "useJobs": true,
  "username": "string"
}

response = falcon.command("UpdateExecutorNode", body=body_payload)
print(response)

CreateExecutorNode

Create a new relay node

PEP8 method name

create_executor_node

Endpoint

MethodRoute
POST/aspm-api-gateway/api/v1/executor_nodes

Required Scope

aspm-admin:write

Content-Type

  • Consumes: application/json
  • Produces: application/json

Keyword Arguments

NameServiceUberTypeData typeDescription
bodyService Class SupportUber Class SupportbodydictionaryFull body payload in JSON format.
additional_headerService Class SupportUber Class SupportbodystringAdditional headers.
current_aws_arnService Class SupportUber Class SupportbodystringAWS ARN.
dashboard_urlService Class SupportUber Class SupportbodystringDashboard URL address.
idService Class SupportUber Class SupportbodyintegerNode ID.
last_health_checkService Class SupportUber Class SupportbodyintegerLast health check.
nameService Class SupportUber Class SupportbodystringNode name.
node_typeService Class SupportUber Class SupportbodystringNode type.
passwordService Class SupportUber Class SupportbodystringPassword.
pod_settingsService Class SupportUber Class SupportbodydictionaryPod settings.
proxy_addressService Class SupportUber Class SupportbodystringProxy server address.
typeService Class SupportUber Class SupportbodystringType.
use_jobsService Class SupportUber Class SupportbodybooleanFlag indicating if jobs should be used.
usernameService Class SupportUber Class SupportbodystringUsername.

Usage

Service class example (PEP8 syntax)
from falconpy import ASPM

falcon = ASPM(client_id=CLIENT_ID,
              client_secret=CLIENT_SECRET
              )

pod_set = {
    "imageAddress": "string",
    "imagePullSecrets": [
        "string"
    ],
    "podLabels": [
        {
            "key": "string",
            "value": "string"
        }
    ]
}

response = falcon.create_executor_node(additional_header="string",
                                       current_aws_arn="string",
                                       dashboard_url="string",
                                       id=integer,
                                       last_health_check=integer,
                                       name="string",
                                       node_type="string",
                                       password="string",
                                       pod_settings=pod_set,
                                       proxy_address="string",
                                       type="string",
                                       use_jobs=boolean,
                                       username="string"
                                       )
print(response)
Service class example (Operation ID syntax)
from falconpy import ASPM

falcon = ASPM(client_id=CLIENT_ID,
              client_secret=CLIENT_SECRET
              )

pod_set = {
    "imageAddress": "string",
    "imagePullSecrets": [
        "string"
    ],
    "podLabels": [
        {
            "key": "string",
            "value": "string"
        }
    ]
}

response = falcon.CreateExecutorNode(additional_header="string",
                                     current_aws_arn="string",
                                     dashboard_url="string",
                                     id=integer,
                                     last_health_check=integer,
                                     name="string",
                                     node_type="string",
                                     password="string",
                                     pod_settings=pod_set,
                                     proxy_address="string",
                                     type="string",
                                     use_jobs=boolean,
                                     username="string"
                                     )
print(response)
Uber class example
from falconpy import APIHarnessV2

falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

body_payload = {
  "additional_header": "string",
  "current_aws_arn": "string",
  "dashboard_url": "string",
  "id": 0,
  "last_health_check": 0,
  "name": "string",
  "node_type": "string",
  "password": "string",
  "pod_settings": {
    "imageAddress": "string",
    "imagePullSecrets": [
      "string"
    ],
    "podLabels": [
      {
        "key": "string",
        "value": "string"
      }
    ]
  },
  "proxy_address": "string",
  "type": "string",
  "useJobs": true,
  "username": "string"
}

response = falcon.command("CreateExecutorNode", body=BODY)
print(response)

DeleteExecutorNode

Delete a relay node

PEP8 method name

delete_node

Endpoint

MethodRoute
DELETE/aspm-api-gateway/api/v1/executor_nodes/{ID}

Required Scope

aspm-admin:write

Content-Type

  • Consumes: application/json
  • Produces: application/json

Keyword Arguments

NameServiceUberTypeData typeDescription
idService Class SupportUber Class SupportpathintegerExecutor node ID.

Usage

Service class example (PEP8 syntax)
from falconpy import ASPM

falcon = ASPM(client_id=CLIENT_ID,
              client_secret=CLIENT_SECRET
              )

response = falcon.delete_node(id=integer)
print(response)
Service class example (Operation ID syntax)
from falconpy import ASPM

falcon = ASPM(client_id=CLIENT_ID,
              client_secret=CLIENT_SECRET
              )

response = falcon.DeleteExecutorNode(id=integer)
print(response)
Uber class example
from falconpy import APIHarnessV2

falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

response = falcon.command("DeleteExecutorNode", id=integer)
print(response)

GetIntegrationTasks

Get all the integration tasks

PEP8 method name

get_integration_tasks

Endpoint

MethodRoute
GET/aspm-api-gateway/api/v1/integration_tasks

Required Scope

aspm-read-only:read

Content-Type

  • Consumes: application/json
  • Produces: application/json

Keyword Arguments

NameServiceUberTypeData typeDescription
integration_task_typeService Class SupportUber Class SupportquerystringIntegration task type.
categoryService Class SupportUber Class SupportquerystringIntegration task category.
parametersService Class SupportUber Class SupportquerydictionaryFull query string parameters payload in JSON format.

Usage

Service class example (PEP8 syntax)
from falconpy import ASPM

falcon = ASPM(client_id=CLIENT_ID,
              client_secret=CLIENT_SECRET
              )

response = falcon.get_integration_tasks(integration_task_type="string", category="string")
print(response)
Service class example (Operation ID syntax)
from falconpy import ASPM

falcon = ASPM(client_id=CLIENT_ID,
              client_secret=CLIENT_SECRET
              )

response = falcon.GetIntegrationTasks(integration_task_type="string", category="string")
print(response)
Uber class example
from falconpy import APIHarnessV2

falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

response = falcon.command("GetIntegrationTasks", integration_task_type="string", category="string")
print(response)

CreateIntegrationTask

Create new integration task.

PEP8 method name

create_integration_task

Endpoint

MethodRoute
POST/aspm-api-gateway/api/v1/integration_tasks

Required Scope

aspm-admin:write

Content-Type

  • Consumes: application/json
  • Produces: application/json

Keyword Arguments

NameServiceUberTypeData typeDescription
bodyService Class SupportUber Class SupportbodydictionaryFull body payload in JSON format.
access_tokenService Class SupportUber Class SupportbodystringAccess token.
task_idService Class SupportUber Class SupportbodyintegerTask ID.
dataService Class SupportUber Class SupportbodystringTask data content.
overrideService Class SupportUber Class SupportbodybooleanFlag indicating if this task should override other task values.
scheduledService Class SupportUber Class SupportbodybooleanFlag indicating if this task is scheduled.
idService Class SupportUber Class SupportpathdictionaryID of the integration task to execute.
integration_taskService Class SupportUber Class SupportqueryintegrationFull integration task detail.

Usage

Service class example (PEP8 syntax)
from falconpy import ASPM

falcon = ASPM(client_id=CLIENT_ID,
              client_secret=CLIENT_SECRET
              )

task_dictionary = {
    "access_token": "string",
    "additional_header": "string",
    "business_application": "string",
    "data": "string",
    "enabled": boolean,
    "id": integer,
    "integration": {
    "data": "string",
    "enabled": boolean,
    "id": integer,
    "integration_type": {
        "configured": boolean,
        "display_name": "string",
        "enabled": boolean,
        "id": integer,
        "name": "string"
    },
    "name": "string",
    "node": {
        "additional_header": "string",
        "current_aws_arn": "string",
        "dashboard_url": "string",
        "id": integer,
        "last_health_check": integer,
        "name": "string",
        "node_type": "string",
        "password": "string",
        "pod_settings": {
        "imageAddress": "string",
        "imagePullSecrets": [
            "string"
        ],
        "podLabels": [
            {
            "key": "string",
            "value": "string"
            }
        ]
        },
        "proxy_address": "string",
        "type": "string",
        "useJobs": boolean,
        "username": "string"
    },
    "type": {
        "configured": boolean,
        "display_name": "string",
        "enabled": boolean,
        "id": integer,
        "name": "string"
    },
    "update_time": integer
    },
    "integration_task_type": {
    "category": "string",
    "display_name": "string",
    "enabled": boolean,
    "id": integer,
    "name": "string",
    "required_integration_types": [
        {
        "configured": boolean,
        "display_name": "string",
        "enabled": boolean,
        "id": integer,
        "name": "string"
        }
    ]
    },
    "latest_task_run": {
    "create_time": {
        "nanos": integer,
        "seconds": integer
    },
    "events": [
        {
        "FlatData": {
            "additionalProp1": "string",
            "additionalProp2": "string",
            "additionalProp3": "string"
        },
        "additional_data": "string",
        "data": {
            "additional_info": "string",
            "aws": {
            "accountArn": "string",
            "region": "string"
            },
            "azureSite": {
            "location": "string",
            "resourceGroup": "string",
            "siteId": "string",
            "siteKind": "string",
            "siteName": "string",
            "subscriptionId": "string"
            },
            "azureVm": {
            "id": "string",
            "region": "string",
            "resourceGroup": "string",
            "subscriptionId": "string",
            "vmName": "string"
            },
            "cloud_function": {
            "function_name": "string"
            },
            "crowdstrike_cloud_security": {
            "baseUrl": "string",
            "clientId": "string",
            "cloudProvider": "string",
            "iomID": "string",
            "policyId": integer,
            "resourceId": "string",
            "resourceType": "string"
            },
            "ec2": {
            "instance_id": "string",
            "instance_name": "string"
            },
            "ecs": {
            "clusterName": "string",
            "collectionMethod": integer,
            "resourceArn": "string",
            "resourceName": "string",
            "resourceType": "string"
            },
            "gcp": {
            "project": "string",
            "region": "string"
            },
            "host": {
            "address": "string"
            },
            "k8s": {
            "container": "string",
            "namespace": "string",
            "pod_name": "string"
            },
            "lambda": {
            "lambdaArn": "string",
            "lambdaName": "string"
            },
            "remedy": {
            "content": "string",
            "url": "string"
            },
            "snyk": {
            "apiEndpointUrl": "string",
            "appEndpointUrl": "string",
            "groupId": "string"
            },
            "sonatype": {
            "CVEId": "string",
            "applicationPublicId": "string",
            "componentNameVersion": "string",
            "iqServerUrl": "string"
            }
        },
        "flat_fields": [
            "string"
        ],
        "id": integer,
        "message": "string",
        "object": "string",
        "object_type": "string",
        "send_time": {
            "nanos": integer,
            "seconds": integer
        },
        "status": integer
        }
    ],
    "id": integer,
    "latest_event": {
        "FlatData": {
        "additionalProp1": "string",
        "additionalProp2": "string",
        "additionalProp3": "string"
        },
        "additional_data": "string",
        "data": {
        "additional_info": "string",
        "aws": {
            "accountArn": "string",
            "region": "string"
        },
        "azureSite": {
            "location": "string",
            "resourceGroup": "string",
            "siteId": "string",
            "siteKind": "string",
            "siteName": "string",
            "subscriptionId": "string"
        },
        "azureVm": {
            "id": "string",
            "region": "string",
            "resourceGroup": "string",
            "subscriptionId": "string",
            "vmName": "string"
        },
        "cloud_function": {
            "function_name": "string"
        },
        "crowdstrike_cloud_security": {
            "baseUrl": "string",
            "clientId": "string",
            "cloudProvider": "string",
            "iomID": "string",
            "policyId": integer,
            "resourceId": "string",
            "resourceType": "string"
        },
        "ec2": {
            "instance_id": "string",
            "instance_name": "string"
        },
        "ecs": {
            "clusterName": "string",
            "collectionMethod": integer,
            "resourceArn": "string",
            "resourceName": "string",
            "resourceType": "string"
        },
        "gcp": {
            "project": "string",
            "region": "string"
        },
        "host": {
            "address": "string"
        },
        "k8s": {
            "container": "string",
            "namespace": "string",
            "pod_name": "string"
        },
        "lambda": {
            "lambdaArn": "string",
            "lambdaName": "string"
        },
        "remedy": {
            "content": "string",
            "url": "string"
        },
        "snyk": {
            "apiEndpointUrl": "string",
            "appEndpointUrl": "string",
            "groupId": "string"
        },
        "sonatype": {
            "CVEId": "string",
            "applicationPublicId": "string",
            "componentNameVersion": "string",
            "iqServerUrl": "string"
        }
        },
        "flat_fields": [
        "string"
        ],
        "id": integer,
        "message": "string",
        "object": "string",
        "object_type": "string",
        "send_time": {
        "nanos": integer,
        "seconds": integer
        },
        "status": integer
    },
    "metadata": {
        "collected_objects": integer,
        "end_time": {
        "nanos": integer,
        "seconds": integer
        },
        "integration_task_id": integer,
        "integration_task_name": "string",
        "integration_task_type": {
        "category": "string",
        "display_name": "string",
        "enabled": boolean,
        "id": integer,
        "name": "string",
        "required_integration_types": [
            {
            "configured": boolean,
            "display_name": "string",
            "enabled": boolean,
            "id": integer,
            "name": "string"
            }
        ]
        },
        "start_time": {
        "nanos": integer,
        "seconds": integer
        },
        "total_objects": integer
    },
    "progress": integer,
    "scheduled": boolean,
    "trace_uuid": "string"
    },
    "name": "string",
    "next_run": {
    "nanos": integer,
    "seconds": integer
    },
    "progress": integer,
    "schedule": {
    "every": integer,
    "every_unit": integer,
    "hour": integer,
    "minute": integer,
    "startTimeTimezoneOffsetMinutes": integer,
    "start_time": {
        "nanos": integer,
        "seconds": integer
    },
    "timezone": integer,
    "weekdays": [
        integer
    ]
    },
    "schedule_every_unit_display_name": "string",
    "trigger": "string",
    "type": {
    "category": "string",
    "display_name": "string",
    "enabled": boolean,
    "id": integer,
    "name": "string",
    "required_integration_types": [
        {
        "configured": boolean,
        "display_name": "string",
        "enabled": boolean,
        "id": integer,
        "name": "string"
        }
    ]
    }
}

response = falcon.create_integration_task(access_token="string",
                                          task_id=integer,
                                          data="string",
                                          override=boolean,
                                          scheduled=boolean,
                                          id=integer,
                                          integration_task=task_dictionary
                                          )
print(response)
Service class example (Operation ID syntax)
from falconpy import ASPM

falcon = ASPM(client_id=CLIENT_ID,
              client_secret=CLIENT_SECRET
              )

task_dictionary = {
    "access_token": "string",
    "additional_header": "string",
    "business_application": "string",
    "data": "string",
    "enabled": boolean,
    "id": integer,
    "integration": {
    "data": "string",
    "enabled": boolean,
    "id": integer,
    "integration_type": {
        "configured": boolean,
        "display_name": "string",
        "enabled": boolean,
        "id": integer,
        "name": "string"
    },
    "name": "string",
    "node": {
        "additional_header": "string",
        "current_aws_arn": "string",
        "dashboard_url": "string",
        "id": integer,
        "last_health_check": integer,
        "name": "string",
        "node_type": "string",
        "password": "string",
        "pod_settings": {
        "imageAddress": "string",
        "imagePullSecrets": [
            "string"
        ],
        "podLabels": [
            {
            "key": "string",
            "value": "string"
            }
        ]
        },
        "proxy_address": "string",
        "type": "string",
        "useJobs": boolean,
        "username": "string"
    },
    "type": {
        "configured": boolean,
        "display_name": "string",
        "enabled": boolean,
        "id": integer,
        "name": "string"
    },
    "update_time": integer
    },
    "integration_task_type": {
    "category": "string",
    "display_name": "string",
    "enabled": boolean,
    "id": integer,
    "name": "string",
    "required_integration_types": [
        {
        "configured": boolean,
        "display_name": "string",
        "enabled": boolean,
        "id": integer,
        "name": "string"
        }
    ]
    },
    "latest_task_run": {
    "create_time": {
        "nanos": integer,
        "seconds": integer
    },
    "events": [
        {
        "FlatData": {
            "additionalProp1": "string",
            "additionalProp2": "string",
            "additionalProp3": "string"
        },
        "additional_data": "string",
        "data": {
            "additional_info": "string",
            "aws": {
            "accountArn": "string",
            "region": "string"
            },
            "azureSite": {
            "location": "string",
            "resourceGroup": "string",
            "siteId": "string",
            "siteKind": "string",
            "siteName": "string",
            "subscriptionId": "string"
            },
            "azureVm": {
            "id": "string",
            "region": "string",
            "resourceGroup": "string",
            "subscriptionId": "string",
            "vmName": "string"
            },
            "cloud_function": {
            "function_name": "string"
            },
            "crowdstrike_cloud_security": {
            "baseUrl": "string",
            "clientId": "string",
            "cloudProvider": "string",
            "iomID": "string",
            "policyId": integer,
            "resourceId": "string",
            "resourceType": "string"
            },
            "ec2": {
            "instance_id": "string",
            "instance_name": "string"
            },
            "ecs": {
            "clusterName": "string",
            "collectionMethod": integer,
            "resourceArn": "string",
            "resourceName": "string",
            "resourceType": "string"
            },
            "gcp": {
            "project": "string",
            "region": "string"
            },
            "host": {
            "address": "string"
            },
            "k8s": {
            "container": "string",
            "namespace": "string",
            "pod_name": "string"
            },
            "lambda": {
            "lambdaArn": "string",
            "lambdaName": "string"
            },
            "remedy": {
            "content": "string",
            "url": "string"
            },
            "snyk": {
            "apiEndpointUrl": "string",
            "appEndpointUrl": "string",
            "groupId": "string"
            },
            "sonatype": {
            "CVEId": "string",
            "applicationPublicId": "string",
            "componentNameVersion": "string",
            "iqServerUrl": "string"
            }
        },
        "flat_fields": [
            "string"
        ],
        "id": integer,
        "message": "string",
        "object": "string",
        "object_type": "string",
        "send_time": {
            "nanos": integer,
            "seconds": integer
        },
        "status": integer
        }
    ],
    "id": integer,
    "latest_event": {
        "FlatData": {
        "additionalProp1": "string",
        "additionalProp2": "string",
        "additionalProp3": "string"
        },
        "additional_data": "string",
        "data": {
        "additional_info": "string",
        "aws": {
            "accountArn": "string",
            "region": "string"
        },
        "azureSite": {
            "location": "string",
            "resourceGroup": "string",
            "siteId": "string",
            "siteKind": "string",
            "siteName": "string",
            "subscriptionId": "string"
        },
        "azureVm": {
            "id": "string",
            "region": "string",
            "resourceGroup": "string",
            "subscriptionId": "string",
            "vmName": "string"
        },
        "cloud_function": {
            "function_name": "string"
        },
        "crowdstrike_cloud_security": {
            "baseUrl": "string",
            "clientId": "string",
            "cloudProvider": "string",
            "iomID": "string",
            "policyId": integer,
            "resourceId": "string",
            "resourceType": "string"
        },
        "ec2": {
            "instance_id": "string",
            "instance_name": "string"
        },
        "ecs": {
            "clusterName": "string",
            "collectionMethod": integer,
            "resourceArn": "string",
            "resourceName": "string",
            "resourceType": "string"
        },
        "gcp": {
            "project": "string",
            "region": "string"
        },
        "host": {
            "address": "string"
        },
        "k8s": {
            "container": "string",
            "namespace": "string",
            "pod_name": "string"
        },
        "lambda": {
            "lambdaArn": "string",
            "lambdaName": "string"
        },
        "remedy": {
            "content": "string",
            "url": "string"
        },
        "snyk": {
            "apiEndpointUrl": "string",
            "appEndpointUrl": "string",
            "groupId": "string"
        },
        "sonatype": {
            "CVEId": "string",
            "applicationPublicId": "string",
            "componentNameVersion": "string",
            "iqServerUrl": "string"
        }
        },
        "flat_fields": [
        "string"
        ],
        "id": integer,
        "message": "string",
        "object": "string",
        "object_type": "string",
        "send_time": {
        "nanos": integer,
        "seconds": integer
        },
        "status": integer
    },
    "metadata": {
        "collected_objects": integer,
        "end_time": {
        "nanos": integer,
        "seconds": integer
        },
        "integration_task_id": integer,
        "integration_task_name": "string",
        "integration_task_type": {
        "category": "string",
        "display_name": "string",
        "enabled": boolean,
        "id": integer,
        "name": "string",
        "required_integration_types": [
            {
            "configured": boolean,
            "display_name": "string",
            "enabled": boolean,
            "id": integer,
            "name": "string"
            }
        ]
        },
        "start_time": {
        "nanos": integer,
        "seconds": integer
        },
        "total_objects": integer
    },
    "progress": integer,
    "scheduled": boolean,
    "trace_uuid": "string"
    },
    "name": "string",
    "next_run": {
    "nanos": integer,
    "seconds": integer
    },
    "progress": integer,
    "schedule": {
    "every": integer,
    "every_unit": integer,
    "hour": integer,
    "minute": integer,
    "startTimeTimezoneOffsetMinutes": integer,
    "start_time": {
        "nanos": integer,
        "seconds": integer
    },
    "timezone": integer,
    "weekdays": [
        integer
    ]
    },
    "schedule_every_unit_display_name": "string",
    "trigger": "string",
    "type": {
    "category": "string",
    "display_name": "string",
    "enabled": boolean,
    "id": integer,
    "name": "string",
    "required_integration_types": [
        {
        "configured": boolean,
        "display_name": "string",
        "enabled": boolean,
        "id": integer,
        "name": "string"
        }
    ]
    }
}

response = falcon.CreateIntegrationTask(access_token="string",
                                        task_id=integer,
                                        data="string",
                                        override=boolean,
                                        scheduled=boolean,
                                        id=integer,
                                        integration_task=task_dictionary
                                        )
print(response)
Uber class example
from falconpy import APIHarnessV2

falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

body_payload = {
  "integration_task": {
    "access_token": "string",
    "additional_header": "string",
    "business_application": "string",
    "data": "string",
    "enabled": boolean,
    "id": integer,
    "integration": {
      "data": "string",
      "enabled": boolean,
      "id": integer,
      "integration_type": {
        "configured": boolean,
        "display_name": "string",
        "enabled": boolean,
        "id": integer,
        "name": "string"
      },
      "name": "string",
      "node": {
        "additional_header": "string",
        "current_aws_arn": "string",
        "dashboard_url": "string",
        "id": integer,
        "last_health_check": integer,
        "name": "string",
        "node_type": "string",
        "password": "string",
        "pod_settings": {
          "imageAddress": "string",
          "imagePullSecrets": [
            "string"
          ],
          "podLabels": [
            {
              "key": "string",
              "value": "string"
            }
          ]
        },
        "proxy_address": "string",
        "type": "string",
        "useJobs": boolean,
        "username": "string"
      },
      "type": {
        "configured": boolean,
        "display_name": "string",
        "enabled": boolean,
        "id": integer,
        "name": "string"
      },
      "update_time": integer
    },
    "integration_task_type": {
      "category": "string",
      "display_name": "string",
      "enabled": boolean,
      "id": integer,
      "name": "string",
      "required_integration_types": [
        {
          "configured": boolean,
          "display_name": "string",
          "enabled": boolean,
          "id": integer,
          "name": "string"
        }
      ]
    },
    "latest_task_run": {
      "create_time": {
        "nanos": integer,
        "seconds": integer
      },
      "events": [
        {
          "FlatData": {
            "additionalProp1": "string",
            "additionalProp2": "string",
            "additionalProp3": "string"
          },
          "additional_data": "string",
          "data": {
            "additional_info": "string",
            "aws": {
              "accountArn": "string",
              "region": "string"
            },
            "azureSite": {
              "location": "string",
              "resourceGroup": "string",
              "siteId": "string",
              "siteKind": "string",
              "siteName": "string",
              "subscriptionId": "string"
            },
            "azureVm": {
              "id": "string",
              "region": "string",
              "resourceGroup": "string",
              "subscriptionId": "string",
              "vmName": "string"
            },
            "cloud_function": {
              "function_name": "string"
            },
            "crowdstrike_cloud_security": {
              "baseUrl": "string",
              "clientId": "string",
              "cloudProvider": "string",
              "iomID": "string",
              "policyId": integer,
              "resourceId": "string",
              "resourceType": "string"
            },
            "ec2": {
              "instance_id": "string",
              "instance_name": "string"
            },
            "ecs": {
              "clusterName": "string",
              "collectionMethod": integer,
              "resourceArn": "string",
              "resourceName": "string",
              "resourceType": "string"
            },
            "gcp": {
              "project": "string",
              "region": "string"
            },
            "host": {
              "address": "string"
            },
            "k8s": {
              "container": "string",
              "namespace": "string",
              "pod_name": "string"
            },
            "lambda": {
              "lambdaArn": "string",
              "lambdaName": "string"
            },
            "remedy": {
              "content": "string",
              "url": "string"
            },
            "snyk": {
              "apiEndpointUrl": "string",
              "appEndpointUrl": "string",
              "groupId": "string"
            },
            "sonatype": {
              "CVEId": "string",
              "applicationPublicId": "string",
              "componentNameVersion": "string",
              "iqServerUrl": "string"
            }
          },
          "flat_fields": [
            "string"
          ],
          "id": integer,
          "message": "string",
          "object": "string",
          "object_type": "string",
          "send_time": {
            "nanos": integer,
            "seconds": integer
          },
          "status": integer
        }
      ],
      "id": integer,
      "latest_event": {
        "FlatData": {
          "additionalProp1": "string",
          "additionalProp2": "string",
          "additionalProp3": "string"
        },
        "additional_data": "string",
        "data": {
          "additional_info": "string",
          "aws": {
            "accountArn": "string",
            "region": "string"
          },
          "azureSite": {
            "location": "string",
            "resourceGroup": "string",
            "siteId": "string",
            "siteKind": "string",
            "siteName": "string",
            "subscriptionId": "string"
          },
          "azureVm": {
            "id": "string",
            "region": "string",
            "resourceGroup": "string",
            "subscriptionId": "string",
            "vmName": "string"
          },
          "cloud_function": {
            "function_name": "string"
          },
          "crowdstrike_cloud_security": {
            "baseUrl": "string",
            "clientId": "string",
            "cloudProvider": "string",
            "iomID": "string",
            "policyId": integer,
            "resourceId": "string",
            "resourceType": "string"
          },
          "ec2": {
            "instance_id": "string",
            "instance_name": "string"
          },
          "ecs": {
            "clusterName": "string",
            "collectionMethod": integer,
            "resourceArn": "string",
            "resourceName": "string",
            "resourceType": "string"
          },
          "gcp": {
            "project": "string",
            "region": "string"
          },
          "host": {
            "address": "string"
          },
          "k8s": {
            "container": "string",
            "namespace": "string",
            "pod_name": "string"
          },
          "lambda": {
            "lambdaArn": "string",
            "lambdaName": "string"
          },
          "remedy": {
            "content": "string",
            "url": "string"
          },
          "snyk": {
            "apiEndpointUrl": "string",
            "appEndpointUrl": "string",
            "groupId": "string"
          },
          "sonatype": {
            "CVEId": "string",
            "applicationPublicId": "string",
            "componentNameVersion": "string",
            "iqServerUrl": "string"
          }
        },
        "flat_fields": [
          "string"
        ],
        "id": integer,
        "message": "string",
        "object": "string",
        "object_type": "string",
        "send_time": {
          "nanos": integer,
          "seconds": integer
        },
        "status": integer
      },
      "metadata": {
        "collected_objects": integer,
        "end_time": {
          "nanos": integer,
          "seconds": integer
        },
        "integration_task_id": integer,
        "integration_task_name": "string",
        "integration_task_type": {
          "category": "string",
          "display_name": "string",
          "enabled": boolean,
          "id": integer,
          "name": "string",
          "required_integration_types": [
            {
              "configured": boolean,
              "display_name": "string",
              "enabled": boolean,
              "id": integer,
              "name": "string"
            }
          ]
        },
        "start_time": {
          "nanos": integer,
          "seconds": integer
        },
        "total_objects": integer
      },
      "progress": integer,
      "scheduled": boolean,
      "trace_uuid": "string"
    },
    "name": "string",
    "next_run": {
      "nanos": integer,
      "seconds": integer
    },
    "progress": integer,
    "schedule": {
      "every": integer,
      "every_unit": integer,
      "hour": integer,
      "minute": integer,
      "startTimeTimezoneOffsetMinutes": integer,
      "start_time": {
        "nanos": integer,
        "seconds": integer
      },
      "timezone": integer,
      "weekdays": [
        integer
      ]
    },
    "schedule_every_unit_display_name": "string",
    "trigger": "string",
    "type": {
      "category": "string",
      "display_name": "string",
      "enabled": boolean,
      "id": integer,
      "name": "string",
      "required_integration_types": [
        {
          "configured": boolean,
          "display_name": "string",
          "enabled": boolean,
          "id": integer,
          "name": "string"
        }
      ]
    }
  }
}

response = falcon.command("CreateIntegrationTask", body=body_payload)
print(response)

UpdateIntegrationTask

Update an existing integration task by its ID

PEP8 method name

update_integration_task

Endpoint

MethodRoute
PUT/aspm-api-gateway/api/v1/integration_tasks/{ID}

Required Scope

aspm-admin:write

Content-Type

  • Consumes: application/json
  • Produces: application/json

Keyword Arguments

NameServiceUberTypeData typeDescription
bodyService Class SupportUber Class SupportbodydictionaryFull body payload in JSON format.
access_tokenService Class SupportUber Class SupportbodystringAccess token.
task_idService Class SupportUber Class SupportbodyintegerTask ID.
dataService Class SupportUber Class SupportbodystringTask data content.
overrideService Class SupportUber Class SupportbodybooleanFlag indicating if this task should override other task values.
scheduledService Class SupportUber Class SupportbodybooleanFlag indicating if this task is scheduled.
idService Class SupportUber Class SupportpathdictionaryID of the integration task to execute.
integration_taskService Class SupportUber Class SupportqueryintegrationFull integration task detail.

Usage

Service class example (PEP8 syntax)
from falconpy import ASPM

falcon = ASPM(client_id=CLIENT_ID,
              client_secret=CLIENT_SECRET
              )

task_dictionary = {
    "access_token": "string",
    "additional_header": "string",
    "business_application": "string",
    "data": "string",
    "enabled": boolean,
    "id": integer,
    "integration": {
    "data": "string",
    "enabled": boolean,
    "id": integer,
    "integration_type": {
        "configured": boolean,
        "display_name": "string",
        "enabled": boolean,
        "id": integer,
        "name": "string"
    },
    "name": "string",
    "node": {
        "additional_header": "string",
        "current_aws_arn": "string",
        "dashboard_url": "string",
        "id": integer,
        "last_health_check": integer,
        "name": "string",
        "node_type": "string",
        "password": "string",
        "pod_settings": {
        "imageAddress": "string",
        "imagePullSecrets": [
            "string"
        ],
        "podLabels": [
            {
            "key": "string",
            "value": "string"
            }
        ]
        },
        "proxy_address": "string",
        "type": "string",
        "useJobs": boolean,
        "username": "string"
    },
    "type": {
        "configured": boolean,
        "display_name": "string",
        "enabled": boolean,
        "id": integer,
        "name": "string"
    },
    "update_time": integer
    },
    "integration_task_type": {
    "category": "string",
    "display_name": "string",
    "enabled": boolean,
    "id": integer,
    "name": "string",
    "required_integration_types": [
        {
        "configured": boolean,
        "display_name": "string",
        "enabled": boolean,
        "id": integer,
        "name": "string"
        }
    ]
    },
    "latest_task_run": {
    "create_time": {
        "nanos": integer,
        "seconds": integer
    },
    "events": [
        {
        "FlatData": {
            "additionalProp1": "string",
            "additionalProp2": "string",
            "additionalProp3": "string"
        },
        "additional_data": "string",
        "data": {
            "additional_info": "string",
            "aws": {
            "accountArn": "string",
            "region": "string"
            },
            "azureSite": {
            "location": "string",
            "resourceGroup": "string",
            "siteId": "string",
            "siteKind": "string",
            "siteName": "string",
            "subscriptionId": "string"
            },
            "azureVm": {
            "id": "string",
            "region": "string",
            "resourceGroup": "string",
            "subscriptionId": "string",
            "vmName": "string"
            },
            "cloud_function": {
            "function_name": "string"
            },
            "crowdstrike_cloud_security": {
            "baseUrl": "string",
            "clientId": "string",
            "cloudProvider": "string",
            "iomID": "string",
            "policyId": integer,
            "resourceId": "string",
            "resourceType": "string"
            },
            "ec2": {
            "instance_id": "string",
            "instance_name": "string"
            },
            "ecs": {
            "clusterName": "string",
            "collectionMethod": integer,
            "resourceArn": "string",
            "resourceName": "string",
            "resourceType": "string"
            },
            "gcp": {
            "project": "string",
            "region": "string"
            },
            "host": {
            "address": "string"
            },
            "k8s": {
            "container": "string",
            "namespace": "string",
            "pod_name": "string"
            },
            "lambda": {
            "lambdaArn": "string",
            "lambdaName": "string"
            },
            "remedy": {
            "content": "string",
            "url": "string"
            },
            "snyk": {
            "apiEndpointUrl": "string",
            "appEndpointUrl": "string",
            "groupId": "string"
            },
            "sonatype": {
            "CVEId": "string",
            "applicationPublicId": "string",
            "componentNameVersion": "string",
            "iqServerUrl": "string"
            }
        },
        "flat_fields": [
            "string"
        ],
        "id": integer,
        "message": "string",
        "object": "string",
        "object_type": "string",
        "send_time": {
            "nanos": integer,
            "seconds": integer
        },
        "status": integer
        }
    ],
    "id": integer,
    "latest_event": {
        "FlatData": {
        "additionalProp1": "string",
        "additionalProp2": "string",
        "additionalProp3": "string"
        },
        "additional_data": "string",
        "data": {
        "additional_info": "string",
        "aws": {
            "accountArn": "string",
            "region": "string"
        },
        "azureSite": {
            "location": "string",
            "resourceGroup": "string",
            "siteId": "string",
            "siteKind": "string",
            "siteName": "string",
            "subscriptionId": "string"
        },
        "azureVm": {
            "id": "string",
            "region": "string",
            "resourceGroup": "string",
            "subscriptionId": "string",
            "vmName": "string"
        },
        "cloud_function": {
            "function_name": "string"
        },
        "crowdstrike_cloud_security": {
            "baseUrl": "string",
            "clientId": "string",
            "cloudProvider": "string",
            "iomID": "string",
            "policyId": integer,
            "resourceId": "string",
            "resourceType": "string"
        },
        "ec2": {
            "instance_id": "string",
            "instance_name": "string"
        },
        "ecs": {
            "clusterName": "string",
            "collectionMethod": integer,
            "resourceArn": "string",
            "resourceName": "string",
            "resourceType": "string"
        },
        "gcp": {
            "project": "string",
            "region": "string"
        },
        "host": {
            "address": "string"
        },
        "k8s": {
            "container": "string",
            "namespace": "string",
            "pod_name": "string"
        },
        "lambda": {
            "lambdaArn": "string",
            "lambdaName": "string"
        },
        "remedy": {
            "content": "string",
            "url": "string"
        },
        "snyk": {
            "apiEndpointUrl": "string",
            "appEndpointUrl": "string",
            "groupId": "string"
        },
        "sonatype": {
            "CVEId": "string",
            "applicationPublicId": "string",
            "componentNameVersion": "string",
            "iqServerUrl": "string"
        }
        },
        "flat_fields": [
        "string"
        ],
        "id": integer,
        "message": "string",
        "object": "string",
        "object_type": "string",
        "send_time": {
        "nanos": integer,
        "seconds": integer
        },
        "status": integer
    },
    "metadata": {
        "collected_objects": integer,
        "end_time": {
        "nanos": integer,
        "seconds": integer
        },
        "integration_task_id": integer,
        "integration_task_name": "string",
        "integration_task_type": {
        "category": "string",
        "display_name": "string",
        "enabled": boolean,
        "id": integer,
        "name": "string",
        "required_integration_types": [
            {
            "configured": boolean,
            "display_name": "string",
            "enabled": boolean,
            "id": integer,
            "name": "string"
            }
        ]
        },
        "start_time": {
        "nanos": integer,
        "seconds": integer
        },
        "total_objects": integer
    },
    "progress": integer,
    "scheduled": boolean,
    "trace_uuid": "string"
    },
    "name": "string",
    "next_run": {
    "nanos": integer,
    "seconds": integer
    },
    "progress": integer,
    "schedule": {
    "every": integer,
    "every_unit": integer,
    "hour": integer,
    "minute": integer,
    "startTimeTimezoneOffsetMinutes": integer,
    "start_time": {
        "nanos": integer,
        "seconds": integer
    },
    "timezone": integer,
    "weekdays": [
        integer
    ]
    },
    "schedule_every_unit_display_name": "string",
    "trigger": "string",
    "type": {
    "category": "string",
    "display_name": "string",
    "enabled": boolean,
    "id": integer,
    "name": "string",
    "required_integration_types": [
        {
        "configured": boolean,
        "display_name": "string",
        "enabled": boolean,
        "id": integer,
        "name": "string"
        }
    ]
    }
}

response = falcon.update_integration_task(access_token="string",
                                          task_id=integer,
                                          data="string",
                                          override=boolean,
                                          scheduled=boolean,
                                          id=integer,
                                          integration_task=task_dictionary
                                          )
print(response)
Service class example (Operation ID syntax)
from falconpy import ASPM

falcon = ASPM(client_id=CLIENT_ID,
              client_secret=CLIENT_SECRET
              )

task_dictionary = {
    "access_token": "string",
    "additional_header": "string",
    "business_application": "string",
    "data": "string",
    "enabled": boolean,
    "id": integer,
    "integration": {
    "data": "string",
    "enabled": boolean,
    "id": integer,
    "integration_type": {
        "configured": boolean,
        "display_name": "string",
        "enabled": boolean,
        "id": integer,
        "name": "string"
    },
    "name": "string",
    "node": {
        "additional_header": "string",
        "current_aws_arn": "string",
        "dashboard_url": "string",
        "id": integer,
        "last_health_check": integer,
        "name": "string",
        "node_type": "string",
        "password": "string",
        "pod_settings": {
        "imageAddress": "string",
        "imagePullSecrets": [
            "string"
        ],
        "podLabels": [
            {
            "key": "string",
            "value": "string"
            }
        ]
        },
        "proxy_address": "string",
        "type": "string",
        "useJobs": boolean,
        "username": "string"
    },
    "type": {
        "configured": boolean,
        "display_name": "string",
        "enabled": boolean,
        "id": integer,
        "name": "string"
    },
    "update_time": integer
    },
    "integration_task_type": {
    "category": "string",
    "display_name": "string",
    "enabled": boolean,
    "id": integer,
    "name": "string",
    "required_integration_types": [
        {
        "configured": boolean,
        "display_name": "string",
        "enabled": boolean,
        "id": integer,
        "name": "string"
        }
    ]
    },
    "latest_task_run": {
    "create_time": {
        "nanos": integer,
        "seconds": integer
    },
    "events": [
        {
        "FlatData": {
            "additionalProp1": "string",
            "additionalProp2": "string",
            "additionalProp3": "string"
        },
        "additional_data": "string",
        "data": {
            "additional_info": "string",
            "aws": {
            "accountArn": "string",
            "region": "string"
            },
            "azureSite": {
            "location": "string",
            "resourceGroup": "string",
            "siteId": "string",
            "siteKind": "string",
            "siteName": "string",
            "subscriptionId": "string"
            },
            "azureVm": {
            "id": "string",
            "region": "string",
            "resourceGroup": "string",
            "subscriptionId": "string",
            "vmName": "string"
            },
            "cloud_function": {
            "function_name": "string"
            },
            "crowdstrike_cloud_security": {
            "baseUrl": "string",
            "clientId": "string",
            "cloudProvider": "string",
            "iomID": "string",
            "policyId": integer,
            "resourceId": "string",
            "resourceType": "string"
            },
            "ec2": {
            "instance_id": "string",
            "instance_name": "string"
            },
            "ecs": {
            "clusterName": "string",
            "collectionMethod": integer,
            "resourceArn": "string",
            "resourceName": "string",
            "resourceType": "string"
            },
            "gcp": {
            "project": "string",
            "region": "string"
            },
            "host": {
            "address": "string"
            },
            "k8s": {
            "container": "string",
            "namespace": "string",
            "pod_name": "string"
            },
            "lambda": {
            "lambdaArn": "string",
            "lambdaName": "string"
            },
            "remedy": {
            "content": "string",
            "url": "string"
            },
            "snyk": {
            "apiEndpointUrl": "string",
            "appEndpointUrl": "string",
            "groupId": "string"
            },
            "sonatype": {
            "CVEId": "string",
            "applicationPublicId": "string",
            "componentNameVersion": "string",
            "iqServerUrl": "string"
            }
        },
        "flat_fields": [
            "string"
        ],
        "id": integer,
        "message": "string",
        "object": "string",
        "object_type": "string",
        "send_time": {
            "nanos": integer,
            "seconds": integer
        },
        "status": integer
        }
    ],
    "id": integer,
    "latest_event": {
        "FlatData": {
        "additionalProp1": "string",
        "additionalProp2": "string",
        "additionalProp3": "string"
        },
        "additional_data": "string",
        "data": {
        "additional_info": "string",
        "aws": {
            "accountArn": "string",
            "region": "string"
        },
        "azureSite": {
            "location": "string",
            "resourceGroup": "string",
            "siteId": "string",
            "siteKind": "string",
            "siteName": "string",
            "subscriptionId": "string"
        },
        "azureVm": {
            "id": "string",
            "region": "string",
            "resourceGroup": "string",
            "subscriptionId": "string",
            "vmName": "string"
        },
        "cloud_function": {
            "function_name": "string"
        },
        "crowdstrike_cloud_security": {
            "baseUrl": "string",
            "clientId": "string",
            "cloudProvider": "string",
            "iomID": "string",
            "policyId": integer,
            "resourceId": "string",
            "resourceType": "string"
        },
        "ec2": {
            "instance_id": "string",
            "instance_name": "string"
        },
        "ecs": {
            "clusterName": "string",
            "collectionMethod": integer,
            "resourceArn": "string",
            "resourceName": "string",
            "resourceType": "string"
        },
        "gcp": {
            "project": "string",
            "region": "string"
        },
        "host": {
            "address": "string"
        },
        "k8s": {
            "container": "string",
            "namespace": "string",
            "pod_name": "string"
        },
        "lambda": {
            "lambdaArn": "string",
            "lambdaName": "string"
        },
        "remedy": {
            "content": "string",
            "url": "string"
        },
        "snyk": {
            "apiEndpointUrl": "string",
            "appEndpointUrl": "string",
            "groupId": "string"
        },
        "sonatype": {
            "CVEId": "string",
            "applicationPublicId": "string",
            "componentNameVersion": "string",
            "iqServerUrl": "string"
        }
        },
        "flat_fields": [
        "string"
        ],
        "id": integer,
        "message": "string",
        "object": "string",
        "object_type": "string",
        "send_time": {
        "nanos": integer,
        "seconds": integer
        },
        "status": integer
    },
    "metadata": {
        "collected_objects": integer,
        "end_time": {
        "nanos": integer,
        "seconds": integer
        },
        "integration_task_id": integer,
        "integration_task_name": "string",
        "integration_task_type": {
        "category": "string",
        "display_name": "string",
        "enabled": boolean,
        "id": integer,
        "name": "string",
        "required_integration_types": [
            {
            "configured": boolean,
            "display_name": "string",
            "enabled": boolean,
            "id": integer,
            "name": "string"
            }
        ]
        },
        "start_time": {
        "nanos": integer,
        "seconds": integer
        },
        "total_objects": integer
    },
    "progress": integer,
    "scheduled": boolean,
    "trace_uuid": "string"
    },
    "name": "string",
    "next_run": {
    "nanos": integer,
    "seconds": integer
    },
    "progress": integer,
    "schedule": {
    "every": integer,
    "every_unit": integer,
    "hour": integer,
    "minute": integer,
    "startTimeTimezoneOffsetMinutes": integer,
    "start_time": {
        "nanos": integer,
        "seconds": integer
    },
    "timezone": integer,
    "weekdays": [
        integer
    ]
    },
    "schedule_every_unit_display_name": "string",
    "trigger": "string",
    "type": {
    "category": "string",
    "display_name": "string",
    "enabled": boolean,
    "id": integer,
    "name": "string",
    "required_integration_types": [
        {
        "configured": boolean,
        "display_name": "string",
        "enabled": boolean,
        "id": integer,
        "name": "string"
        }
    ]
    }
}

response = falcon.UpdateIntegrationTask(access_token="string",
                                        task_id=integer,
                                        data="string",
                                        override=boolean,
                                        scheduled=boolean,
                                        id=integer,
                                        integration_task=task_dictionary
                                        )
print(response)
Uber class example
from falconpy import APIHarnessV2

falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

body_payload = {
    "integration_task": {
        "access_token": "string",
        "additional_header": "string",
        "business_application": "string",
        "data": "string",
        "enabled": boolean,
        "id": integer,
        "integration": {
        "data": "string",
        "enabled": boolean,
        "id": integer,
        "integration_type": {
            "configured": boolean,
            "display_name": "string",
            "enabled": boolean,
            "id": integer,
            "name": "string"
        },
        "name": "string",
        "node": {
            "additional_header": "string",
            "current_aws_arn": "string",
            "dashboard_url": "string",
            "id": integer,
            "last_health_check": integer,
            "name": "string",
            "node_type": "string",
            "password": "string",
            "pod_settings": {
            "imageAddress": "string",
            "imagePullSecrets": [
                "string"
            ],
            "podLabels": [
                {
                "key": "string",
                "value": "string"
                }
            ]
            },
            "proxy_address": "string",
            "type": "string",
            "useJobs": boolean,
            "username": "string"
        },
        "type": {
            "configured": boolean,
            "display_name": "string",
            "enabled": boolean,
            "id": integer,
            "name": "string"
        },
        "update_time": integer
        },
        "integration_task_type": {
        "category": "string",
        "display_name": "string",
        "enabled": boolean,
        "id": integer,
        "name": "string",
        "required_integration_types": [
            {
            "configured": boolean,
            "display_name": "string",
            "enabled": boolean,
            "id": integer,
            "name": "string"
            }
        ]
        },
        "latest_task_run": {
        "create_time": {
            "nanos": integer,
            "seconds": integer
        },
        "events": [
            {
            "FlatData": {
                "additionalProp1": "string",
                "additionalProp2": "string",
                "additionalProp3": "string"
            },
            "additional_data": "string",
            "data": {
                "additional_info": "string",
                "aws": {
                "accountArn": "string",
                "region": "string"
                },
                "azureSite": {
                "location": "string",
                "resourceGroup": "string",
                "siteId": "string",
                "siteKind": "string",
                "siteName": "string",
                "subscriptionId": "string"
                },
                "azureVm": {
                "id": "string",
                "region": "string",
                "resourceGroup": "string",
                "subscriptionId": "string",
                "vmName": "string"
                },
                "cloud_function": {
                "function_name": "string"
                },
                "crowdstrike_cloud_security": {
                "baseUrl": "string",
                "clientId": "string",
                "cloudProvider": "string",
                "iomID": "string",
                "policyId": integer,
                "resourceId": "string",
                "resourceType": "string"
                },
                "ec2": {
                "instance_id": "string",
                "instance_name": "string"
                },
                "ecs": {
                "clusterName": "string",
                "collectionMethod": integer,
                "resourceArn": "string",
                "resourceName": "string",
                "resourceType": "string"
                },
                "gcp": {
                "project": "string",
                "region": "string"
                },
                "host": {
                "address": "string"
                },
                "k8s": {
                "container": "string",
                "namespace": "string",
                "pod_name": "string"
                },
                "lambda": {
                "lambdaArn": "string",
                "lambdaName": "string"
                },
                "remedy": {
                "content": "string",
                "url": "string"
                },
                "snyk": {
                "apiEndpointUrl": "string",
                "appEndpointUrl": "string",
                "groupId": "string"
                },
                "sonatype": {
                "CVEId": "string",
                "applicationPublicId": "string",
                "componentNameVersion": "string",
                "iqServerUrl": "string"
                }
            },
            "flat_fields": [
                "string"
            ],
            "id": integer,
            "message": "string",
            "object": "string",
            "object_type": "string",
            "send_time": {
                "nanos": integer,
                "seconds": integer
            },
            "status": integer
            }
        ],
        "id": integer,
        "latest_event": {
            "FlatData": {
            "additionalProp1": "string",
            "additionalProp2": "string",
            "additionalProp3": "string"
            },
            "additional_data": "string",
            "data": {
            "additional_info": "string",
            "aws": {
                "accountArn": "string",
                "region": "string"
            },
            "azureSite": {
                "location": "string",
                "resourceGroup": "string",
                "siteId": "string",
                "siteKind": "string",
                "siteName": "string",
                "subscriptionId": "string"
            },
            "azureVm": {
                "id": "string",
                "region": "string",
                "resourceGroup": "string",
                "subscriptionId": "string",
                "vmName": "string"
            },
            "cloud_function": {
                "function_name": "string"
            },
            "crowdstrike_cloud_security": {
                "baseUrl": "string",
                "clientId": "string",
                "cloudProvider": "string",
                "iomID": "string",
                "policyId": integer,
                "resourceId": "string",
                "resourceType": "string"
            },
            "ec2": {
                "instance_id": "string",
                "instance_name": "string"
            },
            "ecs": {
                "clusterName": "string",
                "collectionMethod": integer,
                "resourceArn": "string",
                "resourceName": "string",
                "resourceType": "string"
            },
            "gcp": {
                "project": "string",
                "region": "string"
            },
            "host": {
                "address": "string"
            },
            "k8s": {
                "container": "string",
                "namespace": "string",
                "pod_name": "string"
            },
            "lambda": {
                "lambdaArn": "string",
                "lambdaName": "string"
            },
            "remedy": {
                "content": "string",
                "url": "string"
            },
            "snyk": {
                "apiEndpointUrl": "string",
                "appEndpointUrl": "string",
                "groupId": "string"
            },
            "sonatype": {
                "CVEId": "string",
                "applicationPublicId": "string",
                "componentNameVersion": "string",
                "iqServerUrl": "string"
            }
            },
            "flat_fields": [
            "string"
            ],
            "id": integer,
            "message": "string",
            "object": "string",
            "object_type": "string",
            "send_time": {
            "nanos": integer,
            "seconds": integer
            },
            "status": integer
        },
        "metadata": {
            "collected_objects": integer,
            "end_time": {
            "nanos": integer,
            "seconds": integer
            },
            "integration_task_id": integer,
            "integration_task_name": "string",
            "integration_task_type": {
            "category": "string",
            "display_name": "string",
            "enabled": boolean,
            "id": integer,
            "name": "string",
            "required_integration_types": [
                {
                "configured": boolean,
                "display_name": "string",
                "enabled": boolean,
                "id": integer,
                "name": "string"
                }
            ]
            },
            "start_time": {
            "nanos": integer,
            "seconds": integer
            },
            "total_objects": integer
        },
        "progress": integer,
        "scheduled": boolean,
        "trace_uuid": "string"
        },
        "name": "string",
        "next_run": {
        "nanos": integer,
        "seconds": integer
        },
        "progress": integer,
        "schedule": {
        "every": integer,
        "every_unit": integer,
        "hour": integer,
        "minute": integer,
        "startTimeTimezoneOffsetMinutes": integer,
        "start_time": {
            "nanos": integer,
            "seconds": integer
        },
        "timezone": integer,
        "weekdays": [
            integer
        ]
        },
        "schedule_every_unit_display_name": "string",
        "trigger": "string",
        "type": {
        "category": "string",
        "display_name": "string",
        "enabled": boolean,
        "id": integer,
        "name": "string",
        "required_integration_types": [
            {
            "configured": boolean,
            "display_name": "string",
            "enabled": boolean,
            "id": integer,
            "name": "string"
            }
        ]
        }
    }
}

response = falcon.command("UpdateIntegrationTask", body=body_payload)
print(response)

DeleteIntegrationTask

Delete an existing integration task by its ID

PEP8 method name

delete_integration_task

Endpoint

MethodRoute
DELETE/aspm-api-gateway/api/v1/integration_tasks/{ID}

Required Scope

aspm-admin:write

Content-Type

  • Consumes: application/json
  • Produces: application/json

Keyword Arguments

NameServiceUberTypeData typeDescription
idService Class SupportUber Class SupportpathintegerExecutor node ID.

Usage

Service class example (PEP8 syntax)
from falconpy import ASPM

falcon = ASPM(client_id=CLIENT_ID,
              client_secret=CLIENT_SECRET
              )

response = falcon.delete_integration_task(id=integer)
print(response)
Service class example (Operation ID syntax)
from falconpy import ASPM

falcon = ASPM(client_id=CLIENT_ID,
              client_secret=CLIENT_SECRET
              )

response = falcon.DeleteIntegrationTask(id=integer)
print(response)
Uber class example
from falconpy import APIHarnessV2

falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

response = falcon.command("DeleteIntegrationTask", id=integer)
print(response)

RunIntegrationTask

Run an integration task by its ID

PEP8 method name

run_integration_task

Endpoint

MethodRoute
POST/aspm-api-gateway/api/v1/integration_tasks/{ID}/run

Required Scope

aspm-analyst:write

Content-Type

  • Consumes: application/json
  • Produces: application/json

Keyword Arguments

NameServiceUberTypeData typeDescription
access_tokenService Class SupportUber Class SupportbodystringAccess token.
task_idService Class SupportUber Class SupportbodyintegerTask ID.
dataService Class SupportUber Class SupportbodystringTask data content.
overrideService Class SupportUber Class SupportbodybooleanFlag indicating if this task should override other task values.
scheduledService Class SupportUber Class SupportbodybooleanFlag indicating if this task is scheduled.
idService Class SupportUber Class SupportpathdictionaryID of the integration task to execute.
categoryService Class SupportUber Class SupportquerystringIntegration task category.
bodyService Class SupportUber Class SupportbodydictionaryFull body payload in JSON format.
parametersService Class SupportUber Class SupportquerydictionaryFull query string parameters payload in JSON format.

Usage

Service class example (PEP8 syntax)
from falconpy import ASPM

falcon = ASPM(client_id=CLIENT_ID,
              client_secret=CLIENT_SECRET
              )

response = falcon.run_integration_task(access_token="string",
                                       task_id=integer,
                                       data="string",
                                       override=boolean,
                                       scheduled=boolean,
                                       id=integer,
                                       category="string"
                                       )
print(response)
Service class example (Operation ID syntax)
from falconpy import ASPM

falcon = ASPM(client_id=CLIENT_ID,
              client_secret=CLIENT_SECRET
              )

response = falcon.RunIntegrationTask(access_token="string",
                                     task_id=integer,
                                     data="string",
                                     override=boolean,
                                     scheduled=boolean,
                                     id=integer,
                                     category="string"
                                     )
print(response)
Uber class example
from falconpy import APIHarnessV2

falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

body_payload = {
  "access_token": "string",
  "category": "string",
  "data": "string",
  "override": boolean,
  "scheduled": boolean,
  "task_id": integer
}

response = falcon.command("RunIntegrationTask",
                          body=body_payload,
                          id=integer,
                          category="string"
                          )
print(response)

GetIntegrationTypes

Get all the integration types

PEP8 method name

get_integration_types

Endpoint

MethodRoute
GET/aspm-api-gateway/api/v1/integration_types

Required Scope

aspm-admin:read

Content-Type

  • Consumes: application/json
  • Produces: application/json

Keyword Arguments

No keywords or arguments accepted.

Usage

Service class example (PEP8 syntax)
from falconpy import ASPM

falcon = ASPM(client_id=CLIENT_ID,
              client_secret=CLIENT_SECRET
              )

response = falcon.get_integration_types()
print(response)
Service class example (Operation ID syntax)
from falconpy import ASPM

falcon = ASPM(client_id=CLIENT_ID,
              client_secret=CLIENT_SECRET
              )

response = falcon.GetIntegrationTypes()
print(response)
Uber class example
from falconpy import APIHarnessV2

falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

response = falcon.command("GetIntegrationTypes")
print(response)

GetIntegrations

Get a list of all the integrations

PEP8 method name

get_integrations

Endpoint

MethodRoute
GET/aspm-api-gateway/api/v1/integrations

Required Scope

aspm-read-only:read

Content-Type

  • Consumes: application/json
  • Produces: application/json

Keyword Arguments

NameServiceUberTypeData typeDescription
integration_typeService Class SupportUber Class SupportquerystringIntegration type.
categoryService Class SupportUber Class SupportquerystringIntegration category.
parametersService Class SupportUber Class SupportquerydictionaryFull query string parameters payload in JSON format.

Usage

Service class example (PEP8 syntax)
from falconpy import ASPM

falcon = ASPM(client_id=CLIENT_ID,
              client_secret=CLIENT_SECRET
              )

response = falcon.get_integrations(integration_type="string", category="string")
print(response)
Service class example (Operation ID syntax)
from falconpy import ASPM

falcon = ASPM(client_id=CLIENT_ID,
              client_secret=CLIENT_SECRET
              )

response = falcon.GetIntegrations(integration_type="string", category="string")
print(response)
Uber class example
from falconpy import APIHarnessV2

falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

response = falcon.command("GetIntegrations", integration_type="string", category="string")
print(response)

CreateIntegration

Create a new integration

PEP8 method name

create_integration

Endpoint

MethodRoute
POST/aspm-api-gateway/api/v1/integrations

Required Scope

aspm-admin:write

Content-Type

  • Consumes: application/json
  • Produces: application/json

Keyword Arguments

NameServiceUberTypeData typeDescription
bodyService Class SupportUber Class SupportbodydictionaryFull body payload in JSON format.
integrationService Class SupportUber Class SupportbodydictionaryIntegration details in JSON format.

Usage

Service class example (PEP8 syntax)
from falconpy import ASPM

falcon = ASPM(client_id=CLIENT_ID,
              client_secret=CLIENT_SECRET
              )

integration = {
    "data": "string",
    "enabled": boolean,
    "id": integer,
    "integration_type": {
        "configured": boolean,
        "display_name": "string",
        "enabled": boolean,
        "id": integer,
        "name": "string"
    },
    "name": "string",
    "node": {
        "additional_header": "string",
        "current_aws_arn": "string",
        "dashboard_url": "string",
        "id": integer,
        "last_health_check": integer,
        "name": "string",
        "node_type": "string",
        "password": "string",
        "pod_settings": {
            "imageAddress": "string",
            "imagePullSecrets": [
                "string"
            ],
            "podLabels": [
                {
                    "key": "string",
                    "value": "string"
                }
            ]
        },
        "proxy_address": "string",
        "type": "string",
        "useJobs": boolean,
        "username": "string"
    },
    "type": {
        "configured": boolean,
        "display_name": "string",
        "enabled": boolean,
        "id": integer,
        "name": "string"
    },
    "update_time": integer
}

response = falcon.create_integration(integration=integration)
print(response)
Service class example (Operation ID syntax)
from falconpy import ASPM


integration = {
    "data": "string",
    "enabled": boolean,
    "id": integer,
    "integration_type": {
        "configured": boolean,
        "display_name": "string",
        "enabled": boolean,
        "id": integer,
        "name": "string"
    },
    "name": "string",
    "node": {
        "additional_header": "string",
        "current_aws_arn": "string",
        "dashboard_url": "string",
        "id": integer,
        "last_health_check": integer,
        "name": "string",
        "node_type": "string",
        "password": "string",
        "pod_settings": {
            "imageAddress": "string",
            "imagePullSecrets": [
                "string"
            ],
            "podLabels": [
                {
                    "key": "string",
                    "value": "string"
                }
            ]
        },
        "proxy_address": "string",
        "type": "string",
        "useJobs": boolean,
        "username": "string"
    },
    "type": {
        "configured": boolean,
        "display_name": "string",
        "enabled": boolean,
        "id": integer,
        "name": "string"
    },
    "update_time": integer
}


falcon = ASPM(client_id=CLIENT_ID,
              client_secret=CLIENT_SECRET
              )

response = falcon.CreateIntegration(integration=integration)
print(response)
Uber class example
from falconpy import APIHarnessV2

falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

body_payload = {
    "integration": {
        "data": "string",
        "enabled": boolean,
        "id": integer,
        "integration_type": {
            "configured": boolean,
            "display_name": "string",
            "enabled": boolean,
            "id": integer,
            "name": "string"
        },
        "name": "string",
        "node": {
            "additional_header": "string",
            "current_aws_arn": "string",
            "dashboard_url": "string",
            "id": integer,
            "last_health_check": integer,
            "name": "string",
            "node_type": "string",
            "password": "string",
            "pod_settings": {
                "imageAddress": "string",
                "imagePullSecrets": [
                    "string"
                ],
                "podLabels": [
                    {
                        "key": "string",
                        "value": "string"
                    }
                ]
            },
            "proxy_address": "string",
            "type": "string",
            "useJobs": boolean,
            "username": "string"
        },
        "type": {
            "configured": boolean,
            "display_name": "string",
            "enabled": boolean,
            "id": integer,
            "name": "string"
        },
        "update_time": integer
    }
}

response = falcon.command("CreateIntegration", body=BODY)
print(response)

UpdateIntegration

Update an existing integration by its ID

PEP8 method name

update_integration

Endpoint

MethodRoute
PUT/aspm-api-gateway/api/v1/integrations/{ID}

Required Scope

aspm-admin:write

Content-Type

  • Consumes: application/json
  • Produces: application/json

Keyword Arguments

NameServiceUberTypeData typeDescription
parametersService Class SupportUber Class SupportqueryintegerIntegration ID to update.
bodyService Class SupportUber Class SupportbodydictionaryFull body payload in JSON format.
overwrite_fieldsService Class SupportUber Class Supportbodylist of stringsFields to be overwritten.
parametersService Class SupportUber Class SupportquerydictionaryFull query string parameters payload in JSON format.

Usage

Service class example (PEP8 syntax)
from falconpy import ASPM

falcon = ASPM(client_id=CLIENT_ID,
              client_secret=CLIENT_SECRET
              )

integration = {
    "data": "string",
    "enabled": boolean,
    "id": integer,
    "integration_type": {
        "configured": boolean,
        "display_name": "string",
        "enabled": boolean,
        "id": integer,
        "name": "string"
    },
    "name": "string",
    "node": {
        "additional_header": "string",
        "current_aws_arn": "string",
        "dashboard_url": "string",
        "id": integer,
        "last_health_check": integer,
        "name": "string",
        "node_type": "string",
        "password": "string",
        "pod_settings": {
            "imageAddress": "string",
            "imagePullSecrets": [
                "string"
            ],
            "podLabels": [
                {
                    "key": "string",
                    "value": "string"
                }
            ]
        },
        "proxy_address": "string",
        "type": "string",
        "useJobs": boolean,
        "username": "string"
    },
    "type": {
        "configured": boolean,
        "display_name": "string",
        "enabled": boolean,
        "id": integer,
        "name": "string"
    },
    "update_time": integer
}
overwrite = ["string"]

response = falcon.update_integration(id=integer,
                                     overwrite_fields=overwrite,
                                     integration=integration
                                     )
print(response)
Service class example (Operation ID syntax)
from falconpy import ASPM

falcon = ASPM(client_id=CLIENT_ID,
              client_secret=CLIENT_SECRET
              )

integration = {
    "data": "string",
    "enabled": boolean,
    "id": integer,
    "integration_type": {
        "configured": boolean,
        "display_name": "string",
        "enabled": boolean,
        "id": integer,
        "name": "string"
    },
    "name": "string",
    "node": {
        "additional_header": "string",
        "current_aws_arn": "string",
        "dashboard_url": "string",
        "id": integer,
        "last_health_check": integer,
        "name": "string",
        "node_type": "string",
        "password": "string",
        "pod_settings": {
            "imageAddress": "string",
            "imagePullSecrets": [
                "string"
            ],
            "podLabels": [
                {
                    "key": "string",
                    "value": "string"
                }
            ]
        },
        "proxy_address": "string",
        "type": "string",
        "useJobs": boolean,
        "username": "string"
    },
    "type": {
        "configured": boolean,
        "display_name": "string",
        "enabled": boolean,
        "id": integer,
        "name": "string"
    },
    "update_time": integer
}
overwrite = ["string"]

response = falcon.UpdateIntegration(id=integer,
                                    overwrite_fields=overwrite,
                                    integration=integration
                                    )
print(response)
Uber class example
from falconpy import APIHarnessV2

falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

body_payload = {
    "integration": {
        "data": "string",
        "enabled": boolean,
        "id": integer,
        "integration_type": {
            "configured": boolean,
            "display_name": "string",
            "enabled": boolean,
            "id": integer,
            "name": "string"
        },
        "name": "string",
        "node": {
            "additional_header": "string",
            "current_aws_arn": "string",
            "dashboard_url": "string",
            "id": integer,
            "last_health_check": integer,
            "name": "string",
            "node_type": "string",
            "password": "string",
            "pod_settings": {
                "imageAddress": "string",
                "imagePullSecrets": [
                    "string"
                ],
                "podLabels": [
                    {
                        "key": "string",
                        "value": "string"
                    }
                ]
            },
            "proxy_address": "string",
            "type": "string",
            "useJobs": boolean,
            "username": "string"
        },
        "type": {
            "configured": boolean,
            "display_name": "string",
            "enabled": boolean,
            "id": integer,
            "name": "string"
        },
        "update_time": integer
    },
    "overwriteFields": [
        "string"
    ]
}

response = falcon.command("UpdateIntegration", body=body_payload)
print(response)

DeleteIntegration

Delete an existing integration by its ID

PEP8 method name

delete_integration

Endpoint

MethodRoute
DELETE/aspm-api-gateway/api/v1/integrations/{ID}

Required Scope

aspm-admin:write

Content-Type

  • Consumes: application/json
  • Produces: application/json

Keyword Arguments

NameServiceUberTypeData typeDescription
idService Class SupportUber Class SupportpathintegerIntegration ID.

Usage

Service class example (PEP8 syntax)
from falconpy import ASPM

falcon = ASPM(client_id=CLIENT_ID,
              client_secret=CLIENT_SECRET
              )

response = falcon.delete_integration(id=integer)
print(response)
Service class example (Operation ID syntax)
from falconpy import ASPM

falcon = ASPM(client_id=CLIENT_ID,
              client_secret=CLIENT_SECRET
              )

response = falcon.DeleteIntegration(id=integer)
print(response)
Uber class example
from falconpy import APIHarnessV2

falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

response = falcon.command("DeleteIntegration", id=integer)
print(response)

ExecuteQuery

Execute a query. The syntax used is identical to that of the query page.

PEP8 method name

execute_query

Endpoint

MethodRoute
POST/aspm-api-gateway/api/v1/query

Required Scope

aspm-read-only:read

Content-Type

  • Consumes: application/json
  • Produces: application/json

Keyword Arguments

NameServiceUberTypeData typeDescription
bodyService Class SupportUber Class SupportbodydictionaryFull body payload in JSON format.
paginateService Class SupportUber Class SupportbodydictionaryPagination detail.
queryService Class SupportUber Class SupportbodystringQuery to execute.
select_fieldsService Class SupportUber Class SupportbodydictionaryField selection detail.
timestampService Class SupportUber Class SupportbodyintegerTimestamp.

Usage

Service class example (PEP8 syntax)
from falconpy import ASPM

falcon = ASPM(client_id=CLIENT_ID,
              client_secret=CLIENT_SECRET
              )

pagination = {
    "direction": "string",
    "limit": integer,
    "offset": integer,
    "orderBy": [
      "string"
    ]
}

selected = {
    "fields": [
      "string"
    ],
    "serviceFields": [
      "string"
    ],
    "withoutServices": boolean
}
response = falcon.execute_query(paginate=pagination,
                                query="string",
                                select_fields=selected,
                                timestamp=integer
                                )
print(response)
Service class example (Operation ID syntax)
from falconpy import ASPM

falcon = ASPM(client_id=CLIENT_ID,
              client_secret=CLIENT_SECRET
              )

pagination = {
    "direction": "string",
    "limit": integer,
    "offset": integer,
    "orderBy": [
      "string"
    ]
}

selected = {
    "fields": [
      "string"
    ],
    "serviceFields": [
      "string"
    ],
    "withoutServices": boolean
}

response = falcon.ExecuteQuery(paginate=pagination,
                               query="string",
                               select_fields=selected,
                               timestamp=integer
                               )
print(response)
Uber class example
from falconpy import APIHarnessV2

falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

body_payload = {
  "paginate": {
    "direction": "string",
    "limit": integer,
    "offset": integer,
    "orderBy": [
      "string"
    ]
  },
  "query": "string",
  "selectFields": {
    "fields": [
      "string"
    ],
    "serviceFields": [
      "string"
    ],
    "withoutServices": boolean
  },
  "timestamp": integer
}

response = falcon.command("ExecuteQuery", body=body_payload)
print(response)

ServiceNowGetDeployments

Retrieve ServiceNow deployments

PEP8 method name

get_servicenow_deployments

Endpoint

MethodRoute
GET/aspm-api-gateway/api/v1/servicenow/deployments

Required Scope

aspm-read-only:read

Content-Type

  • Consumes: application/json
  • Produces: application/json

Keyword Arguments

NameServiceUberTypeData typeDescription
ql_filtersService Class SupportUber Class SupportquerystringQuery filter.
limitService Class SupportUber Class SupportqueryintegerMaximum number of records to return.
offsetService Class SupportUber Class SupportqueryintegerStarting position of returned records.
order_byService Class SupportUber Class SupportquerystringSort field.
directionService Class SupportUber Class SupportquerystringSort direction.
parametersService Class SupportUber Class SupportquerydictionaryFull query string parameters payload in JSON format.

Usage

Service class example (PEP8 syntax)
from falconpy import ASPM

falcon = ASPM(client_id=CLIENT_ID,
              client_secret=CLIENT_SECRET
              )

response = falcon.get_servicenow_deployments(ql_filters="string",
                                             limit=integer,
                                             offset=integer,
                                             order_by="string",
                                             direction="string"
                                             )
print(response)
Service class example (Operation ID syntax)
from falconpy import ASPM

falcon = ASPM(client_id=CLIENT_ID,
              client_secret=CLIENT_SECRET
              )

response = falcon.ServiceNowGetDeployments(ql_filters="string",
                                           limit=integer,
                                           offset=integer,
                                           order_by="string",
                                           direction="string"
                                           )
print(response)
Uber class example
from falconpy import APIHarnessV2

falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

response = falcon.command("ServiceNowGetDeployments",
                          ql_filters="string",
                          limit=integer,
                          offset=integer,
                          order_by="string",
                          direction="string"
                          )
print(response)

ServiceNowGetServices

Retrieve ServiceNow services.

PEP8 method name

get_servicenow_services

Endpoint

MethodRoute
GET/aspm-api-gateway/api/v1/servicenow/services

Required Scope

aspm-read-only:read

Content-Type

  • Consumes: application/json
  • Produces: application/json

Keyword Arguments

NameServiceUberTypeData typeDescription
ql_filtersService Class SupportUber Class SupportquerystringQuery filter.
limitService Class SupportUber Class SupportqueryintegerMaximum number of records to return.
offsetService Class SupportUber Class SupportqueryintegerStarting position of returned records.
order_byService Class SupportUber Class SupportquerystringSort field.
directionService Class SupportUber Class SupportquerystringSort direction.
parametersService Class SupportUber Class SupportquerydictionaryFull query string parameters payload in JSON format.

Usage

Service class example (PEP8 syntax)
from falconpy import ASPM

falcon = ASPM(client_id=CLIENT_ID,
              client_secret=CLIENT_SECRET
              )

response = falcon.get_servicenow_services(ql_filters="string",
                                          limit=integer,
                                          offset=integer,
                                          order_by="string",
                                          direction="string"
                                          )
print(response)
Service class example (Operation ID syntax)
from falconpy import ASPM

falcon = ASPM(client_id=CLIENT_ID,
              client_secret=CLIENT_SECRET
              )

response = falcon.ServiceNowGetServices(ql_filters="string",
                                        limit=integer,
                                        offset=integer,
                                        order_by="string",
                                        direction="string"
                                        )
print(response)
Uber class example
from falconpy import APIHarnessV2

falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

response = falcon.command("ServiceNowGetServices",
                          ql_filters="string",
                          limit=integer,
                          offset=integer,
                          order_by="string",
                          direction="string"
                          )
print(response)

GetServicesCount

Get the total amount of existing services

PEP8 method name

get_services_count

Endpoint

MethodRoute
POST/aspm-api-gateway/api/v1/services/count

Required Scope

aspm-read-only:read

Content-Type

  • Consumes: application/json
  • Produces: application/json

Keyword Arguments

NameServiceUberTypeData typeDescription
bodyService Class SupportUber Class SupportbodydictionaryFull body payload in JSON format.
deployment_tuple_filtersService Class SupportUber Class Supportbodylist of dictionariesFilter excludes and includes.
nesting_levelService Class SupportUber Class SupportbodyintegerNesting level.
only_countService Class SupportUber Class SupportbodybooleanFlag indicating if result totals only should be returned.
optional_timeService Class SupportUber Class SupportbodyintegerOptional time.
paginationService Class SupportUber Class SupportbodydictionaryPagination.
persistent_signaturesService Class SupportUber Class Supportbodystring or list of stringsPersistent signatures.
ql_filtersService Class SupportUber Class SupportbodystringQuery filters.
related_entitiesService Class SupportUber Class Supportbodylist of dictionariesRelated entities.
revision_idService Class SupportUber Class SupportbodyintegerRevision ID.
roles_signaturesService Class SupportUber Class SupportbodystringRoles signature.

Usage

Service class example (PEP8 syntax)
from falconpy import ASPM

falcon = ASPM(client_id=CLIENT_ID,
              client_secret=CLIENT_SECRET
              )

dep_filters = [
    {
      "excludes": [
        {
          "key": "string",
          "value": "string"
        }
      ],
      "includes": [
        {
          "key": "string",
          "value": "string"
        }
      ]
    }
]

pagination = {
    "direction": "string",
    "limit": integer,
    "offset": integer,
    "order_by": [
        "string"
    ]
}
persistent = ["string"]
related = [
    {
        "aggregation_type": integer,
        "entity_type": integer,
        "filters": {
            "include_du_services": boolean,
            "only_du_types": boolean,
            "only_get_brokers": boolean
        },
        "groupByFields": {
            "fields": [
                "string"
            ]
        }
    }
]

response = falcon.get_services_count(deployment_tuple_filters=dep_filters,
                                     nesting_level=integer,
                                     only_count=boolean,
                                     optional_time=integer,
                                     pagination=pagination,
                                     persistent_signatures=persistent,
                                     ql_filters="string",
                                     related_entities=related,
                                     revision_id=integer,
                                     roles_signature="string"
                                     )
print(response)
Service class example (Operation ID syntax)
from falconpy import ASPM

falcon = ASPM(client_id=CLIENT_ID,
              client_secret=CLIENT_SECRET
              )

dep_filters = [
    {
      "excludes": [
        {
          "key": "string",
          "value": "string"
        }
      ],
      "includes": [
        {
          "key": "string",
          "value": "string"
        }
      ]
    }
]

pagination = {
    "direction": "string",
    "limit": integer,
    "offset": integer,
    "order_by": [
        "string"
    ]
}
persistent = ["string"]
related = [
    {
        "aggregation_type": integer,
        "entity_type": integer,
        "filters": {
            "include_du_services": boolean,
            "only_du_types": boolean,
            "only_get_brokers": boolean
        },
        "groupByFields": {
            "fields": [
                "string"
            ]
        }
    }
]
response = falcon.GetServicesCount(deployment_tuple_filters=dep_filters,
                                   nesting_level=integer,
                                   only_count=boolean,
                                   optional_time=integer,
                                   pagination=pagination,
                                   persistent_signatures=persistent,
                                   ql_filters="string",
                                   related_entities=related,
                                   revision_id=integer,
                                   roles_signature="string"
                                   )
print(response)
Uber class example
from falconpy import APIHarnessV2

falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

body_payload = {
  "deploymentTupleFilters": [
    {
      "excludes": [
        {
          "key": "string",
          "value": "string"
        }
      ],
      "includes": [
        {
          "key": "string",
          "value": "string"
        }
      ]
    }
  ],
  "nestingLevel": integer,
  "onlyCount": boolean,
  "optionalTime": integer,
  "pagination": {
    "direction": "string",
    "limit": integer,
    "offset": integer,
    "order_by": [
      "string"
    ]
  },
  "persistentSignatures": [
    "string"
  ],
  "qlFilters": "string",
  "relatedEntities": [
    {
      "aggregation_type": integer,
      "entity_type": integer,
      "filters": {
        "include_du_services": boolean,
        "only_du_types": boolean,
        "only_get_brokers": boolean
      },
      "groupByFields": {
        "fields": [
          "string"
        ]
      }
    }
  ],
  "revisionId": integer,
  "rolesSignature": "string"
}

response = falcon.command("GetServicesCount", body=body_payload)
print(response)

GetServiceViolationTypes

Get the different types of violation

PEP8 method name

get_service_violation_types

Endpoint

MethodRoute
GET/aspm-api-gateway/api/v1/services/violations/types

Required Scope

aspm-read-only:read

Content-Type

  • Consumes: application/json
  • Produces: application/json

Keyword Arguments

NameServiceUberTypeData typeDescription
bodyService Class SupportUber Class SupportbodydictionaryFull body payload in JSON format.
filterService Class SupportUber Class SupportbodydictionaryFilter to use for search.
optional_timeService Class SupportUber Class SupportbodyintegerOptional time.
revision_idService Class SupportUber Class SupportbodyintegerRevision ID.

Usage

Service class example (PEP8 syntax)
from falconpy import ASPM

falcon = ASPM(client_id=CLIENT_ID,
              client_secret=CLIENT_SECRET
              )

filter_dictionary = {
    "order_by": {
      "by_field": "string",
      "direction": integer
    },
    "paginate": {
      "direction": "string",
      "limit": integer,
      "offset": integer,
      "orderBy": [
        "string"
      ]
    }
}

response = falcon.get_service_violation_types(filter=filter_dictionary,
                                              optional_time=integer,
                                              revision_id=integer
                                              )
print(response)
Service class example (Operation ID syntax)
from falconpy import ASPM

falcon = ASPM(client_id=CLIENT_ID,
              client_secret=CLIENT_SECRET
              )

filter_dictionary = {
    "order_by": {
      "by_field": "string",
      "direction": integer
    },
    "paginate": {
      "direction": "string",
      "limit": integer,
      "offset": integer,
      "orderBy": [
        "string"
      ]
    }
}

response = falcon.GetServiceViolationTypes(filter=filter_dictionary,
                                           optional_time=integer,
                                           revision_id=integer
                                           )
print(response)
Uber class example
from falconpy import APIHarnessV2

falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

body_payload = {
  "filter": {
    "order_by": {
      "by_field": "string",
      "direction": integer
    },
    "paginate": {
      "direction": "string",
      "limit": integer,
      "offset": integer,
      "orderBy": [
        "string"
      ]
    }
  },
  "optionalTime": integer,
  "revisionId": integer
}

response = falcon.command("GetServiceViolationTypes", body=body_payload)
print(response)

GetTags

Get all the tags

PEP8 method name

get_tags

Endpoint

MethodRoute
GET/aspm-api-gateway/api/v1/tags

Required Scope

aspm-read-only:read

Content-Type

  • Consumes: application/json
  • Produces: application/json

Keyword Arguments

NameServiceUberTypeData typeDescription
is_uniqueService Class SupportUber Class SupportquerybooleanTag is unique.
limitService Class SupportUber Class SupportqueryintegerMaximum number of records to return.
offsetService Class SupportUber Class SupportqueryintegerStarting position of returned records.
tag_nameService Class SupportUber Class SupportquerystringTag name.
nameService Class SupportUber Class Supportquerystring or list_of_stringsName.
parametersService Class SupportUber Class SupportquerydictionaryFull query string parameters payload in JSON format.

Usage

Service class example (PEP8 syntax)
from falconpy import ASPM

falcon = ASPM(client_id=CLIENT_ID,
              client_secret=CLIENT_SECRET
              )

response = falcon.get_tags(is_uniquye=boolean,
                           limit=integer,
                           offset=integer,
                           tag_name="string",
                           name="string"
                           )
print(response)
Service class example (Operation ID syntax)
from falconpy import ASPM

falcon = ASPM(client_id=CLIENT_ID,
              client_secret=CLIENT_SECRET
              )

response = falcon.GetTags(is_uniquye=boolean,
                          limit=integer,
                          offset=integer,
                          tag_name="string",
                          name="string"
                          )
print(response)
Uber class example
from falconpy import APIHarnessV2

falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

response = falcon.command("GetTags", 
                          is_uniquye=boolean,
                          limit=integer,
                          offset=integer,
                          tag_name="string",
                          name="string"
                          )
print(response)

UpsertTags

Create new or update existing tag. You can update unique tags table or regular tags table

PEP8 method name

update_tags

Endpoint

MethodRoute
PUT/aspm-api-gateway/api/v1/tags

Required Scope

aspm-analyst:write

Content-Type

  • Consumes: application/json
  • Produces: application/json

Keyword Arguments

NameServiceUberTypeData typeDescription
bodyService Class SupportUber Class SupportbodydictionaryFull body payload in JSON format.
is_sensitiveService Class SupportUber Class SupportbodybooleanFlag indicating if the tag is sensitive.
persistent_signatureService Class SupportUber Class SupportbodystringTag persistent signature.
valueService Class SupportUber Class SupportbodystringTag value.
nameService Class SupportUber Class SupportbodystringTag name.

Usage

Service class example (PEP8 syntax)
from falconpy import ASPM

falcon = ASPM(client_id=CLIENT_ID,
              client_secret=CLIENT_SECRET
              )

response = falcon.update_tags(is_sensitive=boolean,
                              persistent_signature="string",
                              value="string",
                              name="string"
                              )
print(response)
Service class example (Operation ID syntax)
from falconpy import ASPM

falcon = ASPM(client_id=CLIENT_ID,
              client_secret=CLIENT_SECRET
              )

response = falcon.UpsertTags(is_sensitive=boolean,
                             persistent_signature="string",
                             value="string",
                             name="string"
                             )
print(response)
Uber class example
from falconpy import APIHarnessV2

falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

body_payload = {
  "entries": [
    {
      "isSensitive": boolean,
      "name": "string",
      "tag_type": "string",
      "value": "string"
    }
  ]
}

response = falcon.command("UpsertTags", body=body_payload)
print(response)

DeleteTags

Remove existing tags

PEP8 method name

delete_tags

Endpoint

MethodRoute
POST/aspm-api-gateway/api/v1/tags

Required Scope

aspm-analyst:write

Content-Type

  • Consumes: application/json
  • Produces: application/json

Keyword Arguments

NameServiceUberTypeData typeDescription
bodyService Class SupportUber Class SupportbodydictionaryFull body payload in JSON format.
is_sensitiveService Class SupportUber Class SupportbodybooleanFlag indicating if the tag is sensitive.
persistent_signatureService Class SupportUber Class SupportbodystringTag persistent signature.
valueService Class SupportUber Class SupportbodystringTag value.
nameService Class SupportUber Class SupportbodystringTag name.

Usage

Service class example (PEP8 syntax)
from falconpy import ASPM

falcon = ASPM(client_id=CLIENT_ID,
              client_secret=CLIENT_SECRET
              )

response = falcon.delete_tags(is_sensitive=boolean,
                              persistent_signature="string",
                              value="string",
                              name="string"
                              )
print(response)
Service class example (Operation ID syntax)
from falconpy import ASPM

falcon = ASPM(client_id=CLIENT_ID,
              client_secret=CLIENT_SECRET
              )

response = falcon.DeleteTags(is_sensitive=boolean,
                             persistent_signature="string",
                             value="string",
                             name="string"
                             )
print(response)
Uber class example
from falconpy import APIHarnessV2

falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

body_payload = {
  "entries": [
    {
      "isSensitive": boolean,
      "persistentSignature": "string",
      "value": "string"
    }
  ],
  "name": "string"
}

response = falcon.command("DeleteTags", body=body_payload)
print(response)