RoutePrivateZoneInCenToVpc - Cloud Enterprise Network - Alibaba Cloud ドキュメントセンター

操作説明

Alibaba Cloud DNS PrivateZone は、仮想プライベートクラウド (VPC) に基づくプライベートドメインネームシステム (DNS) 解決および管理サービスです。仮想ボーダールータ (VBR) インスタンスまたはクラウド相互接続ネットワーク (CCN) インスタンスが Cloud Enterprise Network (CEN) インスタンスに接続されると、関連付けられたオンプレミスネットワークは CEN インスタンスを介して PrivateZone サービスにアクセスできます。

VBR または CCN インスタンスに関連付けられているオンプレミスネットワークは、同じリージョンでのみ PrivateZone サービスにアクセスできます。

たとえば、PrivateZone サービスが中国 (北京) リージョンにある場合、中国 (北京) リージョンにある VBR インスタンス、または中国本土にある CCN インスタンスに関連付けられているオンプレミスネットワークのみが PrivateZone サービスにアクセスできます。
RoutePrivateZoneInCenToVpc 操作は非同期です。リクエストが送信されると、システムから RequestId が返されます。その後、構成がバックグラウンドで追加されます。DescribeCenPrivateZoneRoutes 操作を呼び出して、PrivateZone サービスのステータスをクエリできます。
- PrivateZone サービスが[作成中]状態の場合、構成が追加されています。この状態では、構成のクエリのみ可能で、他の操作は実行できません。
- PrivateZone サービスが[アクティブ]状態の場合、構成は完了です。
- PrivateZone サービスが[失敗] 状態の場合、構成に失敗しました。

前提条件

RoutePrivateZoneInCenToVpc 操作を呼び出す前に、次の条件が満たされていることを確認してください。

PrivateZone サービスがデプロイされていること。詳細については、「Alibaba Cloud DNS PrivateZone クイックスタート」をご参照ください。
PrivateZone サービスに関連付けられている VPC インスタンスと、アクセスリージョンにある VBR または CCN インスタンスが、同じ CEN インスタンスに接続されていること。詳細については、「AttachCenChildInstance」をご参照ください。
オンプレミスネットワークが CCN インスタンスを介して Alibaba Cloud に接続し、CCN、VPC、および CEN インスタンスが異なるアカウントに属している場合、最初に CCN インスタンスを承認する必要があります。詳細については、「クラウド相互接続ネットワークの承認」をご参照ください。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。
API：アクションを具体的に実行するための API。
アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。
リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。
- リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。
- リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。
条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。
依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

cen:RoutePrivateZoneInCenToVpc

create

*CenInstance

acs:cen:*:{#accountId}:ceninstance/{#ceninstanceId}

なし

リクエストパラメーター

パラメーター	タイプ	必須 / 任意	説明	例
CenId	string	必須	CEN インスタンスの 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

例

成功レスポンス

JSONJSON

{
  "RequestId": "C0245BEF-52AC-44A8-A776-EF96FD26A5CA\t"
}

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ
400	OperationUnsupported.CrossRegionNotSupport	Operation Failed. Host region Id is not equal to access region Id, VPC or VBR not support cross region privatezone service.
400	Forbidden.PrivatezoneServiceNotAuthorize	Privatezone service not to grant authorization.
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.
409	InvalidOperation.PrivatezoneRouteExisted	Privatezone routes already existed.
409	InvalidOperation.VpcNotAttachedToCen	Vpc not attached to cen.
409	InvalidOperation.UnmatchRouteInVpcRegion	Operation Failed.Unmatch route in vpc region.

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。