ASPM - CrowdStrike/falconpy GitHub Wiki

CrowdStrike Falcon CrowdStrike Subreddit

Using the ASPM service collection

Uber class support Service class support Documentation Version Page Updated

Table of Contents

Operation ID Description
UpsertBusinessApplications
PEP8 update_business_applications
Create or Update Business Applications
GetExecutorNodes
PEP8 get_executor_nodes
Get all the relay nodes
UpdateExecutorNode
PEP8 update_executor_node
Update an existing relay node
CreateExecutorNode
PEP8 create_executor_node
Create a new relay node
DeleteExecutorNode
PEP8 delete_node
Delete a relay node
GetIntegrationTasks
PEP8 get_integration_tasks
Get all the integration tasks
CreateIntegrationTask
PEP8 create_integration_task
Create new integration task.
UpdateIntegrationTask
PEP8 update_integration_task
Update an existing integration task by its ID
DeleteIntegrationTask
PEP8 delete_integration_task
Delete an existing integration task by its ID
RunIntegrationTask
PEP8 run_integration_task
Run an integration task by its ID
GetIntegrationTypes
PEP8 get_integration_types
Get all the integration types
GetIntegrations
PEP8 get_integrations
Get a list of all the integrations
CreateIntegration
PEP8 create_integration
Create a new integration
UpdateIntegration
PEP8 update_integration
Update an existing integration by its ID
DeleteIntegration
PEP8 delete_integration
Delete an existing integration by its ID
ExecuteQuery
PEP8 execute_query
Execute a query. The syntax used is identical to that of the query page.
ServiceNowGetDeployments
PEP8 get_servicenow_deployments
Retrieve ServiceNow deployments.
ServiceNowGetServices
PEP8 get_servicenow_services
Retrieve ServiceNow services.
GetServicesCount
PEP8 get_services_count
Get the total amount of existing services
GetServiceViolationTypes
PEP8 get_service_violation_types
Get the different types of violation
GetTags
PEP8 get_tags
Get all the tags
UpsertTags
PEP8 update_tags
Create new or update existing tag. You can update unique tags table or regular tags table
DeleteTags
PEP8 delete_tags
Remove existing tags

UpsertBusinessApplications

Create or Update Business Applications

PEP8 method name

update_business_applications

Endpoint

Method Route
PUT /aspm-api-gateway/api/v1/business_applications

Required Scope

aspm-analyst:write

Content-Type

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

Keyword Arguments

Name Service Uber Type Data type Description
body Service Class Support Uber Class Support body dictionary Full body payload in JSON format.
name Service Class Support Uber Class Support body string Application name.
persistent_signature Service Class Support Uber Class Support body string or list of strings Signature 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

Method Route
GET /aspm-api-gateway/api/v1/executor_nodes

Required Scope

aspm-admin:read

Content-Type

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

Keyword Arguments

Name Service Uber Type Data type Description
node_type Service Class Support Uber Class Support query string Relay node type.
integration_type Service Class Support Uber Class Support query string Integration type.
parameters Service Class Support Uber Class Support query dictionary Full 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

Method Route
PUT /aspm-api-gateway/api/v1/executor_nodes

Required Scope

aspm-admin:write

Content-Type

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

Keyword Arguments

Name Service Uber Type Data type Description
body Service Class Support Uber Class Support body dictionary Full body payload in JSON format.
additional_header Service Class Support Uber Class Support body string Additional headers.
current_aws_arn Service Class Support Uber Class Support body string AWS ARN.
dashboard_url Service Class Support Uber Class Support body string Dashboard URL address.
last_health_check Service Class Support Uber Class Support body integer Last health check.
name Service Class Support Uber Class Support body string Node name.
node_type Service Class Support Uber Class Support body string Node type.
password Service Class Support Uber Class Support body string Password.
pod_settings Service Class Support Uber Class Support body dictionary Pod settings.
proxy_address Service Class Support Uber Class Support body string Proxy server address.
type Service Class Support Uber Class Support body string Type.
use_jobs Service Class Support Uber Class Support body boolean Flag indicating if jobs should be used.
username Service Class Support Uber Class Support body string Username.

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

Method Route
POST /aspm-api-gateway/api/v1/executor_nodes

Required Scope

aspm-admin:write

Content-Type

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

Keyword Arguments

Name Service Uber Type Data type Description
body Service Class Support Uber Class Support body dictionary Full body payload in JSON format.
additional_header Service Class Support Uber Class Support body string Additional headers.
current_aws_arn Service Class Support Uber Class Support body string AWS ARN.
dashboard_url Service Class Support Uber Class Support body string Dashboard URL address.
id Service Class Support Uber Class Support body integer Node ID.
last_health_check Service Class Support Uber Class Support body integer Last health check.
name Service Class Support Uber Class Support body string Node name.
node_type Service Class Support Uber Class Support body string Node type.
password Service Class Support Uber Class Support body string Password.
pod_settings Service Class Support Uber Class Support body dictionary Pod settings.
proxy_address Service Class Support Uber Class Support body string Proxy server address.
type Service Class Support Uber Class Support body string Type.
use_jobs Service Class Support Uber Class Support body boolean Flag indicating if jobs should be used.
username Service Class Support Uber Class Support body string Username.

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

Method Route
DELETE /aspm-api-gateway/api/v1/executor_nodes/{ID}

Required Scope

aspm-admin:write

Content-Type

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

Keyword Arguments

Name Service Uber Type Data type Description
id Service Class Support Uber Class Support path integer Executor 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

Method Route
GET /aspm-api-gateway/api/v1/integration_tasks

Required Scope

aspm-read-only:read

Content-Type

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

Keyword Arguments

Name Service Uber Type Data type Description
integration_task_type Service Class Support Uber Class Support query string Integration task type.
category Service Class Support Uber Class Support query string Integration task category.
parameters Service Class Support Uber Class Support query dictionary Full 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

Method Route
POST /aspm-api-gateway/api/v1/integration_tasks

Required Scope

aspm-admin:write

Content-Type

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

Keyword Arguments

Name Service Uber Type Data type Description
body Service Class Support Uber Class Support body dictionary Full body payload in JSON format.
access_token Service Class Support Uber Class Support body string Access token.
task_id Service Class Support Uber Class Support body integer Task ID.
data Service Class Support Uber Class Support body string Task data content.
override Service Class Support Uber Class Support body boolean Flag indicating if this task should override other task values.
scheduled Service Class Support Uber Class Support body boolean Flag indicating if this task is scheduled.
id Service Class Support Uber Class Support path dictionary ID of the integration task to execute.
integration_task Service Class Support Uber Class Support query integration Full 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

Method Route
PUT /aspm-api-gateway/api/v1/integration_tasks/{ID}

Required Scope

aspm-admin:write

Content-Type

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

Keyword Arguments

Name Service Uber Type Data type Description
body Service Class Support Uber Class Support body dictionary Full body payload in JSON format.
access_token Service Class Support Uber Class Support body string Access token.
task_id Service Class Support Uber Class Support body integer Task ID.
data Service Class Support Uber Class Support body string Task data content.
override Service Class Support Uber Class Support body boolean Flag indicating if this task should override other task values.
scheduled Service Class Support Uber Class Support body boolean Flag indicating if this task is scheduled.
id Service Class Support Uber Class Support path dictionary ID of the integration task to execute.
integration_task Service Class Support Uber Class Support query integration Full 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

Method Route
DELETE /aspm-api-gateway/api/v1/integration_tasks/{ID}

Required Scope

aspm-admin:write

Content-Type

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

Keyword Arguments

Name Service Uber Type Data type Description
id Service Class Support Uber Class Support path integer Executor 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

Method Route
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

Name Service Uber Type Data type Description
access_token Service Class Support Uber Class Support body string Access token.
task_id Service Class Support Uber Class Support body integer Task ID.
data Service Class Support Uber Class Support body string Task data content.
override Service Class Support Uber Class Support body boolean Flag indicating if this task should override other task values.
scheduled Service Class Support Uber Class Support body boolean Flag indicating if this task is scheduled.
id Service Class Support Uber Class Support path dictionary ID of the integration task to execute.
category Service Class Support Uber Class Support query string Integration task category.
body Service Class Support Uber Class Support body dictionary Full body payload in JSON format.
parameters Service Class Support Uber Class Support query dictionary Full 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

Method Route
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

Method Route
GET /aspm-api-gateway/api/v1/integrations

Required Scope

aspm-read-only:read

Content-Type

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

Keyword Arguments

Name Service Uber Type Data type Description
integration_type Service Class Support Uber Class Support query string Integration type.
category Service Class Support Uber Class Support query string Integration category.
parameters Service Class Support Uber Class Support query dictionary Full 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

Method Route
POST /aspm-api-gateway/api/v1/integrations

Required Scope

aspm-admin:write

Content-Type

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

Keyword Arguments

Name Service Uber Type Data type Description
body Service Class Support Uber Class Support body dictionary Full body payload in JSON format.
integration Service Class Support Uber Class Support body dictionary Integration 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

Method Route
PUT /aspm-api-gateway/api/v1/integrations/{ID}

Required Scope

aspm-admin:write

Content-Type

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

Keyword Arguments

Name Service Uber Type Data type Description
parameters Service Class Support Uber Class Support query integer Integration ID to update.
body Service Class Support Uber Class Support body dictionary Full body payload in JSON format.
overwrite_fields Service Class Support Uber Class Support body list of strings Fields to be overwritten.
parameters Service Class Support Uber Class Support query dictionary Full 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

Method Route
DELETE /aspm-api-gateway/api/v1/integrations/{ID}

Required Scope

aspm-admin:write

Content-Type

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

Keyword Arguments

Name Service Uber Type Data type Description
id Service Class Support Uber Class Support path integer Integration 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

Method Route
POST /aspm-api-gateway/api/v1/query

Required Scope

aspm-read-only:read

Content-Type

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

Keyword Arguments

Name Service Uber Type Data type Description
body Service Class Support Uber Class Support body dictionary Full body payload in JSON format.
paginate Service Class Support Uber Class Support body dictionary Pagination detail.
query Service Class Support Uber Class Support body string Query to execute.
select_fields Service Class Support Uber Class Support body dictionary Field selection detail.
timestamp Service Class Support Uber Class Support body integer Timestamp.

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

Method Route
GET /aspm-api-gateway/api/v1/servicenow/deployments

Required Scope

aspm-read-only:read

Content-Type

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

Keyword Arguments

Name Service Uber Type Data type Description
ql_filters Service Class Support Uber Class Support query string Query filter.
limit Service Class Support Uber Class Support query integer Maximum number of records to return.
offset Service Class Support Uber Class Support query integer Starting position of returned records.
order_by Service Class Support Uber Class Support query string Sort field.
direction Service Class Support Uber Class Support query string Sort direction.
parameters Service Class Support Uber Class Support query dictionary Full 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

Method Route
GET /aspm-api-gateway/api/v1/servicenow/services

Required Scope

aspm-read-only:read

Content-Type

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

Keyword Arguments

Name Service Uber Type Data type Description
ql_filters Service Class Support Uber Class Support query string Query filter.
limit Service Class Support Uber Class Support query integer Maximum number of records to return.
offset Service Class Support Uber Class Support query integer Starting position of returned records.
order_by Service Class Support Uber Class Support query string Sort field.
direction Service Class Support Uber Class Support query string Sort direction.
parameters Service Class Support Uber Class Support query dictionary Full 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

Method Route
POST /aspm-api-gateway/api/v1/services/count

Required Scope

aspm-read-only:read

Content-Type

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

Keyword Arguments

Name Service Uber Type Data type Description
body Service Class Support Uber Class Support body dictionary Full body payload in JSON format.
deployment_tuple_filters Service Class Support Uber Class Support body list of dictionaries Filter excludes and includes.
nesting_level Service Class Support Uber Class Support body integer Nesting level.
only_count Service Class Support Uber Class Support body boolean Flag indicating if result totals only should be returned.
optional_time Service Class Support Uber Class Support body integer Optional time.
pagination Service Class Support Uber Class Support body dictionary Pagination.
persistent_signatures Service Class Support Uber Class Support body string or list of strings Persistent signatures.
ql_filters Service Class Support Uber Class Support body string Query filters.
related_entities Service Class Support Uber Class Support body list of dictionaries Related entities.
revision_id Service Class Support Uber Class Support body integer Revision ID.
roles_signatures Service Class Support Uber Class Support body string Roles 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

Method Route
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

Name Service Uber Type Data type Description
body Service Class Support Uber Class Support body dictionary Full body payload in JSON format.
filter Service Class Support Uber Class Support body dictionary Filter to use for search.
optional_time Service Class Support Uber Class Support body integer Optional time.
revision_id Service Class Support Uber Class Support body integer Revision 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

Method Route
GET /aspm-api-gateway/api/v1/tags

Required Scope

aspm-read-only:read

Content-Type

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

Keyword Arguments

Name Service Uber Type Data type Description
is_unique Service Class Support Uber Class Support query boolean Tag is unique.
limit Service Class Support Uber Class Support query integer Maximum number of records to return.
offset Service Class Support Uber Class Support query integer Starting position of returned records.
tag_name Service Class Support Uber Class Support query string Tag name.
name Service Class Support Uber Class Support query string or list_of_strings Name.
parameters Service Class Support Uber Class Support query dictionary Full 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

Method Route
PUT /aspm-api-gateway/api/v1/tags

Required Scope

aspm-analyst:write

Content-Type

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

Keyword Arguments

Name Service Uber Type Data type Description
body Service Class Support Uber Class Support body dictionary Full body payload in JSON format.
is_sensitive Service Class Support Uber Class Support body boolean Flag indicating if the tag is sensitive.
persistent_signature Service Class Support Uber Class Support body string Tag persistent signature.
value Service Class Support Uber Class Support body string Tag value.
name Service Class Support Uber Class Support body string Tag 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

Method Route
POST /aspm-api-gateway/api/v1/tags

Required Scope

aspm-analyst:write

Content-Type

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

Keyword Arguments

Name Service Uber Type Data type Description
body Service Class Support Uber Class Support body dictionary Full body payload in JSON format.
is_sensitive Service Class Support Uber Class Support body boolean Flag indicating if the tag is sensitive.
persistent_signature Service Class Support Uber Class Support body string Tag persistent signature.
value Service Class Support Uber Class Support body string Tag value.
name Service Class Support Uber Class Support body string Tag 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)
⚠️ **GitHub.com Fallback** ⚠️