城域數(shù)據(jù)中心網(wǎng)絡(luò)控制器北向接口技術(shù)要求

城域數(shù)據(jù)中心網(wǎng)絡(luò)控制器北向接口技術(shù)要求本文件規(guī)定了城域網(wǎng)中數(shù)據(jù)中心網(wǎng)絡(luò)控制器北向開放接口及相關(guān)功能定義，包括拓?fù)涔芾?、業(yè)務(wù)管理、網(wǎng)絡(luò)運(yùn)維管理等多種通用業(yè)務(wù)場景的編排管控接口。數(shù)據(jù)中心網(wǎng)絡(luò)控制器南向接口不在本文件范圍內(nèi)本文件適用于在城域網(wǎng)數(shù)據(jù)中心應(yīng)用的網(wǎng)絡(luò)SDN控制器的北向接口開發(fā)設(shè)計(jì)。2規(guī)范性引用文件本文件沒有規(guī)范性引用文件。3術(shù)語和定義下列術(shù)語和FloatingIP指浮動IP,是管理者臨時(shí)分配給到一個(gè)或多個(gè)實(shí)體設(shè)備使用的動態(tài)IP,通過該浮動IP,內(nèi)網(wǎng)的實(shí)體設(shè)備才能被外網(wǎng)識別和訪問，一個(gè)浮動IP通常是一個(gè)公開的、可以路由到的IP地址。下列縮略語適用于本文件。API應(yīng)用程序編程接口ApplicationProgrammingInterfaceAPP應(yīng)用程序Application數(shù)據(jù)中心差分服務(wù)代碼點(diǎn)ifferentiatedServicesCodetEVPN以太網(wǎng)虛擬專用網(wǎng)絡(luò)EthernetVirtualPrivateNetworkIP互聯(lián)網(wǎng)協(xié)議InternetProtocolLSP鏈路狀態(tài)包LinkStatePacketNVE網(wǎng)絡(luò)虛擬邊緣NetworkVirtualizationEdgeNAT網(wǎng)絡(luò)地址轉(zhuǎn)換NetworkAddressTranslationPE網(wǎng)絡(luò)側(cè)邊緣設(shè)備ProviderEdgeQoS服務(wù)質(zhì)量Qualityof,ServiceSDN軟件定義網(wǎng)絡(luò)SoftwaredefinednetworkSNMP簡單網(wǎng)絡(luò)管理協(xié)議SimpleNetworkManagementProtocolVXLANTunnelEndPoint虛擬專用網(wǎng)絡(luò)VirtualPrivateNetwork虛擬數(shù)據(jù)中心虛擬機(jī)虛擬路由器虛擬交換機(jī)詢到特定設(shè)備的具體信息。c)查詢鏈路信息獲取DC控制器管理網(wǎng)絡(luò)拓?fù)涞乃墟溌沸畔?，也可以根?jù)網(wǎng)絡(luò)標(biāo)識id,鏈路標(biāo)識id查詢到指定交換機(jī)相關(guān)的鏈路信息。d)查詢端口信息獲取DC控制器管理網(wǎng)絡(luò)拓?fù)渲械乃泄?jié)點(diǎn)上對于控制器可見的端口信息?？梢灾付ňW(wǎng)絡(luò)標(biāo)識id,設(shè)備標(biāo)識id以及端6.2租戶資源管理接口租戶資源管理接口詳細(xì)定義如下：a)創(chuàng)建租戶資源創(chuàng)建租戶資源，主要包括TenantUUID、Name、Description、Type等信息。b)更新租戶資源更新租戶資源，輸入TenantUUID、Name等Key值信息查詢到對應(yīng)租戶，并更新該租戶的資源信息。c)刪除租戶資源刪除租戶資源，輸入TenantUUID信息，找到該租戶對應(yīng)的資源信息，刪除該租戶之前分配的資源信息。d)查詢租戶資源查詢租戶資源，輸入TenantUUID信息后，可以查詢到該TenantUUID對應(yīng)的租戶資源6.3網(wǎng)絡(luò)資源管理接口網(wǎng)絡(luò)資源管理接口詳細(xì)定義如下：a)創(chuàng)建網(wǎng)絡(luò)資源創(chuàng)建虛擬網(wǎng)絡(luò)資源信息，主要包括NetworkUUID、Name、管理狀態(tài)、SDN側(cè)網(wǎng)絡(luò)狀態(tài)、External(是否是外部網(wǎng)絡(luò))、Subnets、Shared(network是否租戶間共享)b)更新網(wǎng)絡(luò)資源更新虛擬網(wǎng)絡(luò)資源信息。輸入Network的Key值信息以及需要更新的信息，返回已經(jīng)更新成功的虛擬網(wǎng)絡(luò)資源信息c)刪除網(wǎng)絡(luò)資源刪除虛擬網(wǎng)絡(luò)資源信息，輸入Netaork的WUID信息，刪除該Network對應(yīng)的網(wǎng)絡(luò)資源d)查詢網(wǎng)絡(luò)資源查詢虛擬網(wǎng)絡(luò)資源信息，輸入Network的UUID,可以查詢到該Network對應(yīng)的資源信6.4子網(wǎng)資源管理接口子網(wǎng)資源管理接口詳細(xì)定義如下：a)創(chuàng)建子網(wǎng)資源創(chuàng)建子網(wǎng)資源，主要包括SubnetUUID、所在NetworkUUID、Name、IP地址版本、IPCIDR信息(在機(jī)架出租場景下需要能指定不同地址段的起始地址和結(jié)束地址)、網(wǎng)關(guān)地址、DNSServer地址列表、分配地址池資源信息、主機(jī)路由信息、DHCP使能開關(guān)、關(guān)聯(lián)的租戶WID信息。b)更新子網(wǎng)資源更新子網(wǎng)資源，輸入需要更新的子網(wǎng)資源信息，DC控制器內(nèi)部更新對應(yīng)的子網(wǎng)資源。o)刪除子網(wǎng)資源刪除子網(wǎng)資源，輸入子網(wǎng)的UUID信息，刪除該子網(wǎng)對應(yīng)的資源信息。d)查詢子網(wǎng)資源查詢子網(wǎng)資源，輸入子網(wǎng)的UUID信息，可以查詢到該子網(wǎng)對應(yīng)的資源信息。6.5端口資源管理接口a)創(chuàng)建網(wǎng)絡(luò)端口資源端口被誰使用)、端口允許通過的地址對、Port所屬租戶的UUID、Port上所綁定的安全組列表、關(guān)聯(lián)的QoSpolicy、端口所在設(shè)備id以及端口所在物理設(shè)備上的端口號信息。b)更新端口資源更新虛擬網(wǎng)絡(luò)內(nèi)部的端口資源信息，輸入需要更新的端口資源信息，DC控制器收到后內(nèi)部更新該端口的資源信息。c)刪除端口資源刪除虛擬網(wǎng)絡(luò)內(nèi)部的端口資源信息，輸入需要?jiǎng)h除的Port的UID信息，根據(jù)UUID找到對應(yīng)的Port資源信息進(jìn)行副除d)查詢端口資源查詢虛擬網(wǎng)絡(luò)內(nèi)部的端口資源信息，輸入需要查詢的Port的UUID信息，根據(jù)LWID可以查詢到該端口對應(yīng)的資源信息。6.6vRouter資源管理接口vRouter資源管理接口詳細(xì)需求定義外部網(wǎng)絡(luò)IP等信息。更新虛擬路由器資源，輸入需要更新的Router資源信息，DC控制器內(nèi)部更新該Routerd)查詢vRouter資源查詢虛擬路由器資源信息，輸入RouterWID,可以查詢到該Router對應(yīng)的資源信息。6.7FloatingIP資源管理接口要實(shí)現(xiàn)內(nèi)部網(wǎng)絡(luò)的虛擬機(jī)和部署環(huán)境以外的云外網(wǎng)絡(luò)的連通，需要給虛機(jī)配置FloatingIP資源管理接口詳細(xì)定義如下：創(chuàng)建FloatingIP信息，主要包括FloatingIPUUID、FloatingIP綁定的Port的UUID、FloatingIP所屬的Router的LUID、FloatingIP所綁定的靜態(tài)地址、FloatingIP所在的Network的UUID、FloatingIP地址、帶寬限速、流量整形、FloatingIP所屬的租FloatingIP綁定的PortUUID信息，DC控制器內(nèi)部會進(jìn)行對該信息進(jìn)行更新。刷除FloatingIP信息，輸入FloatingIP的UUID,DC控制器內(nèi)部會根據(jù)UUID找到該FloatingIP,并刪除其相關(guān)信息。查詢FloatingIP信息，輸入FloatingIP的UUID,可以查看該Floating6.8安全組資源管理接口安全組是一些規(guī)則的集合，用來對虛擬機(jī)的訪問流量加以限制安全組資源管理接口詳細(xì)定義如下：創(chuàng)建安全組信息，主要包括SecurityGroupUUID、Name、Description、SecurityGroup下掛的安全組規(guī)則的UUID列表、SecurityGroup所屬租戶的UUID信息。更新安全組信息，輸入SecurityGroup的WID以及需要更新的相關(guān)信息，DC控制器收到后會根據(jù)UUID更新該安全組的信息。刪除安全組信息，輸入SecurityGroup的UUID信息，DC控制器收到后根據(jù)UUID刪除該安全組的信息。查詢安全組信息，輸入SecurityGroup的UUID信息，可以查看到該安全組的具體信息。e)創(chuàng)建安全組規(guī)則創(chuàng)建安全組規(guī)則，主要包括SecurityGroupRule的UUID信息、SecurityGroupRule作用流量方向(入向或出向)、協(xié)議類型、以太類型、協(xié)議最大Port號、協(xié)議最小Port號(因OpenFlow協(xié)議限制，需確保協(xié)議最大Port號和協(xié)議最小Port號一致)、指定流量對對端IPV6地址(僅當(dāng)以太類型為IPV6時(shí)有效)、SecurityGroupRule所屬租戶WID信息。f)更新安全組規(guī)則更新安全組規(guī)則，輸入需要更新的SecurityGroupRule的UUID信息以及需要更新的相關(guān)信息，比如作用流量方向信息，DC控制器內(nèi)部會對該安全組規(guī)則進(jìn)行更新刪除安全組規(guī)則，輸入SecurityGroupR刪除該安全組規(guī)則。h)查詢安全組規(guī)則查詢安全組規(guī)則，輸入SecurityGroupRule的WID信息，可以查看到該安全組規(guī)則的具體信息。QoS指一個(gè)網(wǎng)絡(luò)能夠利用各種基礎(chǔ)技術(shù)，為指定的網(wǎng)絡(luò)通信提供更好的服務(wù)能力，是網(wǎng)絡(luò)中的一種安全機(jī)制，是用來解決網(wǎng)絡(luò)延遲和阻塞等問題的一種技術(shù)。QoS策略管理接口詳細(xì)需求定義如下：針對不同用戶的不同應(yīng)用創(chuàng)建QoS策略，主要包括租戶ID、項(xiàng)目ID、策略對象、策略是否共享、策略名、策略描述、負(fù)載均衡器用于探測成員狀態(tài)采用的協(xié)議報(bào)文類型(PING、b)創(chuàng)建帶寬限制規(guī)則配置網(wǎng)絡(luò)的帶寬限制范圍，主要包括網(wǎng)絡(luò)的UUID、QoS策略id、帶寬限制規(guī)則對象、最大KBPS值、KBPS值上的最大突發(fā)脈沖值等信息。c)創(chuàng)建DSCP標(biāo)記規(guī)則配置網(wǎng)絡(luò)的DSCP標(biāo)記規(guī)則，主要包括網(wǎng)絡(luò)的UUID、QoS策略id、DSCP標(biāo)記規(guī)則對象、DSCP值等信息。d)創(chuàng)建復(fù)雜QoS流分類器配置復(fù)雜QoS流分類器，支持按照L3、L4的流量特征分類，L3分類器內(nèi)容主要包括地址類型、源/目的前級信息和DSCP值，L4分類器主要包括源/目的端口、DSCP值等信息。6.10日志管理接口當(dāng)前主要通過日志接口獲取SDN控制器的系統(tǒng)，安全等事件的信息，為上層系統(tǒng)的狀態(tài)監(jiān)控、運(yùn)維等提供手段。目前采用Syslog協(xié)議上送日志信息，DC控制器北向接口定義包括由DC控制器向日志服務(wù)器發(fā)送日志內(nèi)容。日志數(shù)據(jù)發(fā)送日志的詳細(xì)信息包括：主機(jī)名稱或者地址、嚴(yán)重度、接收時(shí)間和消息詳細(xì)內(nèi)容等信息。支持的日志類型包括操作日志，安全日志和系統(tǒng)日志。操作日志主要包括對所有數(shù)據(jù)對象進(jìn)行新增操作或者修改操作后的記錄安全日志主要包括賬戶創(chuàng)建、修改和刪除、賬戶登錄失敗、賬戶鎖定和解鎖、賬戶登錄和注銷等安全事件相關(guān)的消息系統(tǒng)日志內(nèi)容主要包括交換機(jī)上下線、端口UP/DoWN、控制器節(jié)點(diǎn)過載、轉(zhuǎn)發(fā)面鏈路新建和消除等系統(tǒng)狀態(tài)變化相關(guān)的事件。7.1接口與對象對應(yīng)關(guān)系7.1.1拓?fù)涔芾韺ο蟮?1頁7.1.2業(yè)務(wù)管理對象7.2對象屬性列表詳細(xì)定義7.2.1拓?fù)涔芾韺ο笤敿?xì)定義必填備注R是作必選備注R是R網(wǎng)絡(luò)類型，對應(yīng)YANG里的是R否R是R是R示不可編輯否必選R是R空否R是R是R是 必選R是R空否R是R目的節(jié)點(diǎn)是R否R是R是R是R是RLink唯一標(biāo)識，是R否R是R是R端口狀態(tài)，是R是 R是R是R是R是R是R是R是R是R是R是R是R是R內(nèi)網(wǎng)ip列表是R是第14頁R是型CCdCCCARP報(bào)文的最大速率，缺省值為0,表示不限CCCCCCCCCCRRR間國0~365,單位為(天)。體賦值 CC址eCSddeviceidportidR點(diǎn)IP地址，地址格如23.23.22.1。R可選。datapathID格式，R的端口號。R息，包括：VLAN,取值范國1-R絡(luò)名稱。1~60個(gè)字字、下劃線和連字符。RdRC接口。"1b“代表Loadbalance接口，無缺省值，當(dāng)PUT操值。和連字符。值范圍68~65535。劃線。端口組概念來自VMware,用于適配EXSi,同時(shí)可以承IP的UUID列表，無圍，通過配置泛洪域，并將虛擬端口