仮想ボーダールーター (VBR) の設定を変更します。
この API を呼び出す前に、次の内容をご確認ください。
- VLAN ID は、物理接続の所有者だけが変更できます。
- 物理接続の VLAN ID は、2 つの VBR で同時に使用することはできません。
- VBR が [終了] 状態になると、その VLAN ID は 7 日間保持され、この期間中は他の VBR による使用が許可されません。 VBR の終了から 7 日経過した後、他の VBR で使用することができます。
- 他のアカウントに属する VBR の LocalGatewayIp、PeerGatewayIp、PeeringSubnetMask パラメーターを設定することはできません。
- LocalGatewayIp、PeerGatewayIp、PeeringSubnetMask の要件は次のとおりです。
- PeeringSubnetMask の範囲は /24 〜 /30 です。
- PeeringSubnetMask は、ドット付き 10 進表記をサポートし、255.255.255.0 〜 255.255.255.252 の範囲で指定することができます。
-
LocalGatewayIp と PeerGatewayIp は、同じ CIDR ブロックに存在する必要があります。
以下は例です。
- LocalGatewayIp: 192.168.xx.17
- PeerGatewayIp: 192.168.xx.18
- PeeringSubnetMask: 255.255.255.248
デバッグ
リクエストパラメーター
パラメータ | データ型 | 必須 | 値の例 | 説明 |
---|---|---|---|---|
Action | String | 必須 | ModifyVirtualBorderRouterAttribute |
この操作の名前。 値: ModifyVirtualBorderRouterAttribute |
RegionId | String | 必須 | cn-shanghai |
VBR が属するリージョンの ID。 リージョン ID を照会するには、DescribeRegionsを呼び出します。 |
VbrId | String | 必須 | vbr-************** |
VBR の ID。 |
AssociatedPhysicalConnections | String | 任意 | pc-kojok19xxxxxxxxx |
任意。 物理接続の ID。 |
CircuitCode | String | 任意 | longtel001 |
任意。 物理接続のためにサービスプロバイダーが提供する専用回線コード。 注 このパラメーターは物理接続の所有者のみが指定することができます。
|
ClientToken | String | 任意 | 02fb3da4-130e-11e9-8e44-00xxxxxxxx |
任意。 クライアントトークン。 <td class="en-UStry align-left colsep-1 rowsep-1">リクエストのべき等性を保証するために使用されます 。 このパラメーターの値はクライアントによって生成されます。 異なるリクエストの間で一意な値となり、長さが 1 〜 64 文字の ASCII 文字です。 |
説明 | String | 任意 | VBR |
任意。 VBR の説明。 説明は、長さが 2 ~ 256 文字で、文頭はアルファベットから始める必要があります。 先頭文字列を |
DetectMultiplier | Long | 任意 | 3 |
任意。 検出時間の乗数。受信者が送信者に許可する破棄される接続パケットの最大数。 値の範囲: 3~10。 |
LocalGatewayIp | String | 任意 | 116.62.xx.xx |
任意。 VBR が使用する Alibaba Cloud 側の IP アドレス。 |
MinRxInterval | Long | 任意 | 100 |
任意。 受信される 2 つの連続した BFD パケット間の時間間隔。 値の範囲: 200 ~ 1000。 単位: ms |
MinTxInterval | Long | 任意 | 100 |
任意。 送信される 2 つの連続した BFD パケット間の時間間隔。 値の範囲: 200 ~ 1000 単位: ms |
Name | String | 任意 | test |
任意。 VBR の名前。 名前は 2〜128 文字である必要があります。英数字、ピリオド (.)、アンダースコア (_)、ハイフン (-) が使用可能です。 名前の先頭文字列は、英字または漢字である必要があります。
先頭文字列を |
PeerGatewayIp | String | 任意 | 120.120.xx.xx |
任意。 VBR が使用するカスタマー側の IP アドレス。 VBR 所有者のみがこのパラメーターを指定または変更することができます。 [有効] 状態の VBR では、このパラメーターを空のままにすることはできません。 |
PeeringSubnetMask | String | 任意 | 255.255.128.0 |
任意。 Alibaba Cloud 側の IP アドレスとカスタマー側の IP アドレスのサブネットマスク。 これら 2 つの IP アドレスは同じ CIDR ブロック内にある必要があります。 |
VlanId | Integer | No | 12 |
任意。 VBR の VLAN ID 。 値の範囲:1〜2999 注 このパラメーターは物理接続の所有者のみが指定することができます。 同じ物理接続に関連付けられた 2 つの VBR の VLAN ID は、異なる ID である必要があります。
|
応答パラメーター
パラメーター | データ型 | 値の例 | 説明 |
---|---|---|---|
RequestId | String | 980960B0-2969-40BF-8542-EBB34FD358AB |
リクエスト ID。 |
例
要求の例
http(s)://[Endpoint]/? Action=ModifyVirtualBorderRouterAttribute
&RegionId=cn-shanghai
&VbrId=vbr-***********
&<CommonParameters>
レスポンスの例
XML
形式
<ModifyVirtualBorderRouterAttributeResponse>
<RequestId>980960B0-2969-40BF-8542-EBB34FD358AB</RequestId>
</ModifyVirtualBorderRouterAttributeResponse>
JSON
形式
{
"RequestId":"980960B0-2969-40BF-8542-EBB34FD358AB"
}
エラー
HTTP ステータスコード | エラーコード | エラーメッセージ | 説明 |
---|---|---|---|
404 | InvalidRegionId.NotFound | 指定された RegionId が見つかりません。 | 指定されたリージョン ID は無効です。 指定のリージョンでクラウドサービスが利用可能か確認してください。 |
400 | InvalidVbrId.NotFound | The specified VirutalBorderRouter is not found. | 指定された VBR は存在しません。 |
400 | InvalidVlanId.Used | 指定された VlanId が使用されました。 | 指定された VLAN はすでに使用されています。 |
400 | InvalidCircuitCode.Malformed | 指定された CircuitCode は無効です。 | CircuitCode パラメーターの指定値が無効です。 |
400 | InvalidVlanId.Malformed | 指定された VlanId は無効です。 | VlanId パラメーターの指定値が無効です。 |
400 | InvalidIp.Malformed | The specified ip address is not valid. | 指定されたプライベート IP アドレスは無効です。 |
400 | InvalidPeeringSubnetMask.Malformed | 指定された PeeringSubnetMask は無効です。 | PeeringSubnetMask パラメーターの指定値が無効です。 |
403 | Forbidden.CircuitCodeNotAllowedByCaller | The caller is not allowed to modify. | CircuitCode パラメーターを変更することはできません。 |
403 | Forbidden.CircuitCodeNotAllowedByCaller | The caller is not allowed to specify the CircuitCode parameter. | CircuitCode パラメーターを指定することはできません。 |
403 | Forbidden.LocalGatewayIpNotAllowedByCaller | 呼び出し元は、LocalGatewayIp パラメーターを指定することを許可されていません。 | LocalGatewayIp パラメーターを指定することを許可されていません。 |
403 | Forbidden.PeerGatewayIpNotAllowedByCaller | The caller is not allowed to specify the PeerGatewayIp parameter. | PeerGatewayIp パラメーターを指定することを許可されていません。 |
403 | Forbidden.PeeringSubnetMaskNotAllowedByCaller | 呼び出し元は、PeeringSubnetMask パラメーターを指定することを許可されていません。 | PeeringSubnetMask パラメーターを指定することを許可されていません。 |
403 | Forbidden.VlanIdNotAllowedByCaller | The caller is not allowed to specify the VlanId. | VLAN ID を指定することはできません。 |
403 | Forbidden.NameNotAllowedByCaller | 呼び出し元は、Name パラメーターを指定することを許可されていません。 | Name パラメーターを指定することはできません。 |
403 | Forbidden.DescriptionNotAllowedByCaller | 呼び出し元は、Description パラメーターを指定できません。 | Description パラメーターを指定することはできません。 |
400 | InvalidIp.NotSameSubnet | ローカルゲートウェイ IP とピアゲートウェイ IP が同一のサブネット内にありません。 | ローカルゲートウェイ IP とピアゲートウェイ IP が同一のサブネット内にありません。 |
エラーコードについては、「API エラーセンター」をご参照ください。