summaryrefslogtreecommitdiff
path: root/doc/source/admin/notifications.rst
blob: 0a9f12151f9db2612c357a89324eb4601ff386f2 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
.. _notifications:

Notifications
=============

.. HINT::

    In this context, "notifications" are not related to the DNS NOTIFY message.


Notifications are RPC calls that contain a JSON object.
Designate both generates and receives notifications.

The purpose of notifications in to inform unrelated OpenStack components
of events in real time and trigger actions.

Emitters
--------

They are emitted by Central on the following events:

* dns.tld.create
* dns.tld.update
* dns.tld.delete
* dns.tsigkey.create
* dns.tsigkey.update
* dns.tsigkey.delete
* dns.domain.create
* dns.zone.create
* dns.domain.update
* dns.zone.update
* dns.domain.delete
* dns.zone.delete
* dns.zone.touch
* dns.recordset.create
* dns.recordset.update
* dns.recordset.delete
* dns.record.create
* dns.record.update
* dns.record.delete
* dns.blacklist.create
* dns.blacklist.update
* dns.blacklist.delete
* dns.pool.create
* dns.pool.update
* dns.pool.delete
* dns.domain.update
* dns.zone.update
* dns.zone_transfer_request.create
* dns.zone_transfer_request.update
* dns.zone_transfer_request.delete
* dns.zone_transfer_accept.create
* dns.zone_transfer_accept.update
* dns.zone_transfer_accept.delete
* dns.zone_import.create
* dns.zone_import.update
* dns.zone_import.delete
* dns.zone_export.create
* dns.zone_export.update
* dns.zone_export.delete
* dns.zone.share
* dns.zone.unshare

Receivers
---------

Notification from other OpenStack component outside of Designate are
received by :ref:`designate-sink`.

Format
------

An example notification from Neutron:

.. literalinclude:: ../../../designate/tests/resources/sample_notifications/neutron/port.delete.start.json

More examples can be found at
:file:`designate/tests/resources/sample_notifications`