すべてのプロダクト
Search
ドキュメントセンター

Cloud Enterprise Network:CreateTransitRouterPeerAttachment

最終更新日:Aug 12, 2026

ネットワークインスタンス (VPC、VBR、IPsec 接続) がトランジットルーターに接続された後、異なるリージョンのネットワークインスタンス間の通信を有効にするには、トランジットルーター間にクロスリージョン接続を作成する必要があります。CreateTransitRouterPeerAttachment 操作を呼び出して、Enterprise Edition トランジットルーターインスタンスのクロスリージョン接続を作成できます。

操作説明

  • Enterprise Edition トランジットルーターは、次の 2 つの帯域幅割り当てメソッドをサポートしています。

今すぐお試しください

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

create

CenInstance

acs:cen:*:{#accountId}:ceninstance/{#ceninstanceId}

TransitRouter

acs:cen:*:{#accountId}:centransitrouter/{#TransitRouterId}

なし なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

ClientToken

string

任意

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

02fb3da4-130e-11e9-8e44-001****

CenId

string

任意

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

cen-j3jzhw1zpau2km****

TransitRouterId

string

任意

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

tr-bp1su1ytdxtataupl****

RegionId

string

任意

ローカルの Enterprise Edition トランジットルーターインスタンスのリージョン ID。

cn-hangzhou

TransitRouterAttachmentName

string

任意

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

testname

TransitRouterAttachmentDescription

string

任意

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

testdesc

PeerTransitRouterId

string

必須

ピアトランジットルーターインスタンスの ID。

tr-m5eq27g6bndum7e88****

PeerTransitRouterRegionId

string

任意

ピアトランジットルーターインスタンスのリージョン ID。

cn-qingdao

AutoPublishRouteEnabled

boolean

任意

Enterprise Edition トランジットルーターがクロスリージョン接続のルートをピアリージョンに自動的に公開するかどうかを指定します。

false

Bandwidth

integer

任意

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

2

CenBandwidthPackageId

string

任意

クロスリージョン接続に関連付ける帯域幅パッケージの ID。

cenbwp-3xrxupouolw5ou****

DryRun

boolean

任意

権限とインスタンスステータスの検証を含むドライランを実行するかどうかを指定します。有効な値:

false

BandwidthType

string

任意

クロスリージョン接続の帯域幅割り当てメソッド。有効な値:

BandwidthPackage

Tag

array<object>

任意

タグ情報。

object

任意

Key

string

任意

リソースのタグキー。

tag_A1

Value

string

任意

リソースのタグ値。

value_A1

DefaultLinkType

string

任意

デフォルトのリンクタイプ。

Gold

レスポンスフィールド

フィールド

説明

object

レスポンスパラメーター。

TransitRouterAttachmentId

string

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

tr-attach-nwkiqfvw22qesz****

RequestId

string

リクエスト ID。

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

成功レスポンス

JSONJSON

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

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

400 OperationUnsupported.TransitRouterRegionId The specified TransitRouterRegion does not support the operation.
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 InvalidTransitRouterId.NotFound TransitRouterId is not found. リクエストに指定された TransitRouterId が存在しません。
400 IllegalParam.PeerTransitRouterId PeerTransitRouterId is illegal. リージョン間接続のピア側のトランジットルーター ID が無効です。
400 OperationUnsupported.TransitRouterId TransitRouterId is unsupported. トランジットルーターが Basic Edition の場合、この操作はサポートされていません。
400 MissingParam.Bandwidth The parameter Bandwidth is mandatory. 帯域幅値のパラメーターは必須です。
400 IllegalParam.Bandwidth Bandwidth is illegal. 帯域幅パッケージ ID が無効です。
400 Forbbiden.TransitRouterServiceNotOpen The user has not open transit router service. トランジットルーターサービスが有効化されていません。サービスを有効化して、再試行してください。
400 OperationUnsupported.TransitRouterType The specified TransitRouterType does not support the operation. 現在のトランジットルータータイプでは、この操作はサポートされていません。
400 OperationUnsupported.BandwidthType The specified BandwidthType does not support the operation. 現在の BandwidthType はこの操作をサポートしていません。
400 InvalidCenId.NotFound CenId is not found. パラメーターで指定された CenId が存在しません。
400 IllegalParam.BandwidthType BandwidthType is illegal. 帯域幅パッケージタイプが無効です。
400 MissingParam.CenIdOrRegionId Either CenId or RegionId must be specified. CenId または RegionId は必須パラメーターです。
400 OperationUnsupported.BandwidthHS This bandwidth limit can only be set in China-AsiaPacific-HS
400 OperationUnsupported.CenFullLevel CEN full level does not support TransitRouter フルモード CEN インスタンスは VPN BGP をサポートしていません。
400 OperationUnsupported.CloudDataTransferService CCN region not support cloud data transfer service. CCN リージョンでは Cloud Data Transfer サービスはサポートされていません。
400 InvalidPeerTransitRouterId.NotFound The specified PeerTransitRouterId is not found. リクエストに指定された PeerTransitRouterId が存在しません。
400 IllegalParam.RegionId RegionId is illegal. リクエストで指定されたリージョンが無効です。
400 IllegalParam.PeerRegionId PeerRegionId is illegal. リクエストに指定された PeerRegionId が無効です。
400 IllegalParam.TransitRouterRegionId TransitRouterRegionId is illegal. TransitRouterRegionId が無効です。
400 InvalidOperation.CenInstanceStatus The CEN instance is not in a valid state for the operation.
400 IncorrectStatus.TransitRouter The status of TransitRouter is incorrect. トランジットルーターの現在のステータスでは、この操作はサポートされていません。後でもう一度お試しください。
400 InvalidOperation.BwpNotAssociated Operation is invalid because a bandwidth package corresponding to the geographic span is not associated. 帯域幅パッケージが対応するリージョンに関連付けられていないため、操作を実行できません。
400 InvalidOperation.BwpBusinessStatus The CBN bandwidth package is not in a valid business state for the operation. 帯域幅パッケージが安定した状態ではないため、操作を実行できません。
400 IllegalParam.CenBandwidthPackageId Parameter CenBandwidthPackageId is illegal. リクエストパラメーターで指定された CenBandwidthPackageId が無効です。
400 InvalidOperation.BwpBandwidthExceeded Operation is invalid because the total bandwidth limit has exceeded that of the bandwidth package.
400 ParameterIllegal.CdtDefaultLinkTypeOnlySupportPlatinumOrGold DataTransfer only support Platinum and Gold. 帯域幅割り当てメソッドがデータ転送量課金の場合、デフォルトのリンクタイプはプラチナおよびゴールドのみをサポートします。
400 ParameterIllegal.BandwidthPackageDefaultLinkTypeOnlySupportGold Cen bandwidthPackage only support Gold. 帯域幅割り当てメソッドが帯域幅パッケージの場合、デフォルトのリンクタイプはゴールドのみをサポートします。
400 ParameterIllegal.CdtDefaultLinkTypeOnlySupportGold CDT only support Gold when both transitrouters for cross regional connections are not all enterprise version. クロスリージョン接続の両端のトランジットルーターがすべて Enterprise Edition ではなく、かつ帯域幅割り当てメソッドがデータ転送量課金の場合、デフォルトのリンクタイプはゴールドのみをサポートします。
400 OperationNotAllowed.DefaultLinkTypeOnlySupportGold Operation is not allowed because this user can only set default link type to Gold. このユーザーは、デフォルトのリンクタイプをゴールドにのみ設定できます。
400 OperationInvalid.UserCanNotBuyCrossBorderBwp According to the laws and regulations of the operator and mainland China, you are currently not eligible to purchase or renew a cross-border bandwidth package. Please contact online customer service or your business manager for consultation. 通信事業者および中国本土の法令の要件に基づき、現在、国境を越えた帯域幅プランの購入または更新を行う資格がありません。サポートが必要な場合は、オンラインカスタマーサービスまたはアカウントマネージャーにお問い合わせください。
400 OperationInvalid.IdentityRegistrationStatusNotSupport Real name registration of enterprises required. 選択したリージョンには、中国本土と中国本土外との間の通信が含まれています。購入を進める前に、以下の条件を満たす必要があります。 1) ビジネスアカウントであること:アカウントセンターコンソールの基本情報ページに移動し、必須の情報を入力して、アカウントタイプを「企業」にセットしてください。 ビジネスアカウントの登録方法の詳細については、「ビジネスアカウントの登録」をご参照ください。 2) 企業の本人確認が完了していること:アカウントが企業の本人確認に合格しており、中国本土でクラウドリソースを購入するオプションを選択していることを確認してください。 企業の本人確認の完了方法の詳細については、「企業の本人確認」をご参照ください。
400 InvalidOperation.OnlyOneRegionSupportIpv6 Peer Attachment is only allowed when both regions support IPv6 or do not support IPv6 at all. クロスリージョン接続は、両方のリージョンが IPv6 をサポートしているか、または両方のリージョンが IPv6 をサポートしていない場合にのみ作成できます。
400 InvalidOperation Operation is invalid. 操作が無効です。
400 Forbidden.ResourceOwnerTransitRouterServiceExpired The transit router service of the account to which the resource belongs has been suspended due to arrears. Please notify the other party to renew the service and try again. リソースを所有するアカウントのトランジットルーターサービスが支払い遅延により停止されています。アカウントオーナーに通知してサービスを更新し、再試行してください。
400 Forbidden.TransitRouterServiceExpired The transit router service is out of service. トランジットルーターサービスが支払い遅延により停止されています。サービスを更新して、再試行してください。
400 OperationUnsupported.RegionId The specified RegionId does not support the operation. 現在のリージョンではこの操作はサポートされていません。
400 QuotaExceeded.Bandwidth Bandwidth quota exceeded. 帯域幅の値がクォータ制限を超えています。
400 InvalidParameter Invalid parameter. パラメーターが無効です。
400 Unauthorized The AccessKeyId is unauthorized. この操作を実行するために必須の権限がアカウントにありません。
400 InvalidParameter.PeerTransitRouterId The specified parameter PeerTransitRouterId is invalid.
400 InvalidParameter.ResourceType The specified parameter ResourceType is invalid.
400 ParameterIllegal.CdtDefaultLinkTypeOnlySupportUnderlaySilver CDT only support UnderlaySilver when both transitrouters for cross regional connections are not all enterprise version. リージョン間接続の両端のトランジットルーターがすべて Enterprise Edition ではなく、かつ帯域幅割り当てメソッドがデータ転送課金の場合、デフォルトのリンクタイプは Silver (UnderlaySilver) のみをサポートします。
400 ParameterIllegal.DefaultLinkTypeOnlySupportUnderlaySilver Cen bandwidthPackage only support UnderlaySilver. 帯域幅割り当てメソッドが帯域幅プランの場合、デフォルトのリンクタイプは Silver (UnderlaySilver) のみをサポートします。
400 OperationNotAllowed.DefaultLinkTypeOnlySupportUnderlaySilver This user can only set the default link type to UnderlaySilver. このユーザーはデフォルトのリンクタイプを Silver (UnderlaySilver) にのみ設定できます。
400 OperationFailed.ValidateVbrInstanceFailedForLowLatencyCircuit Operation failed when validate VBR instance for Low Latency Circuit. 低遅延リンクの作成時に、読み込まれた VBR インスタンスの検証が失敗しました。有効なインスタンスであることを確認してください。
400 InvalidParameter.TagValue The specified parameter TagValue is invalid. タグ値パラメーターが無効です。
400 InvalidParameter.CenBandwidthPackageId The specified parameter CenBandwidthPackageId is invalid. CenBandwidthPackageId パラメーターが無効です。
400 InvalidParameter.CenId The specified parameter CenId is invalid.
400 InvalidParameter.TransitRouterId The specified parameter TransitRouterId is invalid. TransitRouterId パラメーターが無効です。

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

変更履歴

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