すべてのプロダクト
Search

このプロダクト

    Virtual Private Cloud:CreateRouterInterface

    ドキュメントセンター

    Virtual Private Cloud:CreateRouterInterface

    最終更新日:Apr 27, 2026

    ルーターインターフェイスを作成します。

    操作説明

    この操作を呼び出す際は、以下の制限事項にご注意ください。

    • 2 つのルーター間に接続できるインターフェイスのペアは 1 組のみです。

    • 1 つのルーターに対して作成できるルーターインターフェイスは最大 5 個です。

    • Alibaba Cloud アカウント (root ユーザー) に支払い遅延のあるルーターインターフェイスが存在する場合、新しいルーターインターフェイスを作成できません。

    • 同一のルートテーブル内のルートエントリの宛先 CIDR ブロックは、それぞれ一意である必要があります。

    • 仮想ボーダールータ (VBR) は要求側 (requester) のみとして機能できます。また、VBR は「アクティブ」な状態である必要があります。

    • この操作を使用して、サブスクリプションおよび従量課金のルーターインターフェイスを作成できます。

    今すぐお試しください

    この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

    テスト

    RAM 認証

    この操作の認証情報はありません。問題が発生した場合は、アカウントマネージャーにご連絡ください。

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    RegionId

    string

    必須

    ルーターインターフェイスが属するリージョンの ID です。

    DescribeRegions 操作を呼び出して、リージョン ID を取得できます。

    cn-hangzhou
    Role

    string

    必須

    ルーターインターフェイスのロールです。有効値：

    • InitiatingSide：要求側 (requester)

    • AcceptingSide：受信側 (acceptor)

    InitiatingSide
    OppositeRegionId

    string

    必須

    受信側がデプロイされているリージョンの ID です。

    cn-shanghai
    Spec

    string

    必須

    ルーターインターフェイスの仕様および対応する帯域幅です。有効値：

    • Mini.2：2 Mbit/s

    • Mini.5：5 Mbit/s

    • Small.1：10 Mbit/s

    • Small.2：20 Mbit/s

    • Small.5：50 Mbit/s

    • Middle.1：100 Mbit/s

    • Middle.2：200 Mbit/s

    • Middle.5：500 Mbit/s

    • Large.1：1,000 Mbit/s

    • Large.2：2,000 Mbit/s

    • Large.5：5,000 Mbit/s

    • Xlarge.1：10,000 Mbit/s

    説明

    Role が AcceptingSide に設定されている場合は、Spec を Negative に設定してください。これは、受信側のルーターインターフェイスを作成する際に仕様を指定する必要がないことを示します。

    Mini.2
    RouterType

    string

    必須

    ルーターインターフェイスに関連付けられているルーターのタイプです。有効値：

    • VRouter

    • VBR

    VRouter
    RouterId

    string

    必須

    ルーターインターフェイスに関連付けられているルーターの ID です。

    vbr-m5ebm6g9ptc9mly1c****
    OppositeInterfaceId

    string

    任意

    ピアルーターインターフェイスの ID です。

    ri-2zeo3xzyf38r4urzd****
    OppositeRouterId

    string

    任意

    ピアルーターの ID です。

    vrt-bp1lhl0taikrteen8****
    OppositeRouterType

    string

    任意

    ピアルーターインターフェイスに関連付けられているルーターのタイプです。有効値：

    • VRouter

    • VBR

    VRouter
    OppositeInterfaceOwnerId

    string

    任意

    ピアルーターインターフェイスが属する Alibaba Cloud アカウント (root ユーザー) の ID です。

    253460731706911258
    HealthCheckSourceIp

    string

    任意

    ヘルスチェックを実行するための送信元 IP アドレスです。送信元 IP アドレスは、ローカル VPC のアイドル IP アドレスである必要があります。

    説明

    Express Connect 回線を使用している場合に、このパラメーターを設定できます。

    192.168.0.6
    HealthCheckTargetIp

    string

    任意

    ヘルスチェックを実行するための宛先 IP アドレスです。

    説明

    HealthCheckSourceIp を指定する場合は、このパラメーターが必須です。

    192.168.0.8
    AccessPointId

    string

    任意

    VBR が属するアクセスポイントの ID です。

    DescribeAccessPoints 操作を呼び出して、アクセスポイントの ID を取得できます。

    説明

    VBR が Express Connect 回線に接続されている場合は、このパラメーターが必須です。

    ap-cn-hangzhou-yh-ts-A
    OppositeAccessPointId

    string

    任意

    ピアが属するアクセスポイントの ID です。

    説明

    ピアルーターインターフェイスが VBR に関連付けられている場合は、このパラメーターが必須です。ルーターインターフェイスの作成後は、指定された値を変更できません。

    ap-cn-shanghai-nt-aligroup-C
    Description

    string

    任意

    ルーターインターフェイスの説明です。

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

    abcabc
    Name

    string

    任意

    ルーターインターフェイスの名前です。

    名前は 2～128 文字で、英数字、ピリオド (.)、アンダースコア (_)、ハイフン (-) を使用できます。

    abc
    Period

    integer

    任意

    サブスクリプション期間です。有効値：

    • PricingCycle が Month に設定されている場合：1～9

    • PricingCycle が Year に設定されている場合：1～3

    説明

    InstanceChargeType が PrePaid に設定されている場合は、このパラメーターが必須です。

    3
    InstanceChargeType

    string

    任意

    ルーターインターフェイスの課金方法です。有効値：

    • PrePaid：サブスクリプション

    • PostPaid：従量課金

    PrePaid
    AutoPay

    boolean

    任意

    自動支払いを有効にするかどうかを指定します。有効値：

    • false (デフォルト)：自動支払いは無効です。このオプションを選択した場合、注文後に注文センターで支払いを完了する必要があります。

    • true：自動支払いが有効です。注文後に支払いが自動的に完了します。

    説明

    InstanceChargeType が PrePaid に設定されている場合は、このパラメーターが必須です。

    false
    PricingCycle

    string

    任意

    サブスクリプションの課金サイクルです。有効値：

    • Month (デフォルト)

    • Year

    説明

    InstanceChargeType が PrePaid に設定されている場合は、このパラメーターが必須です。

    Month
    ClientToken

    string

    任意

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

    クライアント側でトークンを生成できますが、異なるリクエスト間でトークンが一意であることを保証する必要があります。

    説明

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

    123e4567-e89b-12d3-a456-426655440000
    ClientToken

    string

    任意

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

    クライアント側でトークンを生成できますが、異なるリクエスト間でトークンが一意であることを保証する必要があります。

    説明

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

    123e4567-e89b-12d3-a456-426655440000
    FastLinkMode

    boolean

    任意

    VBR が Fast Link モードで作成され、ルーターインターフェイスにアップリンクされるかどうかを指定します。Fast Link モードにより、VBR とそのピア VPC 用に作成されたルーターインターフェイスが自動的に接続されます。有効値：

    • true

    • false

    説明

    • このパラメーターは、RouterType が VBR に設定され、かつ OppositeRouterType が VRouter に設定されている場合にのみ有効です。

    • FastLinkMode が true に設定されている場合、Role は InitiatingSide に設定する必要があります。この場合、AccessPointId、OppositeRouterType、OpppsiteRouterId、および OppositeInterfaceOwnerId が必須となります。

    false
    AutoRenew

    boolean

    任意

    自動更新を有効にするかどうかを指定します。有効値：

    • false (デフォルト)

    • true

    false
    ResourceGroupId

    string

    任意

    リソースグループの ID です。

    リソースグループの詳細については、「Resource Management とは」をご参照ください。

    rg-acfmxazb4ph6aiy****
    Tags

    array<object>

    任意

    リソースに追加するタグです。

    object

    任意

    Key

    string

    任意

    リソースに追加するタグキーです。少なくとも 1 つのタグキーを入力する必要があります。最大 20 個のタグキーを指定できます。タグキーは空文字列であってはなりません。

    タグキーの長さは最大 128 文字です。aliyun または acs: で始めることはできず、http:// または https:// を含んではなりません。

    FinanceDept
    Value

    string

    任意

    リソースに追加するタグ値です。最大 20 個のタグ値を指定できます。タグ値は空文字列であっても構いません。

    タグ値の長さは最大 128 文字です。acs: または aliyun で始めることはできず、http:// または https:// を含んではなりません。

    FinanceJoshua

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    リクエスト ID です。

    RequestId

    string

    リクエスト ID です。

    079874CD-AEC1-43E6-AC03-ADD96B6E4907
    OrderId

    integer

    注文番号です。InstanceChargeType が PrePaid に設定されている場合に返されます。

    20210101123456
    RouterInterfaceId

    string

    ルーターインターフェイスの ID です。

    ri-2ze7fbuohm****

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "079874CD-AEC1-43E6-AC03-ADD96B6E4907",
  "OrderId": 20210101123456,
  "RouterInterfaceId": "ri-2ze7fbuohm****"
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    400 InvalidPrice.NotFound Pricing plan result not found.
    400 InvalidAliuid Invalid Aliuid.
    400 InvalidRole.ValueNotSupported The specified Role is not valid.
    400 InvalidSpec.ValudNotSupported The specified Spec is not supported.
    400 InvalidRouterType.ValueNotSupported The specified RouterType is not valid.
    400 InvalidName.Malformed The specified "Name" is not valid.
    400 Forbidden.BillsOutstanding You cannot create more RouterInterface because you have bills outstanding.
    400 LimitationExceed.InterfaceNumberOnRouter Total number of RouterInterfaces on a Router exceeded.
    400 Forbidden.NotInRouterInterfaceCreateWhitelist Not in router interface create whitelist.
    400 RI_CREATE_ONE_LIMIT_BY_SYNC Create ri only one limit by sync.
    400 InvalidAccessPoint.ValueNotAllowed The non-vbr router interface cannot have access point configured.
    400 InvalidParam.NotFound Parameter must not be null,uid, bid,regionNo, remoteRegionNo, routerId or accessPointId
    400 InvalidAccessPoint.NotMatch The accessPoint id is not matched
    400 InvalidAccessPoint.NotExist The accessPoint not exit
    400 INVAID_VBR_STATUS VBR status must be active
    400 IncorrectStatus.CenStatus Cen status must not be middle status.
    400 Forbidden.AcceptRoleNotSupportPrePay Acception side ri not support chargetype for prepaid.
    400 InvalidRouterInterfaceSpec.Malformed Specified RouterInterface spec is not valid.
    400 VpcSubnet.NotFound Vpc subnet not exist.
    400 IllegalParam.HealthcheckIp Healthcheck ip cannot equal with instance ip.
    400 OperationFailed.HcForInvalidRiType Healthchecksourceip and healthchecktargetip is only valid for vr ri that is connected to vbr.
    400 OperationFailed.SyncOrderToSub SyncOrderToSub error.
    400 IllegalParam.CrossBorderBandwidth CrossBorder bandwidth error.
    400 IllegalParam.VRouterType The VRouterType is not supported.
    400 IllegalParam.Spec The spec is illegal.
    400 Forbidden.CrossBorder User not authorized to create cross border routerInterface.
    400 InvalidRouterId.NotFound Param is not valid,this user does not have this router or aliuid bid regionNo and routerId must have something wrong.
    400 InvalidCommodity.NotFound Commodity is not exist.
    400 InvalidRouterInterfaceChargeType.Malformed Specified RouterInterface ChargeType is not valid.
    400 IllegalParam.RegionId The specified regionId is illegal.
    400 PAY.MAYI_WITHHOLDING_AGREEMENT_ILLEGAL User withhoding argeement is illegal.
    400 QuotaExceeded RiPerUser quota exceeded
    400 OperationFailed.PconnTrafficNotEnable The operation is failed because of PconnTrafficNotEnable. クラウドトラフィックがアクティブ化されていないため、操作は失敗しました。
    400 InvalidRegionId.NotFound The regionId provided does not exist in ec region list.
    400 ResourceNotInResourceGroup The specified resource is not in the specified ResourceGroup.
    400 HaveConnectionBetweenRouters Have connection between routers
    400 InvalidDescription.Malformed The specified "Description" is not valid.
    400 InvalidBandwidth.NotEnough Bandwidth not enough.
    400 ForbiddenAction The user does not support this action.
    400 OperationFailed.NotSupportIPv6 Router interface not support IPv6.
    400 InvalidParam.AvailableZoneId The specified AvailableZoneId did not retrieve the corresponding cluster IP address.
    400 OperationFailed.NoAvailableAmount The available amount of your account is less than 0, please recharge before attempting to purchase.
    400 OperationFailed.OperationLocked Operation failed because OperationLocked.
    400 OperationFailed.InvalidEcGrant The VBR have no grant to create EC.
    400 OperationFailed.CannotConnectOtherOwnerInstance Can not connect with other owner VPC or CEN.
    400 InvalidParams.NotNull params must not null.
    404 InvalidRegionId.NotFound The regionId provided does not exist in our records. 指定された値の「regionid」ではありません。
    404 InvalidRouterId.NotFound The specified RouterId does not exist in our recored.
    404 InvalidRouterId.AttacedToCEN Can not create ri when attaced to CEN.

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

    変更履歴

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