仮想ボーダールーター (VBR) の設定を変更します。

この API を呼び出す前に、次の内容をご確認ください。

  • VLAN ID は、物理接続の所有者だけが変更できます。
  • 物理接続の VLAN ID は、2 つの VBR で同時に使用することはできません。
  • VBR が [終了] 状態になると、その VLAN ID は 7 日間保持され、この期間中は他の VBR による使用が許可されません。 VBR の終了から 7 日経過した後、他の VBR で使用することができます。
  • 他のアカウントに属する VBR の LocalGatewayIpPeerGatewayIpPeeringSubnetMask パラメーターを設定することはできません。
  • LocalGatewayIpPeerGatewayIpPeeringSubnetMask の要件は次のとおりです。
    • PeeringSubnetMask の範囲は /24 〜 /30 です。
    • PeeringSubnetMask は、ドット付き 10 進表記をサポートし、255.255.255.0 〜 255.255.255.252 の範囲で指定することができます。
    • LocalGatewayIpPeerGatewayIp は、同じ CIDR ブロックに存在する必要があります。

      以下は例です。

    • LocalGatewayIp: 192.168.xx.17
    • PeerGatewayIp: 192.168.xx.18
    • PeeringSubnetMask: 255.255.255.248

デバッグ

OpenAPI Explorer を使用して、デバッグ操作を実行し、SDK コード例を生成します。

リクエストパラメーター

パラメータ データ型 必須 値の例 説明 
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 文字で、文頭はアルファベットから始める必要があります。 先頭文字列をhttp:// https://にすることはできません。

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 文字である必要があります。英数字、ピリオド (.)、アンダースコア (_)、ハイフン (-) が使用可能です。 名前の先頭文字列は、英字または漢字である必要があります。 先頭文字列をhttp:// https://にすることはできません。

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 エラーセンター」をご参照ください。