すべてのプロダクト
Search

このプロダクト

    Express Connect:CreateVirtualBorderRouter

    ドキュメントセンター

    Express Connect:CreateVirtualBorderRouter

    最終更新日:Sep 18, 2026

    Virtual Border Router (VBR) インスタンスを作成します。

    操作説明

    VBR インスタンスの作成後、VBR インスタンスステータスは アクティブな 状態になります。

    今すぐお試しください

    この 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 ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    vpc:CreateVirtualBorderRouter

    create

    *PhysicalConnection。

    acs:vpc:{#regionId}:{#accountId}:physicalconnection/{#PhysicalConnectionId}

    *VirtualBorderRouter

    acs:vpc:{#regionId}:{#AccountId}:virtualborderrouter/*

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    RegionId

    string

    必須

    Express Connect 回線のリージョン ID。

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

    cn-shanghai
    PhysicalConnectionId

    string

    必須

    Express Connect 回線のインスタンス ID。

    専用 Express Connect 回線または共有 Express Connect 回線用に VBR インスタンスを作成できます。

    pc-2zextbehcx****
    VbrOwnerId

    integer

    任意

    VBR インスタンス所有者のアカウント ID。

    デフォルト値は、ログインに使用している Alibaba Cloud アカウントの ID です。

    168811111****
    VlanId

    integer

    必須

    VBR インスタンスの VLAN ID。有効な値: 0 ~ 2999。

    説明

    このパラメーターは、Express Connect 回線のオーナーのみが指定できます。同じ Express Connect 回線上の 2 つの VBR インスタンスの VLAN ID は異なる必要があります。

    0
    CircuitCode

    string

    任意

    Express Connect 回線に対してキャリアから提供される回線コード。

    説明

    このパラメーターは、Express Connect 回線のオーナーのみが指定できます。

    longtel001
    LocalGatewayIp

    string

    任意

    VBR インスタンスの Alibaba Cloud 側 IP アドレス。このプロパティは、VBR のオーナーのみが指定または変更できます。

    このパラメーターは、Express Connect 回線のオーナー用に VBR インスタンスを作成する場合に必須です。

    192.168.XX.XX
    PeerGatewayIp

    string

    任意

    VBR インスタンスの顧客側 IP アドレス。このプロパティは、VBR のオーナーのみが指定または変更できます。

    このパラメーターは、Express Connect 回線のオーナー用に VBR インスタンスを作成する場合に必須です。

    116.62.XX.XX
    PeeringSubnetMask

    string

    任意

    VBR インスタンスの Alibaba Cloud 側および顧客側 IP アドレスのサブネットマスク。

    2 つの IP アドレスは同じサブネット内にある必要があります。

    255.255.255.252
    Description

    string

    任意

    VBR インスタンスの説明。

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

    desc
    Name

    string

    任意

    VBR インスタンスの名前。

    名前は 2 ~ 128 文字の長さで、英字または漢字で始まる必要があります。数字、アンダースコア (_)、ハイフン (-) を含めることができます。http:// または https:// で始めることはできません。

    test
    ClientToken

    string

    任意

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

    このパラメーターの値はクライアントによって生成されます。異なるリクエスト間で値が一意であることを確認してください。

    説明

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

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

    string

    任意

    VBR インスタンスの Alibaba Cloud 側 IPv6 アドレス。このプロパティは、VBR のオーナーのみが指定または変更できます。

    このパラメーターは、Express Connect 回線のオーナー用に VBR インスタンスを作成する場合に必須です。

    2001:XXXX:3c4d:0015:0000:0000:0000:1a2b
    PeerIpv6GatewayIp

    string

    任意

    VBR インスタンスの顧客側 IPv6 アドレス。このプロパティは、VBR のオーナーのみが指定または変更できます。

    このパラメーターは、Express Connect 回線のオーナー用に VBR インスタンスを作成する場合に必須です。

    2001:XXXX:4:4:4:4:4:4
    PeeringIpv6SubnetMask

    string

    任意

    VBR インスタンスの Alibaba Cloud 側および顧客側 IPv6 アドレスのサブネットマスク。

    2 つの IPv6 アドレスは同じサブネット内にある必要があります。

    2408:4004:cc:400::/56
    EnableIpv6

    boolean

    任意

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

    • true: 有効。

    • false (デフォルト): 無効。

    true
    Bandwidth

    integer

    任意

    VBR インスタンスの帯域幅値。単位: Mbit/s。

    • 専用 Express Connect 回線用に VBR インスタンスを作成する場合、有効な値は 50、100、200、300、400、500、1000、2048、5120、8192、10240、20480、40960、50120、61440、および 102400 です。

    • 共有 Express Connect 回線用に VBR インスタンスを作成する場合、このパラメーターを設定する必要はありません。VBR の帯域幅は、共有 Express Connect 回線の作成時に設定項目で指定された共有 Express Connect 回線の帯域幅になります。

    100
    ResourceGroupId

    string

    任意

    リソースグループ ID。

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

    rg-acfmxazb4ph6aiy****
    Tags

    array<object>

    任意

    リソースのタグ。

    object

    任意

    タグ。

    Key

    string

    任意

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

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

    FinanceDept
    Value

    string

    任意

    リソースのタグ値。最大 20 個のタグ値を指定できます。タグ値は空の文字列にすることができます。

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

    FinanceJoshua

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    応答パラメーター。

    RequestId

    string

    リクエスト ID。

    4EC47282-1B74-4534-BD0E-403F3EE64CAF
    VbrId

    string

    VBR インスタンスの ID。

    vbr-bp1jcg5cmxjbl9xgc****

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "4EC47282-1B74-4534-BD0E-403F3EE64CAF",
  "VbrId": "vbr-bp1jcg5cmxjbl9xgc****"
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    400 OperationFailed.PconnAllocateVlan0 Vlan 0 Vbr cannot share the physical connection with another Vbr. Express Connect 回線上の VLAN 0 は、他の仮想ボーダールーター (VBR) と共存できません。
    400 IllegalParam.IpAddress The specified IpAddress (%s) is illegal. IP アドレスが無効です。
    400 IllegalParam.CidrBlock The specified CidrBlock (%s) is illegal. CIDR ブロックが無効です。
    400 InvalidPhysicalConnectionId.NotFound The specified PhysicalConnectionId is not found. 指定された Express Connect 回線 ID は存在しません。
    400 InvalidVlanId.Used The specified VlanId has been used.
    400 MissingParameter The input parameter 'PhysicalConnectionId' that is mandatory for processing this request is not supplied.
    400 InvalidPhysicalConnectionId.NotEnabled The specified PhysicalConnectionId is not in Enabled state.
    400 InvalidVlanId.Malformed The specified VlanId is not valid.
    400 InvalidCircuitCode.Malformed The specified CircuitCode is not valid.
    400 InvalidLocalGatewayIp.Malformed The specified LocalGatewayIp is not valid.
    400 InvalidPeeringSubnetMask.Malformed The specified PeeringSubnetMask is not valid. 指定された PeeringSubnetMask は無効です。パラメーターが正しいかどうかを確認してください。
    400 InvalidName.Malformed The specified ?Name? is not valid.
    400 InvalidDescription.Malformed The specifid ?Description? is not valid. 指定されたリソースの説明のフォーマットは無効です。説明は 2～256 文字で、http:// または https:// で始まらないようにしてください。
    400 QuotaExceeded.vbrPerpConn Virtual boarder router per PhysicalConnection quota exceed.
    400 QuotaExceeded.freevbr Free virtual boarder router quota exceed.
    400 InvalidIp.NotSameSubnet Local gateway ip and peer gateway ip are not in the same subnet. ローカルゲートウェイ IP アドレスとピアゲートウェイ IP アドレスが同じサブネット内にありません。
    400 TaskConflict The operation is too frequent, please wait a moment and try again. EIP の操作が頻繁すぎます。
    400 QuotaExceeded.CrossUserVBRPerUser Cross virtual boarder router per user quota exceed. クォータの上限に達しています。
    400 OperationFailed.VlanIdInUse Operation failed because vlanId is in use. VLAN ID はすでに使用されています。
    400 QuotaExceeded.SameAccountVBRPerPconn Same account virtual boarder router per physicalConnection quota exceed. VBR のクォータを超過しています。
    400 QuotaExceeded.VbrPerPconnPortSpec Quota exceed for current port spec クォータの上限に達しています。
    400 QuotaExceeded.VbrPerAccessDevice Virtual boarder router per access device quota exceed. デバイスのクォータを超過しています。
    400 OperationUnsupported.IPV6ForThisRegion This Region do not support IPV6. このリージョンは IPv6 をサポートしていません。
    400 VbrBandwidthExceed VBR bandwidth exceed for this physical connection. 仮想ボーダールーターの帯域幅が Express Connect 回線のしきい値を超えています。
    400 OperationFailed.PconnExistVlan0Vbr The physical connection has VLAN 0 VBR. You cannot create another VBR. Express Connect 回線上に VLAN 0 VBR が既に存在します。他の VBR を作成することはできません。
    400 OperationFailed.Vlan0VbrUnSharePconn VLAN 0 VBR cannot share the physical connection with another VBR. Express Connect 回線上に別の VLAN 0 VBR が既に存在します。この回線上に VLAN 0 VBR を作成することはできません。
    400 OperationFailed.PconnTrafficNotEnable The operation is failed because of PconnTrafficNotEnable. アウトバウンドトラフィックが有効になっていないため、操作に失敗しました。
    400 ResourceNotEnough.Bandwidth The specified resource of Bandwidth is not enough. 帯域幅リソースが不足しています。
    400 OperationUnsupported.VirtualBorderRouterEnableIPv6 The operation failed. The device or region does not support IPv6 functions. デバイスまたはリージョンが IPv6 をサポートしていないため、操作に失敗しました。
    400 IllegalParam.OwnerAliUid The param of VbrOwnerId is illegal. ユーザー ID は無効なパラメーターです。
    400 Forbidden.OwnerAliUid RAM account or Partner account is forbidden to be OwnerAliUid. VbrOwnerId がリソースアクセス管理 (RAM) ユーザーアカウントまたはパートナーアカウントであるため、VBR のオーナーアカウントとして使用できません。
    400 OperationDenied.VPconn Vpconn is forbidden to create vbr for another account. Vpconn タイプでは、この操作はサポートされていません。
    400 OperationFailed.NotConsistentWithVpconn VBR bandwidth is not consistent with vpconn VBR の帯域幅の値が、関連付けられた共有 Express Connect 回線の帯域幅の値と一致しません。
    400 IllegalParam.Bandwidth The param of bandwidth is illegal. 指定された帯域幅の値は無効です。
    400 OperationFailed.VirtualPhysicalConnectionExistVBR The virtual physical connect has already created another VBR. VirtualPhysicalConnection 用の VBR はすでに存在します。
    400 ResourceNotInResourceGroup The specified resource is not in the specified ResourceGroup. 指定されたリソースは、指定されたリソースグループ内にありません。
    400 IncorrectStatus.VirtualPhysicalConnection The status of PhysicalConnection [%s] is incorrect. 共有 Express Connect 回線 [%s] のステータスが正しくありません。
    400 EcAssociatedQoSPconnNotAllowCreateCrossAccountVbr The specified Pconn associated with Qos is not allowed to create cross account VBR.Please contact the business manager. QoS ポリシーに関連付けられている共有 Express Connect 回線では、クロスアカウントの仮想ボーダールーターを作成できません。アカウントマネージャーにお問い合わせください。
    400 OperationFailed.VbrBandWidthMust0InVlan0Vbr The operation is failed because of VbrBandWidthMust0InVlan0Vbr. 操作に失敗しました。帯域幅制限の構成は許可されていません。
    400 OperationDenied.PhysicalConnectionNotSupportMPBGPAndMPBGP-v6 The operation is not allowed because this physical connection not support MPBGP and MPBGP-v6. 現在の物理ポートは MPBGP や MPBGP-v6 などの高度な機能をサポートしていないため、この操作は実行できません。
    400 IncorrectBusinessStatus.PhysicalConnection Invalid physical connection business status. 現在の Express Connect 回線のサービスステータスでは、この操作はサポートされていません。
    500 InternalError The request processing has failed due to some unknown error, exception or failure. 不明なエラーにより、リクエストの処理に失敗しました。
    403 Forbidden.LocalGatewayIpNotAllowedByCaller The caller is not allowed to specify the LocalGatewayIp parameter.
    403 Forbidden.PeerGatewayIpNotAllowedByCaller The caller is not allowed to specify the PeerGatewayIp parameter.
    403 Forbidden.PeeringSubnetMaskNotAllowedByCaller The caller is not allowed to specify the PeeringSubnetMask parameter.
    403 Forbidden.NameNotAllowedByCaller The caller is not allowed to specify the Name parameter.
    403 Forbidden.DescriptionNotAllowedByCaller The caller is not allowed to specify the Description parameter.
    404 InvalidRegionId.NotFound The specified RegionId is not found.
    404 InvalidVbrOwnerId.NotFound The specified VbrOwnerId is not valid.
    404 CROSS_BID.FORBIDDEN Create VBR across bid is illegal Cross-BID 接続は許可されていません。
    404 OperationFailed.AccessDeviceDisabled Access device is disabled and can not create vbr. アクセスデバイスが無効になっているため、VBR を作成できません。

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

    変更履歴

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