您可以透過呼叫 ResolveAndRouteServiceInCen 介面設定雲端服務,為地端網路新增存取雲端服務的組態。
介面說明
雲端服務指使用阿里雲雲端服務位址段 100.64.0.0/10 提供服務的雲端產品,例如物件儲存 OSS(Object Storage Service)、日誌服務 SLS(Log Service)、資料傳輸服務 DTS(Data Transmission Service)等。若您的地端網路需要存取雲端服務,您需要將地端網路關聯的邊界路由器 VBR(Virtual Border Router)執行個體或雲連接網 CCN(Cloud Connect Network)執行個體載入至雲企業網,並且將雲端服務所在地域的一個專有網路 VPC(Virtual Private Cloud)執行個體載入至該雲企業網。載入後,您的地端網路可透過雲企業網存取雲端服務所在地域的 VPC 執行個體,並透過該 VPC 存取雲端服務。
-
使用限制,該介面僅適用於基礎版轉發路由器。VBR 執行個體關聯的地端網路只能透過雲企業網存取和其同地域的雲端服務。
例如:雲端服務所在地域為華北 2(北京),那麼只有華北 2(北京)地域下的 VBR 執行個體關聯的地端網路可以存取雲端服務。
-
ResolveAndRouteServiceInCen 介面屬於非同步介面,即系統會先返回一個 RequestId,但雲端服務組態並未新增完成,系統後台的新增任務仍在進行。您可以呼叫 DescribeRouteServicesInCen 介面查詢雲端服務的狀態。
當雲端服務處於 Creating 狀態時,表示雲端服務組態正在新增中,在該狀態下,您只能對雲端服務組態執行查詢操作,不能執行其他操作。
當雲端服務處於 Active 狀態時,表示雲端服務組態新增完成。
當雲端服務處於 Failed 狀態時,表示雲端服務組態新增失敗。
前提條件
在呼叫 ResolveAndRouteServiceInCen 介面前,確保滿足以下條件:
您地端網路連線的 VBR 或 CCN 執行個體已經載入到雲企業網。
雲端服務所在地域已有 VPC 執行個體載入至雲企業網。具體操作,請參見 AttachCenChildInstance 。
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
|
操作 |
存取層級 |
資源類型 |
條件關鍵字 |
關聯操作 |
|
cen:ResolveAndRouteServiceInCen |
create |
*CenInstance
|
無 | 無 |
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| ClientToken |
string |
否 |
用戶端 Token,用於保證請求的冪等性。 從您的用戶端產生一個參數值,確保不同請求間該參數值唯一。ClientToken 只支援 ASCII 字元。 說明
若您未指定,則系統自動使用 API 請求的 RequestId 作為 ClientToken 標識。每次 API 請求的 RequestId 可能不一樣。 |
02fb3da4**** |
| CenId |
string |
是 |
雲企業網執行個體 ID。 |
cen-ckwa2hhmuislse**** |
| Host |
string |
是 |
雲端服務 IP 位址或位址段。 說明
通常雲端服務會使用多個位址或位址段,建議您重複呼叫本介面,新增該雲端服務所有位址或位址段。 |
100.118.28.0/24 |
| HostRegionId |
string |
是 |
雲端服務所在的地域 ID。 |
cn-hangzhou |
| HostVpcId |
string |
是 |
雲端服務關聯的 VPC 執行個體 ID。 |
vpc-o6woh5s494zueq40v**** |
| Description |
string |
否 |
雲端服務的描述資訊。 描述可以為空或長度為 1~256 個字元,不能以 http:// 或 https:// 開頭。 |
descname |
| AccessRegionIds |
array |
是 |
存取雲端服務的地域 ID 清單。 |
cn-hangzhou |
|
string |
否 |
存取雲端服務的地域 ID。 您可以透過呼叫 DescribeChildInstanceRegions 介面取得地域 ID。 |
cn-hangzhou |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
|||
| RequestId |
string |
請求 ID。 |
C0245BEF-52AC-44A8-A776-EF96FD26A5CA |
樣本
正常返回樣本
JSON格式
{
"RequestId": "C0245BEF-52AC-44A8-A776-EF96FD26A5CA"
}
錯誤碼
|
HTTP status code |
錯誤碼 |
錯誤資訊 |
描述 |
|---|---|---|---|
| 400 | ParameterIllegal.Ipv6CloudRouteCidrNotAllow | Parameter Host not in valid ipv6 cidr. | 雲端服務路由不支援 IPv6。 |
| 400 | ParameterIllegal.AccessRegionId | Parameter Access RegionId illegal. | 參數中指定的 AccessRegionId 不合法。 |
| 400 | ParameterIllegal.CloudRouteHost | Parameter Host is not valid. | 參數中指定的 CloudRouteHost 不合法。 |
| 400 | ParameterIllegal.ClouteRouteNotSupportIpv6 | Parameter Host not support IPv6 | 雲端服務路由不支援 IPv6。 |
| 400 | ParameterIllegal.ClouteRouteCidrNotAllow | Parameter Host not in 100.64.0.0/10 | 雲端服務路由網段不合法。 |
| 400 | CloudRoute.Exist | The Specified Cloud Route already Exists | 雲端服務路由已存在。 |
| 400 | ParameterIllegal.Host | Parameter Host does not support domain. | |
| 400 | CloudRoute.Conflict | The Specified Cloud Route Conflicts. | 雲端服務路由衝突。 |
| 400 | CloudRoute.VpcNotAttached | The Specified Vpc instance is not attached to CEN. | |
| 400 | OperationUnsupported.TransitRouterType | The specified TransitRouterType does not support the operation. | 目前的 TransitRouter 類型不支援此操作。 |
| 400 | ParameterIllegal.AccessRegionIdNoCCN | Parameter Access RegionId illegal. | 參數 AccessRegionId 不合法。 |
| 400 | IncorrectStatus.TransitRouter | The resource is not in a valid state for the operation. | 目前 TR 的狀態不支援此操作,請稍後重試。 |
| 400 | InvalidOperation.InstanceNotSupportIPv6Route | IPv6 routing has not been enabled for the CEN instance. | 目前 CEN 未啟用 IPv6 路由功能。 |
| 400 | InvalidParameter | Invalid parameter. | 參數不合法。 |
| 400 | Unauthorized | The AccessKeyId is unauthorized. | 帳號無權限操作。 |
| 400 | InvalidParameter.CenId | The specified parameter CenId is invalid. |
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊,參考變更詳情。