2023數(shù)字換流站業(yè)務(wù)交互技術(shù)規(guī)范

數(shù)字換流站業(yè)務(wù)交互技術(shù)規(guī)范 1范圍本文件規(guī)定了數(shù)字換流站業(yè)務(wù)交互部分的系統(tǒng)構(gòu)成、總體原則和技術(shù)要求，包括數(shù)據(jù)、告警、文件、日志、視頻、三維、控制、卡片等業(yè)務(wù)交互接口。本文件適用于換流站的數(shù)字化建設(shè)，指導(dǎo)數(shù)字換流站的設(shè)計(jì)、研發(fā)、驗(yàn)收和應(yīng)用。2規(guī)范性引用文件下列文件中的內(nèi)容通過文中的規(guī)范性引用而構(gòu)成本文件必不可少的條款。其中，注日期的引用文件，僅該日期對(duì)應(yīng)的版本適用于本文件；不注日期的引用文件，其最新版本（包括所有的修改單）適用于本文件。GB/T22239信息安全技術(shù)網(wǎng)絡(luò)安全等級(jí)保護(hù)基本要求GB/T30149電網(wǎng)通用模型描述規(guī)范3術(shù)語和定義數(shù)字換流站digitalconverterstation運(yùn)用先進(jìn)數(shù)字技術(shù)、信息技術(shù)發(fā)展創(chuàng)新成果，統(tǒng)籌布局?jǐn)?shù)字化基礎(chǔ)設(shè)施，具有強(qiáng)化設(shè)備廣泛互聯(lián)、狀態(tài)深度感知、數(shù)據(jù)融合貫通、管理精益高效能力的換流站。公共組件publiccomponent具備數(shù)據(jù)接入、處理、存儲(chǔ)和分析能力，對(duì)外提供服務(wù)接口供應(yīng)用調(diào)用，支撐業(yè)務(wù)應(yīng)用功能實(shí)現(xiàn)的軟件?；A(chǔ)應(yīng)用basicapplication具備一定的生產(chǎn)業(yè)務(wù)處理能力，滿足運(yùn)行監(jiān)視、運(yùn)維分析、業(yè)務(wù)管控等共性數(shù)字化需求的應(yīng)用軟件。高級(jí)應(yīng)用advancedapplication具有較強(qiáng)專業(yè)性或信息綜合處理能力的應(yīng)用軟件，是基礎(chǔ)應(yīng)用的增強(qiáng)和補(bǔ)充，滿足狀態(tài)預(yù)測(cè)、健康評(píng)估、診斷分析等生產(chǎn)業(yè)務(wù)的差異化需求。4縮略語API：應(yīng)用程序接口（ApplicationProgrammingInterface）CIM：公共信息模型（CommonInformationModel）JSON：數(shù)據(jù)交換格式（JavaScriptObjectNotation）MQ：消息隊(duì)列（MessageQueue）URL：統(tǒng)一資源定位系統(tǒng)（UniformResourceLocator）XML：可擴(kuò)展標(biāo)記語言（ExtensibleMarkupLanguage）UTF-8：8位元可變長(zhǎng)度統(tǒng)一碼（萬國碼）字符編碼（UnicodeTransformationFormat-8bit）5系統(tǒng)構(gòu)成數(shù)字站公共組件由若干數(shù)據(jù)組件和業(yè)務(wù)組件組合而成，公共組件基于基礎(chǔ)數(shù)據(jù)實(shí)現(xiàn)業(yè)務(wù)功能的處理和響應(yīng)；作為服務(wù)端，公共組件對(duì)外提供一系列業(yè)務(wù)交互接口，支撐應(yīng)用獲取數(shù)據(jù)、告警、文件等信息。數(shù)字站業(yè)務(wù)交互框架如圖1所示。業(yè)務(wù)交互支持本地及遠(yuǎn)方訪問數(shù)字站公共組件等，業(yè)務(wù)交互應(yīng)滿足如下主要功能：a) 提供請(qǐng)求訂閱實(shí)時(shí)數(shù)據(jù)的能力；b) 提供請(qǐng)求存儲(chǔ)歷史數(shù)據(jù)的能力；c) 提供請(qǐng)求訂閱告警數(shù)據(jù)的能力；d) 提供請(qǐng)求發(fā)送文件數(shù)據(jù)的能力；e) 提供請(qǐng)求獲取視頻數(shù)據(jù)的能力；f) 提供請(qǐng)求獲取三維模型的能力；g) 提供請(qǐng)求數(shù)據(jù)模型的能力；h) 提供請(qǐng)求設(shè)備臺(tái)賬數(shù)據(jù)的能力。圖1數(shù)字站業(yè)務(wù)交互框架示意圖6總體原則業(yè)務(wù)交互應(yīng)遵循以下基本技術(shù)原則：a) 業(yè)務(wù)交互應(yīng)通過微服務(wù)架構(gòu)實(shí)現(xiàn)統(tǒng)一的信息訪問接口；b) 交互接口參數(shù)應(yīng)采用JSON格式定義；c) 交互接口應(yīng)具備權(quán)限校驗(yàn)機(jī)制；d) 安全防護(hù)應(yīng)符合GB/T22239規(guī)定，。7技術(shù)要求7.1接口交互7.1.1總體要求公共組件與應(yīng)用之間使用統(tǒng)一的數(shù)據(jù)交互接口，數(shù)據(jù)交互內(nèi)容使用UTF-8編碼的JSON格式字符串，用于應(yīng)用讀取公共組件的實(shí)時(shí)數(shù)據(jù)、收發(fā)公共組件的告警消息、讀寫公共組件的歷史數(shù)據(jù)、文件數(shù)據(jù)、視頻數(shù)據(jù)以及三維數(shù)據(jù)等，交互數(shù)據(jù)分為請(qǐng)求接口輸入?yún)?shù)和回調(diào)接口返回參數(shù)，交互時(shí)需要進(jìn)行用戶權(quán)限校驗(yàn)。7.1.2交互內(nèi)容公共組件與應(yīng)用之間交互的數(shù)據(jù)內(nèi)容如下：a) 實(shí)時(shí)數(shù)據(jù)：包括裝置上送的模擬量、相量量測(cè)、狀態(tài)量的實(shí)時(shí)變化數(shù)據(jù)；b) 歷史數(shù)據(jù)：包括公共組件存儲(chǔ)的狀態(tài)量、模擬量等歷史數(shù)據(jù)；c) 告警數(shù)據(jù)：包括實(shí)時(shí)告警數(shù)據(jù)和歷史告警數(shù)據(jù)；d) 文件數(shù)據(jù)：包括錄波文件、圖形文件等；e) 日志數(shù)據(jù)：包括應(yīng)用運(yùn)行日志、操作日志等；f) 視頻數(shù)據(jù)：包括視頻流、快照?qǐng)D片等；g) 三維數(shù)據(jù)：包括三維信息、三維畫面等。7.1.3交互方式公共組件與應(yīng)用之間的數(shù)據(jù)交互方式包括數(shù)據(jù)查詢、數(shù)據(jù)訂閱（WebSocket方式）、數(shù)據(jù)訂閱（消息隊(duì)列）和數(shù)據(jù)存儲(chǔ)四種方式，要求如下：a) 數(shù)據(jù)查詢：應(yīng)用通過主動(dòng)請(qǐng)求方式查詢需要的數(shù)據(jù)，交互方式采用HTTP（HTTPS）協(xié)議，使用RESTful設(shè)計(jì)風(fēng)格，查詢的數(shù)據(jù)應(yīng)支持查詢條件過濾，查詢的數(shù)據(jù)類型包括實(shí)時(shí)數(shù)據(jù)、歷史數(shù)據(jù)、告警數(shù)據(jù)和文件數(shù)據(jù)等，數(shù)據(jù)查詢交互方式如圖2所示；b) 數(shù)據(jù)訂閱（WebSocket方式）：應(yīng)用主動(dòng)向公共組件建立WebSocket連接，并向公共組件進(jìn)行數(shù)據(jù)訂閱，訂閱后公共組件周期向應(yīng)用推送訂閱的數(shù)據(jù)，同時(shí)實(shí)時(shí)推送變化的數(shù)據(jù)，訂閱的數(shù)據(jù)應(yīng)支持查詢條件過濾，數(shù)據(jù)訂閱（WebSocket方式）如圖3所示；c) 數(shù)據(jù)訂閱（消息隊(duì)列方式）：應(yīng)用通過消息中間件以訂閱主題的方式請(qǐng)求數(shù)據(jù)，公共組件通過消息中間件周期向應(yīng)用推送訂閱的數(shù)據(jù)，同時(shí)實(shí)時(shí)推送變化的數(shù)據(jù)，數(shù)據(jù)訂閱（消息隊(duì)列方式）如圖4所示；d) 數(shù)據(jù)存儲(chǔ)：應(yīng)用調(diào)用公共組件提供的歷史數(shù)據(jù)交互接口寫入需要保存的歷史數(shù)據(jù)，交互方式采用HTTP（HTTPS）協(xié)議，使用RESTful設(shè)計(jì)風(fēng)格，數(shù)據(jù)存儲(chǔ)交互方式如圖5所示。圖2數(shù)據(jù)查詢圖3數(shù)據(jù)訂閱（WebSocket方式）圖4數(shù)據(jù)訂閱（消息隊(duì)列方式）圖5數(shù)據(jù)存儲(chǔ)7.2接口定義7.2.1總體要求接口是由公共組件基于微服務(wù)框架提供的一組服務(wù)，用于讀取和修改數(shù)據(jù)、收發(fā)消息、讀寫文件等。接口風(fēng)格參照RESTfulAPI規(guī)范，以HTTP(s)URL的形式體現(xiàn)資源和對(duì)應(yīng)的接口方法。完整的接口方法由域名（IP地址）、版本、路徑（端點(diǎn)）、HTTP動(dòng)詞（GET和POST）、過濾信息（參數(shù)）、狀態(tài)碼、返回結(jié)果等組成。7.2.2URL接口采用的HTTP(s)URL形式，如表1所示，接口URL中各組成部分的說明如下所列，如表2所示。表1HTTP(s)URL形式序號(hào)URL組成形式1http(s)://{host}:{port}/v{n}/cs/{endpoint}表2URL組成部分序號(hào)URL組成部分說明1{host}:{port}采用http協(xié)議訪問接口所需的主機(jī)地址和端口2cs固定詞，表示數(shù)字站3v{n}表示版本號(hào)，如當(dāng)前版本號(hào)為v14{endpoint}表示路徑（端點(diǎn)），用于標(biāo)識(shí)具體的接口采用本文件的接口URL中，{endpoint}之前的部分（即“http(s)://{host}:{port}/v{n}/cs/”或者“http(s)://{}/v{n}/cs/”）需根據(jù)數(shù)字站的情況進(jìn)行組裝。具體的接口內(nèi)容在{endpoint}部分定義。7.2.3請(qǐng)求方法查詢和數(shù)據(jù)獲取類型的接口，采用HTTPGET方法。其他類型的接口采用HTTPPOST方法。如表3所示。表3請(qǐng)求方法方法描述GET讀取動(dòng)作POST請(qǐng)求動(dòng)作7.2.4消息頭部消息頭部如表4所示。表4消息頭部屬性名稱類型是否必選Content-Type交互類型：權(quán)限認(rèn)證交互（application/x-www-form-urlencoded）、其它交互（application/json）String是Authorizationtoken令牌String是X-HW-IDAPI網(wǎng)關(guān)身份認(rèn)證IDString否X-HW-APPKEYAPI網(wǎng)關(guān)身份認(rèn)證KEYString否7.2.5請(qǐng)求體請(qǐng)求體為JSON格式的對(duì)象，應(yīng)具有以下字段，如表5所示。表5請(qǐng)求體屬性名稱類型是否必選id請(qǐng)求IDInt是clientId客戶端Id（應(yīng)用注冊(cè)時(shí)由權(quán)限認(rèn)證服務(wù)提供）String是body請(qǐng)求內(nèi)容（具體內(nèi)容見各接口詳細(xì)說明）Object是7.2.6返回體返回體為JSON格式的對(duì)象，應(yīng)有以下字段，如表6所示。表6返回體屬性名稱類型是否必選id請(qǐng)求IDInt是code返回碼（應(yīng)符合表A.1）String是message返回碼描述String是body返回內(nèi)容（具體內(nèi)容見各接口詳細(xì)說明）Object是7.3接口功能7.3.1權(quán)限認(rèn)證管理總體要求應(yīng)符合OAuth2.0要求，應(yīng)用前后端交互的權(quán)限認(rèn)證宜采用客戶端模式，對(duì)接口進(jìn)行訪問認(rèn)證和安全管控。應(yīng)用部署時(shí)，應(yīng)在管理平臺(tái)注冊(cè)備案，獲取兩個(gè)身份識(shí)別碼，客戶端ID（clientid）和客戶端密鑰（clientsecret）。應(yīng)用在調(diào)用公共組件接口時(shí)，權(quán)限認(rèn)證服務(wù)通過驗(yàn)證令牌和白名單確保服務(wù)調(diào)用方的合法性。令牌默認(rèn)有效期為24小時(shí)，超時(shí)后需要重新調(diào)用接口獲取新的令牌。權(quán)限獲取權(quán)限獲取接口定義如表7所示，客戶端請(qǐng)求Content-Type為application/x-www-form-urlencoded，請(qǐng)求參數(shù)采用表單傳值方式，如表8所示，返回成功時(shí)數(shù)據(jù)格式定義如表9所示。表7權(quán)限獲取接口定義請(qǐng)求方法POST請(qǐng)求地址/auth-service/oauth/token協(xié)議應(yīng)用http(s)表8權(quán)限獲取請(qǐng)求體定義屬性名稱類型是否必選描述grant_typeToken類型String是固定填寫client_credentialsscope信號(hào)索引鍵String是固定填寫allclient_id客戶端賬號(hào)String是客戶端賬號(hào)，由平臺(tái)分配client_secret客戶端密碼String是客戶端密碼，由平臺(tái)分配表9權(quán)限獲取返回體定義屬性名稱類型描述access_token認(rèn)證TokenString獲取到的令牌token_typeToken類型StringToken類型expires_in過期時(shí)間Long過期時(shí)間scope權(quán)限范圍String表示申請(qǐng)的權(quán)限范圍，默認(rèn)為allcode返回碼String應(yīng)符合表A.1message返回碼描述String返回碼對(duì)應(yīng)的描述信息jti聲明String唯一標(biāo)識(shí)符權(quán)限校驗(yàn)權(quán)限校驗(yàn)接口定義如表10所示，請(qǐng)求參數(shù)采用表單傳值方式，其定義如表11所示，校驗(yàn)成功時(shí)返回?cái)?shù)據(jù)格式定義如表12所示，校驗(yàn)失敗時(shí)返回?cái)?shù)據(jù)格式定義如表13所示。表10權(quán)限校驗(yàn)接口定義請(qǐng)求方法POST請(qǐng)求地址/auth-service/oauth/check_token協(xié)議應(yīng)用http(s)表11權(quán)限校驗(yàn)請(qǐng)求體定義屬性名稱類型是否必選描述token令牌String是待校驗(yàn)的令牌表12權(quán)限校驗(yàn)成功返回體定義屬性名稱類型是否必選描述client_id客戶端IDString是client的配置項(xiàng)即客戶端IDscope授權(quán)范圍String[]是由請(qǐng)求時(shí)參數(shù)決定expaccess_token有效期Long是默認(rèn)有效期為86400秒active是否有效Boolean是token是否有效sub被授權(quán)方String是一般就是當(dāng)前用戶IDiss授權(quán)方String是站名@授權(quán)方，示例如poyanghu@nrecuser_name當(dāng)前用戶名String否當(dāng)前用戶名（僅針對(duì)web用戶）last_login上次登陸時(shí)間戳Long是如果未登陸過，則為0pri用戶角色String[]是用戶具備的角色集合account統(tǒng)一賬戶名String否ISC的唯一賬戶名（僅針對(duì)web用戶）obj_id統(tǒng)一賬戶用戶IDString否ISC的唯一賬戶用戶ID（僅針對(duì)web用戶） 表13權(quán)限校驗(yàn)失敗返回?cái)?shù)據(jù)屬性名稱類型描述succ是否成功Boolean是否校驗(yàn)成功code錯(cuò)誤碼String校驗(yàn)錯(cuò)誤碼message錯(cuò)誤信息String校驗(yàn)錯(cuò)誤信息path請(qǐng)求路徑String請(qǐng)求路徑timestamp校驗(yàn)時(shí)間Long校驗(yàn)時(shí)間用戶同步用戶同步接口定義如表14所示，應(yīng)遵循7.2中消息頭部、請(qǐng)求體、返回體的相關(guān)定義。請(qǐng)求體中body數(shù)據(jù)的定義如表15所示，Condition的定義如表16所示。請(qǐng)求成功時(shí)，返回體中body定義如表17所示，其中SysUser的結(jié)構(gòu)如表18所示。請(qǐng)求失敗時(shí)，返回體中body定義為空。表14用戶同步接口定義請(qǐng)求方法POST請(qǐng)求地址sys-service/sys/user協(xié)議應(yīng)用http(s)表15用戶同步請(qǐng)求體body定義屬性名稱類型是否必選描述id人員主鍵ID列表List<String>否需查詢的人員列表,為空時(shí)查所有人員信息attributes屬性列表List<String>否需返回的屬性列表，不填返回所有conditions檢索條件List<Condition>否檢索條件列表，不填無條件表16用戶同步請(qǐng)求參數(shù)Condition定義屬性名稱類型是否必選描述dept_id部門IdString否所屬部門Idorg_id單位IdString否所屬單位Idif_effective檢索值Boolean否人員是否有效，默認(rèn)所有表17用戶同步成功時(shí)返回體body定義屬性名稱類型描述values人員列表List<SysUser>查詢到的人員列表表18用戶同步返回參數(shù)SysUser定義屬性名稱類型描述obj_id人員主鍵String最大長(zhǎng)度42staff_name人員姓名String最大長(zhǎng)度60order_no顯示順序Intdept_id所屬部門IdString最大長(zhǎng)度42org_id所屬單位IdString最大長(zhǎng)度42account登錄賬戶String最大長(zhǎng)度50create_time創(chuàng)建時(shí)間String格式要求為"yyyy-MM-ddHH:mm:ss.SSS"syn_time同步時(shí)間String格式要求為"yyyy-MM-ddHH:mm:ss.SSS"cancel_time撤銷時(shí)間String格式要求為"yyyy-MM-ddHH:mm:ss.SSS"if_effective是否有效Stringtrue:有效，false:無效staff_post人員崗位String最大長(zhǎng)度50staff_subject人員專業(yè)String最大長(zhǎng)度50staff_sex人員性別String人員性別(0:女,1:男)telphone內(nèi)線電話String最大長(zhǎng)度50cardid身份證String最大長(zhǎng)度52source數(shù)據(jù)來源Stringisc:數(shù)據(jù)同步,owner:自身新增組織同步組織同步接口定義如表19所示，應(yīng)遵循7.2中消息頭部、請(qǐng)求體、返回體的相關(guān)定義。請(qǐng)求體中body數(shù)據(jù)的定義如表20所示，Condition的定義如表21所示。請(qǐng)求成功時(shí)，返回體中body定義如表22所示，其中SysOrg的結(jié)構(gòu)如表23所示。請(qǐng)求失敗時(shí)，返回體中body定義為空。表19組織同步接口定義請(qǐng)求方法POST請(qǐng)求地址sys-service/sys/org協(xié)議應(yīng)用http(s)表20組織同步請(qǐng)求體body定義屬性名稱類型是否必選描述id部門主鍵IDString否需查詢的部門根節(jié)點(diǎn)及其子節(jié)點(diǎn),為空時(shí)查所有部門組織信息attributes屬性列表List<String>否需返回的屬性列表，不填返回所有conditions檢索條件List<Condition>否檢索條件列表，不填無條件表21組織同步請(qǐng)求參數(shù)Condition定義屬性名稱類型是否必選描述manage_level管理級(jí)別String否管理級(jí)別表22組織同步成功時(shí)返回體body定義屬性名稱類型描述values部門列表List<SysOrg>查詢到的部門列表表23組織同步返回?cái)?shù)據(jù)SysOrg定義屬性名稱類型描述obj_id部門主鍵String最大長(zhǎng)度42dept_name部門名稱String最大長(zhǎng)度200dept_style部門性質(zhì)String最大長(zhǎng)度50dept_code部門編碼String最大長(zhǎng)度50p_id上級(jí)IdString最大長(zhǎng)度42p_name上級(jí)部門名稱String最大長(zhǎng)度200order_no顯示順序Intmanage_level管理級(jí)別String最大長(zhǎng)度20dept_simp部門簡(jiǎn)稱String最大長(zhǎng)度100create_time創(chuàng)建時(shí)間String格式要求為"yyyy-MM-ddHH:mm:ss.SSS"syn_time同步時(shí)間String格式要求為"yyyy-MM-ddHH:mm:ss.SSS"cancel_time撤銷時(shí)間String格式要求為"yyyy-MM-ddHH:mm:ss.SSS"if_effective數(shù)據(jù)有效性Intprovince_id所屬網(wǎng)省String最大長(zhǎng)度42province_name所屬網(wǎng)省名稱String最大長(zhǎng)度200municipa_id所屬地市String最大長(zhǎng)度42municipa_name所屬地市名稱String最大長(zhǎng)度200county_id所屬供電公司（縣局）String最大長(zhǎng)度42county_name所屬供電公司名稱String最大長(zhǎng)度200dept_level單位級(jí)別String最大長(zhǎng)度30，判斷省市公司path_name組織全路徑String最大長(zhǎng)度500path_id組織全路徑IdString最大長(zhǎng)度500if_cancel是否撤銷String最大長(zhǎng)度5source數(shù)據(jù)來源Stringisc:數(shù)據(jù)同步,owner:自身新增unicode統(tǒng)一編碼String最大長(zhǎng)度50pms_idPMS映射主鍵String最大長(zhǎng)度50station_type站的類別String最大長(zhǎng)度17.3.2查詢模型數(shù)據(jù)管理通用模型查詢接口公共組件支持應(yīng)用獲取指定設(shè)備模型相關(guān)數(shù)據(jù)信息，設(shè)備模型應(yīng)符合GB/T30149和Q/GDW10703。接口定義如表24所示，應(yīng)遵循7.2中消息頭部、請(qǐng)求體、返回體的相關(guān)定義。請(qǐng)求體中body數(shù)據(jù)的定義如表25所示。請(qǐng)求成功時(shí)，返回體中body定義如表26所示，其中Data結(jié)構(gòu)字段以請(qǐng)求參數(shù)中field字段查詢的數(shù)據(jù)結(jié)構(gòu)為準(zhǔn)，如表27所示。請(qǐng)求失敗時(shí)，返回體中body定義為空。表24通用模型查詢接口定義請(qǐng)求方法POST請(qǐng)求地址mdldata-service/model協(xié)議應(yīng)用http(s)表25通用模型查詢請(qǐng)求體body定義屬性名稱類型是否必選描述field查詢的數(shù)據(jù)結(jié)構(gòu)String是mrid,name,description,…。特定選擇字段，多個(gè)字段時(shí)用英文逗號(hào)分隔，不允許使用*,每個(gè)datetype類型支持的field列表見模型文檔。datatype數(shù)據(jù)類型String是1.Station，廠站2.Area，區(qū)域3.Voltagelevel，電壓等級(jí)4.Bay，間隔5.Equipment，一次設(shè)備6.Analog，模擬量7.State，狀態(tài)量8.Accumulator，遙脈量9.Assettype，設(shè)備類型10.Component，設(shè)備部件11.可根據(jù)具體場(chǎng)景約定擴(kuò)展condition查詢條件String是SQL語句的where條件，查詢條件應(yīng)防止SQL注入。必須指定查詢條件，如不指定，則公共組件直接返回查詢失敗，其中analog/state/accumulator需支持按mrid（模擬量/離散量/累加量標(biāo)識(shí)）、astid（所屬設(shè)備資產(chǎn)ID）、psrid（所屬設(shè)備資源ID）、astuid（所屬設(shè)備通用識(shí)別碼ID）、flagcode(應(yīng)用標(biāo)記碼)進(jìn)行過濾查詢。表26通用模型查詢成功時(shí)返回體body定義屬性名稱類型描述data返回?cái)?shù)據(jù)信息Data數(shù)據(jù)表27通用模型查詢返回?cái)?shù)據(jù)Data定義屬性名稱類型描述mridId值Long例“4222124802768902”name名稱String例“A相電壓”desc描述String例“A相電壓”parentid父節(jié)點(diǎn)String例“029020000000000002092756”dimension單位String例“kV”type類型Int例“6”calvalue值Long例“220.156”根據(jù)mrid查詢數(shù)據(jù)公共組件支持應(yīng)用按需根據(jù)mrid查詢當(dāng)前數(shù)據(jù)。接口定義如表28所示，應(yīng)遵循7.2中消息頭部、請(qǐng)求體、返回體的相關(guān)定義。請(qǐng)求體中body數(shù)據(jù)的定義如表29所示。請(qǐng)求成功時(shí)，返回體中body定義如表30所示。請(qǐng)求失敗時(shí)，返回體中body定義為空。表28根據(jù)mrid查詢數(shù)據(jù)接口定義請(qǐng)求方法POST請(qǐng)求地址mdldata-service/model/getByMrid協(xié)議應(yīng)用http(s)表29根據(jù)mrid查詢數(shù)據(jù)請(qǐng)求體body定義屬性名稱類型是否必選描述mridmridList<String>是根據(jù)mrid查詢具體記錄tableName表名String是根據(jù)模型規(guī)范傳入表名表30根據(jù)mrid查詢數(shù)據(jù)成功時(shí)返回體body定義屬性名稱類型描述values信號(hào)值列表List<Map>查詢到的信號(hào)值列表根據(jù)mrid更新測(cè)點(diǎn)屬性公共組件支持應(yīng)用按需根據(jù)mrid更新測(cè)點(diǎn)的靜態(tài)屬性。接口定義如表31所示，應(yīng)遵循7.2中消息頭部、請(qǐng)求體、返回體的相關(guān)定義。請(qǐng)求體中body數(shù)據(jù)的定義如表32所示。請(qǐng)求成功/失敗時(shí)，返回體中body定義為空。表31根據(jù)mrid更新測(cè)點(diǎn)屬性接口定義請(qǐng)求方法POST請(qǐng)求地址mdldata-service/model/updateAttrsByMrid協(xié)議應(yīng)用http(s)表32根據(jù)mrid更新測(cè)點(diǎn)屬性請(qǐng)求體body定義屬性名稱類型是否必選描述datatype測(cè)點(diǎn)類型String是analog/statemrid測(cè)點(diǎn)idString是測(cè)點(diǎn)mridfields屬性列表List<String>是需要更新的屬性列表，目前支持morelowerlimit（下下限）lowerlimit（下限）upperlimit（上限）moreupperlimit（上上限）flagcode（應(yīng)用標(biāo)記碼）屬性values值List<Object>是需要更新的值列表，順序和fields順序保持一致7.3.3實(shí)時(shí)數(shù)據(jù)管理查詢實(shí)時(shí)數(shù)據(jù)公共組件支持應(yīng)用按需查詢實(shí)時(shí)數(shù)據(jù)的值。接口定義如表33所示，應(yīng)遵循7.2中消息頭部、請(qǐng)求體、返回體的相關(guān)定義。請(qǐng)求體中body數(shù)據(jù)的定義如表34所示。請(qǐng)求成功時(shí)，返回體中body定義如表35所示，其中Data的結(jié)構(gòu)如表36所示。請(qǐng)求失敗時(shí)，返回體中body定義為空。表33查詢實(shí)時(shí)數(shù)據(jù)接口定義請(qǐng)求方法POST請(qǐng)求地址realdata-service/data/realtime協(xié)議應(yīng)用http(s)表34查詢實(shí)時(shí)數(shù)據(jù)請(qǐng)求體body定義屬性名稱類型是否必選描述datatype數(shù)據(jù)類型String是需查詢的數(shù)據(jù)類型(analog/state/accumulator),為空時(shí)不限定類型keys信號(hào)索引鍵List<String>是需查詢的信號(hào)列表表35查詢實(shí)時(shí)數(shù)據(jù)成功時(shí)返回體body定義屬性名稱類型描述values信號(hào)值列表List<Data>查詢到的信號(hào)值列表表36查詢實(shí)時(shí)數(shù)據(jù)返回?cái)?shù)據(jù)Data定義屬性名稱類型描述key信號(hào)索引鍵String信號(hào)的mridvalue值Double信號(hào)值quality品質(zhì)Int描述信號(hào)的品質(zhì)，0為有效，1為無效time_stamp刷新時(shí)間String描述信號(hào)的刷新時(shí)間，格式要求為"yyyy-MM-ddHH:mm:ss.SSS"訂閱實(shí)時(shí)數(shù)據(jù)（WebSocket方式）公共組件支持應(yīng)用通過WebSocket方式按需或全量訂閱數(shù)據(jù)，一般用于前后端交互。接口定義如表37所示。請(qǐng)求體中body數(shù)據(jù)的定義如表38所示。WebSocket服務(wù)端根據(jù)訂閱情況，轉(zhuǎn)發(fā)實(shí)時(shí)數(shù)據(jù)，數(shù)據(jù)遵循7.2中關(guān)于返回體的定義，如果是單個(gè)測(cè)點(diǎn)數(shù)據(jù)返回，即請(qǐng)求體中package為0，或者不帶package屬性，返回體格式如表39所示，如果是批量測(cè)點(diǎn)數(shù)據(jù)返回，即請(qǐng)求體中package為1，返回體body格式定義如表40所示，其中Data的結(jié)構(gòu)如表41所示。表37訂閱實(shí)時(shí)數(shù)據(jù)（WebSocket方式）接口定義請(qǐng)求方法WebSocket請(qǐng)求地址ws-service/register協(xié)議應(yīng)用WebSocket表38訂閱實(shí)時(shí)數(shù)據(jù)（WebSocket方式）請(qǐng)求體body定義屬性名稱類型是否必選描述token令牌String是表征鑒權(quán)令牌action動(dòng)作類型String是表示執(zhí)行的操作類型，subscribe訂閱，unsubscribe退訂subscribetype訂閱類型Int否0，周期推送，1變化推送，2周期加變化推送，默認(rèn)周期推送interval推送周期Int否單位秒，最小30秒，默認(rèn)1800秒package是否組包Int否0組包，1不組包，默認(rèn)不組包datatype數(shù)據(jù)類型String是訂閱的數(shù)據(jù)類型(analog/state),為空時(shí)不限定類型keys信號(hào)索引鍵List<String>是需訂閱（退訂）的信號(hào)列表，在訂閱時(shí)，如果為空則表示全部訂閱表39訂閱實(shí)時(shí)數(shù)據(jù)（不組包）成功時(shí)返回體body定義屬性名稱類型描述key信號(hào)索引鍵String信號(hào)的mridvalue值Object信號(hào)值quality品質(zhì)Int描述信號(hào)的品質(zhì)，0為有效，1為無效name名稱String描述信號(hào)的名稱datatype測(cè)點(diǎn)類型Stringanalog/statetime_stamp時(shí)間String描述信號(hào)的刷新時(shí)間，格式要求為：yyyy-MM-ddHH:mm:ss.SSS表40訂閱實(shí)時(shí)數(shù)據(jù)（組包）成功時(shí)返回體body定義屬性名稱類型描述values信號(hào)值列表List<Data>查詢到的信號(hào)值列表reason推送原因Int0，周期推送，1變化推送，2周期加變化推送表41訂閱實(shí)時(shí)數(shù)據(jù)（組包）返回?cái)?shù)據(jù)Data定義屬性名稱類型描述key信號(hào)索引鍵String信號(hào)的mridvalue值Object信號(hào)值quality品質(zhì)Int描述信號(hào)的品質(zhì)，0為有效，1為無效name名稱String描述信號(hào)的名稱datatype測(cè)點(diǎn)類型Stringanalog/statetime_stamp時(shí)間String描述信號(hào)的刷新時(shí)間，格式要求為：yyyy-MM-ddHH:mm:ss.SSS訂閱實(shí)時(shí)數(shù)據(jù)（消息隊(duì)列方式）消息隊(duì)列方式只支持全量訂閱，應(yīng)用端按需處理。接口定義如表42所示，消息隊(duì)列方式時(shí)，只需要按需訂閱相關(guān)主題，可以使用通配的方式通過過濾key值訂閱一組數(shù)據(jù)，公共組件服務(wù)端定時(shí)或按變化向消息隊(duì)列發(fā)布實(shí)時(shí)數(shù)據(jù)，應(yīng)用按訂閱獲取數(shù)據(jù)，返回body定義如表43所示。表42訂閱實(shí)時(shí)數(shù)據(jù)（消息隊(duì)列方式）接口定義請(qǐng)求方法消息隊(duì)列TOPICT_DC_MQ_REALDATA協(xié)議應(yīng)用消息隊(duì)列組件SDK，key為信號(hào)鍵，支持通配符模式表43訂閱實(shí)時(shí)數(shù)據(jù)（消息隊(duì)列方式）成功時(shí)返回體body定義屬性名稱類型描述key信號(hào)索引鍵String信號(hào)的mrid。value值Object信號(hào)值quality品質(zhì)Int描述信號(hào)的品質(zhì)，0為有效，1為無效name名稱String描述信號(hào)的名稱datatype測(cè)點(diǎn)類型Stringanalog/statetime_stamp時(shí)間String描述信號(hào)的刷新時(shí)間，格式要求為：yyyy-MM-ddHH:mm:ss.SSS存儲(chǔ)實(shí)時(shí)數(shù)據(jù)公共組件支持應(yīng)用存儲(chǔ)更新實(shí)時(shí)數(shù)據(jù)。接口定義如表44所示，應(yīng)遵循7.2中消息頭部、請(qǐng)求體、返回體的相關(guān)定義。請(qǐng)求體中body數(shù)據(jù)的定義如表45所示，其中Data的結(jié)構(gòu)如表46所示。請(qǐng)求成功或者失敗時(shí)，返回體中body都定義為空。表44存儲(chǔ)實(shí)時(shí)數(shù)據(jù)接口定義請(qǐng)求方法POST請(qǐng)求地址realdata-service/data/realtime/store協(xié)議應(yīng)用http(s)表45存儲(chǔ)實(shí)時(shí)數(shù)據(jù)請(qǐng)求體body定義屬性名稱類型是否必選描述datatype數(shù)據(jù)類型String是存儲(chǔ)的數(shù)據(jù)類型(analog/state),為空時(shí)不限定類型values信號(hào)值列表List<Data>是存儲(chǔ)的信號(hào)值列表表46存儲(chǔ)實(shí)時(shí)數(shù)據(jù)請(qǐng)求參數(shù)Data定義屬性名稱類型描述key信號(hào)索引鍵String信號(hào)的mridvalue值Object信號(hào)值quality品質(zhì)Int描述信號(hào)的品質(zhì)，0為有效，1為無效time_stamp時(shí)間String描述信號(hào)的采集時(shí)間，格式要求為：yyyy-MM-ddHH:mm:ss.SSSdescription信號(hào)描述String描述7.3.4關(guān)系庫數(shù)據(jù)管理查詢歷史數(shù)據(jù)管理公共組件支持應(yīng)用按需查詢指定一組遙測(cè)信號(hào)的歷史數(shù)據(jù)。單次查詢數(shù)據(jù)返回總量不應(yīng)超過10萬條，超過一定量時(shí)，返回調(diào)用失敗，提示采用分批多次取數(shù)據(jù)方式獲取數(shù)據(jù)，以防網(wǎng)絡(luò)擁堵。接口定義如表47所示，應(yīng)遵循7.2中消息頭部、請(qǐng)求體、返回體的相關(guān)定義。請(qǐng)求體中body數(shù)據(jù)的定義如表48所示。請(qǐng)求成功時(shí)，返回體中body定義如表49所示，其中HisData的結(jié)構(gòu)如表50所示，HisDataVal的結(jié)構(gòu)如表51所示，部分失敗時(shí)對(duì)應(yīng)信號(hào)的vals值為空。請(qǐng)求失敗時(shí)，返回體中body定義為空。表47查詢歷史數(shù)據(jù)接口定義請(qǐng)求方法POST請(qǐng)求地址hisdata-service/data/history協(xié)議應(yīng)用http(s)表48查詢歷史數(shù)據(jù)請(qǐng)求體body定義屬性名稱類型是否必選描述datatype數(shù)據(jù)類型String是需查詢的數(shù)據(jù)類型(analog/state/accumulator),為空時(shí)不限定類型keys信號(hào)索引鍵List<String>是需查詢的信號(hào)列表startTime開始時(shí)間String是開始時(shí)間（含），格式要求為：yyyy-MM-ddHH:mm:ss.SSSendTime結(jié)束時(shí)間String是結(jié)束時(shí)間（不含），格式要求為：yyyy-MM-ddHH:mm:ss.SSSinterval取值間隔Int是取值間隔，如：5，表示5分鐘取一個(gè)值count是否查詢統(tǒng)計(jì)值Int否0，不返回統(tǒng)計(jì)值，1，返回統(tǒng)計(jì)值表49查詢歷史數(shù)據(jù)成功時(shí)返回體body定義屬性名稱類型描述values信號(hào)值列表List<HisData>查詢到的信號(hào)值列表表50查詢歷史數(shù)據(jù)返回?cái)?shù)據(jù)HisData定義屬性名稱類型描述key信號(hào)索引鍵String信號(hào)的mridvals值List<HisDataVal>歷史數(shù)據(jù)列表表51查詢歷史數(shù)據(jù)返回?cái)?shù)據(jù)HisDataVal定義屬性名稱類型是否必選描述time時(shí)刻String是采樣時(shí)刻，格式要求為：yyyy-MM-ddHH:mm:ss.SSSvalue值Double是遙測(cè)值favgvalue平均值Double否（入?yún)ount為1時(shí)返回）過去5分鐘平均值fmax極大值Double否（入?yún)ount為1時(shí)返回）過去5分鐘極大值fmin極小值Double否（入?yún)ount為1時(shí)返回）過去5分鐘極小值tmax極大值時(shí)間String否（入?yún)ount為1時(shí)返回）格式要求為：yyyy-MM-ddHH:mm:ss.SSStmin極小值時(shí)間String否（入?yún)ount為1時(shí)返回）格式要求為：yyyy-MM-ddHH:mm:ss.SSS查詢關(guān)系庫元數(shù)據(jù)公共組件支持應(yīng)用按需查詢關(guān)系庫數(shù)據(jù)。接口定義如表52所示，應(yīng)遵循7.2中消息頭部、請(qǐng)求體、返回體的相關(guān)定義。請(qǐng)求體中body數(shù)據(jù)的定義如表53所示。請(qǐng)求成功時(shí)，返回體中body定義如表54所示。請(qǐng)求失敗時(shí)，返回體中body只包含noun。表52查詢關(guān)系庫元數(shù)據(jù)接口定義請(qǐng)求方法POST請(qǐng)求地址db-service/GetMetaData協(xié)議應(yīng)用http(s)表53查詢關(guān)系庫元數(shù)據(jù)請(qǐng)求體body定義屬性名稱類型是否必選描述nounCIM名稱String是對(duì)應(yīng)關(guān)系庫的物理表名稱表54查詢關(guān)系庫元數(shù)據(jù)成功時(shí)返回體body定義屬性名稱類型描述nounCim名稱String查詢表名attributes屬性列表List<String>返回的屬性列表查詢關(guān)系庫數(shù)據(jù)公共組件支持應(yīng)用按需查詢關(guān)系庫數(shù)據(jù)。接口定義如表55所示，應(yīng)遵循7.2中消息頭部、請(qǐng)求體、返回體的相關(guān)定義。請(qǐng)求體中body數(shù)據(jù)的定義如表56所示，Condition定義如表57所示，Operator支持列表如表58所示，多個(gè)condition之間是“邏輯或”的關(guān)系，condition內(nèi)部多組條件之間是“邏輯與”的關(guān)系。請(qǐng)求成功時(shí)，返回體中body定義如表59所示。請(qǐng)求失敗時(shí)，返回體中body只包含noun。表55查詢關(guān)系庫數(shù)據(jù)接口定義請(qǐng)求方法POST請(qǐng)求地址db-service/GetData協(xié)議應(yīng)用http(s)表56查詢關(guān)系庫數(shù)據(jù)請(qǐng)求體body定義屬性名稱類型是否必選描述nounCIM名稱String是對(duì)應(yīng)關(guān)系庫的物理表名稱attributes屬性列表List<String>是需返回的屬性列表conditions檢索條件List<condition>是檢索條件列表表57查詢關(guān)系庫數(shù)據(jù)請(qǐng)求參數(shù)Condition定義屬性名稱類型是否必選描述attribute屬性名String是對(duì)應(yīng)關(guān)系庫的物理表字段名稱operator比較符String是見下表value檢索值String是檢索值表58查詢關(guān)系庫數(shù)據(jù)請(qǐng)求參數(shù)Operator支持列表Operator含義LIKELikeEQ=NE!=GT>LT<GE>=LE<=INIn（對(duì)應(yīng)值列表以英文逗號(hào)分隔）表59查詢關(guān)系庫數(shù)據(jù)成功時(shí)返回體body定義屬性名稱類型描述count記錄數(shù)Int返回記錄數(shù)nounCim名稱String查詢表名attributes屬性列表List<String>返回的屬性列表recs值列表List<JSON>返回的值列表存儲(chǔ)關(guān)系庫數(shù)據(jù)公共組件支持應(yīng)用按需存儲(chǔ)關(guān)系庫數(shù)據(jù)。接口定義如表60所示，應(yīng)遵循7.2中消息頭部、請(qǐng)求體、返回體的相關(guān)定義。請(qǐng)求體中body數(shù)據(jù)的定義如表61所示。請(qǐng)求成功或失敗時(shí)，返回體中body定義如表62所示。表60存儲(chǔ)關(guān)系庫數(shù)據(jù)接口定義請(qǐng)求方法POST請(qǐng)求地址db-service/PutData協(xié)議應(yīng)用http(s)表61存儲(chǔ)關(guān)系庫數(shù)據(jù)請(qǐng)求體body定義屬性名稱類型是否必選描述nounCIM名稱String是對(duì)應(yīng)關(guān)系庫的物理表名稱attributes屬性列表List<String>是需插入的屬性列表recs值列表List<JSON>是需插入的值列表表62存儲(chǔ)關(guān)系庫數(shù)據(jù)成功時(shí)返回體body定義屬性名稱類型描述nounCim名稱String查詢表名更新關(guān)系庫數(shù)據(jù)公共組件支持應(yīng)用按需更新關(guān)系庫數(shù)據(jù)。接口定義如表63所示，應(yīng)遵循7.2中消息頭部、請(qǐng)求體、返回體的相關(guān)定義。請(qǐng)求體中body數(shù)據(jù)的定義如表64所示。請(qǐng)求成功或失敗時(shí)，返回體中body定義如表65所示。表63更新關(guān)系庫數(shù)據(jù)接口定義請(qǐng)求方法POST請(qǐng)求地址db-service/UpdateData協(xié)議應(yīng)用http(s)表64更新關(guān)系庫數(shù)據(jù)請(qǐng)求體body定義屬性名稱類型是否必選描述nounCIM名稱String是對(duì)應(yīng)關(guān)系庫的物理表名稱attributes屬性列表List<String>是需更新的屬性列表recs值列表List<JSON>是需更新的值列表，目前只支持單條記錄更新conditions條件列表List<condition>是更新條件,詳見章節(jié)表65更新關(guān)系庫數(shù)據(jù)成功時(shí)返回體body定義屬性名稱類型描述nounCim名稱String查詢表名7.3.5系統(tǒng)事件告警管理訂閱實(shí)時(shí)告警（WebSocket方式）公共組件支持應(yīng)用通過WebSocket方式按需或全量訂閱實(shí)時(shí)告警，一般用于前后端交互。接口定義如表66所示，請(qǐng)求體中body數(shù)據(jù)的定義如表67所示，其中Conditions定義如表68所示，WebSocket服務(wù)端根據(jù)訂閱情況，轉(zhuǎn)發(fā)實(shí)時(shí)告警，返回body定義如表69所示，其中Warn的結(jié)構(gòu)如表70所示。表66訂閱實(shí)時(shí)告警（WebSocket方式）接口定義請(qǐng)求方法WebSocket請(qǐng)求地址ws-service/register協(xié)議應(yīng)用WebSocket表67訂閱實(shí)時(shí)告警（WebSocket方式）請(qǐng)求體body定義屬性名稱類型是否必選描述token令牌String是表征鑒權(quán)令牌action動(dòng)作類型String是表示執(zhí)行的操作類型，subscribe訂閱，unsubscribe退訂conditions過濾條件Conditions是用于篩選告警數(shù)據(jù)表68訂閱實(shí)時(shí)告警（WebSocket方式）Conditions定義屬性名稱類型是否必選描述deviceId設(shè)備IDList<String>否訂閱設(shè)備的編號(hào)列表level告警級(jí)別List<Int>否告警級(jí)別列表，對(duì)告警級(jí)別進(jìn)行過濾,應(yīng)符合表B.1type告警類型List<String>否告警類型列表，對(duì)告警類型進(jìn)行過濾keywords關(guān)鍵詞List<String>否關(guān)鍵詞列表，對(duì)告警內(nèi)容進(jìn)行模糊匹配，關(guān)鍵詞之間為或關(guān)系表69訂閱實(shí)時(shí)告警（WebSocket方式）成功時(shí)返回體body定義屬性名稱類型描述warns告警列表List<Warn>查詢到的告警列表表70訂閱實(shí)時(shí)告警（WebSocket方式）返回?cái)?shù)據(jù)Warn定義屬性名稱類型是否必選描述idIDString是告警id唯一標(biāo)識(shí)areaid區(qū)域IDString是告警所屬區(qū)域idareaname區(qū)域名稱String是告警所屬區(qū)域名稱isreport是否含有簡(jiǎn)報(bào)Boolean是標(biāo)識(shí)是否含有簡(jiǎn)報(bào)內(nèi)容time時(shí)間String是告警發(fā)生時(shí)間，格式要求為：yyyy-MM-ddHH:mm:ss.SSSsystemid主機(jī)String是所屬主機(jī)redundantsystem系統(tǒng)String是所屬系統(tǒng)deviceId所屬設(shè)備String是告警相關(guān)設(shè)備IDlevel告警級(jí)別Int是應(yīng)符合表B.1type子系統(tǒng)或設(shè)備String是告警類型，應(yīng)符合表C.1content告警描述String是告警內(nèi)容描述eventstatus動(dòng)作名稱String是動(dòng)作名稱isconfirm是否確認(rèn)String是true已確認(rèn),false未確認(rèn)pointId告警標(biāo)識(shí)String是由告警發(fā)送端生成的告警ID訂閱實(shí)時(shí)告警（消息隊(duì)列方式）消息隊(duì)列方式只支持全量訂閱，應(yīng)用端按需處理。接口定義如表71所示，消息隊(duì)列方式時(shí)，只需要按需訂閱相關(guān)主題，可以使用通配的方式訂閱一組設(shè)備的告警，公共組件服務(wù)端定時(shí)或按變化向消息隊(duì)列發(fā)布實(shí)時(shí)告警，應(yīng)用按訂閱獲取告警，數(shù)據(jù)遵循7.2中關(guān)于返回體的定義，其body定義如表72所示，其中Warn的結(jié)構(gòu)如表73所示。表71訂閱實(shí)時(shí)告警（消息隊(duì)列方式）接口定義請(qǐng)求方法消息隊(duì)列TOPICT_DC_MQ_ALARM協(xié)議應(yīng)用消息隊(duì)列組件SDK，deviceId為設(shè)備編碼，支持通配符模式表72訂閱實(shí)時(shí)告警（消息隊(duì)列方式）成功時(shí)返回體body定義屬性名稱類型描述warns告警列表List<Warn>查詢到的告警列表表73訂閱實(shí)時(shí)告警（消息隊(duì)列方式）返回?cái)?shù)據(jù)Warn定義屬性名稱類型是否必選描述time時(shí)間String是告警發(fā)生時(shí)間，格式要求為：yyyy-MM-ddHH:mm:ss.SSSsystemid主機(jī)String是所屬主機(jī)redundantsystem系統(tǒng)String是所屬系統(tǒng)deviceId所屬設(shè)備String是告警相關(guān)設(shè)備IDlevel告警級(jí)別Int是應(yīng)符合表B.1type子系統(tǒng)或設(shè)備String是告警類型，應(yīng)符合表C.1content告警描述String是告警內(nèi)容描述eventstatus動(dòng)作名稱String是動(dòng)作名稱isconfirm是否確認(rèn)String是true已確認(rèn),false未確認(rèn)pointId告警標(biāo)識(shí)String是由告警發(fā)送端生成的告警ID請(qǐng)求歷史告警公共組件支持應(yīng)用查詢歷史告警，并支持簡(jiǎn)單的篩選。接口定義如表74所示，應(yīng)遵循7.2中消息頭部、請(qǐng)求體、返回體的相關(guān)定義。請(qǐng)求體中body數(shù)據(jù)的定義如表75所示，其中conditions定義如表76所示。請(qǐng)求成功時(shí)，返回體中body定義如表77所示，其中Warn的結(jié)構(gòu)如表78所示，請(qǐng)求失敗時(shí)，返回體中body定義為空。表74請(qǐng)求歷史告警接口定義請(qǐng)求方法POST請(qǐng)求地址alarm-service/warn/history協(xié)議應(yīng)用http(s)表75請(qǐng)求歷史告警請(qǐng)求體body定義屬性名稱類型是否必選描述startTime開始時(shí)間String是開始時(shí)間（含），格式要求為：yyyy-MM-ddHH:mm:ss.SSSendTime結(jié)束時(shí)間String是結(jié)束時(shí)間（不含），格式要求為：yyyy-MM-ddHH:mm:ss.SSSpageNum當(dāng)前頁碼數(shù)Int否查詢的頁碼數(shù)pageSize每頁顯示條數(shù)Int否每頁返回條目數(shù)conditions過濾條件Conditions是用于篩選告警數(shù)據(jù)表76請(qǐng)求歷史告警請(qǐng)求參數(shù)Conditions定義屬性名稱類型是否必選描述level告警級(jí)別String否應(yīng)符合表B.1，支持多個(gè)等級(jí)過濾，英文分號(hào)分隔,例如“0;1;2”redundantsystem系統(tǒng)Char否系統(tǒng)：A、B、C，eventactive值班備用Int否1值班、0備用systemid主機(jī)String否支持通配符*和多個(gè)關(guān)鍵字，多個(gè)關(guān)鍵字之間用;分隔deviceId設(shè)備String否告警相關(guān)設(shè)備ID多個(gè)設(shè)備ID之間用英文;分隔type子系統(tǒng)類型String是類型：“監(jiān)控”/“輔控”/“高級(jí)應(yīng)用”分別表示監(jiān)控、輔控告警和高級(jí)應(yīng)用告警content告警描述String否支持通配符*和多個(gè)關(guān)鍵字，多個(gè)關(guān)鍵字之間用;分隔eventstatus動(dòng)作名稱String否支持通配符*和多個(gè)關(guān)鍵字，多個(gè)關(guān)鍵字之間用;分隔isconfirm消息狀態(tài)String否true已確認(rèn),false未確認(rèn)pointid告警事件idString否支持通配符*和多個(gè)關(guān)鍵字，多個(gè)關(guān)鍵字之間用;分隔表77請(qǐng)求歷史告警成功時(shí)返回體body定義屬性名稱類型是否必選描述data告警列表List<Warn>是查詢到的告警列表,列表按照時(shí)間降序排列，最新的告警排在數(shù)組前部total返回告警數(shù)Int否返回告警總數(shù)，分頁查詢時(shí)返回表78請(qǐng)求歷史告警返回?cái)?shù)據(jù)Warn定義屬性名稱類型是否必選描述time時(shí)間String是告警發(fā)生時(shí)間，格式要求為：yyyy-MM-ddHH:mm:ss.SSSsystemid主機(jī)String是所屬主機(jī)redundantsystem系統(tǒng)String是所屬系統(tǒng)eventactive備用Int是1值班、0備用deviceId所屬設(shè)備String是告警相關(guān)設(shè)備IDlevel告警級(jí)別Int是告警級(jí)別，應(yīng)符合表B.1type子系統(tǒng)類型String是類型：“監(jiān)控”/“輔控”/“高級(jí)應(yīng)用”分別表示監(jiān)控、輔控告警和高級(jí)應(yīng)用告警content告警描述String是告警內(nèi)容描述eventstatus動(dòng)作名稱String是動(dòng)作名稱isconfirm是否確認(rèn)String是true已確認(rèn),false未確認(rèn)pointId告警標(biāo)識(shí)String是由告警發(fā)送端生成的告警IDid告警主鍵idString是告警主鍵id查詢未復(fù)歸事件公共組件支持應(yīng)用查詢未復(fù)歸事件列表，并支持按條件篩選。接口定義如表79所示，應(yīng)遵循7.2中消息頭部、請(qǐng)求體、返回體的相關(guān)定義。請(qǐng)求體中body數(shù)據(jù)的定義如表80所示，其中Conditions定義如表81所示。請(qǐng)求成功時(shí)，返回體中body定義如表82所示，其中Warn的結(jié)構(gòu)如表83所示，請(qǐng)求失敗時(shí)，返回體中body定義為空。表79查詢未復(fù)歸事件接口定義請(qǐng)求方法POST請(qǐng)求地址/alarm-service/realdata/getM2FaultList協(xié)議應(yīng)用http(s)表80查詢未復(fù)歸事件請(qǐng)求體body定義屬性名稱類型是否必選描述startTime開始時(shí)間String是開始時(shí)間（含），格式要求為：yyyy-MM-ddHH:mm:ss.SSSendTime結(jié)束時(shí)間String是結(jié)束時(shí)間（不含），格式要求為：yyyy-MM-ddHH:mm:ss.SSSconditions過濾條件Conditions是用于篩選告警數(shù)據(jù)表81查詢未復(fù)歸事件請(qǐng)求參數(shù)Conditions定義屬性名稱類型是否必選描述level告警級(jí)別String否應(yīng)符合表B.1，支持多個(gè)等級(jí)過濾，英文分號(hào)分隔,例如“0;1;2”redundantsystem系統(tǒng)Char否系統(tǒng)：A、B、C，eventactive值班備用Int否1值班、0備用systemid主機(jī)String否支持通配符*和多個(gè)關(guān)鍵字，多個(gè)關(guān)鍵字之間用;分隔deviceId設(shè)備String告警相關(guān)設(shè)備ID多個(gè)設(shè)備ID之間用英文;分隔type子系統(tǒng)類型String是類型：“監(jiān)控”/“輔控”/“高級(jí)應(yīng)用”分別表示監(jiān)控、輔控告警和高級(jí)應(yīng)用告警content告警描述String否支持通配符*和多個(gè)關(guān)鍵字，多個(gè)關(guān)鍵字之間用;分隔eventstatus動(dòng)作名稱String否支持通配符*和多個(gè)關(guān)鍵字，多個(gè)關(guān)鍵字之間用;分隔isconfirm消息狀態(tài)String否true已確認(rèn),false未確認(rèn)pointid告警事件idString否支持通配符*和多個(gè)關(guān)鍵字，多個(gè)關(guān)鍵字之間用;分隔表82查詢未復(fù)歸事件成功時(shí)返回體body定義屬性名稱類型描述data告警列表List<Warn>查詢到的告警列表表83查詢未復(fù)歸事件返回?cái)?shù)據(jù)Warn定義屬性名稱類型是否必選描述time時(shí)間String是告警發(fā)生時(shí)間，格式要求為：yyyy-MM-ddHH:mm:ss.SSSsystemid主機(jī)String是所屬主機(jī)redundantsystem系統(tǒng)String是所屬系統(tǒng)eventactive備用Int是1值班、0備用deviceId所屬設(shè)備String是告警相關(guān)設(shè)備IDlevel告警級(jí)別Int是告警級(jí)別，應(yīng)符合表B.1type子系統(tǒng)類型String是類型：“監(jiān)控”/“輔控”/“高級(jí)應(yīng)用”分別表示監(jiān)控、輔控告警和高級(jí)應(yīng)用告警content告警描述String是告警內(nèi)容描述eventstatus動(dòng)作名稱String是動(dòng)作名稱isconfirm是否確認(rèn)String是true已確認(rèn),false未確認(rèn)pointId告警標(biāo)識(shí)string是由告警發(fā)送端生成的告警ID推送應(yīng)用故障告警公共組件支持接收應(yīng)用發(fā)送的分析故障告警，公共組件負(fù)責(zé)處理和存儲(chǔ)。接口定義如表84所示，應(yīng)遵循7.2中消息頭部、請(qǐng)求體、返回體的相關(guān)定義。請(qǐng)求體中body數(shù)據(jù)的定義如表85所示，其中Warn的結(jié)構(gòu)如表86所示，Alarm的結(jié)構(gòu)如表87所示，Report的結(jié)構(gòu)如表88所示。請(qǐng)求成功時(shí)，返回告警主鍵id列表，返回體中body定義如表89所示，請(qǐng)求失敗時(shí)，返回體中body定義為空。表84推送應(yīng)用故障告警接口定義請(qǐng)求方法POST請(qǐng)求地址alarm-service/appalarm/sendalarm協(xié)議應(yīng)用http(s)表85推送應(yīng)用故障告警請(qǐng)求體body定義屬性名稱類型是否必選描述warns告警列表List<Warn>是存儲(chǔ)的告警列表表86推送應(yīng)用故障告警請(qǐng)求參數(shù)Warn定義屬性名稱類型是否必選描述alarm告警內(nèi)容Alarm是report簡(jiǎn)報(bào)內(nèi)容Report否表87推送應(yīng)用故障告警請(qǐng)求參數(shù)Alarm定義屬性名稱類型是否必選描述client_id系統(tǒng)標(biāo)識(shí)String是發(fā)送告警的系統(tǒng)標(biāo)識(shí)time告警時(shí)間String是開始時(shí)間（含），格式要求為：yyyy-MM-ddHH:mm:ss.SSSareaid區(qū)域IDString否區(qū)域mridareaname區(qū)域名稱String否stationid電站IDString否電站mridstationname電站名稱String否deviceid設(shè)備IDString否設(shè)備mriddevicename設(shè)備名稱String否partid部件IDString否部件mridpartname部件名稱String否type子類型String否各系統(tǒng)內(nèi)部分類eventlevel告警級(jí)別Int是應(yīng)符合表B.1eventdesc事件描述String是eventaction動(dòng)作名稱String是isreport是否擁有簡(jiǎn)報(bào)Boolean否表88推送應(yīng)用故障告警請(qǐng)求參數(shù)Report定義屬性名稱類型是否必選描述client_id系統(tǒng)標(biāo)識(shí)String是發(fā)送告警的系統(tǒng)標(biāo)識(shí)time告警時(shí)間String是開始時(shí)間（含），格式要求為：yyyy-MM-ddHH:mm:ss.SSSeventdesc事件描述String否eventreason告警原因String否eventhandle處理辦法String否analysisdata相關(guān)數(shù)據(jù)String否analysiswave相關(guān)波形String否波形url地址analysispic相關(guān)圖像String否圖像url地址analysisvideo相關(guān)視頻String否視頻url地址analysisreport相關(guān)報(bào)告String否報(bào)告url地址alarmRect報(bào)警位置區(qū)域String否獲得人員報(bào)警圖像位置controllingArea管控區(qū)域String否管控區(qū)域位置信息表89推送應(yīng)用故障告警成功時(shí)返回體body定義屬性名稱類型描述id信號(hào)值列表List<String>成功推送的告警id列表更新故障簡(jiǎn)報(bào)接口公共組件支持更新應(yīng)用發(fā)送的故障簡(jiǎn)報(bào)，公共組件負(fù)責(zé)處理和存儲(chǔ)。接口定義如表90所示，應(yīng)遵循7.2中消息頭部、請(qǐng)求體、返回體的相關(guān)定義。請(qǐng)求體中body數(shù)據(jù)的定義如表91所示，其中Warn的結(jié)構(gòu)如表92所示，report的結(jié)構(gòu)如表93所示。請(qǐng)求成功/失敗時(shí)，返回體中body定義為空。表90更新故障簡(jiǎn)報(bào)接口接口定義請(qǐng)求方法POST請(qǐng)求地址alarm-service/appalarm/sendreport協(xié)議應(yīng)用http(s)表91更新故障簡(jiǎn)報(bào)接口請(qǐng)求體body定義屬性名稱類型描述reports告警列表List<Report>存儲(chǔ)的告警列表表92更新故障簡(jiǎn)報(bào)接口請(qǐng)求參數(shù)Report定義屬性名稱類型是否必選描述report簡(jiǎn)報(bào)內(nèi)容Warn是表93更新故障簡(jiǎn)報(bào)接口請(qǐng)求參數(shù)Warn定義屬性名稱類型是否必選描述id告警idString是與推送返回的告警id一致cliend_id系統(tǒng)標(biāo)識(shí)String是發(fā)送告警的系統(tǒng)標(biāo)識(shí)time告警時(shí)間String是開始時(shí)間（含），格式要求為：yyyy-MM-ddHH:mm:ss.SSSeventdesc事件描述String否eventreason告警原因String否eventhandle處理辦法String否analysisdata相關(guān)數(shù)據(jù)String否analysiswave相關(guān)波形String否波形url地址analysispic相關(guān)圖像String否圖像url地址analysisvideo相關(guān)視頻String否視頻url地址analysisreport相關(guān)報(bào)告String否報(bào)告url地址alarmRect報(bào)警位置區(qū)域String否獲得人員報(bào)警圖像位置controllingArea管控區(qū)域String否管控區(qū)域位置信息查詢應(yīng)用故障告警公共組件支持應(yīng)用查詢歷史告警，并支持簡(jiǎn)單的篩選。接口定義如表94所示，應(yīng)遵循7.2中消息頭部、請(qǐng)求體、返回體的相關(guān)定義。請(qǐng)求體中body數(shù)據(jù)的定義如表95所示，其中conditions定義如表96所示，請(qǐng)求成功時(shí)，返回體中body定義如表97所示，其中Warn的結(jié)構(gòu)如表98所示。請(qǐng)求失敗時(shí)，返回體中body定義為空。表94查詢應(yīng)用故障告警接口定義請(qǐng)求方法POST請(qǐng)求地址alarm-service/appalarm/history協(xié)議應(yīng)用http(s)表95查詢應(yīng)用故障告警請(qǐng)求體body定義屬性名稱類型是否必選描述startTime開始時(shí)間String是開始時(shí)間（含），格式要求為：yyyy-MM-ddHH:mm:ss.SSSendTime結(jié)束時(shí)間String是結(jié)束時(shí)間（不含），格式要求為：yyyy-MM-ddHH:mm:ss.SSSpageNum當(dāng)前頁碼數(shù)Int否查詢的頁碼數(shù)pageSize每頁顯示條數(shù)Int否每頁返回條目數(shù)conditions過濾條件Conditions是用于篩選告警數(shù)據(jù)表96查詢應(yīng)用故障告警Conditions定義屬性名稱類型是否必選描述client_id應(yīng)用IDString否信息來源的系統(tǒng)IDareaid區(qū)域IDString否信息來源的區(qū)域IDdeviceid設(shè)備IDList<String>否訂閱設(shè)備的編號(hào)列表eventlevel告警級(jí)別List<Int>否告警級(jí)別列表，對(duì)告警級(jí)別進(jìn)行過濾,應(yīng)符合表B.1type告警類型List<String>否告警類型列表，對(duì)告警類型進(jìn)行過濾keywords關(guān)鍵詞List<String>否關(guān)鍵詞列表，對(duì)告警內(nèi)容進(jìn)行模糊匹配表97查詢應(yīng)用故障告警成功時(shí)返回體body定義屬性名稱類型描述data告警列表List<Warn>查詢到的告警列表total返回告警總數(shù)Int返回告警總數(shù)，分頁查詢時(shí)返回表98查詢應(yīng)用故障告警返回?cái)?shù)據(jù)Warn定義屬性名稱類型是否必選描述idIDString是告警id唯一標(biāo)識(shí)client_id系統(tǒng)標(biāo)識(shí)String是發(fā)送告警的系統(tǒng)標(biāo)識(shí)time告警時(shí)間String是格式要求為：yyyy-MM-ddHH:mm:ss.SSSareaid區(qū)域IDString是區(qū)域mridareaname區(qū)域名稱String是stationid電站IDString是電站mridstationname電站名稱String是deviceid設(shè)備IDString是設(shè)備mriddevicename設(shè)備名稱String是partid部件IDString是部件mridpartname部件名稱String是type子類型String是各系統(tǒng)內(nèi)部分類eventlevel告警級(jí)別Int是應(yīng)符合表B.1eventdesc事件描述String是eventaction動(dòng)作名稱String是isconfirm是否確認(rèn)String是true已確認(rèn),false未確認(rèn)confirmtime確認(rèn)時(shí)間String是格式要求為：yyyy-MM-ddHH:mm:ss.SSSconfirmman確認(rèn)人String是isreport是否擁有簡(jiǎn)報(bào)String是查詢應(yīng)用故障簡(jiǎn)報(bào)公共組件支持應(yīng)用查詢故障簡(jiǎn)報(bào)，并支持簡(jiǎn)單的篩選。接口定義如表99所示，應(yīng)遵循7.2中消息頭部、請(qǐng)求體、返回體的相關(guān)定義。請(qǐng)求體中body數(shù)據(jù)的定義如表100所示。請(qǐng)求成功時(shí)，返回體中body定義如表101所示，其中report的結(jié)構(gòu)如表102所示。請(qǐng)求失敗時(shí)，返回體中body定義為空。表99查詢應(yīng)用故障簡(jiǎn)報(bào)接口定義請(qǐng)求方法POST請(qǐng)求地址alarm-service/appalarm/getreport協(xié)議應(yīng)用http(s)表100查詢應(yīng)用故障簡(jiǎn)報(bào)請(qǐng)求體body定義屬性名稱類型是否必選描述idIDString是告警事件IDtime時(shí)間String否格式要求為：yyyy-MM-ddHH:mm:ss.SSS表101查詢應(yīng)用故障簡(jiǎn)報(bào)成功時(shí)返回體body定義屬性名稱類型描述report告警列表Report表102查詢應(yīng)用故障簡(jiǎn)報(bào)返回?cái)?shù)據(jù)Report定義屬性名稱類型是否必選描述idIDLong是uuid唯一標(biāo)識(shí)client_id系統(tǒng)標(biāo)識(shí)String是發(fā)送告警的系統(tǒng)標(biāo)識(shí)time告警時(shí)間String是格式要求為：yyyy-MM-ddHH:mm:ss.SSSeventdesc事件描述String是eventreason告警原因String是eventhandle處理辦法String是analysisdata相關(guān)數(shù)據(jù)String是analysiswave相關(guān)波形String是波形url地址analysispic相關(guān)圖像String是圖像url地址analysisvideo相關(guān)視頻String是視頻url地址analysisreport相關(guān)報(bào)告String是報(bào)告url地址alarmRect報(bào)警位置區(qū)域String否獲得人員報(bào)警圖像位置controllingArea管控區(qū)域String否管控區(qū)域位置信息推送告警處理結(jié)果告警處理后向平臺(tái)消息中間件推送處理結(jié)果，供其他第三方應(yīng)用訂閱。接口定義如表103所示，應(yīng)遵循7.2中消息頭部、請(qǐng)求體、返回體的相關(guān)定義。請(qǐng)求體中body數(shù)據(jù)的定義如表104所示，其中info的結(jié)構(gòu)如表105所示，請(qǐng)求成功/失敗時(shí)，返回體中body定義為空。表103推送告警處理結(jié)果定義請(qǐng)求方法POST請(qǐng)求地址alarm-service/appalarm/sendconfirminfo協(xié)議應(yīng)用http(s)表104推送告警處理結(jié)果請(qǐng)求體body定義屬性名稱類型是否必選描述info告警內(nèi)容Info是表105推送告警處理結(jié)果Info定義屬性名稱類型是否必選描述cliend_id系統(tǒng)標(biāo)識(shí)String是發(fā)送告警的系統(tǒng)標(biāo)識(shí)alarmid告警idString是告警的唯一標(biāo)識(shí)time處理的timeString是開始時(shí)間（含），格式要求為：yyyy-MM-ddHH:mm:ss.SSSman處理人String否handle處理內(nèi)容String否0訂閱告警處理結(jié)果告警處理后向平臺(tái)消息中間件推送處理結(jié)果后，可以通過消息訂閱的方式，向消息中間件訂閱處理結(jié)果消息。接口定義如表106所示，消息隊(duì)列方式時(shí)，只需要按需訂閱相關(guān)主題，可以使用通配的方式訂閱一組設(shè)備的告警處理結(jié)果，返回?cái)?shù)據(jù)如表107所示。表106訂閱告警處理結(jié)果接口定義端口和地址消息隊(duì)列TOPICT_DC_MQ_ALARM_CONFIRM協(xié)議應(yīng)用消息隊(duì)列組件SDK表107訂閱告警處理結(jié)果成功時(shí)返回體body定義屬性名稱類型描述cliend_id系統(tǒng)標(biāo)識(shí)String發(fā)送告警的系統(tǒng)標(biāo)識(shí)alarmid告警idString告警的唯一標(biāo)識(shí)time處理的timeString開始時(shí)間（含），格式要求為：yyyy-MM-ddHH:mm:ss.SSSman處理人Stringhandle處理內(nèi)容String1推送設(shè)備狀態(tài)接口公共組件支持接收應(yīng)用發(fā)送的設(shè)備狀態(tài)，公共組件負(fù)責(zé)處理和存儲(chǔ)。接口定義如表108所示，應(yīng)遵循7.2中消息頭部、請(qǐng)求體、返回體的相關(guān)定義。請(qǐng)求體中body數(shù)據(jù)的定義如表109所示，其中Data的結(jié)構(gòu)如表110所示。請(qǐng)求成功/失敗時(shí)，返回體中body定義為空。表108推送設(shè)備狀態(tài)接口定義請(qǐng)求方法POST請(qǐng)求地址/alarm-service/equipment/sendstatus協(xié)議應(yīng)用http(s)表109推送設(shè)備狀態(tài)請(qǐng)求體body定義屬性名稱類型是否必選描述data請(qǐng)求內(nèi)容List<Data>是表110推送設(shè)備狀態(tài)請(qǐng)求參數(shù)Data定義屬性名稱類型是否必選描述cliend_id系統(tǒng)標(biāo)識(shí)String是發(fā)送告警的系統(tǒng)標(biāo)識(shí)equipment_id設(shè)備idString是設(shè)備資產(chǎn)idequipment_type設(shè)備類型Int是0：設(shè)備，1：部件status設(shè)備狀態(tài)Int是設(shè)備當(dāng)前狀態(tài)(0：正常，1：異常，2：嚴(yán)重)2查詢?cè)O(shè)備狀態(tài)接口公共組件支持查詢?cè)O(shè)備狀態(tài)。接口定義如表111所示，應(yīng)遵循7.2中消息頭部、請(qǐng)求體、返回體的相關(guān)定義。請(qǐng)求體中body數(shù)據(jù)的定義如表112所示。請(qǐng)求成功時(shí)，返回體中body定義如表113所示，其中Status的結(jié)構(gòu)如表114所示。請(qǐng)求失敗時(shí)，返回體中body定義為空。表111查詢?cè)O(shè)備狀態(tài)接口接口定義請(qǐng)求方法POST請(qǐng)求地址/alarm-service/equipment/getstatus協(xié)議應(yīng)用http(s)表112查詢?cè)O(shè)備狀態(tài)接口請(qǐng)求體body定義屬性名稱類型是否必選描述equipment_id設(shè)備idList<String>是需要設(shè)備資產(chǎn)id數(shù)組表113查詢?cè)O(shè)備狀態(tài)接口成功時(shí)返回體body定義屬性名稱類型是否必選描述status請(qǐng)求內(nèi)容List<Status>是表114查詢?cè)O(shè)備狀態(tài)接口返回?cái)?shù)據(jù)Status定義屬性名稱類型是否必選描述equipment_id設(shè)備idString是設(shè)備資產(chǎn)idequipment_type設(shè)備類型Int是0：設(shè)備，1：部件status設(shè)備狀態(tài)Int是設(shè)備當(dāng)前狀態(tài)(0：正常，1：異常，2：嚴(yán)重)cliend_id系統(tǒng)標(biāo)識(shí)String是發(fā)送告警的系統(tǒng)標(biāo)識(shí)updatetime狀態(tài)更新時(shí)間String是平臺(tái)收到狀態(tài)推送的時(shí)間，格式要求為：yyyy-MM-ddHH:mm:ss.SSS3高級(jí)應(yīng)用告警確認(rèn)公共組件支持應(yīng)用高級(jí)應(yīng)用告警確認(rèn)。接口定義如表115所示，應(yīng)遵循7.2中消息頭部、請(qǐng)求體、返回體的相關(guān)定義。請(qǐng)求體中body數(shù)據(jù)的定義如表116所示。請(qǐng)求成功/失敗時(shí)，返回體中body定義為空。表115高級(jí)應(yīng)用告警確認(rèn)接口定義請(qǐng)求方法POST請(qǐng)求地址/alarm-service/appalarmconfirm協(xié)議應(yīng)用http(s)表116高級(jí)應(yīng)用告警確認(rèn)請(qǐng)求體body定義屬性名稱類型是否必選描述attrOid告警idString是高級(jí)應(yīng)用告警主鍵idattrTime告警時(shí)間String是高級(jí)應(yīng)用告警時(shí)間,格式要求為：yyyy-MM-ddHH:mm:ss.SSSconfirmhandle處理意見String否處理結(jié)果confirmman處理人String是處理人confirmtime告警處理時(shí)間String否告警處理時(shí)間,格式樣例"yyyy-MM-ddHH:mm:ss"4系統(tǒng)事件告警確認(rèn)公共組件支持應(yīng)用監(jiān)控系統(tǒng)事件告警確認(rèn)。接口定義如表117所示，應(yīng)遵循7.2中消息頭部、請(qǐng)求體、返回體的相關(guān)定義。請(qǐng)求體中body數(shù)據(jù)的定義如表118所示。請(qǐng)求成功/失敗時(shí)，返回體中body定義為空。表117系統(tǒng)事件告警確認(rèn)接口定義請(qǐng)求方法POST請(qǐng)求地址/alarm-service/owsalarmconfirm協(xié)議應(yīng)用http(s)表118系統(tǒng)事件告警確認(rèn)請(qǐng)求體body定義屬性名稱類型是否必選描述attrOid告警idString是監(jiān)控告警的主鍵idconfirmTime處理時(shí)間String是監(jiān)控告警處理時(shí)間,格式要求為：yyyy-MM-ddHH:mm:ss.SSSconfirmhandle處理意見String否處理結(jié)果confirmman處理人String是處理人pointid監(jiān)控告警事件idString是監(jiān)控告警事件id7.3.6文件數(shù)據(jù)管理查詢文件數(shù)據(jù)公共組件支持應(yīng)用查詢文件數(shù)據(jù)，并支持簡(jiǎn)單的篩選。接口定義如表119所示，應(yīng)遵循7.2中消息頭部、請(qǐng)求體、返回體的相關(guān)定義。請(qǐng)求體中body數(shù)據(jù)的定義如表120所示，其中conditions定義如表121所示。請(qǐng)求成功時(shí)，返回體中body定義如表122所示，其中File的結(jié)構(gòu)如表123所示。請(qǐng)求失敗時(shí)，返回體中body定義為空。表119查詢文件數(shù)據(jù)接口定義請(qǐng)求方法POST請(qǐng)求地址filedata-service/file/list協(xié)議應(yīng)用http(s)全部采用全部采用表120查詢文件數(shù)據(jù)請(qǐng)求體body定義屬性名稱類型是否必選描述conditions過濾條件conditions是用于篩選文件數(shù)據(jù)表121查詢文件數(shù)據(jù)請(qǐng)求參數(shù)Conditions定義屬性名稱類型是否必選描述deviceId設(shè)備IDList<String>是設(shè)備的編號(hào)列表type文件類型List<String>否文件類型列表startTime開始時(shí)間String是開始時(shí)間（含），格式要求為：yyyy-MM-ddHH:mm:ss.SSSendTime結(jié)束時(shí)間String是結(jié)束時(shí)間（不含），格式要求為：yyyy-MM-ddHH:mm:ss.SSSkeywords關(guān)鍵詞List<String>否關(guān)鍵詞列表，對(duì)文件名進(jìn)行模糊匹配，關(guān)鍵詞之間為或關(guān)系表122查詢文件數(shù)據(jù)成功時(shí)返回體body定義屬性名稱類型描述files文件列表List<File>查詢到的文件信息列表表123查詢文件數(shù)據(jù)返回?cái)?shù)據(jù)File定義屬性名稱類型描述id文件IDString系統(tǒng)自編文件唯一IDtime時(shí)間String文件創(chuàng)建時(shí)間，格式要求為：yyyy-MM-ddHH:mm:ss.SSSname文件名稱String文件名稱hash檢驗(yàn)碼String基于sha256或者md5算法計(jì)算的文件校驗(yàn)碼deviceId設(shè)備編碼String文件來源設(shè)備編碼type文件類型String文件格式類型，如scd/xml/json/wave/png等size字節(jié)數(shù)Long文件字節(jié)大小文件下載公共組件應(yīng)支持根據(jù)文件標(biāo)識(shí)號(hào)碼下載或文件名下載方式。根據(jù)文件標(biāo)識(shí)號(hào)碼下載方式接口定義如表124所示，應(yīng)遵循7.2中消息頭部相關(guān)定義，請(qǐng)求地址中的id為設(shè)備的唯一索引編碼。根據(jù)文件名下載方式接口定義如表125所示，應(yīng)遵循7.2中消息頭部相關(guān)定義，請(qǐng)求地址中的name為文件的文件名。表124文件下載（根據(jù)文件標(biāo)識(shí)號(hào)碼）接口定義請(qǐng)求方法GET請(qǐng)求地址/file/download/deviceId/{id}協(xié)議應(yīng)用http(s)表125文件下載（根據(jù)文件名）接口定義請(qǐng)求方法GET請(qǐng)求地址/file/download/name/{name}協(xié)議應(yīng)用http(s)文件上傳公共組件支持上傳文件。接口定義如表126所示，應(yīng)遵循7.2中消息頭部相關(guān)定義，請(qǐng)求地址中的deviceId為文件來源設(shè)備編碼，請(qǐng)求成功時(shí)，返回體中body定義如表127所示。請(qǐng)求失敗時(shí)，返回體