CreateTransitRouter を使用して Enterprise Edition トランジットルーターを作成 - CEN - Alibaba Cloud - Cloud Enterprise Network

Enterprise エディションのトランジットルーターインスタンスを作成します。

操作説明

CreateTransitRouter 操作を呼び出して、Enterprise エディションのトランジットルーターインスタンスを作成できます。Enterprise エディションのトランジットルーターは、一部のリージョンでのみ利用可能です。リージョンの詳細については、「Cloud Enterprise Network とは」をご参照ください。
CreateTransitRouter は非同期操作です。リクエストを送信すると、システムは Enterprise エディションのトランジットルーターインスタンス ID を返しますが、インスタンスはまだ作成されていません。作成タスクはバックグラウンドで実行中です。 ListTransitRouters 操作を呼び出して、Enterprise エディションのトランジットルーターインスタンスのステータスをクエリできます。
- Enterprise エディションのトランジットルーターインスタンスが Creating 状態の場合、インスタンスは作成中です。この状態では、インスタンスのクエリのみが可能で、その他の操作は実行できません。
- Enterprise エディションのトランジットルーターインスタンスが Active 状態の場合、インスタンスは作成済みです。
Cloud Enterprise Network (CEN) インスタンス内の各リージョンには、トランジットルーターインスタンスを 1 つだけ作成できます。

今すぐお試しください

この 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:CreateTransitRouter

create

CenInstance

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

TransitRouter

acs:cen:*:{#accountId}:centransitrouter/*

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
ClientToken	string	任意	リクエストのべき等性を確保するために使用されるクライアントトークン。クライアントを使用してトークンを生成できますが、異なるリクエスト間でトークンが一意であることを確認する必要があります。トークンには ASCII 文字のみを含めることができます。説明このパラメーターを指定しない場合、システムは API リクエストの RequestId を ClientToken として自動的に使用します。RequestId は呼び出しごとに異なる場合があります。	02fb3da4-130e-11e9-8e44-001****
CenId	string	必須	CEN インスタンスの ID。	cen-j3jzhw1zpau2km****
RegionId	string	必須	Enterprise エディションのトランジットルーターインスタンスのリージョン ID。 DescribeChildInstanceRegions 操作を呼び出して、リージョン ID をクエリできます。	cn-zhangjiakou
TransitRouterName	string	任意	Enterprise エディションのトランジットルーターインスタンスの名前。名前は空にするか、1～128 文字の長さに設定できます。http:// または https:// で始めることはできません。	testname
TransitRouterDescription	string	任意	Enterprise エディションのトランジットルーターインスタンスの説明。説明は空にするか、1～256 文字の長さに設定できます。http:// または https:// で始めることはできません。	testdesc
DryRun	boolean	任意	ドライランを実行するかどうかを指定します。権限およびインスタンスステータスの検証が含まれます。有効な値: false (デフォルト): 通常のリクエストを送信し、チェックに合格した後に Enterprise エディションのトランジットルーターインスタンスを作成します。 true: Enterprise エディションのトランジットルーターインスタンスを作成せずにチェックリクエストを送信します。システムは必須パラメーター、リクエストフォーマット、およびその他の条件をチェックします。チェックに失敗した場合、対応するエラーが返されます。チェックに合格した場合、エラーコード `DryRunOperation` が返されます。	false
SupportMulticast	boolean	任意	Enterprise エディションのトランジットルーターのマルチキャスト特徴を有効にするかどうかを指定します。有効な値: false (デフォルト): 無効。 true: 有効。一部のリージョンの Enterprise エディションのトランジットルーターのみがマルチキャスト特徴をサポートしています。 ListTransitRouterAvailableResource 操作を呼び出して、マルチキャスト特徴をサポートするリージョンをクエリできます。	false
TransitRouterCidrList	array<object>	任意	トランジットルーター CIDR ブロックのリスト。
	object	任意	トランジットルーター CIDR ブロックのリスト。一度に最大 5 つのトランジットルーター CIDR ブロックを追加できます。トランジットルーター CIDR ブロックの詳細については、「トランジットルーター CIDR ブロック」をご参照ください。説明 Enterprise エディションのトランジットルーターのみが CIDR ブロックをサポートしています。
Cidr	string	任意	トランジットルーター CIDR ブロック。	192.168.10.0/24
Name	string	任意	トランジットルーター CIDR ブロックの名前。名前は 1～128 文字の長さである必要があります。	nametest
Description	string	任意	トランジットルーター CIDR ブロックの説明。説明は 1～256 文字の長さである必要があります。	desctest
PublishCidrRoute	boolean	任意	トランジットルーター CIDR ブロックのルートをトランジットルーターのルートテーブルに自動的に追加することをシステムに許可するかどうかを指定します。 true (デフォルト): 許可。このオプションを選択した場合、非公開ゲートウェイタイプの VPN 接続を作成し、その VPN 接続のルート学習関係を作成した後、システムは VPN 接続とルート学習関係を持つトランジットルーターのルートテーブルにルートエントリを自動的に追加します。 IPsec 接続用にゲートウェイ IP アドレスが割り当てられたトランジットルーター CIDR ブロックを送信先 CIDR ブロックとするブラックホールルート。ブラックホールルートは、トランジットルーターに関連付けられた仮想ボーダールーター (VBR) インスタンスのルートテーブルにのみ伝播されます。 false: 不許可。	true
Tag	array<object>	任意	タグ情報。
	object	任意	タグ情報。一度に最大 20 個のタグを指定できます。
Key	string	任意	リソースのタグキー。指定されたタグキーは空の文字列にすることはできません。タグキーは最大 64 文字の長さに設定でき、`aliyun` または `acs:` で始めることはできず、`http://` または `https://` を含めることはできません。一度に最大 20 個のタグキーを指定できます。	tagtest
Value	string	任意	リソースのタグ値。タグ値は空にするか、最大 128 文字の長さに設定でき、`aliyun` または `acs:` で始めることはできず、`http://` または `https://` を含めることはできません。各タグキーは 1 つのタグ値に対応します。一度に最大 20 個のタグ値を指定できます。	TagValue

レスポンスフィールド

フィールド	型	説明	例
	object	応答パラメーター。
TransitRouterId	string	Enterprise エディションのトランジットルーターインスタンスの ID。	tr-uf6llz2286805i44g****
RequestId	string	リクエスト ID。	404DA7EC-F495-44B5-B543-6EDCDF90F3D1

例

成功レスポンス

JSONJSON

{
  "TransitRouterId": "tr-uf6llz2286805i44g****",
  "RequestId": "404DA7EC-F495-44B5-B543-6EDCDF90F3D1"
}

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ	説明
400	OperationUnsupported.RegionId	The specified Region is not supported.	現在のリージョンではこの操作はサポートされていません。
400	InstanceExist.TransitRouterInstance	The instance already exists.	現在のリージョンには既にトランジットルーターインスタンスが存在します。同じリージョンに重複するトランジットルーターインスタンスを作成することはできません。
400	Forbbiden.TransitRouterServiceNotOpen	The user has not open transit router service.	トランジットルーターサービスが有効化されていません。サービスを有効化して、再試行してください。
400	OperationUnsupported.SupportMulticast	The multicast is not supported in the specified region.	現在のリージョンではマルチキャストはサポートされていません。
400	OperationUnsupported.CenFullLevel	CEN full level does not support TransitRouter.
400	IllegalParam.Cidr	Cidr is illegal.	リクエストで指定された CIDR ブロックが無効です。
400	Illegal.TrType	The TransitRouter type is illegal.	トランジットルータータイプはこの操作をサポートしていません。
400	OperationUnsupported.TransitRouterCidrList	The TransitRouterCidrList is not support in the specified Region.	現在のリージョンではこの操作はサポートされていません。
400	OperationFailed.CidrConflict	Operation is invalid because the cidr conflict.	CIDR ブロックが既存のものと競合しています。
400	IllegalParam.Region	The specified region is invalid.
400	OverLappingExist.Cidr	The cidr overlapping exist.	CIDR ブロックの重複がすでに存在します。
400	IllegalParam.ServiceMode	The specified ServiceMode is invalid.	リクエストで指定されたサービスモードが無効です。
400	ParamExclusive.ServiceModeAndSupportMulticast	ServiceMode and SupportMulticast is mutually exclusive.	このモードのトランジットルーターでは、マルチキャスト機能を有効にできません。
400	ParamExclusive.ServiceModeAndTransitRouterCidrList	ServiceMode and TransitRouterCidrList is mutually exclusive.	このモードのトランジットルーターでは、CIDR 機能を有効にできません。
400	OperationUnsupported.Tag	The Tag is not supported in the specified region.	このリージョンではトランジットルーターのタグの機能はサポートされていません。
400	IllegalParam.SupportMulticast	Basic Transit router is not support multicast.	Basic Edition のトランジットルーターはマルチキャスト機能をサポートしていません。
400	ParamExclusive.BasicAndPrimaryStandby	Basic and PrimaryStandby is mutually exclusive.	Basic Edition エディションのトランジットルーターでは、モードを PrimaryStandby にセットすることはサポートされていません。
400	ParamExclusive.BasicAndMultiPrimary	Basic and MultiPrimary is mutually exclusive.	Basic Edition エディションのトランジットルーターでは、モードを MultiPrimary にセットすることはサポートされていません。
400	IllegalParam.RegionId	The Specified Parameter RegionId is illegal.	リクエストで指定されたリージョンが無効です。
400	OperationFailed.PostPay95BwpNotAllowEnterpriseTr	Cbn with post pay 95 bandwidth package does not allow enterprise tr.	レガシ 95 パーセンタイル帯域幅プランを使用している Cloud Enterprise Network (CEN) インスタンスでは、Enterprise エディショントランジットルーターを作成できません。
400	Forbidden.TransitRouterServiceExpired	The transit router service is out of service.	トランジットルーターサービスが支払い遅延により停止されています。サービスを更新して、再試行してください。
400	InvalidParameter	Invalid parameter.	パラメーターが無効です。
400	Unauthorized	The AccessKeyId is unauthorized.	アカウントにこの操作を実行する権限がありません。
400	IllegalParam.TagValue	The tag values are not valid.	リクエストで指定されたタグ値が無効です。
400	IllegalParam.TagKey	The tag keys are not valid.	リクエストで指定されたタグキーが無効です。
400	InvalidParameter.TagValue	The specified parameter TagValue is invalid.	タグ値パラメーターが無効です。

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

変更履歴

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