すべてのプロダクト
Search

このプロダクト

    Express Connect:CreateVirtualBorderRouter

    ドキュメントセンター

    Express Connect:CreateVirtualBorderRouter

    最終更新日:Apr 27, 2026

    仮想ボーダールータ (VBR) を作成します。

    操作説明

    VBR を作成すると、その VBR は アクティブな 状態になります。

    今すぐお試しください

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

    テスト

    RAM 認証

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

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    RegionId

    string

    必須

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

    最新のリージョン一覧を確認するには、DescribeRegions 操作を呼び出してください。

    cn-shanghai
    PhysicalConnectionId

    string

    必須

    Express Connect 回線の ID です。

    専用接続またはホスト接続に対して 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 の IP アドレスです。このパラメーターを設定または変更できるのは VBR の所有者のみです。

    Express Connect 回線の所有者向けに VBR を作成する場合、このパラメーターは必須です。

    192.168.XX.XX
    PeerGatewayIp

    string

    任意

    データセンター内のゲートウェイデバイスの IP アドレスです。このパラメーターを設定または変更できるのは VBR の所有者のみです。

    Express Connect 回線の所有者向けに VBR を作成する場合、このパラメーターは必須です。

    116.62.XX.XX
    PeeringSubnetMask

    string

    任意

    VBR とデータセンター内のゲートウェイデバイスの IP アドレスのサブネットマスクです。

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

    255.255.255.252
    Description

    string

    任意

    VBR の説明です。

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

    desc
    Name

    string

    任意

    VBR の名前です。

    名前は 2 ～ 128 文字で、英字、数字、アンダースコア (_)、ハイフン (-) を使用できます。先頭は英字で始まる必要があります。

    test
    ClientToken

    string

    任意

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

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

    説明

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

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

    string

    任意

    VBR の IPv6 アドレスです。このパラメーターを設定または変更できるのは VBR の所有者のみです。

    Express Connect 回線の所有者向けに VBR を作成する場合、このパラメーターは必須です。

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

    string

    任意

    データセンター内のゲートウェイデバイスの IPv6 アドレスです。このパラメーターを設定または変更できるのは VBR の所有者のみです。

    Express Connect 回線の所有者向けに VBR を作成する場合、このパラメーターは必須です。

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

    string

    任意

    VBR とデータセンター内のゲートウェイデバイスの IPv6 アドレスのサブネットマスクです。

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

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

    boolean

    任意

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

    • true：IPv6 を有効にします。

    • false (デフォルト)：IPv6 を無効にします。

    true
    Bandwidth

    integer

    任意

    VBR の帯域幅です。単位：Mbit/s。

    • 専用接続向けに VBR を作成する場合、有効値は 50、100、200、300、400、500、1000、2048、5120、8192、10240、20480、40960、50120、61440、および 102400 です。

    • ホスト接続向けに VBR を作成する場合は、このパラメーターを設定する必要はありません。帯域幅はホスト接続作成時にすでに設定されています。

    100
    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 文字です。http:// または https:// を含んではならず、aliyun または acs: で始めることはできません。

    FinanceJoshua

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    返されたデータです。

    VbrId

    string

    VBR の ID です。

    vbr-bp1jcg5cmxjbl9xgc****
    RequestId

    string

    リクエスト ID です。

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

    例

    成功レスポンス

    JSONJSON

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

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    400 OperationFailed.PconnAllocateVlan0 Vlan 0 Vbr cannot share the physical connection with another Vbr.
    400 IllegalParam.IpAddress The specified IpAddress (%s) is illegal.
    400 IllegalParam.CidrBlock The specified CidrBlock (%s) is illegal.
    400 InvalidPhysicalConnectionId.NotFound The specified PhysicalConnectionId is not found.
    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.
    400 InvalidName.Malformed The specified ?Name? is not valid.
    400 InvalidDescription.Malformed The specifid ?Description? is not valid.
    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.
    400 TaskConflict The operation is too frequent, please wait a moment and try again.
    400 QuotaExceeded.CrossUserVBRPerUser Cross virtual boarder router per user quota exceed.
    400 OperationFailed.VlanIdInUse Operation failed because vlanId is in use.
    400 QuotaExceeded.SameAccountVBRPerPconn Same account virtual boarder router per physicalConnection quota exceed.
    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.
    400 VbrBandwidthExceed VBR bandwidth exceed for this physical connection.
    400 OperationFailed.PconnExistVlan0Vbr The physical connection has VLAN 0 VBR. You cannot create another VBR.
    400 OperationFailed.Vlan0VbrUnSharePconn VLAN 0 VBR cannot share the physical connection with another 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.
    400 IllegalParam.OwnerAliUid The param of VbrOwnerId is illegal.
    400 Forbidden.OwnerAliUid RAM account or Partner account is forbidden to be OwnerAliUid.
    400 OperationDenied.VPconn Vpconn is forbidden to create vbr for another account.
    400 OperationFailed.NotConsistentWithVpconn VBR bandwidth is not consistent with vpconn
    400 IllegalParam.Bandwidth The param of bandwidth is illegal.
    400 OperationFailed.VirtualPhysicalConnectionExistVBR The virtual physical connect has already created another VBR.
    400 ResourceNotInResourceGroup The specified resource is not in the specified ResourceGroup.
    400 IncorrectStatus.VirtualPhysicalConnection The status of PhysicalConnection [%s] is incorrect.
    400 EcAssociatedQoSPconnNotAllowCreateCrossAccountVbr The specified Pconn associated with Qos is not allowed to create cross account VBR.Please contact the business manager.
    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.
    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
    404 OperationFailed.AccessDeviceDisabled Access device is disabled and can not create vbr.

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

    変更履歴

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