故障通知接口

显示全部

故障通知接口

此接口用于通知 VIM 检测到的故障事件。当 VIM 中发生故障事件时，VIM 通过此接口向 Tacker 通知故障事件。Tacker 根据故障事件执行自动修复。

POST

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

通知故障事件

详情

当 VIM 中发生故障事件时，通知 Tacker。

此接口可以在短时间内被多次触发。为了防止对单个 VNF 调用多次修复操作，此接口的多次请求将在配置的时间段内进行打包 (CONF.server_notification.timer_interval)。

响应代码

成功

代码	原因
204 - No Content	服务器已通过删除资源来满足请求。

错误

代码	原因
400 - 请求错误	请求中的某些内容无效。
404 - Not Found	故障通知 API 未启用。（CONF.server_notification.server_notification）

请求参数

名称	入参	类型	描述
vnfInstanceId	路径	字符串	与此通知相关的 Vnf 实例标识符。
server_id	路径	字符串	虚拟机的标识符。
notification	body	结构	故障通知事件。
host_id (可选)	body	标识符	物理服务器 ID。此项为预留功能，目前将被忽略。
alarm_id	body	标识符	用于标识告警的 ID。
fault_id	body	字符串	目标故障 ID。
fault_type	body	字符串	故障类型。“10”：物理服务器故障，“11”：物理服务器 OUS，“20”：VM 状态不一致，“21”：VM 重启检测。
fault_option (可选)	body	KeyValuePairs	有关此故障事件的附加信息。

请求示例

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