Enterprise Editionトランジットルーターでクロスリージョン接続を作成します。

説明

By default, 1 Kbit/s of bandwidth is provided for cross-region communication between transit routers. これにより、クロスリージョンIPv4ネットワークの接続性をテストできます。 異なるリージョンにデプロイされているサービスが相互に通信できるようにするには、クロスリージョン接続を作成し、その接続に帯域幅リソースを割り当てる必要があります。

Enterprise Edition transit routers allow you to allocate bandwidth resources to cross-region connections by using the following methods:

  • 帯域幅プランから帯域幅リソースを割り当てる:

    帯域幅プランを購入し、帯域幅プランからクロスリージョン接続に帯域幅リソースを割り当てる必要があります。 For more information, see CreateCenBandwidthPackage.

  • 従量課金データ転送帯域幅リソースの使用:

    クロスリージョン接続の帯域幅制限を設定できます。 次に、接続のデータ転送量に対して課金されます。 詳細については、「クロスリージョンデータ転送」をご参照ください。

デバッグ

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

リクエストパラメーター

パラメーター データ型 必須／任意 例 説明
操作 String 必須 CreateTransitRouterPeerAttachment

実行する操作です。 Set the value to CreateTransitRouterPeerAttachment.

ClientTokend String 任意 02fb3da4-130e-11e9-8e44-001****

リクエストのべき等性を保証するために使用されるクライアントトークンです。

クライアントを使用してトークンを生成できますが、異なるリクエスト間で一意であることを確認する必要があります。 The token can contain only ASCII characters and cannot exceed 64 characters in length.

CenId String 任意 cen-j3jzhw1zpau2km ****

Cloud Enterprise Network (CEN) インスタンスのID。

TransitRouterId String 任意 tr-bp1su1ytdxtataupl ****

ローカルEnterprise EditionトランジットルーターのID。

RegionId String 任意 cn-hangzhou

ローカルEnterprise EditionトランジットルーターがデプロイされているリージョンのID。

DescribeRegions を呼び出して、最新のリージョンリストをクエリできます。

TransitRouterAttachmentName String 任意 テスト名

クロスリージョン接続の名前。

名前は2 ~ 128文字で、英数字、アンダースコア (_) 、ハイフン (-) を使用できます。 先頭は英字とする必要があります。

TransitRouterAttachmentDescription String 任意 testdesc

クロスリージョン接続の説明。

長さは 2 文字から 256 文字である必要があります。 説明は文字で始める必要がありますが、http:// またはhttps:// で始めることはできません。

PeerTransitRouterId String 必須 tr-m5eq27g6bndum7e88 ****

ピア中継ルータのID。

PeerTransitRouterRegionId String 任意 cn-qingdao

ピア中継ルータがデプロイされているリージョンのID。

AutoPublishRouteEnabled Boolean 任意 false

ローカルのEnterprise Editionトランジットルーターが、リージョン間接続のルートをピアのトランジットルーターに自動的に通知できるようにするかどうかを指定します。 設定可能な値は以下のとおりです。

  • false (デフォルト): いいえ
  • true: はい
帯域幅 Integer 任意 2

クロスリージョン接続の帯域幅の値。 単位：Mbit/秒

  • BandwidthTypeをBandwidthPackageに設定した場合、このパラメーターには、クロスリージョン接続で使用できる帯域幅を指定します。
  • BandwidthTypeをDataTransferに設定した場合、このパラメーターには、クロスリージョン接続の帯域幅制限を指定します。
CenBandwidthPackageId String 任意 cenbwp-3xrxupouolw5ou ****

クロスリージョン接続に帯域幅を割り当てるために使用される帯域幅プランのID。

説明 BandwidthTypeをDataTransferに設定した場合、このパラメーターを設定する必要はありません。
DryRun Boolean 任意 false

リクエストをチェックするが操作を実行しないかどうかを指定します。 システムは、指定されたインスタンスの権限とステータスをチェックします。 設定可能な値は以下のとおりです。

  • false (デフォルト): リクエストを確認します。 リクエストがチェックに合格すると、クロスリージョン接続が作成されます。
  • true: リクエストはチェックされますが、操作は実行されません。 リクエストがチェックに合格した後、クロスリージョン接続は作成されません。 この値を使用すると、必要なパラメーターが設定されているかどうか、およびリクエスト構文が有効かどうかが確認されます。 要求がチェックに失敗した場合、エラーメッセージが返されます。 If the request passes the check, the system returns the ID of the request.
BandwidthType String 任意 BandwidthPackage

クロスリージョン接続に帯域幅を割り当てるために使用されるメソッド。 設定可能な値は以下のとおりです。

BandwidthPackage: allocates bandwidth from a bandwidth plan.

DataTransfer: データ転送ごとの帯域幅を使用します。

レスポンスパラメーター

パラメーター データ型 例 説明
TransitRouterAttachmentId String tr-attach-nwkiqfvw22qesz ****

The ID of the cross-region connection.

RequestId String 59422BF5-BAAD-4CFD-9019-9557BD3ACFA3

リクエストの ID です。

例

リクエストの例

http(s)://[Endpoint]/? アクション=CreateTransitRouterPeerAttachment
&PeerTransitRouterId=tr-m5eq27g6bndum7e88 ****
&<共通リクエストパラメーター>

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

XML 形式 

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

<CreateTransitRouterPeerAttachmentResponse>
<TransitRouterAttachmentId>tr-attach-nwkiqfvw22qesz ****</TransitRouterAttachmentId>
<RequestId>59422BF5-BAAD-4CFD-9019-9557BD3ACFA3</RequestId>
</CreateTransitRouterPeerAttachmentResponse>

JSON 形式 

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

{
  "TransitRouterAttachmentId" : "tr-attach-nwkiqfvw22qesz ****" 、
  "RequestId" : "59422BF5-BAAD-4CFD-9019-9557BD3ACFA3"
}

エラーコード

HttpCode エラーコード エラーメッセージ 説明
400 OperationUnsupported.TransitRouterRegionId 指定されたTransitRouterRegionは操作をサポートしていません。 指定されたリージョンが操作をサポートしていない場合に返されるエラーメッセージ。
400 NoPermission.AliyunServiceRolePolicyForCEN サービスにリンクされたロールを作成する権限がありません。 ロール名: AliyunServiceRolePolicyForCEN。 サービス名: cen.aliyuncs.com。 ユーザーにram:CreateServiceLinkedRole権限が付与されていることを確認します。 サービスe cen.aliyuncs.comのサービスにリンクされたロールAliyunServiceRolePolicyForCENを作成する権限がない場合に返されるエラーメッセージ。 操作を実行する前に、ram:CreateServiceLinkedRole権限を取得する必要があります。
400 InvalidTransitRouterId.NotFound TransitRouterIdが見つかりません。 トランジットルーターのIDが無効な場合に返されるエラーメッセージ。
400 IllegalParam.PeerTransitRouterId PeerTransitRouterIdは違法です。 ピア中継ルータのIDが無効な場合に返されるエラーメッセージ。
400 OperationUnsupported.TransitRouterId TransitRouterIdはサポートされていません。 The error message returned because the Basic Edition transit routers do not support the operation.
400 MissingParam.Bandwidth パラメータBandwidthは必須です。 帯域幅の値が指定されていない場合に返されるエラーメッセージ。
400 IllegalParam.Bandwidth 帯域幅は違法です 指定された帯域幅の値が無効な場合に返されるエラーメッセージ。

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