更新时间:2023-12-19 GMT+08:00

查询UAP性能信息接口

前置条件

需要在性能管理工具里面创建“入局话务测量”任务,创建详情请参考《UAP9600 产品文档》中的“维护->性能管理”章节。该接口仅支持全局AK/SK鉴权调用。

注意:本接口仅支持独立部署环境。

场景描述

查询当前时间最近5分钟UAP的性能数据,包括中继使用信息,包括空闲电路数、可用电路数、电路占用率等。

接口方法

设置成“POST”。该接口仅支持POST方法,不支持PUT、GET和DELTE等方法。

请求URL

https://ip:port/rest/cmsapp/v1/openapi/uap/queryUapPerfInfo

其中,公有云环境请联系管理员获取,ip为CC-CMS服务器地址,port为CC-CMS服务器的HTTPS端口号。

非公有云环境如果配置了NSLB服务,ip请填写NSLB的服务器地址,port为CC-CMS服务在NSLB映射的HTTPS端口号。

请求说明

表1 请求头参数

序号

名称

参数类型

是否必选

说明

1

Content-Type

String

True

固定填 application/json; charset=UTF-8。

2

Authorization

String

True

生成方式参见C2 监控/系统外呼/话单/知识库类接口鉴权方式

表2 请求消息体参数说明

参数名

数据类型

是否必选

说明

ofcNo

array

False

入局编号数组,如果编号数组为空则查询所有入局编号数据;

入局编号可以通过MML命令LST OFC命令查询获得。

ccId

int

False

呼叫中心编号

  • 独立部署环境,默认值为系统管理员登录AICC系统后,通过配置中心 > 系统管理 > 参数配置查看“默认呼叫中心标识”的值。

响应消息

表3 响应消息体参数说明

参数名

数据类型

说明

resultCode

String

查询结果。取值如下:

  • "0100000":成功
  • 其他:失败
  • 失败的原因说明请参见错误码参考

resultDesc

List

查询成功后,返回结果信息的对象列表。

该数组中对象的参数说明请参见下

10.xx.xx.xx#0

String

  • 10.xx.xx.xx:UAP IP
  • “#”:固定分隔符
  • “0”:UAP编号
表4 resultDesc对象参数说明

参数名

数据类型

说明

RET

String

采集该数据结束时间

RNAT12

String

久叫不应次数

busy circuits (TIMES)

String

忙电路数

ASD32

String

平均占用时长(秒)

ITAR19

String

入中继可用率

CLBT40

String

被叫忙(市话或称本地通话)

MEID

String

设备ID

UBC43

String

电路闭塞个数

CCT34

String

对端拥塞造成呼叫失败数

LCOICT7

String

本局内部拥塞呼损

IOCS44

String

入局CAPS统计值

MOIID

String

测量对象类ID

CCT3

String

接通次数

CDA9

String

拥塞时长辅助量

AART11

String

振铃早释次数,即主叫用户在呼叫接通或结束前挂机的次数。

TAT6

String

转接应答次数。

转接应答,指接听应答的用户非本局用户。

Period

String

周期

TCAT5

String

落地应答次数

落地应答,指接听应答的用户为本局用户。

AR21

String

应答率

TCAT2

String

转接试占次数

TCAT1

String

落地试占次数

ICN13

String

安装电路数

ECT35

String

拨打空号的次数

incoming direction

String

0(anonymous):0表示入局ID,anonymous表示名称

IBCN16

String

安装双向电路数

ACN14

String

可用电路数

TCT42

String

转接占用次数

IAT36

String

无效的地址的次数

Credible

String

是否可信

CFORT39

String

被叫没有权限

RT

String

采集改数据时间

ST26

String

占用话务量

Time

String

次数

average answer duration (SECOND)

String

平均接通响应时长

AT30

String

应答话务量

TUT37

String

终端不兼容的次数

BCN15

String

闭塞电路数

BBCR23

String

双向电路闭塞率

CTBT41

String

被叫长忙次数

BTST24

String

双向中继占用话务量

BTSTA25

String

双向中继占用话务量辅助量

ABCN17

String

可用双向电路数

CTA29

String

接通话务量辅助量

AT4

String

应答次数

EROC46

String

电路占用率

TET38

String

终端错误的次数

CT28

String

接通话务量

SOIC45

String

空闲电路数

ST0

String

占用次数

BCR22

String

闭塞率

ABRT33

String

呼叫早释次数

CR20

String

接通率

BBCN18

String

闭塞双向电路数

CD8

String

拥塞时长

ATA31

String

应答话务量辅助量

CBT10

String

被叫忙

STA27

String

占用话务量辅助量

average connection duration (MILLISECOND)

String

平均连接时长

answer duration aux (TIMES)

String

应答响应总时长辅助量

样例报文

  • 请求头:
    Content-Type: application/json;charset=UTF-8
    Authorization: ******************
  • 请求参数:
    {
        "ofcNo": [0,1],
        "ccId": 1
    }
  • 响应参数:
    {
        "resultCode": "0100000",
        "resultDesc": {
          "10.xx.xx.xx#0": [
            {
                "RET": "2021-02-04 10:05:00 +00:00",
                "RNAT12": "0",
                "busy circuits (TIMES)": "0",
                "ASD32": "0.000000",
                "ITAR19": "0.000000",
                "CLBT40": "-1",
                "MEID": "5",
                "UBC43": "-1",
                "CCT34": "-1",
                "LCOICT7": "0",
                "IOCS44": "0",
                "MOIID": "0",
                "CCT3": "0",
                "CDA9": "-1",
                "AART11": "0",
                "TAT6": "0",
                "Period": "5",
                "TCAT5": "0",
                "AR21": "0.000000",
                "TCAT2": "0",
                "TCAT1": "0",
                "ICN13": "0",
                "ECT35": "0",
                "incoming direction": "0(anonymous)",
                "IBCN16": "0",
                "ACN14": "0",
                "TCT42": "-1",
                "IAT36": "0",
                "Credible": "Credible",
                "CFORT39": "-1",
                "RT": "2021-02-04 10:00:00 +00:00",
                "ST26": "0.000000",
                "Time": "1000",
                "average answer duration (SECOND)": "0",
                "AT30": "0.000000",
                "TUT37": "-1",
                "BCN15": "0",
                "BBCR23": "0.000000",
                "CTBT41": "-1",
                "BTST24": "0.000000",
                "BTSTA25": "-1",
                "ABCN17": "0",
                "CTA29": "-1",
                "AT4": "0",
                "EROC46": "0.000000",
                "TET38": "-1",
                "CT28": "0.000000",
                "SOIC45": "0",
                "ST0": "0",
                "BCR22": "0.000000",
                "ABRT33": "0",
                "CR20": "0.000000",
                "BBCN18": "0",
                "CD8": "0",
                "ATA31": "-1",
                "CBT10": "0",
                "STA27": "-1",
                "average connection duration (MILLISECOND)": "0",
                "answer duration aux (TIMES)": "-1"
            }
        ]
        }
    }