呼叫 RoutePrivateZoneInCenToVpc 介面設定 PrivateZone 服務。
介面說明
PrivateZone 是基於阿里雲端專有網路 VPC(Virtual Private Cloud)環境的私有 DNS 網域名稱解析和管理服務。邊界路由器 VBR(Virtual Border Router)執行個體、雲連接網 CCN(Cloud Connect Network)執行個體載入到雲企業網中後,其關聯的地端網路可以透過雲企業網存取 PrivateZone 服務。
-
VBR 執行個體和 CCN 執行個體關聯的地端網路只能存取和其同地域的 PrivateZone 服務。
例如:PrivateZone 服務所在地為華北 2(北京),那麼只有華北 2(北京)地域下的 VBR 執行個體和中國內地 CCN 執行個體關聯的地端網路可以存取 PrivateZone 服務。
-
RoutePrivateZoneInCenToVpc 介面屬於非同步介面,即系統會先返回一個 RequestId,但 PrivateZone 服務設定並未新增完成,系統背景的新增任務仍在進行。您可以呼叫 DescribeCenPrivateZoneRoutes 介面查詢 PrivateZone 服務的狀態。
當 PrivateZone 服務處於 Creating 狀態時,表示 PrivateZone 服務設定正在新增中,在該狀態下,您只能對 PrivateZone 服務設定執行查詢操作,不能執行其他操作。
當 PrivateZone 服務處於 Active 狀態時,表示 PrivateZone 服務設定新增完成。
當 PrivateZone 服務處於 Failed 狀態時,表示 PrivateZone 服務設定新增失敗。
前提條件
在呼叫 RoutePrivateZoneInCenToVpc 介面前,確保滿足以下條件:
您已部署好 PrivateZone 服務。具體操作,請參見雲解析 PrivateZone 快速入門。
確保 PrivateZone 服務關聯的 VPC 執行個體、存取所在地的 VBR 執行個體或 CCN 執行個體已載入至同一個雲企業網執行個體。具體操作,請參見 AttachCenChildInstance 。
如果您地端網路使用 CCN 執行個體接入阿里雲端,且 CCN 執行個體所屬帳號與 VPC 執行個體所屬帳號、雲企業網執行個體所屬帳號不同,那麼您需要先完成對 CCN 執行個體的授權。具體操作,請參見雲連接網授權。
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
|
操作 |
存取層級 |
資源類型 |
條件關鍵字 |
關聯操作 |
|
cen:RoutePrivateZoneInCenToVpc |
create |
*CenInstance
|
無 | 無 |
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| CenId |
string |
是 |
雲企業網執行個體 ID。 |
cen-7qthudw0ll6jmc**** |
| AccessRegionId |
string |
是 |
存取 PrivateZone 服務的地域 ID。 存取所在地是指存取 PrivateZone 服務的地域。 您可以透過呼叫 DescribeChildInstanceRegions 介面取得地域 ID。 |
cn-hangzhou |
| HostRegionId |
string |
是 |
PrivateZone 服務所在的地域 ID。 |
cn-hangzhou |
| HostVpcId |
string |
是 |
PrivateZone 服務關聯的 VPC 執行個體 ID。 |
vpc-bp1h8vbrbcgohcju5**** |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
|||
| RequestId |
string |
請求 ID。 |
C0245BEF-52AC-44A8-A776-EF96FD26A5CA |
樣本
正常返回樣本
JSON格式
{
"RequestId": "C0245BEF-52AC-44A8-A776-EF96FD26A5CA"
}
錯誤碼
|
HTTP status code |
錯誤碼 |
錯誤資訊 |
描述 |
|---|---|---|---|
| 400 | OperationUnsupported.CrossRegionNotSupport | Operation Failed. Host region Id is not equal to access region Id, VPC or VBR not support cross region privatezone service. | 主機地域 ID 與接入地域 ID 不一致,VPC 或 VBR 不支援跨地域 PrivateZone 服務。 |
| 400 | Forbidden.PrivatezoneServiceNotAuthorize | Privatezone service not to grant authorization. | Privatezone 服務未授權。 |
| 400 | ParameterIllegal.AccessRegionIdNoCCN | Parameter Access RegionId illegal. | |
| 400 | InvalidParameter | Invalid parameter. | 參數不合法。 |
| 400 | Unauthorized | The AccessKeyId is unauthorized. | 帳號無權限操作。 |
| 400 | InvalidParameter.CenId | The specified parameter CenId is invalid. | |
| 403 | InvalidOperation.PvtzNotAssociatedWithVpc | Privatezone not associated with the specified vpc. | Privatezone 未綁定指定的 VPC。 |
| 409 | InvalidOperation.PrivatezoneRouteExisted | Privatezone routes already existed. | Private Zone 路由已存在。 |
| 409 | InvalidOperation.VpcNotAttachedToCen | Vpc not attached to cen. | 該 VPC 未綁定到 CEN 中。 |
| 409 | InvalidOperation.UnmatchRouteInVpcRegion | Operation Failed.Unmatch route in vpc region. | VPC 區域中的路由不匹配。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊,參考變更詳情。