Monty Taylor f44ed7ab35
Update python-openstacksdk references to openstacksdk
Now that the repo is renamed, update all of the references.
While we're at it, remote unused translation config.

Change-Id: Ib9f80eb809317483f83f79952470c2b57b2bb7c6
2018-03-23 12:31:24 -05:00

2.7 KiB

Managing Receivers

Receivers are the event sinks associated to senlin clusters. When certain events (or alarms) are seen by a monitoring software, the software can notify the senlin clusters of those events (or alarms). When senlin receives those notifications, it can automatically trigger some predefined operations with preset parameter values.

List Receivers

To examine the list of receivers:

../../examples/clustering/receiver.py

When listing receivers, you can specify the sorting option using the sort parameter and you can do pagination using the limit and marker parameters.

Full example: manage receiver

Create Receiver

When creating a receiver, you will provide a dictionary with keys and values according to the receiver type referenced.

../../examples/clustering/receiver.py

Optionally, you can specify a metadata keyword argument that contains some key-value pairs to be associated with the receiver.

Full example: manage receiver

Get Receiver

To get a receiver based on its name or ID:

../../examples/clustering/receiver.py

Full example: manage receiver

Find Receiver

To find a receiver based on its name or ID:

../../examples/clustering/receiver.py

Full example: manage receiver

Update Receiver

After a receiver is created, most of its properties are immutable. Still, you can update a receiver's name and/or params.

../../examples/clustering/receiver.py

Full example: manage receiver

Delete Receiver

A receiver can be deleted after creation, provided that it is not referenced by any active clusters. If you attempt to delete a receiver that is still in use, you will get an error message.

../../examples/clustering/receiver.py