Oracle Cloud Infrastructure Documentation

Batch Events

Oracle Cloud Infrastructure Events allows the development teams to automatically respond when a resource changes its state. Batch resources emit the following events.

See Getting Started with Events.

Batch Event Types

Friendly Name Event Type
Batch Job - Lifecycle State Change 
com.oraclecloud.batch.updatebatchjobstate
Batch Task - Lifecycle State Change 
com.oraclecloud.batch.updatebatchjobtaskstate

Batch Job: Lifecycle State Change

Example events:

{
  {
  "eventType": "com.oraclecloud.batch.updatebatchjobstate",
  "cloudEventsVersion": "0.1",
  "eventTypeVersion": "2.0",
  "source": "batchjob",
  "eventID": "unique_ID",
  "eventTime": "2025-03-27T15:59:44.695Z",
  "contentType": "application/json",
  "data": {
    "compartmentId": "ocid1.compartment.oc1..unique_ID",
    "compartmentName": "Batch Job Customer Compartment1",
    "resourceName": "batchJob1",
    "resourceId": "ocid1.batchjob.ash.oc1..unique_ID",
    "definedTags": {
      "Oracle-Tags": {
        "CreatedBy": "creating entity",
        "CreatedOn": "2023-08-03T13:07:23.110Z",
        "StudioPriority": "LOW"
      }
    },
    "freeFormTags": {
      "tagKey2": "updatedTagValue2",
      "updatedTagKey3": "updatedTagValue3"
    },
    "additionalDetails": {
      "lifecycleState": "WAITING",
      "lifecycleDetails": "Paused",
      "progress": 50,
      "progressDetails": "half way",
      "batchContextId": "unique_ID",
      "batchJobPoolId": "unique_ID"
    }
  },
  "extensions": {
    "compartmentId": "ocid1.compartment.oc1..unique_ID"
  }
}

Batch Task - Lifecycle State Change

Example events:

{
  "eventType": "com.oraclecloud.batch.updatebatchjobtaskstate",
  "cloudEventsVersion": "0.1",
  "eventTypeVersion": "2.0",
  "source": "batchtask",
  "eventID": "unique_ID",
  "eventTime": "2025-03-27T15:59:44.695Z",
  "contentType": "application/json",
  "data": {
    "compartmentId": "ocid1.compartment.oc1..unique_ID",
    "compartmentName": "Batch Job Customer Compartment1",
    "resourceName": "Batch job 1",
    "resourceId": "ocid1.batchjob.ash.oc1..unique_ID",
    "definedTags": {
      "Oracle-Tags": {
        "CreatedBy": "creating entity",
        "CreatedOn": "2023-08-03T13:07:23.110Z"
      }
    },
    "freeformTags": {
      "tagKey2": "updatedTagValue2",
      "updatedTagKey3": "updatedTagValue3"
    },
    "additionalDetails": {
      "taskName": "Task 1",
      "taskLifecycleState": "IN_PROGRESS",
      "taskLifecycleDetails": "",
      "batchContextId": "unique_ID",
      "batchJobPoolId": "unique_ID"
    }
  },
  "extensions": {
    "compartmentId": "ocid1.compartment.oc1..unique_ID"
  }
}