v1

latestOpenAPI 3.1.0Elastic 2.02026-07-179371211.2 KB

Jobs

Get Jobs

Retrieves the list of jobs that match the given parameters.

get/connect/jobs/

Query parameters

kindstring required

The job kind, such as 'analyze'. Specify an empty value for PCAP jobs

parameters[artifact][id]string

Optional case ID to locate matching analyze jobs

Response

The array of retrieved jobs

completeTimestring

The date and time when the job was completed

createTimestring

The date and time when the job was created

failCountinteger

The number of times the job was processed but failed

failTimestring

The date and time when the job last failed and was marked incomplete

failurestring

The failure reason

fileExtensionstring

The file extension for any attached job result/output data

idinteger

The unique Job ID

kindstring

The kind of job that this object represents; blank values represent pcap jobs

nodeIdstring

The unique node ID that is responsible for completing this job

ownerstring

Owner field [not actively used by the API]

sensorIdstring

Legacy sensor ID field

sizeinteger

The size of the job stream output, if a stream output was attached

statusinteger

The current state of the job. 0 = pending, 1 = complete, 2 = incomplete, 3 = deleted

userIdstring

The unique user ID that created this job

Example response

[
  {
    "completeTime": "2024-10-07T12:15:09.12424556Z",
    "createTime": "2024-10-07T06:45:49.52456415Z",
    "failTime": "0001-01-01T00:00:00Z",
    "fileExtension": "bin",
    "filter": {
      "beginTime": "2024-12-03T00:25:09.899Z",
      "dstIp": "1.2.3.4",
      "dstPort": 80,
      "endTime": "2024-12-03T00:29:09.899Z",
      "importId": "bd77c8bc7498c795cc6608c5d45bd51b",
      "protocol": "tcp",
      "srcIp": "44.2.12.63",
      "srcPort": 55312
    },
    "id": 1004,
    "kind": "analyze",
    "nodeId": "sensor-001",
    "results": [
      {
        "id": "malwarebazaar",
        "summary": "no result"
      }
    ],
    "size": 3781,
    "status": 1,
    "userId": "39314a6b-0b79-4210-1233-4e3fbcd7bfec"
  }
]