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 ブロックは、次の要件を満たしている必要があります。
|
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 |
ネクストホップのタイプ。 有効な値:
|
レスポンスパラメーター
パラメーター | データ型 | 値の例 | 説明 |
---|---|---|---|
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 は存在しません。 | 指定されたルートエントリは存在しません。 |