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

仮想非公開クラウド (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

create

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

例

成功レスポンス

JSONJSON

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

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ
400	IncorrectStatus.Ecr	Ecr Status does not allow current operation.
400	OperationDenied.ForceDeleting	The current instance is being deleted.
400	UnsupportedRegion	Feature not supported in specified region.
400	QuotaExceeded.VpcCountPerEcr	The number of VPC bound to the ECR exceeds the quota.
400	QuotaExceeded.TrCountPerEcr	The number of TR bound to the ECR exceeds the quota.
400	IllegalParamFormat.AllowedPrefixes	The prefix parameter format is invalid. Procedure.
400	OperationDenied.NotGrantedByNodeOwner	The node owner is not authorized.
400	OperationFailed.CdtNotOpened	The Cdt function is disabled.
400	OperationFailed.CdtCrossBoarderNotOpened	The Cdt cross-border transmission function is disabled.
400	OperationFailed.CrossBorderNotAllowed	There is no qualification for creating cross-border links.
400	ResourceNotFound.CenId	CenId not found.
400	ResourceNotFound.TrId	TRId not found.
400	Conflict.ASNOfVBR	ASN already used by other VBR.
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.
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.
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.
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.
400	ResourceAlreadyExist.VpcId	The specified resource of VpcId already exists.
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.
400	InternalErrorTemp	The request processing has failed due to some unknown error.
404	ResourceNotFound.EcrId	EcrId not found.

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

変更履歴

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