仮想ボーダールーター (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 文字である必要があります。 先頭文字列は、文字または漢字である必要があります。 |
LocalGatewayIp | String | 省略可能 | 116.62.222.28 |
任意。 VBR が使用する Alibaba Cloud 側の IP アドレス。 |
Name | String | 省略可能 | テスト |
任意。 VBR の名前。 名前は 2〜128 文字である必要があります。英数字、ピリオド (.)、アンダースコア (_)、ハイフン (-) が使用可能です。 名前の先頭文字列は、英字または漢字である必要があります。
先頭文字列を |
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 を作成することはできません。 |