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