Fault Notification Interface

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."
        }
    }
}