仮想ボーダールーター (VBR) を作成します。

現在のアカウントを使用して VBR を作成する場合、作成後の VBR の状態は有効になります。 他のアカウントを使用して VBR を作成する場合、作成された VBR のステータスは未確認になります。 他のアカウントからの確認が必要になります。

デバッグ

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

リクエストパラメーター

パラメーター データ型 必須/省略可能 値の例 説明
Action String 必須 CreateVirtualBorderRouter

この操作の名前です。

値:CreateVirtualBorderRouter

PhysicalConnectionId String 必須 pc-xxxxxxxxx

物理接続の ID 。

RegionId String 必須 cn-shanghai

物理接続が属するリージョンの ID 。 リージョン ID を照会するには、DescribeRegions を呼び出します。

VlanId Integer 必須 10

VBR の VLAN ID 。 値の範囲:1〜2999

物理接続の所有者のみがこのパラメーターを指定することができます。 同じ物理接続内にある 2 つの VBR の VLAN ID は異なる ID である必要があります。
CircuitCode String 省略可能 longtel001

任意。 物理接続のためにサービスプロバイダーが提供する専用回線コード。

このパラメーターは物理接続の所有者のみが指定することができます。
ClientToken String 省略可能 02fb3da4-130e-11e9-8e44-0016e04115b

任意。 クライアントトークン。 リクエストのべき等性を保証するために使用されます。 このパラメーターの値は、クライアントによって生成される、多様なリクエストにおいて一意の値です。 長さは 1〜64 ASCII 文字である必要があります。

Description String 省略可能 VBR の説明

任意。 VBR の説明。 説明の長さは 2~256 文字である必要があります。 先頭文字列は、文字または漢字である必要があります。 http://や、 https://にすることはできません。

LocalGatewayIp String 省略可能 116.62.222.28

任意。 VBR が使用する Alibaba Cloud 側の IP アドレス。

Name String 省略可能 テスト

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

PeerGatewayIp String 省略可能 116.62.222.28

任意。 VBR が使用するカスタマー側の IP アドレス。 VBR 所有者のみがこのパラメーターを指定または変更することができます。 このパラメーターは、物理接続所有者の VBR を作成する場合に必要なパラメーターです。他のアカウントの VBR を作成する場合はこのパラメーターを指定することはできません。

PeeringSubnetMask String 省略可能 255.255.255.252

任意。 Alibaba Cloud 側の IP アドレスとカスタマー側の IP アドレスのサブネットマスク。 これら 2 つの IP アドレスは同じ CIDR ブロック内にある必要があります。

VbrOwnerId Long 省略可能 10

任意。 VBR 所有者のアカウント ID 。 既定値は、現在のユーザーのアカウント ID 、すなわち物理接続の所有者です。

レスポンスパラメーター

パラメーター データ型 値の例 説明
VbrId String vbr-bp1jcg5cmxjbl9xgc58bw

VBR の ID 。

RequestId String 4EC47282-1B74-4534-BD0E-403F3EE64CAF

リクエスト ID。

リクエストの例


http(s)://[Endpoint]/? Action = CreateVirtualBorderRouter
&PhysicalConnectionId=pc-xxxxxxxxx
&RegionId=cn-shanghai
&VlanId=10
&<CommonParameters>

レスポンスの例

XML 形式

<CreateRouterInterfaceResponse>
  <RequestId>980960B0-2969-40BF-8542-EBB34FD358AB</RequestId>
  <VbrId>vbr-2zecmmvg5gvu8i4telkhw</VbrId>
</CreateRouterInterfaceResponse>

JSON 形式

{
	"CreateRouterInterfaceResponse":{
		"RequestId":"980960B0-2969-40BF-8542-EBB34FD358AB",
		"VbrId":"vbr-2zecmmvg5gvu8i4telkhw"
	}
}

エラーコード

HTTP ステータスコード エラーコード エラーメッセージ 説明
404 InvalidRegionId.NotFound 指定された RegionId が見つかりません。 指定された RegionId は無効です。 指定のリージョンでクラウドサービスが利用可能か確認してください。
400 InvalidPhysicalConnectionId.NotFound 指定された PhysicalConnectionId が見つかりません。 指定された物理接続 ID は無効です。
400 InvalidVlanId.Used 指定された VlanId が使用されました。 指定された VLAN はすでに使用されています。
400 MissingParameter リクエスト処理に必須の入力パラメーター 'PhysicalConnectionId' が指定されていません。 PhysicalConnectionId パラメーターを指定する必要があります。
400 InvalidPhysicalConnectionId.NotEnabled 指定された PhysicalConnectionId が有効の状態になっていません。 指定された物理接続のステータスでは、この操作は許可されていません。
404 InvalidVbrOwnerId.NotFound 指定された VbrOwnerId は無効です。 VbrOwnerId パラメーターの値が無効です。
400 InvalidVlanId.Malformed 指定された VlanId は無効です。 VlanId パラメーターの値が無効です。
400 InvalidCircuitCode.Malformed 指定された CircuitCode は無効です。 CircuitCode パラメーターの指定値が無効です。
400 MissingParameter このリクエスト処理に必須の入力パラメーター 'LocalGatewayIp' が指定されていません。 LocalGatewayIp パラメーターを指定する必要があります。
400 InvalidLocalGatewayIp.Malformed 指定された LocalGatewayIp は無効です。 ローカルゲートウェイの IP アドレスが無効です。
400 MissingParameter このリクエスト処理に必須の入力パラメーター 'PeerGatewayIp' が指定されていません。 PeerGatewayIp パラメーターを指定する必要があります。
400 MissingParameter このリクエスト処理に必須の入力パラメーター 'PeeringSubnetMask' が指定されていません。 PeeringSubnetMask パラメーターを指定する必要があります。
400 InvalidPeeringSubnetMask.Malformed 指定された PeeringSubnetMask は無効です。 PeeringSubnetMask パラメーターの指定値が無効です。
403 Forbidden.LocalGatewayIpNotAllowedByCaller 呼び出し元は、LocalGatewayIp パラメーターを指定することを許可されていません。 LocalGatewayIp パラメーターを指定することを許可されていません。
403 Forbidden.PeerGatewayIpNotAllowedByCaller 呼び出し元は、PeerGatewayIp パラメーターを指定することを許可されていません。 PeerGatewayIp パラメーターを指定することを許可されていません。
403 Forbidden.PeeringSubnetMaskNotAllowedByCaller 呼び出し元は、PeeringSubnetMask パラメーターを指定することを許可されていません。 PeeringSubnetMask パラメーターを指定することを許可されていません。
403 Forbidden.NameNotAllowedByCaller 呼び出し元は、Name パラメーターを指定することを許可されていません。 Name パラメーターを指定することはできません。
403 Forbidden.DescriptionNotAllowedByCaller 呼び出し元は、Description パラメーターを指定できません。 Description パラメーターを指定することはできません。
400 InvalidName.Malformed 指定された? Name? が無効です。 指定された名前は無効です。
400 InvalidDescription.Malformed 指定された? Description? が無効です。 説明が無効です。 説明の長さは 2~256 文字である必要があります。 先頭文字列を http:// または https:// にすることはできません。
400 QuotaExceeded.vbrPerpConn 各 PhysicalConnection クォータの仮想ボーダールーターを超えています。 物理接続の VBR クォータを超えています。
400 QuotaExceeded.freevbr 無料の仮想ボーダールーターのクォータを超えています。 VBR クォータを超えています。
400 InvalidIp.NotSameSubnet ローカルゲートウェイ IP とピアゲートウェイ IP が同一のサブネット内にありません。 ローカルゲートウェイ IP とピアゲートウェイ IP が同一のサブネット内にありません。
404 CROSS_BID.FORBIDDEN bid をまたいで VBR を作成することは違法です。 別のサイトのユーザー用に VBR を作成することはできません。

一般的なエラーコードをご参照ください。