ルーターインターフェイスを作成します。
-
2 つの VRouter 間に最大 1 ペアの相互接続されたルーターインターフェイスを作成できます。
-
VRouter には最大 5 つのルーターインターフェイスを作成できます。
-
アカウントに未払いのルーターインターフェイスがある場合はルーターインターフェイスを作成することはできません。
-
同じルートテーブル内のルートエントリに同じターゲット CIDR ブロックを含めることはできません。
-
VBR が接続イニシエーターである必要があります。また、ステータスが有効である必要があります。
デバッグ
API Explorer を使用して、API のデバッグ、SDK コード例の自動生成、API のすばやい検索が簡単にできます。
リクエストパラメーター
パラメーター | データ型 | 必須/省略可能 | 値の例 | 説明 |
---|---|---|---|---|
Action | String | 必須 | CreateRouterInterface |
この操作の名前。 値 : CreateRouterInterface |
OppositeRegionId | String | 必須 | cn-shanghai |
接続アクセプターのリージョン。 |
RegionId | String | 必須 | cn-hangzhou |
ルーターインターフェイスが属するリージョン。 リージョン ID を照会するには、 DescribeRegions を呼び出します。 |
Role | String | 必須 | InitiatingSide|AcceptingSide |
ルーターインターフェイスの役割。 有効値:
|
RouterId | String | 必須 | cn-hangzhou |
ルーターインターフェイスに関連付けられているルーターの ID 。 |
RouterType | String | 必須 | VRouter |
ルーターインターフェイスに関連付けられているルーターのタイプ。 有効値:
|
Spec | String | 必須 | Large |
ルーターインターフェイスの仕様を変更します。 利用可能な仕様と対応する帯域幅は以下の通りです。
|
AccessPointId | String | 省略可能 | ap-cn-shanghaiSZ-pd-A |
VBR が属するアクセスポイントの ID 。 リージョン ID を照会するには、 DescribeAccessPoints を呼び出します。 注 物理アクセスのシナリオでは、このパラメーターを指定する必要があります。
|
AutoPay | String | 省略可能 | false |
オーダーが自動的に支払われるかどうか。 有効値:
注 InstanceChargeType の値が PrePaid の場合は、必要なパラメーターです。
|
ClientToken | String | 省略可能 | sjffha123334 |
リクエストの冪等性を保証するために使用されるクライアントトークン。 このパラメーター値はクライアントによって生成され、多様なリクエストにおいて一意であることが保証されています。 長さは 1 〜 64 ASCII 文字でなければなりません。 |
Description | String | 省略可能 | This is my description. |
ルートテーブルの説明。 説明の長さは 2 ~ 256 文字でなければなりません。 名前は英字で始まる必要があります。先頭文字列は |
HealthCheckSourceIp | String | 省略可能 | 116.62.222.28 |
ヘルスチェックの実行に使用されるソース IP アドレス。 ローカル VPC の未使用の IP アドレスである必要があります。 注 このパラメーターは、物理アクセスのシナリオで指定できます。
|
HealthCheckTargetIp | String | 省略可能 | 116.62.222.28 |
ヘルスチェックのターゲット IP アドレス。 注 HealthCheckSourceIp パラメーターが指定されている場合は、必要なパラメーターです。
|
InstanceChargeType | String | 省略可能 | PrePaid |
ルーターインターフェイスの課金方法。 有効値:
|
Name | String | 省略可能 | Router interface 1 |
ルーターインターフェイスの名前。 名前の長さは 2 ~ 128 文字である必要があります。 英数字、ピリオド (.)、アンダースコア (_)、ハイフン (-) を含めることができます。 名前は英字で始まる必要があります。先頭文字列は
|
OppositeAccessPointId | String | 省略可能 | ap-cn-shanghaiSZ-pd-A | ピアルーターインターフェイスのアクセスポイントの ID 。
注 VBR 上にピアルーターインターフェイスがある場合は、必要なパラメーターです。 ルーターインターフェイスの作成後は変更できません。
|
OppositeInterfaceId | String | 省略可能 | ri-2zeo3xzyf38r4urzdpvfs |
ピアルーターインターフェイスの ID 。 |
OppositeInterfaceOwnerId | String | 省略可能 | fffsf |
ピアルーターインターフェイスの所有者の ID 。 |
OppositeRouterId | String | 省略可能 | vrt-bp1lhl0taikrteen80oxx |
ピアルーターの ID 。 |
OppositeRouterType | String | 省略可能 | VRouter |
ピアルーターインターフェイスに関連付けられているルーターのタイプ。 有効値:
|
Period | String | 省略可能 | 3 |
購入内容の有効期間。 値の範囲:
注 InstanceChargeTypeパラメーターの値がPrePaid の場合は、必要なパラメーターです。
|
PricingCycle | String | 省略可能 | Month |
サブスクリプション課金方法の課金サイクル。 有効値:
注 InstanceChargeType パラメーターの値が PrePaid5 の場合は、必要なパラメーターです。
|
レスポンスパラメーター
パラメーター | データ型 | 値の例 | 説明 |
---|---|---|---|
OrderId | String | 202008594930117 | オーダーナンバー。 サブスクリプションの課金方法を選択すると、このパラメーターが返されます。 |
RequestId | String | 079874CD-AEC1-43E6-AC03-ADD96B6E4907 | リクエストの ID です。 |
RouterInterfaceId | String | ri-2ze7fbuohmxxxxxx | ルーターインターフェイスの ID 。 |
例
リクエストの例
http(s)://vpc.aliyuncs.com/?Action=CreateRouterInterface
&OppositeRegionId=cn-shanghai
&RegionId=cn-hangzhou
&Role=InitiatingSide|AcceptingSide
&RegionId=cn-hangzhou
&RouterType=VRouter
&Spec=Large
&<CommonParameters>
レスポンス例-
XML 形式
<CreateRouterInterfaceResponse> <RequestId>980960B0-2969-40BF-8542-EBB34FD358AB</RequestId> <RouterInterfaceId>ri-2ze7fbuohmxxxxxx</RouterInterfaceId> </CreateRouterInterfaceResponse>
-
JSON 形式
{ "RouterInterfaceId":"ri-2ze7fbuohmxxxxxx", "RequestId":"980960B0-2969-40BF-8542-EBB34FD358AB" }
エラーコード
HTTP ステータスコード | エラーコード | エラーメッセージ | 説明 |
---|---|---|---|
404 | InvalidRegionId.NotFound | 指定された regionId はレコードに存在しません。 | 指定された リージョン ID は存在しません。 |
400 | InvalidRole.ValueNotSupported | 指定された役割は無効です。 | 指定された役割は無効です。 |
400 | InvalidSpec.ValudNotSupported | 指定された Spec はサポートされていません。 | 指定された仕様はサポートされていません。 |
400 | InvalidRouterType.ValueNotSupported | 指定された RouterType は無効です。 | 指定されたルータータイプは無効です。 |
404 | InvalidRouterId.NotFound | 指定された RegionId はレコードに存在しません。 | 指定されたルーター ID は存在しません。 |
400 | InvalidDescription.Malformed | 指定された "Description" は無効です。 | 指定された説明は無効です。 説明の長さは 2~256 文字でなければなりません。 先頭文字列を http:// または https:// にすることはできません。 |
400 | Forbidden.BillsOutstanding | 未払いの請求書があるため、新たに RouterInterface を作成することはできません。 | 支払い期限が過ぎている支払いがあるため、ルーターインターフェイスを作成できません。 |
400 | LimitationExceed.InterfaceNumberOnRouter | ルーター上の RouterInterface の総数を超えています。 | ルーターインターフェイスのクォータに達しました。 |
400 | Forbidden.NotInRouterInterfaceCreateWhitelist | ルーターインターフェイス作成ホワイトリストの範囲外です。 | ルーターインターフェイスのホワイトリスト上に存在しません。 |
400 | RI_CREATE_ONE_LIMIT_BY_SYNC | 同期によって 1 つのルーターインターフェイスのみ作成。 | 一度に作成できるルーターインターフェイスは 1 つのみです。 |
400 | InvalidAccessPoint.ValueNotAllowed | 非 vbr のルーターインターフェイスにアクセスポイントを設定することはできません。 | VBR にないルーターインターフェイスにアクセスポイントを設定することはできません。 |
400 | InvalidAccessPoint.ValueNotAllowed | 非 vbr のピア側ルーターインターフェイスには、ピア側のアクセスポイントを設定することはできません。 | VBR にないルーターインターフェイスにアクセスポイントを設定することはできません。 |
400 | InvalidAccessPoint.NotMatch | accessPoint ID が一致しません | アクセスポイントの ID が無効です。 |
400 | InvalidAccessPoint.NotExist | accessPoint が存在しません | 指定されたアクセスポイントは存在しません。 |
400 | InvalidRouterType.ValueNotSupported | 指定された RouterType は無効です | 指定されたルータータイプは無効です。 |
400 | ForbiddenAction | 該当ユーザーはこのアクションを行うことができません。 | この操作を行う権限がありません。 |