すべてのプロダクト
Search

このプロダクト

    Cloud Enterprise Network:CreateTransitRouterVpcAttachment

    ドキュメントセンター

    Cloud Enterprise Network:CreateTransitRouterVpcAttachment

    最終更新日:Jul 20, 2026

    CreateTransitRouterVpcAttachment 操作を呼び出し、Virtual Private Cloud (VPC) インスタンスをトランジットルーターインスタンスに接続してプライベートネットワークピアリングを実現します。接続が確立されると、トランジットルーターインスタンスを使用してプライベートネットワークピアリングを実現できます。

    操作説明

    • Enterprise Edition トランジットルーターで VPC 接続を作成するには、次の 2 つの方法があります。

      • ターゲットリージョンに Enterprise Edition トランジットルーターインスタンスが既に作成されている場合は、VpcId、ZoneMappings.N.VSwitchId、ZoneMappings.N.ZoneId、TransitRouterId、および RegionId を指定して VPC 接続を作成できます。

      • ターゲットリージョンに Enterprise Edition トランジットルーターインスタンスがない場合は、VpcId、ZoneMappings.N.VSwitchId、ZoneMappings.N.ZoneId、CenId、および RegionId を指定して VPC 接続を作成できます。VPC 接続の作成時に、システムによって Enterprise Edition トランジットルーターインスタンスの自動作成が実行されます。

    • CreateTransitRouterVpcAttachment 操作は非同期です。リクエストを送信すると、システムは VPC 接続 ID を返しますが、VPC 接続はまだ作成されていません。作成ノードはバックグラウンドで実行中です。 ListTransitRouterVpcAttachments 操作を呼び出して、VPC 接続のステータスを照会できます。

      • VPC 接続が Attaching 状態の場合、VPC 接続の作成中です。この状態では、VPC 接続に対してクエリ操作のみを実行でき、他の操作は実行できません。

      • VPC 接続が Attached 状態の場合、VPC 接続は作成済みです。

    • VPC 接続の作成後、デフォルトでは、VPC 接続はどのトランジットルータールートテーブルともルーティング学習や転送関連付けを確立しません。

    開始する前に

    この操作を呼び出して VPC 接続を作成する前に、以下の条件が満たされていることを確認してください。

    • VPC インスタンスに、Enterprise Edition トランジットルーターがサポートするゾーン内に少なくとも 1 つの vSwitch インスタンスがあり、その vSwitch インスタンスに少なくとも 1 つのアイドル IP アドレスがあること。Enterprise Edition トランジットルーターがサポートするリージョンとゾーンの詳細については、「Enterprise Edition トランジットルーターがサポートするリージョンとゾーン」をご参照ください。

    • クロスアカウント VPC 接続インスタンスを接続する場合は、事前にクロスアカウント VPC 接続インスタンスの権限付与を取得してください。詳細については、「クロスアカウント VPC 接続インスタンスの権限付与」をご参照ください。

    • VPC 接続の作成後に料金が発生します。課金ルールを理解していることを確認してください。詳細については、「課金」をご参照ください。

    今すぐお試しください

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

    create

    CenInstance

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

    TransitRouter

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

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    ClientToken

    string

    任意

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

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

    説明

    このパラメーターを指定しない場合、システムは API リクエストの RequestId を ClientToken として自動的に使用します。RequestId は API リクエストごとに異なる場合があります。

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

    string

    任意

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

    cen-j3jzhw1zpau2km****
    TransitRouterId

    string

    任意

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

    tr-bp1su1ytdxtataupl****
    RegionId

    string

    任意

    VPC 接続インスタンスのリージョン ID。

    DescribeChildInstanceRegions 操作を呼び出して、リージョン ID をクエリできます。

    cn-hangzhou。
    TransitRouterAttachmentName

    string

    任意

    VPC 接続の名前。

    名前は空、または 1～128 文字で、http:// または https:// で始まることはできません。

    testname。
    TransitRouterAttachmentDescription

    string

    任意

    VPC 接続の説明。

    説明は空、または 1～256 文字で、http:// または https:// で始まることはできません。

    testname。
    VpcId

    string

    必須

    VPC 接続インスタンスのインスタンス ID。

    vpc-bp1kbjcre9vtsebo1****
    VpcOwnerId

    integer

    任意

    VPC 接続インスタンスが属する Alibaba Cloud アカウント ID。デフォルト値は、現在のログインユーザーの Alibaba Cloud アカウント ID です。

    説明

    クロスアカウントネットワークインスタンスをロードする場合、このパラメーターは必須です。

    1250123456123456
    ChargeType

    string

    任意

    課金方法。デフォルト値: POSTPAY (従量課金を示します)。

    POSTPAY。
    DryRun

    boolean

    任意

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

    • false (デフォルト): 通常のリクエストを送信し、チェックに合格した後に VPC 接続を作成します。

    • true: チェックリクエストを送信します。チェックのみが実行され、VPC 接続は作成されません。チェック項目には、必須パラメーターが指定されているかどうかなどが含まれます。チェックに失敗した場合、対応するエラーが返されます。チェックに成功した場合、エラーコード DryRunOperation が返されます。

    false。
    ZoneMappings

    array<object>

    必須

    Enterprise Edition トランジットルーターがサポートするゾーン内の vSwitch インスタンスを選択します。

    一度に最大 10 件のエントリを追加できます。

    object

    任意

    Enterprise Edition トランジットルーターがサポートするゾーンと対応する vSwitch インスタンスの情報。

    VSwitchId

    string

    必須

    Enterprise Edition トランジットルーターがサポートするゾーン内の vSwitch インスタンスの ID。

    一度に最大 10 ゾーンの vSwitch インスタンスを選択できます。

    vsw-bp1a214sbus8z3b54****
    ZoneId

    string

    必須

    Enterprise Edition トランジットルーターがサポートするゾーンの ID。

    DescribeZones 操作を呼び出して、ゾーン ID をクエリできます。

    一度に最大 10 ゾーンを選択できます。

    cn-hangzhou-h。
    AutoPublishRouteEnabled

    boolean

    任意

    Enterprise Edition トランジットルーターが VPC インスタンスにルートエントリを自動的に公開することを許可するかどうかを指定します。

    • false (デフォルト): いいえ。

    • true: はい。

    true。
    TransitRouterVPCAttachmentOptions

    object

    任意

    VPC 接続の特徴属性のリスト (非推奨予定のため、新しいパラメーター Options を使用してください)。

    string

    任意

    VPC 接続の特徴プロパティ (非推奨予定のため、新しいパラメーター Options を使用してください)。

    ipv6Support: IPv6 を有効にするかどうかを指定します。

    • enable: IPv6 を有効にします。

    • disable: IPv6 を無効にします。

    説明

    VPC 接続で IPv6 を有効にする前に、VPC インスタンスおよび関連付けられた vSwitch インスタンスで IPv6 が有効になっていることを確認してください。詳細については、「 AllocateVpcIpv6Cidr 」および「 CreateVSwitchCidrReservation 」をご参照ください。

    disable。
    Tag

    array<object>

    任意

    タグのリスト。

    一度に最大 20 個のタグを指定できます。

    object

    任意

    タグ。

    Key

    string

    任意

    リソースのタグキー。

    指定した場合、タグキーを空文字列にすることはできません。タグキーは最大 64 文字で、aliyun または acs: で始まったり、http:// または https:// を含んだりすることはできません。

    一度に最大 20 個のタグキーを指定できます。

    tagtest。
    Value

    string

    任意

    リソースのタグ値。

    指定した場合、タグ値を空にすることはできません。タグ値は最大 128 文字で、aliyun または acs: で始まったり、http:// または https:// を含んだりすることはできません。

    各タグキーは 1 つのタグ値に対応します。一度に最大 20 個のタグ値を指定できます。

    tagtest。
    Options

    object

    任意

    特徴属性のコレクション。

    Ipv6Support

    string

    任意

    IPv6 がサポートされているかどうかを指定します。

    • disable (デフォルト): いいえ。

    • enable: 有効。

    enable
    ApplianceModeSupport

    string

    任意

    アプライアンスモードを有効にするかどうかを指定します。

    • disable (デフォルト): いいえ。

    • enable: はい。

    enable

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    応答パラメーター。

    TransitRouterAttachmentId

    string

    VPC 接続の ID。

    tr-attach-ia340z7xis7t5s****
    RequestId

    string

    リクエスト ID。

    C087A369-82B9-43EF-91F4-4B63A9C6E6B6

    例

    成功レスポンス

    JSONJSON

    {
  "TransitRouterAttachmentId": "tr-attach-ia340z7xis7t5s****",
  "RequestId": "C087A369-82B9-43EF-91F4-4B63A9C6E6B6"
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    400 OperationUnsupported.TransitRouterRegionId The specified TransitRouterRegion does not support the operation.
    400 NoPermission.AliyunServiceRoleForCEN You are not authorized to create the service linked role. Role Name: AliyunServiceRoleForCEN. Service Name: cen.aliyuncs.com. Make sure that the user has been granted the ram:CreateServiceLinkedRole permission. リクエストは承認されていません。
    400 IllegalParam.RegionId The Specified Parameter RegionId is illegal リクエストに指定されたリージョンが無効です。
    400 MissingParam.CenIdOrRegionId Either CenId or RegionId must be specified. CenId または RegionId は必須パラメーターです。
    400 IllegalParam.ZoneId The specified ZoneId is illegal. 指定されたゾーンが無効です。
    400 IllegalParam.ChargeType The specified ChargeType is illegal. 課金タイプが無効です。
    400 InvalidTransitRouterId.NotFound The specified TransitRouterId is not found. リクエストに指定された TransitRouterId が存在しません。
    400 IncorrectStatus.VpcResource The resource is not in a valid state for the attachment operation. VPC リソースが安定した状態ではありません。現在の VPC に対する関連操作が完了するまで待ってから、リトライしてください。
    400 IncorrectStatus.Vpc The resource is not in a valid state for the attachment operation. VPC の現在のステータスでは、この操作はサポートされていません。後でもう一度お試しください。
    400 IncorrectStatus.VpcOrVswitch The Vpc Or Vswith is not in a valid state for the attachment operation. VPC または vSwitch の現在のステータスでは、この操作はサポートされていません。後でもう一度お試しください。
    400 OperationNotSupport.VpcAutoRoutesPublish Auto publish vpc routes is not supported in this region. 現在のリージョンでは、自動 VPC ルート広告はサポートされていません。
    400 InvalidOperation.VpnAssociated The operation is not supported because the VPC is associated with VPN. 現在の VPC は VPN にアタッチされています。ルーティングの自動同期特徴を有効にすることはできません。
    400 Forbbiden.TransitRouterServiceNotOpen The user has not open transit router service. トランジットルーターサービスが有効化されていません。サービスを有効化して、再試行してください。
    400 IllegalParam.ZoneMappings The Specified Parameter ZoneMappings is illegal リクエストで指定された ZoneMappings が無効です。
    400 OperationUnsupported.TransitRouterType The specified TransitRouterType does not support the operation. 現在のトランジットルータータイプでは、この操作はサポートされていません。
    400 InvalidCenId.NotFound CenId is not found. パラメーターで指定された CenId が存在しません。
    400 IllegalParam.VSwitchId VSwitchId is illegal. リクエストで指定された VSwitchId が無効です。
    400 IncorrectStatus.TransitRouterInstance The status of TransitRouter is incorrect. トランジットルーターが無効な状態です。
    400 OperationUnsupported.CenFullLevel CEN full level does not support TransitRouter Full モードの CEN インスタンスは VPN BGP をサポートしていません。
    400 IllegalParam.ServiceMode ServiceMode is illegal. リクエストに指定されたサービスモードが無効です。
    400 QuotaFull.ChildInstanceRelatedCen The childinstance has exceed the quota of the times that a childinstance can be attached as an attachment. このインスタンスに関連付けられる CEN インスタンス数が上限に達しました。インスタンスを読み込めません。
    400 OperationUnsupported.CloudBoxVswNotSupport Cloud Box vsw does not support. CloudBox の vSwitch を読み込めません。
    400 IncorrectStatus.TransitRouter The status of TransitRouter is incorrect. トランジットルーターの現在のステータスでは、この操作はサポートされていません。後でもう一度お試しください。
    400 Duplicated.ZoneMapping The parameter ZoneMapping is duplicated. ZoneMapping に重複するエントリが含まれています。
    400 QuotaExceeded.CenQuotaVpcAttachPerTransitRouter The maximum number of VPC attachment per Transit Router is exceeded. 各トランジットルーターに接続できる VPC の数が制限を超えました。
    400 IncorrectStatus.VpcRouteTable The VPC route table is not in a desired state. この操作に関連付けられた VPC ルートテーブルが安定した状態ではありません。後でもう一度お試しください。
    400 InvalidStatus.VpcAttachedFullModeCen The VPC has been attached to another CEN instance whose protection level is FULL. 指定された VPC は、保護レベルが FULL に設定された別の CEN インスタンスに既にアタッチされているため、他の CEN インスタンスにアタッチすることはできません。
    400 Forbbiden.AttachChildInstanceAcrossBid VPCs that belong to another BID cannot be associated. You need to apply for cross-BID attaching. 異なる入札アカウント配下の VPC をバインドすることは許可されていません。
    400 InvalidOperation.VpcAutoRoutesPublishInOtherCEN The specified VPC already has its routes synchronized with another CEN instance. 現在の VPC では、別の CEN でルーティングの自動同期が既に有効になっています。この操作はサポートされていません。
    400 QuotaExceeded.VpcAutoRoutesPublishPerTransitRouter The number of VPCs that have route synchronization enabled has reached the upper limit. ルーティング自動同期が有効な VPC の数が上限に達しました。
    400 InsufficientIpAddr.vsw Insufficient available IP addresses in the vSwitch. vSwitch 内のアクティブな IP アドレス数が不足しています。
    400 Forbidden.ResourceOwnerTransitRouterServiceNotOpen The resource owner user has not opened transit router service. リソースを所有するアカウントのトランジットルーターサービスが有効化されていません。アカウントオーナーにサービスの有効化を通知して、再試行してください。
    400 IllegalParam.TransitRouterRegionId TransitRouterRegionId is illegal. TransitRouterRegionId が無効です。
    400 InvalidTransitRouterMode.NeedUpgrade TransitRouter need to upgrade. 現在のトランジットルーターモードはサポートされていません。
    400 IllegalParam.Ipv6Support Ipv6Support is illegal. Valid Values are [enable, disable]. Ipv6Support リクエストパラメーターの値が無効です。有効な値: enable、disable。
    400 OperationFailed.VSwitchNotFound The specified vswitch not found. 指定された VSwitchId が存在しません。vSwitch が利用可能であることを確認するか、別の利用可能な vSwitch を指定してください。
    400 OperationFailed.VSwitchIpv6CidrNotAllocated The specified vswitch does not have IPv6 address allocated. 指定された vSwitch で IPv6 が有効になっていません。この操作を実行する前に IPv6 を有効にしてください。
    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 InvalidParameter Invalid parameter. パラメーターが無効です。
    400 Unauthorized The AccessKeyId is unauthorized. アカウントにこの操作を実行する権限がありません。
    400 InvalidParameter.ResourceType The specified parameter ResourceType is invalid.
    400 ParamExclusive.TransitRouterVPCAttachmentOptionsAndOptions When creating or modifying a VPC attachment, the input parameter TransitRouterVPCAttachmentOptions and Options cannot be used at the same time. VPC ネットワーク接続性の作成または変更時、パラメーター TransitRouterVPCAttachmentOptions と Options を同時に使用することはできません。
    400 InvalidParameter.ApplianceModeSupport The specified parameter ApplianceModeSupport is invalid. パラメーター ApplianceModeSupport の値が無効です。
    400 InvalidParameter.Ipv6Support The specified parameter Ipv6Support is invalid. パラメーター Ipv6Support の値が無効です。
    400 INVALID_OPERATION_RESOURCE_NOT_SUPPORT_APPLIANCE_MODE Only VPC attachment support appliance mode. アプライアンスパターンをサポートするのは VPC ネットワーク接続性のみです。
    400 InvalidParameter.TagValue The specified parameter TagValue is invalid. タグ値パラメーターが無効です。
    404 InvalidVSwitchId.NotFound The specified VSwitchId is not found. VSwitchId が存在しません。
    409 InvalidOperation.CenInstanceStatus The CEN instance is not in a valid state for the operation. CEN の現在のステータスでは、この操作はサポートされていません。後でもう一度お試しください。
    409 IncorrectStatus.VpcSwitch The resource is not in a valid state for the attachment operation.

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

    変更履歴

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