CreateExpressConnectRouterAssociation API で Express Connect Router を VPC または Transit Router に関連付け - Express Connect - Alibaba Cloud - Express Connect

Virtual Private Cloud (VPC) またはトランジットルーター (TR) を Express Connect Router (ECR) に関連付けます。

今すぐお試しください

この 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 ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

expressconnectrouter:CreateExpressConnectRouterAssociation

none

*ExpressConnectRouter。

acs:expressconnectrouter::{#accountId}:expressconnectrouter/{#EcrId}

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
EcrId	string	必須	Express Connect Router (ECR) インスタンスの ID。	ecr-mezk2idmsd0vx2****
AssociationRegionId	string	必須	関連付けられるリソースが属するリージョン。	cn-hangzhou
TransitRouterOwnerId	integer	任意	トランジットルーターインスタンスを所有するアカウントの Alibaba Cloud アカウント ID。デフォルト値: 現在のログインアカウントの Alibaba Cloud アカウント ID。説明別のアカウントに属するネットワークインスタンスをアタッチする場合、このパラメーターは必須です。	189159362009****
TransitRouterId	string	任意	トランジットルーターの ID。説明 TransitRouterId パラメーターと VpcId パラメーターは相互排他です。いずれか一方を指定する必要があります。Cbn(2017-09-12) プロダクトの CreateTransitRouter API を呼び出してトランジットルーターを作成し、TransitRouterId を取得します。	tr-2ze4i71c6be454e2l****
CenId	string	任意	Cloud Enterprise Network (CEN) インスタンスの ID。説明 TransitRouterId を指定する場合、CenId は必須です。Cbn(2017-09-12) プロダクトの CreateCen API を呼び出して CEN インスタンスを作成し、CenId を取得します。	cen-of3o1the3i4gwb****
VpcOwnerId	integer	任意	VPC 接続インスタンスを所有するアカウントの Alibaba Cloud アカウント ID。デフォルト値: 現在のログインアカウントの Alibaba Cloud アカウント ID。説明別のアカウントに属するネットワークインスタンスをアタッチする場合、このパラメーターは必須です。	132193271328****
VpcId	string	任意	VPC 接続インスタンスの ID。説明 VpcId パラメーターと TransitRouterId パラメーターは相互排他です。いずれか一方を指定する必要があります。 Vpc(2016-04-28) プロダクトの CreateVpc API を呼び出して VPC を作成し、VpcId を取得します。	vpc-bp1h37fchc6jmfyln****
AllowedPrefixes	array	任意	許可されたプレフィックスルートのリスト。
	string	任意	許可されたプレフィックスルート。	192.0.20.0/24
CreateAttachment	boolean	任意	ECR が TR にアタッチされたときに関連付けを開始するかどうかを指定します。有効な値: true: トランジットルーター側から関連付けを開始する必要はありません。 false: トランジットルーター側から関連付けを開始する必要があります。	true
DryRun	boolean	任意	ドライランを実行するかどうかを指定します。有効な値: true: ドライランを実行します。システムは、EPS リソースを変更せずに、潜在的な問題についてリクエストをチェックします。 false (デフォルト値): 通常通りリクエストを送信します。	false
ClientToken	string	任意	リクエストのべき等性を確保するために使用されるクライアントトークン。クライアントでパラメーター値を生成して、異なるリクエスト間での一意性を確保します。ClientToken は ASCII 文字のみをサポートします。説明このパラメーターを指定しない場合、システムは API リクエストの RequestId を ClientToken として使用します。RequestId は API リクエストごとに異なる場合があります。	02fb3da4-130e-11e9-8e44-00****
AllowedPrefixesMode	string	任意	プレフィックスルートモード。有効な値: MatchMode: 一致モード。設定されたルート CIDR ブロックのみが IDC にアドバタイズされ、以前にアドバタイズされた特定のルートは取り消されます。 IncrementalMode: 増分モード。設定されたルート CIDR ブロックが IDC にアドバタイズされます。設定された CIDR ブロック内に含まれる以前にアドバタイズされた特定のルートは取り消されますが、設定された CIDR ブロック内に含まれない特定のルートはアドバタイズされたままになります。	MatchMode
Description	string	任意	関連付けられたリソースの説明。説明は 0～128 文字の長さである必要があります。	test
Tag	array<object>	任意	タグのリスト。最大 20 個のタグを付与できます。
	object	任意
Key	string	任意	リソースのタグキー。このパラメーターを指定する場合、値は空の文字列にできません。タグキーは最大 128 文字の長さで、`aliyun` または `acs:` で始めることはできません。`http://` または `https://` を含めることはできません。	TestKey
Value	string	任意	リソースのタグ値。タグ値は空の文字列にでき、最大 128 文字の長さにできます。`http://` または `https://` を含めることはできません。	TestValue

レスポンスフィールド

フィールド	型	説明	例
	object	RpcResponse
AccessDeniedDetail	string	アクセス拒否の詳細。	認証は **** に対して失敗した
AssociationId	string	Express Connect Router (ECR) と VPC または TR の間の関連付け ID。	ecr-assoc-9p2qxx5phpca2m****
Code	string	状態コード。値が 200 の場合、関連付けが成功したことを示します。その他の値は失敗を示します。詳細については、エラーコードのフォーマットを参照してください。	200
DynamicCode	string	動的エラーコード。	IllegalParamFormat.EcrId
DynamicMessage	string	動的エラーメッセージ。ErrMessage パラメーターの `%s` プレースホルダーを置き換えるために使用されます。説明 ErrMessage が The Value of Input Parameter %s is not valid を返し、DynamicMessage が DtsJobId を返す場合、リクエストパラメーター DtsJobId の値は有効ではありません。	EcrId **** のパラメーターフォーマットは不正です。
HttpStatusCode	integer	HTTP 状態コード。	200
Message	string	返されるメッセージ。	OK
RequestId	string	リクエストの ID。	05130E79-588D-5C40-A718-C4863A59****
Success	boolean	呼び出しが成功したかどうかを示します。有効な値: True: 呼び出しが成功しました。 False: 呼び出しが失敗しました。	True

例

成功レスポンス

JSONJSON

{
  "AccessDeniedDetail": "**** の認証は失敗した",
  "AssociationId": "ecr-assoc-9p2qxx5phpca2m****",
  "Code": "200",
  "DynamicCode": "IllegalParamFormat.EcrId",
  "DynamicMessage": "EcrId **** のパラメーターフォーマットは不正です。",
  "HttpStatusCode": 200,
  "Message": "OK",
  "RequestId": "05130E79-588D-5C40-A718-C4863A59****",
  "Success": true
}

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ	説明
400	IncorrectStatus.Ecr	Ecr Status does not allow current operation.	Express Connect Router (ECR) のインスタンスステータスでは、この操作を実行することは許可されていません。別の操作が実行中であるか、Express Connect Router (ECR) インスタンスの削除処理中です。しばらくしてからもう一度お試しください。
400	OperationDenied.ForceDeleting	The current instance is being deleted.	操作が拒否されました。Express Connect Router (ECR) インスタンスは強制削除中です。しばらくしてからもう一度お試しください。
400	UnsupportedRegion	Feature not supported in specified region.	指定されたリージョンでは Express Connect Router (ECR) の特徴がサポートされていません。
400	QuotaExceeded.VpcCountPerEcr	The number of VPC bound to the ECR exceeds the quota.	1 つの Express Connect Router (ECR) インスタンスにバインド可能な VPC 数がクォータ制限に達しました。アカウントマネージャーに連絡して、クォータの引き上げをリクエストしてください。
400	QuotaExceeded.TrCountPerEcr	The number of TR bound to the ECR exceeds the quota.	1 つの Express Connect Router (ECR) インスタンスにバインド可能なトランジットルーター (TR) 数がクォータ制限に達しました。アカウントマネージャーに連絡して、クォータの引き上げをリクエストしてください。
400	IllegalParamFormat.AllowedPrefixes	The prefix parameter format is invalid. Procedure.	指定されたルートプレフィックス CIDR ブロックのフォーマットは無効です。
400	OperationDenied.NotGrantedByNodeOwner	The node owner is not authorized.	操作が拒否されました。Express Connect Router (ECR) プロダクトが承認されていません。
400	OperationFailed.CdtNotOpened	The Cdt function is disabled.	Alibaba Cloud のデータ転送特徴が有効になっていないため、操作に失敗しました。
400	OperationFailed.CdtCrossBoarderNotOpened	The Cdt cross-border transmission function is disabled.	Alibaba Cloud のクロス罫線データ転送特徴が有効になっていないため、操作に失敗しました。
400	OperationFailed.CrossBorderNotAllowed	There is no qualification for creating cross-border links.	操作に失敗しました。現在のご契約にはクロス罫線接続を作成する権限がありません。この権限を追加するには、アカウントマネージャーにお問い合わせください。
400	ResourceNotFound.CenId	CenId not found.	CEN インスタンスが存在しません。
400	ResourceNotFound.TrId	TRId not found.	TR インスタンスが存在しません。
400	Conflict.ASNOfVBR	ASN already used by other VBR.	VBR BgpGroup の localAsn が ECR の ASN と一致していません。一致するように調整してから、再度バインドしてください。
400	MissingParam.%s	The param of %s is missing.	必須のリクエストパラメーターが不足しています。パラメーターを確認して、もう一度お試しください。
400	IllegalParamFormat.%s	The param format of %s is illegal.	パラメーターのフォーマットは無効です。
400	IllegalParamFormat.CenId	The format of the entered Cen instance ID is incorrect.	指定された CEN インスタンス ID のフォーマットは無効です。
400	OperationDenied.CrossBidAssociating	Cross-border binding of resources is subject to compliance constraints.	このバインドには、中国サイトのリソースと国際サイトのリソース間の相互接続が含まれます。コンプライアンス上の制約により、連絡先であるアカウントマネージャーに確認してください。
400	ExclusiveParam.TransitRouterIdAndVpcId	A private network instance cannot be bound to a forwarding router instance at the same time.	VPC インスタンスとトランジットルーターインスタンスを同じ時間にバインドすることはできません。いずれか一方のみをバインドしてください。
400	IllegalParamSize.AllowedPrefixes	The number of prefix routes exceeded the quota.	ルートプレフィックスの数がクォータを超えています。クォータの引き上げを申請してください。
400	OperationDenied.CrossAccountAttaching	If the forwarding router is bound to another account, perform this operation on the same account.	操作が拒否されました。別のアカウントに属するトランジットルーターをバインドするには、そのアカウントでこの操作を実行してください。
400	OperationDenied.AttachmentInCurrentRegionExisted	Only one forwarding router can be bound to an area.	操作が拒否されました。Express Connect Router (ECR) インスタンスは、ルーティングと転送のために、同じエリア内の 1 つのトランジットルーターのみをアタッチできます。
400	Conflict.Lock	There are other unfinished operations.	別の操作が進行中です。しばらくしてからもう一度お試しください。
400	OperationFailed.CallingVpcYaochi	The system is abnormal. Please try again later.	内部システムエラーにより操作に失敗しました。しばらくしてからもう一度お試しください。問題が継続する場合は、アカウントマネージャーにお問い合わせください。
400	ResourceAlreadyExist.TransitRouterId	The specified resource of transit router already exists.	指定された TR リソースはすでに Express Connect Router (ECR) に関連付けられています。リソースを確認してからもう一度お試しください。
400	ResourceAlreadyExist.VpcId	The specified resource of VpcId already exists.	指定された VPC リソースはすでに Express Connect Router (ECR) に関連付けられています。リソースを確認してからもう一度お試しください。
400	Conflict.AllowedPrefixes	The allowed route prefixes [%s] is conflict.	指定されたルートプレフィックスはすでに存在します。構成を確認し、リクエストを再送信してください。
400	UnsupportedFeature.JumboFrame	The region where the sub-instance is located does not support the jumbo frame feature and cannot be attached to the express connect router.	サブインスタンスのリージョンではジャンボフレームの特徴がサポートされていないため、Express Connect Router (ECR) にロードできません。
400	InternalErrorTemp	The request processing has failed due to some unknown error.	内部エラーが発生しました。もう一度お試しください。複数回再試行してもエラーが解消されない場合は、チケットを起票してください。
400	OperationFailed.AlreadyExistPropagationSource	The operation failed because an existing propagation source is already configured for the instance.	このインスタンスにはすでにルート伝播ソースが存在します。このインスタンスを Express Connect Router (ECR) に再度アタッチすることはできません。
400	OperationFailed.CloudBoxVSwitchExist	The operation failed because the VPC contains a CloudBox vSwitch.	VPC に CloudBox vSwitch が含まれているため、Express Connect Router (ECR) にアタッチできません。
400	OperationFailed.CloudBoxVbrExist	The operation is not allowed because a CloudBox VBR already exists on this ECR association.	この関連付けにはすでに CloudBox VBR が存在します。操作を続行できません。
400	OperationFailed.NoRouteTableInVpc	The operation failed because no system route table is found in the VPC.	VPC にシステムルートテーブルが見つかりません。関連付けを作成できません。
400	OperationFailed.TrServiceNotOpened	The operation is not allowed because the Transit Router service is not opened.	トランジットルーター (TR) サービスが有効化されていません。サービスを有効化して、もう一度お試しください。
400	OperationFailed.TrServiceExpired	The operation is not allowed because the Transit Router service has expired.	トランジットルーター (TR) サービスが期限切れになっているか、支払い遅延が発生しています。サービスを更新して、もう一度お試しください。
400	IncorrectStatus.Vpc	The status of the VPC is incorrect.	VPC の現在のステータスでは、この操作はサポートされていません。VPC が安定した状態に戻るまで待ってから、もう一度お試しください。
400	IncorrectStatus.VpcOperating	The VPC is operating and does not support this operation.	VPC に対して別の操作が実行されています。操作が完了するまで待ってから、もう一度お試しください。
400	IncorrectStatus.Vswitch	The status of the vSwitch is incorrect.	vSwitch の現在のステータスでは、この操作はサポートされていません。vSwitch が安定した状態に戻るまで待ってから、もう一度お試しください。
400	IncorrectStatus.RouteEntry	The status of the route entry is incorrect.	ルートエントリの現在のステータスでは、この操作はサポートされていません。ルートエントリが安定した状態に戻るまで待ってから、もう一度お試しください。
400	OperationDenied.ViolateRegionMutuallyExclusive	The operation is not allowed because the region violates the mutually exclusive constraint.	リージョンの相互排他制約に違反しています。このリージョンは、すでに関連付けられているリージョンと同じ Express Connect Router (ECR) にアタッチできません。
404	ResourceNotFound.EcrId	EcrId not found.	ECR インスタンスが存在しません。

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

変更履歴

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