調(diào)用CreateVirtualBorderRouter接口創(chuàng)建邊界路由器VBR（Virtual Border Router）實例。
接口說明
創(chuàng)建 VBR 實例后，VBR 實例狀態(tài)為 active。
調(diào)試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
授權(quán)信息
下表是API對應(yīng)的授權(quán)信息，可以在RAM權(quán)限策略語句的Action元素中使用，用來給RAM用戶或RAM角色授予調(diào)用此API的權(quán)限。具體說明如下：
- 操作：是指具體的權(quán)限點。
- 訪問級別：是指每個操作的訪問級別，取值為寫入（Write）、讀取（Read）或列出（List）。
- 資源類型：是指操作中支持授權(quán)的資源類型。具體說明如下：
- 對于必選的資源類型，用背景高亮的方式表示。
- 對于不支持資源級授權(quán)的操作，用
全部資源表示。
- 條件關(guān)鍵字：是指云產(chǎn)品自身定義的條件關(guān)鍵字。
- 關(guān)聯(lián)操作：是指成功執(zhí)行操作所需要的其他權(quán)限。操作者必須同時具備關(guān)聯(lián)操作的權(quán)限，操作才能成功。
| 操作 | 訪問級別 | 資源類型 | 條件關(guān)鍵字 | 關(guān)聯(lián)操作 |
|---|---|---|---|---|
| vpc:CreateVirtualBorderRouter | create |
|
| 無 |
請求參數(shù)
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| RegionId | string | 是 | 物理專線所在的地域 ID。 您可以通過調(diào)用 DescribeRegions 接口獲取地域 ID。 | cn-shanghai |
| PhysicalConnectionId | string | 是 | 物理專線實例 ID。 可以為獨享專線創(chuàng)建 VBR 實例，也可以為共享專線創(chuàng)建 VBR 實例。 | pc-2zextbehcx**** |
| VbrOwnerId | long | 否 | VBR 實例所有者的賬號 ID。 默認為登錄的阿里云賬號 ID。 | 168811111**** |
| VlanId | integer | 是 | VBR 實例的 VLAN ID，取值范圍：0～2999。 說明
只有物理專線的所有者可以指定該參數(shù)，同一條物理專線下的兩個 VBR 的 VLAN ID 不能相同。
| 0 |
| CircuitCode | string | 否 | 運營商為物理專線提供的電路編碼。 說明
只有物理專線所有者可以指定該參數(shù)。
| longtel001 |
| LocalGatewayIp | string | 是 | VBR 實例的阿里云側(cè)互聯(lián) IP。 該屬性只允許 VBR 所有者指定或者修改。 為物理專線所有者創(chuàng)建 VBR 實例時必填。 | 192.168.XX.XX |
| PeerGatewayIp | string | 是 | VBR 實例的客戶側(cè)互聯(lián) IP。該屬性只允許 VBR 所有者指定或者修改。 為物理專線所有者創(chuàng)建 VBR 實例時必填。 | 116.62.XX.XX |
| PeeringSubnetMask | string | 是 | VBR 實例的阿里云側(cè)和客戶側(cè)互聯(lián) IP 的子網(wǎng)掩碼。 兩個 IP 地址必須位于同一個子網(wǎng)中。 | 255.255.255.252 |
| Description | string | 否 | VBR 實例的描述信息。 長度為 2～256 個字符，必須以字母或中文開頭，但不能以 | desc |
| Name | string | 否 | VBR 實例的名稱。 長度為 2～128 個字符，必須以字母或中文開頭，可包含數(shù)字、下劃線（_）和短劃線（-）。 | test |
| ClientToken | string | 否 | 客戶端 Token，用于保證請求的冪等性。 由客戶端生成該參數(shù)值，要保證在不同請求間唯一。 說明
若您未指定，則系統(tǒng)自動使用 API 請求的 RequestId 作為 ClientToken 標識。每次 API 請求的 RequestId 可能不一樣。
| 123e4567-e89b-12d3-a456-426655440000 |
| LocalIpv6GatewayIp | string | 否 | VBR 實例的阿里云側(cè)互聯(lián) IPv6 地址。該屬性只允許 VBR 所有者指定或者修改。 為物理專線所有者創(chuàng)建 VBR 實例時必填。 | 2001:XXXX:3c4d:0015:0000:0000:0000:1a2b |
| PeerIpv6GatewayIp | string | 否 | VBR 實例的客戶側(cè)互聯(lián) IPv6 地址。該屬性只允許 VBR 所有者指定或者修改。 為物理專線所有者創(chuàng)建 VBR 實例時必填。 | 2001:XXXX:4:4:4:4:4:4 |
| PeeringIpv6SubnetMask | string | 否 | VBR 實例的阿里云側(cè)和客戶側(cè)互聯(lián) IPv6 的子網(wǎng)掩碼。 兩個 IPv6 地址必須位于同一個子網(wǎng)中。 | 2408:4004:cc:400::/56 |
| EnableIpv6 | boolean | 否 | 是否啟用 IPv6 功能。取值：
| true |
| Bandwidth | long | 否 | VBR 實例的帶寬值，單位：Mbps。
| 100 |
| ResourceGroupId | string | 否 | 資源組 ID。 關(guān)于資源組的更多信息，請參見什么是資源組。 | rg-acfmxazb4ph6aiy**** |
| Tags | array<object> | 否 | 資源的標簽。 | |
| object | 否 | 標簽。 | ||
| Key | string | 否 | 資源的標簽鍵。至少輸入 1 個標簽鍵，最多支持輸入 20 個標簽鍵。如需傳入該值，不能輸入空字符串。 一個標簽鍵最多支持 128 個字符，不能以 | FinanceDept |
| Value | string | 否 | 資源的標簽值。最多支持輸入 20 個標簽值。如需傳入該值，可以輸入空字符串。 最多支持 128 個字符，不能以 | FinanceJoshua |
返回參數(shù)
示例
正常返回示例
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參數(shù)不合法 |
| 400 | IllegalParam.CidrBlock | The specified CidrBlock (%s) is illegal. | CidrBlock參數(shù)不合法 |
| 400 | InvalidPhysicalConnectionId.NotFound | The specified PhysicalConnectionId is not found. | 該物理專線ID不存在。 |
| 400 | InvalidVlanId.Used | The specified VlanId has been used. | 該VLAN已經(jīng)被占用。 |
| 400 | MissingParameter | The input parameter 'PhysicalConnectionId' that is mandatory for processing this request is not supplied. | 必須指定參數(shù)PhysicalConnectionId。 |
| 400 | InvalidPhysicalConnectionId.NotEnabled | The specified PhysicalConnectionId is not in Enabled state. | 該物理專線當前未處于正常狀態(tài)，請檢查物理專線后再創(chuàng)建。 |
| 400 | InvalidVlanId.Malformed | The specified VlanId is not valid. | 參數(shù)VlanId的值不合法。 |
| 400 | InvalidCircuitCode.Malformed | The specified CircuitCode is not valid. | 該CircuitCode不合法。 |
| 400 | MissingParameter | The input parameter 'LocalGatewayIp' that is mandatory for processing this request is not supplied. | 必須指定參數(shù)LocalGatewayIp。 |
| 400 | InvalidLocalGatewayIp.Malformed | The specified LocalGatewayIp is not valid. | 該本端網(wǎng)關(guān)的IP不合法。 |
| 400 | MissingParameter | The input parameter 'PeerGatewayIp' that is mandatory for processing this request is not supplied. | 必須指定參數(shù)PeerGatewayIp。 |
| 400 | MissingParameter | The input parameter 'PeeringSubnetMask' that is mandatory for processing this request is not supplied. | 必須指定參數(shù)PeeringSubnetMask。 |
| 400 | InvalidPeeringSubnetMask.Malformed | The specified PeeringSubnetMask is not valid. | 指定的PeeringSubnetMask不合法，請您檢查該參數(shù)是否正確。 |
| 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. | 超過了每個物理專線上的邊界路由器配額上限，請您減少該物理專線上的邊界路由器數(shù)量后再試。 |
| 400 | QuotaExceeded.freevbr | Free virtual boarder router quota exceed. | 超過邊界路由器配額。 |
| 400 | MissingParameter | LocalGatewayIp, peerGatewayIp and peeringSubnetMask must not be null. | 參數(shù)缺失LocalGatewayIp，peerGatewayIp，peeringSubnetMask不能為空 |
| 400 | InvalidIp.NotSameSubnet | Local gateway ip and peer gateway ip are not in the same subnet. | 本地網(wǎng)關(guān)IP地址與對端網(wǎng)關(guān)IP地址不在同一個子網(wǎng)內(nèi)。 |
| 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已經(jīng)被使用 |
| 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. | 設(shè)備配額超限 |
| 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. | 專線上已經(jīng)存在VLAN 0 VBR，不允許創(chuàng)建其它VBR。 |
| 400 | OperationFailed.Vlan0VbrUnSharePconn | VLAN 0 VBR cannot share the physical connection with another VBR. | 專線已有其它VLAN 0 VBR，不允許在此專線創(chuàng)建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. | 操作失敗，設(shè)備或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. | 共享專線不允許為其他賬號創(chuàng)建VBR |
| 400 | OperationFailed.NotConsistentWithVpconn | VBR bandwidth is not consistent with vpconn | VBR帶寬值與所屬共享專線帶寬值不一致 |
| 400 | IllegalParam.Bandwidth | The param of bandwidth is illegal. | Bandwidth參數(shù)非法 |
| 400 | OperationFailed.VirtualPhysicalConnectionExistVBR | The virtual physical connect has already created another VBR. | 共享專線已創(chuàng)建一個VBR，無法繼續(xù)創(chuàng)建 |
| 400 | ResourceNotInResourceGroup | The specified resource is not in the specified ResourceGroup. | 輸入的資源不在輸入的資源組內(nèi) |
| 400 | IncorrectStatus.VirtualPhysicalConnection | The status of PhysicalConnection [%s] is incorrect. | 共享物理專線 [%s] 狀態(tài)不正確。 |
| 400 | EcAssociatedQoSPconnNotAllowCreateCrossAccountVbr | The specified Pconn associated with Qos is not allowed to create cross account VBR.Please contact the business manager. | 綁定了Qos策略的共享物理專線不允許創(chuàng)建跨賬號虛擬邊界路由器，請聯(lián)系商務(wù)經(jīng)理。 |
| 403 | Forbidden.LocalGatewayIpNotAllowedByCaller | The caller is not allowed to specify the LocalGatewayIp parameter. | 不允許指定LocalGatewayIp參數(shù)。 |
| 403 | Forbidden.PeerGatewayIpNotAllowedByCaller | The caller is not allowed to specify the PeerGatewayIp parameter. | 不允許指定PeerGatewayIp參數(shù)。 |
| 403 | Forbidden.PeeringSubnetMaskNotAllowedByCaller | The caller is not allowed to specify the PeeringSubnetMask parameter. | 不允許指定PeeringSubnetMask參數(shù)。 |
| 403 | Forbidden.NameNotAllowedByCaller | The caller is not allowed to specify the Name parameter. | 不允許指定Name參數(shù)。 |
| 403 | Forbidden.DescriptionNotAllowedByCaller | The caller is not allowed to specify the Description parameter. | 不允許指定Description參數(shù)。 |
| 404 | InvalidRegionId.NotFound | The specified RegionId is not found. | 指定的RegionId不存在，請您檢查此產(chǎn)品在該地域是否可用。 |
| 404 | InvalidVbrOwnerId.NotFound | The specified VbrOwnerId is not valid. | 參數(shù)VbrOwnerId的值不合法。 |
| 404 | CROSS_BID.FORBIDDEN | Create VBR across bid is illegal | 禁止為其他站點的用戶創(chuàng)建VBR。 |
| 404 | OperationFailed.AccessDeviceDisabled | Access device is disabled and can not create vbr. | 訪問設(shè)備已禁用，無法創(chuàng)建vbr。 |
| 500 | InternalError | The request processing has failed due to some unknown error, exception or failure. | 內(nèi)部錯誤 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
| 變更時間 | 變更內(nèi)容概要 | 操作 |
|---|---|---|
| 2024-02-01 | OpenAPI 錯誤碼發(fā)生變更 | 查看變更詳情 |
| 2023-09-11 | OpenAPI 描述信息更新、OpenAPI 錯誤碼發(fā)生變更 | 查看變更詳情 |
| 2023-07-24 | OpenAPI 錯誤碼發(fā)生變更 | 查看變更詳情 |
| 2023-07-20 | OpenAPI 錯誤碼發(fā)生變更、OpenAPI 入?yún)l(fā)生變更 | 查看變更詳情 |