調用CreateVirtualBorderRouter介面建立邊界路由器VBR（Virtual Border Router）執行個體。
介面說明
建立 VBR 執行個體後，VBR 執行個體狀態為 active。
調試
您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| RegionId |
string |
是 |
物理專線所在的地區 ID。 您可以通過調用 DescribeRegions 介面擷取地區 ID。 |
cn-shanghai |
| PhysicalConnectionId |
string |
是 |
物理專線執行個體 ID。 可以為獨享專線建立 VBR 執行個體，也可以為共用專線建立 VBR 執行個體。 |
pc-2zextbehcx**** |
| VbrOwnerId |
integer |
否 |
VBR 執行個體所有者的帳號 ID。 預設為登入的阿里雲帳號 ID。 |
168811111**** |
| VlanId |
integer |
是 |
VBR 執行個體的 VLAN ID，取值範圍：0～2999。 說明
只有物理專線的所有者可以指定該參數，同一條物理專線下的兩個 VBR 的 VLAN ID 不能相同。 |
0 |
| CircuitCode |
string |
否 |
電訊廠商為物理專線提供的電路編碼。 說明
只有物理專線所有者可以指定該參數。 |
longtel001 |
| LocalGatewayIp |
string |
否 |
VBR 執行個體的阿里雲側互聯 IP。 該屬性只允許 VBR 所有者指定或者修改。 為物理專線所有者建立 VBR 執行個體時必填。 |
192.168.XX.XX |
| PeerGatewayIp |
string |
否 |
VBR 執行個體的客戶側互聯 IP。該屬性只允許 VBR 所有者指定或者修改。 為物理專線所有者建立 VBR 執行個體時必填。 |
116.62.XX.XX |
| PeeringSubnetMask |
string |
否 |
VBR 執行個體的阿里雲側和客戶側互聯 IP 的子網路遮罩。 兩個 IP 位址必須位於同一個子網中。 |
255.255.255.252 |
| Description |
string |
否 |
VBR 執行個體的描述資訊。 長度為 2～256 個字元，必須以字母或中文開頭，但不能以 |
desc |
| Name |
string |
否 |
VBR 執行個體的名稱。 長度為 2～128 個字元，必須以字母或中文開頭，可包含數字、底線（_）和短劃線（-），但不能以 |
test |
| ClientToken |
string |
否 |
用戶端 Token，用於保證請求的等冪性。 由用戶端產生該參數值，要保證在不同請求間唯一。 說明
若您未指定，則系統自動使用 API 請求的 RequestId 作為 ClientToken 標識。每次 API 請求的 RequestId 可能不一樣。 |
123e4567-e89b-12d3-a456-426655440000 |
| LocalIpv6GatewayIp |
string |
否 |
VBR 執行個體的阿里雲側互聯 IPv6 地址。該屬性只允許 VBR 所有者指定或者修改。 為物理專線所有者建立 VBR 執行個體時必填。 |
2001:XXXX:3c4d:0015:0000:0000:0000:1a2b |
| PeerIpv6GatewayIp |
string |
否 |
VBR 執行個體的客戶側互聯 IPv6 地址。該屬性只允許 VBR 所有者指定或者修改。 為物理專線所有者建立 VBR 執行個體時必填。 |
2001:XXXX:4:4:4:4:4:4 |
| PeeringIpv6SubnetMask |
string |
否 |
VBR 執行個體的阿里雲側和客戶側互聯 IPv6 的子網路遮罩。 兩個 IPv6 地址必須位於同一個子網中。 |
2408:4004:cc:400::/56 |
| EnableIpv6 |
boolean |
否 |
是否啟用 IPv6 功能。取值：
|
true |
| Bandwidth |
integer |
否 |
VBR 執行個體的頻寬值，單位：Mbps。
|
100 |
| ResourceGroupId |
string |
否 |
資源群組 ID。 關於資源群組的更多資訊，請參見什麼是資源群組。 |
rg-acfmxazb4ph6aiy**** |
| Tags |
array<object> |
否 |
資源的標籤。 |
|
|
object |
否 |
標籤。 |
||
| Key |
string |
否 |
資源的標籤鍵。至少輸入 1 個標籤鍵，最多支援輸入 20 個標籤鍵。如需傳入該值，不能輸入Null 字元串。 一個標籤鍵最多支援 128 個字元，不能以 |
FinanceDept |
| Value |
string |
否 |
資源的標籤值。最多支援輸入 20 個標籤值。如需傳入該值，可以輸入Null 字元串。 最多支援 128 個字元，不能以 |
FinanceJoshua |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
返回資訊。 |
||
| VbrId |
string |
VBR 執行個體 ID。 |
vbr-bp1jcg5cmxjbl9xgc**** |
| RequestId |
string |
請求 ID。 |
4EC47282-1B74-4534-BD0E-403F3EE64CAF |
樣本
正常返回樣本
JSON格式
{
"VbrId": "vbr-bp1jcg5cmxjbl9xgc****",
"RequestId": "4EC47282-1B74-4534-BD0E-403F3EE64CAF"
}錯誤碼
|
HTTP status code |
錯誤碼 |
錯誤資訊 |
描述 |
|---|---|---|---|
| 400 | OperationFailed.PconnAllocateVlan0 | Vlan 0 Vbr cannot share the physical connection with another Vbr. | 物理專線上Vlan 0 不能和其他Vbr共存 |
| 400 | IllegalParam.IpAddress | The specified IpAddress (%s) is illegal. | IpAddress參數不合法 |
| 400 | IllegalParam.CidrBlock | The specified CidrBlock (%s) is illegal. | CidrBlock參數不合法 |
| 400 | InvalidPhysicalConnectionId.NotFound | The specified PhysicalConnectionId is not found. | 該物理專線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. | 操作過於頻繁，請稍等一會再重試 |
| 400 | QuotaExceeded.CrossUserVBRPerUser | Cross virtual boarder router per user quota exceed. | 配額超限 |
| 400 | OperationFailed.VlanIdInUse | Operation failed because vlanId is in use. | vlanId已經被使用 |
| 400 | QuotaExceeded.SameAccountVBRPerPconn | Same account virtual boarder router per physicalConnection quota exceed. | VBR超過配額 |
| 400 | QuotaExceeded.VbrPerPconnPortSpec | Quota exceed for current port spec | quota超限 |
| 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. | 虛擬邊界路由器頻寬超過物理專線閾值。 |
| 400 | OperationFailed.PconnExistVlan0Vbr | The physical connection has VLAN 0 VBR. You cannot create another VBR. | 專線上已經存在VLAN 0 VBR，不允許建立其它VBR。 |
| 400 | OperationFailed.Vlan0VbrUnSharePconn | VLAN 0 VBR cannot share the physical connection with another VBR. | 專線已有其它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. | 操作失敗，裝置或region不支援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. | 共用專線不允許為其他帳號建立VBR |
| 400 | OperationFailed.NotConsistentWithVpconn | VBR bandwidth is not consistent with vpconn | VBR頻寬值與所屬共用專線頻寬值不一致 |
| 400 | IllegalParam.Bandwidth | The param of bandwidth is illegal. | Bandwidth參數非法 |
| 400 | OperationFailed.VirtualPhysicalConnectionExistVBR | The virtual physical connect has already created another VBR. | 共用專線已建立一個VBR，無法繼續建立 |
| 400 | ResourceNotInResourceGroup | The specified resource is not in the specified ResourceGroup. | 輸入的資源不在輸入的資源群組內 |
| 400 | IncorrectStatus.VirtualPhysicalConnection | The status of PhysicalConnection [%s] is incorrect. | 共用物理專線 [%s] 狀態不正確。 |
| 400 | EcAssociatedQoSPconnNotAllowCreateCrossAccountVbr | The specified Pconn associated with Qos is not allowed to create cross account VBR.Please contact the business manager. | 綁定了Qos策略的共用物理專線不允許建立跨帳號虛擬邊界路由器，請聯絡商務經理。 |
| 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等進階能力。 |
| 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. | 指定的RegionId不存在，請您檢查此產品在該地區是否可用。 |
| 404 | InvalidVbrOwnerId.NotFound | The specified VbrOwnerId is not valid. | |
| 404 | CROSS_BID.FORBIDDEN | Create VBR across bid is illegal | 禁止為其他網站的使用者建立VBR。 |
| 404 | OperationFailed.AccessDeviceDisabled | Access device is disabled and can not create vbr. | 訪問裝置已禁用，無法建立vbr。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊，參考變更詳情。