調用RoutePrivateZoneInCenToVpc介面設定PrivateZone服務。
介面說明
PrivateZone 是基於阿里雲Virtual Private Cloud(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 服務。具體操作,請參見Alibaba Cloud DNS 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. | 帳號無許可權操作。 |
| 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地區中的路由不匹配。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊,參考變更詳情。