# Events
This article lists the model lifecycle events fired by EasyDCIM (saving, saved, updating, updated, deleting, deleted, creating, created). It explains when each event is dispatched and shows how extension code can listen to them to react to data changes inside the platform.
# System events
EasyDCIM models call several events, allowing you to hook into various points in the model's lifecycle using the following methods: saving, saved, updating, updated, deleting, deleted. Whenever a new item is saved for the first time, the creating and created events will start. If an item is not new and the save method is called, the updating / updated events will be started. In both cases, the saving / saved events will be called.
The last part of the event name is the model name, for example device, itemPort or user. Not every model fires every lifecycle event. The lists below show the events that are fired for each model.
Example:
\Event::listen('easydcim.saving: device', function($model) {
$model->label = 'Custom Device Label';
});
The basic events fired by the system are the following:
# Devices
- easydcim.saving: device
- easydcim.saved: device
- easydcim.creating: device
- easydcim.updating: device
- easydcim.deleting: device
- easydcim.deleted: device
- easydcim.device: boot (power on device)
- easydcim.device: reboot (reboot device)
- easydcim.device: shutdown (power off device)
- easydcim.device: boot.success (device powered on successfully)
- easydcim.device: reboot.success (device rebooted successfully)
- easydcim.device: shutdown.success (device powered off successfully)
Servers, colocations, colocation devices and parts fire the same lifecycle events under their own model names: server, colocation, colocationDevice and part, for example easydcim.saved: server.
# Items
- easydcim.saving: item
- easydcim.saved: item
- easydcim.creating: item
- easydcim.updating: item
- easydcim.deleting: item
- easydcim.deleted: item
# Item models
- easydcim.saved: itemModel
- easydcim.creating: itemModel
- easydcim.updating: itemModel
# Monitors
- easydcim.saving: monitor
- easydcim.saved: monitor
- easydcim.creating: monitor
- easydcim.updating: monitor
- easydcim.deleting: monitor
# Item ports
- easydcim.saving: itemPort
- easydcim.saved: itemPort
- easydcim.creating: itemPort
- easydcim.created: itemPort
- easydcim.updating: itemPort
- easydcim.updated: itemPort
- easydcim.deleted: itemPort
# Item power ports
- easydcim.saving: itemPowerPort
- easydcim.saved: itemPowerPort
- easydcim.creating: itemPowerPort
- easydcim.created: itemPowerPort
- easydcim.updating: itemPowerPort
- easydcim.updated: itemPowerPort
- easydcim.deleting: itemPowerPort
- easydcim.deleted: itemPowerPort
# Item sensors
- easydcim.saving: itemSensor
- easydcim.saved: itemSensor
- easydcim.creating: itemSensor
- easydcim.created: itemSensor
- easydcim.updating: itemSensor
- easydcim.updated: itemSensor
- easydcim.deleting: itemSensor
- easydcim.deleted: itemSensor
# Item types
- easydcim.saving: itemType
- easydcim.saved: itemType
- easydcim.creating: itemType
- easydcim.updating: itemType
# Item type fields
- easydcim.saving: itemTypeField
- easydcim.saved: itemTypeField
- easydcim.creating: itemTypeField
- easydcim.updating: itemTypeField
# Locations
- easydcim.saving: location
- easydcim.saved: location
- easydcim.creating: location
- easydcim.updating: location
- easydcim.deleting: location
# Racks
- easydcim.saving: rack
- easydcim.saved: rack
- easydcim.creating: rack
- easydcim.updating: rack
- easydcim.deleting: rack
# Floors
- easydcim.saving: floor
- easydcim.saved: floor
- easydcim.creating: floor
- easydcim.updating: floor
# Notifications
- easydcim.saving: notificationStream
- easydcim.saved: notificationStream
- easydcim.creating: notificationStream
- easydcim.updating: notificationStream
- easydcim.deleting: notificationStream
# Orders
- easydcim.saving: order
- easydcim.saved: order
- easydcim.creating: order
- easydcim.deleting: order
# Services
The service events below receive the related order as the parameter.
- easydcim.service.before: activate
- easydcim.service.after: activate
- easydcim.service.before: suspend
- easydcim.service.after: suspend
- easydcim.service.before: unsuspend
- easydcim.service.after: unsuspend
- easydcim.service.before: terminate
- easydcim.service.after: terminate
# Service access levels
- easydcim.saving: serviceAccessLevel
- easydcim.saved: serviceAccessLevel
- easydcim.creating: serviceAccessLevel
- easydcim.created: serviceAccessLevel
- easydcim.updating: serviceAccessLevel
- easydcim.deleting: serviceAccessLevel
- easydcim.deleted: serviceAccessLevel
# Users
- easydcim.saving: user
- easydcim.saved: user
- easydcim.creating: user
- easydcim.updating: user
- easydcim.deleting: user
- easydcim.deleted: user
# Companies
- easydcim.saving: company
- easydcim.saved: company
- easydcim.creating: company
- easydcim.created: company
- easydcim.updating: company
- easydcim.updated: company
- easydcim.deleting: company
- easydcim.deleted: company