告警变更消息通知

接口功能

根据第三方系统 ID、第三方系统消息接收接口凭证 openID、第三方系统消息接收接口 URL 和订阅操作描述，订阅告警变更消息通知。告警变更消息包括新增告警、新增事件、告警确认/反确认、告警级别变更、告警清除。

URI路径

/rest/openapi/notification/common/alarm

访问方法

PUT

参数说明

FilterInfo需要上报告警的过滤条件包含以下字段，条件与条件之间是与的关系：

AlarmSourceInfo告警源相关信息对象包含以下字段，条件与条件之间是与的关系：

AlarmSourceInstance告警源加定位信息对象：

返回结果

注意事项

无。

调用示例

使用示例

package com.huawei.nms.openapi.demo.integrated;

import java.util.ArrayList;
import java.util.List;

import org.apache.http.HttpResponse;
import org.apache.http.message.BasicNameValuePair;

import com.huawei.nms.openapi.demo.global.GlobalVar;
import com.huawei.nms.openapi.demo.global.NewHttpsAccess;
import com.huawei.nms.openapi.demo.sm.Login;

public class SubscribeTrandtion {

	public static void main(String[] args) throws Exception {
		Login.login();
		put();
	}
	
	public static void put() throws Exception {
		//set the URL and method
        final String openidURL = "/rest/openapi/notification/common/alarm";
        final String method = "PUT";

        List<BasicNameValuePair> headers = new ArrayList<BasicNameValuePair>();
		headers.add(new BasicNameValuePair("openid", GlobalVar.globalOpenid));
		
        //set parameters
        final List<BasicNameValuePair> bodys = new ArrayList<BasicNameValuePair>();
        bodys.add(new BasicNameValuePair("systemID", "tradition"));
        bodys.add(new BasicNameValuePair("openID", "aa"));
        bodys.add(new BasicNameValuePair("url", "http://1.2.3.4:8080/alarm"));
        bodys.add(new BasicNameValuePair("dataType", "JSON"));
        bodys.add(new BasicNameValuePair("desc", "desc"));
		
        //send the request
        final HttpResponse response = NewHttpsAccess.access(GlobalVar.GLOBAL_IP,
                GlobalVar.GLOBAL_PORT,
                openidURL,
                method,
                headers,
                bodys);
        //get the result
        final String ret = NewHttpsAccess.getResult(response);
        System.out.println(ret);
	}
	
	public static void delete() throws Exception {
		//set the URL and method
        final String openidURL = "/rest/openapi/notification/common/alarm";
        final String method = "DELETE";

        List<BasicNameValuePair> headers = new ArrayList<BasicNameValuePair>();
		headers.add(new BasicNameValuePair("openid", GlobalVar.globalOpenid));
		
        //set parameters
        final List<BasicNameValuePair> parameters = new ArrayList<BasicNameValuePair>();
        parameters.add(new BasicNameValuePair("systemID", "tradition"));
		
        //send the request
        final HttpResponse response = NewHttpsAccess.access(GlobalVar.GLOBAL_IP,
                GlobalVar.GLOBAL_PORT,
                openidURL,
                method,
                headers,
                parameters);
        //get the result
        final String ret = NewHttpsAccess.getResult(response);
        System.out.println(ret);
	}

执行结果如下：

{
    "code": 0, 
    "data": null, 
    "description": "Operation success."
}

接口功能

根据第三方系统 ID退订操作描述，退订告警变更消息通知。

URI路径

/rest/openapi/notification/common/alarm

访问方法

DELETE

参数说明

返回结果

注意事项

MIME type 为 application/x-www-form-urlencoded 的请求中，空格将会编码为加号，加号则编码为%2B。

调用示例

使用示例

package com.huawei.nms.openapi.demo.integrated;

import java.util.ArrayList;
import java.util.List;

import org.apache.http.HttpResponse;
import org.apache.http.message.BasicNameValuePair;

import com.huawei.nms.openapi.demo.global.GlobalVar;
import com.huawei.nms.openapi.demo.global.NewHttpsAccess;
import com.huawei.nms.openapi.demo.sm.Login;

public class SubscribeTrandtion {

	public static void main(String[] args) throws Exception {
		Login.login();
	        delete();
	}

       public static void delete() throws Exception {
		//set the URL and method
        final String openidURL = "/rest/openapi/notification/common/alarm";
        final String method = "DELETE";

        List<BasicNameValuePair> headers = new ArrayList<BasicNameValuePair>();
		headers.add(new BasicNameValuePair("openid", GlobalVar.globalOpenid));
		
        //set parameters
        final List<BasicNameValuePair> parameters = new ArrayList<BasicNameValuePair>();
        parameters.add(new BasicNameValuePair("systemID", "tradition"));
		
        //send the request
        final HttpResponse response = NewHttpsAccess.access(GlobalVar.GLOBAL_IP,
                GlobalVar.GLOBAL_PORT,
                openidURL,
                method,
                headers,
                parameters);
        //get the result
        final String ret = NewHttpsAccess.getResult(response);
        System.out.println(ret);
	}

}

执行结果如下：

{
    "code": 0, 
    "data": null, 
    "description": "Operation success."
}

消息数据

data 包含以下字段：

字段细则

不同的告警通知中，data 字段填充内容不同。以下数据中打钩的为该类告警事件具备的数据，没打钩的字段使用默认值且无须读取。通过上文中 optType 决定是哪种告警事件：

解密示例

private static String decrypt(String data){
  String result = "";

  // 注：以下两个密钥串参考etc/oms.ros/ros.web.notification.xml自行添加，需要明文。
  String decryptedKey = "E5DF96DE53ED56CBAE25368624DC25Ef";
  String decryptedIv = "E2CDBCA5693654EF2E6F38693653564E";
  // 获取结果，KEY和IV值
  final byte[] key = strToBytes( decryptedKey.toUpperCase() );
  final byte[] iv = strToBytes( decryptedIv.toUpperCase() );
  try {
   // 获取key生成器
   KeyGenerator kgen = KeyGenerator.getInstance("AES", "SunJCE");

   SecureRandom secureRandom = SecureRandom.getInstance("SHA1PRNG", "SUN");
   secureRandom.setSeed( key );
   // 初始化
   kgen.init( 128, secureRandom );
   // 算法参数
   AlgorithmParameterSpec paramSpec = new IvParameterSpec(iv);
   // 生成加密key
   SecretKey secretKey = kgen.generateKey();
   // 加密器
   Cipher cipher = Cipher.getInstance("AES/CBC/PKCS5Padding", "SunJCE");
   // 初始化加密器
   cipher.init( Cipher.DECRYPT_MODE, secretKey, paramSpec);
   // 获取解密结果
   byte[] res = cipher.doFinal(strToBytes(data));
   try {
    result = new String( res,"UTF-8" );
   } catch (UnsupportedEncodingException e) {
    // TODO Auto-generated catch block
    e.printStackTrace();
   }
  } catch( final GeneralSecurityException e ) {
   e.printStackTrace();
   result = null;
  }
  return result;
 }

 public static byte[] strToBytes(final String str)
    {
        // 参数校验
        if (null == str || str.isEmpty() || !str.matches("[0-9a-zA-Z]{1,}"))
        {
            return null;
        }

        // 转换成大写
        final String upperCaseString = str.toUpperCase(Locale.US);

        // 字符串长度
        final int strLen = upperCaseString.length();

        // 被加密数组
        final byte[] bytes = new byte[16];

        // 循环计算加密值
        for (int i = 0; i < (strLen / 2); i++)
        {
            // 高低位
            int high = charToHex(upperCaseString.charAt(i * 2));
            int low = charToHex(upperCaseString.charAt(i * 2 + 1));
            // 获得结果
            bytes[i] = (byte) ((high << 4) | low);
        }

        return bytes;
    }

通知示例

新增告警：

{
    "timestamp":"2014-12-19 17:31:24",
    "extendedData":{},
    "resourceURI":"/rest/openapi/notification/common/alarm",
    "description":"Alarm related notification.",
    "data":
    [
        {
            "proposedRepairActions":"null",
            "additionalText":"null",
            "eventType":-1,
            "neDN":"NE=34603111",
            "moName":"E200E-F-64",
            "perceivedSeverity":2,
            "moDN":"NE=34603111",
            "clearUser":"",
            "commentUser":"",
            "neName":"E200E-F-64",
            "alarmName":"BGP状态下降",
            "alarmId":1100840,
            "ackUser":"",
            "optType":1,
            "cleared":false,
            "commentTime":0,
            "alarmSN":146,
            "probableCause":51569,
            "neType":"{Huawei}Eudemon200E-X5",
            "objectInstance":"null",
            "systemID":"HuaweiPlatform",
            "additionalInformation":"null",
            "acked":false,
            "eventTime":1418981484000,
            "clearedType":0,
            "arrivedTime":1418981484465,
            "clearedTime":0,
            "ackTime":0,
            "comments":"",
            "devCsn":0,
            "alarmEvent":"Alarms"
        }
    ],
    "msgType":1
}

确认告警：

{
    "timestamp":"2014-12-19 17:33:14",
    "extendedData":{},
    "resourceURI":"/rest/openapi/notification/common/alarm",
    "description":"Alarm related notification.",
    "data":
    [
        {
            "proposedRepairActions":"",
            "additionalText":"",
            "eventType":-1,
            "neDN":"NE=34603111",
            "moName":"E200E-F-64",
            "perceivedSeverity":2,
            "moDN":"NE=34603111",
            "clearUser":"",
            "commentUser":"",
            "neName":"E200E-F-64",
            "alarmName":"",
            "alarmId":1100840,
            "ackUser":"admin",
            "optType":3,
            "cleared":false,
            "commentTime":0,
            "alarmSN":146,
            "probableCause":51569,
            "neType":"{Huawei}Eudemon200E-X5",
            "objectInstance":"null",
            "systemID":"HuaweiPlatform",
            "additionalInformation":"",
            "acked":true,
            "eventTime":1418981593000,
            "clearedType":0,
            "arrivedTime":1418981484465,
            "clearedTime":0,
            "ackTime":1418981593000,
            "comments":"",
            "devCsn":0,
            "alarmEvent":"Alarms"
        }
    ],
    "msgType":3
}

清除告警：

{
    "timestamp":"2014-12-19 16:25:11",
    "extendedData":{},
    "resourceURI":"/rest/openapi/notification/common/alarm",
    "description":"Alarm related notification.",
    "data":
    [
        {
            "proposedRepairActions":"",
            "additionalText":"",
            "eventType":-1,
            "neDN":"NE=34603109",
            "moName":"E200E-F-64",
            "perceivedSeverity":5,
            "moDN":"NE=34603109",
            "clearUser":"System User",
            "commentUser":"",
            "neName":"E200E-F-64",
            "alarmName":"光纤连接错误告警",
            "alarmId":2100095,
            "ackUser":"",
            "optType":2,
            "cleared":true,
            "commentTime":0,
            "alarmSN":122,
            "probableCause":50225,
            "neType":"{Huawei}Eudemon200E-X5",
            "objectInstance":"",
            "systemID":"HuaweiPlatform",
            "additionalInformation":"null",
            "acked":true,
            "eventTime":1418977509000,
            "clearedType":1,
            "arrivedTime":1418977313529,
            "clearedTime":1418977509000,
            "ackTime":0,
            "comments":"",
            "devCsn":0,
            "alarmEvent":"Alarms"
        }
    ],
    "msgType":2
}