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.

POST

/server_notification/vnf_instances/{vnfInstanceId}/servers/{server_id}/notify

Notify a fault event

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¶

Success¶

Code	Reason
`204 - No Content`	The server has fulfilled the request by deleting the resource.

Error¶

Code	Reason
`400 - Bad Request`	Some content in the request was invalid.
`404 - Not Found`	The fault notification API is not enabled. (CONF.server_notification.server_notification)

Request Parameters¶

Name	In	Type	Description
vnfInstanceId	path	string	Identifier of Vnf instance related to this notification.
server_id	path	string	Identifier of the virtual machine.
notification	body	Structure	Fault notification event.
host_id (Optional)	body	Identifier	Physical server ID. This is for future use and ignored for now.
alarm_id	body	Identifier	ID to identify alarm.
fault_id	body	String	Target fault ID.
fault_type	body	String	Fault type. “10”: Physical server fault, “11”: Physical server OUS, “20”: Inconsistency of VM status, “21”: VM reboot detection.
fault_option (Optional)	body	KeyValuePairs	Optional information about this fault event.

Request Example¶

{
    "notification": {
        "host_id": "host1",
        "alarm_id": "e8e97eaf-ba85-4b92-aeb9-f2b2c712ca4f",
        "fault_id": "1234",
        "fault_type": "10",
        "fault_option": {
            "message": "Server is down."
        }
    }
}

Fault Notification Interface

Fault Notification Interface¶