您可以通過調用ResolveAndRouteServiceInCen介面設定雲端服務,為本網添加訪問雲端服務的配置。
介面說明
雲端服務指使用阿里雲雲端服務位址區段 100.64.0.0/10 提供服務的雲產品,例如Object Storage Service、Log Service SLS(Log Service)、Data Transmission Service(Data Transmission Service)等。如果您的本網需要訪問雲端服務,您需要將本網關聯的邊界路由器 VBR(Virtual Border Router)執行個體或雲串連網 CCN(Cloud Connect Network)執行個體載入至雲企業網,並且將雲端服務所在地區的一個Virtual Private Cloud(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. | 帳號無許可權操作。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊,參考變更詳情。