VRouter または VBR にカスタムルートエントリを作成します。

このアクションで VRouter のカスタムルートエントリを追加する前に、次の内容をご確認ください。

  • ルートテーブルには、最大 48 個のカスタムルートエントリを作成できます。
  • 各カスタムルートエントリのターゲット CIDR ブロックを VSwitch の CIDR ブロックと同じにすることはできません。また、VSwitch の CIDR ブロックを含めたり VSwitch の CIDR ブロックに含まれることもできません。
  • 各カスタムルートエントリのターゲット CIDR ブロックを 100.64.0.0/10 にすることはできません。また、100.64.0.0/10 に含めることはできません。
  • 同じルートテーブル内のルートエントリのターゲット CIDR ブロックを同じにすることはできません。
  • ターゲット CIDR ブロックが IP アドレスの場合、マスク/32 が使用されます。
  • 複数のルートエントリが同じネクストホップをポイントすることができます。
  • 各カスタムルートエントリとルートテーブルのネクストホップは同じ VPC 内に存在する必要があります。
  • NextHopList パラメーターを使用して ECMP の設定ができます。
    • 通常のカスタムルートエントリ (非 ECMP) を追加する場合、DestinationCidrBlock、NextHopType、NextHopId パラメーターを指定する必要があります。NextHopList パラメーターは指定できません。
    • ECMP ルートエントリを追加する場合、DestinationCidrBlock および NextHopList パラメーターを指定する必要があります。NextHopType および NextHopId パラメーターを指定することはできません。

      このアクションで VBR のルートエントリを追加する場合は、次のことに注意してください。

  • ルートテーブルには、最大 48 個のルートエントリを作成できます。
  • NextHopList パラメーターはサポートされていません。
  • 各カスタムルートエントリのターゲット CIDR ブロックを100.64.0.0/10 にしたり、100.64.0.0/10 に含めることはできません。
  • 同じルートテーブル内のルートエントリのターゲット CIDR ブロックを同じにすることはできません。
  • ターゲット CIDR ブロックが IP アドレスの場合、マスク/32が使用されます。
  • 複数のルートエントリが同じ ネクストホップ (NextHopId) をポイントすることができます。
  • 各ルートエントリのネクストホップ (NextHopId) は、VBRに関連付けられたルーターインターフェイスである必要があります。
  • VBR がアクティブステータスで、対応する物理接続が有効ステータス、かつ財務的にロックされていない場合にのみ、ルートエントリを追加できます。
  • 共通ルートエントリ (非 ECMP) のみが追加可能です。 DestinationCidrBlock、NextHopType、NextHopId パラメーターを指定する必要があります。HopList パラメーターは指定できません。

デバッグ

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

リクエストパラメーター

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

この操作の名前。

値:CreateRouteEntry

DestinationCidrBlock String 必須 192.168.0.1/24

カスタムルートエントリのターゲット CIDR ブロック。 IPv4 および IPv6 の両方のターゲット CIDR ブロックがサポートされています。 ターゲット CIDR ブロックは、次の要件を満たしている必要があります。

  • ターゲット CIDR ブロックを 100.64.0.0/10 またはそのサブネットにすることはできません。
  • ルートテーブル内の異なるルートエントリに同じターゲット CIDR ブロックを使用することはできません。
  • ターゲット CIDR ブロックが IP アドレスの場合、デフォルトでマスク/32が使用されます。
  • ターゲット CIDR ブロックが IPv6 アドレスの場合、マスク/128が使用されます。
RegionId String 必須 cn-hangzhou

ルートテーブルが属するリージョンの ID。

RouteTableId String 必須 VTB-bp145q7glnuzdxxxxxxxx

ルートテーブルの ID。

ClientToken String 省略可能 02fb3da4-130e-11e9-8e44-001xxxxxxxx

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

NextHopId String 省略可能 ri-2zeo3xzyf38r4xxxxxxxx

ネクストホップとして使用されるインスタンスの ID 。

NextHopList.N.NextHopId String 省略可能 ri-2zeo3xzyf38r4xxxxxxxx

ネクストホップとして使用されるインスタンスの ID 。

NextHopList.N.NextHopType String 省略可能 RouterInterface

ネクストホップのタイプ。 有効な値:

RouterInterface:ルーターインターフェイス

NextHopList.N.Weight Integer 省略可能 10

ネクストホップのルーティングの重み。

NextHopType String 省略可能 RouterInterface

ネクストホップのタイプ。 有効な値:

  • Instance:ECS インスタンス (デフォルト)
  • HaVip:HaVip
  • RouterInterface:ルーターインターフェイス
  • NetworkInterface:Elastic Network Interface (ENI)
  • VpnGateway:VPN ゲートウェイ
  • IPv6Gateway:IPv6 ゲートウェイ

レスポンスパラメーター

パラメーター データ型 値の例 説明
RequestId String 0ED8D006-F706-4D23-88ED-E11ED28DCAC0

リクエストの ID 。

リクエストの例


https://vpc.aliyuncs.com/?Action=CreateRouteEntry
&DestinationCidrBlock=192.168.0.1/24
&RouteTableId=vtb-bp145q7glnuzdxxxxxxxx
&<CommonParameters>

レスポンス例

XML 形式

<CreateRouteEntryResponse>
  <RequestId>12D086F6-8F31-4658-84C1-006DED011A85</RequestId>
</CreateRouteEntryResponse>

JSON 形式

{
	 "RequestId":"12D086F6-8F31-4658-84C1-006DED011A85"
}

エラーコード

HTTP ステータスコード エラーコード エラーメッセージ 説明
404 InvalidInstanId.NotFound 指定されたインスタンスは存在しません。 指定されたインスタンスは存在しません。
400 MissingParameter 必須のパラメーターが入力されていません。 必須のパラメーターが未入力です。
400 InvalidCidrBlock.Malformed 指定された CIDR ブロックは無効です。 指定された CIDR ブロックの形式が無効です。
404 InvalidNextHopId.NotFound 指定されたネクストホップは存在しません。 指定されたネクストホップは存在しません。
404 InvalidRouteTableId.NotFound 指定されたルートテーブルは存在しません。 指定された VRouter は存在しません。
400 InvalidCIDRBlock.Duplicate 指定された CIDR ブロックは既に存在します。 指定された CIDR ブロックは、このルートテーブルに既に存在します。
400 IncorrectVpcStatus 現在の VPC のステータスでは、この操作を実行できません。 現在の VPC のステータスでは実行できない操作です。
400 IncorrectInstanceStatus 現在のインスタンスのステータスでは、この操作を実行できません。 指定されたインスタンスのステータスでは実行できない操作です。
400 QuotaExceeded 該当のルートテーブルのルートエントリクォータを超えています。 ルートエントリのクォータを超えています。
400 IncorrectRouteEntryStatus 一部のルートエントリのステータスによってこの操作がブロックされました。 ルートテーブルに、Pending または Modifying ステータスのエントリが含まれています。
400 InvalidCidrBlock 指定された CIDR ブロックは無効です。 考えられる原因 1. このCIDR ブロックは IP アドレス 10.0.0.0/8 のホワイトリストで設定されていないため、使用できません。 2. 追加されたルートエントリのターゲット CIDR ブロックは、同じ VPC 内の VSwitch の CIDR ブロックに属することはできません。 3. CIDRブロックを 100.64.0.0/10 にすることはできません。
400 InvalidNextHopType 指定されたパラメーター "NextHopType" は無効です。 指定されたネクストホップのタイプが無効です。
400 InvalidNextHop.NotFound 指定されたネクストホップは存在しません。 指定されたネクストホップは存在しません。
400 InvalidVRouter.NotFound vRouter が存在しません。 VRouterが存在しません。
400 InvalidVpc.NotFound Vpc が存在しません。 指定された VPC は存在しません。 入力した VPC が正しいか確認してください。
400 InvalidNexthopTypeAndList.BothNull nexthopType および nextHopList の両方が null になっています。 ネクストホップタイプとネクストホップリストが未入力です。
400 InvalidNexthopTypeAndList.BothNotNull nexthopType および nextHopList の両方が null になっていません。 ネクストホップタイプおよびネクストホップリストの両方を未入力にすることはできません。
400 InvalidRouterInterface ルーターインターフェイスが無効です。 指定されたルーターインターフェイスは存在しません。
400 InvalidOppositeRouterType ネクストホップリストには、もう一方のルーターインターフェイスが vbr 上にあるルーターインターフェイスのみを含めることはできません。 ネクストホップとして使用されるルーターインターフェイスのピアルーターのタイプは VBR である必要があります。
400 InvalidNexthopListSize ネクストホップのサイズが違法です。 サイズは 2 〜 4 でなければなりません。 ネクストホップとして 2 〜 4 個のルーターインターフェイスを指定する必要があります。
400 InvalidEntryRuleQuota.NotFound ルートエントリのクォータルールが存在しません。 指定されたルートエントリクォータルールは存在しません。
400 Forbidden.CheckEntryRuleQuota ルートエントリのクォータルールの確認エラー。 ルートエントリクォータの確認中にエラーが発生しました。
400 InvalidVBRStatus 仮想ボーダールーターのステータスが無効です。 VBR のステータスが無効です。
400 InvalidPhysicalConnectionBusinessStatus 物理接続ビジネスステータスが無効です。 物理接続のステータスが無効です。
404 InvalidHaVipId.NotFound 指定された VPC に、指定の HaVip が存在しません。 指定された VPC に、指定の HaVip は存在しません。
400 IncorrectHaVipStatus 指定された HaVip のステータスが Available または InUse のいずれでもないため、操作が却下されました。 HAVIP のステータスが Available または InUse であるため、この操作は実行できません。
400 CountLimitExceed.HaVipRouteEntry 1 つのルートテーブルに対して、 HaVip へのルートエントリは最大で 5つまでです。 指定された HaVip インスタンスをポイントするカスタムルートエントリの数が制限に達しました。
400 InvalidRouteEntry.Duplicate ルートエントリが既に存在します。 指定されたルートエントリは既に存在します。
403 IncorrectInstanceStatus リソースの現在のステータスではこの操作を実行できません。 現在のボリュームのステータスでは実行できない操作です。
400 InvalidCidrBlock 指定された CIDR ブロックは既に存在します。 指定された CIDR ブロックは、別の VSwitch の CIDR ブロックまたは既存のカスタムルートエントリの CIDR ブロックと重複しています。 使用されてない CIDR ブロックを選択してください。
400 IncorrectRouteEntryStatus 指定された routeEntry のステータスに関するエラーが発生しました。 ルートテーブルに Pending または Modifying ステータスのエントリが含まれています。
400 IncorrectRouteEntryStatus vpc のステータスが NotStable routeEntry です。 ルートテーブルに Pending または Modifying ステータスのエントリが含まれているため、この操作は実行できません。
400 IncorrectRouteEntryStatus VBR のルートエントリが NotStable になっています。 ルートテーブルには Pending または Modifying ステータスのエントリが含まれているため、この操作は許可されません。
400 InvalidParam Ecmp routerEntry と、ルーターインターフェイスのローカル vgw vip が一致しません。 ルートエントリが、ルーターインターフェイスのローカルビデオゲートウェイの VIP と一致していません。
400 INVALID_WEIGHT_PARAM 指定された重みの値が無効です。 指定された Weight は無効です。
400 FORBIDDEN_USE_VPC_AS_INTERNET_GATEWAY 指定の CIDR は vpc CIDR にある必要があります。 指定の CIDR ブロックは、VPC CIDR ブロックのサブセットである必要があります。
400 INVALID_VPC_ID 指定された VpcId が一致しません。 指定された VPC は存在しません。
400 InvalidRouteEntrySize 指定された routerEntry のサイズは違法です。 ECMP の設定において、2 〜 4 のルーターインターフェイスをネクストホップとして設定する必要があります。
400 InvalidRouteEntry 指定された routeEntry は存在しません。 指定されたルートエントリは存在しません。

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