:CreateRouteEntry

使用上の注意

• CreateRouteEntry は非同期操作です。リクエストが送信されると、システムはリクエスト ID を返し、バックグラウンドでタスクを実行します。DescribeRouteEntryList 操作を呼び出して、タスクのステータスをクエリできます。
  • ルートが Creating 状態の場合、ルートは追加中です。
  • ルートが Created 状態の場合、ルートは追加済みです。
• 一定期間内に CreateRouteEntry を繰り返し呼び出すことはできません。

• 1 つのルートテーブルには、最大 200 個のカスタムルートエントリを含めることができます。
• カスタムルートエントリの宛先 CIDR ブロック (DestinationCidrBlock) は、VPC 内の vSwitch の CIDR ブロックと同じ、またはそのサブセットにすることはできません。宛先 CIDR ブロックには、vSwitch の CIDR ブロックを含めることができます。
• カスタムルートエントリの宛先 CIDR ブロック (DestinationCidrBlock) は、100.64.0.0/10 またはそのサブセットにすることはできません。
• 同じルートテーブル内のルートエントリの宛先 CIDR ブロック (DestinationCidrBlock) は一意である必要があります。
• 宛先 CIDR ブロック (DestinationCidrBlock) を指定するときにマスク長を含めない場合、宛先 CIDR ブロックはマスク長が 32 ビットのホスト IP アドレスと見なされます。
• 複数カスタムルートエントリを同じネクストホップ (NextHopId) にポイントできます。
• カスタムルートエントリのネクストホップ (NextHopId) は、ルートテーブルと同じ VPC に属している必要があります。
• NextHopList を指定することで、等価コストマルチパス (ECMP) ルーティングを設定できます。
  • 非 ECMP ルートエントリを追加する場合は、DestinationCidrBlock、NextHopType、および NextHopId を指定する必要があり、NextHopList を指定することはできません。
  • ECMP ルーティングのルートエントリを追加する場合は、DestinationCidrBlock と NextHopList を指定する必要があり、NextHopType または NextHopId を指定することはできません。

• 1 つのルートテーブルには、最大 200 個のカスタムルートエントリを含めることができます。
• NextHopList はサポートされていません。
• カスタムルートエントリの宛先 CIDR ブロック (DestinationCidrBlock) は、100.64.0.0/10 またはそのサブセットにすることはできません。
• 同じルートテーブル内のルートエントリの宛先 CIDR ブロック (DestinationCidrBlock) は一意である必要があります。
• 宛先 CIDR ブロック (DestinationCidrBlock) を指定するときにマスク長を含めない場合、宛先 CIDR ブロックはマスク長が 32 ビットのホスト IP アドレスと見なされます。
• 複数カスタムルートエントリを同じネクストホップ (NextHopId) にポイントできます。
• カスタムルートエントリのネクストホップ (NextHopId) は、VBR に関連付けられたルーターインターフェースである必要があります。
• VBR が アクティブ 状態であり、VBR に関連付けられた Express Connect 回線が 有効 状態であり、支払い遅延のためにロックされていない場合にのみ、ルートエントリを追加できます。
• 非 ECMP ルートエントリのみがサポートされています。非 ECMP ルートエントリを追加する場合は、DestinationCidrBlock、NextHopType、および NextHopId を指定する必要があり、NextHopList を指定することはできません。

リクエストパラメーター

レスポンスパラメーター

説明

サンプルリクエスト

http(s)://[Endpoint]/?Action=CreateRouteEntry
&RegionId=cn-hangzhou
&RouteTableId=vtb-bp145q7glnuzd****
&DestinationCidrBlock=192.168.0.0/24
&NextHopId=i-j6c2fp57q8rr4jlu****
&ClientToken=02fb3da4-130e-11e9-8e44-001****
&RouteEntryName=test
&Description=test
&NextHopType=RouterInterface
&NextHopList=[{"NextHopId":"ri-2zeo3xzyf3cd8r4****","Weight":10,"NextHopType":"RouterInterface"}]
&共通リクエストパラメーター

サンプルの成功レスポンス

XML 形式

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateRouteEntryResponse>
    <RouteEntryId>rte-sn6vjkioxte1gz83z****</RouteEntryId>
    <RequestId>0ED8D006-F706-4D23-88ED-E11ED28DCAC0</RequestId>
</CreateRouteEntryResponse>

JSON 形式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RouteEntryId" : "rte-sn6vjkioxte1gz83z****",
  "RequestId" : "0ED8D006-F706-4D23-88ED-E11ED28DCAC0"
}

エラーコード

エラーコードの一覧については、「サービスエラーコード」をご参照ください。