阿里云如何使用高速通道有關(guān)接口

　　新建路由器接口

　　描述

　　創(chuàng)建一個路由器接口(RouterInterface)。

　　關(guān)于路由器接口的介紹，請參見 阿里云文檔-網(wǎng)絡(luò)產(chǎn)品-高速通道-功能介紹。

　　高速通道產(chǎn)品處于公測狀態(tài)。如果您需要使用該功能，請到阿里云官網(wǎng)高速通道產(chǎn)品頁 申請公測資格。

　　該API僅用于生成一個RouterInterface，并未觸發(fā)連接動作。若要真的實現(xiàn)路由器接口的互聯(lián)，需要使用后面的“發(fā)起路由器接口連接”操作。

　　路由器接口之間的“互連”，表示兩個路由器通過一根虛擬的“鏈路”連接起來。若要在鏈路上正確的實現(xiàn)消息的傳遞，還需要在兩邊的路由器上正確地配置路由表，以及在實際通信的對象上正確的配置訪問控制規(guī)則;

　　任意兩個路由器之間，最多只能存在一對互連的RouterInterface。

　　一個路由器上可以最多創(chuàng)建5個路由器接口。

　　一個用戶名下最多可以同時擁有5個路由器接口。

　　若用戶名下有RI處于欠費狀態(tài)，則不允許新建更多的路由器接口。

　　OppositeRouterType、OppositeRouterId、OppositeInterfaceId、 OppositeInterfaceOwnerId四個參數(shù)，用于兩個路由器接口互連時進行校驗。在發(fā)起連接時必須事先填好。所以，您可以選擇在創(chuàng)建時就填好，或者創(chuàng)建出路由器接口之后調(diào)用ModifyRouterInterfaceAttribute來修改。

　　請求參數(shù)

名稱 類型 是否必須 描述
Action   String   是   操作接口名，系統(tǒng)規(guī)定參數(shù)，取值：CreateRouterInterface  
RegionId   String   是   實例所在的地域  
RouterType   String   是   所屬的路由器類型。目前僅支持VRouter這一種類型。
可選值：VRouter  
RouterId   String   是   所屬的路由器Id  
Role   String   是   連接中扮演的角色，即，是連接發(fā)起端還是連接接受端。
可選值：InitiatingSide|AcceptingSide；  
Spec   String   是   規(guī)格，詳見 阿里云文檔-網(wǎng)絡(luò)產(chǎn)品-高速通道-地域、規(guī)格與價格  
OppositeRegionId   String   是   要連接的對端所在的Region.  
OppositeRouterType   String   否   要連接的對端路由器接口所屬的路由器類型。目前僅支持VRouter這一種類型。
可選值：VRouter  
OppositeRouterId   String   否   要連接的對端的路由器的ID。  
OppositeInterfaceId   String   否   要連接的對端RouterInterface的Id  
OppositeInterfaceOwnerId   String   否   連接對端路由器接口的持有者賬號ID。您可以登錄阿里云官網(wǎng)以后，在 控制臺-用戶中心-賬號管理 中看到您的賬號ID。  
Name   String   否   實例的顯示名稱，[2, 128] 英文或中文字符，必須以大小字母或中文開頭，可包含數(shù)字，“.”，“_”或“-”。
實例名稱會顯示在控制臺。
如果沒有指定該參數(shù)，默認(rèn)值為實例的 InstanceId
不能以 和 https:// 開頭。  
Description   String   否   自定義描述[[2, 256] 個字符，實例描述會顯示在控制臺。不填則為空，默認(rèn)為空。不能以 和 https:// 開頭  
ClientToken   String   否   用于保證請求的冪等性。由客戶端生成該參數(shù)值，要保證在不同請求間唯一，最大不值過64個ASCII字符。
具體參見附錄：如何保證冪等性。  

　　返回參數(shù)

名稱 類型 描述
RouterInterfaceId   String   路由器接口的實例ID，由系統(tǒng)生成，全局唯一。是操作路由器接口實例的唯一標(biāo)識  

　　錯誤碼

錯誤代碼 描述 Http 狀態(tài)碼 語義
InvalidRegionId.NotFound   The RegionId provided does not exist in our records.   404   指定的 RegionId 不存在  
InvalidOppositeRegionId.NotFound   The OppositeRegionId provided does not exist in our records.   404   用戶填寫的OppositeRegionId是一個不存在的regionId  
InvalidRegionPair.NotReachable   The specified OppositeRegion is not reachable by ExpressConnect from that region specified by ‘RegionId’   400   用戶指定的兩個region是無法通過高速通道產(chǎn)品進行連接的。  
InvalidRole.ValueNotSupported   The specified Role is not valid.   400   指定的 Role 不合法  
InvalidSpec.ValudNotSupported   The specified Spec is not supported.   400   指定的 Spec 不支持  
InvalidRouterType.ValueNotSupported   The specified RouterType is not valid   400   指定的 RouterType 不合法  
InvalidRouterId.NotFound   The specified RouterId does not exist in our recored.   404   指定的 RouterId 不存在  
InvalidOppositeRouterType.ValueNotSupported   The specified OppositeRouterType is not valid.   400   指定的 OppositeRouterType 不合法  
ParameterMismatch.Role-Spec   The specified Spec and Role mismatch.   400   指定的 Spec 和 Role 不匹配  
ParameterMismatch.RegionId-OppositeRegionId-Spec   The specified Spec is not supported between the specified RegionId and OppositeRegionId.   400   該規(guī)格在這兩個Region之間不支持。  
InvalidName.Malformed   The specified ‘Name’ is not valid.   400   指定的 Name 不合法  
InvalidDescription.Malformed   The specifid ‘Description’ is not valid.   400   指定的 Description 不合法  
Forbidden.BillsOutstanding   You cannot create more RouterInterface because you have bills outstanding.   400   有未結(jié)清的賬單，因而拒絕創(chuàng)建更多的后付費資源；  
QuotaExceed.RouterInterface   Living RouterInterface quota exceeded.   400   已有路由器接口數(shù)量超過配額  
LimitationExceed.InterfaceNumberOnRouter   Total number of RouterInterfaces on a Router exceeded.   400   單個路由器上存在的路由器接口數(shù)量超過配額  
Forbidden.NotInRouterInterfaceCreateWhitelist   Not in router interface create whitelist.   500   帳號不在創(chuàng)建路由器接的白名單中  
RI_CREATE_ONE_LIMIT_BY_SYNC   Create ri only one limit by sync.   500      
InvalidAccessPoint.ValueNotAllowed   The non-vbr router interface cannot have access point configured.   500   非 VBR 路由器接口不能指定接入點信息  
InvalidAccessPoint.ValueNotAllowed   The non-vbr opposite router interface cannot have opposite access point configured.   500   非 VBR 對端路由器接口不能指定接入點信息  
InvalidParam.NotFound   Parameter must not be null,uid, bid,regionNo, remoteRegionNo or routerId   400   ‘uid’, ‘bid’, ‘regionNo’, ‘remoteRegionNo’ 或者 ‘routerId’不能為空  
InvalidAccessPoint.NotMatch   The accessPoint id is not matched   400   接入點Id 不匹配  
InvalidAccessPoint.NotExist   The accessPoint not exit   400   接入點Id 不存在