notification: notifications handling

Notifications can be retrieved, expired or created with the notification commands.

add

Add and broadcast a new notification. Only admin profiles can add a notification.

It can be used for service announcement, such as planned maintenance.

To make an announcement to all profiles, use the -g, --is-global. Note that such global notification aren’t deleted when using expire command: you have either to use -e EXPIRE_AT, --expire-at EXPIRE_AT to set an expiration date, or to delete them manually with delete.

example

Add a global service announcement to indicate that the server will be shut down. The expiration date is set so that the notification will be expired after expected end of maintenance:

$ li notification add service "Server will be shut down for maintenance." -P HIGH -g -e "2023-10-22"

get

Retrieve notification for current profile. If -f, --follow argument is used, the CLI will continue to run and show any new incoming notification.

examples

Louise wishes to obtain her current notifications and display any new notifications as they are issued:

$ li notification get -f

Louise wants to see all her chat notifications which are at least of high priority (this includes urgent ones):

$ li notification get -t chat -P HIGH

delete

Delete a notification by its ID. The notification must belong to the profile doing the request.

If -g, --is-global is used, a global notification is to be deleted. Only admins can delete a global notification.

example

Louise (who is an admin) wants to delete a previous global service announcement with ID 123:

$ li notification delete -g 123

expire

Delete expired notification (the ones with an expiration date set).

If -l TIME_PATTERN, --limit TIME_PATTERN is used, also delete notification which have been created before the given limit. Some notifications can’t be deleted this way: if they are global, or if they require a user action. Using now as time pattern will clear all the notifications that can be deleted.

By default, only notifications of requesting profile are deleted (except for expired ones which are always deleted). If -a, --all is used, notification for all profiles can be deleted. This option is notably useful to schedule automatic notification cleaning.

example

Louise want to expire notification for all profiles that are older than 7 days:

$ li notification expire -a -l "7 days ago"