tacker/api-ref/source/v2/fault_notification.inc
Koji Shimizu 72e361bb18 Add docs for faultnotification auto heal
This patch makes the following updates to the API and CLI docs.

* Add support faultnotification auto heal

Implements: blueprint support-autoheal-queue
Change-Id: I2fcb3c54ef3cca4e79bf701daebf1286a36f730c
2022-09-08 14:51:48 +09:00

54 lines
1.3 KiB
ReStructuredText

.. -*- rst -*-
============================
Fault Notification Interface
============================
This interface is used for notifying fault events that is detected by VIM.
When fault events occur in VIM, VIM notifies fault event to Tacker via
the interface. Tacker performs autohealing according to the fault event.
Notify a fault event
====================
.. rest_method:: POST /server_notification/vnf_instances/{vnfInstanceId}/servers/{server_id}/notify
Notifies Tacker when a fault event occur in VIM.
This interface can be alerted by multiple times in a short period.
To prevent invoking multiple heal operations to single VNF,
the multiple requests by this interface are packed for
a configured period of time (CONF.server_notification.timer_interval).
Response Codes
--------------
.. rest_status_code:: success status.yaml
- 204
.. rest_status_code:: error status.yaml
- 400
- 404: fault_notification
Request Parameters
------------------
.. rest_parameters:: parameters_fault_notification.yaml
- vnfInstanceId: vnf_instance_id
- server_id: server_id
- notification: notification
- \>host_id: host_id
- \>alarm_id: alarm_id
- \>fault_id: fault_id
- \>fault_type: fault_type
- \>fault_option: fault_option
Request Example
---------------
.. literalinclude:: samples/fault_notification/notify.json
:language: javascript