Files
tacker/api-ref/source/v2/fault_notification.inc
Yuta Kazato bb16f78280 Update docs of User guide and API reference
This patch provides the following User guide and
API documentation updates (fixes) in Tacker Antelope.

User doc:
* Update current support v2 API
  operation status in the cli doc.
* Fix the settings of "vimConnectionInfo".
* Add vimType "ETSINFV.KUBERNETES.V_1"
  to the samples of "vimConnectionInfo".

API doc:
* Fix the misdescription of VNF LCM Interface v2.
* Fix the misdescription of VNF FM Interface v1.
* Fix the misdescription of VNF PM Interface v2.
* Fix the format of request parameters
  in Prometheus Plugin Interface
  and Fault Notification Interface.

Implements: blueprint enhance-change-package
Implements: blueprint support-auto-lcm
Co-Author: Taiki Kimura <taiki.kimura@ntt-at.co.jp>
Change-Id: I50c130d5de812efac631ed8ad1432a98a9d00e6c
2023-02-28 10:55:25 +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