OCI Events for OS Management Hub
Certain OS Management Hub resources emit information used by the OCI Events service.
OS Management Hub resources that emit event information include:
- Events
- Lifecycle environments
- Managed instances
- Managed instance groups
- Scheduled jobs
- Software sources
You can create automation based on state changes of resources by using event types, rules, and actions. You can define rules that trigger a specific action when an event occurs. For more information, see Overview of Events and Get Started with Events. For information about managing rules for events, see Managing Rules for Events.
Event Resource Event Types
These are the event types that OS Management Hub event resource emits. The OS Management Hub event resource is distinct and separate from an OCI event. However, each OS Management Hub event emits an event that can be tracked using the OCI Events service. See What's the difference between OS Management Hub Events and OCI Events?.
| Friendly Name | Event Type |
|---|---|
| Change Event Compartment |
|
| Create Agent List Packages Event |
|
| Create Sync Agent Config Event |
|
| Create Agent Upload Content Event |
|
| Create Exploit Attempt Event |
|
| Create Kernel Crash Event |
|
| Create Kernel Oops Event |
|
| Create Update Ksplice Kernel Event |
|
| Create Update Ksplice Userspace Event |
|
| Create Set Management Station Config Event |
|
| Create Set Management Station Healthy State Event |
|
| Create Set Management Station Unavailable State Event |
|
| Create Set Management Station Unhealthy State Event |
|
| Create Sync Management Station Config Event |
|
| Create Update Management Station Config Event |
|
| Create Reboot Failed Event |
|
| Create Reboot Started Event |
|
| Create Reboot Succeeded Event |
|
| Create Reboot Succeeded After Timeout Event |
|
| Create Software Source Event |
|
| Disable Module Streams Event |
|
| Create Enable Module Streams Event |
|
| Create Install Module Profiles Event |
|
| Create Lifecycle Promotion Event |
|
| Create Remove Module Profile Event |
|
| Create Set Software Source Event |
|
| Create Switch Module Stream Event |
|
| Create Update Software Source Event |
|
| Create Install Packages Event |
|
| Create Remove Packages Event |
|
| Create Update All Packages Event |
|
| Create Update Bugfix Event |
|
| Create Update Enhancement Event |
|
| Create Update Other Event |
|
| Create Update Packages Event |
|
| Create Update Security Event |
|
| Create Sysadmin Failed Event |
|
| Create Sysadmin Succeeded Event |
|
| Delete Event |
|
| Update Event |
|
Event Example
This is a reference event for an OS Management Hub event:
{
"eventType": "com.oraclecloud.osmh.createevent.reboot.rebootsucceeded",
"cloudEventsVersion": "0.1",
"eventTypeVersion": "2.0",
"source": "osmh",
"eventTime": "2024-11-20T23:30:38.051Z",
"contentType": "application/json",
"data": {
"compartmentId": "ocid1.compartment.oc1..<unique_ID>",
"compartmentName": "example_compartment",
"resourceName": "My test resource",
"resourceId": "ocid1.example_regional_resource.oc1.iad.<unique_ID>",
"availabilityDomain": "<availability_domain>"
},
"eventID": "<unique_ID>",
"extensions": {
"compartmentId": "ocid1.compartment.oc1..<unique_ID>"
}
}Lifecycle Environment Event Types
These are the event types that the lifecycle environment resource emits:
| Friendly Name | Event Type |
|---|---|
| Attach Managed Instances To Lifecycle Stage |
|
| Create Lifecycle Environment |
|
| Delete Lifecycle Environment |
|
| Detach Managed Instances From Lifecycle Stage |
|
| Promote Software Source To Lifecycle Stage |
|
| Update Lifecycle Environment |
|
Lifecycle Environment Example
This is a reference event for a lifecycle environment:
{
"eventType": "com.oraclecloud.osmh.attachmanagedinstancestolifecyclestage",
"cloudEventsVersion": "0.1",
"eventTypeVersion": "2.0",
"source": "osmhprod-lifecycle-environment",
"eventTime": "2024-01-08T22:04:53Z",
"contentType": "application/json",
"data": {
"eventName": "AttachManagedInstancesToLifecycleStage",
"compartmentId": "ocid1.compartment.oc1..<unique_ID>",
"compartmentName": "example_compartment",
"resourceName": "My test resource",
"resourceId": "ocid1.example_regional_resource.oc1.iad.<unique_ID>",
"availabilityDomain": "<availability_domain>"
},
"eventID": "<unique_ID>",
"extensions": {
"compartmentId": "ocid1.compartment.oc1..<unique_ID>",
}
}Managed Instance Event Types
These are the event types that the managed instance resource emits:
| Friendly Name | Event Type |
|---|---|
| Attach Profile to Managed Instance |
|
| Attach Software Sources to Managed Instance |
|
| Delete Managed Instance |
|
| Disable Module Stream On Managed Instance |
|
| Enable Module Stream On Managed Instance |
|
| Install All Windows Updates On Managed Instances In Compartment |
|
| Install Module Stream Profile On Managed Instance |
|
| Install Packages On Managed Instance |
|
| Install Windows Updates On Managed Instance |
|
| Manage Module Streams On Managed Instance |
|
| Refresh Software On Managed Instance |
|
| Remove Module Stream Profile From Managed Instance |
|
| Remove Packages From Managed Instance |
|
| Switch Module Stream On Managed Instance |
|
| Update All Packages On Managed Instances In Compartment |
|
| Update Managed Instance |
|
| Update Packages On Managed Instance |
|
Managed Instance Example
This is a reference event for a managed instance:
{
"eventType": "com.oraclecloud.osmh.installpackagesonmanagedinstance",
"cloudEventsVersion": "0.1",
"eventTypeVersion": "2.0",
"source": "osmhprod-managed-instance",
"eventTime": "2024-01-08T17:13:55Z",
"contentType": "application/json",
"data": {
"eventName": "InstallPackagesOnManagedInstance",
"compartmentId": "ocid1.compartment.oc1..<unique_ID>",
"compartmentName": "example_compartment",
"resourceName": "My test resource",
"resourceId": "ocid1.example_regional_resource.oc1.iad.<unique_ID>",
"availabilityDomain": "<availability_domain>"
},
"eventID": "<unique_ID>",
"extensions": {
"compartmentId": "ocid1.compartment.oc1..<unique_ID>"
}
}
Managed Instance Group Event Types
These are the event types that the managed instance group resource emits:
| Friendly Name | Event Type |
|---|---|
| Attach Managed Instances to Managed Instance Group |
|
| Attach Software Sources to Managed Instance Group |
|
| Change Managed Instance Group Compartment |
|
| Create Managed Instance Group |
|
| Detach Managed Instances From Managed Instance Group |
|
| Detach Software Sources From Managed Instance Group |
|
| Disable Module Stream On Managed Instance Group |
|
| Enable Module Stream On Managed Instance Group |
|
| Install Module Stream Profile On Managed Instance Group |
|
| Install Packages On Managed Instance Group |
|
| Remove Module Stream Profile From Managed Instance Group |
|
| Remove Packages From Managed Instance Group |
|
| Update All Packages On Managed Instance Group |
|
| Update Managed Instance Group |
|
Managed Instance Group Example
This is a reference event for a managed instance group:
{
"eventType": "com.oraclecloud.osmh.attachmanagedinstancetomanagedinstancegroup",
"cloudEventsVersion": "0.1",
"eventTypeVersion": "2.0",
"source": "osmhprod-managed-instance-group",
"eventTime": "2024-01-11T17:02:13Z",
"contentType": "application/json",
"data": {
"eventName": "AttachManagedInstanceToManagedInstanceGroup",
"compartmentId": "ocid1.compartment.oc1..<unique_ID>",
"compartmentName": "example_compartment",
"resourceName": "My test resource",
"resourceId": "ocid1.example_regional_resource.oc1.iad.<unique_ID>",
"availabilityDomain": "<availability_domain>"
},
"eventID": "<unique_ID>",
"extensions": {
"compartmentId": "ocid1.compartment.oc1..<unique_ID>"
}
}Scheduled Job Event Types
These are the event types that the scheduled job resource emits:
| Friendly Name | Event Type |
|---|---|
| Change Scheduled Job Compartment |
|
| Create Scheduled Job |
|
| Delete Scheduled Job |
|
| Run Scheduled Job Now |
|
| Update Scheduled Job |
|
Scheduled Job Example
This is a reference event for a scheduled job:
{
"eventType": "com.oraclecloud.osmh.updatescheduledjob",
"cloudEventsVersion": "0.1",
"eventTypeVersion": "2.0",
"source": "osmhprod-scheduled-job",
"eventTime": "2024-01-09T18:33:49Z",
"contentType": "application/json",
"data": {
"eventName": "UpdateScheduledJob",
"compartmentId": "ocid1.compartment.oc1..<unique_ID>",
"compartmentName": "example_compartment",
"resourceName": "My test resource",
"resourceId": "ocid1.example_regional_resource.oc1.iad.<unique_ID>",
"availabilityDomain": "<availability_domain>"
},
"eventID": "<unique_ID>",
"extensions": {
"compartmentId": "ocid1.compartment.oc1..<unique_ID>"
}
}Software Source Event Types
These are the event types that the software source resource emits:
| Friendly Name | Event Type |
|---|---|
| Add Packages To Software Source |
|
| Change Availability Of Software Sources |
|
| Change Software Source Compartment |
|
| Create Software Source |
|
| Delete Software Source |
|
| Update Software Source |
|
Software Source Example
This is a reference event for a software source:
{
"eventType": "com.oraclecloud.osmh.addpackagestosoftwaresource",
"cloudEventsVersion": "0.1",
"eventTypeVersion": "2.0",
"source": "osmhprod-software-source",
"eventTime": "2024-01-09T17:33:56Z",
"contentType": "application/json",
"data": {
"eventName": "AddPackagesToSoftwareSource",
"compartmentId": "ocid1.compartment.oc1..<unique_ID>",
"compartmentName": "example_compartment",
"resourceName": "My test resource",
"resourceId": "ocid1.example_regional_resource.oc1.iad.<unique_ID>",
"availabilityDomain": "<availability_domain>"
},
"eventID": "<unique_ID>",
"extensions": {
"compartmentId": "ocid1.compartment.oc1..<unique_ID>"
}
}