功能明细 > Web客户端 > WebAPI > S_BI_HD

● 接口说明:

当前版本：0.1

接口描述：统计计算接口

接口服务ID：S_BI_HD_09

请求服务名：BIHD09

请求方法：calculateTagValues

● 请求参数示例

HTTP请求：[POST] /service/S_BI_HD_09

HTTP请求体如下：

{

"clientId": "4436611986732923",

"secret": "45384AE8472330A8C0843EE969296BEA",

"dsName": "test217",

"tags": [

{

"tagName": "hdsys_cpu_0",

"statsType":0,

"timeRegions":[

{

"startTime": "2024-06-18T0:00:00.000",

"endTime": "2024-06-18T16:01:00.000"

}

]

}

]

}

请求参数含义解析:

名称

类型

是否必需

描述

clientId

String

是

客户端id

secret

String

是

密钥

dsName

String

是

数据源名称

calculateEx

Boolean

否

是否调用扩展接口，如未传入该参数或传入值为false，则调用统计计算常规接口，如传入该参数且值为true，则调用统计计算扩展接口

tags

List<Map>

是

点表

详解如下：
常规接口：

key	含义	类型	是否必需	描述
tagName	点名	String	是
statsType	统计类型	int	是	统计类型 0：最大值 1：最小值 2：求和 5：算术平均值
timeRegions	时间范围	List<Map<String, String>>	是	时间范围， startTime为起始时间，格式为"YYYY-MM-ddThh:mm:ss.SSS"， endTime为结束时间，格式为"YYYY-MM-ddThh:mm:ss.SSS"

扩展接口：

key	含义	类型	是否必需	描述
tagName	点名	String	是
statsType	统计类型	int	是	统计类型 0：最大值 1：最小值 2：求和 3：最新值 4：可信度 5：算术平均值 6：时间加权平均值 7：积分 8：值变化 9：区间变化,从<=到>= 10：区间变化，从>=到<= 11：差值统计 12：值在区间 13：值不在区间 14：极差 15：标准差 16：大于某个值的时间 17：大于等于某个值的时间 18：等于某个值的时间 19：不等于某个值的时间 20：小于某个值的时间 21：小于等于某个值的时间 22：在某个值区间的时间 23：不在某个值区间的时间
timeRegions	时间范围	List<Map<String, String>>	是	统计区间数组，其中， startTime为起始时间，格式为"YYYY-MM-ddThh:mm:ss.SSS"， endTime为结束时间，格式为"YYYY-MM-ddThh:mm:ss.SSS"，
percentGood	信任度	float	否	Good的数据个数百分比大于或等于该比例时认为计算出的结果是可信的，取值范围为0-100
sampleType	统计类型	float	否	0：原始点 1：线性插值 2：前向插值
filterExpr	数据过滤表达式	String	否	数据过滤表达式
filterFailMode	过滤失败时对采样数据的处理	int	否	0为过滤采样数据，1为不过滤采样数据
extParam1	第一个参数	float	否	计数和计时的参数, 值变化的参数，区间变化的第一个参数，在区间不在区间的第一个参数
extParam2	第二个参数	float	否	计数和计时的参数，区间变化的第二个参数，在区间不在区间的第二个参数
offset	偏移量	int	否	采样模式为插值时，插值点为startTime+nOffset,startTime+nOffset+nPeriod, 单位为秒
period	插值间隔	int	否	采样模式为插值时，插值点的间隔为nPeriod, 单位为秒
useBadValue	bad值是否参与统计	int	否	1表示bad值参与统计，0表示不参与

● java调用示例

EiInfo inInfo = new EiInfo();

List<Map> tagList = new ArrayList<>();

Map<String, Object> map = new HashMap<>();

map.put("tagName", "hdsys_cpu_0");

map.put("statsType", 0);

List<Map> timeList = new ArrayList<>();

Map<String, String> TimeMap = new HashMap<>();

TimeMap.put("startTime", "2024-07-01T0:00:00.000");

TimeMap.put("endTime", "2024-07-01T0:00:00.000");

timeList.add(TimeMap);

map.put("timeRegions", timeList);

tagList.add(map);

inInfo.set("clientId","4436611986732923");

inInfo.set("secret","45384AE8472330A8C0843EE969296BEA");

inInfo.set("dsName","test217");

inInfo.set("tags",tagList);

inInfo.set(EiConstant.serviceId, "S_BI_HD_09");

outInfo = XServiceManager.call(inInfo);

● 返回结果示例

{

"result": {

"tags": [

{

"tagName": "hdsys_cpu_0",

"tagId": "1",

"errorCode": "0",

"value": "28"

}

]

"__sys__": {

"msg": "",

"traceId": "0aa19758e17224093092310000005c",

"detailMsg": "",

"msgKey": "",

"status": 1

"__version__": "2.0",

"__blocks__": {}

}

S_BI_HD_09 统计

S_BI_HD_09 统计