v1

latestOpenAPI 3.1.0Elastic 2.02026-07-179371211.2 KB

Jobs

Get Job

Retrieves a specific job that matches the given job ID.

get/connect/job/{jobId}

Path parameters

jobIdinteger required

The job ID

Response

The retrieved Job object

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"
}