すべてのプロダクト
Search

このプロダクト

    :CreateTransitRouterPeerAttachment

    ドキュメントセンター

    :CreateTransitRouterPeerAttachment

    最終更新日:May 08, 2025

    Enterprise Edition 転送ルータにクロスリージョン接続を作成します。

    背景情報

    デフォルトでは、転送ルータ間のクロスリージョン通信に 1 Kbit/s の帯域幅が提供されます。これにより、クロスリージョン IPv4 ネットワークの接続性をテストできます。異なるリージョンにデプロイされているサービスが相互に通信できるようにするには、クロスリージョン接続を作成し、接続に帯域幅リソースを割り当てる必要があります。

    Enterprise Edition 転送ルータでは、次の方法を使用してクロスリージョン接続に帯域幅リソースを割り当てることができます。

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

      帯域幅プランを購入し、帯域幅プランからクロスリージョン接続に帯域幅リソースを割り当てる必要があります。詳細については、「CEN 帯域幅プランを作成する」をご参照ください。

    • トラフィック課金帯域幅リソースを使用する:

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

    使用上の注意

    CreateTransitRouterPeerAttachment は非同期操作です。リクエストを送信した後、システムはクロスリージョン接続 ID を返しますが、操作は引き続きシステムバックグラウンドで実行されています。ListTransitRouterPeerAttachments を呼び出して、クロスリージョン接続のステータスをクエリできます。

    • クロスリージョン接続が Attaching 状態の場合、クロスリージョン接続は作成中です。クロスリージョン接続をクエリできますが、他のリージョンを実行することはできません。
    • クロスリージョン接続が Attached 状態の場合、クロスリージョン接続は作成されています。

    デバッグ

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

    リクエストパラメータ

    パラメータタイプ必須例説明
    ActionStringはいCreateTransitRouterPeerAttachment

    実行する操作。値を CreateTransitRouterPeerAttachment に設定します。

    ClientTokenStringいいえ02fb3da4-130e-11e9-8e44-001****

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

    クライアントを使用して値を生成できますが、異なるリクエスト間で一意であることを確認する必要があります。 ClientToken には ASCII 文字のみを含めることができます。

    説明 このパラメータを設定しない場合、システムは自動的に RequestId を ClientToken として使用します。各 API リクエストの RequestId の値は異なる場合があります。
    CenIdStringいいえcen-j3jzhw1zpau2km****

    クラウドエンタープライズネットワーク ( CEN ) インスタンスの ID。

    TransitRouterIdStringいいえtr-bp1su1ytdxtataupl****

    ローカルの Enterprise Edition 転送ルータの ID。

    RegionIdStringいいえcn-hangzhou

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

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

    TransitRouterAttachmentNameStringいいえtestname

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

    名前は 2 ～ 128 文字で、文字、数字、アンダースコア (_ )、およびハイフン (-) を含めることができます。名前は文字で始める必要があります。

    TransitRouterAttachmentDescriptionStringいいえtestdesc

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

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

    PeerTransitRouterIdStringはいtr-m5eq27g6bndum7e88****

    ピア転送ルータの ID。

    PeerTransitRouterRegionIdStringいいえcn-qingdao

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

    AutoPublishRouteEnabledBooleanいいえfalse

    ローカルの Enterprise Edition 転送ルータがクロスリージョン接続のルートをピア転送ルータに自動的にアドバタイズするのを有効にするかどうかを指定します。有効な値：

    • false (デフォルト): いいえ。
    • true: はい。
    BandwidthIntegerいいえ2

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

    • BandwidthType を BandwidthPackage に設定した場合、このパラメータはクロスリージョン接続で使用可能な帯域幅を指定します。
    • BandwidthType を DataTransfer に設定した場合、このパラメータはクロスリージョン接続の帯域幅制限を指定します。
    CenBandwidthPackageIdStringいいえcenbwp-3xrxupouolw5ou****

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

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

    リクエストを確認するが操作を実行しないかどうかを指定します。システムは、指定されたインスタンスの権限とステータスを確認します。有効な値：

    • false (デフォルト): リクエストを確認します。リクエストがチェックに合格すると、クロスリージョン接続が作成されます。
    • true: リクエストを確認しますが、操作は実行しません。リクエストがチェックに合格した後、クロスリージョン接続は作成されません。この値を使用すると、システムは必須パラメータとリクエスト構文をチェックします。リクエストが事前チェックに合格しなかった場合は、エラーメッセージが返されます。リクエストがチェックに合格すると、システムはリクエストの ID を返します。
    BandwidthTypeStringいいえBandwidthPackage

    クロスリージョン接続に帯域幅を割り当てるために使用されるメソッド。有効な値：

    BandwidthPackage: 帯域幅プランから帯域幅を割り当てます。

    DataTransfer: トラフィック課金帯域幅を使用します。

    レスポンスパラメータ

    パラメータタイプ例説明
    TransitRouterAttachmentIdStringtr-attach-nwkiqfvw22qesz****

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

    RequestIdString59422BF5-BAAD-4CFD-9019-9557BD3ACFA3

    リクエストの ID。

    例

    サンプルリクエスト

    http(s)://[Endpoint]/?Action=CreateTransitRouterPeerAttachment
&ClientToken=02fb3da4-130e-11e9-8e44-001****
&CenId=cen-j3jzhw1zpau2km****
&TransitRouterId=tr-bp1su1ytdxtataupl****
&RegionId=cn-hangzhou
&TransitRouterAttachmentName=testname
&TransitRouterAttachmentDescription=testdesc
&PeerTransitRouterId=tr-m5eq27g6bndum7e88****
&PeerTransitRouterRegionId=cn-qingdao
&AutoPublishRouteEnabled=false
&Bandwidth=2
&CenBandwidthPackageId=cenbwp-3xrxupouolw5ou****
&DryRun=false
&BandwidthType=BandwidthPackage
&共通リクエストパラメータ

    サンプルの成功レスポンス

    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エラーコードエラーメッセージ説明
    400OperationUnsupported.TransitRouterRegionIdThe specified TransitRouterRegion does not support the operation.指定されたリージョンがこの操作をサポートしていないために返されるエラーメッセージ。
    400NoPermission.AliyunServiceRolePolicyForCENYou 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.サービス cen.aliyuncs.com のサービスロール AliyunServiceRolePolicyForCEN を作成する権限がないために返されるエラーメッセージ。操作を実行する前に、ram:CreateServiceLinkedRole 権限を取得する必要があります。
    400InvalidTransitRouterId.NotFoundTransitRouterId is not found.転送ルータの ID が無効なために返されるエラーメッセージ。
    400IllegalParam.PeerTransitRouterIdPeerTransitRouterId is illegal.ピア転送ルータの ID が無効なために返されるエラーメッセージ。
    400OperationUnsupported.TransitRouterIdTransitRouterId is unsupported.Basic Edition 転送ルータがこの操作をサポートしていないために返されるエラーメッセージ。
    400MissingParam.BandwidthThe parameter Bandwidth is mandatory.帯域幅値が指定されていないために返されるエラーメッセージ。

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