ModifyVirtualBorderRouterAttribute API を呼び出して、仮想ボーダールータ (VBR) の構成を変更できます。
操作説明
-
VlanId は、Express Connect 回線の所有者のみが変更できます。
-
同一の Express Connect 回線上では、同じ VLAN ID を複数の VBR で同時に使用できません。
-
terminated ステータスの VBR は、VLAN ID を 7 日間排他的に保持します。この期間中、他の VBR はその VLAN ID を使用できません。7 日経過後、その VLAN ID は他の VBR で使用可能になります。
-
他のアカウントが所有する VBR インスタンスでは、LocalGatewayIp、PeerGatewayIp、および PeeringSubnetMask を設定できません。
-
PeeringSubnetMask は、サブネットマスク /24 ～ /30（255.255.255.0 ～ 255.255.255.252）をサポートします。
-
LocalGatewayIp および PeerGatewayIp は、同一のネットワークセグメントに属している必要があります。例：LocalGatewayIp：192.168.XX.XX、PeerGatewayIp：192.168.XX.XX、PeeringSubnetMask：255.255.255.248。
今すぐお試しください
テスト
RAM 認証
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| RegionId |
string |
必須 |
VBR のリージョン ID です。 最新のリージョン一覧を取得するには、DescribeRegions 操作を呼び出してください。 |
cn-shanghai |
| VbrId |
string |
必須 |
VBR ID です。 |
vbr-bp1lhl0taikrte**** |
| VlanId |
integer |
任意 |
VBR の VLAN ID です。有効値：0 ～ 2999。 説明
このパラメーターは Express Connect 回線の所有者のみが使用できます。同一の Express Connect 回線上にある VBR の VLAN ID は一意である必要があります。 |
0 |
| CircuitCode |
string |
任意 |
Express Connect 回線の回線コードです。回線コードは接続プロバイダーから提供されます。 説明
このプロパティを設定できるのは、Express Connect 回線の所有者のみです。 |
longtel001 |
| LocalGatewayIp |
string |
任意 |
VBR の IP アドレスです。 このパラメーターを設定または変更できるのは、VBR の所有者のみです。 |
192.168.XX.XX |
| PeerGatewayIp |
string |
任意 |
データセンター内のゲートウェイデバイスの IP アドレスです。 このパラメーターを設定または変更できるのは、VBR の所有者のみです。 |
192.168.XX.X |
| PeeringSubnetMask |
string |
任意 |
Alibaba Cloud 側および顧客側のゲートウェイデバイスの IP アドレスに使用するサブネットマスクです。このパラメーターを設定または変更できるのは、VBR の所有者のみです。 両方の IP アドレスは、同一のサブネット内に存在する必要があります。 |
255.255.255.252 |
| MinTxInterval |
integer |
任意 |
BFD パケットの送信間隔です。有効値：200 ～ 1000。単位：ミリ秒。 |
300 |
| MinRxInterval |
integer |
任意 |
BFD パケットの受信間隔です。有効値：200 ～ 1000。単位：ミリ秒。 |
300 |
| DetectMultiplier |
integer |
任意 |
送信側がパケットを送信中に受信側が許容できるドロップパケットの最大数です。この値を使用して、接続が期待どおりに機能しているかを確認できます。 有効値：3 ～ 10。 |
3 |
| Description |
string |
任意 |
VBR の説明です。 長さは 2 ～ 256 文字で、先頭は英字である必要があります。 |
desc |
| Name |
string |
任意 |
VBR の名前です。 長さは 2 ～ 128 文字で、英字、数字、アンダースコア (_)、ハイフン (-) を使用できます。先頭は英字である必要があります。 |
VBR |
| AssociatedPhysicalConnections |
string |
任意 |
VBR に関連付けられた Express Connect 回線の情報です。以下のパラメーターが含まれます。
|
[ { "VlanId": "5", "CircuitCode": "longtel001", "LocalGatewayIp": "192.168.XX.XX", "PeerGatewayIp": "192.168.XX.XX", "PeeringSubnetMask": "255.255.255.252", "LocalIpv6GatewayIp": "fd00:XXXX:1030:3f41::1", "PeerIpv6GatewayIp": "fd00:XXXX:1030:3f41::2", "PeeringIpv6SubnetMask": "fd00:0:1030:3f41::/126", "ipv6Enable": true, "PhysicalConnectionId": "pc-kojok19****" } ] |
| ClientToken |
string |
任意 |
リクエストのべき等性を保証するために使用されるクライアントトークンです。 クライアント側でトークンを生成できますが、異なるリクエスト間でトークンが一意であることを保証する必要があります。トークンには ASCII 文字のみを使用できます。 説明
このパラメーターを指定しない場合、システムは自動的に リクエスト ID を クライアントトークン として使用します。リクエスト ID は各リクエストごとに異なる場合があります。 |
02fb3da4-130e-11e9-8e44-00**** |
| LocalIpv6GatewayIp |
string |
任意 |
VBR の IPv6 アドレスです。 |
2001:XXXX:3c4d:0015:0000:0000:0000:1a2b |
| PeerIpv6GatewayIp |
string |
任意 |
データセンター内のゲートウェイデバイスの IPv6 アドレスです。
|
2001:XXXX:3c4d:0015:0000:0000:0000:2a2b |
| PeeringIpv6SubnetMask |
string |
任意 |
VBR およびデータセンター内のゲートウェイデバイスの IPv6 アドレスのサブネットマスクです。 両方の IPv6 アドレスは、同一のサブネット内に存在する必要があります。 |
2408:4004:cc:400::/56 |
| EnableIpv6 |
boolean |
任意 |
IPv6 を有効にするかどうかを指定します。有効値：
|
false |
| Bandwidth |
integer |
任意 |
帯域幅の値です。単位：Mbit/s。 |
100 |
| SitelinkEnable |
boolean |
任意 |
データセンター間でのサービスアクセスを許可するかどうかを示します。有効値：
|
false |
| Mtu |
integer |
任意 |
VBR がサポートする MTU 値です。有効値：1500 および 8500。 この値は、VBR が ECR にアタッチされている場合にのみ設定できます。また、この値は同一の ECR 内の他のすべての VBR および VPC にも影響します。 |
1500 |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
リクエスト ID です。 |
||
| RequestId |
string |
リクエスト ID です。 |
980960B0-2969-40BF-8542-EBB34FD358AB |
例
成功レスポンス
JSONJSON
{
"RequestId": "980960B0-2969-40BF-8542-EBB34FD358AB"
}エラーコード
|
HTTP ステータスコード |
エラーコード |
エラーメッセージ |
説明 |
|---|---|---|---|
| 400 | IllegalParam.AssociatedPhysicalConnections | The specified AssociatedPhysicalConnections is illegal. | |
| 400 | IllegalParam.IpAddress | The specified IpAddress is illegal. | |
| 400 | IllegalParam.CidrBlock | The specified CidrBlock is illegal. | |
| 400 | InvalidVbrId.NotFound | The specified VirutalBorderRouter is not found. | |
| 400 | IllegalParam.MinTxInterval | The specified MinTxInterval is not in proper range. | |
| 400 | IllegalParam.MinRxInterval | The specified MinRxInterval is not in proper range. | |
| 400 | IllegalParam.DetectMultiplier | The specified DetectMultiplier is not in proper range. | |
| 400 | InvalidVlanId.Used | The specified VlanId has been used. | |
| 400 | Duplicated.LocalGatewayIp | The specified LocalGatewayIps are duplicated. | |
| 400 | Duplicated.PeerGatewayIp | The specified PeerGatewayIp are duplicated. | |
| 400 | IllegalParam.LocalGatewayIp | The specified LocalGatewayIp already exists. | |
| 400 | IllegalParam.PeerGatewayIp | The specified PeerGatewayIp already exists. | |
| 400 | InvalidCircuitCode.Malformed | The specified CircuitCode is not valid. | |
| 400 | InvalidVlanId.Malformed | The specified VlanId is not valid. | |
| 400 | InvalidIp.Malformed | The specified ip address 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 | MissingParameter | LocalGatewayIp, peerGatewayIp and peeringSubnetMask must not be null. | |
| 400 | InvalidIp.NotSameSubnet | Local gateway ip and peer gateway ip are not in the same subnet. | |
| 400 | InvalidParameter | %s | |
| 400 | OperationFailed.VlanIdInUse | Operation failed because vlanId is in use. | |
| 400 | IncorrectStatus.VirtualBorderRouter | %s | |
| 400 | OperationUnsupported.IPV6ForThisRegion | This Region do not support IPV6. | |
| 400 | OperationFailed.PconnTrafficNotEnable | The operation is failed because of PconnTrafficNotEnable. | クラウドトラフィックがアクティブ化されていないため、操作は失敗しました。 |
| 400 | OperationDenied.VBRAssociateVPconn | The operation is not allowed because of VBRAssociateVPconn. | |
| 400 | OperationFailed.PhysicalConnectionFinancialLocked | Update failed, the physical connection is financial locked. | |
| 400 | OperationFailed.PhysicalConnectionTerminated | Update failed, the physical connection is terminated. | |
| 400 | OperationFailed.VbrBandWidthMust0InVlan0Vbr | The operation is failed because of VbrBandWidthMust0InVlan0Vbr. | |
| 400 | MissingParam.DetectMultiplier | The parameter DetectMultiplier is mandatory. | |
| 400 | MissingParam.MinRxInterval | The parameter MinRxInterval is mandatory. | |
| 400 | MissingParam.MinTxInterval | The parameter MinTxInterval is mandatory. | |
| 400 | DuplicatedParam.LocalGatewayIp | The LocalGatewayIp values are duplicated. | |
| 400 | Forbidden.VbrNotAllowModifySiteLink | Can not modify virtualBorderRouter site link, please call PD to authorize. | |
| 400 | OperationUnsupported.VirtualBorderRouterEnableIPv6 | The operation failed. The device or region does not support IPv6 functions. | |
| 400 | OperationFailed.PconnAllocateVlan0 | Vlan 0 Vbr cannot share the physical connection with another Vbr. | |
| 400 | IllegalParam.VlanId | The parameter VlanId is illegal. | |
| 400 | OperationFailed.VbrLocked | The VBR is locked. | |
| 400 | IllegalParam.%s | The param of %s is illegal. | |
| 400 | OperationDenied.NotInWhiteList | User does not have permission to turn on jumbo frames. | |
| 400 | IncorrectStatus.Ecr | The express connect router is not in a steady state and cannot operate. | |
| 400 | ResourceInConfiguring.NodeId | The express connect router subinstance is not in a steady state and cannot operate. | |
| 400 | UnsupportedFeature.JumboFrame | The jumbo frame feature is not supported in the current region. | |
| 403 | Forbidden.CircuitCodeNotAllowedByCaller | The caller is not allowed to modify. | |
| 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.VlanIdNotAllowedByCaller | The caller is not allowed to specify the VlanId. | |
| 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. |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。