(高清版)GBT 42569-2023 工業(yè)互聯(lián)網(wǎng)平臺 開放應用編程接口功能要求

工業(yè)互聯(lián)網(wǎng)平臺開放應用編程接口功能要求2023-05-23發(fā)布國家市場監(jiān)督管理總局國家標準化管理委員會 I 2規(guī)范性引用文件 3術語和定義 4開放應用編程接口 24.1接口框架 4.2工業(yè)應用接口 4.3工業(yè)裝備接口 4.4工業(yè)互聯(lián)網(wǎng)平臺間接口 5工業(yè)應用接口要求 5.1資源管理類接口 5.2數(shù)據(jù)操作類接口 5.3安全輔助類接口 35.4應用管理類接口 5.5支撐服務類接口 5.6運維管理類接口 46工業(yè)裝備接口要求 6.1接入管理類接口 6.2監(jiān)控管理類接口 6.3數(shù)據(jù)管理類接口 56.4安全輔助類接口 6.5運維管理類接口 7工業(yè)互聯(lián)網(wǎng)平臺間接口要求 57.1互通管理類接口 57.2數(shù)據(jù)操作類接口 7.3安全輔助類接口 7.4運維管理類接口 參考文獻 I本文件按照GB/T1.1—2020《標準化工作導則第1部分：標準化文件的結構和起草規(guī)則》的規(guī)定起草。請注意本文件的某些內(nèi)容可能涉及專利。本文件的發(fā)布機構不承擔識別專利的責任。本文件由全國信息技術標準化技術委員會(SAC/TC28)提出并歸口。本文件起草單位：中國電子技術標準化研究院、網(wǎng)絡通信與安全紫金山實驗室、浪潮云信息技術股份公司、合肥斯歐互聯(lián)科技股份有限公司、國電南京自動化股份有限公司、江蘇方天電力技術有限公司、山東未來集團有限公司、中汽研汽車工業(yè)工程(天津)有限公司、江蘇亨通智能裝備有限公司、四川長虹電子控股集團有限公司、襄陽光瑞汽車零部件有限公司、甌星機械設備有限公司、貴州航天云網(wǎng)科技有限公司、中航電測儀器(西安)有限公司、北京力控元通科技有限公司、潤聯(lián)智能科技股份有限公司、濰坊北大青鳥華光照排有限公司、東南大學、深圳華制智能制造技術有限公司、青島孚鼎泰智能技術有限公司、貴州大學、青島中瑞汽車服務有限公司、甘肅銀光化學工業(yè)集團有限公司、中移(蘇州)軟件技術有限公司、天津融和互聯(lián)高新技術股份有限公司、蘇州協(xié)同創(chuàng)新智能制造裝備有限公司、安徽邁立信息科技有限公司、深圳融昕醫(yī)療科技有限公司、北京華勝天成科技股份有限公司、卡奧斯工業(yè)智能研究院(青島)有限公司。本文件主要起草人：陳志峰、王志鵬、陳平平、張敏、王照陽、于萬欽、尹飛、徐小傳、韋安壘、門峰、楊凌崗。1工業(yè)互聯(lián)網(wǎng)平臺開放應用編程接口功能要求1范圍本文件確立了工業(yè)互聯(lián)網(wǎng)平臺開放應用編程接口框架，規(guī)定了接口的功能要求。本文件適用于工業(yè)互聯(lián)網(wǎng)平臺或工業(yè)應用的開發(fā)方、使用方及第三方組織對工業(yè)互聯(lián)網(wǎng)平臺和接口開展設計、開發(fā)及測試評估工作。2規(guī)范性引用文件下列文件中的內(nèi)容通過文中的規(guī)范性引用而構成本文件必不可少的條款。其中，注日期的引用文件，僅該日期對應的版本適用于本文件；不注日期的引用文件，其最新版本(包括所有的修改單)適用于本文件。GB/T11457—2006信息技術軟件工程術語3術語和定義GB/T11457—2006界定的以及下列術語和定義適用于本文件。面向制造業(yè)數(shù)字化、網(wǎng)絡化、智能化需求，構建基于云平臺的海量數(shù)據(jù)采集、匯聚和分析服務，支撐制造資源廣泛連接、彈性供給、高效配置的系統(tǒng)。開放應用編程接口openapplicationprogramminginterface提供應用軟件、裝備和互聯(lián)網(wǎng)平臺間的操作、接入能力，為互聯(lián)網(wǎng)平臺的使用資源實現(xiàn)信息融合、信息交換和信息共享的接口。數(shù)據(jù)模型datamodel一種針對工業(yè)裝備采集數(shù)據(jù)配置的模型。注：通過配置的數(shù)據(jù)模型完成數(shù)據(jù)的清洗、轉換、加工。模型一般由工藝參數(shù)、工況參數(shù)、能耗參數(shù)構成。處理模型processingmodel實現(xiàn)工業(yè)裝備的數(shù)據(jù)采集，對采集數(shù)據(jù)按照模型中配置的信息實現(xiàn)邏輯運算，通過邏輯運算完成數(shù)據(jù)清洗、數(shù)據(jù)加工、感知計算、事件告警和規(guī)則計算處理。工業(yè)數(shù)據(jù)存儲和計算、工業(yè)協(xié)議解析和轉換的軟硬件系統(tǒng)或裝置，用于建立工業(yè)裝備與工業(yè)互聯(lián)網(wǎng)平臺間的連接。24開放應用編程接口4.1接口框架工業(yè)互聯(lián)網(wǎng)平臺開放應用編程接口指用于管控工業(yè)應用、工業(yè)裝備，并為其他工業(yè)互聯(lián)網(wǎng)平臺提供能力的接口。開放應用編程接口要求，用于指導開展工業(yè)應用、工業(yè)裝備和工業(yè)互聯(lián)網(wǎng)平臺間的互聯(lián)互通、互操作接口設計、開發(fā)及測試評估工作。開放應用編程接口包括：工業(yè)應用接口、工業(yè)裝備接口和工業(yè)互聯(lián)網(wǎng)平臺間接口。工業(yè)互聯(lián)網(wǎng)平臺開放應用編程接口框架見圖1。其中，工業(yè)應用接口為工業(yè)應用及其開發(fā)者提供了工業(yè)應用開發(fā)過程中所需的資源、數(shù)據(jù)及支撐服務的訪問及操作的能力；工業(yè)裝備接口為工業(yè)裝備及其開發(fā)者提供了工業(yè)裝備的接入、監(jiān)控、配置、運維的能力；工業(yè)互聯(lián)網(wǎng)平臺間接口為工業(yè)應用及其開發(fā)者提供了平臺間互聯(lián)、互通、互操作的能力；“……”為與工業(yè)裝備接口處于同一層級包括如資源與能力接口等在內(nèi)的其他接入工業(yè)互聯(lián)網(wǎng)平臺的接口。工業(yè)應用工業(yè)應用接口工業(yè)互聯(lián)網(wǎng)平臺工業(yè)互聯(lián)錯工業(yè)互聯(lián)網(wǎng)平臺工業(yè)裝備接口……工業(yè)裝備圖1工業(yè)互聯(lián)網(wǎng)平臺開放應用編程接口框架4.2工業(yè)應用接口工業(yè)應用接口應包含：a)資源管理類接口；b)數(shù)據(jù)操作類接口；c)安全輔助類接口；d)應用管理類接口；e)支撐服務類接口；f)運維管理類接口。4.3工業(yè)裝備接口工業(yè)裝備接口應包含：a)接入管理類接口；b)監(jiān)控管理類接口；c)數(shù)據(jù)管理類接口；3d)安全輔助類接口；e)運維管理類接口。4.4工業(yè)互聯(lián)網(wǎng)平臺間接口工業(yè)互聯(lián)網(wǎng)平臺間接口應包含：a)互通管理類接口；b)數(shù)據(jù)操作類接口；c)安全輔助類接口；d)運維管理類接口。5工業(yè)應用接口要求5.1資源管理類接口資源管理類接口應：a)提供對計算資源、存儲資源、網(wǎng)絡資源的申請功能；b)提供對已申請資源的使用功能；c)提供對已注銷資源的釋放功能；d)提供對運行中資源的監(jiān)控功能。5.2數(shù)據(jù)操作類接口數(shù)據(jù)操作類接口應：a)針對不同的數(shù)據(jù)存儲要求，提供全量、增量的寫入功能；b)依據(jù)業(yè)務處理要求，對狀態(tài)變更的數(shù)據(jù)提供逐條、批量的邏輯刪除功能；c)在過程數(shù)據(jù)發(fā)生變更時，提供滿足不同結構數(shù)據(jù)的全量、增量更新功能；d)對各種結構化數(shù)據(jù)、非結構化數(shù)據(jù)和半結構化數(shù)據(jù)的讀取查詢功能；e)針對報表呈現(xiàn)的數(shù)據(jù)要求，提供業(yè)務數(shù)據(jù)的統(tǒng)計分析功能。5.3安全輔助類接口安全輔助類接口應：a)具備驗證用戶真實身份和權限范圍的能力；b)具備訪問速率限制、訪問次數(shù)限制及峰值保護等能力；c)對具有寫入權限的接口，提供驗證輸入、輸出內(nèi)容的能力；d)具備安全審計功能，如，訪問異常檢測能力、接口訪問行為檢測能力等；e)接口鑒權應具備時效性，對于異常訪問應限制最高錯誤次數(shù)。5.4應用管理類接口應用管理類接口應提供：配置和應用發(fā)布；b)應用操作功能，對已創(chuàng)建的應和實例銷毀；c)應用關聯(lián)功能，對應用實例關聯(lián)的數(shù)據(jù)源和服務提供綁定與解除綁定的功能；d)應用監(jiān)控功能，實現(xiàn)對運行的應用進行監(jiān)控，包括運行狀態(tài)、會話控制、異常告警、日志審計和閾值監(jiān)控。45.5支撐服務類接口支撐服務類接口應提供第三方支撐服務的操作能力，支撐服務類接口提供的服務應包括但不限于：a)消息隊列服務支持：b)算法服務支持：1)算法服務實例創(chuàng)建、銷毀和狀態(tài)查詢功能；2)算法服務模型聲明及服務調(diào)用的功能。c)數(shù)據(jù)庫服務支持：1)數(shù)據(jù)庫實例的創(chuàng)建、修改、銷毀的功能；4)實例運行時監(jiān)控的能力，以及配置數(shù)據(jù)集權限的功能。5.6運維管理類接口運維管理類接口：a)應針對已有應用實例，提供備份與遷移、快速恢復、應用重啟等功能；b)應實現(xiàn)應用依賴的各種數(shù)據(jù)結構的數(shù)據(jù)備份，按照時間節(jié)點或業(yè)務要求進行的數(shù)據(jù)恢復功能；c)應按照數(shù)據(jù)存儲時間周期，定期實現(xiàn)數(shù)據(jù)的清理或遷移功能；d)應具備數(shù)據(jù)操作、傳輸日志的記錄功能，并提供數(shù)據(jù)存儲的能力；e)可具備應用實例的異常診斷及其自恢復功能。6工業(yè)裝備接口要求6.1接入管理類接口接入管理類接口應滿足如下要求：a)支持工業(yè)裝備直連接入，包括：1)具備工業(yè)裝備識別能力，提供工業(yè)裝備識別、鑒權功能，根據(jù)預設規(guī)則主動掃描網(wǎng)絡內(nèi)待接入裝備并建立接入連接；2)具備工業(yè)裝備注冊能力，提供工業(yè)裝備鑒權及信息收集功能；3)具備工業(yè)裝備接入復位能力，提供快速恢復前次配置的功能。b)支持工業(yè)裝備網(wǎng)關類產(chǎn)品接入，包括：1)具備工業(yè)裝備網(wǎng)關識別能力，提供工業(yè)裝備網(wǎng)關的識別、鑒權功能，可根據(jù)預設規(guī)則主動掃描工業(yè)裝備網(wǎng)關并建立接入連接；2)具備工業(yè)裝備網(wǎng)關注冊能力，提供工業(yè)裝備網(wǎng)關的鑒權及信息收集功能；3)具備工業(yè)裝備網(wǎng)關接入復位能力，提供快速恢復前次配置的功能。6.2監(jiān)控管理類接口監(jiān)控管理類接口功能包括：a)應支持監(jiān)控工業(yè)裝備的綜合利用信息、故障信息、計劃時間、平均故障間隔期和有效生產(chǎn)數(shù)據(jù)b)應支持監(jiān)控工業(yè)裝備的工況狀態(tài)；5d)應支持監(jiān)控工業(yè)裝備的生產(chǎn)數(shù)據(jù)；e)應支持監(jiān)控工業(yè)裝備的異常信息、報警事件；f)可支持監(jiān)控工業(yè)裝備網(wǎng)絡狀況。6.3數(shù)據(jù)管理類接口數(shù)據(jù)管理類接口功能應：1)具備對于幾何模型、物理特征、數(shù)據(jù)模型和處理模型的建模功能；2)支持模型變更，根據(jù)工業(yè)裝備信息的變化，對幾何模型、物理特征、數(shù)據(jù)模型和處理模型的數(shù)據(jù)進行同步變更；3)支持模型移除，將取消或棄用的模型進行移除操作。1)支持數(shù)據(jù)獲取，獲取裝備的注冊臺賬信息、裝備運行狀態(tài)信息和裝備生產(chǎn)工藝信息；2)支持數(shù)據(jù)解析，提供識別裝備采集數(shù)據(jù)的能力，實現(xiàn)數(shù)據(jù)解析；3)支持數(shù)據(jù)加工，提供支持數(shù)據(jù)采集的邊緣計算能力，基于數(shù)據(jù)模型和處理模型中的配置信息，對已采集的數(shù)據(jù)進行清洗、轉換及規(guī)則感知計算等處理；4)支持數(shù)據(jù)存儲，將經(jīng)加工處理的數(shù)據(jù)寫入工業(yè)互聯(lián)網(wǎng)平臺進行持久化存儲。c)支持命令下發(fā)，包括：1)支持裝備控制，接收裝備運行控制命令，下發(fā)裝備運行控制命令至工業(yè)裝備；2)支持固件升級，為固件程序提供版本升級功能。6.4安全輔助類接口安全輔助類接口功能應包括：a)提供對工業(yè)裝備接入進行身份鑒別的功能；b)提供通信鏈路加密功能，實現(xiàn)對工業(yè)裝備上行數(shù)據(jù)和下行數(shù)據(jù)的安全防護；c)提供非可逆算法生成會話簽名，保障通信通道鏈路中傳輸?shù)男畔⒉槐淮鄹幕蚋`??；d)支持預設通信鏈路的會話時間，降低工業(yè)裝備接口被攻擊/仿冒的風險；e)提供支持工業(yè)裝備終端敏感數(shù)據(jù)的脫敏功能，實現(xiàn)安全啟動和安全能力升級。6.5運維管理類接口運維管理類接口功能包括：a)應支持工業(yè)裝備的工單操作，記錄處理工單的過程信息；b)應支持對工業(yè)裝備采集的數(shù)據(jù)進行定期維護，實現(xiàn)定時、定量的數(shù)據(jù)清理與遷移；c)可支持通過對工業(yè)裝備工況信息的數(shù)據(jù)分析，實現(xiàn)為工業(yè)裝備預測性維護提供數(shù)據(jù)支撐；d)應支持通過對工業(yè)裝備的日常巡檢和點檢，完成對工業(yè)裝備的保護性檢查，記錄排查信息并提供工業(yè)裝備的健康數(shù)據(jù)；e)應支持獲取并管理工業(yè)裝備上存儲的日志信息，實現(xiàn)日志信息的審計維護功能。7工業(yè)互聯(lián)網(wǎng)平臺間接口要求7.1互通管理類接口互通管理類接口應包括：6a)支持工業(yè)互聯(lián)網(wǎng)平臺配置，具備工業(yè)互聯(lián)網(wǎng)平臺間的互聯(lián)操作及配置平臺實例的能力；b)支持服務配置，具備對工業(yè)互聯(lián)網(wǎng)平臺開放服務實現(xiàn)配置調(diào)整的能力；c)具備工業(yè)互聯(lián)網(wǎng)平臺間的網(wǎng)絡診斷功能；d)具備工業(yè)互聯(lián)網(wǎng)平臺間開放服務的訪問功能；e)具備長連接資源的釋放操作，提供應答確認功能。7.2數(shù)據(jù)操作類接口數(shù)據(jù)操作類接口應包括：a)支持通過符合相關規(guī)定的請求/響應模式實現(xiàn)同步信息交換；b)支持通過消息隊列機制，完成發(fā)布/訂閱模式的異步信息交換；c)提供句法互操作功能，識別工業(yè)互聯(lián)網(wǎng)平臺間交換信息的數(shù)據(jù)組織格式；d)提供數(shù)據(jù)互操作功能，識別工業(yè)互聯(lián)網(wǎng)平臺間交換信息的數(shù)據(jù)模型。7.3安全輔助類接口安全輔助類接口應具備：a)設備安全接入能力，設備接入到工業(yè)互聯(lián)網(wǎng)平臺時需進行必要的授權登錄，結合數(shù)據(jù)加密傳輸實現(xiàn)設備加密通信，保證設備接入安全可靠；b)應用安全接入能力，應用接入到工業(yè)互聯(lián)網(wǎng)平臺時需進行必要的授權與鑒別，保證應用接入安全可靠；c)數(shù)據(jù)安全管理能力，基于平臺數(shù)據(jù)的安全等級對數(shù)據(jù)安全的生存周期進行管理，保證數(shù)據(jù)安全可靠。7.4運維管理類接口運維管理類接口應包括：a)支持記錄、存儲、查詢工業(yè)互聯(lián)網(wǎng)平臺間的服務配置和服務訪問日志；b)支持日志審計，異常診斷和處理模型數(shù)據(jù)。[1]GB/T114