gns3-server/docs/notifications.rst
2018-03-12 13:38:50 +07:00

180 lines
3.0 KiB
ReStructuredText

Notifications
=============
Notifications can be received from the controller, they can be used to update your local data.
Notification endpoints
**********************
Listen to the HTTP stream endpoint or to the Websocket endpoint.
* :doc:`api/v2/controller/project/projectsprojectidnotifications`
* :doc:`api/v2/controller/project/projectsprojectidnotificationsws`
It is recommended to use the Websocket endpoint.
Available notifications
***********************
.. contents::
:local:
ping
----
Keep-alive between client and controller. Also used to receive the current CPU and memory usage.
.. literalinclude:: api/notifications/ping.json
compute.created
----------------
A compute has been created.
.. literalinclude:: api/notifications/compute.created.json
compute.updated
----------------
A compute has been updated.
.. literalinclude:: api/notifications/compute.updated.json
compute.deleted
---------------
A compute has been deleted.
.. literalinclude:: api/notifications/compute.deleted.json
node.created
------------
A node has been created.
.. literalinclude:: api/notifications/node.created.json
node.updated
------------
A node has been updated.
.. literalinclude:: api/notifications/node.updated.json
node.deleted
------------
A node has been deleted.
.. literalinclude:: api/notifications/node.deleted.json
link.created
------------
A link has been created. Note that a link is not connected
to any node when it is created.
.. literalinclude:: api/notifications/link.created.json
link.updated
------------
A link has been updated.
.. literalinclude:: api/notifications/link.updated.json
link.deleted
------------
A link has been deleted.
.. literalinclude:: api/notifications/link.deleted.json
drawing.created
---------------
A drawing has been created.
.. literalinclude:: api/notifications/drawing.created.json
drawing.updated
---------------
A drawing has been updated. The svg field is only included if it
has changed in order to reduce data transfer.
.. literalinclude:: api/notifications/drawing.updated.json
drawing.deleted
---------------
A drawing has been deleted.
.. literalinclude:: api/notifications/drawing.deleted.json
project.updated
---------------
A project has been updated.
.. literalinclude:: api/notifications/project.updated.json
project.closed
---------------
A project has been closed.
.. literalinclude:: api/notifications/project.closed.json
snapshot.restored
--------------------------
A snapshot has been restored
.. literalinclude:: api/notifications/project.snapshot_restored.json
log.error
---------
Sends an error
.. literalinclude:: api/notifications/log.error.json
log.warning
------------
Sends a warning
.. literalinclude:: api/notifications/log.warning.json
log.info
---------
Sends an information
.. literalinclude:: api/notifications/log.info.json
settings.updated
-----------------
GUI settings have been updated. Will be removed in a later release.
.. literalinclude:: api/notifications/settings.updated.json