算力公共服務(wù)平臺資源納管接口規(guī)范_第1頁
算力公共服務(wù)平臺資源納管接口規(guī)范_第2頁
算力公共服務(wù)平臺資源納管接口規(guī)范_第3頁
算力公共服務(wù)平臺資源納管接口規(guī)范_第4頁
算力公共服務(wù)平臺資源納管接口規(guī)范_第5頁
已閱讀5頁,還剩48頁未讀, 繼續(xù)免費(fèi)閱讀

下載本文檔

版權(quán)說明:本文檔由用戶提供并上傳,收益歸屬內(nèi)容提供方,若內(nèi)容存在侵權(quán),請進(jìn)行舉報(bào)或認(rèn)領(lǐng)

文檔簡介

算力公共服務(wù)平臺資源納管接口規(guī)范范圍本文件規(guī)定了接入算力公共服務(wù)平臺的通用算力(簡稱“通算”)、智能算力(簡稱“智算”)、超級算力(簡稱“超算”)、量子計(jì)算(簡稱“量算”)、安全業(yè)務(wù)以及涉及平臺監(jiān)管的資源納管接口的要求。本文件適用于通算、智算、超算、量子計(jì)算等算力供給方和安全資源接入到算力公共服務(wù)平臺資源納管接口的設(shè)計(jì)和驗(yàn)證。規(guī)范性引用文件下列文件中的內(nèi)容通過文中的規(guī)范性引用而構(gòu)成本文件必不可少的條款。其中,注日期的引用文件,僅該日期對應(yīng)的版本適用于本文件;不注日期的引用文件,其最新版本(包括所有的修改單)適用于本文件。ISO/IEC21778信息技術(shù)JSON數(shù)據(jù)交換語法(Informationtechnology-TheJSONdataInterchangesyntax)術(shù)語和定義下列術(shù)語和定義適用于本文件。算力computingcapability網(wǎng)絡(luò)中具有計(jì)算能力的節(jié)點(diǎn)通過對數(shù)據(jù)的處理,實(shí)現(xiàn)特定結(jié)果輸出的能力,具體包括不限于計(jì)算、內(nèi)存和存儲能力,算力可以分布在網(wǎng)絡(luò)邊緣、云數(shù)據(jù)中心、連網(wǎng)終端、轉(zhuǎn)發(fā)節(jié)點(diǎn)等各種形態(tài)的設(shè)備上。[來源:YD/T4255-2023,3.1]算力公共服務(wù)平臺computingpowerpublicserviceplatform通過整合和調(diào)度各類各地的算力資源,促進(jìn)異構(gòu)異地異屬算力資源互聯(lián)互通和高效利用的綜合性服務(wù)平臺。算力公共服務(wù)平臺旨在滿足人工智能、大數(shù)據(jù)處理、科學(xué)計(jì)算等領(lǐng)域的應(yīng)用需求,為用戶提供便捷、高效、低成本的算力服務(wù)。通用算力generalcomputingpower以CPU芯片輸出的計(jì)算能力為主,能夠處理一般性計(jì)算任務(wù)的算力集群。智能算力Intelligentcomputingpower(intelligent)以GPU、現(xiàn)場可編程門陣列(FPGA)、專用集成電路(ASIC)等AI芯片為主,能夠執(zhí)行圖形顯示、信號處理和物理模擬等計(jì)算密集型任務(wù)的高性能算力集群。注:智算通常服務(wù)于人工智能、機(jī)器學(xué)習(xí)以及深度學(xué)習(xí)等。超級算力highjperformancecomputing由通用或?qū)S玫母咝阅苡布蛙浖M成的,為處理復(fù)雜的數(shù)據(jù)、算法和應(yīng)用等提供高性能算力的高性能計(jì)算集群。量子計(jì)算quantumcomputing基于量子力學(xué)原理,采用真實(shí)量子計(jì)算架構(gòu),利用量子比特進(jìn)行信息處理,支持大規(guī)模信息處理和計(jì)算的能力??s略語下列縮略語適用于本文件。API:應(yīng)用程序編程接口(ApplicationProgrammingInterface)CPU:中央處理器(CentralProcessingUnit)DCU:深度計(jì)算單元(DeepComputingUnit)GPU:圖形處理器(GraphicsProcessingUnit)HTTP:超文本傳輸協(xié)議(HyperTextTransferProtocol)HTTPS:超文本傳輸安全協(xié)議(HypertextTransferProtocolSecure)JSON:一種JavaScript對象的輕量級的數(shù)據(jù)交換格式(JavaScriptObjectNotation)RESTful:表現(xiàn)層狀態(tài)傳遞(RepresentationalStateTransfer)URI:統(tǒng)一資源標(biāo)識符(UniformResourceIdentifier)URL:統(tǒng)一資源定位器(UniformResourceLocator)UTF-8:8位元轉(zhuǎn)換格式(UnicodeTransformationFormat8bit)總體架構(gòu)算力公共服務(wù)平臺通過納管各種異屬異構(gòu)跨地域算網(wǎng)資源,實(shí)現(xiàn)集群數(shù)據(jù)中心資源的統(tǒng)一調(diào)度和全生命周期管理。其整體架構(gòu)如圖1所示。算力公共服務(wù)平臺架構(gòu)圖統(tǒng)一運(yùn)營門戶實(shí)現(xiàn)計(jì)算、存儲、網(wǎng)絡(luò)、安全等各方算力提供者的各類資源的精細(xì)化統(tǒng)一運(yùn)營管理,提供全局資源總覽、資源使用情況、資源上下架、用戶管理、日志管理等。服務(wù)交易中心實(shí)現(xiàn)已納管算力、網(wǎng)絡(luò)、安全資源的交易,支持通過統(tǒng)一入口、統(tǒng)一流程訂購資源、退訂資源、變更資源等操作。資源調(diào)度中心支撐面向算力的跨域調(diào)度、彈性調(diào)度、容災(zāi)調(diào)度等多樣化的調(diào)度場景。編排管理中心基于原子能力一體化編排,實(shí)現(xiàn)算、網(wǎng)、安能力統(tǒng)一設(shè)計(jì)開發(fā)和一體編排,滿足不同行業(yè)應(yīng)用場景對算網(wǎng)的需求,快速構(gòu)建算網(wǎng)產(chǎn)品和解決方案。監(jiān)控運(yùn)維中心實(shí)現(xiàn)對資源池基礎(chǔ)設(shè)施以及虛擬化資源進(jìn)行集中監(jiān)控,提供高可用、統(tǒng)一認(rèn)證、統(tǒng)一監(jiān)控告警、日志分析、行為溯源等能力。資源納管功能提供各類異構(gòu)算力的納管,形成標(biāo)準(zhǔn)接入規(guī)范,支持全量異構(gòu)資源池的統(tǒng)一納管。包括實(shí)例、流程、配額、資源對賬等管理能力。服務(wù)運(yùn)營實(shí)現(xiàn)流程管控、配額管理、成本管理和運(yùn)營分析等能力。算力公共服務(wù)平臺根據(jù)對接算力供給方資源池的技術(shù)要求,通過認(rèn)證、用戶、鏡像、存儲、實(shí)例服務(wù)、作業(yè)等管理接口,實(shí)現(xiàn)對算力供給方平臺各類資源的開通和管理。接口通用技術(shù)要求接口調(diào)用方式接口格式應(yīng)遵循RESTfulAPI,傳輸協(xié)議支持HTTP2.0版本(RFC7540)并向下兼容,并且基于HTTPS方式加密訪問。接口消息體包括請求體和響應(yīng)體,請求體包含請求頭以及Request內(nèi)容,響應(yīng)體包括Response內(nèi)容。HTTP接口訪問方法格式為:請求方法/api/v1/接口功能/{路徑參數(shù)}(如果有)/操作(如果有),在實(shí)際調(diào)用中需補(bǔ)全前綴和后綴。請求方法包括POST、PUT等,api為域名地址或IP地址,v1為接口版本且隨版本更新而更新,接口功能、路徑參數(shù)與操作詳見表2~表70中的定義。云主機(jī)監(jiān)控同步的接口訪問方法為POST//v1/instances/{"instance-123456"}/monitor,其中“”為接口地址,“instances”為接口功能,表示對云主機(jī)的實(shí)例進(jìn)行操作,{"instance-123456"}”為路徑參數(shù)instanceId的值,monitor為操作,表示監(jiān)控。請求頭應(yīng)包含Content-Type信息。認(rèn)證授權(quán)的請求頭為:RequestHTTPHeaderContent-Type:application/json;charset=UTF-8ResponseHTTPHeaderX-Auth-Token:{發(fā)放的令牌}對通算、智算、超算、量子計(jì)算四種算力進(jìn)行定、退、改、續(xù)等管理行為時,請求頭應(yīng)包含攜帶的令牌。RequestHTTPHeaderContent-Type:application/json;charset=UTF-8X-Auth-Token:{發(fā)放的令牌}ResponseHTTPHeaderContent-Type:application/json;charset=UTF-8接口請求(Request)和響應(yīng)(Response)內(nèi)容應(yīng)采用JSON格式,并符合ISO/IEC21778標(biāo)準(zhǔn),應(yīng)支持UTF-8無字節(jié)順序標(biāo)記(BOM)格式編碼格式(返回值為文件、圖片等特殊信息的除外)。接口安全認(rèn)證算力公共服務(wù)平臺應(yīng)支持對納管的各類算力資源進(jìn)行認(rèn)證,保證南向接口傳輸數(shù)據(jù)的機(jī)密性和完整性。算力供給方應(yīng)保障對算力服務(wù)平臺的接入安全,包括對基于證書的認(rèn)證、基于HTTPS保護(hù)接口數(shù)據(jù)傳輸?shù)臋C(jī)密性和完整性。HTTP狀態(tài)碼常用HTTP狀態(tài)碼及信息的描述見表1。狀態(tài)信息及描述狀態(tài)碼描述釋義200OK請求成功。一般用于GET與POST請求201Created已創(chuàng)建。成功請求并創(chuàng)建了新的資源202Accepted已接受。已經(jīng)接受請求,但未處理完成203Non-AuthoritativeInformation非授權(quán)信息。請求成功。但返回的元信息不在原始的服務(wù)器,而是一個副本204NoContent無內(nèi)容。服務(wù)器成功處理,但未返回內(nèi)容。在未更新網(wǎng)頁的情況下,可確保瀏覽器繼續(xù)顯示當(dāng)前文檔205ResetContent重置內(nèi)容。服務(wù)器處理成功,用戶終端(例如:瀏覽器)應(yīng)重置文檔視圖??赏ㄟ^此返回碼清除瀏覽器的表單域206PartialContent部分內(nèi)容。服務(wù)器成功處理了部分GET請求300MultipleChoices多種選擇。請求的資源可包括多個位置,相應(yīng)可返回一個資源特征與地址的列表用于用戶終端(例如:瀏覽器)選擇301MovedPermanently永久移動。請求的資源已被永久的移動到新URI,返回信息會包括新的URI,瀏覽器會自動定向到新URI。今后任何新的請求都應(yīng)使用新的URI代替302Found臨時移動。與301類似。但資源只是臨時被移動。客戶端應(yīng)繼續(xù)使用原有URI303SeeOther查看其它地址。與301類似。使用GET和POST請求查看304NotModified未修改。所請求的資源未修改,服務(wù)器返回此狀態(tài)碼時,不會返回任何資源??蛻舳送ǔ彺嬖L問過的資源,通過提供一個頭信息指出客戶端希望只返回在指定日期之后修改的資源305UseProxy使用代理。所請求的資源必須通過代理訪問306Unused已經(jīng)被廢棄的HTTP狀態(tài)碼307TemporaryRedirect臨時重定向。與302類似。使用GET請求重定向400BadRequest客戶端請求的語法錯誤,服務(wù)器無法理解401Unauthorized請求要求用戶的身份認(rèn)證402PaymentRequired保留,將來使用403ForbIDden服務(wù)器理解請求客戶端的請求,但是拒絕執(zhí)行此請求404NotFound服務(wù)器無法根據(jù)客戶端的請求找到資源(網(wǎng)頁)。通過此代碼,網(wǎng)站設(shè)計(jì)人員可設(shè)置"您所請求的資源無法找到"的個性頁面405MethodNotAllowed客戶端請求中的方法被禁止406NotAcceptable服務(wù)器無法根據(jù)客戶端請求的內(nèi)容特性完成請求407ProxyAuthenticationRequired請求要求代理的身份認(rèn)證,與401類似,但請求者應(yīng)當(dāng)使用代理進(jìn)行授權(quán)408RequestTime-out服務(wù)器等待客戶端發(fā)送的請求時間過長,超時409Conflict服務(wù)器完成客戶端的PUT請求時可能返回此代碼,服務(wù)器處理請求時發(fā)生了沖突410Gone客戶端請求的資源已經(jīng)不存在。410不同于404,如果資源以前有現(xiàn)在被永久刪除了可使用410代碼,網(wǎng)站設(shè)計(jì)人員可通過301代碼指定資源的新位置411LengthRequired服務(wù)器無法處理客戶端發(fā)送的不帶Content-Length的請求信息412PreconditionFailed客戶端請求信息的先決條件錯誤413RequestEntityTooLarge由于請求的實(shí)體過大,服務(wù)器無法處理,因此拒絕請求。為防止客戶端的連續(xù)請求,服務(wù)器可能會關(guān)閉連接。如果只是服務(wù)器暫時無法處理,則會包含一個Retry-After的響應(yīng)信息414Request-URITooLarge請求的URI過長(URI通常為網(wǎng)址),服務(wù)器無法處理415UnsupportedMediaType服務(wù)器無法處理請求附帶的媒體格式416Requestedrangenotsatisfiable客戶端請求的范圍無效417ExpectationFailed服務(wù)器無法滿足Expect的請求頭信息500InternalServerError服務(wù)器內(nèi)部錯誤,無法完成請求501NotImplemented服務(wù)器不支持請求的功能,無法完成請求502BadGateway作為網(wǎng)關(guān)或者代理工作的服務(wù)器嘗試執(zhí)行請求時,從遠(yuǎn)程服務(wù)器接收到了一個無效的響應(yīng)503ServiceUnavailable由于超載或系統(tǒng)維護(hù),服務(wù)器暫時的無法處理客戶端的請求。延時的長度可包含在服務(wù)器的Retry-After頭信息中504GatewayTime-out充當(dāng)網(wǎng)關(guān)或代理的服務(wù)器,未及時從遠(yuǎn)端服務(wù)器獲取請求505HTTPVersionnotsupported服務(wù)器不支持請求的HTTP協(xié)議的版本,無法完成處理響應(yīng)時間同步接口,接口返回時長不應(yīng)超過60s。異步接口,默認(rèn)超時時間為2h。異常處理機(jī)制算力供給方應(yīng)支持異常重試操作。重試時間間隔為50ms~200ms,重試次數(shù)可為1-3次。宜支持采用其他退避策略或機(jī)制優(yōu)化重試過程。通算接口要求認(rèn)證授權(quán)管理認(rèn)證授權(quán)認(rèn)證授權(quán)接口要求見表2。公共接口-認(rèn)證授權(quán)接口名稱及參數(shù)要求消息體類型參數(shù)名參數(shù)類型參數(shù)說明是否必選請求參數(shù)Org_idString算力公共服務(wù)平臺標(biāo)識是Cluster_idString算力供給方標(biāo)識是usernameString算力供給方的用戶名:該用戶具備創(chuàng)建主租戶/賬戶等管理員權(quán)限是passwordString算力供給方用戶密碼是返回值codeInt32狀態(tài)碼否messageString提示信息否isdataBoolean是否返回?cái)?shù)據(jù)否tokeninfoobjectToken數(shù)據(jù),具備參數(shù)包含issueat和expireat否└issueatStringToken生成的日期時間,屬于tokeninfo是└expireatStringToken有效的日期時間,屬于tokeninfo是successBoolean是否成功是接口說明:算力公共服務(wù)平臺調(diào)用算力供給方,用于認(rèn)證授權(quán)接口訪問方法:POST/api/v1/authentication/token授權(quán)廢除授權(quán)廢除接口要求見表3。公共接口-授權(quán)廢除接口名稱及參數(shù)要求消息體類型參數(shù)名參數(shù)類型參數(shù)說明是否必選返回值codeInt32狀態(tài)碼否messageString提示信息否successBoolean是否成功是接口說明:算力公共服務(wù)平臺調(diào)用算力供給方,用于認(rèn)證的授權(quán)廢除接口訪問方法:DELETE/api/v1/authentication/token用戶管理用戶創(chuàng)建用戶創(chuàng)建接口要求見表4。公共接口-用戶創(chuàng)建接口名稱及參數(shù)要求消息體類型參數(shù)參數(shù)類型說明是否必選請求參數(shù)accountString用戶名是accountidInt64父賬號ID否starttimeString賬號有效開始時間否endtimeString賬號有效結(jié)束時間否isresetpasswordString是否首次登錄重置密碼是passwordString密碼是roleidString角色是返回值codeInt32狀態(tài)碼否messageString提示信息否successBoolean是否成功是接口說明:算力公共服務(wù)平臺調(diào)用創(chuàng)建用戶接口,用于創(chuàng)建用戶接口訪問方法:POST/api/v1/account用戶注銷用戶注銷接口要求見表5。公共接口-用戶注銷接口名稱及參數(shù)要求參數(shù)類型參數(shù)參數(shù)類型說明是否必選請求參數(shù)accountidInt64父賬號ID是返回值codeInt32狀態(tài)碼否messageString提示信息否successBoolean是否成功是接口說明:算力公共服務(wù)平臺調(diào)用創(chuàng)建用戶接口,用于創(chuàng)建用戶接口訪問方法:DELETE/api/v1/account/{accountid}配額管理創(chuàng)建配額創(chuàng)建配額接口要求見表6。公共接口-創(chuàng)建配額接口名稱及參數(shù)要求消息體類型參數(shù)名稱參數(shù)類型說明是否必選請求參數(shù)account_idString主用戶ID是quota_setobject資源配額,包含cpu、gpu和storage是└cpuInt32CPU核數(shù),默認(rèn)配額4是└gpuInt32GPU卡數(shù),默認(rèn)配額2是└storageInt32存儲容量(GB),默認(rèn)配額1024否,否時無限制返回值codeInt32狀態(tài)碼否messageString提示信息否isdataBoolean是否返回?cái)?shù)據(jù)否quota_setobject資源配額,包含cpu、gpu和storage否└cpuInt32CPU核數(shù)否└gpuInt32GPU卡數(shù)否└storageInt32存儲容量(GB)否successBoolean是否成功是接口說明:算力公共服務(wù)平臺調(diào)用創(chuàng)建配額接口接口訪問方法:PUT/api/v1/quota-sets/account_id/{account_id}查詢配額查詢配額接口要求見表7。公共接口-查詢配額接口名稱及參數(shù)要求參數(shù)類型參數(shù)名參數(shù)類型說明是否必選請求參數(shù)account_idString主用戶ID是返回值codeInt32狀態(tài)碼否messageString提示信息否isdataBoolean是否返回?cái)?shù)據(jù)否quota_setobject資源配額,包含cpu、gpu和storage否└cpuInt32CPU核數(shù)否└gpuInt32GPU卡數(shù)否└storageInt32存儲容量(GB)否successBoolean是否成功是接口說明:算力公共服務(wù)平臺查詢配額接口接口訪問方法:GET/api/v1/quota-sets/account_id/{account_id}實(shí)例管理計(jì)算實(shí)例管理創(chuàng)建計(jì)算實(shí)例創(chuàng)建計(jì)算實(shí)例接口要求見表8。通算實(shí)例管理-創(chuàng)建計(jì)算實(shí)例接口名稱及參數(shù)要求消息體類型參數(shù)名稱參數(shù)類型說明是否必選請求參數(shù)regionString可用區(qū)是chargeTypeEnum(year,month,hour)計(jì)費(fèi)方式。year/month/hour是cpuIntcpu核數(shù)(核)是ramInt內(nèi)存大?。℅B)是flavorNameString規(guī)格名稱,建議填寫,如s1.medium.2。如填寫該值,將以規(guī)格名稱作為創(chuàng)建云主機(jī)規(guī)格的依據(jù);否bootVolumeObject<請求體>系統(tǒng)盤是└bootVolume.sizeInt系統(tǒng)盤大小是└bootVolume.volumeTypeString系統(tǒng)盤類型是dataVolumeList<云主機(jī)數(shù)據(jù)盤請求體>一體化訂購中數(shù)據(jù)盤產(chǎn)品否└dataVolume.isShareBoolean是否為共享數(shù)據(jù)盤,默認(rèn)為非共享盤否└dataVolume.resourceTypeString數(shù)據(jù)盤類型是└dataVolume.sizeInt數(shù)據(jù)盤大小(G)是imageNameString鏡像名稱是nameString云主機(jī)名稱是passwordString云主機(jī)密碼(使用非對稱加密形式)否keypairNameString密鑰對名稱,可通過查詢密鑰列表接口獲取。(password和keypairName僅能填寫一個)否quantityInt訂購數(shù)量是durationInt訂購時長(月/年)否networksObject<云主機(jī)網(wǎng)絡(luò)信息請求體>網(wǎng)絡(luò)是└networks.subnetIdString指定子網(wǎng)id,具體可通過查詢子網(wǎng)列表接口獲取是└networks.portIdString指定網(wǎng)卡id,具體可通過查詢虛擬網(wǎng)卡列表接口獲取否ipObject<云主機(jī)公網(wǎng)IP請求體>一體化訂購公網(wǎng)ip產(chǎn)品。如需一體化訂購公網(wǎng)ip產(chǎn)品,必須一起填寫ip與bandwidth參數(shù)否└ip.ipTypeEnum(MOBILE,MULTI_LINE)公網(wǎng)IP類型,MOBILE:彈性公網(wǎng)IP;MULTI_LINE:優(yōu)享版彈性公網(wǎng)IP否bandwidthObject<云主機(jī)帶寬請求體>一體化訂購中帶寬產(chǎn)品否└bandwidth.bandwidthSizeInt公網(wǎng)IP帶寬大小(Mbps)是└bandwidth.chargeModeEnum(bandwidthCharge,trafficCharge)公網(wǎng)IP帶寬計(jì)費(fèi)方式,bandwidthCharge:按帶寬計(jì)費(fèi);trafficCharge:按流量計(jì)費(fèi)是└bandwidth.ipv4BandwidthBoolean是否開通ipv4公網(wǎng)帶寬,默認(rèn)開通ipv4公網(wǎng)帶寬否└bandwidth.ipv6BandwidthBoolean是否開通ipv6帶寬,默認(rèn)不開通ipv6帶寬否securityGroupIdsList<String>安全組id,如果指定網(wǎng)卡id(即networks.portId不為空),此參數(shù)無效否└userDataString自定義參數(shù)否descriptionString主機(jī)描述否返回值requestIdString請求Id是successBoolean是否成功是codeString狀態(tài)碼否messageString提示信息否entityObject<創(chuàng)建資源返回實(shí)體>返回實(shí)體是└orderIdString訂單ID,如果返回的是訂單ID,需要提供根據(jù)訂單ID查詢資源ID的接口是└instanceIdString云主機(jī)資源唯一標(biāo)識(ID)是接口說明:算力公共服務(wù)平臺請求創(chuàng)建云主機(jī)實(shí)例接口訪問方法:POST/api/v1/instances/create查詢計(jì)算實(shí)例查詢計(jì)算實(shí)例接口要求見表9。通算實(shí)例管理-查詢計(jì)算實(shí)例接口名稱及參數(shù)要求消息體類型請求參數(shù)參數(shù)類型說明是否必選請求參數(shù)instanceIdString路徑參數(shù),云主機(jī)唯一標(biāo)識是返回值requestIdString請求id是codeString狀態(tài)碼否messageString提示信息否successBoolean是否成功是entityObject<云主機(jī)實(shí)體>返回實(shí)體是└vcpuIntcpu個數(shù)否└memoryInt內(nèi)存大小否└createdTimeString創(chuàng)建時間是└descriptionString云主機(jī)描述是└flavorIdString規(guī)格id是└flavorNameString云主機(jī)規(guī)格名稱是└instanceIdString云主機(jī)id否└imageIdString鏡像id否└imageNameString鏡像名稱否└imageOsNameString鏡像操作系統(tǒng)名稱否└imageOsTypeString鏡像類型否└keypairIdString密鑰對ID否└keypairNameString密鑰對名稱否└modifiedTimeString修改時間否└nameString云主機(jī)名稱是└portsList<Object>云主機(jī)網(wǎng)卡列表是└└port.idString網(wǎng)卡id否└└String網(wǎng)卡名稱否└└port.ipv4AddressStringIpv4地址否└└port.ipv6AddressStringIpv6地址否└└port.publicIpIdString公網(wǎng)ipId否└└port.publicIpString公網(wǎng)ip否└regionString可用區(qū)是└statusEnum(ACTIVE,STOPPED,ERROR,UNKNOWN)云主機(jī)狀態(tài)。ACTIVE運(yùn)行中;STOPPED已關(guān)機(jī);ERROR錯誤;UNKNOWN未知;是└chargeTypeEnum(year,month,hour)計(jì)費(fèi)模式,值為year,month,hour是└expiredTimeString過期時間是└systemDiskIdString系統(tǒng)盤id否└diskInt系統(tǒng)盤大小是└bootVolumeTypeString云主機(jī)系統(tǒng)盤類型是└volumesList<Object>云主機(jī)數(shù)據(jù)盤列表是└└volume.idString數(shù)據(jù)盤id否└└String數(shù)據(jù)盤名稱是└└volume.sizeInt數(shù)據(jù)盤大小是└└volume.typeString數(shù)據(jù)盤類型是接口說明:算力公共服務(wù)平臺請求查詢云主機(jī)詳情接口訪問方法:GET/api/v1/instances/{instanceId}刪除計(jì)算實(shí)例刪除計(jì)算實(shí)例接口要求見表10。通算實(shí)例管理-刪除計(jì)算實(shí)例接口名稱及參數(shù)要求消息體類型參數(shù)名稱參數(shù)類型說明是否必選請求參數(shù)instanceIdString路徑參數(shù),云主機(jī)唯一標(biāo)識是返回值requestIdString請求Id是codeString狀態(tài)碼否messageString提示信息否successBoolean是否成功是接口說明:算力公共服務(wù)平臺請求刪除云主機(jī)接口訪問方法:DELETE/api/v1/instances/{instanceId}開機(jī)/關(guān)機(jī)/重啟計(jì)算實(shí)例開機(jī)/關(guān)機(jī)/重啟計(jì)算實(shí)例接口要求見表11。通算實(shí)例管理-開機(jī)/關(guān)機(jī)/重啟計(jì)算實(shí)例接口名稱及參數(shù)要求消息體類型參數(shù)名稱參數(shù)類型說明是否必選請求參數(shù)instanceIdString路徑參數(shù),云主機(jī)唯一標(biāo)識是返回值requestIdString請求Id是codeString狀態(tài)碼否messageString提示信息否successBoolean是否成功是接口說明:算力公共服務(wù)平臺請求開機(jī)/關(guān)機(jī)/重啟云主機(jī)云主機(jī)開機(jī)接口訪問方法:PUT/api/v1/instances/{instanceId}/start云主機(jī)關(guān)機(jī)接口訪問方法:PUT/api/v1/instances/{instanceId}/stop關(guān)機(jī)云主機(jī)重啟接口訪問方法:PUT/api/v1/instances/{instanceId}/restart重啟修改計(jì)算實(shí)例修改計(jì)算實(shí)例接口要求見表12。通算實(shí)例管理-修改計(jì)算實(shí)例接口名稱及參數(shù)要求消息體類型參數(shù)名稱參數(shù)類型說明是否必選請求參數(shù)instanceIdString路徑參數(shù),云主機(jī)唯一標(biāo)識是nameString云主機(jī)名稱是passwordString云主機(jī)登錄密碼,使用非對稱加密方式是返回值requestIdString請求Id是codeString狀態(tài)碼否messageString提示信息否successBoolean是否成功是接口說明:算力公共服務(wù)平臺請求修改云主機(jī),包括修改名稱、密碼接口訪問方法:PUT/api/v1/instances/{instanceId}/update續(xù)訂計(jì)算實(shí)例續(xù)訂計(jì)算實(shí)例接口要求見表13。通算實(shí)例管理-續(xù)訂計(jì)算實(shí)例接口名稱及參數(shù)要求消息體類型參數(shù)名稱參數(shù)類型說明是否必選請求參數(shù)instanceIdString路徑參數(shù),云主機(jī)唯一標(biāo)識是actionIdString操作ID是返回值requestIdString請求Id是codeString狀態(tài)碼否messageString提示信息否successBoolean是否成功是接口說明:算力公共服務(wù)平臺請求續(xù)訂云主機(jī)接口訪問方法:PUT/api/v1/instances/{instanceId}/renew監(jiān)控?cái)?shù)據(jù)同步計(jì)算實(shí)例資源的監(jiān)控?cái)?shù)據(jù)同步接口要求見表14。通算實(shí)例管理-監(jiān)控?cái)?shù)據(jù)同步接口名稱及參數(shù)要求消息體類型請求參數(shù)參數(shù)類型說明是否必選請求參數(shù)instanceIdString路徑參數(shù),云主機(jī)唯一標(biāo)識是startTimeString查詢開始時間,格式如2020-07-1923:47:12是endTimeString查詢截止時間,格式如2020-07-1923:47:12是metricsList<監(jiān)控指標(biāo)實(shí)體>需要查詢的性能指標(biāo)集合是└metrics.metricNameEnum需要查詢的性能指標(biāo)名稱。/**云主機(jī)cpu利用率*/vm_custom_realtime_cpu_avg_util_percent,/**云主機(jī)內(nèi)存利用率*/vm_custom_realtime_mem_avg_util_percent,/**云主機(jī)磁盤利用率*/vm_disk_util_percent是返回值requestIdString請求Id是codeString狀態(tài)碼否messageString提示信息否successBoolean是否成功是接口說明:用以同步云主機(jī)資源運(yùn)行狀態(tài)等數(shù)據(jù)接口訪問方法:POST/api/v1/instances/{instanceId}/monitor鏡像管理創(chuàng)建鏡像創(chuàng)建鏡像接口要求見表15。通算實(shí)例管理-創(chuàng)建鏡像接口名稱及參數(shù)要求消息體類型參數(shù)名稱參數(shù)類型說明是否必選請求參數(shù)imagenameString文件名稱是noteString鏡像描述信息否instanceIdString云主機(jī)id是serverTypeEnumEnum(VM,IRONIC)主機(jī)類型否返回值requestIdString請求Id是codeString狀態(tài)碼否messageString提示信息否successBoolean是否成功是imageIdString返回鏡像ID是接口說明:算力公共服務(wù)平臺調(diào)用接口,用以創(chuàng)建鏡像接口訪問方法:POST/api/v1/images/create刪除鏡像刪除鏡像接口要求見表16。通算實(shí)例管理-刪除自定義鏡像接口名稱及參數(shù)要求消息體類型參數(shù)名稱參數(shù)類型說明是否必選請求參數(shù)imageIdString路徑參數(shù),鏡像ID是返回值requestIdString請求Id是codeString狀態(tài)碼否messageString提示信息否successBoolean是否成功是接口說明:算力公共服務(wù)平臺調(diào)用接口,用以刪除鏡像接口訪問方法:DELETE/api/v1/images/{imageId}鏡像下載鏡像下載接口要求見表17。通算實(shí)例管理-鏡像下載接口名稱及參數(shù)要求消息體類型參數(shù)名稱參數(shù)類型說明是否必選請求參數(shù)imagenameString文件名稱是返回值codeInt32狀態(tài)碼否messageString提示信息否isdataBoolean是否返回?cái)?shù)據(jù)否imageidString鏡像ID是locationString文件地址否successBoolean是否成功否接口說明:算力公共服務(wù)平臺調(diào)用接口,用以下載鏡像接口訪問方法:POST/api/v1/catalog/images/download查詢鏡像查詢鏡像接口要求見表18。通算實(shí)例管理-查詢鏡像接口名稱及參數(shù)要求消息體類型參數(shù)名稱參數(shù)類型說明是否必選請求參數(shù)typeString鏡像類型否imageidString鏡像ID否3rdosidString三方運(yùn)營服務(wù)系統(tǒng)ID否返回值codeInt32狀態(tài)碼否messageString提示信息否isdataBoolean是否返回?cái)?shù)據(jù)否imagelistarrayimages列表否└imageobjectimage對象是└└nameString鏡像名稱否└└descriptionString鏡像描述否└└typeString鏡像類型是└└publicviewString是否公開否└└imagepathString鏡像地址是successBoolean是否成功否接口說明:算力公共服務(wù)平臺調(diào)用接口,查詢鏡像列表接口訪問方法:GET/api/v1/catalog/images存儲實(shí)例管理文件存儲管理創(chuàng)建文件創(chuàng)建文件接口要求見表19。通算接口-創(chuàng)建文件接口名稱及參數(shù)要求消息體類型參數(shù)參數(shù)類型說明是否必選請求參數(shù)nameString文件存儲名稱是regionString可用區(qū)是protocolEnum(NFS,CIFS,GLUSTERFS,HDFS,SMB,YRFS;)協(xié)議是descriptionString文件存儲描述否chargeTypeEnum(year,month,hour)計(jì)費(fèi)模式,值為year,month,hour否durationInteger訂購時長(月/年)否shareSizeInteger文件存儲容量規(guī)格是vpcIdStringVPC編號否subnetIdString子網(wǎng)編號否groupIdString安全組編號否返回值requestIdString請求Id是codeString狀態(tài)碼否messageString提示信息否successBoolean是否成功是orderIdString訂單ID,如果返回的是訂單ID,需要提供根據(jù)訂單ID查詢資源ID的接口是efsIdSting文件存儲唯一標(biāo)識(ID)是接口說明:算力公共服務(wù)平臺調(diào)用接口,創(chuàng)建文件存儲接口訪問方法:POST/api/v1//v1/efs/create獲取文件列表獲取文件列表接口要求見表20。通算接口-獲取文件列表接口名稱及參數(shù)要求消息體類型參數(shù)名參數(shù)類型說明是否必選請求參數(shù)efsIdString文件存儲唯一標(biāo)識ID是pageSizeInteger分頁頁面大小否pageNumInteger分頁頁碼否返回值requestIdString請求Id是codeString狀態(tài)碼否messageString提示信息否entityObject<文件存儲實(shí)體>返回實(shí)體否└totalInteger總個數(shù)是└listList<文件存儲實(shí)體>文件存儲列表否└efsidStringID否└nameString名稱否└shareSizeInteger文件存儲容量規(guī)格,單位:GB否└usedSpaceString文件存儲已使用容量否└protocolEnum(NFS,CIFS,GLUSTERFS,HDFS,SMB,YRFS;)協(xié)議否└exportLocationString文件存儲共享目錄掛載點(diǎn)否└createdTimeString文件存儲創(chuàng)建時間否└modifiedTimeString文件存儲修改時間否└statusEnum(AVAILABLE,UNKNOWN)狀態(tài)。AVAILABLE可用;UNKNOWN不可用;否└vpcIdStringVPC編號否└subnetIdString子網(wǎng)編號否└groupIdString安全組編號否└regionString區(qū)域否└chargeTypeEnum(year,month,hour)計(jì)費(fèi)模式,值為year,month,hour否└expiredTimeString過期時間否└descriptionString描述否successBoolean是否成功是接口說明:算力公共服務(wù)平臺調(diào)用接口,查詢目錄文件列表接口訪問方法:GET/api/v1/efs/list刪除文件存儲刪除文件存儲接口要求見表21。通算接口-刪除文件存儲接口名稱及參數(shù)要求消息體類型請求參數(shù)參數(shù)說明是否必選請求參數(shù)efsIdString路徑參數(shù),文件存儲唯一標(biāo)識(ID)是filenameString文件名稱是返回值requestIdString請求Id是codeInt32狀態(tài)碼否messageString提示信息否successBoolean是否成功是接口說明:算力公共服務(wù)平臺調(diào)用接口,用于文件上傳接口訪問方法:DELETE/api/v1/efs/{efsId}對象存儲管理創(chuàng)建桶創(chuàng)建桶接口要求見表22。通算接口-創(chuàng)建桶接口名稱及參數(shù)要求消息體類型參數(shù)名參數(shù)類型說明是否必選請求參數(shù)nameString桶名稱是regionString可用區(qū)是storageClassEnum(STANDARD("標(biāo)準(zhǔn)存儲"),STANDARD_IA("低頻訪問存儲"),GLACIER("歸檔存儲"),UNKNOWN("未知")存儲類型是descriptionString描述否chargeTypeEnum(year,month,hour)計(jì)費(fèi)模式,值為year,month,hour否durationInteger訂購時長(月/年)否bucketAclEnum(PUBLIC_READ_WRITE("公共讀寫","public-read-write"),PUBLIC_READ("公共讀","public-read"),PRIVATE("私有","private"),AUTHENTICATED_READ("認(rèn)證用戶可讀","authenticated-read"),PUBLIC_READ_DELIVERED("公共讀","public-read-delivered"),PUBLIC_READ_WRITE_DELIVERED("公共讀寫","public-read-write-delivered"),UNKNOWN("未知","")桶權(quán)限是capacityLong桶的初始容量否返回值requestIdString請求Id是codeInt32狀態(tài)碼否messageString提示信息否entityObject<創(chuàng)建資源返回實(shí)體>返回實(shí)體否orderIdString訂單ID,如果返回的是訂單ID,需要提供根據(jù)訂單ID查詢資源ID的接口是└bucketIdSting資源唯一標(biāo)識(ID)否└successBoolean是否成功是接口說明:算力公共服務(wù)平臺調(diào)用接口,用于創(chuàng)建對象存儲桶接口訪問方法:GET/api/v1/bucket/create查看對象存儲桶目錄查看對象存儲桶目錄接口要求見表23。通算接口-查看對象存儲桶目錄接口名稱及參數(shù)要求消息體類型參數(shù)名參數(shù)類型說明是否必選請求參數(shù)bucketIdString桶唯一標(biāo)識ID必填pageSizeInteger分頁頁面大小非必填pageNumInteger分頁頁碼非必填返回值requestIdString請求Id是codeInt32狀態(tài)碼否messageString提示信息否entityObject<桶實(shí)體>返回實(shí)體否└totalInteger總個數(shù)是└listList<桶實(shí)體>桶列表否└└bucketIdStringID是└└nameString桶名稱是└└regionString可用區(qū)是└└storageClassEnum(STANDARD("標(biāo)準(zhǔn)存儲"),STANDARD_IA("低頻訪問存儲"),GLACIER("歸檔存儲"),UNKNOWN("未知"))存儲類型是└└descriptionString描述否└└chargeTypeEnum(year,month,hour)計(jì)費(fèi)模式,值為year,month,hour否└└bucketAclEnum(PUBLIC_READ_WRITE("公共讀寫","public-read-write"),PUBLIC_READ("公共讀","public-read"),PRIVATE("私有","private"),AUTHENTICATED_READ("認(rèn)證用戶可讀","authenticated-read"),PUBLIC_READ_DELIVERED("公共讀","public-read-delivered"),PUBLIC_READ_WRITE_DELIVERED("公共讀寫","public-read-write-delivered"),UNKNOWN("未知","")桶權(quán)限否└└capacityLong桶的初始容量否└└createdTimeString文件存儲創(chuàng)建時間否└└modifiedTimeString文件存儲修改時間否└└statusEnum(AVAILABLE,UNKNOWN)狀態(tài)。AVAILABLE可用;UNKNOWN不可用;否└└expiredTimeString過期時間否successBoolean是否成功是接口說明:算力公共服務(wù)平臺調(diào)用接口,用于查看對象存儲目錄接口訪問方法:GET/api/v1/bucket/list對象存儲文件上傳接口要求對象存儲文件上傳接口見表24。通算接口-對象存儲文件上傳接口名稱及參數(shù)要求消息體類型參數(shù)參數(shù)類型說明是否必選請求參數(shù)bucketNameString桶名稱是parentPathString父路徑是folderString文件夾名稱是返回值requestIdString請求Id是codeInt32狀態(tài)碼否messageString提示信息否successBoolean是否成功是entityObject<對象實(shí)體>返回實(shí)體是bucketNameString桶名稱否sourceKeyString對象鍵是versionIdString版本號否parentIdString父對象ID是sizeLong文件大小,單位byte(B)是formatString文件格式是isFolderBoolean是否文件夾是eTagStringeTag否LastModifiedString最新修改時間否接口說明:算力公共服務(wù)平臺調(diào)用接口,用于查看文件上傳接口訪問方法:POST/api/v1/os-objects/folder刪除文件夾/對象刪除文件夾/對象接口要求見表25。通算接口-刪除文件夾/對象接口名稱及參數(shù)要求消息體類型請求參數(shù)參數(shù)說明是否必選請求參數(shù)bucketNameString桶名稱是sourceKeyString對象鍵是返回值requestIdString請求Id是codeInt32狀態(tài)碼否messageString提示信息否successBoolean是否成功是接口說明:算力公共服務(wù)平臺調(diào)用接口,用于文件上傳接口訪問方法:DELETE/api/v1/os-objects/object對象存儲文件上傳對象存儲文件上傳接口見表26。通算接口-對象存儲文件上傳接口名稱及參數(shù)要求消息體類型參數(shù)參數(shù)類型說明是否必選請求參數(shù)bucketNameString桶名稱是parentPathString父路徑是fileMultipartFile上傳文件是返回值requestIdString請求Id是codeInt32狀態(tài)碼否messageString提示信息否successBoolean是否成功是entityObject<對象實(shí)體>返回實(shí)體是└bucketNameString桶名稱是└sourceKeyString對象鍵是└versionIdString版本號是└parentIdString父對象ID是└sizeLong文件大小,單位byte(B)是└formatString文件格式是└isFolderBoolean是否文件夾否└eTagStringeTag否└LastModifiedString最新修改時間否接口說明:算力公共服務(wù)平臺調(diào)用接口,用于上傳文件接口訪問方法:PUT/api/v1/os-objects/file/upload查看對象存儲目錄查看對象存儲目錄接口要求見表27。通算接口-查看對象存儲目錄接口名稱及參數(shù)要求消息體類型參數(shù)名參數(shù)類型說明是否必選請求參數(shù)bucketNameString桶名稱是pageSizeInteger分頁頁面大小否pageNumInteger分頁頁碼否返回值requestIdString請求Id是codeInt32狀態(tài)碼否messageString提示信息否entityObject<桶實(shí)體>返回實(shí)體否└totalInteger總個數(shù)是└listList<桶實(shí)體>桶列表否└└bucketNameString桶名稱是└└nameString桶名稱是└└sourceKeyString對象鍵是└└versionIdString版本號是└└parentIdString父對象ID是└└sizeLong文件大小,單位byte(B)是└└formatString文件格式是└└isFolderBoolean是否文件夾是└└eTagStringeTag否└└LastModifiedString最新修改時間否successBoolean是否成功是接口說明:算力公共服務(wù)平臺調(diào)用接口,查看桶內(nèi)對象接口訪問方法:GET/api/v1/{bucketName}/os-objects塊存儲管理創(chuàng)建卷創(chuàng)建卷接口要求見表28。通算接口-創(chuàng)建卷接口名稱及參數(shù)要求消息體類型參數(shù)參數(shù)類型說明是否必選請求參數(shù)volumeTypeString硬盤cinder類型是nameString硬盤名稱是sizeInt硬盤大小是quantityInt訂購個數(shù)是shareBoolean是否設(shè)置為共享盤是regionString底層可用區(qū)是descriptionString云硬盤描述否chargeTypeEnum(year,month,hour)計(jì)費(fèi)方式。year/month/hour是durationInt訂購時長(月/年)否返回值requestIdString請求Id是codeString狀態(tài)碼否messageString提示信息否successBoolean是否成功是entityObject<創(chuàng)建資源返回實(shí)體>返回實(shí)體└orderIdString訂單ID,如果返回的是訂單ID,需要提供根據(jù)訂單ID查詢資源ID的接口└volumeIdString資源唯一標(biāo)識(ID)接口說明:算力公共服務(wù)平臺調(diào)用接口,用于創(chuàng)建云硬盤卷接口訪問方法:POST/api/v1/volumes/create刪除卷刪除卷接口要求見表29。通算接口-刪除卷接口名稱及參數(shù)要求消息體類型參數(shù)參數(shù)類型說明是否必選請求參數(shù)volumeIdString路徑參數(shù),云硬盤唯一標(biāo)識ID是返回值requestIdString請求Id是codeString狀態(tài)碼否messageString提示信息否successBoolean是否成功是接口說明:算力公共服務(wù)平臺調(diào)用接口,用于刪除卷接口訪問方法:DELETE/api/v1/volumes/{volumeId}查詢塊存儲查詢塊存儲接口要求見表30。通算接口-查詢塊存儲接口名稱及參數(shù)要求消息體類型參數(shù)參數(shù)類型說明是否必選請求參數(shù)volumeIdString卷ID是返回值requestIdString請求Id是codeInt32狀態(tài)碼否messageString提示信息否successBoolean是否成功是entityObject<云硬盤實(shí)體>返回實(shí)體是└createdTimeString創(chuàng)建時間是└modifiedTimeString修改時間是└descriptionString硬盤描述是└idString硬盤id是└deletedBoolean是否被刪除是└isShareBoolean是否共享是└iscsiBoolean是否支持ISCSI是└bootableBoolean是否是系統(tǒng)盤是└chargeTypeEnum(year,month,hour)計(jì)費(fèi)模式,值為year,month,hour是└expiredTimeString過期時間是└nameString硬盤name是└regionString可用區(qū)是└serverIdsList<String>硬盤掛載主機(jī)Id列表否sizeInteger硬盤大小是statusEnum(AVAILABLE,IN_USE,ERROR,UNKNOWN)硬盤狀態(tài)。AVAILABLE可用;IN_USE已掛載;ERROR錯誤;UNKNOWN未知;是接口說明:算力公共服務(wù)平臺調(diào)用接口,用于查詢塊存儲接口訪問方法:GET/api/v1/volumes/{volume_id}修改塊存儲修改塊存儲接口要求見表31。通算接口-修改塊存儲接口名稱及參數(shù)要求消息體類型參數(shù)名稱參數(shù)類型說明是否必選請求參數(shù)volumeIdString路徑參數(shù),云主機(jī)唯一標(biāo)識是nameString云主機(jī)名稱否descString描述否返回值requestIdString請求Id是codeString狀態(tài)碼否messageString提示信息否successBoolean是否成功是接口說明:算力公共服務(wù)平臺請求修改塊存儲信息接口訪問方法:PUT/api/v1/volumes/update掛載/卸載云硬盤掛載/卸載云硬盤接口要求見表32。通算接口-掛載/卸載云硬盤接口名稱及參數(shù)要求消息體類型參數(shù)參數(shù)類型說明是否必選請求參數(shù)volumeIdString卷ID是InstanceIdString主機(jī)ID是返回值requestIdString請求ID是codeString狀態(tài)碼否messageString提示信息否successBoolean是否成功是接口說明:算力公共服務(wù)平臺調(diào)用接口,用于掛載/卸載主機(jī)上的云硬盤掛載云盤接口訪問方法:PUT/api/v1/volumes/mount卸載云盤接口訪問方法:PUT/api/v1/volumes/unmount網(wǎng)絡(luò)實(shí)例管理私有云VPC接口管理創(chuàng)建VPC創(chuàng)建VPC接口要求見表33。通算接口-創(chuàng)建VPC接口名稱及參數(shù)要求消息體類型參數(shù)參數(shù)類型說明是否必選請求參數(shù)cidrStringIPv4協(xié)議子網(wǎng)網(wǎng)段,選擇創(chuàng)建IPv4協(xié)議或IPv4+IPv6雙棧協(xié)議子網(wǎng)時必選。否cidrV6StringIPv6協(xié)議子網(wǎng)網(wǎng)段,選擇創(chuàng)建IPv6協(xié)議或IPv4+IPv6雙棧協(xié)議子網(wǎng)時必選,且cidrV6只支持填寫64。否nameStringVPC名稱。是subnetNameStringVPC首個子網(wǎng)名稱。是subnetTypeEnumEnumVPC子網(wǎng)類型,可選值包括:VM、IRONIC。否regionStringVPC首個子網(wǎng)所屬可用區(qū)。是specsStringVPC規(guī)格是返回值requestIdString請求ID是codeString狀態(tài)碼否messageString提示信息否successBoolean是否成功是vpcIdStringVPC唯一標(biāo)識(ID)是接口說明:算力公共服務(wù)平臺調(diào)用接口,用于掛載/卸載主機(jī)上的云盤接口訪問方法:POST/api/v1/vpcs/create查看VPC詳情查看VPC詳情接口要求見表34。通算接口-查看VPC詳情接口名稱及參數(shù)要求消息體類型參數(shù)參數(shù)類型說明是否必選請求參數(shù)vpcIdString路徑參數(shù),VPC唯一標(biāo)識是返回值requestIdString請求Id是codeInt32狀態(tài)碼否messageString提示信息否successBoolean是否成功是entityObject<VPC實(shí)體>返回實(shí)體是└modifiedTimeStringVPC修改時間是└createdTimeStringVPC創(chuàng)建時間是└deletedBoolean是否刪除:true-已刪除;false-未刪除是└descriptionStringVPC描述是└statusEnum(ACTIVE,ERROR,UNKNOWN)狀態(tài)。ACTIVE正常;ERROR錯誤;UNKNOWN未知;是└idStringVPCID是└nameStringVPC名稱是└regionString子網(wǎng)可用區(qū)是└specStringVPC規(guī)格是接口說明:算力公共服務(wù)平臺調(diào)用接口,用于查詢VPC詳情接口訪問方法:GET/api/v1/vpcs/{vpcid}刪除VPC刪除VPC接口要求見表35。通算接口-刪除VPC接口名稱及參數(shù)要求消息體類型參數(shù)參數(shù)類型說明是否必選請求參數(shù)vpcIdString路徑參數(shù),VPC唯一標(biāo)識ID是返回值requestIdString請求Id是codeString狀態(tài)碼否messageString提示信息否successBoolean是否成功是接口說明:算力公共服務(wù)平臺調(diào)用接口,用于刪除VPC接口訪問方法:DELETE/api/v1/vpcs/{vpcId}子網(wǎng)管理創(chuàng)建子網(wǎng)創(chuàng)建子網(wǎng)接口要求見表36。通算接口-創(chuàng)建子網(wǎng)接口名稱及參數(shù)要求消息體類型參數(shù)參數(shù)類型說明是否必選請求參數(shù)regionString可用區(qū)是nameString子網(wǎng)名稱是typeEnum(VM,IRONIC)網(wǎng)絡(luò)的類型,默認(rèn)VM,云主機(jī)類型網(wǎng)絡(luò)不可綁定物理機(jī),反之亦然是vpcIdString關(guān)聯(lián)VPCid是cidrString子網(wǎng)cidr是ipVersionEnum(4,6)ip版本,4--IPv4,6--IPv6是返回值requestIdString請求ID是codeString狀態(tài)碼否messageString提示信息否successBoolean是否成功是subnetIdString子網(wǎng)唯一標(biāo)識(ID)是接口說明:算力公共服務(wù)平臺調(diào)用接口,用于創(chuàng)建子網(wǎng)接口訪問方法:POST/api/v1/subnets/create查看子網(wǎng)詳情查看子網(wǎng)詳情接口要求見表37。通算接口-查看子網(wǎng)詳情接口名稱及參數(shù)要求消息體類型參數(shù)參數(shù)類型說明是否必選請求參數(shù)subnetIdString路徑參數(shù),VPC唯一標(biāo)識是返回值requestIdString請求Id是codeInt32狀態(tài)碼否messageString提示信息否successBoolean是否成功是entityObject<子網(wǎng)實(shí)體>返回實(shí)體是└ipv4CidrString子網(wǎng)v4網(wǎng)段是└ipv6CidrString子網(wǎng)v6網(wǎng)段是└createdTimeString子網(wǎng)創(chuàng)建時間是└deletedBoolean子網(wǎng)是否刪除:true-已刪除;false-未刪除是└idString子網(wǎng)ID是└ipVersionEnum(4,6)子網(wǎng)IP協(xié)議類型:4-IPv4;6-IPv6是└nameString子網(wǎng)名稱是└vpcIdString子網(wǎng)所屬的VPCID是└typeEnum(VM,IRONIC)子網(wǎng)所屬的網(wǎng)絡(luò)類型:VM-云主機(jī)子網(wǎng);IRONIC-裸金屬子網(wǎng)是└regionString子網(wǎng)可用區(qū)接口說明:算力公共服務(wù)平臺調(diào)用接口,用于查詢子網(wǎng)詳情接口訪問方法:GET/api/v1/subnets/{subnetId}更新子網(wǎng)更新子網(wǎng)接口要求見表38。通算接口-更新子網(wǎng)接口名稱及參數(shù)要求消息體類型參數(shù)參數(shù)類型說明是否必選請求參數(shù)subnetIdString子網(wǎng)唯一標(biāo)識是subnetNameString子網(wǎng)名稱否返回值requestIdString請求Id是codeString狀態(tài)碼否messageString提示信息否successBoolean是否成功是接口說明:算力公共服務(wù)平臺調(diào)用接口,用于更新子網(wǎng)接口訪問方法:PUT/api/v1/subnets/update刪除子網(wǎng)刪除子網(wǎng)接口要求見表39。通算接口-刪除子網(wǎng)接口名稱及參數(shù)要求消息體類型參數(shù)參數(shù)類型說明是否必選請求參數(shù)subnetIdString路徑參數(shù),子網(wǎng)唯一標(biāo)識ID是返回值requestIdString請求Id是codeString狀態(tài)碼否messageString提示信息否successBoolean是否成功是接口說明:算力公共服務(wù)平臺調(diào)用接口,用于刪除子網(wǎng)接口訪問方法:DELETE/api/v1/subnets/{subnetId}虛擬網(wǎng)卡管理創(chuàng)建虛擬網(wǎng)卡創(chuàng)建虛擬網(wǎng)卡接口要求見表40。通算接口-創(chuàng)建虛擬網(wǎng)卡接口名稱及參數(shù)要求消息體類型參數(shù)參數(shù)類型說明是否必選請求參數(shù)ipv4AddressString指定的ipv4地址否ipv6AddressString指定的ipv6地址否subnetIdString子網(wǎng)id是macAddressStringmac地址否nameString網(wǎng)卡名稱是regionString可用區(qū)否sgIdsList<String>安全組id否typeEnum(vm,ironic,nas)vm-云主機(jī)網(wǎng)卡,ironic-裸金屬網(wǎng)卡,nas-NAS網(wǎng)卡否返回值requestIdString請求Id是codeString狀態(tài)碼否messageString提示信息否successBoolean是否成功是portIdString子網(wǎng)唯一標(biāo)識(ID)是接口說明:算力公共服務(wù)平臺調(diào)用接口,用于創(chuàng)建虛擬網(wǎng)卡接口訪問方法:POST/api/v1/ports/create刪除虛擬網(wǎng)卡刪除虛擬網(wǎng)卡接口要求見表41。通算接口-刪除虛擬網(wǎng)卡名稱及參數(shù)要求消息體類型參數(shù)參數(shù)類型說明是否必選請求參數(shù)portIdString路徑參數(shù),虛擬網(wǎng)卡唯一標(biāo)識ID是返回值requestIdString請求Id是codeString狀態(tài)碼否messageString提示信息否successBoolean是否成功是接口說明:算力公共服務(wù)平臺調(diào)用接口,用于刪除子網(wǎng)接口訪問方法:DELETE/api/v1/ports/{portId}綁定/解綁虛擬網(wǎng)卡綁定/解綁虛擬網(wǎng)卡接口要求見表42。通算接口-綁定/解綁虛擬網(wǎng)卡接口名稱及參數(shù)要求消息體類型參數(shù)參數(shù)類型說明是否必選請求參數(shù)portIdString虛擬網(wǎng)卡唯一標(biāo)識ID是instanceIdString服務(wù)器唯一標(biāo)識ID綁定必選,解綁否返回值requestIdString請求Id是codeString狀態(tài)碼否messageString提示信息否successBoolean是否成功是接口說明:算力公共服務(wù)平臺調(diào)用接口,用于綁定/解綁虛擬網(wǎng)卡綁定虛擬網(wǎng)卡接口訪問方法:PUT/api/v1/ports/bind解綁虛擬網(wǎng)卡接口訪問方法:PUT/api/v1/ports/unbind查看虛擬網(wǎng)卡詳情查看虛擬網(wǎng)卡詳情接口要求見表43。通算接口-查看虛擬網(wǎng)卡詳情接口名稱及參數(shù)要求消息體類型參數(shù)參數(shù)類型說明是否必選請求參數(shù)portIdString路徑參數(shù),虛擬網(wǎng)卡唯一標(biāo)識ID是返回值requestIdString請求Id是codeString狀態(tài)碼否messageString提示信息否successBoolean是否成功是entityObject<VPC實(shí)體>返回實(shí)體└createdTimeString虛擬網(wǎng)卡創(chuàng)建時間└deletedBoolean虛擬網(wǎng)卡是否刪除:true-已刪除;false-未刪除└ipv4AddressStringIpv4地址└ipVersionEnum(4,6)所屬的子網(wǎng)IP協(xié)議類型:4-IPv4;6-IPv6└ipv6AddressStringIpv6地址└subnetIdString子網(wǎng)ID└subnetNameString子網(wǎng)名稱└vpcIdString所屬的VPCID└vpcNameString所屬的VPC名稱└idString虛擬網(wǎng)卡ID└macAddressString虛擬網(wǎng)卡的MAC地址└nameString虛擬網(wǎng)卡名稱└statusEnum(AVAILABLE,,INUSE,UNKNOWN)虛擬網(wǎng)卡綁定資源操作狀態(tài):AVAILABLE-可用;INUSE-已綁定;UNKNOWN-未知;└regionString可用區(qū)└resourceTypeEnum(vm,ironic)虛擬網(wǎng)卡綁定類型:vm-云主機(jī)網(wǎng)卡;ironic-裸金屬網(wǎng)卡;└resourceIdString綁定的資源ID└resourceNameString綁定的資源名稱└sgIdsList<String>關(guān)聯(lián)的安全組ID列表└typeEnum(PRIMARY,SECONDARY)虛擬網(wǎng)卡類型:PRIMARY:主網(wǎng)卡;SECONDARY:輔助彈性網(wǎng)卡;接口說明:算力公共服務(wù)平臺調(diào)用接口,用于查看虛擬網(wǎng)卡接口訪問方法:GET/api/v1/ports/{portId}虛擬網(wǎng)卡關(guān)聯(lián)安全組虛擬網(wǎng)卡關(guān)聯(lián)安全組接口要求見表44。通算接口-虛擬網(wǎng)卡關(guān)聯(lián)安全組接口名稱及參數(shù)要求消息體類型參數(shù)參數(shù)類型說明是否必選請求參數(shù)portIdString虛擬網(wǎng)卡唯一標(biāo)識ID是sgIdsList<String>安全組ID列表是返回值requestIdString請求Id是codeString狀態(tài)碼否messageString提示信息否successBoolean是否成功是接口說明:算力公共服務(wù)平臺調(diào)用接口,用于虛擬網(wǎng)卡關(guān)聯(lián)安全組接口訪問方法:PUT/api/v1/ports/attach-securitygroups安全組管理安全組創(chuàng)建安全組創(chuàng)建接口要求見表45。通算接口-安全組創(chuàng)建接口名稱及參數(shù)要求消息體類型參數(shù)參數(shù)類型說明是否必選請求參數(shù)descriptionString安全組描述否nameString安全組名稱是statefulBoolean安全組是否為有狀態(tài):true-有狀態(tài)(默認(rèn));false-無狀態(tài)否typeEnum(VM,IRONIC,NAS,EW)安全組類型:VM-云主機(jī)(默認(rèn));IRONIC-裸金屬;NAS-NAS網(wǎng)卡;EW-東西向網(wǎng)卡否返回值requestIdString請求Id是codeString狀態(tài)碼否messageString提示信息否successBoolean是否成功是securitygroupIdString安全組唯一標(biāo)識(ID)是接口說明:算力公共服務(wù)平臺調(diào)用接口,用于創(chuàng)建虛擬網(wǎng)卡接口訪問方法:POST/api/v1/securitygroups/create安全組更新安全組更新接口要求見表46。通算接口-創(chuàng)建安全組接口名稱及參數(shù)要求消息體類型參數(shù)參數(shù)類型說明是否必選請求參數(shù)securitygroupIdString安全組唯一標(biāo)識ID是nameString名稱否descString描述否返回值requestIdString請求Id是codeString狀態(tài)碼否messageString提示信息否successBoolean是否成功是接口說明:算力公共服務(wù)平臺調(diào)用接口,用于創(chuàng)建虛擬網(wǎng)卡接口訪問方法:PUT/api/v1/securitygroups/update安全組刪除安全組刪除接口要求見表47。通算接口-安全組刪除接口名稱及參數(shù)要求消息體類型參數(shù)參數(shù)類型說明是否必選請求參數(shù)securitygroupIdString路徑參數(shù),安全組唯一標(biāo)識ID是返回值requestIdString請求Id是codeString狀態(tài)碼否messageString提示信息否successBoolean是否成功是接口說明:算力公共服務(wù)平臺調(diào)用接口,用于刪除子網(wǎng)接口訪問方法:DELETE/api/v1/ports/{portId}公網(wǎng)IP管理創(chuàng)建彈性公網(wǎng)IP創(chuàng)建彈性公網(wǎng)IP接口要求見表48。通算接口-創(chuàng)建彈性公網(wǎng)IP接口名稱及參數(shù)要求消息體類型參數(shù)參數(shù)類型說明是否必選請求參數(shù)chargeModeEnum(trafficCharge,bandwidthCharge)計(jì)費(fèi)方式:trafficCharge-按流量計(jì)費(fèi);bandwidthCharge-按帶寬計(jì)費(fèi)是bandwidthSizeInteger公網(wǎng)IP的帶寬大小,單位:MB是floatingIpAddressString指定彈性公網(wǎng)IP創(chuàng)建IP地址否quantityInteger訂購個數(shù)是ipTypeEnum(MOBILE,MULTI_LINE)公網(wǎng)IP接入類型:MOBILE-移動類型IP;MULTI_LINE-多線類型IP是descriptionString彈性公網(wǎng)IP描述否chargeTypeEnum(year,month,hour)計(jì)費(fèi)模式,值為year,month,hour否durationInteger訂購時長(月/年)否返回值requestIdString請求Id是codeString狀態(tài)碼否messageString提示信息否successBoolean是否成功是floatingipIdString彈性公網(wǎng)唯一標(biāo)識(ID)是接口說明:算力公共服務(wù)平臺調(diào)用接口,用于創(chuàng)建彈性公網(wǎng)IP。接口訪問方法:POST/api/v1/floatingips/create刪除彈性公網(wǎng)IP刪除彈性公網(wǎng)IP接口要求見表49。通算接口-刪除彈性公網(wǎng)IP接口名稱及參數(shù)要求消息體類型參數(shù)參數(shù)類型說明是否必選請求參數(shù)floatingipIdString路徑參數(shù),公網(wǎng)IP唯一標(biāo)識ID是返回值requestIdString請求Id是codeString狀態(tài)碼否messageString提示信息否successBoolean是否成功是接口說明:算力公共服務(wù)平臺調(diào)用接口,用于刪除彈性公網(wǎng)IP接口訪問方法:DELETE/api/v1/floatingips/{floatingipId}超算接口要求查詢超算查詢超算集群列表查詢超算集群列表接口要求見表50。超算接口-查詢超算集群列表名稱及參數(shù)要求消息體類型返回參數(shù)參數(shù)類型說明是否必選返回值codeString狀態(tài)碼否messageString提示信息否isdataBoolean是否返回?cái)?shù)據(jù)是regionlistarray集群區(qū)域信息列表否└regioninfoobject集群區(qū)域信息否└└nameString集群區(qū)域名稱否└└descriptionString集群區(qū)域描述否└└region_idString集群區(qū)域ID否└userinfoobject集群用戶信息否└└└account_idString主用戶ID是└└└usernameString用戶名是└└└user_idString用戶ID是└└ailurlsStringAI服務(wù)訪問信息否└└efileurlsString文件服務(wù)訪問信息否└└eshellsshhostsString命令行訪問方式下登錄節(jié)點(diǎn)信息否└└eshellurlsString命令行訪問方式下服務(wù)訪問信息否└└hpcurlsString高性能計(jì)算服務(wù)訪問信息否└└InternetsshhostsString集群互聯(lián)網(wǎng)登錄節(jié)點(diǎn)信息否successBoolean是否成功否接口說明:算力公共服務(wù)平臺調(diào)用接口,用于查詢超算集群列表接口訪問方法:GET/api/v1/cluster查詢分區(qū)隊(duì)列查詢超算分區(qū)隊(duì)列接口要求見表51。超算接口-查詢分區(qū)隊(duì)列接口名稱及參數(shù)要求消息體類型參數(shù)名參數(shù)類型說明是否必選請求參

溫馨提示

  • 1. 本站所有資源如無特殊說明,都需要本地電腦安裝OFFICE2007和PDF閱讀器。圖紙軟件為CAD,CAXA,PROE,UG,SolidWorks等.壓縮文件請下載最新的WinRAR軟件解壓。
  • 2. 本站的文檔不包含任何第三方提供的附件圖紙等,如果需要附件,請聯(lián)系上傳者。文件的所有權(quán)益歸上傳用戶所有。
  • 3. 本站RAR壓縮包中若帶圖紙,網(wǎng)頁內(nèi)容里面會有圖紙預(yù)覽,若沒有圖紙預(yù)覽就沒有圖紙。
  • 4. 未經(jīng)權(quán)益所有人同意不得將文件中的內(nèi)容挪作商業(yè)或盈利用途。
  • 5. 人人文庫網(wǎng)僅提供信息存儲空間,僅對用戶上傳內(nèi)容的表現(xiàn)方式做保護(hù)處理,對用戶上傳分享的文檔內(nèi)容本身不做任何修改或編輯,并不能對任何下載內(nèi)容負(fù)責(zé)。
  • 6. 下載文件中如有侵權(quán)或不適當(dāng)內(nèi)容,請與我們聯(lián)系,我們立即糾正。
  • 7. 本站不保證下載資源的準(zhǔn)確性、安全性和完整性, 同時也不承擔(dān)用戶因使用這些下載資源對自己和他人造成任何形式的傷害或損失。

評論

0/150

提交評論