Enterprise Edition トランジットルーターのルートテーブルにルートエントリを追加します。
操作説明
CreateTransitRouterRouteEntry は非同期操作です。リクエストを送信すると、システムはルートエントリ ID を返しますが、ルートエントリはまだ作成されていません。作成タスクはバックグラウンドで引き続き実行されます。ListTransitRouterRouteEntries を呼び出して、ルートエントリのステータスをクエリできます。
ルートエントリが Creating 状態の場合、ルートエントリは作成中です。この状態では、ルートエントリのクエリのみ可能です。ルートエントリに対して他の操作を実行することはできません。
ルートエントリが Active 状態の場合、ルートエントリは作成済みです。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
cen:CreateTransitRouterRouteEntry |
create |
*TransitRouterRouteTable
|
なし | なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| ClientToken |
string |
任意 |
リクエストのべき等性を確保するために使用されるクライアントトークン。 クライアントを使用してトークンを生成できますが、異なるリクエスト間でトークンが一意であることを確認する必要があります。クライアントトークンには ASCII 文字のみを使用できます。 説明
このパラメーターを指定しない場合、システムは API リクエストの RequestId を ClientToken として自動的に使用します。RequestId は各 API 呼び出しごとに異なる場合があります。 |
02fb3da4-130e-11e9-8e44-001**** |
| TransitRouterRouteEntryName |
string |
任意 |
ルートエントリの名前。 名前は空、または 1~128 文字の長さに設定でき、http:// または https:// で始めることはできません。 |
testname |
| TransitRouterRouteEntryDescription |
string |
任意 |
ルートエントリの説明。 説明は空、または 1~256 文字の長さに設定でき、http:// または https:// で始めることはできません。 |
testdesc |
| TransitRouterRouteTableId |
string |
必須 |
Enterprise Edition トランジットルーターのルートテーブルの ID。 |
vtb-bp1dudbh2d5na6b50**** |
| TransitRouterRouteEntryNextHopType |
string |
必須 |
ネクストホップのタイプ。有効な値:
|
BlackHole |
| TransitRouterRouteEntryDestinationCidrBlock |
string |
必須 |
ルートエントリの送信先 CIDR ブロック。IPv4 アドレスと IPv6 アドレスの両方がサポートされています。 |
192.168.0.0/24 |
| TransitRouterRouteEntryNextHopId |
string |
任意 |
ルートエントリのネクストホップに関連付けられたネットワークインスタンス接続の ID。 |
tr-attach-nls9fzkfat8934**** |
| DryRun |
boolean |
任意 |
権限やインスタンスステータスの検証を含むドライランを実行するかどうかを指定します。有効な値:
|
false |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
|||
| TransitRouterRouteEntryId |
string |
ルートエントリの ID。 |
rte-75eg4jprkvk0pw**** |
| RequestId |
string |
リクエスト ID。 |
835E7F4B-B380-4E0F-96A5-6EA572388047 |
例
成功レスポンス
JSONJSON
{
"TransitRouterRouteEntryId": "rte-75eg4jprkvk0pw****",
"RequestId": "835E7F4B-B380-4E0F-96A5-6EA572388047"
}
エラーコード
|
HTTP ステータスコード |
エラーコード |
エラーメッセージ |
説明 |
|---|---|---|---|
| 400 | DryRunOperation | Request validation has been passed with DryRun flag set. | DryRun リクエストの検証が有効です。 |
| 400 | InvalidTransitRouterRouteTableId.NotFound | TransitRouterRouteTableId is not found. | トランジットルーターのルートテーブルインスタンス ID が見つかりませんでした。 |
| 400 | TransitRouterRouteEntryNextHopId.NotFound | TransitRouterRouteEntryNextHopId is not found. | トランジットルータールートエントリのネクストホップインスタンス ID が存在しません。 |
| 400 | OperationFailed.CreateRouteEntryWithCCNAttachment | Operation failed because Create RouteEntry to CCN Attachment does not support. | CCN 添付ファイルを指すルートの作成はサポートされていません。 |
| 400 | QuotaExceeded.TransitRouterRoutEntry | TransitRouterRoutEntry quota exceeded. | ルート数が上限に達しました。 |
| 400 | IllegalParam.TransitRouterDestinationCidrBlock | TransitRouterDestinationCidrBlock is illegal. | リクエストで指定された TransitRouterDestinationCidrBlock が無効です。 |
| 400 | InstanceExist.TransitRouterRouteEntry | The instance TransitRouterRouteEntry already exists. | トランジットルーターのルートエントリは既に存在します。 |
| 400 | IncorrectStatus.TransitRouterRouteTable | TransitRouterRouteTable status is invalid. | トランジットルーターのルートテーブルが無効な状態です。 |
| 400 | ParamExclusive.RouteEntryIdAndRouteTableIdOrDestCidrBlock | RouteEntryId and TransitRouterRouteTableIdOrDestCidrBlock is mutually exclusive. | RouteEntryId、TransitRouterRouteTableId、および DestCidrBlock の各パラメーターは相互排他です。 |
| 400 | InvalidDescription | Description is invalid. | 説明が無効です。 |
| 400 | InvalidName | Name is invalid. | 名前が無効です。 |
| 400 | IllegalParam.NextHopType | The NextHopType is illegal. | リクエストに指定された NextHopType が無効です。 |
| 400 | MissingParam.TransitRouterRouteEntryNextHopId | The parameter TransitRouterRouteEntryNextHopId is mandatory | TransitRouterRouteEntryNextHopId パラメーターが不足しています。 |
| 400 | InvalidTransitRouterRouteEntryNextHopId.NotFound | TransitRouterRouteEntryNextHopId is not found | TransitRouterRouteEntryNextHopId が存在しません。 |
| 400 | OperationFailed.CreateRouteEntryWithSameDestinationCidrBlock | Operation failed because Create RouteEntry with same destination cidrblock does not support. | 同じ送信先 CIDR ブロックを持つルートエントリの作成は許可されていません。 |
| 400 | InvalidDestinationCidrBlock.NotFound | DestinationCidrBlock is not found. | パラメーターで指定された DestinationCidrBlock が存在しません。 |
| 400 | OperationFailed.CreateRouteEntryWithConnectAttachment | Operation failed because Create RouteEntry to connect Attachment does not support. | Connect 添付ファイルを指すルートの作成はサポートされていません。 |
| 400 | ParamExclusive.NextHopTypeBlackHoleAndNextHopId | TransitRouterRouteEntryNextHopType(BlackHole) and TransitRouterRouteEntryNextHopId is mutually exclusive. | ルートエントリがブラックホールルートの場合、ネクストホップ接続を指定しないでください。 |
| 400 | InvalidTransitRouterMode.NeedUpgrade | TransitRouter need to upgrade. | 現在のトランジットルーターモードはサポートされていません。 |
| 400 | OperationFailed.CreateTransitRouterRouteEntryWithVPCAttachment | The specified VPC Attachment has not enable IPv6. | 指定された VPC 添付ファイルでは IPv6 が有効になっていません。 |
| 400 | OperationFailed.CreateTransitRouterRouteEntryWithVPNAttachment | Create RouteEntry to VPN Attachment does not support IPv6. | VPN 添付ファイルを指す IPv6 ルートエントリの作成はサポートされていません。続行する前に構成を確認してください。 |
| 400 | NotSupport.AttachmentRoute | Not support such attachment route. | この接続ルートはサポートされていません。 |
| 400 | InvalidParameter | Invalid parameter. | パラメーターが無効です。 |
| 400 | Unauthorized | The AccessKeyId is unauthorized. | この操作を実行するために必須の権限がアカウントにありません。 |
| 400 | InvalidParameter.TransitRouterRouteEntryNextHopId | The specified parameter TransitRouterRouteEntryNextHopId is invalid. | TransitRouterRouteEntryNextHopId パラメーターが無効です。 |
| 400 | InvalidParameter.TransitRouterRouteTableId | The specified parameter TransitRouterRouteTableId is invalid. |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。