Merge "API microversion 2.76: Add 'power-update' external event"

api-ref/source/os-server-external-events.inc

@@ -7,11 +7,11 @@
 .. warning::
    This is an ``admin`` level service API only designed to be used by
    other OpenStack services. The point of this API is to coordinate
-   between Nova and Neutron, Nova and Cinder (and potentially future
-   services) on activities they both need to be involved in,
+   between Nova and Neutron, Nova and Cinder, Nova and Ironic (and potentially
+   future services) on activities they both need to be involved in,
    such as network hotplugging.
 
-   Unless you are writing Neutron or Cinder code you **should not**
+   Unless you are writing Neutron, Cinder or Ironic code you **should not**
    be using this API.
 
 Creates one or more external events. The API dispatches each event to a

api-ref/source/parameters.yaml

@@ -2587,9 +2587,15 @@ event_hostId:
   type: string
 event_name:
   description: |
-    The event name. A valid value is ``network-changed``, ``network-vif-plugged``,
-    ``network-vif-unplugged``, ``network-vif-deleted``, or ``volume-extended``.
-    The event name ``volume-extended`` is added since microversion ``2.51``.
+    The event name. A valid value is:
+
+    - ``network-changed``
+    - ``network-vif-plugged``
+    - ``network-vif-unplugged``
+    - ``network-vif-deleted``
+    - ``volume-extended`` (since microversion ``2.51``)
+    - ``power-update`` (since microversion ``2.76``)
+
   in: body
   required: true
   type: string
@@ -2623,7 +2629,13 @@ event_status:
   type: string
 event_tag:
   description: |
-    A string value that identifies the event.
+    A string value that identifies the event. Certain types of events require
+    specific tags:
+
+    - For the ``power-update`` event the tag must be either be ``POWER_ON``
+      or ``POWER_OFF``.
+    - For the ``volume-extended`` event the tag must be the volume id.
+
   in: body
   required: false
   type: string