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

プレフィックスリストを Enterprise Edition トランジットルーターのルートテーブルに関連付けます。

操作説明

プレフィックスリストを Enterprise Edition トランジットルーターのルートテーブルに関連付ける前に、以下の条件が満たされていることを確認してください。

プレフィックスリストの使用制限およびルーティング互換性情報について理解していること。詳細については、「プレフィックスリスト」をご参照ください。
プレフィックスリストが作成されていること。詳細については、「 CreateVpcPrefixList 」をご参照ください。
クロスアカウントのプレフィックスリストを Enterprise Edition トランジットルーターのルートテーブルに関連付ける場合は、そのプレフィックスリストが Enterprise Edition トランジットルーターのルートテーブルを所有する Alibaba Cloud アカウントに共有されていることを確認してください。プレフィックスリストの共有方法の詳細については、「リソース共有の概要」および「API リファレンス (リソース共有)」をご参照ください。

今すぐお試しください

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

create

*All Resource

*

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
ClientToken	string	任意	リクエストのべき等性を確保するために使用されるクライアントトークン。クライアントを使用してトークンを生成できますが、異なるリクエスト間でトークンが一意であることを確認する必要があります。クライアントトークンには ASCII 文字のみを使用できます。説明このパラメーターを指定しない場合、システムは API リクエストの RequestId を ClientToken として自動的に使用します。RequestId は各 API の呼び出しで異なる場合があります。	123e4567-e89b-12d3-a456-4266****
RegionId	string	必須	トランジットルーターインスタンスのリージョン ID。 DescribeChildInstanceRegions 操作を呼び出してリージョン ID をクエリできます。	cn-hangzhou
TransitRouterId	string	必須	トランジットルーターインスタンスの ID。	tr-6ehx7q2jze8ch5ji0****
NextHopType	string	任意	ネクストホップのタイプ。有効な値: BlackHole: プレフィックスリスト内のすべての CIDR ブロックがブラックホールルートです。プレフィックスリスト内の CIDR ブロック宛てのすべてのトラフィックが破棄されます。 VPC: プレフィックスリスト内の CIDR ブロックのネクストホップは、Virtual Private Cloud (VPC) 接続です。 VBR: プレフィックスリスト内の CIDR ブロックのネクストホップは、Virtual Border Router (VBR) 接続です。 TR: プレフィックスリスト内の CIDR ブロックのネクストホップは、クロスリージョン接続です。 ECR: プレフィックスリスト内の CIDR ブロックのネクストホップは、Express Connect Router (ECR) インスタンスです。	VPC
PrefixListId	string	必須	プレフィックスリストの ID。	pl-6ehtn5kqxgeyy08fi****
TransitRouterTableId	string	必須	トランジットルーターのルートテーブルの ID。	vtb-6ehgc262hr170qgyc****
NextHop	string	必須	ネクストホップ接続の ID。プレフィックスリスト内のすべての CIDR ブロックをブラックホールルートとして設定するには、このパラメーターを BlackHole に設定します。	tr-attach-flbq507rg2ckrj****
OwnerUid	integer	任意	プレフィックスリストを所有する Alibaba Cloud アカウントの ID。	1210123456123456
DryRun	boolean	任意	ドライランを実行するかどうかを指定します。有効な値: true: 関連付けを作成せずにドライランを実行します。システムは必須パラメーター、リクエスト構文、およびビジネス制限をチェックします。チェックが失敗した場合、対応するエラーが返されます。チェックが成功した場合、エラーコード `DryRunOperation` が返されます。 false (デフォルト): ドライランを実行し、チェックが成功した後に関連付けを作成します。説明このパラメーターは現在使用できません。	false

レスポンスフィールド

フィールド	型	説明	例
	object	応答パラメーター。
RequestId	string	リクエスト ID。	0C2EE7A8-74D4-4081-8236-CEBDE3BBCF50

例

成功レスポンス

JSONJSON

{
  "RequestId": "0C2EE7A8-74D4-4081-8236-CEBDE3BBCF50"
}

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ	説明
400	NoPermission.AliyunServiceRolePolicyForCEN	You are not authorized to create the service linked role. Role Name: AliyunServiceRolePolicyForCEN. Service Name: cen.aliyuncs.com. Make sure that the user has been granted the ram:CreateServiceLinkedRole permission.	サービスリンクロールを作成する権限がありません。ロール名: AliyunServiceRolePolicyForCEN。サービス名: cen.aliyuncs.com。現在のユーザーに ram:CreateServiceLinkedRole 権限が付与されていることを確認してください。
400	ResourceNotSupport.CCN	CCN not support prefix list.	Cloud Connect Network (CCN) はプレフィックスリストをサポートしていません。
400	ResourceNotFound.PrefixlistCidrs	Can not find any cidr of specified prefix list.	プレフィックスリストに CIDR ブロックが含まれていません。
400	ResourceNotFound.Nexthop	The specified nexthop instance is not exsit.	パラメーターで指定されたネクストホップが存在しません。
400	ResourceExisted.PrefixlistAssociation	The prefix list has been already associated with this route table.	プレフィックスリストは既にルートテーブルに関連付けられています。
400	ResourceNotFound.PrefixlistAssociation	The prefix list is not associated with this route table.
400	ResourceConflict.Route	Some of the prefixes of the prefix list are conflicted with exsited routes.
400	MultipleFound.PrefixlistAssociation	multiple same prefix association record found.	システム例外が発生しました。システム内に同一の Record が複数存在します。
400	QuotaReached.Route	The quota of the route table is not enough for the request prefix list.
400	InvalidStatus.PrefixlistAssociation	The prefix list association is not in a valid state for the operation.	現在の PrefixlistAssociation ステータスでは、この操作はサポートされていません。後でもう一度お試しください。
400	NotSupport.TrType	The basic tr type is not support for this operation.	Basic Edition のトランジットルーターでは、この操作はサポートされていません。
400	InvalidValue.PrefixlistCidr	Invalid cidr exist in the specified prefixlist.	プレフィックスリストに無効な CIDR ブロックが含まれています。
400	ResourceNotSupport.Nexthop	The specified nexthop instance type is not support for the operation.	パラメーターで指定されたネクストホップはこの操作をサポートしていません。
400	ResourceMismatch.Nexthop	The specified nexthop and nexthop type mismatched.	パラメーターで指定された nexthop または nexthopType が無効です。
400	ResourceNotFound.PrefixList	The specified prefixlist does not found.	パラメーターで指定されたプレフィックスリストが存在しません。
400	OperationDenied.SystemPrefixList	SystemPrefixList can not be operated.	システムプレフィックスリストに対する操作は許可されていません。
400	OperationFailed.OperateShareResource	Operate share prefixlist failed.	プレフィックスリストの共有に失敗しました。
400	InvalidStatus.Prefixlist	Prefixlist is not in a operate status.	現在のプレフィックスリストステータスでは、この操作はサポートされていません。
400	RegionNotSupport.Prefixlist	Prefixlist association are not supported in this region.	現在のリージョンではこの特徴はサポートされていません。
400	OperationFailed.TransitRouterNotExist	Operation failed because transit router not exist.	トランジットルーターが存在しません。
400	IncorrectStatus.RouteTable	RouteTable status is invalid.	現在の操作に関連するルートテーブルが安定した状態ではないため、レート操作を実行できません。
400	IllegalParam.TransitRouterTableId	The specified Route Table ID is invalid.	ルートテーブル ID が無効です。
400	OperationDenied.ECSPrefixList	Associate ECS PrefixList is not supported.	ECS プレフィックスリストの関連付けはサポートされていません。
400	InvalidParameter	Invalid parameter.	パラメーターが無効です。
400	Unauthorized	The AccessKeyId is unauthorized.	この操作を実行するために必須の権限がアカウントにありません。
400	InvalidParameter.TransitRouterTableId	The specified parameter TransitRouterTableId is invalid.	TransitRouterTableId パラメーターが無効です。
400	InvalidParameter.NextHop	The specified parameter NextHop is invalid.	NextHop パラメーターが無効です。
400	InvalidParameter.TransitRouterId	The specified parameter TransitRouterId is invalid.	TransitRouterId パラメーターが無効です。
404	InvalidRouteTableId.NotFound	The specified RouteTableId is not found.	RouteTableId が存在しません。

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

変更履歴

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