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 エラーセンター」をご参照ください。