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

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

使用上の注意

開始する前に、プレフィックスの制限、互換性、およびルート広告のスコープを読んで理解することをお勧めします。詳細については、「プレフィックスリスト」をご参照ください。

前提条件

プレフィックスリストが作成されます。詳細については、「CreateVpcPrefixList」をご参照ください。
プレフィックスリストとEnterprise Editionトランジットルーターが異なるAlibaba Cloudアカウントに属している場合、プレフィックスリストはEnterprise Editionトランジットルーターを所有するAlibaba Cloudアカウントと共有されます。プレフィックスリストを別のAlibaba Cloudアカウントと共有する方法の詳細については、「リソース共有とは」および「リソース共有のAPIリファレンス」をご参照ください。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。この操作は、OpenAPI Explorer で呼び出すことを推奨します。 OpenAPI Explorer は、さまざまな SDK に対して操作のサンプルコードを動的に生成します。

リクエストパラメーター

項目	データ型	必須／任意	例:	説明
操作	String	必須	CreateTransitRouterPrefixListAssociation	実行する操作です。値をCreateTransitRouterPrefixListAssociationに設定します。
ClientToken	String	任意	123e4567-e89b-12d3-a456-4266 ****	リクエストのべき等性を保証するために使用されるクライアントトークン。クライアントを使用して値を生成できますが、異なるリクエスト間で一意であることを確認する必要があります。 ClientTokenにはASCII文字のみを含めることができます。説明このパラメーターを設定しない場合、ClientTokenはRequestIdの値に設定されます。各APIリクエストのRequestIdの値は異なる場合があります。
RegionId	String	必須	cn-hangzhou	トランジットルーターがデプロイされているリージョンのID。 DescribeChildInstanceRegionsを呼び出して、最新のリージョンリストを照会できます。
TransitRouterId	String	必須	tr-6ehx7q2jze8ch5ji0 ****	トランジットルーターのID。
NextHopType	String	任意	VPC	ネクストホップのタイプ。有効な値： BlackHole: プレフィックスリストのすべてのCIDRブロックがブラックホールルートであることを指定します。 CIDRブロック宛てのパケットはドロップされます。 VPC: プレフィックスリストのCIDRブロックのネクストホップが仮想プライベートクラウド (VPC) 接続であることを指定します。 VBR: プレフィックスリストのCIDRブロックのネクストホップが仮想ボーダールーター (VBR) 接続であることを指定します。 TR: プレフィックスリスト内のCIDRブロックの次のホップがリージョン間接続であることを指定します。
PrefixListId	String	必須	pl-6ehtn5kqxgeyy08fi ****	プレフィックスリストのID。
TransitRouterTableId	String	必須	vtb-6ehgc262hr170qgyc ****	トランジットルーターのルートテーブルのID。
NextHop	String	必須	tr-attach-flbq507rg2ckrj ****	次のホップのID。説明 NextHopTypeがBlackHoleに設定されている場合、このパラメーターをBlackHoleに設定する必要があります。
OwnerUid	Long	いいえ	1210123456123456	プレフィックスリストが属するAlibaba CloudアカウントのID。プレフィックスリストとトランジットルータールートテーブルが同じAlibaba Cloudアカウントに属している場合は、このパラメーターをスキップできます。プレフィックスリストとトランジットルータールートテーブルが異なるAlibaba Cloudアカウントに属している場合は、このパラメーターを設定する必要があります。
DryRun	Boolean	いいえ	false	リクエストのみをチェックするかどうかを指定します。有効な値： true: リクエストを事前にチェックしますが、ルートテーブルをプレフィックスリストに関連付けません。システムは、必要なパラメーター、リクエスト形式、およびサービス制限をチェックします。リクエストが事前チェックに合格しなかった場合、エラーメッセージが返されます。リクエストが事前チェックに合格した場合、`DryRunOperation`エラーコードが返されます。 false (デフォルト): リクエストを送信します。要求が事前チェックをパスした場合、ルートテーブルはプレフィックスリストに関連付けられます。

レスポンスパラメーター

項目	データ型	例:	説明
RequestId	String	0C2EE7A8-74D4-4081-8236-CEBDE3BBCF50	リクエストの ID です。

例

リクエストの例

http(s)://[Endpoint]/? アクション=CreateTransitRouterPrefixListAssociation
&ClientToken=123e4567-e89b-12d3-a456-4266 ****
&RegionId=cn-hangzhou
&TransitRouterId=tr-6ehx7q2jze8ch5ji0 ****
&NextHopType=VPC
&PrefixListId=pl-6ehtn5kqxgeyy08fi ****
&TransitRouterTableId=vtb-6ehgc262hr170qgyc ****
&NextHop=tr-attach-flbq507rg2ckrj ****
&OwnerUid=1210123456123456
&DryRun=false
&共通リクエストパラメータ

正常に処理された場合のレスポンス例

XML 形式

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateTransitRouterPrefixListAssociationResponse>
    <RequestId>0C2EE7A8-74D4-4081-8236-CEBDE3BBCF50</RequestId>
</CreateTransitRouterPrefixListAssociationResponse>

JSON 形式

HTTP/1.1 200 OK
Content-Type:application/json

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

エラーコード

HttpCode	エラーコード	エラーメッセージ	説明
400	NoPermission.AliyunServiceRolePolicyForCEN	サービスにリンクされたロールを作成する権限がありません。ロール名: AliyunServiceRolePolicyForCEN。サービス名: cen.aliyuncs.com。ユーザーにram:CreateServiceLinkedRole権限が付与されていることを確認します。	サービスe cen.aliyuncs.comのサービスにリンクされたロールAliyunServiceRolePolicyForCENを作成する権限がない場合に返されるエラーメッセージ。操作を実行する前に、ram:CreateServiceLinkedRole権限を取得する必要があります。
400	ResourceNotSupport.CCN	CCNはプレフィックスリストをサポートしていません。	ネクストホップがCCNインスタンスであるトランジットルーターがプレフィックスリストをサポートしていない場合に返されるエラーメッセージ。トランジットルーターの設定と、トランジットルーターがネクストホップとしてCCNインスタンスを使用しているかどうかを確認します。
400	ResourceNotFound.PrefixlistCidrs	指定されたプレフィックスリストのcidrが見つかりません。	指定されたプレフィックスリストにCIDRブロックが含まれていない場合に返されるエラーメッセージ。プレフィックスリストを確認します。
400	ResourceNotFound.Nexthop	指定されたnexthopインスタンスはexsitではありません。	指定されたネクストホップが存在しない場合に返されるエラーメッセージ。設定を確認します。
400	ResourceExisted.PrefixlistAssociation	プレフィックスリストは、すでにこのルートテーブルに関連付けられています。	ルートテーブルがプレフィックスリストに既に関連付けられている場合に返されるエラーメッセージ。
400	MultipleFound.PrefixlistAssociation	複数の同じプレフィックス関連レコードが見つかりました。	システムで構成が重複している場合に返されるエラーメッセージ。
400	InvalidStatus.PrefixlistAssociation	プレフィックスリストの関連付けは、操作に対して有効な状態ではありません。	プレフィックスリストとルートテーブルの関連付けが無効な状態になっている場合に返されるエラーメッセージ。
400	NotSupport.TrType	基本的なtrタイプは、この操作をサポートしていません。	Basic Editionトランジットルーターがプレフィックスリストをサポートしていない場合に返されるエラーメッセージ。トランジットルーターをアップグレードして、もう一度お試しください。
400	InvalidValue.PrefixlistCidr	指定されたprefixlistに無効なcidrが存在します。	指定されたプレフィックスリストに無効なCIDRブロックが含まれている場合に返されるエラーメッセージ。プレフィックスリストのCIDRブロックを確認します。
400	ResourceNotSupport.Nexthop	指定されたnexthopインスタンスタイプは、操作をサポートしていません。	プレフィックスリストのネクストホップタイプが無効な場合に返されるエラーメッセージ。 APIリファレンスを参照し、設定を修正してください。
400	ResourceMismatch.Nexthop	指定されたnexthopとnexthopタイプが一致しません。	指定されたネクストホップタイプが指定されたネクストホップと一致しない場合に返されるエラーメッセージ。設定を確認して、もう一度お試しください。
400	ResourceNotFound.PrefixList	指定されたprefixlistが見つかりません。	指定されたプレフィックスリストが見つからない場合に返されるエラーメッセージ。プレフィックスリストが作成されているかどうかを確認します。
400	OperationDenied.SystemPrefixList	SystemPrefixListは操作できません。	プレフィックスリストで操作を実行できない場合に返されるエラーメッセージ。
400	OperationFailed.OperateShareResource	共有プレフィックスリストの操作に失敗しました。	プレフィックスリストで操作を実行できない場合に返されるエラーメッセージ。
400	InvalidStatus.Prefixlist	Prefixlistが動作状態ではありません。	プレフィックスリストが無効な状態の場合に返されるエラーメッセージ。しばらくしてからもう一度お試しください。
400	RegionNotSupport.Prefixlist	このリージョンでは、Prefixlistの関連付けはサポートされません。	現在のリージョンでプレフィックスリストがサポートされていない場合に返されるエラーメッセージ。

エラーコードリストについては、「API エラーセンター」をご参照ください。